rename keyFragments to namespace

Author: sushichan044

src/cache.ts

@@ -25,30 +25,28 @@ const ONE_WEEK = 1000 * 60 * 60 * 24 * 7
 
 interface CachedStorageOptions {
   /**
-   * Array of fragments used to construct the cache key prefix.
-   * Each fragment can be a string or an object (which will be hashed).
-   * This allows cache isolation across different contexts (e.g., provider configurations).
+   * Namespace fragments to isolate cache keys.
    *
    * @example
    * ```ts
    * // Isolate cache per provider configuration
    * const providerName = 'some-awesome-font-provider'
    * const providerOptions = { apiKey: 'xxx', subset: 'latin' }
    * createCachedAsyncStorage(storage, {
-   *   keyFragments: [providerName, providerOptions]
+   *   namespace: [providerName, providerOptions]
    * })
    * ```
    */
-  keyFragments?: any[]
+  namespace?: any[]
 }
 
 export function createCachedAsyncStorage(storage: Storage, options: CachedStorageOptions = {}) {
   function resolveKey(key: string): string {
-    if (!options?.keyFragments || options.keyFragments.length === 0) {
+    if (!options?.namespace || options.namespace.length === 0) {
       return key
     }
 
-    return `${createCacheKey(...options.keyFragments)}:${key}`
+    return `${createCacheKey(...options.namespace)}:${key}`
   }
 
   return {

src/index.ts

@@ -42,7 +42,7 @@ export async function createUnifont(providers: Provider[], options?: UnifontOpti
   function createProviderAwareStorage(providerName: string, providerOptions: unknown): ProviderContext['storage'] {
     // https://github.com/unjs/unifont/issues/184
     return createCachedAsyncStorage(storageImpl, {
-      keyFragments: [providerName, providerOptions],
+      namespace: [providerName, providerOptions],
     })
   }
 

test/cache.test.ts

@@ -65,7 +65,7 @@ describe('cache storage', () => {
         setItem: vi.fn(),
       }
       const cached = createCachedAsyncStorage(storage, {
-        keyFragments: ['provider-name', { a: 1 }, 'variant-a'],
+        namespace: ['provider-name', { a: 1 }, 'variant-a'],
       })
       await cached.setItem('test-key', 'data')
 
@@ -82,10 +82,10 @@ describe('cache storage', () => {
       }
 
       const cachedA = createCachedAsyncStorage(storage, {
-        keyFragments: [{ variant: 'A' }],
+        namespace: [{ variant: 'A' }],
       })
       const cachedB = createCachedAsyncStorage(storage, {
-        keyFragments: [{ variant: 'B' }],
+        namespace: [{ variant: 'B' }],
       })
       await cachedA.setItem('key', 'data')
       await cachedB.setItem('key', 'data')
@@ -110,7 +110,7 @@ describe('cache storage', () => {
         setItem: vi.fn(),
       }
       const cached = createCachedAsyncStorage(storage, {
-        keyFragments: [input],
+        namespace: [input],
       })
 
       await cached.setItem('test-key', 'data')