WIP: v3

[Kansuler]

In progress

[Copilot]

Pull Request Overview

This pull request introduces a major version 3 of the Octobe database abstraction library with significant architectural improvements. It enhances the API design with better type safety, simplifies transaction management, and modernizes the overall developer experience while maintaining the core philosophy of raw SQL execution without ORM complexity.

Key changes:

• Complete API redesign with improved type safety and generics usage
• Simplified transaction management with automatic begin/commit/rollback handling
• Enhanced testing infrastructure with comprehensive mock implementations
• Updated documentation with migration guides and extensive examples

Reviewed Changes

Copilot reviewed 22 out of 25 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
octobe.go	Core API redesign with new interfaces, automatic transaction management, and handler patterns
go.mod	Version bump to v3 with updated Go version and dependencies
examples/	New comprehensive examples showing real-world usage patterns
driver/postgres/	Complete rewrite with separate PGX and PGXPool implementations
driver/postgres/mock/	New extensive mock framework for testing database interactions
README.md	Major documentation overhaul with migration guides and detailed examples

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}