@byline/host-tanstack-start 4.18.0 → 4.19.0

package/dist/admin-shell/collections/create.js

@@ -5,7 +5,7 @@ import { useTranslation } from "@byline/i18n/react";
 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";
 const CreateView = ({ collectionDefinition, adminConfig, initialData, from })=>{
@@ -31,6 +31,17 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData, from })=>{
                     } : {}
                 }
             });
+            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
+                }
+            });
             result?.documentId ? navigate({
                 to: getAdminRoutePath('collections', '$collection', '$id'),
                 params: {
@@ -38,9 +49,12 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData, from })=>{
                     id: result.documentId
                 },
                 search: {
-                    action: 'created',
+                    ...hookFailed ? {} : {
+                        action: 'created'
+                    },
                     from
-                }
+                },
+                ignoreBlocker: true
             }) : navigate({
                 to: getAdminRoutePath('collections', '$collection'),
                 params: {
@@ -48,8 +62,11 @@ const CreateView = ({ collectionDefinition, adminConfig, initialData, from })=>{
                 },
                 search: {
                     ...decodeListReturnState(from),
-                    action: 'created'
-                }
+                    ...hookFailed ? {} : {
+                        action: 'created'
+                    }
+                },
+                ignoreBlocker: true
             });
         } catch (err) {
             console.error(err);

package/dist/admin-shell/collections/edit.js

@@ -6,7 +6,7 @@ import { useTranslation } from "@byline/i18n/react";
 import { Container, Section, useToastManager } from "@byline/ui/react";
 import { getAdminRoutePath } from "../../routes/admin-path.js";
 import { clearListReturnState } from "../../routes/list-return-storage.js";
-import { cancelCollectionDocumentScheduledPublish, confirmCollectionDocumentScheduledPublish, copyDocumentToLocale, deleteDocument, deleteDocumentLocale, duplicateCollectionDocument, hasDeleteSideEffectFailures, scheduleCollectionDocumentPublish, unpublishDocument, updateCollectionDocumentSystemFields, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
+import { cancelCollectionDocumentScheduledPublish, confirmCollectionDocumentScheduledPublish, copyDocumentToLocale, deleteDocument, deleteDocumentLocale, duplicateCollectionDocument, hasCommittedDocumentHookFailure, hasDeleteSideEffectFailures, scheduleCollectionDocumentPublish, unpublishDocument, updateCollectionDocumentSystemFields, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
 import { useTanStackNavigationGuard } from "./tanstack-navigation-guard.js";
 import { ViewMenu } from "./view-menu.js";
@@ -43,6 +43,23 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             }
         });
     };
+    const notifyCommittedHookFailure = ()=>{
+        const description = t("collections.save.hookFailedDescription");
+        toastManager.add({
+            title: t('collections.save.hookFailedToast'),
+            description,
+            data: {
+                intent: 'warning',
+                iconType: 'warning',
+                icon: true,
+                close: true
+            }
+        });
+        setEditState({
+            status: 'warning',
+            message: description
+        });
+    };
     const handleLocaleChange = (newLocale)=>{
         navigate({
             to: getAdminRoutePath('collections', '$collection', '$id'),
@@ -300,6 +317,20 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     id: String(initialData.id)
                 }
             });
+            if (hasCommittedDocumentHookFailure(result)) {
+                notifyCommittedHookFailure();
+                navigate({
+                    to: getAdminRoutePath('collections', '$collection', '$id'),
+                    params: {
+                        collection: path,
+                        id: result.documentId
+                    },
+                    search: (prev)=>({
+                            ...prev
+                        })
+                });
+                return;
+            }
             const description = result.pathRetried ? t("collections.edit.duplicatedAutoPathDescription", {
                 path: result.newPath
             }) : t("collections.edit.duplicatedPathDescription", {
@@ -367,6 +398,22 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     overwrite
                 }
             });
+            if (hasCommittedDocumentHookFailure(result)) {
+                notifyCommittedHookFailure();
+                notifyScheduleSuspended();
+                navigate({
+                    to: getAdminRoutePath('collections', '$collection', '$id'),
+                    params: {
+                        collection: path,
+                        id: String(initialData.id)
+                    },
+                    search: (prev)=>({
+                            ...prev,
+                            locale: targetLocale
+                        })
+                });
+                return;
+            }
             const sourceLabel = contentLocales.find((l)=>l.code === result.sourceLocale)?.label ?? result.sourceLocale;
             const targetLabel = contentLocales.find((l)=>l.code === result.targetLocale)?.label ?? result.targetLocale;
             const description = result.fieldsUpdated > 0 ? t("collections.edit.copiedFieldsDescription", {
@@ -440,6 +487,22 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     locale: targetLocale
                 }
             });
