VAULT

Vault is a high-performance, type-safe resource management library for Roblox Luau. It provides automatic cleanup of connections, instances, promises, threads, and custom objects with intelligent method detection, hierarchical organization, and zero memory leaks.

FEATURES

High Performance

• --!optimize 2 --!strict compiler flags for maximum runtime efficiency
• rawget() direct lookups bypass table prototype chains for method detection
• Global CLEANUP_CACHE stores cleanup functions by typeof() - no recreation overhead
• Sequential numeric tokens enable O(1) Add()/Remove() operations
• Weak metatable (__mode = 'k') for automatic internal state cleanup
• O(1) critical path: Add, Remove, Size, Contains operations

Type Safe

• 15+ CleanableObject union types: Instance, RBXScriptConnection, Promise, thread, functions
• Generic signal support: <T...> for RBXScriptSignal + CustomSignal
• Constructor generics: <T, A...> with perfect type inference
• Metatable method detection with full __index support

Hierarchical Management

MainVault
├── Child1 (Extend)
│   └── DeferredScope (Defer)
├── Child2 (Extend)  
└── ImportedVault (Import)

• Automatic cascade cleanup - Clean() recursively cleans all children
• Parent-child unlink - children automatically removed from parent array
• Scoped inheritance - children inherit parent's cleanup lifecycle

Intelligent Detection

Detection Priority (fast → slow):
1. Custom CleanupStrategy (function or method string)
2. typeof() cached cleanup (Instance→Destroy(), RBXScriptConnection→Disconnect())
3. Promise status validation (getStatus() + cancel if 'Started')
4. Direct methods: Destroy/destroy, Disconnect/disconnect
5. Metatable.__index: Destroy/destroy, Disconnect/disconnect

API COMPLEXITY

Vault guarantees zero memory leaks with deterministic cleanup across all Roblox resource types while maintaining industry-leading performance.