Skip to content

Conversation

@gioboa
Copy link
Collaborator

@gioboa gioboa commented Nov 30, 2025

These options are present in the MysqlConnectionCredentialsOptions interface, but are missing from the documentation.
The options are placed in a logical order, keeping the basic connection parameters (host, port, username, password, database, socketPath, poolSize) together before the more advanced configuration options.

@qodo-free-for-open-source-projects

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪
🧪 No relevant tests
🔒 No security concerns identified
⚡ Recommended focus areas for review

Documentation Clarity

The socketPath description is very brief. Consider adding more context about when to use this option (e.g., for local connections via Unix socket instead of TCP/IP) and whether it's mutually exclusive with host/port parameters.

-   `socketPath` - Database socket path.
Ambiguous Description

The poolSize description mentions 'for each connection' which is confusing since poolSize typically refers to the total number of connections in the pool, not per-connection. Verify this description matches the actual implementation behavior.

-   `poolSize` - Maximum number of clients the pool should contain for each connection.

@qodo-free-for-open-source-projects

PR Code Suggestions ✨

Explore these optional code suggestions:

CategorySuggestion                                                                                                                                    Impact
General
Clarify socketPath usage and precedence

Improve the socketPath description to specify it is for Unix sockets and that it
takes precedence over host and port.

docs/docs/drivers/mysql.md [37]

--   `socketPath` - Database socket path.
+-   `socketPath` - The path to a Unix socket for connecting to the database. When this is provided, `host` and `port` are ignored.
  • Apply / Chat
Suggestion importance[1-10]: 6

__

Why: The suggestion significantly improves the documentation for socketPath by clarifying its purpose as an alternative to host and port and explaining its precedence, which helps prevent common configuration errors.

Low
Clarify connection pool size description

Clarify the description for poolSize to state it is the maximum number of
connections in the pool, removing the confusing phrase "for each connection".

docs/docs/drivers/mysql.md [39]

--   `poolSize` - Maximum number of clients the pool should contain for each connection.
+-   `poolSize` - The maximum number of connections to create in the connection pool.
  • Apply / Chat
Suggestion importance[1-10]: 5

__

Why: The suggestion correctly identifies that the description for poolSize is confusing and provides a much clearer alternative, improving documentation quality and preventing user misconfiguration.

Low
  • More

@alumni alumni changed the title docs: add missing mysql props docs(mysql): add missing mysql credential options Nov 30, 2025
@qodo-free-for-open-source-projects

PR Code Suggestions ✨

No code suggestions found for the PR.

@gioboa gioboa merged commit 61f9e0d into typeorm:master Nov 30, 2025
8 checks passed
@gioboa gioboa deleted the docs/update-mysql branch November 30, 2025 19:35
ThbltLmr pushed a commit to ThbltLmr/typeorm that referenced this pull request Dec 2, 2025
mgohin pushed a commit to mgohin/typeorm that referenced this pull request Jan 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants