add server-side config

libs/client-sdk/include/launchdarkly/client_side/bindings/c/config/config.h

@@ -14,8 +14,8 @@ extern "C" {  // only need to export C interface if
 typedef struct _LDClientConfig* LDClientConfig;
 
 /**
- * Free the configuration. Configurations passed into an LDClient do not need to
- * be freed.
+ * Free the configuration. Configurations passed into an LDClientSDK_New call do
+ * not need to be freed.
  * @param config Config to free.
  */
 LD_EXPORT(void) LDClientConfig_Free(LDClientConfig config);

libs/server-sdk/include/launchdarkly/server_side/bindings/c/config/builder.h

@@ -0,0 +1,346 @@
+/** @file */
+// NOLINTBEGIN modernize-use-using
+
+#pragma once
+
+#include <launchdarkly/server_side/bindings/c/config/config.h>
+
+#include <launchdarkly/bindings/c/config/logging_builder.h>
+#include <launchdarkly/bindings/c/export.h>
+#include <launchdarkly/bindings/c/status.h>
+
+#include <stdbool.h>
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {  // only need to export C interface if
+// used by C++ source code
+#endif
+
+typedef struct _LDServerConfigBuilder* LDServerConfigBuilder;
+typedef struct _LDServerDataSourceStreamBuilder*
+    LDServerDataSourceStreamBuilder;
+typedef struct _LDServerDataSourcePollBuilder* LDServerDataSourcePollBuilder;
+
+/**
+ * Constructs a client-side config builder.
+ */
+LD_EXPORT(LDServerConfigBuilder) LDServerConfigBuilder_New(char const* sdk_key);
+
+/**
+ * Sets a custom URL for the polling service.
+ * @param b Client config builder. Must not be NULL.
+ * @param url Target URL. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_ServiceEndpoints_PollingBaseURL(LDServerConfigBuilder b,
+                                                      char const* url);
+/**
+ * Sets a custom URL for the streaming service.
+ * @param b Client config builder. Must not be NULL.
+ * @param url Target URL. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_ServiceEndpoints_StreamingBaseURL(LDServerConfigBuilder b,
+                                                        char const* url);
+/**
+ * Sets a custom URL for the events service.
+ * @param b Client config builder. Must not be NULL.
+ * @param url Target URL. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_ServiceEndpoints_EventsBaseURL(LDServerConfigBuilder b,
+                                                     char const* url);
+/**
+ * Sets a custom URL for a Relay Proxy instance. The streaming,
+ * polling, and events URLs are set automatically.
+ * @param b Client config builder. Must not be NULL.
+ * @param url Target URL. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_ServiceEndpoints_RelayProxyBaseURL(
+    LDServerConfigBuilder b,
+    char const* url);
+
+/**
+ * Sets an identifier for the application.
+ * @param b Client config builder. Must not be NULL.
+ * @param app_id Non-empty string. Must be <= 64 chars. Must be alphanumeric,
+ * '-', '.', or '_'. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_AppInfo_Identifier(LDServerConfigBuilder b,
+                                         char const* app_id);
+
+/**
+ * Sets a version for the application.
+ * @param b Client config builder. Must not be NULL.
+ * @param app_version Non-empty string. Must be <= 64 chars. Must be
+ * alphanumeric,
+ * '-', '.', or '_'. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_AppInfo_Version(LDServerConfigBuilder b,
+                                      char const* app_version);
+
+/**
+ * Enables or disables "Offline" mode. True means
+ * Offline mode is enabled.
+ * @param b Client config builder. Must not be NULL.
+ * @param offline True if offline.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Offline(LDServerConfigBuilder b, bool offline);
+
+/**
+ * Specify if event-sending should be enabled or not. By default,
+ * events are enabled.
+ * @param b Client config builder. Must not be NULL.
+ * @param enabled True to enable event-sending.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Events_Enabled(LDServerConfigBuilder b, bool enabled);
+
+/**
+ * Sets the capacity of the event processor. When more events are generated
+ * within the processor's flush interval than this value, events will be
+ * dropped.
+ * @param b Client config builder. Must not be NULL.
+ * @param capacity Event queue capacity.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Events_Capacity(LDServerConfigBuilder b, size_t capacity);
+
+/**
+ * Sets the flush interval of the event processor. The processor queues
+ * outgoing events based on the capacity parameter; these events are then
+ * delivered based on the flush interval.
+ * @param b Client config builder. Must not be NULL.
+ * @param milliseconds Interval between automatic flushes.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Events_FlushIntervalMs(LDServerConfigBuilder b,
+                                             unsigned int milliseconds);
+
+/**
+ * Attribute privacy indicates whether or not attributes should be
+ * retained by LaunchDarkly after being sent upon initialization,
+ * and if attributes should later be sent in events.
+ *
+ * Attribute privacy may be specified in 3 ways:
+ *
+ * (1) To specify that all attributes should be considered private - not
+ * just those designated private on a per-context basis - call this method
+ * with true as the parameter.
+ *
+ * (2) To specify that a specific set of attributes should be considered
+ * private - in addition to those designated private on a per-context basis
+ * - call @ref PrivateAttribute.
+ *
+ * (3) To specify private attributes on a per-context basis, it is not
+ * necessary to call either of these methods, as the default behavior is to
+ * treat all attributes as non-private unless otherwise specified.
+ *
+ * @param b Client config builder. Must not be NULL.
+ * @param all_attributes_private True for behavior of (1), false for default
+ * behavior of (2) or (3).
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Events_AllAttributesPrivate(LDServerConfigBuilder b,
+                                                  bool all_attributes_private);
+
+/**
+ * Specifies a single private attribute. May be called multiple times
+ * with additional private attributes.
+ * @param b Client config builder. Must not be NULL.
+ * @param attribute_reference Attribute to mark private.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Events_PrivateAttribute(LDServerConfigBuilder b,
+                                              char const* attribute_reference);
+
+/**
+ * Set the streaming configuration for the builder.
+ *
+ * A data source may either be streaming or polling. Setting a streaming
+ * builder indicates the data source will use streaming. Setting a polling
+ * builder will indicate the use of polling.
+ *
+ * @param b Client config builder. Must not be NULL.
+ * @param stream_builder The streaming builder. The builder is consumed; do not
+ * free it.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_DataSource_MethodStream(
+    LDServerConfigBuilder b,
+    LDServerDataSourceStreamBuilder stream_builder);
+
+/**
+ * Set the polling configuration for the builder.
+ *
+ * A data source may either be streaming or polling. Setting a stream
+ * builder indicates the data source will use streaming. Setting a polling
+ * builder will indicate the use of polling.
+ *
+ * @param b Client config builder. Must not be NULL.
+ * @param poll_builder The polling builder. The builder is consumed; do not free
+ * it.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_DataSource_MethodPoll(
+    LDServerConfigBuilder b,
+    LDServerDataSourcePollBuilder poll_builder);
+
+/**
+ * Creates a new DataSource builder for the Streaming method.
+ *
+ * If not passed into the config
+ * builder, must be manually freed with LDServerDataSourceStreamBuilder_Free.
+ *
+ * @return New builder for Streaming method.
+ */
+LD_EXPORT(LDServerDataSourceStreamBuilder)
+LDServerDataSourceStreamBuilder_New();
+
+/**
+ * Sets the initial reconnect delay for the streaming connection.
+ *
+ * The streaming service uses a backoff algorithm (with jitter) every time
+ * the connection needs to be reestablished.The delay for the first
+ * reconnection will start near this value, and then increase exponentially
+ * for any subsequent connection failures.
+ *
+ * @param b Streaming method builder. Must not be NULL.
+ * @param milliseconds Initial delay for a reconnection attempt.
+ */
+LD_EXPORT(void)
+LDServerDataSourceStreamBuilder_InitialReconnectDelayMs(
+    LDServerDataSourceStreamBuilder b,
+    unsigned int milliseconds);
+
+/**
+ * Frees a Streaming method builder. Do not call if the builder was consumed by
+ * the config builder.
+ *
+ * @param b Builder to free.
+ */
+LD_EXPORT(void)
+LDServerDataSourceStreamBuilder_Free(LDServerDataSourceStreamBuilder b);
+
+/**
+ * Creates a new DataSource builder for the Polling method.
+ *
+ * If not passed into the config
+ * builder, must be manually freed with LDServerDataSourcePollBuilder_Free.
+ *
+ * @return New builder for Polling method.
+ */
+
+LD_EXPORT(LDServerDataSourcePollBuilder)
+LDServerDataSourcePollBuilder_New();
+
+/**
+ * Sets the interval at which the SDK will poll for feature flag updates.
+ * @param b Polling method builder. Must not be NULL.
+ * @param milliseconds Polling interval.
+ */
+LD_EXPORT(void)
+LDServerDataSourcePollBuilder_IntervalS(LDServerDataSourcePollBuilder b,
+                                        unsigned int seconds);
+
+/**
+ * Frees a Polling method builder. Do not call if the builder was consumed by
+ * the config builder.
+ *
+ * @param b Builder to free.
+ */
+LD_EXPORT(void)
+LDServerDataSourcePollBuilder_Free(LDServerDataSourcePollBuilder b);
+
+/**
+ * This should be used for wrapper SDKs to set the wrapper name.
+ *
+ * Wrapper information will be included in request headers.
+ * @param b Client config builder. Must not be NULL.
+ * @param wrapper_name Name of the wrapper.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_HttpProperties_WrapperName(LDServerConfigBuilder b,
+                                                 char const* wrapper_name);
+
+/**
+ * This should be used for wrapper SDKs to set the wrapper version.
+ *
+ * Wrapper information will be included in request headers.
+ * @param b Client config builder. Must not be NULL.
+ * @param wrapper_version Version of the wrapper.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_HttpProperties_WrapperVersion(
+    LDServerConfigBuilder b,
+    char const* wrapper_version);
+
+/**
+ * Set a custom header value. May be called more than once with additional
+ * headers.
+ *
+ * @param b Client config builder. Must not be NULL.
+ * @param key Name of the header. Must not be NULL.
+ * @param value Value of the header. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_HttpProperties_Header(LDServerConfigBuilder b,
+                                            char const* key,
+                                            char const* value);
+
+/**
+ * Disables the default SDK logging.
+ * @param b Client config builder. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Logging_Disable(LDServerConfigBuilder b);
+
+/**
+ * Configures the SDK with basic logging.
+ * @param b  Client config builder. Must not be NULL.
+ * @param basic_builder The basic logging builder. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Logging_Basic(LDServerConfigBuilder b,
+                                    LDLoggingBasicBuilder basic_builder);
+
+/**
+ * Configures the SDK with custom logging.
+ * @param b  Client config builder. Must not be NULL.
+ * @param custom_builder The custom logging builder. Must not be NULL.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Logging_Custom(LDServerConfigBuilder b,
+                                     LDLoggingCustomBuilder custom_builder);
+
+/**
+ * Creates an LDClientConfig. The LDServerConfigBuilder is consumed.
+ * On success, the config will be stored in out_config; otherwise,
+ * out_config will be set to NULL and the returned LDStatus will indicate
+ * the error.
+ * @param builder Builder to consume. Must not be NULL.
+ * @param out_config Pointer to where the built config will be
+ * stored. Must not be NULL.
+ * @return Error status on failure.
+ */
+LD_EXPORT(LDStatus)
+LDServerConfigBuilder_Build(LDServerConfigBuilder builder,
+                            LDServerConfig* out_config);
+
+/**
+ * Frees the builder; only necessary if not calling Build.
+ * @param builder Builder to free.
+ */
+LD_EXPORT(void)
+LDServerConfigBuilder_Free(LDServerConfigBuilder builder);
+
+#ifdef __cplusplus
+}
+#endif
+
+// NOLINTEND modernize-use-using

libs/server-sdk/include/launchdarkly/server_side/bindings/c/config/config.h

@@ -0,0 +1,27 @@
+/** @file */
+// NOLINTBEGIN modernize-use-using
+
+#pragma once
+
+#include <launchdarkly/bindings/c/export.h>
+#include <launchdarkly/bindings/c/status.h>
+
+#ifdef __cplusplus
+extern "C" {  // only need to export C interface if
+// used by C++ source code
+#endif
+
+typedef struct _LDCServerConfig* LDServerConfig;
+
+/**
+ * Free the configuration. Configurations passed into an LDServerSDK_New call do
+ * not need to be freed.
+ * @param config Config to free.
+ */
+LD_EXPORT(void) LDServerConfig_Free(LDServerConfig config);
+
+#ifdef __cplusplus
+}
+#endif
+
+// NOLINTEND modernize-use-using