@byline/host-tanstack-start 3.20.4 → 4.0.0

package/src/routes/create-admin-layout-route.tsx

@@ -43,18 +43,18 @@ 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'
 
 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 function createAdminLayoutRoute(path: string, opts: AdminLayoutOpts = {}) {
-  const signInPath = opts.signInPath ?? '/sign-in'
-
-  // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
+  const resolveSignInPath = createSignInRoutePathResolver(opts.signInPath)
   const Route: any = createFileRoute(path as never)({
     beforeLoad: async ({ location }: { location: { href: string } }) => {
+      const signInPath = resolveSignInPath()
       try {
         const user = await getCurrentAdminUser()
         // Resolve the active interface locale once on the server so SSR

package/src/routes/create-admin-permissions-route.tsx

@@ -16,6 +16,7 @@ import {
   type ListRegisteredAbilitiesResponse,
   listRegisteredAbilities,
 } from '../server-fns/admin-permissions/index.js'
+import { getAdminRoutePath } from './admin-path.js'
 
 export function createAdminPermissionsRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
@@ -31,8 +32,8 @@ export function createAdminPermissionsRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: '/admin' },
-              { label: t('chrome.menu.permissions'), href: '/admin/permissions' },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              { label: t('chrome.menu.permissions'), href: getAdminRoutePath('permissions') },
             ]}
           />
           <AbilitiesInspector data={data} />

package/src/routes/create-admin-role-edit-route.tsx

@@ -19,6 +19,7 @@ import {
   listRegisteredAbilities,
 } from '../server-fns/admin-permissions/index.js'
 import { type AdminRoleResponse, getAdminRole } from '../server-fns/admin-roles/index.js'
+import { getAdminRoutePath } from './admin-path.js'
 
 interface LoaderData {
   role: AdminRoleResponse
@@ -62,9 +63,12 @@ export function createAdminRoleEditRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: '/admin' },
-              { label: t('chrome.menu.adminRoles'), href: '/admin/roles' },
-              { label: t('adminRoles.breadcrumbDetail'), href: `/admin/roles/${role.id}` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              { label: t('chrome.menu.adminRoles'), href: getAdminRoutePath('roles') },
+              {
+                label: t('adminRoles.breadcrumbDetail'),
+                href: getAdminRoutePath('roles', role.id),
+              },
             ]}
           />
           <Section className="py-5 pb-2">

package/src/routes/create-admin-roles-list-route.tsx

@@ -13,6 +13,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 { type AdminRoleListResponse, listAdminRoles } from '../server-fns/admin-roles/index.js'
+import { getAdminRoutePath } from './admin-path.js'
 
 export function createAdminRolesListRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
@@ -28,8 +29,8 @@ export function createAdminRolesListRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: '/admin' },
-              { label: t('chrome.menu.adminRoles'), href: '/admin/roles' },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              { label: t('chrome.menu.adminRoles'), href: getAdminRoutePath('roles') },
             ]}
           />
           <AdminRolesListView data={data} />

package/src/routes/create-admin-user-edit-route.tsx

@@ -19,6 +19,7 @@ import {
   getAdminUser,
   getUserRoles,
 } from '../server-fns/admin-users/index.js'
+import { getAdminRoutePath } from './admin-path.js'
 
 interface LoaderData {
   user: AdminUserResponse
@@ -79,9 +80,12 @@ export function createAdminUserEditRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: '/admin' },
-              { label: t('chrome.menu.adminUsers'), href: '/admin/users' },
-              { label: t('adminUsers.breadcrumbDetail'), href: `/admin/users/${user.id}` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              { label: t('chrome.menu.adminUsers'), href: getAdminRoutePath('users') },
+              {
+                label: t('adminUsers.breadcrumbDetail'),
+                href: getAdminRoutePath('users', user.id),
+              },
             ]}
           />
           <Section className="py-5 pb-2">

package/src/routes/create-admin-users-list-route.tsx

@@ -14,6 +14,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 { type AdminUserListResponse, listAdminUsers } from '../server-fns/admin-users/index.js'
+import { getAdminRoutePath } from './admin-path.js'
 
 const orderSchema = z.enum([
   'given_name',
@@ -72,8 +73,8 @@ export function createAdminUsersListRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: '/admin' },
-              { label: t('chrome.menu.adminUsers'), href: '/admin/users' },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              { label: t('chrome.menu.adminUsers'), href: getAdminRoutePath('users') },
             ]}
           />
           <AdminUsersListView data={data} />

package/src/routes/create-collection-api-route.tsx

