@agent-foundry/replay-server 1.0.0 → 1.0.1

package/dist/services/BundleManager.js

@@ -0,0 +1,410 @@
+/**
+ * Bundle Manager
+ *
+ * Manages bundle lifecycle: download, extraction, caching, and cleanup.
+ * Uses LRU eviction to manage cache size.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { createGunzip } from 'zlib';
+import { extract } from 'tar-stream';
+/**
+ * Error thrown by bundle manager operations
+ */
+export class BundleManagerError extends Error {
+    code;
+    bundleId;
+    constructor(message, code, bundleId) {
+        super(message);
+        this.code = code;
+        this.bundleId = bundleId;
+        this.name = 'BundleManagerError';
+    }
+}
+/**
+ * Bundle Manager for downloading, caching, and serving game bundles
+ */
+export class BundleManager {
+    bundlesDir;
+    maxCacheSize;
+    ossClient;
+    bundles = new Map();
+    downloadPromises = new Map();
+    bundlesInUse = new Set();
+    downloadStats = {
+        active: 0,
+        completed: 0,
+        failed: 0,
+    };
+    constructor(config) {
+        this.bundlesDir = config.bundlesDir;
+        this.maxCacheSize = config.maxCacheSize;
+        this.ossClient = config.ossClient;
+        // Ensure bundles directory exists
+        fs.mkdirSync(this.bundlesDir, { recursive: true });
+        // Load existing bundles from disk
+        this.loadCachedBundles();
+    }
+    /**
+     * Ensure a bundle is available (download if needed)
+     * Returns the path to the bundle directory
+     */
+    async ensureBundle(bundleId, bundleUrl) {
+        const bundlePath = path.join(this.bundlesDir, bundleId);
+        // Check if already cached
+        if (this.isCached(bundleId)) {
+            // Update last accessed time
+            const info = this.bundles.get(bundleId);
+            if (info) {
+                info.lastAccessedAt = new Date();
+            }
+            return bundlePath;
+        }
+        // Check if already downloading
+        if (this.downloadPromises.has(bundleId)) {
+            console.log(`[BundleManager] Waiting for existing download: ${bundleId}`);
+            return this.downloadPromises.get(bundleId);
+        }
+        // Need to download
+        if (!bundleUrl) {
+            throw new BundleManagerError(`Bundle ${bundleId} not cached and no bundleUrl provided`, 'BUNDLE_URL_REQUIRED', bundleId);
+        }
+        // Start download
+        const downloadPromise = this.downloadBundle(bundleId, bundleUrl);
+        this.downloadPromises.set(bundleId, downloadPromise);
+        try {
+            const result = await downloadPromise;
+            return result;
+        }
+        finally {
+            this.downloadPromises.delete(bundleId);
+        }
+    }
+    /**
+     * Check if a bundle is cached and ready
+     */
+    isCached(bundleId) {
+        const bundlePath = path.join(this.bundlesDir, bundleId);
+        const indexPath = path.join(bundlePath, 'index.html');
+        return fs.existsSync(bundlePath) && fs.existsSync(indexPath);
+    }
+    /**
+     * Mark bundle as in use (prevents eviction during rendering)
+     */
+    markInUse(bundleId) {
+        this.bundlesInUse.add(bundleId);
+    }
+    /**
+     * Mark bundle as no longer in use
+     */
+    markNotInUse(bundleId) {
+        this.bundlesInUse.delete(bundleId);
+    }
+    /**
+     * Download and extract a bundle
+     */
+    async downloadBundle(bundleId, bundleUrl) {
+        const bundlePath = path.join(this.bundlesDir, bundleId);
+        const tempPath = `${bundlePath}.downloading`;
+        const archivePath = `${bundlePath}.tar.gz`;
+        // Initialize bundle info
+        this.bundles.set(bundleId, {
+            bundleId,
+            bundleUrl,
+            status: 'downloading',
+            progress: 0,
+        });
+        this.downloadStats.active++;
+        try {
+            console.log(`[BundleManager] Downloading bundle ${bundleId} from ${bundleUrl}`);
+            // Ensure cache has space
+            await this.ensureCacheSpace(100 * 1024 * 1024); // Reserve 100MB
+            // Download archive
+            await this.ossClient.downloadFile(bundleUrl, archivePath, (percent) => {
+                const info = this.bundles.get(bundleId);
+                if (info) {
+                    info.progress = percent;
+                }
+            });
+            console.log(`[BundleManager] Extracting bundle ${bundleId}...`);
+            // Create temp directory for extraction
+            fs.mkdirSync(tempPath, { recursive: true });
+            // Extract TAR.GZ
+            await this.extractTarGz(archivePath, tempPath);
+            // Clean up archive
+            fs.unlinkSync(archivePath);
+            // Move temp to final location
+            if (fs.existsSync(bundlePath)) {
+                fs.rmSync(bundlePath, { recursive: true });
+            }
+            fs.renameSync(tempPath, bundlePath);
+            // Verify extraction
+            const indexPath = path.join(bundlePath, 'index.html');
+            if (!fs.existsSync(indexPath)) {
+                throw new BundleManagerError(`Bundle extraction failed: index.html not found`, 'EXTRACTION_INVALID', bundleId);
+            }
+            // Calculate bundle size
+            const size = this.getDirectorySize(bundlePath);
+            // Update bundle info
+            this.bundles.set(bundleId, {
+                bundleId,
+                bundleUrl,
+                status: 'ready',
+                size,
+                cachedAt: new Date(),
+                lastAccessedAt: new Date(),
+            });
+            this.downloadStats.active--;
+            this.downloadStats.completed++;
+            console.log(`[BundleManager] Bundle ${bundleId} ready (${(size / 1024 / 1024).toFixed(2)} MB)`);
+            return bundlePath;
+        }
+        catch (error) {
+            // Cleanup on error
+            for (const p of [tempPath, archivePath, bundlePath]) {
+                if (fs.existsSync(p)) {
+                    try {
+                        fs.rmSync(p, { recursive: true });
+                    }
+                    catch {
+                        // Ignore cleanup errors
+                    }
+                }
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.bundles.set(bundleId, {
+                bundleId,
+                bundleUrl,
+                status: 'error',
+                error: errorMessage,
+            });
+            this.downloadStats.active--;
+            this.downloadStats.failed++;
+            throw new BundleManagerError(`Failed to download bundle ${bundleId}: ${errorMessage}`, 'DOWNLOAD_FAILED', bundleId);
+        }
+    }
+    /**
+     * Extract TAR.GZ archive to destination directory
+     */
+    async extractTarGz(archivePath, destPath) {
+        return new Promise((resolve, reject) => {
+            const extractStream = extract();
+            const entries = [];
+            extractStream.on('entry', (header, stream, next) => {
+                let filePath = path.join(destPath, header.name);
+                // Handle case where archive has a single root directory
+                // (common with GitHub releases: bundle-v1.0.0/index.html)
+                entries.push(header.name);
+                if (header.type === 'directory') {
+                    fs.mkdirSync(filePath, { recursive: true });
+                    stream.resume();
+                    next();
+                }
+                else if (header.type === 'file') {
+                    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+                    const writeStream = fs.createWriteStream(filePath);
+                    stream.pipe(writeStream);
+                    stream.on('end', () => {
+                        writeStream.end();
+                        next();
+                    });
+                    stream.on('error', reject);
+                    writeStream.on('error', reject);
+                }
+                else {
+                    // Skip other types (symlinks, etc.)
+                    stream.resume();
+                    next();
+                }
+            });
+            extractStream.on('finish', () => {
+                // Check if all files are in a subdirectory
+                // If so, move them up one level
+                const subdirs = fs.readdirSync(destPath);
+                if (subdirs.length === 1) {
+                    const subdir = path.join(destPath, subdirs[0]);
+                    if (fs.statSync(subdir).isDirectory()) {
+                        // Check if index.html is in subdirectory
+                        if (fs.existsSync(path.join(subdir, 'index.html'))) {
+                            // Move all files up
+                            const files = fs.readdirSync(subdir);
+                            for (const file of files) {
+                                fs.renameSync(path.join(subdir, file), path.join(destPath, file));
+                            }
+                            fs.rmdirSync(subdir);
+                        }
+                    }
+                }
+                resolve();
+            });
+            extractStream.on('error', reject);
+            const gunzip = createGunzip();
+            gunzip.on('error', reject);
+            const readStream = fs.createReadStream(archivePath);
+            readStream.on('error', reject);
+            readStream.pipe(gunzip).pipe(extractStream);
+        });
+    }
+    /**
+     * Ensure cache has enough space by evicting old bundles
+     */
+    async ensureCacheSpace(requiredBytes) {
+        const stats = this.getCacheStats();
+        const availableBytes = this.maxCacheSize - stats.used;
+        if (availableBytes >= requiredBytes) {
+            return;
+        }
+        const bytesToFree = requiredBytes - availableBytes;
+        let freedBytes = 0;
+        // Get bundles sorted by last accessed time (oldest first)
+        const evictionCandidates = Array.from(this.bundles.entries())
+            .filter(([id, info]) => {
+            return (info.status === 'ready' &&
+                !this.bundlesInUse.has(id) &&
+                !this.downloadPromises.has(id));
+        })
+            .sort(([, a], [, b]) => {
+            const aTime = a.lastAccessedAt?.getTime() || 0;
+            const bTime = b.lastAccessedAt?.getTime() || 0;
+            return aTime - bTime;
+        });
+        for (const [bundleId, info] of evictionCandidates) {
+            if (freedBytes >= bytesToFree) {
+                break;
+            }
+            console.log(`[BundleManager] Evicting bundle ${bundleId} to free space`);
+            this.removeBundle(bundleId);
+            freedBytes += info.size || 0;
+        }
+        if (freedBytes < bytesToFree) {
+            throw new BundleManagerError(`Unable to free enough cache space (needed: ${bytesToFree}, freed: ${freedBytes})`, 'CACHE_FULL');
+        }
+    }
+    /**
+     * Load existing bundles from disk
+     */
+    loadCachedBundles() {
+        if (!fs.existsSync(this.bundlesDir)) {
+            return;
+        }
+        const entries = fs.readdirSync(this.bundlesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            // Skip temp directories
+            if (entry.name.endsWith('.downloading') || entry.name.endsWith('.tar.gz')) {
+                // Clean up orphaned temp files
+                try {
+                    fs.rmSync(path.join(this.bundlesDir, entry.name), { recursive: true });
+                }
+                catch {
+                    // Ignore
+                }
+                continue;
+            }
+            const bundlePath = path.join(this.bundlesDir, entry.name);
+            const indexPath = path.join(bundlePath, 'index.html');
+            if (fs.existsSync(indexPath)) {
+                const stats = fs.statSync(bundlePath);
+                const size = this.getDirectorySize(bundlePath);
+                this.bundles.set(entry.name, {
+                    bundleId: entry.name,
+                    status: 'ready',
+                    size,
+                    cachedAt: stats.mtime,
+                    lastAccessedAt: stats.mtime,
+                });
+            }
+        }
+        console.log(`[BundleManager] Loaded ${this.bundles.size} cached bundles`);
+    }
+    /**
+     * Get directory size recursively
+     */
+    getDirectorySize(dirPath) {
+        let size = 0;
+        try {
+            const files = fs.readdirSync(dirPath);
+            for (const file of files) {
+                const filePath = path.join(dirPath, file);
+                const stats = fs.statSync(filePath);
+                if (stats.isDirectory()) {
+                    size += this.getDirectorySize(filePath);
+                }
+                else {
+                    size += stats.size;
+                }
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        return size;
+    }
+    /**
+     * List all bundles
+     */
+    listBundles() {
+        return Array.from(this.bundles.values());
+    }
+    /**
+     * Get bundle info
+     */
+    getBundleInfo(bundleId) {
+        return this.bundles.get(bundleId);
+    }
+    /**
+     * Remove bundle from cache
+     */
+    removeBundle(bundleId) {
+        const bundlePath = path.join(this.bundlesDir, bundleId);
+        if (fs.existsSync(bundlePath)) {
+            try {
+                fs.rmSync(bundlePath, { recursive: true });
+            }
+            catch (error) {
+                console.error(`[BundleManager] Failed to remove bundle ${bundleId}:`, error);
+            }
+        }
+        this.bundles.delete(bundleId);
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        let used = 0;
+        let count = 0;
+        for (const info of this.bundles.values()) {
+            if (info.status === 'ready' && info.size) {
+                used += info.size;
+                count++;
+            }
+        }
+        return {
+            used,
+            max: this.maxCacheSize,
+            usedPercent: Math.round((used / this.maxCacheSize) * 100),
+            bundleCount: count,
+        };
+    }
+    /**
+     * Get download statistics
+     */
+    getDownloadStats() {
+        return { ...this.downloadStats };
+    }
+    /**
+     * Get bundles directory path
+     */
+    getBundlesDir() {
+        return this.bundlesDir;
+    }
+}
+/**
+ * Create a bundle manager instance
+ */
+export function createBundleManager(config) {
+    return new BundleManager(config);
+}
+//# sourceMappingURL=BundleManager.js.map

package/dist/services/BundleManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BundleManager.js","sourceRoot":"","sources":["../../src/services/BundleManager.ts"],"names":[],"mappings":"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"}

package/dist/services/OSSClient.d.ts

@@ -0,0 +1,51 @@
+/**
+ * OSS Client
+ *
+ * Handles authenticated downloads from Alibaba Cloud OSS using STS credentials
+ * obtained from the BFF API.
+ */
+import type { STSCredentials, OSSClientConfig } from './types.js';
+/**
+ * Error thrown by OSS client operations
+ */
+export declare class OSSClientError extends Error {
+    readonly code: string;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined);
+}
+/**
+ * OSS Client for downloading bundles with STS authentication
+ */
+export declare class OSSClient {
+    private readonly bffBaseUrl;
+    private readonly serviceToken?;
+    private readonly timeout;
+    private cachedCredentials;
+    private credentialsExpiresAt;
+    constructor(config: OSSClientConfig);
+    /**
+     * Get STS credentials from BFF API
+     * Caches credentials until they expire (with 5 minute buffer)
+     *
+     * Uses the /studio/service/sts endpoint which requires BFF_SERVICE_TOKEN
+     * (set to SUPABASE_JWT_SECRET) for service-to-service authentication.
+     */
+    getSTSCredentials(): Promise<STSCredentials>;
+    /**
+     * Download file from OSS URL with STS authentication
+     *
+     * @param url - OSS URL to download from
+     * @param destPath - Local destination path
+     * @param onProgress - Optional progress callback (0-100)
+     */
+    downloadFile(url: string, destPath: string, onProgress?: (percent: number) => void): Promise<void>;
+    /**
+     * Clear cached credentials
+     */
+    clearCredentialsCache(): void;
+}
+/**
+ * Create an OSS client instance
+ */
+export declare function createOSSClient(config: OSSClientConfig): OSSClient;
+//# sourceMappingURL=OSSClient.d.ts.map

package/dist/services/OSSClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OSSClient.d.ts","sourceRoot":"","sources":["../../src/services/OSSClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA;CAK1C;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,oBAAoB,CAAqB;gBAErC,MAAM,EAAE,eAAe;IAMnC;;;;;;OAMG;IACG,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC;IA8GlD;;;;;;OAMG;IACG,YAAY,CACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACvC,OAAO,CAAC,IAAI,CAAC;IAoGhB;;OAEG;IACH,qBAAqB,IAAI,IAAI;CAIhC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAElE"}