Skip to content

Commit f3fb618

Browse files
qq9340100claude
andauthored
docs: drop refused dotted-fields remedy from v17 release notes (#8393)
The v17.mdx removed-features row for the fields[] object form prescribed a dotted path (fields: ['owner.name']) as a fallback alongside expand. That spelling is now refused at both doors (REST ingress since #7532/PR #7588, engine find/findOne since #7589/PR #8327), so the remedy pointed upgraders straight into the refusal it was meant to route around. Per the card's own prescription: drop the dotted alternative, keep expand alone with the reference column preserved in the projection. Fixes #8329 Claude-Session: https://claude.ai/code/session_01Jqe56GnYFddggeAyfkZFVz Co-authored-by: Claude <noreply@anthropic.com>
1 parent 75fd301 commit f3fb618

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

content/docs/releases/v17.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -974,7 +974,7 @@ a `tsc` error at the call site.
974974

975975
| Removed | Why | Use instead |
976976
|---|---|---|
977-
| `fields[]` object form `{ field, fields, alias }` | inert end to end — every reader treats the list as `string[]`, so it was dropped by the SQL and memory drivers, projected as a column named `"[object Object]"` by MongoDB, and refused by the REST ingress | `expand`, or a dotted path for a single related column (`fields: ['owner.name']`) |
977+
| `fields[]` object form `{ field, fields, alias }` | inert end to end — every reader treats the list as `string[]`, so it was dropped by the SQL and memory drivers, projected as a column named `"[object Object]"` by MongoDB, and refused by the REST ingress | `expand`, keeping the reference column in the projection (`fields: ['title', 'owner']` plus `expand`) |
978978
| `query.joins` | no engine or driver ever read it; the name squatted on the reserved REST parameter set (the `JoinNode`/`JoinType`/`JoinStrategy` cluster goes with it) | `expand` — the engine resolves it via batch `$in` queries |
979979
| `query.windowFunctions` | `find()` never applied one, so every OVER clause was silently dropped; `WindowFunctionNode` declared `field`/`over`/`frame` members the live door never read | `aggregations` + `groupBy`; embedders on a SQL datasource call `SqlDriver.findWithWindowFunctions()` |
980980
| `query.cursor` | no driver implemented keyset pagination — the cursor was accepted and ignored, so every page came back identical and a caller looping "until `hasMore` is false" never terminates | a `where` predicate on your sort key (`{ created_at: { $gt: last.created_at } }`) with the matching `orderBy` |

0 commit comments

Comments
 (0)