SDK Release Notes

CXXCBC-567: Added support for field-level encryption library (#791).

CXXCBC-713, CXXCBC-729: Added cbc-keygen, a tool to generate keys for specific vBucket (#799, #833).

CXXCBC-656: Added cbc-remove and cbc-upsert tools (#781).

CXXCBC-653: Added support "access_deleted" for Replica Reads (#821).

CXXCBC-639: Added support of building both static and shared libraries (#707).

CXXCBC-698: Added flex_index to transaction_query_options (#773).

CXXCBC-675: Added support vector search prefilter (#775).

CXXCBC-699: Added support of randomization of bootstrap nodes (#777). By default the SDK would shuffle node list (including list received via DNS-SRV request). To disable this behavior use preserve_bootstrap_nodes_order option.

CXXCBC-711: Promoted scope_search_index_manager to committed API (#793).

CXXCBC-692: The SDK now prevents connection to Enterprise Analytics cluster (#792, #807, #810). There is a set of specialized SDKs for Enterprise Analytics clusters.

CXXCBC-707: Updated network selection heuristic (#809). The logic is improved in certain cloud-specific cases.

CXXCBC-715: Fixed Hard Failover Intermittent Crash in HTTP connection manager (#818).

CXXCBC-693: Handle empty/null indexDef`s for `search_index_get_all (#800).

CXXCBC-726: Added KV scan timeout to cluster options (#830).

CXXCBC-721: Added caching of FeatureNotAvailable transactions operation failure for get_replica* operations (#823).

CXXCBC-696: Use the external exception field to determine transaction operation error code in Public API (#770).

CXXCBC-695: Always return unwrapped doc_exists from transactions insert (#771).

CXXCBC-700: Updated wan_development profile for public API (#774).

CXXCBC-704: Added handling document_unretrievable from get_multi individual fetch (#782, #785).

CXXCBC-709: Fixed exists() in transactions get_multi result (#786).

CXXCBC-651: Added preserving cached node labels after generating report in app telemetry meter (#802).

CXXCBC-706: Added closing of half-baked cluster object if connection fails (#783).

CXXCBC-733: Fixed build with BoringSSL (#839).

Improved stability of update collection max expiry tests (#838).

CXXCBC-731: Fixed usage of the wan_development profile in tests when required (#835).

CXXCBC-728: Removed handling for eventing handler headers bug (#832).

CXXCBC-724: Added eventing tests to handle Morpheus error behavior (#828, #824).

CXXCBC-639: Build system adjustments (#825).

Added labels to all tests (#820).

Added test improvements (memcached buckets & cleanup search index) (#819).

Added logging of local TCP ports (#814).

Updated llhttp to 9.3.0 and cli11 to 2.5.0 (#811).

Updated asio to 1.34.2 (#776).

Updated CPM.cmake to 0.42.0 (#794).

CXXCBC-712: Fixed build with CPM (#795).

Fixed building tests with system OpenSSL on MacOS (#798).

CXXCBC-693: Fixed clang-tidy else-after-return error (#803).

Fixed gcc maybe-uninitialized warning with std::nullopt (#816).

Github Actions:

CXXCBC-699: By default the SDK will now shuffle the node list (including lists received via DNS-SRV request). To disable this behavior use the preserve_bootstrap_nodes_order option (#778).

CXXCBC-715: An HTTP workload could potentially use an invalid node index to access a node in the config in scenarios to where a node in the cluster has been failed over. This potential intermittent crash during hard failover has now been fixed (#817).

CXXCBC-651: Cached node labels are now preserved after generating reports in app telemetry meter (#804).

CXXCBC-693: Fixed clang-tidy else-after-return error (#805). Now correctly handle empty/null indexDefs for search_index_get_all (801). The client will no longer return an error if/when indexDefs are empty/null — instead returning an empty list of index definitions.

CXXCBC-709: Fixed a bug in the getter that was always returning false for exists() in transactions get_multi result (#787).

CXXCBC-696: The client now uses the external exception field to determine transaction operation error code in the Public API (#772).

CXXCBC-712: Fixed build issue with CPM (#797)

CXXCBC-672: Added add_named_parameter and add_positional_parameter to query/analytics options (#762).

CXXCBC-684: The SDK now allows the setting of both named and positional parameters for queries — previously named parameters would be cleared if positional parameters were set (#759).

CXXCBC-654: Added num_vbuckets to bucket_settings (#746).

CXXCBC-605: Added custom log callback functionality (#743).

CXXCBC-665: The SDK will now always return partial results for *_all_replica operations if some get_replica requests succeeded (#742).

CXXCBC-626: Application Service Telemetry, for future Server releases (#712, #719, #739, #750).

CXXCBC-694: Handle case where requestID is missing from query response payload (#768).

Added CAS to core append/prepend (#737).

CXXCBC-657: For subdoc operations, if no specs are provided then an invalid_argument error is raised instead of crashing on an assert (#727).

CXXCBC-661: Reconnect cluster object on fork (#724).

CXXCBC-660: Fixed potential race condition in the logger (#722).

CXXCBC-646: For performance reasons, the bucket configuration is now stored as shared pointer, and this is copied into the handler instead of the entire configuration (#715, #720).

CXXCBC-688: Don’t convert Public API TOF from lambda to Core API’s TOF, rely on internal state (#765).

CXXCBC-690: Don’t move staged_mutation item when capturing it in commit_doc lambdas (#767).

CXXCBC-683: Transactions replace now uses CAS from given TransactionsGetResult when the document is a staged insert (#763).

CXXCBC-682: Transaction replace/insert result now includes post-op content (#756).

CXXCBC-645, CXXCBC-689, CXXCBC-687: Implemented get_multi_* APIs for transactions (#761, #764, #766).

CXXCBC-681: No longer storing entire transaction_get_result in staged mutations, reducing memory use (#757).

CXXCBC-649: Implemented ExtReplaceBodyWithXattr (#752).

CXXCBC-671: Updated snappy to support CMake 4.0 (#744).

CXXCBC-666: Fixed pkg-config file — couchbase_cxx_client.pc have to use absolute path for libdir. (#735).

CXXCBC-673: Updated query integration tests to compare decoded rows (#747).

CXXCBC-666: Fixed pkg-config file to return absolute path for libdir (#736).

CXXCBC-667: Core implementation of prepend/append no longer ignores encoded CAS value (#738).

CXXCBC-671: Updated snappy to support CMake 4.0 (#745).

CXXCBC-633: In a case of timeout, when the total deadline of the DNS-SRV request has been reached, the library will now report a timeout error code, and not the latest abort as it was doing.

CXXCBC-646: For performance reasons, the SDK now stores bucket configuration as a shared pointer (#713, #721).

CXXCBC-660: Fixed potential race condition in the logger (#723).

CXXCBC-661: The child process now reconnects all of its instances on fork — previously, certain exceptions could cause this not to happen (#725).

CXXCBC-633: In a case of timeout, when the total deadline of the DNS-SRV request has been reached, the library will now report a timeout error code, and not the latest abort as it was doing.

Server group replica reads are now exposed in transaction_context (#704).

Minor improvements (#706).

CXXCBC-640: Debug symbols are no longer forced for release builds (#708).

CXXCBC-638: Switched SDK to use bundled fmtlib for spdlog (#705).

Updated spdlog to 1.15.0 (#709).

CXXCBC-620: Updated core analytics_link_get_all to follow the RFC (#687).

CXXCBC-615: Exposed insert_raw and replace_raw in core transactions attempt context (#686).

CXXCBC-622: Updated OpenTelemetry metrics integration to use GA Metrics API (#688).

CXXCBC-627: A preformance degradation was discovered to be caused by work done in the error function, even if the operation had been successful. The internal conversion work is now only carried out in response to error conditions (#693).

CXXCBC-624: Fixed user agent ID generation (#692).

CXXCBC-611, CXXCBC-612: Updated metric operation names to follow RFC naming (#695).

CXXCBC-632: A crash on testing against Analytics nodes under rebalance was caused by the assumption that Analytics would always send meta fields in its response. This has now been fixed, and the behoavior should not recur (#699).

URI encoding for user_upsert (#700).

CXXCBC-609: Exposed parent_span in Public API options (#690).

Updates for YUM/RPM builders (#691).

Debian/Ubuntu packaging scripts added (#694).

Fixed packaging scripts on MacOS (#698).

Added scripts to produce APK files for Alpine Linux (#685).

CXXCBC-599: Updated allowed connection string options (#668).

CXXCBC-311: SDKs must encode URIs (#674).

CXXCBC-606: Fixed detection of dysfunctional node (#673).

CXXCBC-574: Fixed memory leak when open fails in public API (#649).

CXXCBC-614: Fixed memory leak in observe_poll (#679).

Added missing template parameters to fix compiler warnings (#671).

Allow to query current log level (#672).

CXXCBC-582: Added cluster labels & system tag in spans (#682).

CXXCBC-582: Added cluster labels, keyspace & outcome in metrics (#677).

CXXCBC-598: Propagate bootstrap errors to HTTP operations (#666).

CXXCBC-602: Report first non-retriable code/message in query error (#667).

CXXCBC-604: Apply raw options last (#669).

CXXCBC-616: Report retry information when receiving a timeout from the HTTP component (#681).

CXXCBC-600: Reduced origin::to_json output for Columnar builds (#678).

CXXCBC-303: Fixed RPM for AmazonLinux (#663).

CXXCBC-303: Fixed RPM for RHEL 8 (#664).

Use timestamp from the tag for reproducible tarballs (#665).

Updated list of RPM-based platforms (#676).

CXXCBC-577: Reduced duplicated code in http_component (#657).

CXXCBC-593: Configuration profile are now applied as the last step — taking priority over all other defaults and options (#655).

CXXCBC-552: Cleaned up network selection options (, by deprecating behavior_options#network() in favor to network_options#preferred_network() #651).

CXXCBC-576: When cluster.close() is called, all in-progress HTTP operations should now be cancelled (#648).

Updated code samples in API reference (#653).

CXXCBC-577: Added Columnar database management operations.

CXXCBC-588: Updated timeout sent to server on each Columnar query retry (#654).

CXXCBC-580: SDK now reports last error when timing out on Columnar query retries (#650).

CXXCBC-303: Updated build scripts to produce RPM packages (#660).

CXXCBC-597: SDK now use static library for ASIO; updated it to 1.31.0 (#658).

CXXCBC-596: No longer include tao_json_serializer.hxx by default (#656).

Include <string> in string_hex.h (#652).

CXXCBC-564: Allow to specify all operations (Get, Replace, Delete, Insert, and Query) in pillowfight workload (#640).

Improve logging of DNS client (#634).

CXXCBC-568: Cancel deferred operations when closing HTTP session manager (#643).

CXXCBC-531: Fixed memory leak in range scan implementation (#645, #610).

CXXCBC-573: Avoid uninitialized reads in the logger test (#610).

CXXCBC-572: Always initialize service_type (#610).

CXXCBC-569: Resolved cycle in shared pointers for transaction_context (#641).

CXXCBC-550: Fixed use-after-move issue in command handler (#628).

Fixed build of Ruby wrapper on Windows (#636).

Fixed behaviour when reading is complete before returning HTTP streaming resp (#624).

Add initial Columnar core implementation (#616).

CXXCBC-525: Open cluster connection in background (#621).

Use open_in_background when creating test cluster in Columnar mode (#625).

CXXCBC-542: Richer error information from Columnar core (#626).

Updated columnar log message, enabling dispatch_timeout if in connection string (#627).

Add helper method for serializing ctx into columnar error message (#632).

Add Columnar query positional params (#635).

CXXCBC-543: Added retries for columnar query (#637).

CXXCBC-562: Provided HTTP session manager with updated cluster (#638).

CXXCBC-556: Added versioned Columnar query endpoint (#639).

CXXCBC-557: Added global columnar timeout config (#642).

CXXCBC-509: Allow to restrict replica set to selected server group. This feature allows to implement network optimization when traffic cost between server groups is higher than in the local group. In this case the application might select preferred server group in the connection options, and later opt-in for local operations during replica reads. Related tickets: CXXCBC-546, CXXCBC-513, (#614, #593, #587, #571, #566).

CXXCBC-530: Include 'min' parameter when encoding disjunction FTS queries (#604).

CXXCBC-394: Hide tao::json where it is possible. We still have taocpp/json headers in places where default JSON transcoder is being used.

CXXCBC-449: Do not expose ASIO in public API.

CXXCBC-381: Use std::shared_ptr for transactions_context and attempt_context (#590).

CXXCBC-510: Support binary objects in transactions. This changes allows to use transcoders in transactions API (#576).

Improvements in Vector Search:

CXXCBC-407: Allow to use 0 as a max expiry for new collections (#569).

CXXCBC-496: Convert C++ Public API Error handling to use couchbase::error. Related tickets: CXXCBC-492, CXXCBC-498, CXXCBC-499, CXXCBC-500, CXXCBC-508, CXXCBC-526 (#570, #557, #562, #560, #564, #567, #603, #597, #595, #594).

Update stability levels for API 3.6 level. Remove deprecated search_query (#602).

CXXCBC-517: Add HTTP session retries when SDK fails to resolve hostnames (#589).

CXXCBC-445: Return request_canceled on IO error in HTTP session (#568).

CXXCBC-511: Prevent use of HTTP session if idle timer has expired (#565).

CXXCBC-523: Clean up dump_configuration config output (#577).

CXXCBC-531: Fix deadlock in cluster destructor (public API) (#608).

CXXCBC-534: Fix callbacks to avoid bad_function_call exception (#606).

CXXCBC-518: Handle alternate addresses when locating preferred_node (#574).

Add cmake task to generate tarball (#596).

Do not refer to core headers in public API (#599).

Cleanup attempt_context implementation (#586).

Do not use default parameters for virtual functions in transactions (#588).

Do not fetch config if no sessions in the bucket (#573).

Improve test stability (#563, #613).