Storage

export declare class DynamoDBStorage implements StorageDriver {
    constructor(config?: DynamoDBStorageConfig);
    initialize(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export interface DynamoDBStorageConfig {
    tableName?: string;
    region?: string;
    endpoint?: string;
    credentials?: {
        accessKeyId: string;
        secretAccessKey: string;
    };
}

export declare class InMemoryStorage implements StorageDriver {
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export declare class MongoDBStorage implements StorageDriver {
    constructor(uri: string, dbName?: string, collectionName?: string);
    initialize(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export declare class MySQLStorage implements StorageDriver {
    constructor(config?: MySQLStorageConfig);
    initialize(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export interface MySQLStorageConfig {
    host?: string;
    port?: number;
    user?: string;
    password?: string;
    database?: string;
    connectionString?: string;
    tableName?: string;
}

export declare class PostgresStorage implements StorageDriver {
    constructor(connectionString: string);
    initialize(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export declare class RedisStorage implements StorageDriver {
    constructor(config?: RedisStorageConfig);
    initialize(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export interface RedisStorageConfig {
    host?: string;
    port?: number;
    password?: string;
    db?: number;
    url?: string;
    keyPrefix?: string;
    ttl?: number;
}

/**
 * Wraps any `StorageDriver` and namespaces every key by tenant / user, providing
 * multi-tenant isolation without requiring per-driver changes.
 *
 * Namespace transformation:
 *   "sessions" + scope { tenantId: "acme", userId: "u1" }
 *   -> "tenant:acme:user:u1:sessions"
 */
export declare class ScopedStorage implements StorageDriver {
    constructor(inner: StorageDriver, scope: StorageScope);
    initialize(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export declare class SqliteStorage implements StorageDriver {
    constructor(dbPath: string);
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export interface StorageDriver {
    initialize?(): Promise<void>;
    get<T>(namespace: string, key: string): Promise<T | null>;
    set<T>(namespace: string, key: string, value: T): Promise<void>;
    delete(namespace: string, key: string): Promise<void>;
    list<T>(namespace: string, prefix?: string): Promise<Array<{
        key: string;
        value: T;
    }>>;
    close(): Promise<void>;
}

export interface StorageScope {
    /** Tenant / organization identifier. */
    tenantId?: string;
    /** User identifier within the tenant. */
    userId?: string;
}