TASK-024: register_path / register_prefix split (GREEN)

Replaces the positional `bool family` parameter on register_resource
with a named-API choice between exact and prefix matching. Public
surface on `webserver`:

  - register_path(path, ptr)     -- exact-match registration. Both
                                    unique_ptr<T> and shared_ptr<http_resource>
                                    overloads, returning void. The
                                    unique_ptr<T> form is a templated
                                    inline shim that funnels into the
                                    shared_ptr overload (TASK-023's
                                    pattern) so derived types resolve
                                    unambiguously.
  - register_prefix(path, ptr)   -- prefix-match registration. Same
                                    overload shape.
  - register_resource(path, ptr) -- now [[deprecated]]; thin alias for
                                    register_path. The 3-arg `bool
                                    family` overloads are GONE.
  - unregister_path(path)        -- erase only an exact registration.
  - unregister_prefix(path)      -- erase only a prefix registration.
  - unregister_resource(path)    -- kind-agnostic convenience; calls
                                    both unregister_path and
                                    unregister_prefix (idempotent).

Implementation moves the validation/insertion logic into a private
register_impl_(path, res, family) helper so the family flag only lives
in one place. The same is done for unregister: unregister_impl_ builds
the http_endpoint with the correct family flag (so the erase actually
finds the original key) and only touches the registered_resources_str
fast-path map for non-family entries (the str map only ever held
exact registrations -- this fixes a latent erase bug where
unregister_resource called .erase(string) on a map<http_endpoint,...>).

The single_resource validation now reads "must be registered via
register_prefix" rather than "must be marked as family"; the
deprecated register_resource forwarder calls register_path, so a
single_resource caller doing register_resource("/", sp) now correctly
throws -- they must call register_prefix("/", sp).

Acceptance criteria:

  - `grep -E 'register_resource\([^)]+,\s*bool\s' src/httpserver/*.hpp`
    returns no results: the bool-family overloads are deleted.
  - The new test TU pins both kinds at runtime (prefix matches a
    longer URL; exact does not; parameterized exact path binds {id};
    unregister_* and the umbrella unregister_resource alias all 404
    after removal; the deprecated register_resource forwarder still
    serves and behaves like register_path).
  - All 34 testsuite entries pass under `make check -j1`.

Call sites updated in this commit:

  - examples/*: register_resource(p, ptr, true) -> register_prefix(p, ptr).
    Other examples (which used register_resource for exact match) are
    renamed to register_path to avoid -Werror on the new
    [[deprecated]] forwarder.
  - test/integ/*: same treatment. The smartptr unit test still
    exercises the deprecated forwarder (that is its purpose), so it
    silences -Wdeprecated-declarations file-wide.
  - examples/url_registration.cpp gains a "/family" prefix showcase
    and uses register_path / register_prefix throughout to model the
    new API surface for users.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: etr

examples/allowing_disallowing_methods.cpp

@@ -35,7 +35,7 @@ int main() {
     auto hwr = std::make_shared<hello_world_resource>();
     hwr->disallow_all();
     hwr->set_allowing(httpserver::http_method::get, true);
-    ws.register_resource("/hello", hwr);
+    ws.register_path("/hello", hwr);
     ws.start(true);
 
     return 0;

examples/args_processing.cpp

@@ -90,7 +90,7 @@ int main() {
     httpserver::webserver ws = httpserver::create_webserver(8080);
 
     auto ar = std::make_shared<args_resource>();
-    ws.register_resource("/args", ar);
+    ws.register_path("/args", ar);
 
     std::cout << "Server running on http://localhost:8080/args\n";
     std::cout << "Try: http://localhost:8080/args?name=john&age=30\n";

examples/basic_authentication.cpp

@@ -39,7 +39,7 @@ int main() {
     httpserver::webserver ws = httpserver::create_webserver(8080);
 
     auto hwr = std::make_shared<user_pass_resource>();
-    ws.register_resource("/hello", hwr);
+    ws.register_path("/hello", hwr);
     ws.start(true);
 
     return 0;

examples/benchmark_nodelay.cpp

@@ -52,7 +52,7 @@ int main(int argc, char** argv) {
     hello->with_header("Server", "libhttpserver");
 
     auto hwr = std::make_shared<hello_world_resource>(hello);
-    ws.register_resource(PATH, hwr, false);
+    ws.register_path(PATH, hwr);
 
     ws.start(true);
 

examples/benchmark_select.cpp

@@ -51,7 +51,7 @@ int main(int argc, char** argv) {
     hello->with_header("Server", "libhttpserver");
 
     auto hwr = std::make_shared<hello_world_resource>(hello);
-    ws.register_resource(PATH, hwr, false);
+    ws.register_path(PATH, hwr);
 
     ws.start(true);
 

examples/benchmark_threads.cpp

@@ -50,7 +50,7 @@ int main(int argc, char** argv) {
     hello->with_header("Server", "libhttpserver");
 
     auto hwr = std::make_shared<hello_world_resource>(hello);
-    ws.register_resource(PATH, hwr, false);
+    ws.register_path(PATH, hwr);
 
     ws.start(true);
 

examples/binary_buffer_response.cpp

@@ -74,7 +74,7 @@ int main() {
     httpserver::webserver ws = httpserver::create_webserver(8080);
 
     auto ir = std::make_shared<image_resource>();
-    ws.register_resource("/image", ir);
+    ws.register_path("/image", ir);
     ws.start(true);
 
     return 0;

examples/centralized_authentication.cpp

@@ -63,8 +63,8 @@ int main() {
     auto hello = std::make_shared<hello_resource>();
     auto health = std::make_shared<health_resource>();
 
-    ws.register_resource("/api", hello);
-    ws.register_resource("/health", health);
+    ws.register_path("/api", hello);
+    ws.register_path("/health", health);
 
     ws.start(true);
 

examples/client_cert_auth.cpp

@@ -157,8 +157,8 @@ int main() {
     auto secure = std::make_shared<secure_resource>();
     auto info = std::make_shared<info_resource>();
 
-    ws.register_resource("/secure", secure);
-    ws.register_resource("/info", info);
+    ws.register_path("/secure", secure);
+    ws.register_path("/info", info);
 
     std::cout << "Server started. Press Ctrl+C to stop.\n\n";
     std::cout << "Test commands:\n";

examples/custom_access_log.cpp

@@ -40,7 +40,7 @@ int main() {
         .log_access(custom_access_log);
 
     auto hwr = std::make_shared<hello_world_resource>();
-    ws.register_resource("/hello", hwr);
+    ws.register_path("/hello", hwr);
     ws.start(true);
 
     return 0;