merge dev to main (v3.9.1)

[ymc9]

Summary by CodeRabbit

• New Features

  • Added support for computed fields to access client context, including authentication-related values.
  • Improved handling of mapped model, field, type, and enum names across queries and transactions.
  • Expanded ORM client and CRUD APIs for more flexible client-based configuration.

• Bug Fixes

  • Fixed expression grouping and boolean filter behavior for computed fields.
  • Improved consistency of mapped names across derived clients and connections.

• Tests

  • Added coverage for computed-field context, authentication, transactions, and mapped-name behavior.

• Release

  • Updated packages to version 3.9.1.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 19b254f5-8c6c-4ca7-8777-ff993457561e

📥 Commits

Reviewing files that changed from the base of the PR and between 46d5730 and 1390aa0.

📒 Files selected for processing (43)

• package.json
• packages/auth-adapters/better-auth/package.json
• packages/cli/package.json
• packages/clients/client-helpers/package.json
• packages/clients/fetch-client/package.json
• packages/clients/tanstack-query/package.json
• packages/common-helpers/package.json
• packages/config/eslint-config/package.json
• packages/config/tsdown-config/package.json
• packages/config/typescript-config/package.json
• packages/config/vitest-config/package.json
• packages/create-zenstack/package.json
• packages/ide/vscode/package.json
• packages/language/package.json
• packages/orm/package.json
• packages/orm/src/client/client-impl.ts
• packages/orm/src/client/crud/dialects/base-dialect.ts
• packages/orm/src/client/crud/dialects/index.ts
• packages/orm/src/client/crud/dialects/mysql.ts
• packages/orm/src/client/crud/dialects/postgresql.ts
• packages/orm/src/client/crud/operations/base.ts
• packages/orm/src/client/executor/name-mapper.ts
• packages/orm/src/client/executor/zenstack-query-executor.ts
• packages/orm/src/client/options.ts
• packages/orm/src/client/query-utils.ts
• packages/plugins/policy/package.json
• packages/plugins/policy/src/expression-transformer.ts
• packages/plugins/policy/src/policy-handler.ts
• packages/plugins/soft-delete/package.json
• packages/plugins/soft-delete/src/plugin.ts
• packages/schema/package.json
• packages/sdk/package.json
• packages/server/package.json
• packages/testtools/package.json
• packages/zod/package.json
• samples/orm/package.json
• samples/taskforge/package.json
• tests/e2e/orm/client-api/computed-fields.test.ts
• tests/e2e/package.json
• tests/regression/package.json
• tests/regression/test/issue-2773.test.ts
• tests/runtimes/bun/package.json
• tests/runtimes/edge-runtime/package.json

💤 Files with no reviewable changes (1)

• packages/orm/src/client/crud/dialects/mysql.ts

---

📝 Walkthrough

Walkthrough

The ORM now supports client-aware CRUD dialects and computed fields. Executors detect and reuse compatible name mappers across derived clients. Tests cover computed-field context, expression precedence, mapped names, transactions, and plugins. Package versions were updated to 3.9.1.

Changes

ORM client and dialect flow

Layer / File(s)	Summary
Client-aware dialects and computed fields packages/orm/src/client/client-impl.ts, packages/orm/src/client/crud/dialects/*, packages/orm/src/client/options.ts	CRUD dialects accept client contracts or schema/options. Computed fields receive client context and query-time arguments. Transaction callbacks use $contract.
Name-mapper reuse and executor wiring packages/orm/src/client/executor/*, packages/orm/src/client/query-utils.ts, packages/orm/src/client/crud/operations/base.ts, packages/plugins/*	Executors detect mapped names, reuse compatible mappers, and propagate them through derived clients. ORM plugins now construct dialects from clients.
Behavior validation tests/e2e/orm/client-api/computed-fields.test.ts, tests/regression/test/issue-2773.test.ts	Tests cover computed-field authentication and precedence, mapper identity, mapped enums, transactions, plugins, and mapped table and column queries.
Package version updates package.json, packages/*/package.json, samples/*/package.json, tests/*/package.json	Package versions change from 3.9.0 to 3.9.1.

Estimated code review effort: 4 (Complex) | ~45 minutes

Mergeability Score: ⚪ Minimal · up to 1390a

This change is merge-ready after normal checks and review; no actionable merge-blocking risk remains.

Possibly related PRs

• zenstackhq/zenstack#2744: Changes BaseCrudDialect computed-field handling and expression evaluation.
• zenstackhq/zenstack#2777: Covers QueryNameMapper reuse in related ORM files and regression tests.
• zenstackhq/zenstack#2789: Overlaps with client contracts, CRUD dialects, computed-field context, executors, plugins, and tests.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 50.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title identifies the merge direction and version release, which matches the version bumps and changes included in the pull request.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch dev

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

packages/auth-adapters/better-auth/package.json

ESLint skipped: missing config or dependency (missing-dependency). The ESLint configuration references a package that is not available in the sandbox.

packages/cli/package.json

ESLint skipped: missing config or dependency (missing-dependency). The ESLint configuration references a package that is not available in the sandbox.

packages/clients/client-helpers/package.json

ESLint skipped: missing config or dependency (missing-dependency). The ESLint configuration references a package that is not available in the sandbox.

• 26 others

---

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.}