From 19c8efe49f23569a53e928488c460e0d3b20cf8a Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Thu, 16 May 2024 14:20:39 +0200
Subject: Sketch

---
 mod/ci-common.hxx      | 34 ++++++++++++++++++++++++++++++++++
 mod/tenant-service.hxx | 15 ++++++++++++++-
 2 files changed, 48 insertions(+), 1 deletion(-)

(limited to 'mod')

diff --git a/mod/ci-common.hxx b/mod/ci-common.hxx
index 6f62c4b..047faa1 100644
--- a/mod/ci-common.hxx
+++ b/mod/ci-common.hxx
@@ -36,6 +36,7 @@ namespace brep
       package_name name;
       optional<brep::version> version;
     };
+
     // Note that the inability to generate the reference is an internal
     // error. Thus, it is not optional.
     //
@@ -64,6 +65,39 @@ namespace brep
            const vector<pair<string, string>>& custom_request = {},
            const vector<pair<string, string>>& overrides = {});
 
+    // Create an unloaded CI request returning start_result::reference. Such a
+    // request is not started until loaded with the load() function below. See
+    // also the build_unloaded() tenant services notification.
+    //
+    string
+    create (const basic_mark& error,
+            const basic_mark& warn,
+            const basic_mark* trace,
+            tenant_service&&,
+            const optional<string>& client_ip,
+            const optional<string>& user_agent);
+
+    // Load (and start) previously created (as unloaded) CI request.
+    //
+    // Note that tenant_service::id is used to identify the CI request tenant.
+    //
+    // @@ What if already loaded/abandoned? Can we indicate this in status?
+    //
+    optional<start_result>
+    load (const basic_mark& error,
+          const basic_mark& warn,
+          const basic_mark* trace,
+          tenant_service&&,
+          const repository_location& repository);
+
+    // Abandon previously created (as unloaded) CI request.
+    //
+    void
+    abandon (const basic_mark& error,
+             const basic_mark& warn,
+             const basic_mark* trace,
+             tenant_service&&);
+
     // Helpers.
     //
 
diff --git a/mod/tenant-service.hxx b/mod/tenant-service.hxx
index 9205f76..2ec9cf6 100644
--- a/mod/tenant-service.hxx
+++ b/mod/tenant-service.hxx
@@ -21,7 +21,8 @@ namespace brep
     virtual ~tenant_service_base () = default;
   };
 
-  // Possible build notifications:
+  // Possible build notifications (see also the unloaded special notification
+  // below):
   //
   // queued
   // building
@@ -121,6 +122,18 @@ namespace brep
                  const diag_epilogue& log_writer) const noexcept = 0;
   };
 
+  // This notification is only made on unloaded CI requests created with the
+  // ci_start::create() call and until they are loaded with ci_start::load()
+  // or, alternatively, ci_start::abandon().
+  //
+  class tenant_service_build_unloaded: public virtual tenant_service_base
+  {
+  public:
+    virtual function<optional<string> (const tenant_service&)>
+    build_unloaded (const tenant_service&,
+                    const diag_epilogue& log_writer) const noexcept = 0;
+  };
+
   // Map of service type (tenant_service::type) to service.
   //
   using tenant_service_map = std::map<string, shared_ptr<tenant_service_base>>;
-- 
cgit v1.1