Rename this file

include/asynchronousContinuation.h

@@ -0,0 +1,50 @@
+#ifndef ASYNCHRONOUS_CONTINUATION_H
+#define ASYNCHRONOUS_CONTINUATION_H
+
+#include <functional>
+#include <memory>
+
+/**
+ * AsynchronousContinuation - Template base class for async sequence management
+ *
+ * This template provides a common pattern for managing asynchronous operations
+ * that need to maintain object lifetime through a sequence of callbacks.
+ *
+ * The template parameter OriginalCbFnT represents the signature of the original
+ * callback that will be invoked when the async sequence completes.
+ *
+ * Usage:
+ *   class MyAsyncReq
+ *	 :	public AsynchronousContinuation<std::function<void(bool)>>
+ *   {
+ *   public:
+ *     MyAsyncReq(std::function<void(bool)> originalCbFn)
+ *     :	AsynchronousContinuation(originalCbFn)
+ *    {}
+ *
+ *     // Segment methods take only the shared_ptr for lifetime management
+ *     void myAsyncReq1(std::shared_ptr<MyAsyncReq> context);
+ *     void myAsyncReq2(std::shared_ptr<MyAsyncReq> context);
+ *   };
+ */
+template <class OriginalCbFnT>
+class AsynchronousContinuation
+{
+public:
+	explicit AsynchronousContinuation(OriginalCbFnT originalCbFn)
+	: originalCbFn(std::move(originalCbFn))
+	{}
+
+	/**		EXPLANATION:
+	 * Each numbered segmented sequence persists the lifetime of the
+	 * continuation object by taking a copy of its shared_ptr.
+	 */
+	typedef void (SegmentFn)(
+		std::shared_ptr<AsynchronousContinuation<OriginalCbFnT>>
+			lifetimePreservingConveyance);
+
+protected:
+	OriginalCbFnT originalCbFn;
+};
+
+#endif // ASYNCHRONOUS_CONTINUATION_H