Lesson 35 - Get Compute Auth Token Working

Plugins/GameLiftPlugin/Source/AWSSDK/Include/aws/mqtt/request-response/request_response_client.h

@@ -0,0 +1,274 @@
+#ifndef AWS_MQTT_REQUEST_RESPONSE_REQUEST_RESPONSE_CLIENT_H
+#define AWS_MQTT_REQUEST_RESPONSE_REQUEST_RESPONSE_CLIENT_H
+
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0.
+ */
+
+#include <aws/mqtt/mqtt.h>
+
+struct aws_event_loop;
+struct aws_mqtt_request_response_client;
+struct aws_mqtt_client_connection;
+struct aws_mqtt5_client;
+
+/*
+ * A response path is a pair of values - MQTT topic and a JSON path - that describe where a response to
+ * an MQTT-based request may arrive.  For a given request type, there may be multiple response paths and each
+ * one is associated with a separate JSON schema for the response body.
+ */
+struct aws_mqtt_request_operation_response_path {
+
+    /*
+     * MQTT topic that a response may arrive on.
+     */
+    struct aws_byte_cursor topic;
+
+    /*
+     * JSON path for finding correlation tokens within payloads that arrive on this path's topic.
+     */
+    struct aws_byte_cursor correlation_token_json_path;
+};
+
+/*
+ * Callback signature for request-response completion.
+ *
+ * Invariants:
+ *   If error_code is non-zero then response_topic and payload will be NULL.
+ *   If response_topic and payload are not NULL then error_code will be 0.
+ *   response_topic and payload are either both set or both not set.
+ */
+typedef void(aws_mqtt_request_operation_completion_fn)(
+    const struct aws_byte_cursor *response_topic,
+    const struct aws_byte_cursor *payload,
+    int error_code,
+    void *user_data);
+
+/*
+ * Configuration options for a request-response operation.
+ */
+struct aws_mqtt_request_operation_options {
+
+    /*
+     * Set of topic filters that should be subscribed to in order to cover all possible response paths.  Sometimes
+     * we can use wildcards to cut down on the subscriptions needed; sometimes we can't.
+     */
+    struct aws_byte_cursor *subscription_topic_filters;
+    size_t subscription_topic_filter_count;
+
+    /*
+     * Set of all possible response paths associated with this request type
+     */
+    struct aws_mqtt_request_operation_response_path *response_paths;
+    size_t response_path_count;
+
+    /*
+     * Topic to publish the request to once response subscriptions have been established.
+     */
+    struct aws_byte_cursor publish_topic;
+
+    /*
+     * Payload to publish in order to initiate the request
+     */
+    struct aws_byte_cursor serialized_request;
+
+    /*
+     * Correlation token embedded in the request that must be found in a response message.  This can be the
+     * empty cursor to support certain services which don't use correlation tokens.  In this case, the client
+     * only allows one request at a time to use the associated subscriptions; no concurrency is possible.  There
+     * are some optimizations we could make here but for now, they're not worth the complexity.
+     */
+    struct aws_byte_cursor correlation_token;
+
+    /*
+     * Callback (and associated user data) to invoke when the request is completed.
+     */
+    aws_mqtt_request_operation_completion_fn *completion_callback;
+    void *user_data;
+};
+
+/*
+ * Describes a change to the state of a streaming operation subscription
+ */
+enum aws_rr_streaming_subscription_event_type {
+
+    /*
+     * The streaming operation is successfully subscribed to its topic (filter)
+     */
+    ARRSSET_SUBSCRIPTION_ESTABLISHED,
+
+    /*
+     * The streaming operation has temporarily lost its subscription to its topic (filter)
+     */
+    ARRSSET_SUBSCRIPTION_LOST,
+
+    /*
+     * The streaming operation has entered a terminal state where it has given up trying to subscribe
+     * to its topic (filter).  This is always due to user error (bad topic filter or IoT Core permission policy).
+     */
+    ARRSSET_SUBSCRIPTION_HALTED,
+};
+
+/*
+ * Callback signature for when the subscription status of a streaming operation changes.
+ */
+typedef void(aws_mqtt_streaming_operation_subscription_status_fn)(
+    enum aws_rr_streaming_subscription_event_type status,
+    int error_code,
+    void *user_data);
+
+/*
+ * Callback signature for when a publish arrives that matches a streaming operation's subscription
+ */
+typedef void(aws_mqtt_streaming_operation_incoming_publish_fn)(struct aws_byte_cursor payload, void *user_data);
+
+/*
+ * Callback signature for when a streaming operation is fully destroyed and no more events will be emitted.
+ */
+typedef void(aws_mqtt_streaming_operation_terminated_fn)(void *user_data);
+
+/*
+ * Configuration options for a streaming operation.
+ */
+struct aws_mqtt_streaming_operation_options {
+
+    /*
+     * Topic filter that the streaming operation should listen on
+     */
+    struct aws_byte_cursor topic_filter;
+
+    /*
+     * Callback for subscription status events
+     */
+    aws_mqtt_streaming_operation_subscription_status_fn *subscription_status_callback;
+
+    /*
+     * Callback for publish messages that match the operation's topic filter
+     */
+    aws_mqtt_streaming_operation_incoming_publish_fn *incoming_publish_callback;
+
+    /*
+     * Callback for streaming operation final shutdown
+     */
+    aws_mqtt_streaming_operation_terminated_fn *terminated_callback;
+
+    /*
+     * Data passed to all streaming operation callbacks
+     */
+    void *user_data;
+};
+
+typedef void(aws_mqtt_request_response_client_initialized_callback_fn)(void *user_data);
+typedef void(aws_mqtt_request_response_client_terminated_callback_fn)(void *user_data);
+
+/*
+ * Request-response client configuration options
+ */
+struct aws_mqtt_request_response_client_options {
+
+    /*
+     * Maximum number of subscriptions that the client will concurrently use for request-response operations
+     */
+    size_t max_request_response_subscriptions;
+
+    /*
+     * Maximum number of subscriptions that the client will concurrently use for streaming operations
+     */
+    size_t max_streaming_subscriptions;
+
+    /*
+     * Duration, in seconds, that a request-response operation will wait for completion before giving up
+     */
+    uint32_t operation_timeout_seconds;
+
+    /*
+     * Request-response client initialization is asynchronous.  This callback is invoked when the client is fully
+     * initialized.
+     *
+     * Do not bind the initialized callback; it exists mostly for tests and should not be exposed
+     */
+    aws_mqtt_request_response_client_initialized_callback_fn *initialized_callback;
+
+    /*
+     * Callback invoked when the client's asynchronous destruction process has fully completed.
+     */
+    aws_mqtt_request_response_client_terminated_callback_fn *terminated_callback;
+
+    /*
+     * Arbitrary data to pass to the client callbacks
+     */
+    void *user_data;
+};
+
+AWS_EXTERN_C_BEGIN
+
+/*
+ * Create a new request-response client that uses an MQTT311 client.
+ */
+AWS_MQTT_API struct aws_mqtt_request_response_client *aws_mqtt_request_response_client_new_from_mqtt311_client(
+    struct aws_allocator *allocator,
+    struct aws_mqtt_client_connection *client,
+    const struct aws_mqtt_request_response_client_options *options);
+
+/*
+ * Create a new request-response client that uses an MQTT5 client.
+ */
+AWS_MQTT_API struct aws_mqtt_request_response_client *aws_mqtt_request_response_client_new_from_mqtt5_client(
+    struct aws_allocator *allocator,
+    struct aws_mqtt5_client *client,
+    const struct aws_mqtt_request_response_client_options *options);
+
+/*
+ * Add a reference to a request-response client
+ */
+AWS_MQTT_API struct aws_mqtt_request_response_client *aws_mqtt_request_response_client_acquire(
+    struct aws_mqtt_request_response_client *client);
+
+/*
+ * Remove a reference from a request-response client
+ */
+AWS_MQTT_API struct aws_mqtt_request_response_client *aws_mqtt_request_response_client_release(
+    struct aws_mqtt_request_response_client *client);
+
+/*
+ * Submits a request operation to the client
+ */
+AWS_MQTT_API int aws_mqtt_request_response_client_submit_request(
+    struct aws_mqtt_request_response_client *client,
+    const struct aws_mqtt_request_operation_options *request_options);
+
+/*
+ * Creates a new streaming operation.  Streaming operations start in an inactive state and must be
+ * activated before its subscription can be established.
+ */
+AWS_MQTT_API struct aws_mqtt_rr_client_operation *aws_mqtt_request_response_client_create_streaming_operation(
+    struct aws_mqtt_request_response_client *client,
+    const struct aws_mqtt_streaming_operation_options *streaming_options);
+
+/*
+ * Returns the event loop used by the request-response client's protocol client
+ */
+AWS_MQTT_API struct aws_event_loop *aws_mqtt_request_response_client_get_event_loop(
+    struct aws_mqtt_request_response_client *client);
+
+/*
+ * Initiates a streaming operation's subscription process.
+ */
+AWS_MQTT_API int aws_mqtt_rr_client_operation_activate(struct aws_mqtt_rr_client_operation *operation);
+
+/*
+ * Add a reference to a streaming operation.
+ */
+AWS_MQTT_API struct aws_mqtt_rr_client_operation *aws_mqtt_rr_client_operation_acquire(
+    struct aws_mqtt_rr_client_operation *operation);
+
+/*
+ * Remove a reference from a streaming operation
+ */
+AWS_MQTT_API struct aws_mqtt_rr_client_operation *aws_mqtt_rr_client_operation_release(
+    struct aws_mqtt_rr_client_operation *operation);
+
+AWS_EXTERN_C_END
+
+#endif /* AWS_MQTT_REQUEST_RESPONSE_REQUEST_RESPONSE_CLIENT_H */