Port /v2/user/<user-uuid>/active-signature to golang

Signed-off-by: Lukasz Gryglicki <[email protected]>

Author: lukaszgryglicki

cla-backend-go/swagger/cla.v2.yaml

@@ -2445,6 +2445,48 @@ paths:
       tags:
         - signatures
 
+  /user/{userID}/active-signature:
+    parameters:
+      - $ref: "#/parameters/x-request-id"
+      - name: userID
+        description: the user ID
+        in: path
+        type: string
+        required: true
+        pattern: '^[a-fA-F0-9]{8}-?[a-fA-F0-9]{4}-?4[a-fA-F0-9]{3}-?[89ab][a-fA-F0-9]{3}-?[a-fA-F0-9]{12}$' # uuidv4
+    get:
+      summary: |
+        Returns all metadata associated with a user's active signature.
+        {
+          'user_id': <user-id>,
+          'project_id': <project-id>,
+          'repository_id': <repository-id>,
+          'pull_request_id': <PR>,
+          'return_url': <url-where-user-initiated-signature-from>'
+        }
+        Returns null if the user does not have an active signature.
+      security: [ ]
+      operationId: getUserActiveSignature
+      responses:
+        '200':
+          description: 'Success'
+          headers:
+            x-request-id:
+              type: string
+              description: The unique request ID value - assigned/set by the API Gateway based on the session
+          schema:
+            $ref: '#/definitions/user-active-signature'
+        '400':
+          $ref: '#/responses/invalid-request'
+        '401':
+          $ref: '#/responses/unauthorized'
+        '403':
+          $ref: '#/responses/forbidden'
+        '404':
+          $ref: '#/responses/not-found'
+      tags:
+        - signatures
+
   /signatures/project/{projectSFID}/company/{companyID}/employee:
     get:
       summary: Get project company signatures for the employees
@@ -5006,6 +5048,9 @@ definitions:
   user:
     $ref: './common/user.yaml'
 
+  user-active-signature:
+    $ref: './common/user-active-signature.yaml'
+
   signatures:
     $ref: './common/signatures.yaml'
 

cla-backend-go/swagger/common/user-active-signature.yaml

@@ -0,0 +1,29 @@
+# Copyright The Linux Foundation and each contributor to CommunityBridge.
+# SPDX-License-Identifier: MIT
+
+type: object
+x-nullable: true
+title: User Active Signature
+description: >
+  Returns all metadata associated with a user's active signature.
+  Returns `null` if the user does not have an active signature.
+properties:
+  user_id:
+    $ref: './common/properties/internal-id.yaml'
+    description: The unique internal ID of the user
+  project_id:
+    $ref: './common/properties/internal-id.yaml'
+    description: The unique ID of the associated project
+  repository_id:
+    type: string
+    description: The unique ID of the associated repository
+    example: repo-abc123
+  pull_request_id:
+    type: string
+    description: The pull request ID related to the signature
+    example: '456'
+  return_url:
+    type: string
+    format: uri
+    description: The return URL where the user initiated the signature
+    example: https://example.com/return