bulltrackers-module 1.0.104 → 1.0.106

package/index.js

@@ -1,114 +1,106 @@
-/**
- * @fileoverview Main entry point for the Bulltrackers shared module.
- * This module consolidates all core logic into a single 'pipe' object
- * to enforce a clear naming convention and dependency injection pattern.
- */
-
-// --- Core Utilities (Classes and Stateless Helpers) ---
-
-const core = {
-    IntelligentHeaderManager: require('./functions/core/utils/intelligent_header_manager').IntelligentHeaderManager,
-    IntelligentProxyManager: require('./functions/core/utils/intelligent_proxy_manager').IntelligentProxyManager,
-    FirestoreBatchManager: require('./functions/task-engine/utils/firestore_batch_manager').FirestoreBatchManager,
-    firestoreUtils: require('./functions/core/utils/firestore_utils'),
-    pubsubUtils: require('./functions/core/utils/pubsub_utils'),
-};
-
-// --- Pipe 1: Orchestrator ---
-
-const orchestrator = {
-    // Main Pipes (Entry points for Cloud Functions)
-    runDiscoveryOrchestrator: require('./functions/orchestrator/index').runDiscoveryOrchestrator,
-    runUpdateOrchestrator: require('./functions/orchestrator/index').runUpdateOrchestrator,
-    
-    // Sub-Pipes (Discovery)
-    checkDiscoveryNeed: require('./functions/orchestrator/helpers/discovery_helpers').checkDiscoveryNeed,
-    getDiscoveryCandidates: require('./functions/orchestrator/helpers/discovery_helpers').getDiscoveryCandidates,
-    dispatchDiscovery: require('./functions/orchestrator/helpers/discovery_helpers').dispatchDiscovery,
-
-    // Sub-Pipes (Updates)
-    getUpdateTargets: require('./functions/orchestrator/helpers/update_helpers').getUpdateTargets,
-    dispatchUpdates: require('./functions/orchestrator/helpers/update_helpers').dispatchUpdates,
-};
-
-// --- Pipe 2: Dispatcher ---
-
-const dispatcher = {
-    // Main Pipe
-    handleRequest: require('./functions/dispatcher/index').handleRequest,
-    
-    // Sub-Pipe
-    dispatchTasksInBatches: require('./functions/dispatcher/helpers/dispatch_helpers').dispatchTasksInBatches,
-};
-
-// --- Pipe 3: Task Engine ---
-
-const taskEngine = {
-    // Main Pipe
-    handleRequest: require('./functions/task-engine/handler_creator').handleRequest,
-    
-    // Sub-Pipes
-    handleDiscover: require('./functions/task-engine/helpers/discover_helpers').handleDiscover,
-    handleVerify: require('./functions/task-engine/helpers/verify_helpers').handleVerify,
-    handleUpdate: require('./functions/task-engine/helpers/update_helpers').handleUpdate,
-};
-
-// --- Pipe 4: Computation System ---
-const computationSystem = {
-    // Main Pipe (Scheduler)
-    runOrchestration: require('./functions/computation-system/helpers/orchestration_helpers').runComputationOrchestrator,
-    
-    // Main Pipe (Worker)
-    handleNodeTask: require('./functions/computation-system/helpers/worker_helpers').handleNodeTask, // <-- Corrected
-    
-    // Sub-Pipes (Helpers and Utilities)
-    dataLoader: require('./functions/computation-system/utils/data_loader'),
-    computationUtils: require('./functions/computation-system/utils/utils'),
-    computationStateManager: require('./functions/computation-system/utils/computation_state_manager'), // <-- Added
-    
-    // Graph Tools
-    ComputationGraph: require('./functions/computation-system/utils/dependency_graph').ComputationGraph, // <-- Corrected
-    dependencyConfig: require('./functions/computation-system/computation_dependencies.json') // <-- Added
-}
-
-// --- Pipe 5: API ---
-
-const api = {
-    // Main Pipe
-    createApiApp: require('./functions/generic-api/index').createApiApp,
-    
-    // Sub-Pipes (Helpers exposed for documentation/testing)
-    helpers: require('./functions/generic-api/helpers/api_helpers'),
-};
-
-// --- Pipe 6: Maintenance ---
-// Standalone cleanup and utility functions TODO -- Some of these are not really maintenance pipes, socials could do with its own pipe..?
-const maintenance = {
-    runSpeculatorCleanup: require('./functions/speculator-cleanup-orchestrator/helpers/cleanup_helpers').runCleanup,
-    handleInvalidSpeculator: require('./functions/invalid-speculator-handler/helpers/handler_helpers').handleInvalidSpeculator,
-    runFetchInsights: require('./functions/fetch-insights/helpers/handler_helpers').fetchAndStoreInsights,
-    runFetchPrices: require('./functions/etoro-price-fetcher/helpers/handler_helpers').fetchAndStorePrices,
-    runSocialOrchestrator: require('./functions/social-orchestrator/helpers/orchestrator_helpers').runSocialOrchestrator,
-    handleSocialTask: require('./functions/social-task-handler/helpers/handler_helpers').handleSocialTask,
-    runBackfillAssetPrices: require('./functions/price-backfill/helpers/handler_helpers').runBackfillAssetPrices,
-};
-
-// --- Pipe 7: Proxy ---
-
-const proxy = {
-    handlePost: require('./functions/appscript-api/index').handlePost,
-};
-
-// --- EXPORT THE FINAL PIPE OBJECT ---
-module.exports = {
-    pipe: {
-        core,
-        orchestrator,
-        dispatcher,
-        taskEngine,
-        computationSystem,
-        api,
-        maintenance,
-        proxy,
-    }
+/**
+ * @fileoverview Main entry point for the Bulltrackers shared module.
+ * This module consolidates all core logic into a single 'pipe' object
+ * to enforce a clear naming convention and dependency injection pattern.
+ */
+
+// --- Core Utilities (Classes and Stateless Helpers) ---
+
+const core = {
+    IntelligentHeaderManager: require('./functions/core/utils/intelligent_header_manager').IntelligentHeaderManager,
+    IntelligentProxyManager: require('./functions/core/utils/intelligent_proxy_manager').IntelligentProxyManager,
+    FirestoreBatchManager: require('./functions/task-engine/utils/firestore_batch_manager').FirestoreBatchManager,
+    firestoreUtils: require('./functions/core/utils/firestore_utils'),
+    pubsubUtils: require('./functions/core/utils/pubsub_utils'),
+};
+
+// --- Pipe 1: Orchestrator ---
+
+const orchestrator = {
+    // Main Pipes (Entry points for Cloud Functions)
+    runDiscoveryOrchestrator: require('./functions/orchestrator/index').runDiscoveryOrchestrator,
+    runUpdateOrchestrator: require('./functions/orchestrator/index').runUpdateOrchestrator,
+    
+    // Sub-Pipes (Discovery)
+    checkDiscoveryNeed: require('./functions/orchestrator/helpers/discovery_helpers').checkDiscoveryNeed,
+    getDiscoveryCandidates: require('./functions/orchestrator/helpers/discovery_helpers').getDiscoveryCandidates,
+    dispatchDiscovery: require('./functions/orchestrator/helpers/discovery_helpers').dispatchDiscovery,
+
+    // Sub-Pipes (Updates)
+    getUpdateTargets: require('./functions/orchestrator/helpers/update_helpers').getUpdateTargets,
+    dispatchUpdates: require('./functions/orchestrator/helpers/update_helpers').dispatchUpdates,
+};
+
+// --- Pipe 2: Dispatcher ---
+
+const dispatcher = {
+    // Main Pipe
+    handleRequest: require('./functions/dispatcher/index').handleRequest,
+    
+    // Sub-Pipe
+    dispatchTasksInBatches: require('./functions/dispatcher/helpers/dispatch_helpers').dispatchTasksInBatches,
+};
+
+// --- Pipe 3: Task Engine ---
+
+const taskEngine = {
+    // Main Pipe
+    handleRequest: require('./functions/task-engine/handler_creator').handleRequest,
+    
+    // Sub-Pipes
+    handleDiscover: require('./functions/task-engine/helpers/discover_helpers').handleDiscover,
+    handleVerify: require('./functions/task-engine/helpers/verify_helpers').handleVerify,
+    handleUpdate: require('./functions/task-engine/helpers/update_helpers').handleUpdate,
+};
+
+// --- Pipe 4: Computation System ---
+const computationSystem = {
+    // Main Pipe
+    runOrchestration: require('./functions/computation-system/helpers/orchestration_helpers').runComputationOrchestrator,
+    
+    // Sub-Pipes (Exposing utils for potential external use)
+    dataLoader: require('./functions/computation-system/utils/data_loader'),
+    computationUtils: require('./functions/computation-system/utils/utils'),
+};
+
+// --- Pipe 5: API ---
+
+const api = {
+    // Main Pipe
+    createApiApp: require('./functions/generic-api/index').createApiApp,
+    
+    // Sub-Pipes (Helpers exposed for documentation/testing)
+    helpers: require('./functions/generic-api/helpers/api_helpers'),
+};
+
+// --- Pipe 6: Maintenance ---
+// Standalone cleanup and utility functions TODO -- Some of these are not really maintenance pipes, socials could do with its own pipe..?
+const maintenance = {
+    runSpeculatorCleanup: require('./functions/speculator-cleanup-orchestrator/helpers/cleanup_helpers').runCleanup,
+    handleInvalidSpeculator: require('./functions/invalid-speculator-handler/helpers/handler_helpers').handleInvalidSpeculator,
+    runFetchInsights: require('./functions/fetch-insights/helpers/handler_helpers').fetchAndStoreInsights,
+    runFetchPrices: require('./functions/etoro-price-fetcher/helpers/handler_helpers').fetchAndStorePrices,
+    runSocialOrchestrator: require('./functions/social-orchestrator/helpers/orchestrator_helpers').runSocialOrchestrator,
+    handleSocialTask: require('./functions/social-task-handler/helpers/handler_helpers').handleSocialTask,
+    runBackfillAssetPrices: require('./functions/price-backfill/helpers/handler_helpers').runBackfillAssetPrices,
+};
+
+// --- Pipe 7: Proxy ---
+
+const proxy = {
+    handlePost: require('./functions/appscript-api/index').handlePost,
+};
+
+// --- EXPORT THE FINAL PIPE OBJECT ---
+module.exports = {
+    pipe: {
+        core,
+        orchestrator,
+        dispatcher,
+        taskEngine,
+        computationSystem,
+        api,
+        maintenance,
+        proxy,
+    }
 };

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "bulltrackers-module",
-  "version": "1.0.104",
-  "description": "Helper Functions for Bulltrackers.",
-  "main": "index.js",
-  "files": [
-    "index.js",
-    "functions/orchestrator/",
-    "functions/task-engine/",
-    "functions/core/",
-    "functions/computation-system/",
-    "functions/generic-api/",
-    "functions/dispatcher/",
-    "functions/invalid-speculator-handler/",
-    "functions/speculator-cleanup-orchestrator/",
-    "functions/fetch-insights/",
-    "functions/etoro-price-fetcher/",
-    "functions/appscript-api/",
-    "functions/social-orchestrator/",
-    "functions/social-task-handler/",
-    "functions/price-backfill/"
-  ],
-  "keywords": [
-    "bulltrackers",
-    "etoro",
-    "precompute",
-    "calculations",
-    "finance"
-  ],
-  "dependencies": {
-    "@google-cloud/firestore": "^7.11.3",
-    "sharedsetup": "latest",
-    "require-all": "^3.0.0",
-    "@google-cloud/pubsub": "latest",
-    "express": "^4.19.2",
-    "cors": "^2.8.5",
-    "p-limit": "^3.1.0"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "bulltrackers-module",
+  "version": "1.0.106",
+  "description": "Helper Functions for Bulltrackers.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "functions/orchestrator/",
+    "functions/task-engine/",
+    "functions/core/",
+    "functions/computation-system/",
+    "functions/generic-api/",
+    "functions/dispatcher/",
+    "functions/invalid-speculator-handler/",
+    "functions/speculator-cleanup-orchestrator/",
+    "functions/fetch-insights/",
+    "functions/etoro-price-fetcher/",
+    "functions/appscript-api/",
+    "functions/social-orchestrator/",
+    "functions/social-task-handler/",
+    "functions/price-backfill/"
+  ],
+  "keywords": [
+    "bulltrackers",
+    "etoro",
+    "precompute",
+    "calculations",
+    "finance"
+  ],
+  "dependencies": {
+    "@google-cloud/firestore": "^7.11.3",
+    "sharedsetup": "latest",
+    "require-all": "^3.0.0",
+    "@google-cloud/pubsub": "latest",
+    "express": "^4.19.2",
+    "cors": "^2.8.5",
+    "p-limit": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/functions/computation-system/computation_dependencies.json

@@ -1,120 +0,0 @@
-{
-  "dependencies": {
-    "smart-cohort-flow": ["user-investment-profile"],
-    "dumb-cohort-flow": ["user-investment-profile"],
-    "crowd_sharpe_ratio_proxy": ["pnl-distribution-per-stock"],
-    "social_flow_correlation": [
-      "social_sentiment_aggregation",
-      "asset_crowd_flow"
-    ],
-    "cash-flow-deployment": [
-      "crowd-cash-flow-proxy",
-      "asset_crowd_flow"
-    ],
-    "cash-flow-liquidation": [
-      "crowd-cash-flow-proxy",
-      "asset_crowd_flow"
-    ],
-    "capital_deployment_strategy": [
-      "crowd-cash-flow-proxy",
-      "new-allocation-percentage",
-      "reallocation-increase-percentage"
-    ],
-    "profit_cohort_divergence": [
-      "in-profit-asset-crowd-flow",
-      "in-loss-asset-crowd-flow"
-    ],
-    "smart-dumb-divergence-index": [
-      "smart-cohort-flow",
-      "dumb-cohort-flow"
-    ],
-    "capital_vintage_performance": ["cash-flow-deployment"],
-    "capital_liquidation_performance": ["cash-flow-liquidation"],
-    "strategy-performance": [
-      "smart-dumb-divergence-index",
-      "profit_cohort_divergence"
-    ]
-  },
-  "requirements": {
-    "activity_by_pnl_status": ["today_portfolio", "yesterday_portfolio"],
-    "daily_asset_activity": ["today_portfolio", "yesterday_portfolio"],
-    "daily_user_activity_tracker": ["today_portfolio", "yesterday_portfolio"],
-    "speculator_adjustment_activity": ["today_portfolio", "yesterday_portfolio"],
-    "asset_position_size": ["today_portfolio"],
-    "strategy-performance": ["meta"],
-    "asset_crowd_flow": ["today_portfolio", "yesterday_portfolio"],
-    "drawdown_response": ["today_portfolio", "yesterday_portfolio"],
-    "dumb-cohort-flow": ["today_portfolio", "yesterday_portfolio"],
-    "gain_response": ["today_portfolio", "yesterday_portfolio"],
-    "in_loss_asset_crowd_flow": ["today_portfolio", "yesterday_portfolio"],
-    "in_profit_asset_crowd_flow": ["today_portfolio", "yesterday_portfolio"],
-    "paper_vs_diamond_hands": ["today_portfolio", "yesterday_portfolio"],
-    "position_count_pnl": ["today_portfolio"],
-    "smart-cohort-flow": ["today_portfolio", "yesterday_portfolio"],
-    "smart_money_flow": ["today_portfolio", "yesterday_portfolio"],
-    "user-investment-profile": ["today_portfolio", "yesterday_portfolio"],
-    "crowd-cash-flow-proxy": ["today_portfolio", "yesterday_portfolio"],
-    "deposit_withdrawal_percentage": ["today_portfolio", "yesterday_portfolio"],
-    "new_allocation_percentage": ["today_portfolio", "yesterday_portfolio"],
-    "reallocation_increase_percentage": ["today_portfolio", "yesterday_portfolio"],
-    "daily_bought_vs_sold_count": ["today_insights", "yesterday_insights"],
-    "daily_buy_sell_sentiment_count": ["today_insights"],
-    "daily_ownership_delta": ["today_insights", "yesterday_insights"],
-    "daily_total_positions_held": ["today_insights"],
-    "capital_deployment_strategy": ["meta"],
-    "cash-flow-deployment": ["meta"],
-    "cash-flow-liquidation": ["meta"],
-    "crowd_sharpe_ratio_proxy": ["meta"],
-    "profit_cohort_divergence": ["meta"],
-    "smart-dumb-divergence-index": ["meta"],
-    "social_flow_correlation": ["meta"],
-    "capital_liquidation_performance": ["meta"],
-    "capital_vintage_performance": ["meta"],
-    "profitability_migration": ["today_portfolio", "yesterday_portfolio"],
-    "user_profitability_tracker": ["today_portfolio"],
-    "asset_pnl_status": ["today_portfolio"],
-    "average_daily_pnl_all_users": ["today_portfolio"],
-    "average_daily_pnl_per_sector": ["today_portfolio"],
-    "average_daily_pnl_per_stock": ["today_portfolio"],
-    "average_daily_position_pnl": ["today_portfolio"],
-    "pnl_distribution_per_stock": ["today_portfolio"],
-    "profitability_ratio_per_stock": ["today_portfolio"],
-    "profitability_skew_per_stock": ["today_portfolio"],
-    "profitable_and_unprofitable_status": ["today_portfolio"],
-    "users_processed": ["today_portfolio"],
-    "diversification_pnl": ["today_portfolio", "yesterday_portfolio"],
-    "sector_rotation": ["today_portfolio", "yesterday_portfolio"],
-    "total_long_per_sector": ["today_portfolio"],
-    "total_short_per_sector": ["today_portfolio"],
-    "crowd_conviction_score": ["today_portfolio", "yesterday_portfolio"],
-    "long_position_per_stock": ["today_portfolio"],
-    "sentiment_per_stock": ["today_portfolio"],
-    "short_position_per_stock": ["today_portfolio"],
-    "total_long_figures": ["today_portfolio"],
-    "total_short_figures": ["today_portfolio"],
-    "social-asset-posts-trend": ["today_social"],
-    "social-top-mentioned-words": ["today_social", "yesterday_social"],
-    "social-topic-interest-evolution": ["today_social"],
-    "social-word-mentions-trend": ["today_social"],
-    "social_activity_aggregation": ["today_social"],
-    "social_event_correlation": ["today_social", "yesterday_social"],
-    "social_sentiment_aggregation": ["today_social"],
-    "risk_appetite_change": ["today_portfolio", "yesterday_portfolio"],
-    "tsl_effectiveness": ["today_portfolio"],
-    "distance_to_stop_loss_per_leverage": ["today_portfolio"],
-    "distance_to_tp_per_leverage": ["today_portfolio"],
-    "entry_distance_to_sl_per_leverage": ["today_portfolio"],
-    "entry_distance_to_tp_per_leverage": ["today_portfolio"],
-    "holding_duration_per_asset": ["today_portfolio"],
-    "leverage_per_asset": ["today_portfolio"],
-    "leverage_per_sector": ["today_portfolio"],
-    "risk_reward_ratio_per_asset": ["today_portfolio"],
-    "speculator_asset_sentiment": ["today_portfolio"],
-    "speculator_danger_zone": ["today_portfolio"],
-    "stop_loss_distance_by_sector_short_long_breakdown": ["today_portfolio"],
-    "stop_loss_distance_by_ticker_short_long_breakdown": ["today_portfolio"],
-    "stop_loss_per_asset": ["today_portfolio"],
-    "take_profit_per_asset": ["today_portfolio"],
-    "tsl_per_asset": ["today_portfolio"]
-  }
-}