@flightdev/cache-tiered

Tiered cache adapter for Flight Framework. Combine multiple cache layers for optimal performance.

Installation

bash

npm install @flightdev/cache-tiered





Quick Start

typescript

import { createCache } from '@flightdev/core/cache';

import { tiered } from '@flightdev/cache-tiered';

import { lru } from '@flightdev/cache-lru';

import { redis } from '@flightdev/cache-redis';



const cache = createCache(tiered([

    lru({ max: 100, ttl: 60000 }),        // L1: Fast in-memory

    redis({ url: process.env.REDIS_URL }), // L2: Shared Redis

]));



// Reads check L1 first, then L2

// Writes go to all layers

await cache.set('key', 'value');

const value = await cache.get('key');





Configuration

typescript

tiered([

    // Layers in order of priority (fastest first)

    memoryAdapter,

    redisAdapter,

    s3Adapter,  // For very large/cold data

], {

    // Write to all layers on set (default: true)

    writeThrough: true,

    

    // Populate faster layers on cache miss (default: true)

    populateOnMiss: true,

});

How It Works

1. Read: Check L1 -> L2 -> L3 until found
2. Write: Write to all layers
3. Miss: Populate faster layers with the value

License

MIT