@byline/host-tanstack-start 4.19.0 → 5.0.0

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,12 +1,14 @@
+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 })=>{
+}).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
@@ -16,5 +18,5 @@ const copySingletonToLocale = createServerFn({
         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,16 +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 })=>{
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>{
     try {
-        return serialise(await getAdminBylineClient().singleton(data.singleton).restoreVersion(data.versionId));
+        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,15 +1,16 @@
+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;
+}).validator((input)=>input).handler(withDocumentMutationErrors(async ({ data })=>{
+    const { singleton, data: fields, locale, ...precondition } = data;
     try {
         const result = await getAdminBylineClient().singleton(singleton).update(fields, {
             locale,
-            expectedVersionId
+            ...precondition
         });
         return serialise(result);
     } catch (error) {
@@ -17,5 +18,5 @@ const updateSingleton = createServerFn({
         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.19.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.19.0",
-    "@byline/analytics": "4.19.0",
-    "@byline/analytics-agent": "4.19.0",
-    "@byline/ai": "4.19.0",
-    "@byline/core": "4.19.0",
-    "@byline/client": "4.19.0",
-    "@byline/auth": "4.19.0",
-    "@byline/i18n": "4.19.0",
-    "@byline/ui": "4.19.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",