@byline/host-tanstack-start 3.21.0 → 4.0.0

package/dist/routes/create-admin-account-route.js

@@ -5,6 +5,7 @@ import { useTranslation } from "@byline/i18n/react";
 import { Container, Section } from "@byline/ui/react";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { getAccount } from "../server-fns/admin-account/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function displayNameFor(account) {
     const parts = [
         account.given_name,
@@ -31,11 +32,11 @@ function createAdminAccountRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('chrome.account'),
-                                href: '/admin/account'
+                                href: getAdminRoutePath('account')
                             }
                         ]
                     }),

package/dist/routes/create-admin-activity-route.js

@@ -5,6 +5,7 @@ import { z } from "zod";
 import { ActivitySystemView } from "../admin-shell/admin-activity/list.js";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { getSystemActivityLog } from "../server-fns/admin-activity/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 const searchSchema = z.object({
     page: z.coerce.number().int().min(1).optional(),
     page_size: z.coerce.number().int().min(1).max(100).optional(),
@@ -51,11 +52,11 @@ function createAdminActivityRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('activity.title'),
-                                href: '/admin/activity'
+                                href: getAdminRoutePath('activity')
                             }
                         ]
                     }),

package/dist/routes/create-admin-dashboard-route.js

@@ -5,6 +5,7 @@ import { useTranslation } from "@byline/i18n/react";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { AdminDashboard } from "../admin-shell/chrome/dashboard.js";
 import { getCollectionStats } from "../server-fns/collections/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function createAdminDashboardRoute(path) {
     const Route = createFileRoute(path)({
         loader: async ()=>{
@@ -30,7 +31,7 @@ function createAdminDashboardRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             }
                         ]
                     }),

package/dist/routes/create-admin-layout-route.d.ts

@@ -6,7 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 interface AdminLayoutOpts {
-    /** Path users are redirected to when unauthenticated. Defaults to `/sign-in`. */
+    /** @deprecated Configure `routes.signIn`; an override must resolve to the same path. */
     signInPath?: string;
 }
 export declare function createAdminLayoutRoute(path: string, opts?: AdminLayoutOpts): any;

package/dist/routes/create-admin-layout-route.js

@@ -20,10 +20,12 @@ import { BylineAiAdminProvider } from "../integrations/byline-ai.js";
 import { bylineFieldServices } from "../integrations/byline-field-services.js";
 import { getCurrentAdminUser } from "../server-fns/auth/index.js";
 import { getActiveLocaleFn, setInterfaceLocaleFn } from "../server-fns/i18n/index.js";
