Implement account activity reporting and compliance analysis utilities

[Just-Bamford]

Description

Problem

Account activity can be retrieved, but there is no structured reporting layer for categorizing transactions or preparing account-level compliance data. Consumers must independently transform raw activity into audit-friendly records.

Solution

Introduce a reporting pipeline that normalizes account activity, categorizes transaction behavior, and produces framework-specific report structures. The design should allow additional compliance rules to be introduced without changing the underlying activity retrieval APIs.

Acceptance Criteria

• generateComplianceReport(account, framework) is introduced
• Activity is normalized into a consistent reporting structure
• Transaction categories include transfers, payments, swaps, and contract interactions
• Framework-specific rule sets can be selected without duplicating retrieval logic
• Reports include configurable date ranges and account metadata
• Unsupported or incomplete activity is reported explicitly
• Tests cover categorization, date filtering, framework selection, and incomplete data
• Reporting APIs are exported through src/account/index.ts and src/index.ts

Note for Contributors

Treat this as a reporting abstraction rather than a legal compliance engine. Keep framework rules configurable and avoid embedding assumptions about jurisdiction-specific regulatory requirements.

[Machundii]

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

Hi. I would like to work on this issue

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

[drips-wave]

Congratulations, @Machundii! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @Machundii: 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 🌊