@byline/host-tanstack-start 4.18.0 → 5.0.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.d.ts

@@ -8,7 +8,7 @@
 import type { CollectionAdminConfig, MultiCollectionDefinition } from '@byline/core';
 import type { AnyCollectionSchemaTypes } from '@byline/core/zod-schemas';
 import type { ContentLocaleOption } from './view-menu.js';
-export declare const EditView: ({ collectionDefinition, adminConfig, initialData, locale, contentLocales, defaultContentLocale, returnSearch, }: {
+export declare const EditView: ({ collectionDefinition, adminConfig, initialData: loadedData, locale, contentLocales, defaultContentLocale, returnSearch, }: {
     collectionDefinition: MultiCollectionDefinition;
     adminConfig?: CollectionAdminConfig;
     initialData: AnyCollectionSchemaTypes['UpdateType'];

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

@@ -1,4 +1,4 @@
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { FormRenderer } from "@byline/admin/react";
 import { getDefaultStatus, getWorkflow, getWorkflowStatuses, validateStatusTransition } from "@byline/core";
@@ -6,11 +6,14 @@ 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, updateCollectionDocumentWithPatches, updateDocumentStatus } from "../../server-fns/collections/index.js";
 import { useNavigate } from "../chrome/loose-router.js";
+import { useDocumentMutationState } from "../document-mutation-state.js";
 import { useTanStackNavigationGuard } from "./tanstack-navigation-guard.js";
 import { ViewMenu } from "./view-menu.js";
-const EditView = ({ collectionDefinition, adminConfig, initialData, locale, contentLocales, defaultContentLocale, returnSearch })=>{
+const EditView = ({ collectionDefinition, adminConfig, initialData: loadedData, locale, contentLocales, defaultContentLocale, returnSearch })=>{
+    const mutation = useDocumentMutationState(loadedData);
+    const initialData = mutation.document ?? loadedData;
     const toastManager = useToastManager();
     const { t } = useTranslation('byline-admin');
     const [_editState, setEditState] = useState({
@@ -43,6 +46,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'),
@@ -58,13 +78,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleStatusChange = async (status)=>{
         try {
-            await updateDocumentStatus({
+            mutation.assertWritable();
+            const result = await updateDocumentStatus({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id),
                     status
                 }
             });
+            mutation.adopt(result);
             const description = t("collections.edit.statusChangedDescription", {
                 status
             });
@@ -95,9 +118,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     })
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Status change error:', err);
             const description = t("collections.edit.statusChangeFailedDescription", {
-                message: err.message
+                message: t('documentConcurrency.failed')
             });
             toastManager.add({
                 title: t('collections.edit.statusUpdateTitle', {
@@ -131,14 +161,17 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleSchedulePublication = async ({ publishAt })=>{
         try {
-            await scheduleCollectionDocumentPublish({
+            mutation.assertWritable();
+            const result = await scheduleCollectionDocumentPublish({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id),
                     publishAt,
                     expectedVersionId: String(initialData.versionId)
                 }
             });
+            mutation.adopt(result);
             toastManager.add({
                 title: t('scheduledPublication.toast.scheduledTitle'),
                 description: t("scheduledPublication.toast.scheduledDescription"),
@@ -151,9 +184,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             reloadDocument();
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             toastManager.add({
                 title: t('scheduledPublication.toast.failedTitle'),
-                description: err.message,
+                description: t('documentConcurrency.failed'),
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -166,13 +206,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleConfirmScheduledPublication = async ()=>{
         try {
-            await confirmCollectionDocumentScheduledPublish({
+            mutation.assertWritable();
+            const result = await confirmCollectionDocumentScheduledPublish({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id),
                     expectedVersionId: String(initialData.versionId)
                 }
             });
+            mutation.adopt(result);
             toastManager.add({
                 title: t('scheduledPublication.toast.confirmedTitle'),
                 description: t("scheduledPublication.toast.confirmedDescription"),
@@ -185,9 +228,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             reloadDocument();
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             toastManager.add({
                 title: t('scheduledPublication.toast.failedTitle'),
-                description: err.message,
+                description: t('documentConcurrency.failed'),
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -200,12 +250,18 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleCancelScheduledPublication = async ()=>{
         try {
+            mutation.assertWritable();
             const result = await cancelCollectionDocumentScheduledPublish({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id)
                 }
             });
+            mutation.adopt({
+                ...result,
+                documentId: String(initialData.id)
+            });
             const cancelled = 'cancelled' === result.status;
             toastManager.add({
                 title: cancelled ? t('scheduledPublication.toast.cancelledTitle') : t('scheduledPublication.toast.cancelLostTitle'),
@@ -219,9 +275,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
             });
             reloadDocument();
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             toastManager.add({
                 title: t('scheduledPublication.toast.failedTitle'),
-                description: err.message,
+                description: t('documentConcurrency.failed'),
                 data: {
                     intent: 'danger',
                     iconType: 'danger',
@@ -236,12 +299,15 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     const restoreWarnings = initialData?._restoreWarnings;
     const handleUnpublish = async ()=>{
         try {
-            await unpublishDocument({
+            mutation.assertWritable();
+            const result = await unpublishDocument({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id)
                 }
             });
+            mutation.adopt(result);
             const description = t("collections.edit.unpublishedDescription");
             toastManager.add({
                 title: t('collections.edit.unpublishTitle', {
@@ -270,9 +336,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     })
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Unpublish error:', err);
             const description = t("collections.edit.unpublishFailedDescription", {
-                message: err.message
+                message: t('documentConcurrency.failed')
             });
             toastManager.add({
                 title: t('collections.edit.unpublishTitle', {
@@ -294,12 +367,28 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleDuplicate = async ()=>{
         try {
+            mutation.assertWritable();
             const result = await duplicateCollectionDocument({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     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", {
@@ -334,9 +423,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     })
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Duplicate error:', err);
             const description = t("collections.edit.duplicateFailedDescription", {
-                message: err.message
+                message: t('documentConcurrency.failed')
             });
             toastManager.add({
                 title: t('collections.edit.duplicateTitle', {
@@ -358,8 +454,10 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleCopyToLocale = async ({ targetLocale, overwrite })=>{
         try {
+            mutation.assertWritable();
             const result = await copyDocumentToLocale({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id),
                     sourceLocale: locale ?? defaultContentLocale,
@@ -367,6 +465,23 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     overwrite
                 }
             });
+            mutation.adopt(result);
+            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", {
@@ -409,9 +524,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     })
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Copy to locale error:', err);
             const description = t("collections.edit.copyFailedDescription", {
-                message: err.message
+                message: t('documentConcurrency.failed')
             });
             toastManager.add({
                 title: t('collections.edit.copyToLocaleTitle', {
@@ -433,13 +555,32 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleDeleteLocale = async ({ targetLocale })=>{
         try {
+            mutation.assertWritable();
             const result = await deleteDocumentLocale({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id),
                     locale: targetLocale
                 }
             });
+            mutation.adopt(result);
+            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,
@@ -474,9 +615,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                     })
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Delete locale error:', err);
             const description = t("collections.edit.deleteLocaleFailedDescription", {
-                message: err.message
+                message: t('documentConcurrency.failed')
             });
             toastManager.add({
                 title: t('collections.edit.deleteLocaleTitle', {
@@ -498,12 +646,34 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleDelete = async ()=>{
         try {
+            mutation.assertWritable();
             const result = await deleteDocument({
                 data: {
+                    expectedRevision: mutation.expectedRevision(),
                     collection: path,
                     id: String(initialData.id)
                 }
             });
+            if (result.scheduledPublicationsNeedReconfirmation) toastManager.add({
+                title: t('documentConcurrency.schedulesTitle'),
+                description: /*#__PURE__*/ jsxs(Fragment, {
+                    children: [
+                        /*#__PURE__*/ jsx("p", {
+                            children: t('documentConcurrency.schedules')
+                        }),
+                        /*#__PURE__*/ jsx("a", {
+                            href: getAdminRoutePath('scheduled-publications'),
+                            children: t('documentConcurrency.reviewSchedules')
+                        })
+                    ]
+                }),
+                data: {
+                    intent: 'warning',
+                    iconType: 'warning',
+                    icon: true,
+                    close: true
+                }
+            });
             const hasSideEffectFailures = hasDeleteSideEffectFailures(result);
             const description = hasSideEffectFailures ? t("collections.edit.deletedWithWarningsDescription", {
                 label: singular
@@ -523,7 +693,7 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 }
             });
             setEditState({
-                status: 'success',
+                status: hasSideEffectFailures ? 'warning' : 'success',
                 message: description
             });
             clearListReturnState(path, String(initialData.id));
@@ -535,9 +705,16 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 search: returnSearch
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Delete error:', err);
             const description = t("collections.edit.deleteFailedDescription", {
-                message: err.message
+                message: t('documentConcurrency.failed')
             });
             toastManager.add({
                 title: t('collections.edit.deleteTitle', {
@@ -559,10 +736,13 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     };
     const handleSubmit = async ({ data: _data, patches, contentDirty, pathDirty, systemPath, availableLocalesDirty, systemAvailableLocales })=>{
         try {
-            if (pathDirty || availableLocalesDirty) await updateCollectionDocumentSystemFields({
+            mutation.assertWritable();
+            const result = await updateCollectionDocumentWithPatches({
                 data: {
                     collection: path,
                     id: String(initialData.id),
+                    expectedRevision: mutation.expectedRevision(),
+                    patches: contentDirty ? patches : [],
                     locale,
                     ...pathDirty ? {
                         path: systemPath ?? null
@@ -572,33 +752,26 @@ 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 && scheduledPublication?.state === 'armed') notifyScheduleSuspended();
-            const description = t("collections.edit.updatedDescription", {
+            mutation.adopt(result);
+            const hookFailed = hasCommittedDocumentHookFailure(result);
+            if ((contentDirty || pathDirty || availableLocalesDirty) && scheduledPublication?.state === 'armed') notifyScheduleSuspended();
+            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,9 +782,17 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
                 },
                 search: (prev)=>({
                         ...prev
-                    })
+                    }),
+                ignoreBlocker: true
             });
         } catch (err) {
+            const handled = mutation.report(err);
+            if ('blocked' === handled) throw err;
+            if ('committed' === handled) {
+                notifyCommittedHookFailure();
+                reloadDocument();
+                return;
+            }
             console.error('Network error:', err);
             const description = t("collections.edit.updateFailedDescription", {
                 label: singularLower
@@ -638,6 +819,13 @@ const EditView = ({ collectionDefinition, adminConfig, initialData, locale, cont
     return /*#__PURE__*/ jsx(Section, {
         children: /*#__PURE__*/ jsx(Container, {
             children: /*#__PURE__*/ jsx(FormRenderer, {
+                mutationIssue: mutation.issue,
+                mutationsBlocked: mutation.blocked,
+                observedRevision: mutation.revision,
+                onMutationError: mutation.report,
+                onTreeMutationCommitted: mutation.adopt,
+                scheduledPublicationsNeedReconfirmation: mutation.scheduleNotice,
+                scheduledPublicationsHref: getAdminRoutePath('scheduled-publications'),
                 mode: "edit",
                 fields: fields,
                 onSubmit: handleSubmit,

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

@@ -91,7 +91,7 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, auditLog, workfl
             ];
         }),
         auditColSpan: columns.length + (hasRestoreColumn ? 1 : 0),
-        renderCells: ({ document, versionId, versionNumber, currentVersionId, restoreStatusLabel, openCompare, openRestore })=>columns.flatMap((column)=>{
+        renderCells: ({ document, versionId, versionNumber, currentVersionId, restoreStatusLabel, openCompare, mutationsBlocked, openRestore })=>columns.flatMap((column)=>{
                 const value = getColumnValue(document, String(column.fieldName));
                 const dataCell = /*#__PURE__*/ jsx(Table.Cell, {
                     className: clsx({
@@ -126,6 +126,7 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, auditLog, workfl
                             variant: "outlined",
                             size: "xs",
                             intent: "noeffect",
+                            disabled: mutationsBlocked,
                             onClick: openRestore,
                             className: clsx('byline-coll-history-restore-button', history_module.restoreButton),
                             title: t('collections.history.restoreButtonTitle', {
@@ -209,8 +210,9 @@ const HistoryView = ({ collectionDefinition, adminConfig, data, auditLog, workfl
                         rowPresentation: rowPresentation,
                         loadHistoricalVersion: getCollectionDocumentVersion,
                         onPageSizeChange: handlePageSizeChange,
-                        restoreVersion: (versionId)=>restoreDocumentVersion({
+                        restoreVersion: (versionId, expectedRevision)=>restoreDocumentVersion({
                                 data: {
+                                    expectedRevision,
                                     collection,
                                     id,
                                     versionId