+            if (hasCommittedDocumentHookFailure(result)) {
+                notifyCommittedHookFailure();
+                notifyScheduleSuspended();
+                navigate({
+                    to: getAdminRoutePath('collections', '$collection', '$id'),
+                    params: {
+                        collection: path,
+                        id: String(initialData.id)
+                    },
+                    search: (prev)=>({
+                            ...prev,
+                            locale: defaultContentLocale
+                        })
+                });
+                return;
+            }
             const targetLabel = contentLocales.find((l)=>l.code === result.locale)?.label ?? result.locale;
             const description = t("collections.edit.deletedLocaleDescription", {
                 label: singular,
@@ -523,7 +586,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 }
             });
             setEditState({
-                status: 'success',
+                status: hasSideEffectFailures ? 'warning' : 'success',
                 message: description
             });
             clearListReturnState(path, String(initialData.id));
@@ -559,6 +622,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleSubmit = async ({ data: _data, patches, contentDirty, pathDirty, systemPath, availableLocalesDirty, systemAvailableLocales })=>{
         try {
+            let hookFailed = false;
             if (pathDirty || availableLocalesDirty) await updateCollectionDocumentSystemFields({
                 data: {
                     collection: path,
@@ -572,33 +636,36 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     } : {}
                 }
             });
-            if (contentDirty) await updateCollectionDocumentWithPatches({
-                data: {
-                    collection: path,
-                    id: String(initialData.id),
-                    patches,
-                    versionId: initialData.versionId,
-                    locale
-                }
-            });
+            if (contentDirty) {
+                const result = await updateCollectionDocumentWithPatches({
+                    data: {
+                        collection: path,
+                        id: String(initialData.id),
+                        patches,
+                        versionId: initialData.versionId,
+                        locale
+                    }
+                });
+                hookFailed = hasCommittedDocumentHookFailure(result);
+            }
             if (contentDirty && scheduledPublication?.state === 'armed') notifyScheduleSuspended();
-            const description = t("collections.edit.updatedDescription", {
+            const description = hookFailed ? t("collections.save.hookFailedDescription") : t("collections.edit.updatedDescription", {
                 label: singularLower
             });
             toastManager.add({
-                title: t('collections.edit.updateTitle', {
+                title: hookFailed ? t('collections.save.hookFailedToast') : t('collections.edit.updateTitle', {
                     label: singular
                 }),
                 description,
                 data: {
-                    intent: 'success',
-                    iconType: 'success',
+                    intent: hookFailed ? 'warning' : 'success',
+                    iconType: hookFailed ? 'warning' : 'success',
                     icon: true,
                     close: true
                 }
             });
             setEditState({
-                status: 'success',
+                status: hookFailed ? 'warning' : 'success',
                 message: description
             });
             navigate({
@@ -609,7 +676,8 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 },
                 search: (prev)=>({
                         ...prev
-                    })
+                    }),
+                ignoreBlocker: true
             });
         } catch (err) {
             console.error('Network error:', err);

package/dist/admin-shell/collections/restore-version-modal.js

@@ -2,11 +2,13 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { useTranslation } from "@byline/i18n/react";
-import { Alert, Button, LoaderEllipsis, Modal } from "@byline/ui/react";
+import { Alert, Button, LoaderEllipsis, Modal, useToastManager } from "@byline/ui/react";
 import clsx from "clsx";
+import { hasCommittedDocumentHookFailure } from "../../server-fns/collections/save-outcome.js";
 import restore_version_modal_module from "./restore-version-modal.module.js";
 function RestoreVersionModal({ versionLabel, versionNumber, restoreStatusLabel, onClose, restoreVersion, onRestoreComplete }) {
     const { t } = useTranslation('byline-admin');
+    const toastManager = useToastManager();
     const [error, setError] = useState(null);
     const [pending, setPending] = useState(false);
     async function handleRestore() {
@@ -14,7 +16,17 @@ function RestoreVersionModal({ versionLabel, versionNumber, restoreStatusLabel,
         setPending(true);
         setError(null);
         try {
-            await restoreVersion();
+            const result = await restoreVersion();
+            if (hasCommittedDocumentHookFailure(result)) toastManager.add({
+                title: t('collections.save.hookFailedToast'),
+                description: t("collections.save.hookFailedDescription"),
+                data: {
+                    intent: 'warning',
+                    iconType: 'warning',
+                    icon: true,
+                    close: true
+                }
+            });
             onClose();
             await onRestoreComplete();
         } catch (err) {

package/dist/admin-shell/collections/save-navigation.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 {};

package/dist/admin-shell/singletons/view.js

@@ -6,6 +6,7 @@ import { ErrorCodes, getDefaultStatus, getWorkflow, getWorkflowStatuses, validat
 import { useTranslation } from "@byline/i18n/react";
 import { Container, Section, useToastManager } from "@byline/ui/react";
 import { getAdminRoutePath } from "../../routes/admin-path.js";
+import { hasCommittedDocumentHookFailure } from "../../server-fns/collections/index.js";
 import { cancelSingletonScheduledPublish, changeSingletonStatus, confirmSingletonScheduledPublish, copySingletonToLocale, scheduleSingletonPublish, unpublishSingleton, updateSingleton } from "../../server-fns/singletons/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
 import { useTanStackNavigationGuard } from "../collections/tanstack-navigation-guard.js";
@@ -49,9 +50,12 @@ function SingletonView({ singletonDefinition, adminConfig, document, initialData
         if (scheduledPublication?.state !== 'armed') return;
         toast(t('scheduledPublication.toast.suspendedTitle'), t("scheduledPublication.toast.suspendedDescription"), 'warning');
     };
+    const notifyCommittedHookFailure = ()=>{
+        toast(t('collections.save.hookFailedToast'), t("collections.save.hookFailedDescription"), 'warning');
+    };
     const handleSubmit = async ({ data })=>{
         try {
-            await updateSingleton({
+            const result = await updateSingleton({
                 data: {
                     singleton: path,
                     data,
@@ -60,7 +64,8 @@ function SingletonView({ singletonDefinition, adminConfig, document, initialData
                 }
             });
             if (null != document) notifyScheduleSuspended();
-            toast(t('singletons.edit.updateTitle', {
+            if (hasCommittedDocumentHookFailure(result)) notifyCommittedHookFailure();
+            else toast(t('singletons.edit.updateTitle', {
                 label
             }), t("singletons.edit.updatedDescription", {
                 label: label.toLowerCase()
@@ -122,7 +127,7 @@ function SingletonView({ singletonDefinition, adminConfig, document, initialData
     };
     const handleCopyToLocale = async ({ targetLocale, overwrite })=>{
         try {
-            await copySingletonToLocale({
+            const result = await copySingletonToLocale({
                 data: {
                     singleton: path,
                     sourceLocale: locale ?? defaultContentLocale,
@@ -133,7 +138,8 @@ function SingletonView({ singletonDefinition, adminConfig, document, initialData
             const sourceLocale = locale ?? defaultContentLocale;
             const sourceLabel = contentLocales.find((entry)=>entry.code === sourceLocale)?.label ?? sourceLocale;
             const targetLabel = contentLocales.find((entry)=>entry.code === targetLocale)?.label ?? targetLocale;
-            toast(t('collections.edit.copyToLocaleTitle', {
+            if (hasCommittedDocumentHookFailure(result)) notifyCommittedHookFailure();
+            else toast(t('collections.edit.copyToLocaleTitle', {
                 label
             }), t('collections.edit.copiedSuccessMessage', {
                 source: sourceLabel,

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

@@ -6,6 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 import type { CopyToLocaleResult } from '@byline/core/services';
+import { type CollectionDocumentCommittedHookFailureResponse } from './save-outcome.js';
 /**
  * Copy a document's content from `sourceLocale` into `targetLocale` on
  * the same document. Mirrors the thin-wrapper pattern of the other
@@ -27,4 +28,4 @@ export declare const copyDocumentToLocale: import("@tanstack/react-start").Requi
     sourceLocale: string;
     targetLocale: string;
     overwrite: boolean;
-}, Promise<CopyToLocaleResult>>;
+}, Promise<CollectionDocumentCommittedHookFailureResponse | CopyToLocaleResult>>;

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

@@ -3,6 +3,7 @@ import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { copyToLocale } from "@byline/core/services";
 import { ensureCollection } from "../../integrations/api-utils.js";
+import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const copyDocumentToLocale = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data: input })=>{
@@ -27,11 +28,17 @@ const copyDocumentToLocale = createServerFn({
         slugifier: serverConfig.slugifier,
         requestContext: await getAdminRequestContext()
     };
-    return copyToLocale(ctx, {
-        documentId: id,
-        sourceLocale,
-        targetLocale,
-        overwrite
-    });
+    try {
+        return await copyToLocale(ctx, {
+            documentId: id,
+            sourceLocale,
+            targetLocale,
+            overwrite
+        });
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
 });
 export { copyDocumentToLocale };

package/dist/server-fns/collections/create.d.ts

@@ -17,7 +17,7 @@ export declare const createCollectionDocument: import("@tanstack/react-start").R
     locale?: string;
     path?: string;
     availableLocales?: string[];
-}, Promise<{
+}, Promise<import("./save-outcome.js").CollectionDocumentCommittedHookFailureResponse | {
     status: 'ok';
     documentId: string;
     documentVersionId: string;

package/dist/server-fns/collections/create.js

@@ -3,6 +3,7 @@ import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { createDocument } from "@byline/core/services";
 import { ensureCollection } from "../../integrations/api-utils.js";
+import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const createCollectionDocument = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data: input })=>{
@@ -27,13 +28,20 @@ const createCollectionDocument = createServerFn({
         slugifier: serverConfig.slugifier,
         requestContext: await getAdminRequestContext()
     };
-    const result = await createDocument(ctx, {
-        data: structuredClone(documentData),
-        status: documentData.status,
-        locale: locale ?? serverConfig.i18n.content.defaultLocale,
-        path: explicitPath,
-        availableLocales
-    });
+    let result;
+    try {
+        result = await createDocument(ctx, {
+            data: structuredClone(documentData),
+            status: documentData.status,
+            locale: locale ?? serverConfig.i18n.content.defaultLocale,
+            path: explicitPath,
+            availableLocales
+        });
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
     return {
         status: 'ok',
         documentId: result.documentId,

package/dist/server-fns/collections/delete-locale.d.ts

@@ -6,6 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 import type { DeleteLocaleResult } from '@byline/core/services';
+import { type CollectionDocumentCommittedHookFailureResponse } from './save-outcome.js';
 /**
  * Remove a single (non-default) content locale from a document, leaving every
  * other locale untouched. Mirrors the thin-wrapper pattern of the other
@@ -24,4 +25,4 @@ export declare const deleteDocumentLocale: import("@tanstack/react-start").Requi
     collection: string;
     id: string;
     locale: string;
-}, Promise<DeleteLocaleResult>>;
+}, Promise<CollectionDocumentCommittedHookFailureResponse | DeleteLocaleResult>>;

package/dist/server-fns/collections/delete-locale.js

@@ -3,6 +3,7 @@ import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { deleteLocale } from "@byline/core/services";
 import { ensureCollection } from "../../integrations/api-utils.js";
+import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const deleteDocumentLocale = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data: input })=>{
@@ -27,9 +28,15 @@ const deleteDocumentLocale = createServerFn({
         slugifier: serverConfig.slugifier,
         requestContext: await getAdminRequestContext()
     };
-    return deleteLocale(ctx, {
-        documentId: id,
-        locale
-    });
+    try {
+        return await deleteLocale(ctx, {
+            documentId: id,
+            locale
+        });
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
 });
 export { deleteDocumentLocale };

package/dist/server-fns/collections/duplicate.d.ts

@@ -6,6 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 import type { DuplicateDocumentResult } from '@byline/core/services';
+import { type CollectionDocumentCommittedHookFailureResponse } from './save-outcome.js';
 /**
  * Duplicate an existing document — clones all locales into a brand-new
  * document in one atomic write. Returns the new document's id so the UI
@@ -23,4 +24,4 @@ export declare const duplicateCollectionDocument: import("@tanstack/react-start"
 }) => {
     collection: string;
     id: string;
-}, Promise<DuplicateDocumentResult>>;
+}, Promise<CollectionDocumentCommittedHookFailureResponse | DuplicateDocumentResult>>;

package/dist/server-fns/collections/duplicate.js

@@ -3,6 +3,7 @@ import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { duplicateDocument } from "@byline/core/services";
 import { ensureCollection } from "../../integrations/api-utils.js";
+import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const duplicateCollectionDocument = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data: input })=>{
@@ -27,8 +28,14 @@ const duplicateCollectionDocument = createServerFn({
         slugifier: serverConfig.slugifier,
         requestContext: await getAdminRequestContext()
     };
-    return duplicateDocument(ctx, {
-        sourceDocumentId
-    });
+    try {
+        return await duplicateDocument(ctx, {
+            sourceDocumentId
+        });
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
 });
 export { duplicateCollectionDocument };

package/dist/server-fns/collections/index.d.ts

@@ -17,6 +17,7 @@ export * from './list';
 export * from './reindex';
 export * from './reorder';
 export * from './restore-version';
+export * from './save-outcome';
 export * from './scheduled-publication';
 export * from './set-list-view-preference';
 export * from './stats';

package/dist/server-fns/collections/index.js

@@ -11,6 +11,7 @@ export * from "./list.js";
 export * from "./reindex.js";
 export * from "./reorder.js";
 export * from "./restore-version.js";
+export * from "./save-outcome.js";
 export * from "./scheduled-publication.js";
 export * from "./set-list-view-preference.js";
 export * from "./stats.js";

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

@@ -13,7 +13,7 @@ export declare const restoreDocumentVersion: import("@tanstack/react-start").Req
     collection: string;
     id: string;
     versionId: string;
-}, Promise<{
+}, Promise<import("./save-outcome.js").CollectionDocumentCommittedHookFailureResponse | {
     status: 'ok';
     documentId: string;
     documentVersionId: string;

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

@@ -3,6 +3,7 @@ import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { restoreDocumentVersion } from "@byline/core/services";
 import { ensureCollection } from "../../integrations/api-utils.js";
+import { toCommittedDocumentHookFailureResponse } from "./save-outcome.js";
 const restore_version_restoreDocumentVersion = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data: input })=>{
@@ -27,15 +28,21 @@ const restore_version_restoreDocumentVersion = createServerFn({
         slugifier: serverConfig.slugifier,
         requestContext: await getAdminRequestContext()
     };
-    const result = await restoreDocumentVersion(ctx, {
-        documentId: id,
-        sourceVersionId: versionId
-    });
-    return {
-        status: 'ok',
-        documentId: result.documentId,
-        documentVersionId: result.documentVersionId,
-        sourceVersionId: result.sourceVersionId
-    };
+    try {
+        const result = await restoreDocumentVersion(ctx, {
+            documentId: id,
+            sourceVersionId: versionId
+        });
+        return {
+            status: 'ok',
+            documentId: result.documentId,
+            documentVersionId: result.documentVersionId,
+            sourceVersionId: result.sourceVersionId
+        };
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
 });
 export { restore_version_restoreDocumentVersion as restoreDocumentVersion };

package/dist/server-fns/collections/save-outcome.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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
+ */
+import { type DocumentHookCommittedPhase, type DocumentHookSideEffectCode } from '@byline/core/services';
+export interface CollectionDocumentCommittedHookFailureResponse {
+    status: 'committed-hook-failed';
+    documentId: string;
+    documentVersionId: string;
+    sideEffectFailure: {
+        phase: DocumentHookCommittedPhase;
+        code: DocumentHookSideEffectCode;
+    };
+}
+/**
+ * Convert only validated core committed-hook errors into safe wire data. Raw
+ * hook errors, messages, stack traces, and storage paths remain server-side.
+ */
+export declare function toCommittedDocumentHookFailureResponse(error: unknown): CollectionDocumentCommittedHookFailureResponse | null;
+export declare function hasCommittedDocumentHookFailure(result: unknown): result is CollectionDocumentCommittedHookFailureResponse;

package/dist/server-fns/collections/save-outcome.js

@@ -0,0 +1,18 @@
+import { getDocumentHookCommittedDetails } from "@byline/core/services";
+function toCommittedDocumentHookFailureResponse(error) {
+    const details = getDocumentHookCommittedDetails(error);
+    if (null == details) return null;
+    return {
+        status: 'committed-hook-failed',
+        documentId: details.documentId,
+        documentVersionId: details.documentVersionId,
+        sideEffectFailure: {
+            phase: details.phase,
+            code: details.sideEffectCode
+        }
+    };
+}
+function hasCommittedDocumentHookFailure(result) {
+    return 'object' == typeof result && null != result && 'status' in result && 'committed-hook-failed' === result.status;
+}
+export { hasCommittedDocumentHookFailure, toCommittedDocumentHookFailureResponse };

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

@@ -18,8 +18,10 @@ export declare const updateCollectionDocumentWithPatches: import("@tanstack/reac
     patches: DocumentPatch[];
     versionId?: string;
     locale?: string;
-}, Promise<{
+}, Promise<import("./save-outcome.js").CollectionDocumentCommittedHookFailureResponse | {
     status: 'ok';
+    documentId: string;
+    documentVersionId: string;
 }>>;
 export declare const updateCollectionDocumentSystemFields: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
     collection: string;