Added new Cacheable method `Object get(String key, System.Type cacheB…

…uilderClass)` (#6)

* feat: add get key cachebuilder API

* test improvements for containsAll, cache disabled spec, and implemented `validateKey` spec

* build: set husky as executable, updated lock dependencies

README.md

@@ -4,15 +4,15 @@ A flexible cache management system for Salesforce Apex developers. Built to be s
 
 Learn more about the history & implementation of this repo in [the Joys of Apex article 'Iteratively Building a Flexible Caching System for Apex'](https://www.jamessimone.net/blog/joys-of-apex/iteratively-building-a-flexible-caching-system/)
 
-## Unlocked Package - `Nebula` Namespace - v1.0.0
+## Unlocked Package - `Nebula` Namespace - v1.0.1
 
-[![Install Unlocked Package (Nebula namespace) in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n2AQAQ)
-[![Install Unlocked Package (Nebula namespace) in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n2AQAQ)
+[![Install Unlocked Package (Nebula namespace) in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n6rQAA)
+[![Install Unlocked Package (Nebula namespace) in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n6rQAA)
 
-## Unlocked Package - No Namespace - v1.0.0
+## Unlocked Package - No Namespace - v1.0.1
 
-[![Install Unlocked Package (no namespace) in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n25QAA)
-[![Install Unlocked Package (no namespace) in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n25QAA)
+[![Install Unlocked Package (no namespace) in a Sandbox](./images/btn-install-unlocked-package-sandbox.png)](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n6hQAA)
+[![Install Unlocked Package (no namespace) in Production](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y0000015n6hQAA)
 
 ---
 

nebula-cache-manager/core/classes/CacheManager.cls

@@ -41,6 +41,7 @@ public without sharing class CacheManager {
     Map<String, Boolean> contains(Set<String> keys);
     Boolean containsAll(Set<String> keys);
     Object get(String key);
+    Object get(String key, System.Type cacheBuilderClass);
     Map<String, Object> get(Set<String> keys);
     Map<String, Object> getAll();
     Set<String> getKeys();
@@ -86,6 +87,7 @@ public without sharing class CacheManager {
     cacheTypeToMockPartitionProxy.put(cacheType, mockPartitionProxy);
   }
 
+  @TestVisible
   private static void validateKey(String key) {
     Matcher regexMatcher = ALPHANUMERIC_REGEX_PATTERN.matcher(key);
     if (regexMatcher.matches() == false) {
@@ -161,7 +163,7 @@ public without sharing class CacheManager {
 
     public Boolean containsAll(Set<String> keys) {
       Map<String, Boolean> keyToContainsResult = this.contains(keys);
-      if (keyToContainsResult == null || keyToContainsResult.isEmpty() == true) {
+      if (keyToContainsResult.isEmpty() == true) {
         return false;
       }
 
@@ -188,6 +190,19 @@ public without sharing class CacheManager {
       }
     }
 
+    public Object get(String key, System.Type cacheBuilderClass) {
+      if (this.fallbackTransactionCache.contains(key)) {
+        return this.fallbackTransactionCache.get(key);
+      } else if (this.cachePartitionProxy.isAvailable() == false) {
+        return this.fallbackTransactionCache.get(key, cacheBuilderClass);
+      } else {
+        // Cache.CacheBuilder.doLoad method can return null
+        Object value = this.cachePartitionProxy.get(key, cacheBuilderClass);
+        this.fallbackTransactionCache.put(key, value);
+        return value;
+      }
+    }
+
     public Map<String, Object> get(Set<String> keys) {
       Map<String, Object> keyToValue = this.cachePartitionProxy.get(keys);
       if (keyToValue == null) {
@@ -315,6 +330,10 @@ public without sharing class CacheManager {
       return this.platformCachePartition?.get(key);
     }
 
+    public virtual Object get(String key, System.Type cacheBuilderClass) {
+      return this.platformCachePartition?.get(cacheBuilderClass, key);
+    }
+
     public virtual Map<String, Object> get(Set<String> keys) {
       return this.platformCachePartition?.get(keys);
     }
@@ -367,6 +386,15 @@ public without sharing class CacheManager {
       return this.keyToValue.get(key);
     }
 
+    public Object get(String key, System.Type cacheBuilderClass) {
+      if (this.contains(key) == false) {
+        Cache.CacheBuilder cacheBuilder = (Cache.CacheBuilder) cacheBuilderClass.newInstance();
+        Object value = cacheBuilder.doLoad(key);
+        this.put(key, value);
+      }
+      return this.get(key);
+    }
+
     public Map<String, Object> get(Set<String> keys) {
       Map<String, Object> matchingKeyToValue = new Map<String, Object>();
       for (String key : keys) {