/**
 * @license
 * Copyright 2022-2026 Matter.js Authors
 * SPDX-License-Identifier: Apache-2.0
 */
import { Bytes } from "#util/Bytes.js";
import type { Directory } from "../fs/Directory.js";
import { MaybePromise } from "../util/Promises.js";
import { BaseStorageDriver, type StorageType } from "./BaseStorageDriver.js";
import { DatafileRoot } from "./DatafileRoot.js";
import type { DataNamespace } from "./DataNamespace.js";
/**
 * Storage driver for binary blob data, separate from key-value storage.
 * Contexts map to directories; keys map to individual blobs.
 */
export declare abstract class BlobStorageDriver extends BaseStorageDriver {
    readonly type: "blob";
    abstract openBlob(contexts: string[], key: string): MaybePromise<Blob>;
    abstract writeBlobFromStream(contexts: string[], key: string, stream: ReadableStream<Bytes>): MaybePromise<void>;
}
/**
 * {@link BlobStorageDriver} subclass for drivers backed by the filesystem.
 *
 * Manages a {@link DatafileRoot.Lock} that is acquired during {@link initialize} and released during {@link close}.
 * Filesystem-specific blob drivers should extend this instead of {@link BlobStorageDriver} directly.
 */
export declare abstract class FilesystemBlobStorageDriver extends BlobStorageDriver {
    #private;
    constructor(namespace?: DataNamespace);
    get root(): DatafileRoot | undefined;
    initialize(): Promise<void>;
    close(): Promise<void>;
}
export declare namespace BlobStorageDriver {
    interface Descriptor {
        kind: string;
        type?: StorageType;
    }
    interface Implementation<D extends Descriptor = Descriptor> {
        id: string;
        create(namespace: DataNamespace, descriptor: D): MaybePromise<BlobStorageDriver>;
        preinitialize?(parentDir: Directory, descriptor: D): MaybePromise<void>;
    }
}
//# sourceMappingURL=BlobStorageDriver.d.ts.map