+import { createSignInRoutePathResolver } from "./sign-in-path.js";
 function createAdminLayoutRoute(path, opts = {}) {
-    const signInPath = opts.signInPath ?? '/sign-in';
+    const resolveSignInPath = createSignInRoutePathResolver(opts.signInPath);
     const Route = createFileRoute(path)({
         beforeLoad: async ({ location })=>{
+            const signInPath = resolveSignInPath();
             try {
                 const user = await getCurrentAdminUser();
                 const activeLocale = await getActiveLocaleFn();

package/dist/routes/create-admin-permissions-route.js

@@ -4,6 +4,7 @@ import { AbilitiesInspector } from "@byline/admin/admin-permissions/components/i
 import { useTranslation } from "@byline/i18n/react";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { listRegisteredAbilities } from "../server-fns/admin-permissions/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function createAdminPermissionsRoute(path) {
     const Route = createFileRoute(path)({
         loader: async ()=>{
@@ -21,11 +22,11 @@ function createAdminPermissionsRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('chrome.menu.permissions'),
-                                href: '/admin/permissions'
+                                href: getAdminRoutePath('permissions')
                             }
                         ]
                     }),

package/dist/routes/create-admin-role-edit-route.js

@@ -6,6 +6,7 @@ import { RoleContainer } from "../admin-shell/admin-roles/container.js";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { getRoleAbilities, listRegisteredAbilities } from "../server-fns/admin-permissions/index.js";
 import { getAdminRole } from "../server-fns/admin-roles/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function createAdminRoleEditRoute(path) {
     const Route = createFileRoute(path)({
         loader: async ({ params })=>{
@@ -42,15 +43,15 @@ function createAdminRoleEditRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('chrome.menu.adminRoles'),
-                                href: '/admin/roles'
+                                href: getAdminRoutePath('roles')
                             },
                             {
                                 label: t('adminRoles.breadcrumbDetail'),
-                                href: `/admin/roles/${role.id}`
+                                href: getAdminRoutePath('roles', role.id)
                             }
                         ]
                     }),

package/dist/routes/create-admin-roles-list-route.js

@@ -4,6 +4,7 @@ import { useTranslation } from "@byline/i18n/react";
 import { AdminRolesListView } from "../admin-shell/admin-roles/list.js";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { listAdminRoles } from "../server-fns/admin-roles/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function createAdminRolesListRoute(path) {
     const Route = createFileRoute(path)({
         loader: async ()=>{
@@ -21,11 +22,11 @@ function createAdminRolesListRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('chrome.menu.adminRoles'),
-                                href: '/admin/roles'
+                                href: getAdminRoutePath('roles')
                             }
                         ]
                     }),

package/dist/routes/create-admin-user-edit-route.js

@@ -6,6 +6,7 @@ import { AccountContainer } from "../admin-shell/admin-users/container.js";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { listAdminRoles } from "../server-fns/admin-roles/index.js";
 import { getAdminUser, getUserRoles } from "../server-fns/admin-users/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function displayNameFor(user) {
     const parts = [
         user.given_name,
@@ -49,15 +50,15 @@ function createAdminUserEditRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('chrome.menu.adminUsers'),
-                                href: '/admin/users'
+                                href: getAdminRoutePath('users')
                             },
                             {
                                 label: t('adminUsers.breadcrumbDetail'),
-                                href: `/admin/users/${user.id}`
+                                href: getAdminRoutePath('users', user.id)
                             }
                         ]
                     }),

package/dist/routes/create-admin-users-list-route.js

@@ -5,6 +5,7 @@ import { z } from "zod";
 import { AdminUsersListView } from "../admin-shell/admin-users/list.js";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { listAdminUsers } from "../server-fns/admin-users/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 const orderSchema = z["enum"]([
     'given_name',
     'family_name',
@@ -53,11 +54,11 @@ function createAdminUsersListRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: t('chrome.menu.adminUsers'),
-                                href: '/admin/users'
+                                href: getAdminRoutePath('users')
                             }
                         ]
                     }),

package/dist/routes/create-collection-api-route.js

@@ -6,6 +6,7 @@ import { z } from "zod";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { ApiView } from "../admin-shell/collections/api.js";
 import { getCollectionDocument } from "../server-fns/collections/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 import { getContentLocaleRouteConfig } from "./get-content-locale-route-config.js";
 const searchSchema = z.object({
     locale: z.string().optional(),
@@ -43,19 +44,19 @@ function createCollectionApiRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: "/admin"
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: collectionDef.labels.plural,
-                                href: `/admin/collections/${collection}`
+                                href: getAdminRoutePath('collections', collection)
                             },
                             {
                                 label: t('common.actions.edit'),
-                                href: `/admin/collections/${collection}/${id}`
+                                href: getAdminRoutePath('collections', collection, id)
                             },
                             {
                                 label: t('collections.viewMenu.apiButton'),
-                                href: `/admin/collections/${collection}/${id}/api`
+                                href: getAdminRoutePath('collections', collection, id, 'api')
                             }
                         ]
                     }),

package/dist/routes/create-collection-create-route.js

