@byline/host-tanstack-start 3.21.0 → 4.1.0

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { createDocument } from "@byline/core/services";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const createCollectionDocument = createServerFn({
     method: 'POST'

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { deleteLocale } from "@byline/core/services";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const deleteDocumentLocale = createServerFn({
     method: 'POST'

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

@@ -0,0 +1,30 @@
+/**
+ * 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 { DeleteDocumentResult, DeleteDocumentSideEffectCode, DeleteDocumentSideEffectPhase } from '@byline/core';
+export type DeleteDocumentPublicSideEffectPhase = DeleteDocumentSideEffectPhase | 'unknown';
+export type DeleteDocumentPublicSideEffectCode = DeleteDocumentSideEffectCode;
+export interface DeleteDocumentPublicSideEffectFailure {
+    phase: DeleteDocumentPublicSideEffectPhase;
+    code: DeleteDocumentPublicSideEffectCode;
+}
+export type DeleteDocumentResponse = {
+    status: 'ok';
+    deletedVersionCount: number;
+    outcome: 'committed';
+    sideEffectFailures: [];
+} | {
+    status: 'ok';
+    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

@@ -0,0 +1,34 @@
+import { ErrorCodes } from "@byline/core";
+function sanitizePhase(phase) {
+    if ('storageCleanup' === phase || 'afterTreeChange' === phase || 'afterDelete' === phase) return phase;
+    return 'unknown';
+}
+function sanitizeCode(code) {
+    return code === ErrorCodes.STORAGE ? ErrorCodes.STORAGE : ErrorCodes.UNHANDLED;
+}
+function sanitizeFailure({ phase, code }) {
+    return {
+        phase: sanitizePhase(phase),
+        code: sanitizeCode(code)
+    };
+}
+function toDeleteDocumentResponse(result) {
+    if ('committed' === result.outcome) return {
+        status: 'ok',
+        ...result
+    };
+    const [firstFailure, ...remainingFailures] = result.sideEffectFailures;
+    return {
+        status: 'ok',
+        deletedVersionCount: result.deletedVersionCount,
+        outcome: result.outcome,
+        sideEffectFailures: [
+            sanitizeFailure(firstFailure),
+            ...remainingFailures.map(sanitizeFailure)
+        ]
+    };
+}
+function hasDeleteSideEffectFailures(result) {
+    return 'committed-with-side-effect-failures' === result.outcome;
+}
+export { hasDeleteSideEffectFailures, toDeleteDocumentResponse };

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

@@ -11,7 +11,4 @@ export declare const deleteDocument: import("@tanstack/react-start").RequiredFet
 }) => {
     collection: string;
     id: string;
-}, Promise<{
-    status: 'ok';
-    deletedVersionCount: number;
-}>>;
+}, Promise<import("./delete-outcome.js").DeleteDocumentResponse>>;

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

@@ -1,8 +1,9 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig, getUploadFields } from "@byline/core";
 import { deleteDocument } from "@byline/core/services";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
 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 })=>{
@@ -36,9 +37,6 @@ const delete_deleteDocument = createServerFn({
     const result = await deleteDocument(ctx, {
         documentId: id
     });
-    return {
-        status: 'ok',
-        deletedVersionCount: result.deletedVersionCount
-    };
+    return toDeleteDocumentResponse(result);
 });
 export { delete_deleteDocument as deleteDocument };

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

@@ -1,7 +1,7 @@
 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 { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const duplicateCollectionDocument = createServerFn({
     method: 'POST'

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminBylineClient } from "@byline/client/server";
 import { BylineError, ERR_NOT_FOUND, ErrorCodes, buildRelationSummaryPopulateMap, getCollectionAdminConfig, getCollectionDefinition, getCollectionSchemasForPath, getLogger, getServerConfig } from "@byline/core";
 import { ensureCollection } from "../../integrations/api-utils.js";
-import { getAdminBylineClient } from "../../integrations/byline-client.js";
 import { serialise } from "./utils.js";
 const getDocumentFn = createServerFn({
     method: 'GET'

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminBylineClient } from "@byline/client/server";
 import { ERR_NOT_FOUND, getCollectionSchemasForPath, getLogger } from "@byline/core";
 import { ensureCollection } from "../../integrations/api-utils.js";
-import { getAdminBylineClient } from "../../integrations/byline-client.js";
 import { resolveActorLabels } from "./actors.js";
 import { serialise } from "./utils.js";
 const getCollectionDocumentHistory = createServerFn({

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

@@ -9,6 +9,7 @@ export * from './copy-to-locale';
 export * from './create';
 export * from './delete';
 export * from './delete-locale';
+export * from './delete-outcome';
 export * from './duplicate';
 export * from './get';
 export * from './history';

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

@@ -3,6 +3,7 @@ export * from "./copy-to-locale.js";
 export * from "./create.js";
 export * from "./delete.js";
 export * from "./delete-locale.js";
+export * from "./delete-outcome.js";
 export * from "./duplicate.js";
 export * from "./get.js";
 export * from "./history.js";

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminBylineClient } from "@byline/client/server";
 import { ERR_NOT_FOUND, buildRelationSummaryPopulateMap, getCollectionAdminConfig, getCollectionDefinition, getCollectionSchemasForPath, getLogger, getServerConfig } from "@byline/core";
 import { ensureCollection } from "../../integrations/api-utils.js";
-import { getAdminBylineClient } from "../../integrations/byline-client.js";
 import { serialise } from "./utils.js";
 const getCollectionDocuments = createServerFn({
     method: 'GET'

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminBylineClient } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger } from "@byline/core";
 import { ensureCollection } from "../../integrations/api-utils.js";
-import { getAdminBylineClient } from "../../integrations/byline-client.js";
 const reindexCollection = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data })=>{

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

@@ -1,6 +1,6 @@
 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 { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const reorderCollectionDocument = createServerFn({
     method: 'POST'

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

@@ -1,7 +1,7 @@
 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 { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const restore_version_restoreDocumentVersion = createServerFn({
     method: 'POST'

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

@@ -1,6 +1,6 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminBylineClient } from "@byline/client/server";
 import { ensureCollection } from "../../integrations/api-utils.js";
-import { getAdminBylineClient } from "../../integrations/byline-client.js";
 const getCollectionStatsFn = createServerFn({
     method: 'GET'
 }).validator((input)=>input).handler(async ({ data })=>{

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { changeDocumentStatus, unpublishDocument } from "@byline/core/services";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const updateDocumentStatus = createServerFn({
     method: 'POST'

package/dist/server-fns/collections/tree-mutation.d.ts

@@ -0,0 +1,46 @@
+import type { CollectionHandle, PlaceTreeNodeOptions, RemoveFromTreeOptions } from '@byline/client';
+/** Prefer the code; the marker survives transports that reconstruct a code-less Error. */
+export declare function isTreeMutationConflict(error: unknown): boolean;
+/** Detect when tree/audit committed even if transport reconstruction dropped the code. */
+export declare function isCommittedTreeHookFailure(error: unknown): boolean;
+export type AdminTreeMoveOutcome = {
+    status: 'ok';
+} | {
+    status: 'suppressed';
+} | {
+    status: 'mutation-failed';
+    error: unknown;
+    refreshError?: unknown;
+} | {
+    status: 'committed-hook-failed';
+    error: unknown;
+    refreshError?: unknown;
+} | {
+    status: 'refresh-failed';
+    error: unknown;
+};
+export interface AdminTreeMoveUiEffects {
+    rollback: boolean;
+    preserveOptimistic: boolean;
+    structuralFailure: 'conflict' | 'generic' | null;
+    committedHookWarning: boolean;
+    refreshWarning: boolean;
+}
+/** Pure UI policy for every mutation/refresh outcome. */
+export declare function getAdminTreeMoveUiEffects(outcome: AdminTreeMoveOutcome): AdminTreeMoveUiEffects;
+/** Preserve a committed optimistic move until a later loader returns new row data. */
+export declare function shouldSyncAdminTreeRows(rows: unknown, preservedRows: unknown, isMoving: boolean): boolean;
+/** Keep mutation and canonical-refresh failures distinct for optimistic tree UIs. */
+export declare function executeAdminTreeMove(mutate: () => Promise<unknown>, refresh: () => Promise<unknown>): Promise<AdminTreeMoveOutcome>;
+export interface AdminTreeMoveController {
+    isMoving(): boolean;
+    execute(mutate: () => Promise<unknown>, refresh: () => Promise<unknown>): Promise<AdminTreeMoveOutcome>;
+}
+/** Single-flight controller shared by pointer and keyboard tree moves. */
+export declare function createAdminTreeMoveController(): AdminTreeMoveController;
+/** Admin retries reconcile post-commit tree hooks unless explicitly disabled. */
+export declare function placeAdminTreeNode(handle: Pick<CollectionHandle, 'placeTreeNode'>, documentId: string, options: PlaceTreeNodeOptions): Promise<{
+    orderKey: string;
+}>;
+/** Admin retries reconcile post-commit tree hooks unless explicitly disabled. */
+export declare function removeAdminTreeNode(handle: Pick<CollectionHandle, 'removeFromTree'>, documentId: string, options?: RemoveFromTreeOptions): Promise<void>;

package/dist/server-fns/collections/tree-mutation.js

@@ -0,0 +1,109 @@
+import { ErrorCodes, TREE_HOOK_COMMITTED_MARKER, TREE_PLACEMENT_STALE_MARKER } from "@byline/core";
+function hasErrorCode(error, code) {
+    return 'object' == typeof error && null != error && 'code' in error && error.code === code;
+}
+function hasMessageMarker(error, marker) {
+    return error instanceof Error && error.message.startsWith(marker);
+}
+function isTreeMutationConflict(error) {
+    if (hasErrorCode(error, ErrorCodes.CONFLICT)) return true;
+    return hasMessageMarker(error, TREE_PLACEMENT_STALE_MARKER);
+}
+function isCommittedTreeHookFailure(error) {
+    if (hasErrorCode(error, ErrorCodes.TREE_HOOK_COMMITTED)) return true;
+    return hasMessageMarker(error, TREE_HOOK_COMMITTED_MARKER);
+}
+function getAdminTreeMoveUiEffects(outcome) {
+    if ('mutation-failed' === outcome.status) return {
+        rollback: true,
+        preserveOptimistic: false,
+        structuralFailure: isTreeMutationConflict(outcome.error) ? 'conflict' : 'generic',
+        committedHookWarning: false,
+        refreshWarning: null != outcome.refreshError
+    };
+    if ('committed-hook-failed' === outcome.status) return {
+        rollback: false,
+        preserveOptimistic: null != outcome.refreshError,
+        structuralFailure: null,
+        committedHookWarning: true,
+        refreshWarning: null != outcome.refreshError
+    };
+    if ('refresh-failed' === outcome.status) return {
+        rollback: false,
+        preserveOptimistic: true,
+        structuralFailure: null,
+        committedHookWarning: false,
+        refreshWarning: true
+    };
+    return {
+        rollback: 'suppressed' === outcome.status,
+        preserveOptimistic: false,
+        structuralFailure: null,
+        committedHookWarning: false,
+        refreshWarning: false
+    };
+}
+function shouldSyncAdminTreeRows(rows, preservedRows, isMoving) {
+    return !isMoving && rows !== preservedRows;
+}
+async function executeAdminTreeMove(mutate, refresh) {
+    try {
+        await mutate();
+    } catch (error) {
+        const status = isCommittedTreeHookFailure(error) ? 'committed-hook-failed' : 'mutation-failed';
+        try {
+            await refresh();
+            return {
+                status,
+                error
+            };
+        } catch (refreshError) {
+            return {
+                status,
+                error,
+                refreshError
+            };
+        }
+    }
+    try {
+        await refresh();
+        return {
+            status: 'ok'
+        };
+    } catch (error) {
+        return {
+            status: 'refresh-failed',
+            error
+        };
+    }
+}
+function createAdminTreeMoveController() {
+    let moving = false;
+    return {
+        isMoving: ()=>moving,
+        execute: async (mutate, refresh)=>{
+            if (moving) return {
+                status: 'suppressed'
+            };
+            moving = true;
+            try {
+                return await executeAdminTreeMove(mutate, refresh);
+            } finally{
+                moving = false;
+            }
+        }
+    };
+}
+function placeAdminTreeNode(handle, documentId, options) {
+    return handle.placeTreeNode(documentId, {
+        ...options,
+        reconcile: options.reconcile ?? true
+    });
+}
+function removeAdminTreeNode(handle, documentId, options = {}) {
+    return handle.removeFromTree(documentId, {
+        ...options,
+        reconcile: options.reconcile ?? true
+    });
+}
+export { createAdminTreeMoveController, executeAdminTreeMove, getAdminTreeMoveUiEffects, isCommittedTreeHookFailure, isTreeMutationConflict, placeAdminTreeNode, removeAdminTreeNode, shouldSyncAdminTreeRows };

package/dist/server-fns/collections/tree-read.d.ts

@@ -0,0 +1,6 @@
+import type { ClientDocument, CollectionHandle, TreeParentResult } from '@byline/client';
+import type { ReadContext } from '@byline/core';
+/** Admin tree placement reads must include drafts. */
+export declare function getAdminTreeParent(handle: Pick<CollectionHandle, 'getTreeParent'>, documentId: string): Promise<TreeParentResult>;
+/** Find unplaced nodes through the same row scope as the structural tree read. */
+export declare function getAdminUnplacedTreeDocuments(handle: Pick<CollectionHandle, 'find'>, placed: ReadonlySet<string>, readContext: ReadContext, locale?: string): Promise<ClientDocument[]>;

package/dist/server-fns/collections/tree-read.js

@@ -0,0 +1,15 @@
+function getAdminTreeParent(handle, documentId) {
+    return handle.getTreeParent(documentId, {
+        status: 'any'
+    });
+}
+async function getAdminUnplacedTreeDocuments(handle, placed, readContext, locale) {
+    const all = await handle.find({
+        status: 'any',
+        locale,
+        pageSize: 1000,
+        _readContext: readContext
+    });
+    return all.docs.filter((doc)=>!placed.has(doc.id));
+}
+export { getAdminTreeParent, getAdminUnplacedTreeDocuments };

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

@@ -11,12 +11,14 @@ export declare const placeTreeNode: import("@tanstack/react-start").RequiredFetc
     parentDocumentId: string | null;
     beforeDocumentId?: string | null;
     afterDocumentId?: string | null;
+    reconcile?: boolean;
 }) => {
     collection: string;
     documentId: string;
     parentDocumentId: string | null;
     beforeDocumentId?: string | null;
     afterDocumentId?: string | null;
+    reconcile?: boolean;
 }, Promise<{
     status: 'ok';
     orderKey: string;
@@ -24,9 +26,11 @@ export declare const placeTreeNode: import("@tanstack/react-start").RequiredFetc
 export declare const removeFromTree: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
     collection: string;
     documentId: string;
+    reconcile?: boolean;
 }) => {
     collection: string;
     documentId: string;
+    reconcile?: boolean;
 }, Promise<{
     status: 'ok';
 }>>;
@@ -47,10 +51,7 @@ export declare const getTreeParent: import("@tanstack/react-start").RequiredFetc
 }) => {
     collection: string;
     documentId: string;
-}, Promise<{
-    placed: boolean;
-    parentDocumentId: string | null;
-}>>;
+}, Promise<import("@byline/client").TreeParentResult>>;
 export interface CollectionTreeRow {
     id: string;
     /** Parent document id, or `null` for a root or unplaced node. Drives the

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

@@ -1,7 +1,9 @@
 import { createServerFn } from "@tanstack/react-start";
-import { ERR_NOT_FOUND, getLogger } from "@byline/core";
+import { getAdminBylineClient } from "@byline/client/server";
+import { ERR_NOT_FOUND, createReadContext, getLogger } from "@byline/core";
 import { ensureCollection } from "../../integrations/api-utils.js";
-import { getAdminBylineClient } from "../../integrations/byline-client.js";
+import { placeAdminTreeNode, removeAdminTreeNode } from "./tree-mutation.js";
+import { getAdminTreeParent, getAdminUnplacedTreeDocuments } from "./tree-read.js";
 const placeTreeNode = createServerFn({
     method: 'POST'
 }).validator((input)=>input).handler(async ({ data })=>{
@@ -14,10 +16,11 @@ const placeTreeNode = createServerFn({
         }
     }).log(getLogger());
     const handle = getAdminBylineClient().collection(path);
-    const result = await handle.placeTreeNode(documentId, {
+    const result = await placeAdminTreeNode(handle, documentId, {
         parentDocumentId: data.parentDocumentId,
         beforeDocumentId: data.beforeDocumentId ?? null,
-        afterDocumentId: data.afterDocumentId ?? null
+        afterDocumentId: data.afterDocumentId ?? null,
+        reconcile: data.reconcile
     });
     return {
         status: 'ok',
@@ -35,7 +38,9 @@ const removeFromTree = createServerFn({
             collectionPath: path
         }
     }).log(getLogger());
-    await getAdminBylineClient().collection(path).removeFromTree(documentId);
+    await removeAdminTreeNode(getAdminBylineClient().collection(path), documentId, {
+        reconcile: data.reconcile
+    });
     return {
         status: 'ok'
     };
@@ -76,7 +81,7 @@ const getTreeParent = createServerFn({
             collectionPath: path
         }
     }).log(getLogger());
-    return getAdminBylineClient().collection(path).getTreeParent(documentId);
+    return getAdminTreeParent(getAdminBylineClient().collection(path), documentId);
 });
 const getCollectionTree = createServerFn({
     method: 'GET'
@@ -90,9 +95,11 @@ const getCollectionTree = createServerFn({
         }
     }).log(getLogger());
     const handle = getAdminBylineClient().collection(path);
+    const readContext = createReadContext();
     const forest = await handle.getSubtree({
         status: 'any',
-        locale: data.locale
+        locale: data.locale,
+        _readContext: readContext
     });
     const rows = [];
     const placed = new Set();
@@ -115,12 +122,8 @@ const getCollectionTree = createServerFn({
         }
     };
     walk(forest, 0, null);
-    const all = await handle.find({
-        status: 'any',
-        pageSize: 1000,
-        _bypassBeforeRead: true
-    });
-    for (const doc of all.docs)if (!placed.has(doc.id)) rows.push({
+    const unplaced = await getAdminUnplacedTreeDocuments(handle, placed, readContext, data.locale);
+    for (const doc of unplaced)rows.push({
         id: doc.id,
         parentId: null,
         depth: 0,

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

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, getLogger, getServerConfig } from "@byline/core";
 import { updateDocumentSystemFields, updateDocumentWithPatches } from "@byline/core/services";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 const updateCollectionDocumentWithPatches = createServerFn({
     method: 'POST'
@@ -65,7 +65,8 @@ const updateCollectionDocumentSystemFields = createServerFn({
         documentId: id,
         locale: locale ?? serverConfig.i18n.content.defaultLocale,
         path: explicitPath,
-        availableLocales
+        availableLocales,
+        reconcile: true
     });
     return {
         status: 'ok'

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

@@ -1,9 +1,9 @@
 import { createServerFn } from "@tanstack/react-start";
+import { getAdminRequestContext } from "@byline/client/server";
 import { ERR_NOT_FOUND, ERR_VALIDATION, getServerConfig, getUploadFields } from "@byline/core";
 import { extractImageMeta, generateImageVariants, isBypassMimeType } from "@byline/core/image";
 import { getLogger, withLogContext } from "@byline/core/logger";
 import { uploadField } from "@byline/core/services";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
 import { ensureCollection } from "../../integrations/api-utils.js";
 function parseUploadFormData(data) {
     if (!(data instanceof FormData)) throw new Error('Expected FormData upload payload.');

package/dist/server-fns/i18n/set-locale.js

@@ -1,7 +1,7 @@
 import { createServerFn } from "@tanstack/react-start";
 import { setPreferredLocaleCommand } from "@byline/admin/admin-account";
 import { AuthError, AuthErrorCodes } from "@byline/auth";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
+import { getAdminRequestContext } from "@byline/client/server";
 import { clearAdminLocaleCookie, setAdminLocaleCookie } from "../../i18n/locale-cookie.js";
 import { bylineCore } from "../../integrations/byline-core.js";
 const setInterfaceLocaleFn = createServerFn({

package/dist/server-fns/preview/disable.js

@@ -1,5 +1,5 @@
 import { createServerFn } from "@tanstack/react-start";
-import { clearPreviewCookie } from "../../auth/preview-cookies.js";
+import { clearPreviewCookie } from "@byline/client/server";
 const disablePreviewModeFn = createServerFn({
     method: 'POST'
 }).handler(async ()=>{

package/dist/server-fns/preview/enable.js

@@ -1,6 +1,5 @@
 import { createServerFn } from "@tanstack/react-start";
-import { getAdminRequestContext } from "../../auth/auth-context.js";
-import { setPreviewCookie } from "../../auth/preview-cookies.js";
+import { getAdminRequestContext, setPreviewCookie } from "@byline/client/server";
 const enablePreviewModeFn = createServerFn({
     method: 'POST'
 }).handler(async ()=>{

package/dist/server-fns/preview/state.js

@@ -1,5 +1,5 @@
 import { createServerFn } from "@tanstack/react-start";
-import { readPreviewCookie } from "../../auth/preview-cookies.js";
+import { readPreviewCookie } from "@byline/client/server";
 const getPreviewStateFn = createServerFn({
     method: 'GET'
 }).handler(async ()=>({

package/dist/vite/client-hook-boundary.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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
+ */
+/**
+ * Production client-bundle guard for server-only Byline lifecycle modules.
+ *
+ * Collection schemas are isomorphic, but registered lifecycle hooks may
+ * import Node APIs, caches, storage SDKs, and other server-only dependencies.
+ * This Vite plugin inspects emitted client chunks and fails the build if a
+ * hook implementation, server hook registry, or shared lifecycle helper
+ * becomes reachable from the browser bundle.
+ */
+import type { Plugin } from 'vite';
+export declare function findServerHookModules(moduleIds: Iterable<string>): string[];
+export declare function bylineClientHookBoundary(): Plugin;

package/dist/vite/client-hook-boundary.js

@@ -0,0 +1,20 @@
+const SERVER_HOOK_MODULE = /\/byline\/collections\/(?:.+\/)?(?:hooks|[^/]+-hooks|[^/]+-lifecycle-hooks|[^/]+-side-effects)\.[cm]?[jt]sx?$/;
+function findServerHookModules(moduleIds) {
+    return [
+        ...moduleIds
+    ].filter((moduleId)=>{
+        const normalized = moduleId.replaceAll('\\', '/').split('?', 1)[0];
+        return SERVER_HOOK_MODULE.test(normalized);
+    });
+}
+function bylineClientHookBoundary() {
+    return {
+        name: 'byline:client-hook-boundary',
+        generateBundle (_options, bundle) {
+            if (this.environment?.name !== 'client') return;
+            const leaked = findServerHookModules(Object.values(bundle).flatMap((output)=>'chunk' === output.type ? Object.keys(output.modules) : []));
+            if (leaked.length > 0) this.error(`server lifecycle modules entered the client bundle:\n${leaked.join('\n')}`);
+        }
+    };
+}
+export { bylineClientHookBoundary, findServerHookModules };

package/dist/{integrations/byline-public-client.d.ts → vite/index.d.ts}

@@ -5,5 +5,4 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
-import { type BylineClient } from '@byline/client';
-export declare function getPublicBylineClient(): BylineClient;
+export { bylineClientHookBoundary } from './client-hook-boundary.js';

package/dist/vite/index.js

@@ -0,0 +1 @@
+export { bylineClientHookBoundary } from "./client-hook-boundary.js";