chore: update dependencies and improve documentation links

- Added new dependencies: `github.com/google/uuid` and `github.com/lestrrat-go/jwx/v2`.
- Updated existing dependencies to their latest versions, including `goa.design/goa/v3` and various `golang.org/x` packages.
- Revised documentation links in the README and related files to reflect the new directory structure for subjects.
- Adjusted paths in documentation files to ensure correct navigation to internal resources.

Jira Ticket: https://linuxfoundation.atlassian.net/browse/LFXV2-888

Signed-off-by: Mauricio Zanetti Salomao <mauriciozanetti86@gmail.com>

Author: mauriciozanettisalomao

README.md

@@ -66,7 +66,7 @@ Look up users by their email addresses to retrieve usernames or subject identifi
 - `lfx.auth-service.email_to_username` - Look up username by email
 - `lfx.auth-service.email_to_sub` - Look up subject identifier by email
 
-**[View Email Lookup Documentation](docs/email_lookups.md)**
+**[View Email Lookup Documentation](docs/subjects/email_lookups.md)**
 
 ---
 
@@ -77,7 +77,7 @@ Retrieve and update user profile metadata using various input types (JWT tokens,
 - `lfx.auth-service.user_metadata.read` - Retrieve user metadata
 - `lfx.auth-service.user_metadata.update` - Update user profile
 
-**[View User Metadata Documentation](docs/user_metadata.md)**
+**[View User Metadata Documentation](docs/subjects/user_metadata.md)**
 
 ---
 
@@ -87,7 +87,7 @@ Retrieve user email addresses (primary and alternate emails) using various input
 **Subjects:**
 - `lfx.auth-service.user_emails.read` - Retrieve user email addresses
 
-**[View User Emails Documentation](docs/user_emails.md)** - **Note:** Currently only supported for Authelia
+**[View User Emails Documentation](docs/subjects/user_emails.md)** - **Note:** Currently only supported for Authelia
 
 ---
 
@@ -98,7 +98,7 @@ Two-step verification flow for verifying ownership of alternate email addresses.
 - `lfx.auth-service.email_linking.send_verification` - Send OTP to email
 - `lfx.auth-service.email_linking.verify` - Verify email with OTP
 
-**[View Email Verification Documentation](docs/email_verification.md)** - Includes complete flow diagram
+**[View Email Verification Documentation](docs/subjects/email_verification.md)** - Includes complete flow diagram
 
 ---
 
@@ -108,7 +108,7 @@ Link verified identities (such as verified email addresses) to user accounts.
 **Subjects:**
 - `lfx.auth-service.user_identity.link` - Link verified identity to user
 
-**[View Identity Linking Documentation](docs/identity_linking.md)**
+**[View Identity Linking Documentation](docs/subjects/identity_linking.md)**
 
 ---
 

docs/subjects/email_lookups.md

@@ -98,5 +98,5 @@ nats request lfx.auth-service.email_to_sub zephyr.stormwind@mythicaltech.io
 - Linked/alternate email addresses are **not** supported for lookup
 - The service works with Auth0, Authelia, and mock repositories based on configuration
 - The returned subject identifier is the canonical user identifier used throughout the system
-- For Authelia-specific SUB identifier details and how they are populated, see: [`../internal/infrastructure/authelia/README.md`](../internal/infrastructure/authelia/README.md)
+- For Authelia-specific SUB identifier details and how they are populated, see: [`../../internal/infrastructure/authelia/README.md`](../../internal/infrastructure/authelia/README.md)
 

docs/subjects/email_verification.md

@@ -193,6 +193,6 @@ nats request lfx.auth-service.email_linking.verify '{
 - OTP codes are time-sensitive and available for a valid time period
 - The service prevents linking an email that is already verified and linked to another user
 - The returned token (ID token) can be used to link the verified email to the user account using the identity linking operation (see [Identity Linking Documentation](identity_linking.md))
-- For detailed Auth0-specific implementation details and technical information about the passwordless flow, see: [`../internal/infrastructure/auth0/README.md`](../internal/infrastructure/auth0/README.md)
+- For detailed Auth0-specific implementation details and technical information about the passwordless flow, see: [`../../internal/infrastructure/auth0/README.md`](../../internal/infrastructure/auth0/README.md)
 
 

docs/subjects/user_emails.md

@@ -142,8 +142,8 @@ nats request lfx.auth-service.user_emails.read "john.doe" | jq '.data.alternate_
 - Primary email is always present if the user exists
 - Alternate emails array may be empty if the user has not linked any additional email addresses
 - Only verified alternate emails should be considered as confirmed user identities
-- For detailed Auth0-specific behavior and limitations, see: [`../internal/infrastructure/auth0/README.md`](../internal/infrastructure/auth0/README.md)
-- For detailed Authelia-specific behavior and SUB management, see: [`../internal/infrastructure/authelia/README.md`](../internal/infrastructure/authelia/README.md)
+- For detailed Auth0-specific behavior and limitations, see: [`../../internal/infrastructure/auth0/README.md`](../../internal/infrastructure/auth0/README.md)
+- For detailed Authelia-specific behavior and SUB management, see: [`../../internal/infrastructure/authelia/README.md`](../../internal/infrastructure/authelia/README.md)
 
 ---
 

docs/subjects/user_metadata.md

@@ -108,8 +108,8 @@ nats request lfx.auth-service.user_metadata.read "john.doe"
 - The service automatically detects input type and applies the appropriate lookup strategy
 - JWT tokens are validated for signature and expiration before extracting subject information
 - The target identity provider is determined by the `USER_REPOSITORY_TYPE` environment variable
-- For detailed Auth0-specific behavior and limitations, see: [`../internal/infrastructure/auth0/README.md`](../internal/infrastructure/auth0/README.md)
-- For detailed Authelia-specific behavior and SUB management, see: [`../internal/infrastructure/authelia/README.md`](../internal/infrastructure/authelia/README.md)
+- For detailed Auth0-specific behavior and limitations, see: [`../../internal/infrastructure/auth0/README.md`](../../internal/infrastructure/auth0/README.md)
+- For detailed Authelia-specific behavior and SUB management, see: [`../../internal/infrastructure/authelia/README.md`](../../internal/infrastructure/authelia/README.md)
 
 ---