@byline/host-tanstack-start 4.18.0 → 5.0.0

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

@@ -5,26 +5,30 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import type { DeleteDocumentResult, DeleteDocumentSideEffectCode, DeleteDocumentSideEffectPhase } from '@byline/core';
+import type { DeleteDocumentResult, DeleteDocumentSideEffectCode, DeleteDocumentSideEffectPhase, StructuralMutationReceipt } from '@byline/core';
 export type DeleteDocumentPublicSideEffectPhase = DeleteDocumentSideEffectPhase | 'unknown';
 export type DeleteDocumentPublicSideEffectCode = DeleteDocumentSideEffectCode;
 export interface DeleteDocumentPublicSideEffectFailure {
     phase: DeleteDocumentPublicSideEffectPhase;
     code: DeleteDocumentPublicSideEffectCode;
 }
-export type DeleteDocumentResponse = {
+export type DeleteDocumentResponse = StructuralMutationReceipt & ({
     status: 'ok';
+    documentId: string;
+    revision: number;
     deletedVersionCount: number;
     outcome: 'committed';
     sideEffectFailures: [];
 } | {
     status: 'ok';
+    documentId: string;
+    revision: number;
     deletedVersionCount: number;
     outcome: 'committed-with-side-effect-failures';
     sideEffectFailures: [
         DeleteDocumentPublicSideEffectFailure,
         ...DeleteDocumentPublicSideEffectFailure[]
     ];
-};
+});
 export declare function toDeleteDocumentResponse(result: DeleteDocumentResult): DeleteDocumentResponse;
 export declare function hasDeleteSideEffectFailures(result: Pick<DeleteDocumentResult, 'outcome'>): boolean;

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

@@ -20,6 +20,10 @@ function toDeleteDocumentResponse(result) {
     const [firstFailure, ...remainingFailures] = result.sideEffectFailures;
     return {
         status: 'ok',
+        documentId: result.documentId,
+        revision: result.revision,
+        affectedDocuments: result.affectedDocuments,
+        scheduledPublicationsNeedReconfirmation: result.scheduledPublicationsNeedReconfirmation,
         deletedVersionCount: result.deletedVersionCount,
         outcome: result.outcome,
         sideEffectFailures: [

package/dist/server-fns/collections/delete.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 deleteDocument: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     id: string;
 }) => {
+    expectedRevision: number;
     collection: string;
     id: string;
 }, Promise<import("./delete-outcome.js").DeleteDocumentResponse>>;

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

@@ -1,3 +1,4 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig, getUploadFields } from "@byline/core";
@@ -6,7 +7,7 @@ import { ensureCollection } from "../../integrations/api-utils.js";
 import { toDeleteDocumentResponse } from "./delete-outcome.js";
 const delete_deleteDocument = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data: input })=>{
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, id } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
@@ -35,8 +36,9 @@ const delete_deleteDocument = createServerFn({
         requestContext: await getAdminRequestContext()
     };
     const result = await deleteDocument(ctx, {
-        documentId: id
+        documentId: id,
+        expectedRevision: input.expectedRevision
     });
     return toDeleteDocumentResponse(result);
-});
+}));
 export { delete_deleteDocument as deleteDocument };

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

@@ -1,11 +1,5 @@
-/**
- * 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 { 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
@@ -18,9 +12,11 @@ import type { DuplicateDocumentResult } from '@byline/core/services';
  * TanStack Start's transport layer for the client to branch on.
  */
 export declare const duplicateCollectionDocument: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     id: string;
 }) => {
+    expectedRevision: number;
     collection: string;
     id: string;
-}, Promise<DuplicateDocumentResult>>;
+}, Promise<CollectionDocumentCommittedHookFailureResponse | DuplicateDocumentResult>>;

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

@@ -1,11 +1,13 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 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 })=>{
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, id: sourceDocumentId } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
@@ -27,8 +29,15 @@ const duplicateCollectionDocument = createServerFn({
         slugifier: serverConfig.slugifier,
         requestContext: await getAdminRequestContext()
     };
-    return duplicateDocument(ctx, {
-        sourceDocumentId
-    });
-});
+    try {
+        return await duplicateDocument(ctx, {
+            sourceDocumentId,
+            expectedRevision: input.expectedRevision
+        });
+    } catch (error) {
+        const committedFailure = toCommittedDocumentHookFailureResponse(error);
+        if (null != committedFailure) return committedFailure;
+        throw error;
+    }
+}));
 export { duplicateCollectionDocument };

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

