@byline/host-tanstack-start 4.18.0 → 5.0.0

package/dist/server-fns/document-mutation-errors.js

@@ -0,0 +1,50 @@
+import { BylineError, ErrorCodes, getDocumentRevisionValidationDetails, getDocumentStaleDetails, getLockConflictDetails } from "@byline/core";
+import { getDocumentHookCommittedDetails } from "@byline/core/services";
+import { committedTreeReceipt } from "./structural-receipt.js";
+function documentMutationError(error) {
+    const stale = getDocumentStaleDetails(error);
+    if (stale) return {
+        code: ErrorCodes.DOCUMENT_STALE,
+        message: 'This document has changed. Reload before making changes.',
+        details: stale
+    };
+    const validation = getDocumentRevisionValidationDetails(error);
+    if (validation) return {
+        code: ErrorCodes.VALIDATION,
+        message: 'Reload this document before making changes.',
+        details: validation
+    };
+    const lock = getLockConflictDetails(error);
+    if (lock) return {
+        code: ErrorCodes.LOCK_CONFLICT,
+        message: 'This change could not be saved because another operation was using the document. Reload before trying again.',
+        details: lock
+    };
+    const tree = committedTreeReceipt(error);
+    if (tree) return {
+        code: ErrorCodes.TREE_HOOK_COMMITTED,
+        message: 'The structure was saved, but a follow-up action failed.',
+        details: tree
+    };
+    const committed = getDocumentHookCommittedDetails(error);
+    if (committed) return {
+        code: ErrorCodes.DOCUMENT_HOOK_COMMITTED,
+        message: 'The document was saved, but a follow-up action failed.',
+        details: committed
+    };
+    if (error instanceof BylineError && error.code === ErrorCodes.NOT_FOUND) return {
+        code: ErrorCodes.NOT_FOUND,
+        message: 'This document is no longer available.'
+    };
+    return error;
+}
+function withDocumentMutationErrors(handler) {
+    return async (input)=>{
+        try {
+            return await handler(input);
+        } catch (error) {
+            throw documentMutationError(error);
+        }
+    };
+}
+export { documentMutationError, withDocumentMutationErrors };

package/dist/server-fns/editable-revision.d.ts

@@ -0,0 +1,9 @@
+/** Restore metadata stripped by schema parsing only onto the exact source version.
+ * Never attach by array position: filtering/reordering must not transfer tokens. */
+export declare function withEditableRevision<T extends object>(document: T, observation: {
+    id: string;
+    versionId: string;
+    revision: number;
+} | undefined): T & {
+    revision: number;
+};

package/dist/server-fns/editable-revision.js

@@ -0,0 +1,11 @@
+import { ERR_DATABASE, isDocumentRevision } from "@byline/core";
+function withEditableRevision(document, observation) {
+    if (!observation || !isDocumentRevision(observation.revision) || Reflect.get(document, 'id') !== observation.id || Reflect.get(document, 'versionId') !== observation.versionId) throw ERR_DATABASE({
+        message: 'Editable response no longer matches its source observation'
+    });
+    return {
+        ...document,
+        revision: observation.revision
+    };
+}
+export { withEditableRevision };

package/dist/server-fns/singleton-document-read.d.ts