@@ -4,6 +4,7 @@ import { buildInitialDataFromFields, getCollectionAdminConfig, getCollectionDefi
 import { useTranslation } from "@byline/i18n/react";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { CreateView } from "../admin-shell/collections/create.js";
+import { getAdminRoutePath } from "./admin-path.js";
 function createCollectionCreateRoute(path) {
     const Route = createFileRoute(path)({
         loader: async ({ params })=>{
@@ -29,15 +30,15 @@ function createCollectionCreateRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: '/admin'
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: collectionDef.labels.plural,
-                                href: `/admin/collections/${collection}`
+                                href: getAdminRoutePath('collections', collection)
                             },
                             {
                                 label: t('collections.breadcrumbs.create'),
-                                href: `/admin/collections/${collection}/create`
+                                href: getAdminRoutePath('collections', collection, 'create')
                             }
                         ]
                     }),

package/dist/routes/create-collection-edit-route.js

@@ -9,6 +9,7 @@ import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs
 import { useNavigate } from "../admin-shell/chrome/loose-router.js";
 import { EditView } from "../admin-shell/collections/edit.js";
 import { getCollectionDocument } from "../server-fns/collections/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 import { getContentLocaleRouteConfig } from "./get-content-locale-route-config.js";
 const searchSchema = z.object({
     locale: z.string().optional(),
@@ -86,15 +87,15 @@ function createCollectionEditRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: "/admin"
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: collectionDef.labels.plural,
-                                href: `/admin/collections/${collection}`
+                                href: getAdminRoutePath('collections', collection)
                             },
                             {
                                 label: t('common.actions.edit'),
-                                href: `/admin/collections/${collection}/${id}`
+                                href: getAdminRoutePath('collections', collection, id)
                             }
                         ]
                     }),

package/dist/routes/create-collection-history-route.js

@@ -6,6 +6,7 @@ import { z } from "zod";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { HistoryView } from "../admin-shell/collections/history.js";
 import { getCollectionDocument, getCollectionDocumentAuditLog, getCollectionDocumentHistory } from "../server-fns/collections/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 import { getContentLocaleRouteConfig } from "./get-content-locale-route-config.js";
 const searchSchema = z.object({
     page: z.coerce.number().min(1).optional(),
@@ -80,19 +81,19 @@ function createCollectionHistoryRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: "/admin"
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: collectionDef.labels.plural,
-                                href: `/admin/collections/${collection}`
+                                href: getAdminRoutePath('collections', collection)
                             },
                             {
                                 label: t('common.actions.edit'),
-                                href: `/admin/collections/${collection}/${Route.useParams().id}`
+                                href: getAdminRoutePath('collections', collection, Route.useParams().id)
                             },
                             {
                                 label: t('collections.breadcrumbs.history'),
-                                href: `/admin/collections/${collection}/${Route.useParams().id}/history`
+                                href: getAdminRoutePath('collections', collection, Route.useParams().id, 'history')
                             }
                         ]
                     }),

package/dist/routes/create-collection-list-route.js

