Implement DynamoDB client

[Oluwaseyi89]

Problem Statement

The DynamoDB client is completely unimplemented. The file pkg/aws/dynamodb_client.go is gated with //go:build future, so it is excluded from all production builds and contains only a stub. As a result, the platform cannot store or manage WebSocket connection IDs and session state in DynamoDB, blocking scalable, serverless management of real-time connections and stateful event workflows.

Social Media Link

Let's collaborate on Discord. And ensure to star our repo.

Context

• No client exists for interacting with AWS DynamoDB from the backend.
• WebSocket connection management and session state persistence are not possible in a distributed, serverless environment.
• Real-time features and Lambda handlers require DynamoDB for scalable, low-latency state storage.

Requirements

• Implement a Go client in pkg/aws/dynamodb_client.go to interact with AWS DynamoDB for storing and retrieving WebSocket connection IDs and session state.
• Support CRUD operations for connection records, session tokens, and related metadata.
• Integrate with the WebSocket connection manager, notification service, and Lambda handlers.
• Ensure secure handling of AWS credentials and environment-based configuration.
• Add error handling, logging, and retry logic for failed DynamoDB operations.
• Add unit and integration tests for the client, including edge cases (e.g., conditional writes, throttling, expired sessions).
• Remove the //go:build future tag so the implementation is included in production builds.

Acceptance Criteria

• pkg/aws/dynamodb_client.go contains a production-ready DynamoDB client implementation.
• The platform can store and manage WebSocket connection IDs and session state in DynamoDB.
• The client is integrated with real-time connection management and notification workflows.
• Unit and integration tests cover all major code paths and error scenarios.
• The feature is included in production builds (no //go:build future tag).

Definition of Done

• All requirements and acceptance criteria are met.
• Code is reviewed, merged, and deployed to staging.
• Documentation (README, code comments) is updated.
• No critical bugs or regressions are present.
• Stakeholders can rely on scalable, serverless WebSocket state management via DynamoDB.

Directory to Work On

• project-portal/project-portal-backend

[lawalajose]

@lawalajose has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hi! I’d love to work on this issue because it genuinely interests me. I’m proficient in Go and have experience working with backend systems, APIs, and open-source collaboration. I’d be happy to contribute and help move this forward.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @lawalajose to this issue.

[drips-wave]

Congratulations, @lawalajose! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @lawalajose: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @lawalajose as part of the Stellar Wave Program's 5th Wave 🥳

😎 @lawalajose: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.