@@ -17,4 +17,4 @@ export interface SingletonDocumentReadInput {
  * is deliberately composed one layer up, where host database and actor
  * context are available without widening the singleton transport contract.
  */
-export declare function readSingletonDocument(data: SingletonDocumentReadInput): Promise<import("@byline/client").SingletonDocument<Record<string, any>> | null>;
+export declare function readSingletonDocument(data: SingletonDocumentReadInput): Promise<Omit<import("@byline/client").EditableDocument<Record<string, any>>, "path"> | null>;

package/dist/server-fns/singleton-document-read.js

@@ -1,10 +1,14 @@
 import { getAdminBylineClient } from "@byline/client/server";
-import { getCollectionDefinition } from "@byline/core";
+import { ERR_NOT_FOUND, getCollectionDefinition } from "@byline/core";
 import { resolveAdminDocumentRead } from "./admin-document-presentation.js";
 import { serialise } from "./serialise.js";
 async function readSingletonDocument(data) {
     const handle = getAdminBylineClient().singleton(data.singleton);
-    const { options } = resolveAdminDocumentRead(getCollectionDefinition(data.singleton), data);
-    return serialise(await handle.get(options));
+    const { options: { status: _status, ...options } } = resolveAdminDocumentRead(getCollectionDefinition(data.singleton), data);
+    const snapshot = await handle.getForEdit(options);
+    if (null == snapshot) throw ERR_NOT_FOUND({
+        message: 'Singleton document is unavailable'
+    });
+    return 'empty' === snapshot.state ? null : serialise(snapshot.document);
 }
 export { readSingletonDocument };

package/dist/server-fns/singletons/cancel-scheduled-publish.d.ts

@@ -1,12 +1,10 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const cancelSingletonScheduledPublish: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
 }) => {
+    expectedRevision: number;
     singleton: string;
-}, Promise<import("@byline/client").DocumentPublishScheduleInfo | null>>;
+}, Promise<{
+    schedule: import("@byline/client").DocumentPublishScheduleInfo | null;
+    revision: number;
+}>>;

package/dist/server-fns/singletons/cancel-scheduled-publish.js

@@ -1,7 +1,10 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
 import { serialise } from "../serialise.js";
 const cancelSingletonScheduledPublish = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).cancelScheduledPublish()));
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).cancelScheduledPublish({
+        expectedRevision: data.expectedRevision
+    }))));
 export { cancelSingletonScheduledPublish };

package/dist/server-fns/singletons/change-status.d.ts

@@ -1,14 +1,9 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const changeSingletonStatus: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
     status: string;
 }) => {
+    expectedRevision: number;
     singleton: string;
     status: string;
 }, Promise<import("@byline/core").ChangeStatusResult>>;

package/dist/server-fns/singletons/change-status.js

@@ -1,7 +1,10 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
 import { serialise } from "../serialise.js";
 const changeSingletonStatus = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).changeStatus(data.status)));
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).changeStatus(data.status, {
+        expectedRevision: data.expectedRevision
+    }))));
 export { changeSingletonStatus };

package/dist/server-fns/singletons/confirm-scheduled-publish.d.ts

@@ -1,14 +1,11 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const confirmSingletonScheduledPublish: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
     expectedVersionId: string;
 }) => {
+    expectedRevision: number;
     singleton: string;
     expectedVersionId: string;
-}, Promise<import("@byline/client").DocumentPublishScheduleInfo>>;
+}, Promise<import("@byline/client").DocumentPublishScheduleInfo & {
+    revision: number;
+}>>;

package/dist/server-fns/singletons/confirm-scheduled-publish.js

@@ -1,9 +1,11 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
 import { serialise } from "../serialise.js";
 const confirmSingletonScheduledPublish = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).confirmScheduledPublish({
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).confirmScheduledPublish({
+        expectedRevision: data.expectedRevision,
         expectedVersionId: data.expectedVersionId
-    })));
+    }))));
 export { confirmSingletonScheduledPublish };

package/dist/server-fns/singletons/copy-to-locale.d.ts

@@ -1,16 +1,11 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const copySingletonToLocale: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
     sourceLocale: string;
     targetLocale: string;
     overwrite?: boolean;
 }) => {
+    expectedRevision: number;
     singleton: string;
     sourceLocale: string;
     targetLocale: string;

package/dist/server-fns/singletons/copy-to-locale.js

@@ -1,11 +1,22 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
+import { toCommittedDocumentHookFailureResponse } from "../collections/save-outcome.js";
 import { serialise } from "../serialise.js";
 const copySingletonToLocale = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).copyToLocale({
-        sourceLocale: data.sourceLocale,
-        targetLocale: data.targetLocale,
-        overwrite: data.overwrite
-    })));
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>{
+    try {
+        return serialise(await getAdminBylineClient().singleton(data.singleton).copyToLocale({
+            expectedRevision: data.expectedRevision,
+            sourceLocale: data.sourceLocale,
+            targetLocale: data.targetLocale,
+            overwrite: data.overwrite
+        }));
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
+}));
 export { copySingletonToLocale };