@@ -16,7 +16,8 @@ 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 type { ContentLocaleOption } from '../admin-shell/collections/view-menu.js'
+import { getAdminRoutePath } from './admin-path.js'
+import { getContentLocaleRouteConfig } from './get-content-locale-route-config.js'
 
 const searchSchema = z.object({
   locale: z.string().optional(),
@@ -28,12 +29,7 @@ const searchSchema = z.object({
   depth: z.coerce.number().int().min(0).max(3).optional(),
 })
 
-interface CollectionApiOpts {
-  contentLocales: ReadonlyArray<ContentLocaleOption>
-  defaultContentLocale: string
-}
-
-export function createCollectionApiRoute(path: string, opts: CollectionApiOpts) {
+export function createCollectionApiRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
   const Route: any = createFileRoute(path as never)({
     validateSearch: searchSchema,
@@ -56,7 +52,8 @@ export function createCollectionApiRoute(path: string, opts: CollectionApiOpts)
       // 'all' is now always explicit in the URL when the user picks it.
       // No locale param means the user hasn't made a selection yet — default
       // to the content default locale (same as History and Edit behaviours).
-      const resolvedLocale = deps.locale ?? opts.defaultContentLocale
+      const { defaultContentLocale } = getContentLocaleRouteConfig()
+      const resolvedLocale = deps.locale ?? defaultContentLocale
       const data = await getCollectionDocument(
         params.collection,
         params.id,
@@ -79,20 +76,24 @@ export function createCollectionApiRoute(path: string, opts: CollectionApiOpts)
       const { locale, depth } = Route.useSearch() as z.infer<typeof searchSchema>
       const collectionDef = getCollectionDefinition(collection) as CollectionDefinition
       const { t } = useTranslation('byline-admin')
+      const { contentLocales, defaultContentLocale } = getContentLocaleRouteConfig()
 
       return (
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: `/admin` },
-              { label: collectionDef.labels.plural, href: `/admin/collections/${collection}` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              {
+                label: collectionDef.labels.plural,
+                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'),
               },
             ]}
           />
@@ -101,8 +102,8 @@ export function createCollectionApiRoute(path: string, opts: CollectionApiOpts)
             initialData={data}
             locale={locale}
             depth={depth}
-            contentLocales={opts.contentLocales}
-            defaultContentLocale={opts.defaultContentLocale}
+            contentLocales={contentLocales}
+            defaultContentLocale={defaultContentLocale}
           />
         </>
       )

package/src/routes/create-collection-create-route.tsx

@@ -18,6 +18,7 @@ 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'
 
 export function createCollectionCreateRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
@@ -49,11 +50,14 @@ export function createCollectionCreateRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: '/admin' },
-              { label: collectionDef.labels.plural, href: `/admin/collections/${collection}` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              {
+                label: collectionDef.labels.plural,
+                href: getAdminRoutePath('collections', collection),
+              },
               {
                 label: t('collections.breadcrumbs.create'),
-                href: `/admin/collections/${collection}/create`,
+                href: getAdminRoutePath('collections', collection, 'create'),
               },
             ]}
           />

package/src/routes/create-collection-edit-route.tsx

@@ -19,7 +19,8 @@ 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 type { ContentLocaleOption } from '../admin-shell/collections/view-menu.js'
+import { getAdminRoutePath } from './admin-path.js'
+import { getContentLocaleRouteConfig } from './get-content-locale-route-config.js'
 
 const searchSchema = z.object({
   locale: z.string().optional(),
@@ -27,12 +28,7 @@ const searchSchema = z.object({
   action: z.enum(['created']).optional(),
 })
 
-interface CollectionEditOpts {
-  contentLocales: ReadonlyArray<ContentLocaleOption>
-  defaultContentLocale: string
-}
-
-export function createCollectionEditRoute(path: string, opts: CollectionEditOpts) {
+export function createCollectionEditRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
   const Route: any = createFileRoute(path as never)({
     validateSearch: searchSchema,
@@ -82,6 +78,7 @@ export function createCollectionEditRoute(path: string, opts: CollectionEditOpts
       const { t } = useTranslation('byline-admin')
       const toastManager = useToastManager()
       const navigate = useNavigate()
+      const { contentLocales, defaultContentLocale } = getContentLocaleRouteConfig()
 
       // Post-create toast for the create → edit redirect (?action=created).
       // Ref-guarded for the same reason as the list route's created toast:
@@ -120,11 +117,14 @@ export function createCollectionEditRoute(path: string, opts: CollectionEditOpts
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: `/admin` },
-              { label: collectionDef.labels.plural, href: `/admin/collections/${collection}` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              {
+                label: collectionDef.labels.plural,
+                href: getAdminRoutePath('collections', collection),
+              },
               {
                 label: t('common.actions.edit'),
-                href: `/admin/collections/${collection}/${id}`,
+                href: getAdminRoutePath('collections', collection, id),
               },
             ]}
           />
@@ -133,8 +133,8 @@ export function createCollectionEditRoute(path: string, opts: CollectionEditOpts
             adminConfig={adminConfig ?? undefined}
             initialData={data}
             locale={locale}
-            contentLocales={opts.contentLocales}
-            defaultContentLocale={opts.defaultContentLocale}
+            contentLocales={contentLocales}
+            defaultContentLocale={defaultContentLocale}
           />
         </>
       )

package/src/routes/create-collection-history-route.tsx

@@ -24,7 +24,8 @@ import {
   getCollectionDocumentAuditLog,
   getCollectionDocumentHistory,
 } from '../server-fns/collections/index.js'
-import type { ContentLocaleOption } from '../admin-shell/collections/view-menu.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(),
@@ -43,12 +44,7 @@ const searchSchema = z.object({
 // than wiring a second, tab-specific pager into the shared history route.
 const AUDIT_LOG_PAGE_SIZE = 100
 
-interface CollectionHistoryOpts {
-  contentLocales: ReadonlyArray<ContentLocaleOption>
-  defaultContentLocale: string
-}
-
-export function createCollectionHistoryRoute(path: string, opts: CollectionHistoryOpts) {
+export function createCollectionHistoryRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
   const Route: any = createFileRoute(path as never)({
     validateSearch: searchSchema,
@@ -118,20 +114,24 @@ export function createCollectionHistoryRoute(path: string, opts: CollectionHisto
       const collectionDef = getCollectionDefinition(collection) as CollectionDefinition
       const adminConfig = getCollectionAdminConfig(collection)
       const { t } = useTranslation('byline-admin')
+      const { contentLocales, defaultContentLocale } = getContentLocaleRouteConfig()
 
       return (
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: `/admin` },
-              { label: collectionDef.labels.plural, href: `/admin/collections/${collection}` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
+              {
+                label: collectionDef.labels.plural,
+                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'),
               },
             ]}
           />
@@ -142,8 +142,8 @@ export function createCollectionHistoryRoute(path: string, opts: CollectionHisto
             data={history}
             auditLog={auditLog}
             currentDocument={currentDocument as Record<string, unknown> | null}
-            contentLocales={opts.contentLocales}
-            defaultContentLocale={opts.defaultContentLocale}
+            contentLocales={contentLocales}
+            defaultContentLocale={defaultContentLocale}
           />
         </>
       )

package/src/routes/create-collection-list-route.tsx

@@ -30,6 +30,7 @@ import {
   placeTreeNode,
   reorderCollectionDocument,
 } from '../server-fns/collections/index.js'
+import { getAdminRoutePath } from './admin-path.js'
 import type { CollectionTreeRow } from '../server-fns/collections/tree.js'
 
 const searchSchema = z.object({
@@ -167,10 +168,10 @@ export function createCollectionListRoute(path: string) {
         <>
           <BreadcrumbsClient
             breadcrumbs={[
-              { label: t('chrome.menu.dashboard'), href: `/admin` },
+              { label: t('chrome.menu.dashboard'), href: getAdminRoutePath() },
               {
                 label: data.included.collection.labels.plural,
-                href: `/admin/collections/${collection}`,
+                href: getAdminRoutePath('collections', collection),
               },
             ]}
           />

package/src/routes/create-sign-in-route.tsx

@@ -9,7 +9,7 @@
 /**
  * Sign-in page route factory.
  *
- * Lives outside the `/admin` subtree so the authenticated-admin layout
+ * Lives outside the configured admin subtree so the authenticated-admin layout
  * (and its `beforeLoad` guard) does not apply. Preserves a `callbackUrl`
  * query param so sign-ins triggered by the admin guard redirect back to
  * the originally-requested path.
@@ -21,6 +21,7 @@ import type { LocaleCode } from '@byline/i18n'
 
 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'
 
 interface SignInSearch {
   callbackUrl?: string
@@ -30,7 +31,7 @@ export function createSignInRoute(path: string) {
   // biome-ignore lint/suspicious/noExplicitAny: dynamic path bypasses route-tree typing
   const Route: any = createFileRoute(path as never)({
     validateSearch: (search: Record<string, unknown>): SignInSearch => {
-      const callbackUrl = typeof search.callbackUrl === 'string' ? search.callbackUrl : undefined
+      const callbackUrl = resolveAdminCallbackPath(search.callbackUrl)
       return { callbackUrl }
     },
     beforeLoad: async () => {
@@ -45,7 +46,12 @@ export function createSignInRoute(path: string) {
     component: function SignInRouteComponent() {
       const { callbackUrl } = Route.useSearch() as SignInSearch
       const { activeLocale } = Route.useRouteContext() as { activeLocale: LocaleCode }
-      return <SignInPage callbackUrl={callbackUrl} activeLocale={activeLocale} />
+      return (
+        <SignInPage
+          redirectTo={resolveAdminSignInRedirect(callbackUrl)}
+          activeLocale={activeLocale}
+        />
+      )
     },
   })
   return Route

package/src/routes/get-content-locale-route-config.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 { getClientConfig } from '@byline/core'
+
+import type { ContentLocaleOption } from '../admin-shell/collections/view-menu.js'
+
+export function getContentLocaleRouteConfig(): {
+  contentLocales: ContentLocaleOption[]
+  defaultContentLocale: string
+} {
+  const content = getClientConfig().i18n.content
+  const labels = new Map(
+    content.localeDefinitions?.map(({ code, nativeName }) => [code, nativeName]) ?? []
+  )
+
+  return {
+    contentLocales: content.locales.map((code) => ({ code, label: labels.get(code) ?? code })),
+    defaultContentLocale: content.defaultLocale,
+  }
+}

package/src/routes/index.ts

@@ -6,6 +6,16 @@
  * 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.
  *
@@ -14,6 +24,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/src/routes/sign-in-path.test.node.ts

@@ -0,0 +1,79 @@
+import { defineClientConfig } from '@byline/core'
+import { beforeEach, describe, expect, it } from 'vitest'
+
+import {
+  configureSignInRoutePath,
+  createSignInRoutePathResolver,
+  getSignInRoutePath,
+} from './sign-in-path.js'
+
+describe('sign-in route configuration', () => {
+  beforeEach(() => {
+    defineClientConfig({
+      serverURL: 'http://localhost:3000',
+      routes: { signIn: '/staff/login/' },
+      collections: [],
+      admin: [],
+      i18n: {
+        interface: { defaultLocale: 'en', locales: [] },
+        content: { defaultLocale: 'en', locales: [] },
+      },
+    })
+  })
+
+  it('reads and normalizes routes.signIn', () => {
+    expect(getSignInRoutePath()).toBe('/staff/login')
+  })
+
+  it('allows a deprecated signInPath override when it matches canonical config', () => {
+    expect(configureSignInRoutePath('staff/login/')).toBe('/staff/login')
+  })
+
+  it('rejects an invalid or divergent deprecated override when resolved', () => {
+    expect(() => configureSignInRoutePath('/auth/login/')).toThrow(/must match routes\.signIn/)
+    expect(() => configureSignInRoutePath('/auth/../login')).toThrow(/routes\.signIn/)
+  })
+
+  it('validates an override against configured rather than default route trees', () => {
+    defineClientConfig({
+      serverURL: 'http://localhost:3000',
+      routes: { admin: '/cms', api: '/rpc', signIn: '/admin/login' },
+      collections: [],
+      admin: [],
+      i18n: {
+        interface: { defaultLocale: 'en', locales: [] },
+        content: { defaultLocale: 'en', locales: [] },
+      },
+    })
+
+    expect(configureSignInRoutePath('/admin/login/')).toBe('/admin/login')
+    expect(() => configureSignInRoutePath('/cms/login')).toThrow(/routes\.signIn/)
+  })
+
+  it('defers a deprecated override until parent beforeLoad config registration', () => {
+    defineClientConfig({
+      serverURL: 'http://localhost:3000',
+      routes: { signIn: '/old/login' },
+      collections: [],
+      admin: [],
+      i18n: {
+        interface: { defaultLocale: 'en', locales: [] },
+        content: { defaultLocale: 'en', locales: [] },
+      },
+    })
+    const resolveSignInPath = createSignInRoutePathResolver('/staff/login/')
+
+    defineClientConfig({
+      serverURL: 'http://localhost:3000',
+      routes: { signIn: '/staff/login' },
+      collections: [],
+      admin: [],
+      i18n: {
+        interface: { defaultLocale: 'en', locales: [] },
+        content: { defaultLocale: 'en', locales: [] },
+      },
+    })
+
+    expect(resolveSignInPath()).toBe('/staff/login')
+  })
+})

package/src/routes/sign-in-path.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 { getClientConfig, resolveRoutes } from '@byline/core'
+
+/** Read the canonical client-safe sign-in destination. */
+export function getSignInRoutePath(): string {
+  return getClientConfig().routes.signIn
+}
+
+/** @deprecated Configure `routes.signIn`; retained for route-factory input validation. */
+export function configureSignInRoutePath(legacyOverride?: string): string {
+  const routes = getClientConfig().routes
+  const configured = routes.signIn
+  if (legacyOverride === undefined) 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
+}
+
+/** Defer deprecated override validation until the admin route's beforeLoad boundary. */
+export function createSignInRoutePathResolver(legacyOverride?: string): () => string {
+  return legacyOverride === undefined
+    ? getSignInRoutePath
+    : () => configureSignInRoutePath(legacyOverride)
+}