Method try_insert

crates/bindings-cpp/include/spacetimedb/table.h:416–463

* Insert a row and return Result-like type instead of throwing on error. * * This method provides the same functionality as insert() but returns * an InsertResult that contains either the successfully inserted row * (with auto-generated fields populated) or an InsertError with details * about what went wrong. * * @param row_data The row to insert * @retur

     * }
     */
    InsertResult<T> try_insert(const T& row_data) {
        SpacetimeDB::bsatn::Writer writer;
        SpacetimeDB::bsatn::serialize(writer, row_data);
        auto buffer_vec = writer.get_buffer();

        // Prepare buffer with extra space for auto-increment writeback
        const size_t original_len = buffer_vec.size();
        const size_t extra_space = detail::AUTO_INCREMENT_BUFFER_SPACE;
        std::vector<uint8_t> buffer(buffer_vec.begin(), buffer_vec.end());
        buffer.resize(original_len + extra_space);

        size_t buffer_len = original_len;
        Status status = ::datastore_insert_bsatn(table_id_, buffer.data(), &buffer_len);

        // Instead of calling detail::handle_ffi_error (which LOG_FATALs),
        // handle errors and return appropriate InsertError
        if (is_error(status)) {
            InsertErrorType error_type;
            std::string message;

            // Map status codes to our error types
            if (status == StatusCode::UNIQUE_ALREADY_EXISTS) {
                error_type = InsertErrorType::UniqueConstraintViolation;
                message = "Unique constraint violation";
            } else if (status == StatusCode::AUTO_INC_OVERFLOW) {
                error_type = InsertErrorType::AutoIncOverflow;
                message = "Auto increment overflow";
            } else {
                error_type = InsertErrorType::Other;
                message = "Insert failed with status: " + std::string(StatusCode::to_string(status));
            }

            return InsertResult<T>(InsertError(error_type, status, message));
        }

        // Success path - same as current insert()
        if (buffer_len == 0) {
            // No auto-generated fields, return the original row
            return InsertResult<T>(T(row_data));
        }

        // The buffer contains ONLY the generated column values in BSATN format
        T updated_row = row_data;
        SpacetimeDB::bsatn::Reader reader(buffer.data(), buffer_len);
        detail::integrate_autoinc(updated_row, reader);

        return InsertResult<T>(std::move(updated_row));
    }


    /**