package/dist/server-fns/singletons/get.d.ts

@@ -17,8 +17,8 @@ export interface GetSingletonInput {
  * - this shared host layer owns lenient reads, raw missing-locale values,
  *   relation-summary population, transport serialization, and preservation of
  *   restore warnings and locale metadata;
- * - the route loader composes published-version metadata plus scheduled-
- *   publication enablement, capability, and schedule aliases because those
- *   require host-only database and actor context beyond the singleton handle.
+ * - the route loader composes the informational published-version badge, feature
+ *   enablement, capability, and schedule aliases. Schedule state itself comes
+ *   from the same editable snapshot as the source document.
  */
-export declare const getSingleton: import("@tanstack/react-start").RequiredFetcher<undefined, (input: GetSingletonInput) => GetSingletonInput, Promise<import("@byline/client").SingletonDocument<Record<string, any>> | null>>;
+export declare const getSingleton: import("@tanstack/react-start").RequiredFetcher<undefined, (input: GetSingletonInput) => GetSingletonInput, Promise<Omit<import("@byline/client").EditableDocument<Record<string, any>>, "path"> | null>>;

package/dist/server-fns/singletons/restore-version.d.ts

@@ -1,14 +1,9 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const restoreSingletonVersion: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
     versionId: string;
 }) => {
+    expectedRevision: number;
     singleton: string;
     versionId: string;
 }, Promise<import("@byline/core").SingletonSaveResult>>;

package/dist/server-fns/singletons/restore-version.js

@@ -1,7 +1,19 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
+import { toCommittedDocumentHookFailureResponse } from "../collections/save-outcome.js";
 import { serialise } from "../serialise.js";
 const restoreSingletonVersion = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).restoreVersion(data.versionId)));
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>{
+    try {
+        return serialise(await getAdminBylineClient().singleton(data.singleton).restoreVersion(data.versionId, {
+            expectedRevision: data.expectedRevision
+        }));
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
+}));
 export { restoreSingletonVersion };

package/dist/server-fns/singletons/schedule-publish.d.ts

@@ -1,16 +1,13 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const scheduleSingletonPublish: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
     publishAt: string;
     expectedVersionId: string;
 }) => {
+    expectedRevision: number;
     singleton: string;
     publishAt: string;
     expectedVersionId: string;
-}, Promise<import("@byline/client").DocumentPublishScheduleInfo>>;
+}, Promise<import("@byline/client").DocumentPublishScheduleInfo & {
+    revision: number;
+}>>;

package/dist/server-fns/singletons/schedule-publish.js

@@ -1,10 +1,12 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
 import { serialise } from "../serialise.js";
 const scheduleSingletonPublish = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).schedulePublish({
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).schedulePublish({
         publishAt: data.publishAt,
+        expectedRevision: data.expectedRevision,
         expectedVersionId: data.expectedVersionId
-    })));
+    }))));
 export { scheduleSingletonPublish };

package/dist/server-fns/singletons/unpublish.d.ts

@@ -1,12 +1,7 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
 export declare const unpublishSingleton: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     singleton: string;
 }) => {
+    expectedRevision: number;
     singleton: string;
 }, Promise<import("@byline/core").UnpublishResult>>;

package/dist/server-fns/singletons/unpublish.js

