@cmdoss/memwal-sdk 0.6.2 → 0.7.0

package/dist/services/storage/QuiltBatchManager.d.ts

@@ -28,16 +28,37 @@ import { WalrusClient, WalrusFile } from '@mysten/walrus';
 import type { ClientWithExtensions } from '@mysten/sui/experimental';
 import type { SuiClient } from '@mysten/sui/client';
 import type { UnifiedSigner } from '../../client/signers/UnifiedSigner';
+/**
+ * Input for batch memory upload
+ */
 export interface BatchMemory {
     content: string;
     category: string;
     importance: number;
     topic: string;
     embedding: number[];
-    encryptedContent: Uint8Array;
+    encryptedContent?: Uint8Array;
     summary?: string;
     id?: string;
 }
+/**
+ * Memory package stored in Quilt as JSON
+ * This format is consistent with regular memory storage
+ */
+export interface QuiltMemoryPackage {
+    content: string;
+    embedding: number[];
+    metadata: {
+        category: string;
+        importance: number;
+        topic: string;
+        [key: string]: unknown;
+    };
+    timestamp: number;
+    version: string;
+    encrypted?: boolean;
+    encryptedContent?: string;
+}
 export interface QuiltUploadOptions {
     signer: UnifiedSigner;
     epochs?: number;
@@ -65,6 +86,15 @@ export interface QuiltRetrieveResult {
     tags: Record<string, string>;
     retrievalTimeMs: number;
 }
+/**
+ * Result when retrieving a memory package from Quilt
+ */
+export interface QuiltMemoryRetrieveResult {
+    identifier: string;
+    memoryPackage: QuiltMemoryPackage;
+    tags: Record<string, string>;
+    retrievalTimeMs: number;
+}
 export interface QuiltListResult {
     identifier: string;
     quiltPatchId: string;
@@ -195,6 +225,69 @@ export declare class QuiltBatchManager {
      * @returns Array of matching WalrusFile objects
      */
     getFilesByImportance(quiltId: string, minImportance: number): Promise<Array<WalrusFile>>;
+    /**
+     * Retrieve a memory package as JSON from a Quilt
+     *
+     * Uses file.json() for efficient parsing (SDK handles it)
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param identifier - The file identifier within the quilt
+     * @returns QuiltMemoryRetrieveResult with parsed memory package
+     */
+    getMemoryPackage(quiltId: string, identifier: string): Promise<QuiltMemoryRetrieveResult>;
+    /**
+     * Retrieve all memory packages from a Quilt as JSON
+     *
+     * @param quiltId - The Quilt blob ID
+     * @returns Array of memory packages with metadata
+     */
+    getAllMemoryPackages(quiltId: string): Promise<QuiltMemoryRetrieveResult[]>;
+    /**
+     * Find a specific memory in a Quilt using multiple matching strategies
+     *
+     * Strategies (in order of priority):
+     * 1. Match by tags['memory_id'] === memoryId
+     * 2. Match by identifier === `memory-${memoryId}.json`
+     * 3. Match by JSON metadata.memoryId === memoryId
+     * 4. Fallback to index-based matching (if fileIndex provided)
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param memoryId - The memory ID (usually vectorId) to find
+     * @param fileIndex - Optional fallback index if other strategies fail
+     * @returns The matching memory package result, or null if not found
+     */
+    findMemoryInQuilt(quiltId: string, memoryId: string, fileIndex?: number): Promise<QuiltMemoryRetrieveResult | null>;
+    /**
+     * Get memory content from a Quilt file
+     *
+     * Handles both encrypted and unencrypted content:
+     * - Unencrypted: Returns content directly from package
+     * - Encrypted: Returns decrypted content if sessionKey provided, otherwise throws
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param identifier - The file identifier
+     * @param sessionKey - Optional session key for encrypted content
+     * @returns Memory content as string
+     */
+    getMemoryContent(quiltId: string, identifier: string, decryptFn?: (encryptedBase64: string) => Promise<string>): Promise<string>;
+    /**
+     * Try to recover a partially truncated memory package
+     *
+     * Handles cases where JSON was truncated (e.g., in the middle of encryptedContent)
+     * by extracting metadata and marking the encrypted content as corrupted.
+     *
+     * @param bytes - Raw bytes of the file
+     * @returns Recovered QuiltMemoryPackage or null if recovery fails
+     */
+    private tryRecoverTruncatedPackage;
+    /**
+     * Convert Uint8Array to base64 string
+     */
+    private uint8ArrayToBase64;
+    /**
+     * Convert base64 string to Uint8Array
+     */
+    private base64ToUint8Array;
     /**
      * Get statistics
      */
@@ -206,5 +299,12 @@ export declare class QuiltBatchManager {
      * Get Walrus client
      */
     getWalrusClient(useRelay?: boolean): WalrusClient;
+    /**
+     * Get base64 converter (for external use)
+     */
+    getBase64Utils(): {
+        encode: (bytes: Uint8Array) => string;
+        decode: (base64: string) => Uint8Array;
+    };
 }
 //# sourceMappingURL=QuiltBatchManager.d.ts.map

package/dist/services/storage/QuiltBatchManager.d.ts.map

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

package/dist/services/storage/QuiltBatchManager.js

@@ -87,30 +87,64 @@ export class QuiltBatchManager {
         let totalSize = 0;
         console.log(`📦 Uploading batch of ${memories.length} memories as Quilt (writeFilesFlow)...`);
         try {
-            // Create WalrusFile for each memory with plaintext tags
+            // Create WalrusFile for each memory as JSON package
+            // This format is consistent with regular memory storage
             const files = memories.map((memory, index) => {
                 const identifier = memory.id
                     ? `memory-${memory.id}.json`
                     : `memory-${Date.now()}-${index}-${Math.random().toString(36).slice(2, 9)}.json`;
-                totalSize += memory.encryptedContent.length;
+                const isEncrypted = !!memory.encryptedContent && memory.encryptedContent.length > 0;
+                const timestamp = Date.now();
+                // Create memory package (JSON format - consistent with regular storage)
+                const memoryPackage = {
+                    // Content: plaintext if not encrypted, empty if encrypted
+                    content: isEncrypted ? '' : memory.content,
+                    embedding: memory.embedding,
+                    metadata: {
+                        category: memory.category,
+                        importance: memory.importance,
+                        topic: memory.topic,
+                        ...(memory.summary ? { summary: memory.summary } : {}),
+                        ...(memory.id ? { memoryId: memory.id } : {})
+                    },
+                    timestamp,
+                    version: '2.0.0', // Quilt JSON package version
+                    encrypted: isEncrypted,
+                    // Store encrypted content as base64 for JSON compatibility
+                    ...(isEncrypted && memory.encryptedContent ? {
+                        encryptedContent: this.uint8ArrayToBase64(memory.encryptedContent)
+                    } : {})
+                };
+                // Serialize to JSON and encode as bytes
+                const jsonString = JSON.stringify(memoryPackage);
+                const contents = new TextEncoder().encode(jsonString);
+                totalSize += contents.length;
+                // Diagnostic logging for debugging Quilt corruption issues
+                console.log(`   📝 File ${index}: identifier=${identifier}`);
+                console.log(`      JSON string length: ${jsonString.length} chars`);
+                console.log(`      Encoded bytes: ${contents.length} bytes`);
+                console.log(`      Last 50 chars of JSON: ...${jsonString.slice(-50)}`);
+                console.log(`      Last 10 bytes (hex): ${Array.from(contents.slice(-10)).map(b => b.toString(16).padStart(2, '0')).join(' ')}`);
                 return WalrusFile.from({
-                    contents: memory.encryptedContent,
+                    contents,
                     identifier,
                     tags: {
-                        // Core metadata (plaintext for filtering)
+                        // Core metadata (plaintext for filtering without decryption)
+                        'content-type': 'application/json',
                         'category': memory.category,
                         'importance': memory.importance.toString(),
                         'topic': memory.topic,
-                        'timestamp': new Date().toISOString(),
-                        'created_at': new Date().toISOString(),
+                        'timestamp': new Date(timestamp).toISOString(),
+                        'created_at': new Date(timestamp).toISOString(),
                         // Encryption info
-                        'encrypted': 'true',
-                        'encryption_type': 'seal',
+                        'encrypted': isEncrypted ? 'true' : 'false',
+                        ...(isEncrypted ? { 'encryption_type': 'seal' } : {}),
                         // Owner
                         'owner': options.userAddress,
                         // Content info
-                        'content_size': memory.encryptedContent.length.toString(),
+                        'content_size': contents.length.toString(),
                         'embedding_dimensions': memory.embedding.length.toString(),
+                        'package_version': '2.0.0',
                         // Optional rich metadata
                         ...(memory.summary ? { 'summary': memory.summary } : {}),
                         ...(memory.id ? { 'memory_id': memory.id } : {})
@@ -179,7 +213,7 @@ export class QuiltBatchManager {
                     blobId: quiltId,
                     quiltPatchId,
                     tags: Object.fromEntries(Object.entries(tags).map(([k, v]) => [k, String(v)])),
-                    size: memories[i]?.encryptedContent.length || 0
+                    size: memories[i]?.encryptedContent?.length || memories[i]?.content?.length || 0
                 };
             }));
             return {
@@ -314,10 +348,20 @@ export class QuiltBatchManager {
     async getQuiltFiles(quiltId) {
         try {
             console.log(`📂 Retrieving files from Quilt ${quiltId}...`);
-            // Use getBlob().files() to correctly parse Quilt and get individual files
-            const blob = await this.suiClient.walrus.getBlob({ blobId: quiltId });
-            const files = await blob.files();
-            console.log(`✅ Retrieved ${files.length} files from Quilt`);
+            // Try to parse as Quilt first (getBlob().files() returns ALL files in Quilt)
+            // Fall back to getFiles() for regular blobs
+            let files;
+            try {
+                const blob = await this.suiClient.walrus.getBlob({ blobId: quiltId });
+                files = await blob.files();
+                console.log(`✅ Retrieved ${files.length} files from Quilt`);
+            }
+            catch (quiltError) {
+                // Not a Quilt - try as regular blob
+                console.log(`📄 Not a Quilt format, fetching as regular blob...`);
+                files = await this.suiClient.walrus.getFiles({ ids: [quiltId] });
+                console.log(`✅ Retrieved ${files.length} file(s) as regular blob`);
+            }
             return files;
         }
         catch (error) {
@@ -338,9 +382,8 @@ export class QuiltBatchManager {
         const startTime = performance.now();
         try {
             console.log(`📄 Retrieving file "${identifier}" from Quilt ${quiltId}...`);
-            // Get all files from quilt using getBlob().files()
-            const blob = await this.suiClient.walrus.getBlob({ blobId: quiltId });
-            const files = await blob.files();
+            // Get all files from the blob (Quilt or regular)
+            const files = await this.getQuiltFiles(quiltId);
             // Find file by identifier
             let matchingFile;
             for (const f of files) {
@@ -380,9 +423,8 @@ export class QuiltBatchManager {
     async listQuiltPatches(quiltId) {
         try {
             console.log(`📋 Listing patches in Quilt ${quiltId}...`);
-            // Use getBlob().files() to correctly parse Quilt
-            const blob = await this.suiClient.walrus.getBlob({ blobId: quiltId });
-            const files = await blob.files();
+            // Get all files from the blob (Quilt or regular)
+            const files = await this.getQuiltFiles(quiltId);
             const results = await Promise.all(files.map(async (file) => {
                 const identifier = await file.getIdentifier() || 'unknown';
                 const tags = await file.getTags();
@@ -467,8 +509,347 @@ export class QuiltBatchManager {
         return matchingFiles;
     }
     // ==========================================================================
+    // JSON Memory Package Retrieval
+    // ==========================================================================
+    /**
+     * Retrieve a memory package as JSON from a Quilt
+     *
+     * Uses file.json() for efficient parsing (SDK handles it)
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param identifier - The file identifier within the quilt
+     * @returns QuiltMemoryRetrieveResult with parsed memory package
+     */
+    async getMemoryPackage(quiltId, identifier) {
+        const startTime = performance.now();
+        try {
+            console.log(`📄 Retrieving memory package "${identifier}" from Quilt ${quiltId}...`);
+            // Get all files from the blob
+            const files = await this.getQuiltFiles(quiltId);
+            // Find file by identifier
+            let matchingFile;
+            for (const f of files) {
+                const fileIdentifier = await f.getIdentifier();
+                if (fileIdentifier === identifier) {
+                    matchingFile = f;
+                    break;
+                }
+            }
+            if (!matchingFile) {
+                throw new Error(`File "${identifier}" not found in Quilt`);
+            }
+            const tags = await matchingFile.getTags();
+            let memoryPackage;
+            try {
+                // Parse directly as JSON (SDK handles it!)
+                memoryPackage = await matchingFile.json();
+            }
+            catch (parseError) {
+                // Try partial recovery for truncated JSON
+                console.warn(`⚠️ JSON parse failed for "${identifier}", attempting recovery...`);
+                const bytes = await matchingFile.bytes();
+                const recovered = this.tryRecoverTruncatedPackage(bytes);
+                if (recovered) {
+                    console.log(`🔧 Partially recovered "${identifier}" (encryptedContent may be corrupted)`);
+                    memoryPackage = recovered;
+                }
+                else {
+                    throw parseError;
+                }
+            }
+            const retrievalTimeMs = performance.now() - startTime;
+            console.log(`✅ Retrieved memory package "${identifier}" (${retrievalTimeMs.toFixed(1)}ms)`);
+            return {
+                identifier,
+                memoryPackage,
+                tags,
+                retrievalTimeMs
+            };
+        }
+        catch (error) {
+            console.error(`❌ Failed to retrieve memory package:`, error);
+            throw new Error(`Failed to retrieve memory package "${identifier}": ${error}`);
+        }
+    }
+    /**
+     * Retrieve all memory packages from a Quilt as JSON
+     *
+     * @param quiltId - The Quilt blob ID
+     * @returns Array of memory packages with metadata
+     */
+    async getAllMemoryPackages(quiltId) {
+        const startTime = performance.now();
+        try {
+            console.log(`📂 Retrieving all memory packages from Quilt ${quiltId}...`);
+            const files = await this.getQuiltFiles(quiltId);
+            const results = [];
+            for (const file of files) {
+                const identifier = await file.getIdentifier() || 'unknown';
+                const tags = await file.getTags();
+                try {
+                    // Parse as JSON
+                    const memoryPackage = await file.json();
+                    results.push({
+                        identifier,
+                        memoryPackage,
+                        tags,
+                        retrievalTimeMs: 0 // Individual timing not tracked in batch
+                    });
+                }
+                catch (parseError) {
+                    console.warn(`⚠️ Failed to parse "${identifier}" as JSON:`, parseError);
+                    // Try partial recovery for truncated JSON
+                    try {
+                        const bytes = await file.bytes();
+                        const recoveredPackage = this.tryRecoverTruncatedPackage(bytes);
+                        if (recoveredPackage) {
+                            console.log(`🔧 Partially recovered "${identifier}" (encryptedContent truncated)`);
+                            results.push({
+                                identifier,
+                                memoryPackage: recoveredPackage,
+                                tags,
+                                retrievalTimeMs: 0
+                            });
+                        }
+                    }
+                    catch {
+                        // Skip files that can't be recovered
+                        console.warn(`❌ Could not recover "${identifier}"`);
+                    }
+                }
+            }
+            const totalTimeMs = performance.now() - startTime;
+            console.log(`✅ Retrieved ${results.length} memory packages (${totalTimeMs.toFixed(1)}ms)`);
+            return results;
+        }
+        catch (error) {
+            console.error(`❌ Failed to retrieve memory packages:`, error);
+            throw new Error(`Failed to retrieve memory packages from Quilt ${quiltId}: ${error}`);
+        }
+    }
+    /**
+     * Find a specific memory in a Quilt using multiple matching strategies
+     *
+     * Strategies (in order of priority):
+     * 1. Match by tags['memory_id'] === memoryId
+     * 2. Match by identifier === `memory-${memoryId}.json`
+     * 3. Match by JSON metadata.memoryId === memoryId
+     * 4. Fallback to index-based matching (if fileIndex provided)
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param memoryId - The memory ID (usually vectorId) to find
+     * @param fileIndex - Optional fallback index if other strategies fail
+     * @returns The matching memory package result, or null if not found
+     */
+    async findMemoryInQuilt(quiltId, memoryId, fileIndex) {
+        const startTime = performance.now();
+        try {
+            console.log(`🔍 Finding memory "${memoryId}" in Quilt ${quiltId.substring(0, 20)}...`);
+            const files = await this.getQuiltFiles(quiltId);
+            let matchedFile;
+            let matchStrategy = '';
+            // Strategy 1: Match by tags['memory_id']
+            for (const f of files) {
+                const tags = await f.getTags();
+                if (tags?.['memory_id'] === memoryId) {
+                    matchedFile = f;
+                    matchStrategy = 'memory_id tag';
+                    break;
+                }
+            }
+            // Strategy 2: Match by identifier pattern "memory-{memoryId}.json"
+            if (!matchedFile) {
+                for (const f of files) {
+                    const identifier = await f.getIdentifier();
+                    if (identifier === `memory-${memoryId}.json`) {
+                        matchedFile = f;
+                        matchStrategy = 'identifier pattern';
+                        break;
+                    }
+                }
+            }
+            // Strategy 3: Parse JSON to find matching metadata.memoryId
+            if (!matchedFile) {
+                for (const f of files) {
+                    try {
+                        const json = await f.json();
+                        if (json?.metadata?.memoryId === memoryId) {
+                            matchedFile = f;
+                            matchStrategy = 'JSON metadata.memoryId';
+                            break;
+                        }
+                    }
+                    catch {
+                        // Not valid JSON, continue
+                    }
+                }
+            }
+            // Strategy 4: Fallback to index-based matching
+            if (!matchedFile && fileIndex !== undefined && fileIndex < files.length) {
+                matchedFile = files[fileIndex];
+                matchStrategy = `index fallback (${fileIndex})`;
+            }
+            if (!matchedFile) {
+                console.log(`❌ Memory "${memoryId}" not found in Quilt (${files.length} files)`);
+                return null;
+            }
+            const identifier = await matchedFile.getIdentifier() || 'unknown';
+            const tags = await matchedFile.getTags();
+            let memoryPackage;
+            try {
+                memoryPackage = await matchedFile.json();
+            }
+            catch (parseError) {
+                // Try recovery for truncated JSON
+                const bytes = await matchedFile.bytes();
+                const recovered = this.tryRecoverTruncatedPackage(bytes);
+                if (recovered) {
+                    memoryPackage = recovered;
+                }
+                else {
+                    throw parseError;
+                }
+            }
+            const retrievalTimeMs = performance.now() - startTime;
+            console.log(`✅ Found memory "${memoryId}" via ${matchStrategy} (${identifier}) in ${retrievalTimeMs.toFixed(1)}ms`);
+            return {
+                identifier,
+                memoryPackage,
+                tags,
+                retrievalTimeMs
+            };
+        }
+        catch (error) {
+            console.error(`❌ Failed to find memory in Quilt:`, error);
+            throw new Error(`Failed to find memory "${memoryId}" in Quilt ${quiltId}: ${error}`);
+        }
+    }
+    /**
+     * Get memory content from a Quilt file
+     *
+     * Handles both encrypted and unencrypted content:
+     * - Unencrypted: Returns content directly from package
+     * - Encrypted: Returns decrypted content if sessionKey provided, otherwise throws
+     *
+     * @param quiltId - The Quilt blob ID
+     * @param identifier - The file identifier
+     * @param sessionKey - Optional session key for encrypted content
+     * @returns Memory content as string
+     */
+    async getMemoryContent(quiltId, identifier, decryptFn) {
+        const result = await this.getMemoryPackage(quiltId, identifier);
+        const pkg = result.memoryPackage;
+        if (!pkg.encrypted) {
+            // Not encrypted - return content directly
+            return pkg.content;
+        }
+        if (!pkg.encryptedContent) {
+            throw new Error('Memory is marked as encrypted but no encrypted content found');
+        }
+        if (!decryptFn) {
+            throw new Error('Memory is encrypted. Provide decryptFn to decrypt content.');
+        }
+        // Decrypt using provided function
+        return await decryptFn(pkg.encryptedContent);
+    }
+    // ==========================================================================
     // Utility Methods
     // ==========================================================================
+    /**
+     * Try to recover a partially truncated memory package
+     *
+     * Handles cases where JSON was truncated (e.g., in the middle of encryptedContent)
+     * by extracting metadata and marking the encrypted content as corrupted.
+     *
+     * @param bytes - Raw bytes of the file
+     * @returns Recovered QuiltMemoryPackage or null if recovery fails
+     */
+    tryRecoverTruncatedPackage(bytes) {
+        try {
+            const rawString = new TextDecoder().decode(bytes);
+            // Find and trim trailing null bytes
+            let lastValidIndex = rawString.length - 1;
+            while (lastValidIndex >= 0 && rawString.charCodeAt(lastValidIndex) === 0) {
+                lastValidIndex--;
+            }
+            const trimmedString = rawString.slice(0, lastValidIndex + 1);
+            // First try to parse as-is (maybe nulls were the only issue)
+            try {
+                return JSON.parse(trimmedString);
+            }
+            catch {
+                // Continue to partial recovery
+            }
+            // Look for encryptedContent field - data likely truncated there
+            const encryptedIdx = trimmedString.indexOf('"encryptedContent":"');
+            if (encryptedIdx > 0) {
+                // Extract everything before encryptedContent
+                const beforeEncrypted = trimmedString.slice(0, encryptedIdx);
+                // Remove trailing comma and close the object
+                const cleanedJson = beforeEncrypted.replace(/,\s*$/, '') + '}';
+                try {
+                    const partialPackage = JSON.parse(cleanedJson);
+                    return {
+                        ...partialPackage,
+                        encrypted: true,
+                        encryptedContent: '[CORRUPTED - data truncated during storage]'
+                    };
+                }
+                catch {
+                    // Partial extraction failed
+                }
+            }
+            // Try to find the last complete JSON object by looking for closing brace
+            // This handles cases where truncation happened elsewhere
+            for (let i = trimmedString.length - 1; i >= 0; i--) {
+                if (trimmedString[i] === '}') {
+                    try {
+                        const candidate = trimmedString.slice(0, i + 1);
+                        return JSON.parse(candidate);
+                    }
+                    catch {
+                        // This position doesn't form valid JSON, try earlier
+                        continue;
+                    }
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Convert Uint8Array to base64 string
+     */
+    uint8ArrayToBase64(bytes) {
+        // Use Buffer in Node.js, btoa in browser
+        if (typeof Buffer !== 'undefined') {
+            return Buffer.from(bytes).toString('base64');
+        }
+        // Browser fallback
+        let binary = '';
+        for (let i = 0; i < bytes.length; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return btoa(binary);
+    }
+    /**
+     * Convert base64 string to Uint8Array
+     */
+    base64ToUint8Array(base64) {
+        // Use Buffer in Node.js, atob in browser
+        if (typeof Buffer !== 'undefined') {
+            return new Uint8Array(Buffer.from(base64, 'base64'));
+        }
+        // Browser fallback
+        const binary = atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
     /**
      * Get statistics
      */
@@ -486,5 +867,14 @@ export class QuiltBatchManager {
             ? this.walrusWithRelay
             : this.walrusWithoutRelay;
     }
+    /**
+     * Get base64 converter (for external use)
+     */
+    getBase64Utils() {
+        return {
+            encode: this.uint8ArrayToBase64.bind(this),
+            decode: this.base64ToUint8Array.bind(this)
+        };
+    }
 }
 //# sourceMappingURL=QuiltBatchManager.js.map