Add multi cache provider with cascade fallback support

[Copilot]

Description

Introduces a new "multi" cache provider that cascades through multiple cache backends in order, returning the first hit. Enables multi-tier cache hierarchies (e.g., memory → redis → file).

Core behavior:

• Reads: Check caches sequentially, return first match
• Writes: Broadcast to all caches in parallel
• Deletes: Remove from all caches in parallel
• Increments: Atomic in first cache, sync result to others

Config example:

{
  caches: {
    l1: { provider: 'memory', config: { maxSize: 1000 } },
    l2: { provider: 'redis', config: { url: 'redis://...' } },
    tiered: {
      provider: 'multi',
      config: { caches: ['l1', 'l2'] }
    }
  }
}

Usage:

const cache = cache('tiered');
await cache.put('key', value);     // → writes to l1 and l2
const hit = await cache.get('key'); // → checks l1, then l2

Implementation:

• MultiCacheProvider class implementing CacheProviderInterface
• Config resolver in cache facade converts cache names to provider instances
• Validation prevents circular references and nested multi caches
• Requires minimum 1 cache in array

Checklist

• lint/prettier
• updated docs with new feature/details
• added tests that cover changes
• Add jsdocs for any added function/class

Original prompt

---

This section details on the original issue you should resolve

<issue_title>multicache provider</issue_title>
<issue_description>i want to introduce a new cache where it gets two or more other caches.

it should always use first cache and if no result is found then check the next cache.

make it possible to pass caches as array and account for array length to be longer or equal to one.

call this "multi" cache provider.

when adding it to pashmak make sure the config uses name of other caches already defined.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes multicache provider #144

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[devbro1]

change in approach, multicache shall recieve an array of caches to work with, not configs
@copilot