@@ -1,7 +1,10 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
 import { serialise } from "../serialise.js";
 const unpublishSingleton = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).unpublish()));
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>serialise(await getAdminBylineClient().singleton(data.singleton).unpublish({
+        expectedRevision: data.expectedRevision
+    }))));
 export { unpublishSingleton };

package/dist/server-fns/singletons/update.d.ts

@@ -1,14 +1,7 @@
-/**
- * This Source Code is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at http://mozilla.org/MPL/2.0/.
- *
- * Copyright (c) Infonomic Company Limited
- */
-export interface UpdateSingletonInput {
+import type { SingletonSavePrecondition } from '@byline/core';
+export type UpdateSingletonInput = SingletonSavePrecondition & {
     singleton: string;
     data: Record<string, any>;
     locale?: string;
-    expectedVersionId?: string;
-}
-export declare const updateSingleton: import("@tanstack/react-start").RequiredFetcher<undefined, (input: UpdateSingletonInput) => UpdateSingletonInput, Promise<import("@byline/core").SingletonSaveResult>>;
+};
+export declare const updateSingleton: import("@tanstack/react-start").RequiredFetcher<undefined, (input: UpdateSingletonInput) => UpdateSingletonInput, Promise<import("@byline/core").UpdateSingletonResult>>;

package/dist/server-fns/singletons/update.js

@@ -1,14 +1,22 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient } from "@byline/client/server";
+import { toCommittedDocumentHookFailureResponse } from "../collections/save-outcome.js";
 import { serialise } from "../serialise.js";
 const updateSingleton = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data })=>{
-    const { singleton, data: fields, locale, expectedVersionId } = data;
-    const result = await getAdminBylineClient().singleton(singleton).update(fields, {
-        locale,
-        expectedVersionId
-    });
-    return serialise(result);
-});
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>{
+    const { singleton, data: fields, locale, ...precondition } = data;
+    try {
+        const result = await getAdminBylineClient().singleton(singleton).update(fields, {
+            locale,
+            ...precondition
+        });
+        return serialise(result);
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
+}));
 export { updateSingleton };

package/dist/server-fns/structural-receipt.d.ts

@@ -0,0 +1,4 @@
+import { type StructuralMutationReceipt } from '@byline/core';
+/** Copy only the authorized receipt fields emitted by the lifecycle service. */
+export declare function structuralReceipt(value: unknown): StructuralMutationReceipt | null;
+export declare function committedTreeReceipt(error: unknown): StructuralMutationReceipt | null;

package/dist/server-fns/structural-receipt.js

@@ -0,0 +1,31 @@
+import { ErrorCodes, isDocumentRevision } from "@byline/core";
+function structuralReceipt(value) {
+    if ('object' != typeof value || null === value) return null;
+    const documentId = Reflect.get(value, 'documentId');
+    const revision = Reflect.get(value, 'revision');
+    const suspended = Reflect.get(value, 'scheduledPublicationsNeedReconfirmation');
+    const affected = Reflect.get(value, 'affectedDocuments');
+    if ('string' != typeof documentId || !isDocumentRevision(revision) || 'boolean' != typeof suspended || !Array.isArray(affected)) return null;
+    const affectedDocuments = [];
+    for (const row of affected){
+        if ('object' != typeof row || null === row) return null;
+        const id = Reflect.get(row, 'documentId');
+        const token = Reflect.get(row, 'revision');
+        if ('string' != typeof id || !isDocumentRevision(token)) return null;
+        affectedDocuments.push({
+            documentId: id,
+            revision: token
+        });
+    }
+    return {
+        documentId,
+        revision,
+        affectedDocuments,
+        scheduledPublicationsNeedReconfirmation: suspended
+    };
+}
+function committedTreeReceipt(error) {
+    if ('object' != typeof error || null === error || Reflect.get(error, 'code') !== ErrorCodes.TREE_HOOK_COMMITTED) return null;
+    return structuralReceipt(Reflect.get(error, 'details'));
+}
+export { committedTreeReceipt, structuralReceipt };

