Skip to content

fix(data): updateView reads and writes the same row, so renaming a draft view persists - #4212

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-4139-updateview-draft-read
Aug 11, 2026
Merged

fix(data): updateView reads and writes the same row, so renaming a draft view persists#4212
yinlianghui merged 1 commit into
mainfrom
claude/issue-4139-updateview-draft-read

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes #4139

Premise

Verified on my tip, and it holds exactly as filed. The pre-fix write emitted for a rename of a draft-only view is, verbatim:

1st vi.fn() call:
  [ "view", "crm_activity.kanban_board",
    { "label": "Pipeline Board", "name": "crm_activity.kanban_board", "object": "crm_activity" } ]

That is the {label, name, object} partial-write signature the issue predicted — no viewKind, no config, which is what the server rejects with 422.

Root cause, and the half the issue did not name

ADR-0034 stages every runtime-created view as a per-item draft: the + tab goes through createRuntimeMetadatametadataClient.save(..., { mode: 'draft' }), so the view lives only in the draft row until an explicit Publish, and the UI reads it back through ?preview=draft.

updateView addressed neither half of that. Measuring the write half as the card asked — does saveItem write the draft? — gives a no that changes the fix: client.meta.saveItem has no draft mode at all (the SDK's meta.getItem/saveItem take only packageId), so the write half was published-addressed too. The two halves therefore already agreed — both pointed at the published overlay — and the mismatch was between updateView as a whole and the draft row the create path produces.

That matters because fixing only the read would not fix the reported symptom: the merge would be correct, but the write would still land on the published overlay while the draft row keeps shadowing it in preview, so the rename stays invisible and Publish later overwrites it with the pre-edit body. Making the halves agree on the right row requires moving both.

The fix

packages/data-objectstack/src/index.ts — the read probes the draft first and, on a hit, merges onto that body and writes it straight back with mode: 'draft' via the existing MetadataClient seam (the same one listViews({ previewDrafts }) already uses). Whichever row the read resolved is the row the write updates — agreement by construction, not coincidence.

Draft before published is load-bearing for a view that has both: writing the published row while a draft is pending puts the edit where the draft shadows it, and Publish then overwrites it with the pre-edit body — losing the change a second time, later, where nothing connects it to this call. A draft edit stays a draft, so ADR-0037's guarantee that nothing the preview shows goes live until Publish is preserved. Renaming a published view with no draft pending is untouched: published read, published write.

The silent catch is gone (issue requirement 3). Call sites measured first — all five are in ObjectView.tsx (rename, pin, set-default ×2, reorder), every one an update to an already-listed view, and none creates a view; createView is the operation that means "create". So no caller depended on "create-equivalent", and it is not preserved. A view resolving in neither home now throws naming the view and object; a network/permission/server fault on either read propagates. All five call sites already try/catch and toast, so this surfaces a previously-invisible failure rather than introducing a new one.

Set-default (issue requirement 4) — measured, and it splits

Two symptoms, two causes:

  • The partial write on set-default does share this root cause — same read-merge-write cycle with an {isDefault: true} patch — so it is fixed here and carries its own pin.
  • "Fires no write at all" does not originate in updateView, which writes unconditionally for every patch shape (no early return between read and write; measured against the pre-fix code, an {isDefault: true} patch produced a write every time). It can only come from ObjectView.tsx's isSavedView guard — the sole early return on that path — or from ViewTabBar hiding the menu item under onSetDefaultView && !isReadonly when no savedViews row matches the tab id.

That is UI-layer, above this adapter and on #4155's surface, so per the dispatch scope it is not fixed here — filed with the full measurement as #4211.

Tests

New pins in packages/data-objectstack/src/updateView.draft.test.ts (7): draft rename carries the full merged document to a mode=draft write; draft probed before published; set-default patch likewise; control — published view with no draft still updates the published overlay; genuinely-missing view throws with no write; transport failure on the published read throws with no write; transport failure on the draft probe throws rather than falling through to published.

pnpm exec vitest run packages/data-objectstack/     →  Test Files 27 passed (27)   Tests 392 passed (392)
pnpm --filter @object-ui/data-objectstack type-check →  clean (tsc --noEmit)
pnpm --filter @object-ui/data-objectstack lint       →  0 errors (358 pre-existing no-explicit-any warnings)

Downstream consumers of updateView (ObjectView.defaultViewIdentity, clientValidation.viewShapes) re-run green — 20 passed — since the error semantics changed. Suites were scoped to packages/data-objectstack/ plus those two files per the repo's root-only rule (objectui#3378); the wide sweep is left to CI shards.

Reverse verification

Direction predicted before running: removing the fix should turn the pins RED with the partial-write signature, and leave the control green, since the control exercises the published path the fix deliberately does not change.

git checkout origin/main -- packages/data-objectstack/src/index.ts6 of 7 red, control green, first failure showing {label, name, object} verbatim. Restored with git checkout HEAD -- ...; full suite green again. Confirmed as predicted, including the control staying green.

Changeset

@object-ui/data-objectstack patch.


Generated by Claude Code

…aft view persists

ADR-0034 stages a runtime-created view as a per-item draft, so a view made
from the `+` tab exists only as a draft row until an explicit Publish.
`updateView` addressed neither half of that: the read went to the published
overlay and 404ed, a `catch {}` labelled "treat missing as create-equivalent"
substituted `current = {}`, and the read-merge-write cycle emitted a
`{label, name, object}` partial the server rejects (422) — while the draft
row the UI reads back through `?preview=draft` kept the old label.

The read now probes the draft first and, on a hit, merges onto that body and
writes it back with `mode: 'draft'` — whichever row the read resolved is the
row the write updates. Draft-before-published also keeps an edit from landing
where a pending draft would shadow it and Publish would later overwrite it.

The silent catch is gone: a view found in neither home throws naming the view
and object, and a transport failure on either read propagates rather than
degrading into the partial write.

Fixes #4139

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3
@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Aug 10, 2026 11:55pm

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 28.3 KB 350 KB
Entry file index-CJZPzNBp.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 8.88KB 3.25KB
app-shell (runtime-config.js) 7.42KB 2.32KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 7.57KB 2.97KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 22.10KB 4.37KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.13KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.64KB 2.21KB
auth (SocialSignInButtons.js) 9.60KB 3.89KB
auth (UserMenu.js) 3.40KB 1.22KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 35.76KB 9.11KB
auth (createAuthenticatedFetch.js) 4.37KB 1.69KB
auth (index.js) 2.35KB 1.07KB
auth (org-roles.js) 6.66KB 2.78KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 4.91KB 0.87KB
auth (useIsWorkspaceAdmin.js) 1.61KB 0.85KB
collaboration (CommentThread.js) 26.07KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.65KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 486.47KB 107.53KB
core (index.js) 3.04KB 1.15KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 143.81KB 37.39KB
fields (index.js) 226.96KB 56.30KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (i18n.js) 4.32KB 1.77KB
i18n (index.js) 2.65KB 1.06KB
i18n (pickLocalized.js) 1.70KB 0.83KB
i18n (provider.js) 9.48KB 3.27KB
i18n (useObjectLabel.js) 27.59KB 6.63KB
i18n (useSafeTranslation.js) 4.52KB 1.96KB
layout (index.js) 38.87KB 10.80KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.74KB
mobile (index.js) 1.50KB 0.62KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 2.53KB 0.85KB
mobile (useResponsive.js) 0.71KB 0.42KB
mobile (useResponsiveConfig.js) 1.36KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 8.75KB 3.06KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 3.67KB 1.12KB
permissions (evaluator.js) 4.41KB 1.44KB
permissions (index.js) 0.91KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.52KB
permissions (usePermissions.js) 1.55KB 0.71KB
plugin-ai (index.js) 15.71KB 3.79KB
plugin-calendar (index.js) 45.23KB 12.45KB
plugin-charts (index.js) 61.52KB 17.49KB
plugin-chatbot (index.js) 180.33KB 42.79KB
plugin-dashboard (index.js) 118.52KB 30.68KB
plugin-designer (index.js) 210.51KB 42.51KB
plugin-detail (index.js) 237.80KB 59.48KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 114.58KB 27.68KB
plugin-gantt (index.js) 162.77KB 39.66KB
plugin-grid (index.js) 187.97KB 49.90KB
plugin-kanban (index.js) 48.60KB 13.41KB
plugin-list (index.js) 110.04KB 26.67KB
plugin-map (index.js) 17.00KB 5.32KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 40.58KB 10.58KB
plugin-timeline (index.js) 26.21KB 7.52KB
plugin-tree (index.js) 8.50KB 2.88KB
plugin-view (index.js) 84.03KB 20.55KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.71KB 3.53KB
providers (index.js) 0.44KB 0.22KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.67KB 2.37KB
react (LazyPluginLoader.js) 3.77KB 1.33KB
react (SchemaRenderer.js) 23.71KB 7.95KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 1.23KB 0.66KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 4.09KB 1.74KB
sdui-parser (index.js) 4.47KB 2.03KB
sdui-parser (parse.js) 10.04KB 2.82KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 4.69KB 1.48KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 0.20KB 0.18KB
types (crud.js) 0.20KB 0.18KB
types (data-display.js) 0.20KB 0.18KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.87KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-retry.js) 4.32KB 2.02KB
types (index.js) 2.71KB 1.34KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 2.59KB 1.31KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
types (plugin-scope.js) 0.20KB 0.18KB
types (record-components.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (spec-report.js) 5.05KB 1.93KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 0.20KB 0.18KB
types (ui-action.js) 3.40KB 1.71KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@yinlianghui
yinlianghui marked this pull request as ready for review August 11, 2026 02:52
@yinlianghui
yinlianghui added this pull request to the merge queue Aug 11, 2026
Merged via the queue into main with commit b42558a Aug 11, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4139-updateview-draft-read branch August 11, 2026 02:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants