create or replace package pck_net_storage as

    -- Object Key aufgeteilt in Pfad (ohne Dateiname) und Dateiname (ohne Ordner Pfad)
    type t_object_path is record (
         path      varchar2(4000)
        ,filename  varchar2(256)
    );

    -- Metadaten eines einzelnen OCI-Objekts (HEAD-Anfrage)
    type t_object_meta is record (
         object_name    varchar2(1024)
        ,object_size    number
        ,last_modified  date
        ,content_type   varchar2(256)
        ,etag           varchar2(256)
    );

    function f_split_object_key (
        i_object_key in varchar2
    ) return t_object_path;

    function f_list_objects (
         i_prefix       in varchar2
        ,i_delimiter    in varchar2 default null
        ,i_start_with   in varchar2 default null
        ,i_limit        in number   default 0
    ) return t_net_storage_tab;

    function f_download_object (
        i_object_key    in varchar2
    ) return blob;

    procedure p_upload_object (
         i_object_key   in varchar2
        ,i_content      in blob
        ,i_content_type in varchar2
    );

    procedure p_delete_object (
        i_object_key    in varchar2
    );

    procedure p_delete_folder (
        i_prefix        in varchar2
    );

    procedure p_rename_object (
         i_object_key   in varchar2
        ,i_new_name     in varchar2
    );

    procedure p_move_object (
         i_object_key   in varchar2
        ,i_target_prefix in varchar2
    );

    procedure p_create_folder (
         i_prefix       in varchar2
        ,i_folder_name  in varchar2
    );

    function f_get_object_metadata (
        i_object_key    in varchar2
    ) return t_object_meta;

end pck_net_storage;
/