@@ -11,6 +11,7 @@ import { useNavigate } from "../admin-shell/chrome/loose-router.js";
 import { ListView } from "../admin-shell/collections/list.js";
 import { TreeListView } from "../admin-shell/collections/tree-list.js";
 import { getCollectionDocuments, getCollectionTree, placeTreeNode, reorderCollectionDocument } from "../server-fns/collections/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
 const searchSchema = z.object({
     page: z.coerce.number().min(1).optional(),
     page_size: z.coerce.number().max(100).optional(),
@@ -118,11 +119,11 @@ function createCollectionListRoute(path) {
                         breadcrumbs: [
                             {
                                 label: t('chrome.menu.dashboard'),
-                                href: "/admin"
+                                href: getAdminRoutePath()
                             },
                             {
                                 label: data.included.collection.labels.plural,
-                                href: `/admin/collections/${collection}`
+                                href: getAdminRoutePath('collections', collection)
                             }
                         ]
                     }),

package/dist/routes/create-sign-in-route.js

@@ -2,10 +2,11 @@ import { jsx } from "react/jsx-runtime";
 import { createFileRoute } from "@tanstack/react-router";
 import { SignInPage } from "../admin-shell/chrome/sign-in-page.js";
 import { getActiveLocaleFn } from "../server-fns/i18n/index.js";
+import { resolveAdminCallbackPath, resolveAdminSignInRedirect } from "./admin-path.js";
 function createSignInRoute(path) {
     const Route = createFileRoute(path)({
         validateSearch: (search)=>{
-            const callbackUrl = 'string' == typeof search.callbackUrl ? search.callbackUrl : void 0;
+            const callbackUrl = resolveAdminCallbackPath(search.callbackUrl);
             return {
                 callbackUrl
             };
@@ -20,7 +21,7 @@ function createSignInRoute(path) {
             const { callbackUrl } = Route.useSearch();
             const { activeLocale } = Route.useRouteContext();
             return /*#__PURE__*/ jsx(SignInPage, {
-                callbackUrl: callbackUrl,
+                redirectTo: resolveAdminSignInRedirect(callbackUrl),
                 activeLocale: activeLocale
             });
         }

package/dist/routes/index.d.ts

@@ -5,6 +5,8 @@
  *
  * Copyright (c) Infonomic Company Limited
  */
+export { getAdminRouteId, getAdminRoutePath, isAdminRoutePathActive, isRoutePathWithin, resolveAdminCallbackPath, resolveAdminSignInRedirect, } from './admin-path.js';
+export { configureSignInRoutePath, getSignInRoutePath } from './sign-in-path.js';
 /**
  * Route factories for the Byline admin UI on TanStack Start.
  *
@@ -13,6 +15,7 @@
  * `createFileRoute(path)({...})`. The host's route file collapses to:
  *
  *   import { createCollectionListRoute } from '@byline/host-tanstack-start/routes'
+ *   // Default admin mount example:
  *   export const Route = createCollectionListRoute('/_byline/admin/collections/$collection/')
  *
  * Routes that need host-specific data (i18n bridge component, content

package/dist/routes/index.js

@@ -1,3 +1,5 @@
+export { getAdminRouteId, getAdminRoutePath, isAdminRoutePathActive, isRoutePathWithin, resolveAdminCallbackPath, resolveAdminSignInRedirect } from "./admin-path.js";
+export { configureSignInRoutePath, getSignInRoutePath } from "./sign-in-path.js";
 export { createAdminAccountRoute } from "./create-admin-account-route.js";
 export { createAdminActivityRoute } from "./create-admin-activity-route.js";
 export { createAdminDashboardRoute } from "./create-admin-dashboard-route.js";

package/dist/routes/sign-in-path.d.ts

@@ -0,0 +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
+ */
+/** Read the canonical client-safe sign-in destination. */
+export declare function getSignInRoutePath(): string;
+/** @deprecated Configure `routes.signIn`; retained for route-factory input validation. */
+export declare function configureSignInRoutePath(legacyOverride?: string): string;
+/** Defer deprecated override validation until the admin route's beforeLoad boundary. */
+export declare function createSignInRoutePathResolver(legacyOverride?: string): () => string;

package/dist/routes/sign-in-path.js

@@ -0,0 +1,19 @@
+import { getClientConfig, resolveRoutes } from "@byline/core";
+function getSignInRoutePath() {
+    return getClientConfig().routes.signIn;
+}
+function configureSignInRoutePath(legacyOverride) {
+    const routes = getClientConfig().routes;
+    const configured = routes.signIn;
+    if (void 0 === legacyOverride) return configured;
+    const normalizedOverride = resolveRoutes({
+        ...routes,
+        signIn: legacyOverride
+    }).signIn;
+    if (normalizedOverride !== configured) throw new Error(`createAdminLayoutRoute signInPath (${normalizedOverride}) must match routes.signIn (${configured})`);
+    return configured;
+}
+function createSignInRoutePathResolver(legacyOverride) {
+    return void 0 === legacyOverride ? getSignInRoutePath : ()=>configureSignInRoutePath(legacyOverride);
+}
+export { configureSignInRoutePath, createSignInRoutePathResolver, getSignInRoutePath };

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

@@ -3,6 +3,7 @@ import { ERR_NOT_FOUND, getLogger, getServerConfig, getUploadFields } from "@byl
 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/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/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>;