package/package.json

@@ -3,7 +3,7 @@
   "private": false,
   "type": "module",
   "license": "MPL-2.0",
-  "version": "4.18.0",
+  "version": "5.0.0",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -125,15 +125,15 @@
     "react-json-view-lite": "^2.5.0",
     "react-swipeable": "^7.0.2",
     "zod": "^4.4.3",
-    "@byline/admin": "4.18.0",
-    "@byline/ai": "4.18.0",
-    "@byline/analytics-agent": "4.18.0",
-    "@byline/client": "4.18.0",
-    "@byline/auth": "4.18.0",
-    "@byline/analytics": "4.18.0",
-    "@byline/i18n": "4.18.0",
-    "@byline/core": "4.18.0",
-    "@byline/ui": "4.18.0"
+    "@byline/admin": "5.0.0",
+    "@byline/analytics": "5.0.0",
+    "@byline/ai": "5.0.0",
+    "@byline/analytics-agent": "5.0.0",
+    "@byline/core": "5.0.0",
+    "@byline/i18n": "5.0.0",
+    "@byline/ui": "5.0.0",
+    "@byline/client": "5.0.0",
+    "@byline/auth": "5.0.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.167.0",
@@ -174,7 +174,7 @@
     "build": "run-s build:*",
     "build:clean": "node scripts/clean.js dist build",
     "build:code": "rslib build",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.revision-tests.json",
     "clean": "node scripts/clean.js node_modules dist build types .turbo",
     "lint": "biome check --write --unsafe --diagnostic-level=error",
     "test": "vitest run --mode=jsdom && vitest run --mode=node",

package/src/admin-shell/collections/create.tsx

@@ -15,7 +15,10 @@ import { Container, Section, useToastManager } from '@byline/ui/react'
 
 import { getAdminRoutePath } from '../../routes/admin-path.js'
 import { decodeListReturnState } from '../../routes/list-return-state.js'
-import { createCollectionDocument } from '../../server-fns/collections/index.js'
+import {
+  createCollectionDocument,
+  hasCommittedDocumentHookFailure,
+} from '../../server-fns/collections/index.js'
 import { useNavigate } from '../chrome/loose-router.js'
 import { useTanStackNavigationGuard } from './tanstack-navigation-guard.js'
 
@@ -65,6 +68,14 @@ export const CreateView = ({
           ...(systemAvailableLocales ? { availableLocales: systemAvailableLocales } : {}),
         },
       })
+      const hookFailed = hasCommittedDocumentHookFailure(result)
+      if (hookFailed) {
+        toastManager.add({
+          title: t('collections.save.hookFailedToast'),
+          description: t('collections.save.hookFailedDescription'),
+          data: { intent: 'warning', iconType: 'warning', icon: true, close: true },
+        })
+      }
       // Create → edit: land the editor on the new document, where the rest
       // of the work (content, status, relations) happens. `from` threads
       // forward so closing the brand-new document also returns to the
@@ -75,13 +86,21 @@ export const CreateView = ({
         navigate({
           to: getAdminRoutePath('collections', '$collection', '$id'),
           params: { collection: path, id: result.documentId } as never,
-          search: { action: 'created', from },
+          search: { ...(hookFailed ? {} : { action: 'created' as const }), from },
+          // Persistence has succeeded, but FormRenderer cannot commit its
+          // clean baseline until this handler returns. Do not let that brief
+          // dirty-state overlap block the intentional create → edit redirect.
+          ignoreBlocker: true,
         })
       } else {
         navigate({
           to: getAdminRoutePath('collections', '$collection'),
           params: { collection: path },
-          search: { ...decodeListReturnState(from), action: 'created' },
+          search: {
+            ...decodeListReturnState(from),
+            ...(hookFailed ? {} : { action: 'created' as const }),
+          },
+          ignoreBlocker: true,
         })
       }
     } catch (err) {