@@ -1,10 +1,3 @@
-/**
- * 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
- */
 /**
  * Fetch a single document by ID. Returns `null` when the document is not found
  * so callers can degrade gracefully (e.g. `notFound()`).
@@ -16,6 +9,7 @@
  * `{target_document_id, target_collection_id}` refs.
  */
 export declare function getCollectionDocument(collection: string, id: string, locale?: string, depth?: number, populateRelations?: boolean): Promise<{
+    revision: number;
     _publishedVersion: Record<string, any> | null;
     _restoreWarnings?: string[] | undefined;
     availableLocales?: string[] | undefined;

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

@@ -1,3 +1,4 @@
+import { withEditableRevision } from "../editable-revision.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminBylineClient, getAdminRequestContext } from "@byline/client/server";
 import { BylineError, ERR_NOT_FOUND, ErrorCodes, documentAbilityKey, getCollectionSchemasForPath, getLogger, getServerConfig } from "@byline/core";
@@ -18,12 +19,12 @@ const getDocumentFn = createServerFn({
     }).log(logger);
     const client = getAdminBylineClient();
     const handle = client.collection(path);
-    const { options: readOptions, populatedTree } = resolveAdminDocumentRead(config.definition, {
+    const { options: { status: _status, ...readOptions }, populatedTree } = resolveAdminDocumentRead(config.definition, {
         locale,
         depth,
         populateRelations
     });
-    const document = await handle.findById(id, {
+    const document = await handle.findByIdForEdit(id, {
         ...readOptions
     });
     if (!document) throw ERR_NOT_FOUND({
@@ -61,11 +62,11 @@ const getDocumentFn = createServerFn({
     if (scheduledPublicationEnabled) {
         const actor = (await getAdminRequestContext()).actor;
         canSchedulePublication = actor?.hasAbility(documentAbilityKey(config.definition, 'changeStatus')) === true && actor.hasAbility(documentAbilityKey(config.definition, 'publish'));
-        if (canSchedulePublication) scheduledPublish = await handle.getScheduledPublish(id);
+        if (canSchedulePublication) scheduledPublish = document.scheduledPublication;
     }
     const serializedSchedule = null == scheduledPublish ? null : serialise(scheduledPublish);
     return {
-        ...parsed,
+        ...withEditableRevision(parsed, document),
         _publishedVersion: publishedVersion,
         ...restoreWarnings && restoreWarnings.length > 0 ? {
             _restoreWarnings: restoreWarnings

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/list.d.ts

@@ -1,10 +1,3 @@
-/**
- * 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 CollectionSearchParams {
     page?: number;
     page_size?: number;

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

@@ -1,3 +1,4 @@
+import { withEditableRevision } from "../editable-revision.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getPreferenceCommand } from "@byline/admin/admin-preferences";
 import { getAdminBylineClient, getAdminRequestContext } from "@byline/client/server";
@@ -61,7 +62,7 @@ const getCollectionDocuments = createServerFn({
         }));
     const hasRelations = Object.keys(populateMap).length > 0;
     const populate = hasRelations ? populateMap : void 0;
-    const result = await handle.find({
+    const result = await handle.findForEdit({
         where: Object.keys(where).length > 0 ? where : void 0,
         sort: viewState.sort,
         locale: params.locale ?? 'en',
@@ -70,7 +71,6 @@ const getCollectionDocuments = createServerFn({
         select: params.fields,
         populate,
         depth: hasRelations ? 1 : void 0,
-        status: 'any',
         onMissingLocale: 'empty'
     });
     const documentIds = result.docs.map((d)=>d.id);
@@ -104,6 +104,14 @@ const getCollectionDocuments = createServerFn({
     const serialised = serialise(response);
     const { list } = getCollectionSchemasForPath(path);
     if (hasRelations) return serialised;
-    return list.parse(serialised);
+    const parsed = list.parse(serialised);
+    const observations = new Map(result.docs.map((doc)=>[
+            doc.id,
+            doc
+        ]));
+    return {
+        ...parsed,
+        docs: parsed.docs.map((doc)=>withEditableRevision(doc, observations.get(doc.id)))
+    };
 });
 export { getCollectionDocuments };

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

@@ -1,21 +1,20 @@
-/**
- * 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 reorderCollectionDocument: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     documentId: string;
     beforeDocumentId?: string | null;
     afterDocumentId?: string | null;
 }) => {
+    expectedRevision: number;
     collection: string;
     documentId: string;
     beforeDocumentId?: string | null;
     afterDocumentId?: string | null;
 }, Promise<{
-    status: 'ok';
+    documentId: string;
+    revision: number;
+    affectedDocuments: import("@byline/core").DocumentRevisionReceipt[];
+    scheduledPublicationsNeedReconfirmation: boolean;
     orderKey: string;
+    status: 'ok';
 }>>;

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

@@ -1,10 +1,11 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 import { getAdminRequestContext } from "@byline/client/server";
-import { ERR_NOT_FOUND, ERR_VALIDATION, assertActorCanPerform, generateKeyBetween, generateNKeysBetween, getLogger, getServerConfig } from "@byline/core";
+import { ERR_NOT_FOUND, getLogger, getServerConfig, reorderDocument } from "@byline/core";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const reorderCollectionDocument = createServerFn({
     method: 'POST'
-}).validator((input)=>input).handler(async ({ data: input })=>{
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, documentId, beforeDocumentId, afterDocumentId } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
@@ -14,83 +15,26 @@ const reorderCollectionDocument = createServerFn({
             collectionPath: path
         }
     }).log(logger);
-    if (true !== config.definition.orderable) throw ERR_VALIDATION({
-        message: `collection '${path}' is not orderable; set \`orderable: true\` on its collection definition to enable reordering`,
-        details: {
-            collectionPath: path
-        }
-    }).log(logger);
-    const requestContext = await getAdminRequestContext();
-    assertActorCanPerform(requestContext, config.definition, 'update');
     const serverConfig = getServerConfig();
-    const collectionId = config.collection.id;
-    const canonical = await serverConfig.db.queries.documents.getCanonicalDocumentOrder({
-        collection_id: collectionId
-    });
-    let corrupted = false;
-    {
-        const seen = new Set();
-        let lastKey = null;
-        for (const doc of canonical)if (null != doc.order_key) {
-            if (seen.has(doc.order_key)) {
-                corrupted = true;
-                break;
-            }
-            if (null != lastKey && doc.order_key <= lastKey) {
-                corrupted = true;
-                break;
-            }
-            seen.add(doc.order_key);
-            lastKey = doc.order_key;
-        }
-    }
-    if (corrupted) {
-        const allKeys = generateNKeysBetween(null, null, canonical.length);
-        for(let i = 0; i < canonical.length; i++)await serverConfig.db.commands.documents.setOrderKey({
-            document_id: canonical[i]?.id,
-            order_key: allKeys[i]
-        });
-    } else {
-        const firstNullIdx = canonical.findIndex((d)=>null == d.order_key);
-        if (-1 !== firstNullIdx) {
-            const nullDocs = canonical.slice(firstNullIdx);
-            const lastExistingKey = 0 === firstNullIdx ? null : canonical[firstNullIdx - 1]?.order_key;
-            const newKeys = generateNKeysBetween(lastExistingKey, null, nullDocs.length);
-            for(let i = 0; i < nullDocs.length; i++)await serverConfig.db.commands.documents.setOrderKey({
-                document_id: nullDocs[i]?.id,
-                order_key: newKeys[i]
-            });
-        }
-    }
-    const { left, right } = await serverConfig.db.queries.documents.getNeighborOrderKeys({
-        collection_id: collectionId,
-        before_document_id: beforeDocumentId ?? null,
-        after_document_id: afterDocumentId ?? null
-    });
-    let newKey;
-    try {
-        newKey = generateKeyBetween(left, right);
-    } catch (err) {
-        throw ERR_VALIDATION({
-            message: 'cannot generate order_key between supplied neighbors',
-            details: {
-                collectionPath: path,
-                documentId,
-                beforeDocumentId,
-                afterDocumentId,
-                left,
-                right,
-                cause: err instanceof Error ? err.message : String(err)
-            }
-        }).log(logger);
-    }
-    await serverConfig.db.commands.documents.setOrderKey({
-        document_id: documentId,
-        order_key: newKey
+    const result = await reorderDocument({
+        db: serverConfig.db,
+        definition: config.definition,
+        collectionId: config.collection.id,
+        collectionVersion: config.collection.version,
+        collectionPath: path,
+        requestContext: await getAdminRequestContext(),
+        logger,
+        defaultLocale: serverConfig.i18n.content.defaultLocale,
+        slugifier: serverConfig.slugifier
+    }, {
+        documentId,
+        expectedRevision: input.expectedRevision,
+        beforeDocumentId,
+        afterDocumentId
     });
     return {
         status: 'ok',
-        orderKey: newKey
+        ...result
     };
-});
+}));
 export { reorderCollectionDocument };

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

@@ -1,21 +1,17 @@
-/**
- * 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 restoreDocumentVersion: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     id: string;
     versionId: string;
 }) => {
+    expectedRevision: number;
     collection: string;
     id: string;
     versionId: string;
-}, Promise<{
+}, Promise<import("./save-outcome.js").CollectionDocumentCommittedHookFailureResponse | {
     status: 'ok';
     documentId: string;
+    revision: number;
     documentVersionId: string;
     sourceVersionId: string;
 }>>;

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

@@ -1,11 +1,13 @@
+import { withDocumentMutationErrors } from "../document-mutation-errors.js";
 import { createServerFn } from "@tanstack/react-start";
 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 })=>{
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data: input })=>{
     const { collection: path, id, versionId } = input;
     const logger = getLogger();
     const config = await ensureCollection(path);
@@ -27,15 +29,23 @@ 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,
+            expectedRevision: input.expectedRevision,
+            sourceVersionId: versionId
+        });
+        return {
+            status: 'ok',
+            documentId: result.documentId,
+            revision: result.revision,
+            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,24 @@
+/**
+ * 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;
+    revision: number;
+    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,19 @@
+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,
+        revision: details.revision,
+        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/scheduled-publication.d.ts

@@ -1,10 +1,3 @@
-/**
- * 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 { DocumentPublishScheduleInfo } from '@byline/client';
 import { type DocumentPublishScheduleState, type RecurringTaskHealth } from '@byline/core';
 export interface ScheduledPublicationRuntime {
@@ -31,6 +24,7 @@ export type SerializedDocumentPublishSchedule = Omit<DocumentPublishScheduleInfo
     nextAttemptAt: string;
 };
 export interface ScheduledPublicationListItem extends SerializedDocumentPublishSchedule {
+    revision: number;
     collectionPath: string;
     collectionLabel: string;
     documentPath: string | null;
@@ -56,37 +50,83 @@ export interface ScheduledPublicationListResponse {
 /** Authenticated feature discovery for the admin shell and health warning. */
 export declare const getScheduledPublicationRuntime: import("@tanstack/react-start").OptionalFetcher<undefined, undefined, Promise<ScheduledPublicationRuntime>>;
 export declare const scheduleCollectionDocumentPublish: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     id: string;
     publishAt: string;
     expectedVersionId: string;
 }) => {
+    expectedRevision: number;
     collection: string;
     id: string;
     publishAt: string;
     expectedVersionId: string;
-}, Promise<SerializedDocumentPublishSchedule>>;
+}, Promise<{
+    authorizedRevision: number | null;
+    documentId: string;
+    collectionId: string;
+    targetVersionId: string;
+    state: DocumentPublishScheduleState;
+    suspendedReason: ("content_edited" | "document_metadata_changed" | "upgrade_invalidated") | null;
+    scheduledBy: string | null;
+    lastAuthorizedBy: string | null;
+    attemptCount: number;
+    lastError: string | null;
+    publishAt: string;
+    suspendedAt: string | null;
+    lastAuthorizedAt: string;
+    scheduledAt: string;
+    updatedAt: string;
+    lastAttemptAt: string | null;
+    nextAttemptAt: string;
+    revision: number;
+}>>;
 export declare const confirmCollectionDocumentScheduledPublish: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     id: string;
     expectedVersionId: string;
 }) => {
+    expectedRevision: number;
     collection: string;
     id: string;
     expectedVersionId: string;
-}, Promise<SerializedDocumentPublishSchedule>>;
+}, Promise<{
+    authorizedRevision: number | null;
+    documentId: string;
+    collectionId: string;
+    targetVersionId: string;
+    state: DocumentPublishScheduleState;
+    suspendedReason: ("content_edited" | "document_metadata_changed" | "upgrade_invalidated") | null;
+    scheduledBy: string | null;
+    lastAuthorizedBy: string | null;
+    attemptCount: number;
+    lastError: string | null;
+    publishAt: string;
+    suspendedAt: string | null;
+    lastAuthorizedAt: string;
+    scheduledAt: string;
+    updatedAt: string;
+    lastAttemptAt: string | null;
+    nextAttemptAt: string;
+    revision: number;
+}>>;
 export declare const cancelCollectionDocumentScheduledPublish: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    expectedRevision: number;
     collection: string;
     id: string;
 }) => {
+    expectedRevision: number;
     collection: string;
     id: string;
 }, Promise<{
     status: 'not_found';
+    revision: number;
     schedule?: undefined;
 } | {
     status: 'cancelled';
     schedule: SerializedDocumentPublishSchedule;
+    revision: number;
 }>>;
 export declare const listScheduledPublications: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
     states?: readonly DocumentPublishScheduleState[];