livekit_data_stream.h

/*
 * Copyright 2025 LiveKit, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>

#define LIVEKIT_DATA_STREAM_CHUNK_SIZE 15000
 
#ifdef __cplusplus
extern "C" {
#endif

typedef void *livekit_data_stream_handle_t;

typedef struct {
    const char* stream_id;
    const char* topic;
    const char* sender_identity;
    int64_t timestamp;
    uint64_t total_length;
    bool has_total_length;
    bool is_text;
} livekit_data_stream_header_t;

typedef struct {
    const char* stream_id;
    uint64_t chunk_index;
    const uint8_t* content;
    size_t content_size;
} livekit_data_stream_chunk_t;

typedef struct {
    const char* stream_id;
    const char* reason;
} livekit_data_stream_trailer_t;

typedef void (*livekit_data_stream_open_cb_t)(
    const livekit_data_stream_header_t* header, void* ctx);

typedef void (*livekit_data_stream_recv_cb_t)(
    const livekit_data_stream_chunk_t* chunk, void* ctx);

typedef void (*livekit_data_stream_close_cb_t)(
    const livekit_data_stream_trailer_t* trailer, void* ctx);

typedef struct {
    const char *topic;
    bool is_text;
    uint64_t total_length;
    bool has_total_length;
} livekit_data_stream_options_t;

typedef struct {
    livekit_data_stream_recv_cb_t on_recv;

    livekit_data_stream_open_cb_t on_open;

    livekit_data_stream_close_cb_t on_close;

    void* ctx;
} livekit_data_stream_handler_t;
 
#ifdef __cplusplus
}
#endif