294 lines
10 KiB
TypeScript
294 lines
10 KiB
TypeScript
// services/cache-manager.ts
|
|
import { config } from 'dotenv';
|
|
import { fetchActivityData } from '../engage-api/get-activity';
|
|
import { structActivityData } from '../engage-api/struct-activity';
|
|
import { structStaffData } from '../engage-api/struct-staff';
|
|
import {
|
|
getActivityData,
|
|
setActivityData,
|
|
getStaffData,
|
|
setStaffData,
|
|
getAllActivityKeys,
|
|
ACTIVITY_KEY_PREFIX
|
|
} from './redis-service';
|
|
import { uploadImageFromBase64, listS3Objects, constructS3Url } from './s3-service';
|
|
import { extractBase64Image } from '../utils/image-processor';
|
|
import { logger } from '../utils/logger';
|
|
|
|
|
|
import type { ActivityData } from '../models/activity';
|
|
|
|
config();
|
|
|
|
// Environment configuration
|
|
const USERNAME = process.env.API_USERNAME;
|
|
const PASSWORD = process.env.API_PASSWORD;
|
|
const MIN_ACTIVITY_ID_SCAN = parseInt(process.env.MIN_ACTIVITY_ID_SCAN || '0', 10);
|
|
const MAX_ACTIVITY_ID_SCAN = parseInt(process.env.MAX_ACTIVITY_ID_SCAN || '9999', 10);
|
|
const CLUB_UPDATE_INTERVAL_MINS = parseInt(process.env.CLUB_UPDATE_INTERVAL_MINS || '60', 10);
|
|
const STAFF_UPDATE_INTERVAL_MINS = parseInt(process.env.STAFF_UPDATE_INTERVAL_MINS || '60', 10);
|
|
const FIXED_STAFF_ACTIVITY_ID = process.env.FIXED_STAFF_ACTIVITY_ID;
|
|
const S3_IMAGE_PREFIX = (process.env.S3_PUBLIC_URL_PREFIX || 'files').replace(/\/$/, '');
|
|
|
|
/**
|
|
* Extracts S3 object key from a public URL.
|
|
* Handles both S3_PUBLIC_URL and S3_ENDPOINT formats.
|
|
*
|
|
* Examples:
|
|
* - https://cdn.example.com/bucket/files/abc123.avif → files/abc123.avif
|
|
* - https://s3.amazonaws.com/bucket/files/abc123.avif → files/abc123.avif
|
|
*
|
|
* @param url - The full S3 public URL
|
|
* @returns The object key (e.g., "files/abc123.avif") or null if parsing fails
|
|
*/
|
|
function extractObjectKeyFromUrl(url: string): string | null {
|
|
try {
|
|
const urlObj = new URL(url);
|
|
const path = urlObj.pathname;
|
|
|
|
const parts = path.replace(/^\//, '').split('/').filter(p => p);
|
|
|
|
if (parts.length >= 2) {
|
|
const key = parts.slice(1).join('/');
|
|
return key;
|
|
}
|
|
|
|
logger.warn(`Failed to extract object key from URL: ${url} - insufficient path parts`);
|
|
return null;
|
|
} catch (error) {
|
|
logger.warn(`Failed to parse URL: ${url}`, error);
|
|
return null;
|
|
}
|
|
}
|
|
|
|
// Crawler configuration
|
|
const CRAWLER_REQUEST_TIMEOUT_MS = parseInt(process.env.CRAWLER_REQUEST_TIMEOUT_MS || '25000', 10);
|
|
const CRAWLER_MAX_RETRIES = parseInt(process.env.CRAWLER_MAX_RETRIES || '3', 10);
|
|
const CRAWLER_RETRY_DELAY_MS = parseInt(process.env.CRAWLER_RETRY_DELAY_MS || '1000', 10);
|
|
|
|
// Module-level counter for skipped activities (reset at start of each scan)
|
|
let skippedCount = 0;
|
|
|
|
/**
|
|
* Process and cache a single activity
|
|
* @param activityId - The activity ID to process
|
|
* @returns The processed activity data
|
|
*/
|
|
async function processAndCacheActivity(activityId: string): Promise<ActivityData> {
|
|
logger.debug(`Processing activity ID: ${activityId}`);
|
|
try {
|
|
if (!USERNAME || !PASSWORD) {
|
|
throw new Error('API username or password not configured');
|
|
}
|
|
|
|
// Add timeout protection for the entire fetch operation
|
|
logger.debug(`Fetching activity data for ID: ${activityId}`);
|
|
const activityJson = await Promise.race([
|
|
fetchActivityData(activityId, USERNAME, PASSWORD, false),
|
|
new Promise((_, reject) =>
|
|
setTimeout(() => reject(new Error(`Timeout fetching activity ${activityId} after ${CRAWLER_REQUEST_TIMEOUT_MS}ms`)), CRAWLER_REQUEST_TIMEOUT_MS + 5000)
|
|
)
|
|
]);
|
|
let structuredActivity: ActivityData;
|
|
|
|
if (!activityJson) {
|
|
logger.info(`No data found for activity ID ${activityId} from engage API. Caching as empty.`);
|
|
structuredActivity = {
|
|
lastCheck: new Date().toISOString(),
|
|
source: 'api-fetch-empty'
|
|
};
|
|
} else {
|
|
structuredActivity = await structActivityData(activityJson);
|
|
if (structuredActivity && structuredActivity.photo &&
|
|
typeof structuredActivity.photo === 'string' &&
|
|
structuredActivity.photo.startsWith('data:image')) {
|
|
|
|
const imageInfo = extractBase64Image(structuredActivity.photo);
|
|
if (imageInfo) {
|
|
const s3Url = await uploadImageFromBase64(
|
|
imageInfo.base64Content,
|
|
imageInfo.format,
|
|
activityId
|
|
);
|
|
|
|
if (s3Url) {
|
|
structuredActivity.photo = s3Url;
|
|
} else {
|
|
logger.warn(`Failed S3 upload for activity ${activityId}. Photo may be base64 or null.`);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
structuredActivity.lastCheck = new Date().toISOString();
|
|
await setActivityData(activityId, structuredActivity);
|
|
return structuredActivity;
|
|
} catch (error) {
|
|
logger.error(`Error processing activity ID ${activityId}:`, error);
|
|
const errorData: ActivityData = {
|
|
lastCheck: new Date().toISOString(),
|
|
error: "Failed to fetch or process"
|
|
};
|
|
await setActivityData(activityId, errorData);
|
|
return errorData;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Process a single activity for initialization
|
|
* @param activityId - The activity ID to process
|
|
*/
|
|
async function processSingleActivity(activityId: string): Promise<void> {
|
|
const cachedData = await getActivityData(activityId);
|
|
|
|
if (!cachedData ||
|
|
Object.keys(cachedData).length === 0 ||
|
|
!cachedData.lastCheck ||
|
|
cachedData.error) {
|
|
|
|
logger.debug(`Initializing cache for activity ID: ${activityId}`);
|
|
await processAndCacheActivity(activityId);
|
|
} else {
|
|
skippedCount++;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Initialize the club cache by scanning through all activity IDs
|
|
* Processed sequentially
|
|
*/
|
|
export async function initializeClubCache(): Promise<void> {
|
|
logger.info(`Starting initial club cache population from ID ${MIN_ACTIVITY_ID_SCAN} to ${MAX_ACTIVITY_ID_SCAN}`);
|
|
|
|
const totalIds = MAX_ACTIVITY_ID_SCAN - MIN_ACTIVITY_ID_SCAN + 1;
|
|
let successCount = 0;
|
|
let errorCount = 0;
|
|
skippedCount = 0; // Reset for this run
|
|
|
|
// Generate array of activity IDs
|
|
const activityIds = Array.from(
|
|
{ length: totalIds },
|
|
(_, i) => String(MIN_ACTIVITY_ID_SCAN + i)
|
|
);
|
|
|
|
// Process all activities sequentially
|
|
for (let i = 0; i < activityIds.length; i++) {
|
|
const activityId = activityIds[i]!;
|
|
try {
|
|
await processSingleActivity(activityId);
|
|
successCount++;
|
|
} catch (error) {
|
|
errorCount++;
|
|
logger.error(`Error processing activity ID ${activityId}:`, error);
|
|
}
|
|
|
|
// Log progress every 100 activities or at completion
|
|
if ((i + 1) % 100 === 0 || i === activityIds.length - 1) {
|
|
const mem = process.memoryUsage();
|
|
logger.info(`Progress: ${i + 1}/${totalIds} (${Math.round((i + 1) / totalIds * 100)}%) - Success: ${successCount}, Skipped: ${skippedCount}, Errors: ${errorCount} | Heap: ${Math.round(mem.heapUsed / 1024 / 1024)}MB`);
|
|
}
|
|
}
|
|
|
|
logger.info(`Initial club cache population finished.`);
|
|
logger.info(`Summary: Total: ${totalIds}, Processed: ${activityIds.length}, Success: ${successCount}, Skipped: ${skippedCount}, Errors: ${errorCount}`);
|
|
}
|
|
|
|
/**
|
|
* Update stale clubs in the cache
|
|
* Processed sequentially
|
|
*/
|
|
export async function updateStaleClubs(): Promise<void> {
|
|
logger.info('Starting stale club check...');
|
|
const now = Date.now();
|
|
const updateIntervalMs = CLUB_UPDATE_INTERVAL_MINS * 60 * 1000;
|
|
const activityKeys = await getAllActivityKeys();
|
|
|
|
// Identify stale activities
|
|
const staleActivityIds: string[] = [];
|
|
for (const key of activityKeys) {
|
|
const activityId = key.substring(ACTIVITY_KEY_PREFIX.length);
|
|
const cachedData = await getActivityData(activityId);
|
|
|
|
const needsUpdate = !cachedData ||
|
|
Object.keys(cachedData).length === 0 ||
|
|
(!cachedData.lastCheck && !cachedData.error) ||
|
|
(cachedData.lastCheck && (now - new Date(cachedData.lastCheck).getTime()) > updateIntervalMs) ||
|
|
cachedData.error;
|
|
|
|
if (needsUpdate) {
|
|
staleActivityIds.push(activityId);
|
|
}
|
|
}
|
|
|
|
if (staleActivityIds.length === 0) {
|
|
logger.info('No stale activities found. Skipping update.');
|
|
logger.info('Stale club check finished.');
|
|
return;
|
|
}
|
|
|
|
logger.info(`Found ${staleActivityIds.length} stale activities to update.`);
|
|
|
|
// Process stale activities sequentially
|
|
for (let i = 0; i < staleActivityIds.length; i++) {
|
|
const activityId = staleActivityIds[i]!;
|
|
try {
|
|
logger.debug(`Updating stale activity ${activityId}`);
|
|
await processAndCacheActivity(activityId);
|
|
} catch (error) {
|
|
logger.error(`Error updating stale activity ${activityId}:`, error);
|
|
}
|
|
|
|
// Log progress every 10 activities or at completion
|
|
if ((i + 1) % 10 === 0 || i === staleActivityIds.length - 1) {
|
|
logger.info(`Update progress: ${i + 1}/${staleActivityIds.length} (${Math.round((i + 1) / staleActivityIds.length * 100)}%)`);
|
|
}
|
|
}
|
|
|
|
logger.info('Stale club check finished.');
|
|
}
|
|
|
|
/**
|
|
* Initialize or update the staff cache
|
|
* @param forceUpdate - Force an update regardless of staleness
|
|
*/
|
|
export async function initializeOrUpdateStaffCache(forceUpdate: boolean = false): Promise<void> {
|
|
logger.info('Starting staff cache check/update...');
|
|
try {
|
|
const cachedStaffData = await getStaffData();
|
|
const now = Date.now();
|
|
const updateIntervalMs = STAFF_UPDATE_INTERVAL_MINS * 60 * 1000;
|
|
let needsUpdate = forceUpdate;
|
|
|
|
if (!cachedStaffData || !cachedStaffData.lastCheck) {
|
|
needsUpdate = true;
|
|
} else {
|
|
const lastCheckTime = new Date(cachedStaffData.lastCheck).getTime();
|
|
if ((now - lastCheckTime) > updateIntervalMs) {
|
|
needsUpdate = true;
|
|
}
|
|
}
|
|
|
|
if (needsUpdate && USERNAME && PASSWORD && FIXED_STAFF_ACTIVITY_ID) {
|
|
logger.info('Staff data needs update. Fetching...');
|
|
const activityJson = await fetchActivityData(FIXED_STAFF_ACTIVITY_ID, USERNAME, PASSWORD);
|
|
|
|
if (activityJson) {
|
|
const staffMap = await structStaffData(activityJson);
|
|
const staffObject = Object.fromEntries(staffMap);
|
|
staffObject.lastCheck = new Date().toISOString();
|
|
await setStaffData(staffObject);
|
|
logger.info('Staff data updated and cached.');
|
|
} else {
|
|
logger.warn(`Could not retrieve base data for staff (activity ID ${FIXED_STAFF_ACTIVITY_ID}).`);
|
|
if (cachedStaffData && cachedStaffData.lastCheck) {
|
|
cachedStaffData.lastCheck = new Date().toISOString();
|
|
await setStaffData(cachedStaffData);
|
|
}
|
|
}
|
|
} else {
|
|
logger.info('Staff data is up-to-date.');
|
|
}
|
|
} catch (error) {
|
|
logger.error('Error initializing or updating staff cache:', error);
|
|
}
|
|
}
|