Introduce Controller API to the package

Author: ayeshLK

Diff for: ballerina/annotation.bal

@@ -16,11 +16,13 @@
 
 # Configuration for a WebSub Hub service.
 #
-# + leaseSeconds - The period for which the subscription is expected to be active in the `hub`
-# + webHookConfig - HTTP client configurations for subscription/unsubscription intent verification
+# + leaseSeconds - The period for which the subscription is expected to be active in the `hub`  
+# + webHookConfig - HTTP client configurations for subscription/unsubscription intent verification  
+# + autoVerifySubscription - Configuration to enable or disable automatic subscription verification
 public type ServiceConfiguration record {|
     int leaseSeconds?;
     ClientConfiguration webHookConfig?;
+    boolean autoVerifySubscription = false;
 |};
 
 # WebSub Hub Configuration for the service.

Diff for: ballerina/http_service.bal

@@ -29,6 +29,7 @@ isolated service class HttpService {
     private final boolean isSubscriptionValidationAvailable;
     private final boolean isUnsubscriptionAvailable;
     private final boolean isUnsubscriptionValidationAvailable;
+    private final Controller hubController;
 
     isolated function init(HttpToWebsubhubAdaptor adaptor, string hubUrl, int leaseSeconds,
                            *ClientConfiguration clientConfig) {
@@ -41,6 +42,7 @@ isolated service class HttpService {
         self.isSubscriptionValidationAvailable = isMethodAvailable("onSubscriptionValidation", methodNames);
         self.isUnsubscriptionAvailable = isMethodAvailable("onUnsubscription", methodNames);
         self.isUnsubscriptionValidationAvailable = isMethodAvailable("onUnsubscriptionValidation", methodNames);
+        self.hubController = new;
     }
 
     isolated resource function post .(http:Caller caller, http:Request request, http:Headers headers) returns Error? {

Diff for: ballerina/hub_controller.bal

@@ -0,0 +1,28 @@
+// Copyright (c) 2025 WSO2 LLC. (http://www.wso2.com).
+//
+// WSO2 LLC. licenses this file to you under the Apache License,
+// Version 2.0 (the "License"); you may not use this file except
+// in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+// todo: implement this properly
+
+public isolated class Controller {
+
+    public function markAsVerified(Subscription|Unsubscription subscription) returns error? {
+        return error("Not implemented yet");
+    }
+
+    function skipSubscriptionVerification(Subscription|Unsubscription subscription) returns boolean {
+        return false;
+    }
+}