// SPDX-License-Identifier: BSD-3-Clause OR Apache-2.0

syntax = "proto3";

enum StorageOperation {
    // Invalid.
    STORAGE_OPERATION_UNSPECIFIED = 0;

    // List all bundles matching the given filter.
    STORAGE_OPERATION_LIST_BUNDLES = 1;

    // Delete all bundles matching the given filter.
    STORAGE_OPERATION_DELETE_BUNDLES = 2;

    // Push all bundles matching the given filter to the BPA ("receive" them).
    STORAGE_OPERATION_PUSH_BUNDLES = 3;

    // NOTE: FUTURE EXTENSION: PUSH_AND_DELETE
    // NOTE: FUTURE EXTENSION: UPDATE (e.g., for fragmentation)
}

message BundleFilter {
    // An EID pattern to match a set of bundles. May contain '*' as a
    // placeholder (similar to POSIX-style glob patterns).
    string eid_glob = 1;

    // NOTE: FUTURE EXTENSION: Arbitrary filters on all bundle metadata, potentially
    // using regular expressions or glob patterns.
}

message StorageCall {
    StorageOperation operation = 1;
    BundleFilter filter = 2;
}