Database lib bump

[shimonewman]

Summary by CodeRabbit

• Chores
  • Updated core database package dependency to the latest major version for improved compatibility and ongoing maintenance support.

[coderabbitai]

Walkthrough

The composer.json file is updated to bump the utopia-php/database package dependency from version 3.* to 4.*. This is a single version constraint change in the require section with no functional code modifications, logic alterations, or error handling changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Verify major version compatibility: Review breaking changes between utopia-php/database v3 and v4 to ensure the codebase can safely upgrade without compatibility issues
• Check for additional dependency adjustments: Confirm whether related dependencies or transitive dependencies require corresponding version updates
• Integration impact: Assess whether any codebase integrations with the database package need updates to work with v4's API

Pre-merge checks and finishing touches

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'Database lib bump' clearly and concisely describes the main change: bumping the database library version from 3.* to 4.* in composer.json.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch database-lib-bump

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d039181 and 7a12be1.

⛔ Files ignored due to path filters (1)

• composer.lock is excluded by !**/*.lock

📒 Files selected for processing (1)

• composer.json (1 hunks)

🧰 Additional context used

🧠 Learnings (1)

📓 Common learnings

Learnt from: abnegate
Repo: utopia-php/migration PR: 0
File: :0-0
Timestamp: 2025-07-30T12:06:02.331Z
Learning: In the utopia-php/migration codebase, the Utopia Database package does not have a Memory adapter. When testing classes that require a Database instance (like CSV), use PHPUnit's createMock() method to create proper mocks instead of trying to instantiate real database adapters.

Learnt from: abnegate
Repo: utopia-php/migration PR: 0
File: :0-0
Timestamp: 2025-07-30T12:06:02.331Z
Learning: In the utopia-php/migration codebase, the Utopia Database package does not have a Memory adapter. When testing classes that require a Database instance (like CSV), use PHPUnit's createMock() method to create proper mocks instead of trying to instantiate real database adapters.

Learnt from: ItzNotABug
Repo: utopia-php/migration PR: 81
File: src/Migration/Sources/CSV.php:215-233
Timestamp: 2025-07-02T06:24:50.844Z
Learning: In the utopia-php/migration codebase, invalid numeric values (like null) in parsed data are acceptable because the underlying database structure validator will catch and handle these validation errors, so explicit filtering during parsing is not required.

🔇 Additional comments (1)

composer.json (1)

29-29: Verify breaking changes and codebase compatibility for utopia-php/database v4.

This is a major version bump that likely introduces breaking changes to the Database API. Before merging, please verify:

1. Breaking changes: Are there API, method signature, or behavior changes in utopia-php/database v4 that affect this codebase? (The learnings indicate Database instances are used in migration sources like CSV.)
2. Code updates: Have all usages of the Database class been updated to work with v4?
3. Test verification: Do the full test suite and integration tests pass with v4?

Please confirm that the following hold true for this PR:

• All code changes required to support v4 compatibility are included in this PR or have already been merged
• The test suite passes with utopia-php/database v4.*
• Any deprecated or removed APIs from v3 have been addressed

You may want to consult the utopia-php/database changelog to identify breaking changes between v3 and v4.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}