@byline/host-tanstack-start 4.15.0 → 4.17.0

package/dist/integrations/api-utils.d.ts

@@ -10,8 +10,8 @@
  * of our API and used only for development.
  * We'll extract a properly configured API server soon.
  */
-import type { CollectionDefinition } from '@byline/core';
-export interface EnsuredCollection {
+import type { CollectionDefinition, MultiCollectionDefinition } from '@byline/core';
+export interface EnsuredDocumentResource {
     definition: CollectionDefinition;
     collection: {
         id: string;
@@ -20,14 +20,28 @@ export interface EnsuredCollection {
         schemaHash: string;
     };
 }
+export interface EnsuredCollection extends EnsuredDocumentResource {
+    definition: MultiCollectionDefinition;
+}
 /**
- * Resolve a collection for an admin API request.
+ * Resolve either registered document-resource kind against the reconciled
+ * collection record.
  *
  * Collections are reconciled with the database once at startup by
  * `initBylineCore()` (see `packages/core/src/services/collection-bootstrap.ts`).
  * This helper is a per-request cache lookup against the resulting in-memory
  * registry — no DB I/O, no hash work.
  *
- * Returns `null` when the path is not registered in the client/server config.
+ * This broader seam is reserved for operations such as field upload whose core
+ * service is explicitly kind-aware; collection route families continue to use
+ * `ensureCollection` below.
+ */
+export declare function ensureDocumentResource(path: string): Promise<EnsuredDocumentResource | null>;
+/**
+ * Narrow the shared document-resource resolution to a multi-document
+ * collection for a collection-scoped admin API request.
+ *
+ * Returns `null` when the path is unregistered or belongs to a singleton, so
+ * collection route families cannot accidentally admit the other resource kind.
  */
 export declare function ensureCollection(path: string): Promise<EnsuredCollection | null>;

package/dist/integrations/api-utils.js

@@ -1,6 +1,6 @@
-import { getCollectionDefinition } from "@byline/core";
+import { getCollectionDefinition, isSingleton } from "@byline/core";
 import { bylineCore } from "./byline-core.js";
-async function ensureCollection(path) {
+async function ensureDocumentResource(path) {
     const definition = getCollectionDefinition(path);
     if (null == definition) return null;
     let record;
@@ -19,4 +19,11 @@ async function ensureCollection(path) {
         }
     };
 }
-export { ensureCollection };
+async function ensureCollection(path) {
+    const resource = await ensureDocumentResource(path);
+    return null == resource || isSingleton(resource.definition) ? null : {
+        ...resource,
+        definition: resource.definition
+    };
+}
+export { ensureCollection, ensureDocumentResource };

package/dist/integrations/serve-analytics-agent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 function serveAnalyticsAgent(): Response;

package/dist/integrations/serve-analytics-agent.js

@@ -0,0 +1,11 @@
+import { ANALYTICS_AGENT_SOURCE } from "@byline/analytics-agent/source";
+function serveAnalyticsAgent() {
+    return new Response(ANALYTICS_AGENT_SOURCE, {
+        headers: {
+            'cache-control': 'public, max-age=3600, must-revalidate',
+            'content-type': "text/javascript; charset=utf-8",
+            'x-content-type-options': 'nosniff'
+        }
+    });
+}
+export { serveAnalyticsAgent };

package/dist/routes/analytics-range.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { AnalyticsDashboardPeriod } from '@byline/admin/analytics';
+export declare function buildAnalyticsDashboardRange(period: AnalyticsDashboardPeriod, now?: Date, earliestReportDay?: string | null): {
+    from: string;
+    to: string;
+};

package/dist/routes/analytics-range.js

@@ -0,0 +1,35 @@
+const UTC_DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/u;
+function buildAnalyticsDashboardRange(period, now = new Date(), earliestReportDay = null) {
+    const to = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+    if ('ytd' === period) return {
+        from: formatUtcDay(new Date(Date.UTC(to.getUTCFullYear(), 0, 1))),
+        to: formatUtcDay(to)
+    };
+    if ('all' === period) {
+        const toDay = formatUtcDay(to);
+        const earliest = null == earliestReportDay ? toDay : assertUtcDay(earliestReportDay);
+        return {
+            from: earliest <= toDay ? earliest : toDay,
+            to: toDay
+        };
+    }
+    const from = new Date(to);
+    from.setUTCDate(from.getUTCDate() - (period - 1));
+    return {
+        from: formatUtcDay(from),
+        to: formatUtcDay(to)
+    };
+}
+function formatUtcDay(value) {
+    const year = value.getUTCFullYear().toString().padStart(4, '0');
+    const month = (value.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = value.getUTCDate().toString().padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+function assertUtcDay(value) {
+    if (!UTC_DAY_PATTERN.test(value)) throw new Error('analytics report day must use YYYY-MM-DD');
+    const date = new Date(`${value}T00:00:00.000Z`);
+    if (!Number.isFinite(date.valueOf()) || formatUtcDay(date) !== value) throw new Error('analytics report day must be a real UTC calendar day');
+    return value;
+}
+export { buildAnalyticsDashboardRange };

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

@@ -0,0 +1,8 @@
+/**
+ * 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 function createAdminAnalyticsRoute(path: string): any;

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

@@ -0,0 +1,108 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createFileRoute, notFound } from "@tanstack/react-router";
+import { AnalyticsDashboard } from "@byline/admin/analytics/components/dashboard";
+import { isAnalyticsDashboardPeriod } from "@byline/analytics/config";
+import { useTranslation } from "@byline/i18n/react";
+import { z } from "zod";
+import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
+import { useNavigate } from "../admin-shell/chrome/loose-router.js";
+import { getAnalyticsCountries, getAnalyticsReferrers, getAnalyticsReportCoverage, getAnalyticsRuntime, getAnalyticsSummary, getAnalyticsTop } from "../server-fns/analytics/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
+import { buildAnalyticsDashboardRange } from "./analytics-range.js";
+const periodSchema = z.preprocess((value)=>{
+    if (null == value) return;
+    if ('ytd' === value || 'all' === value) return value;
+    return Number(value);
+}, z.custom((value)=>isAnalyticsDashboardPeriod(value)).optional());
+const searchSchema = z.object({
+    period: periodSchema.catch(void 0)
+});
+function createAdminAnalyticsRoute(path) {
+    const Route = createFileRoute(path)({
+        validateSearch: searchSchema,
+        loaderDeps: ({ search })=>({
+                period: search.period ?? 30
+            }),
+        loader: async ({ deps })=>{
+            const runtime = await getAnalyticsRuntime();
+            if (!runtime.enabled) throw notFound();
+            const coverage = await getAnalyticsReportCoverage();
+            const range = buildAnalyticsDashboardRange(deps.period, new Date(), coverage.summaryFrom);
+            const [summary, pages, downloads, referrers, countries] = await Promise.all([
+                getAnalyticsSummary({
+                    data: range
+                }),
+                getAnalyticsTop({
+                    data: {
+                        ...range,
+                        kind: 'page',
+                        limit: 20
+                    }
+                }),
+                getAnalyticsTop({
+                    data: {
+                        ...range,
+                        kind: 'download',
+                        limit: 20
+                    }
+                }),
+                getAnalyticsReferrers({
+                    data: {
+                        ...range,
+                        limit: 20
+                    }
+                }),
+                getAnalyticsCountries({
+                    data: range
+                })
+            ]);
+            return {
+                data: {
+                    summary,
+                    pages,
+                    downloads,
+                    referrers,
+                    countries,
+                    range,
+                    coverage
+                },
+                period: deps.period
+            };
+        },
+        component: function() {
+            const { data, period } = Route.useLoaderData();
+            const navigate = useNavigate();
+            const { t } = useTranslation('byline-admin');
+            return /*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    /*#__PURE__*/ jsx(BreadcrumbsClient, {
+                        breadcrumbs: [
+                            {
+                                label: t('chrome.menu.dashboard'),
+                                href: getAdminRoutePath()
+                            },
+                            {
+                                label: t('analytics.title'),
+                                href: getAdminRoutePath('analytics')
+                            }
+                        ]
+                    }),
+                    /*#__PURE__*/ jsx(AnalyticsDashboard, {
+                        data: data,
+                        period: period,
+                        onPeriodChange: (nextPeriod)=>{
+                            navigate({
+                                to: getAdminRoutePath('analytics'),
+                                search: {
+                                    period: nextPeriod
+                                }
+                            });
+                        }
+                    })
+                ]
+            });
+        }
+    });
+    return Route;
+}
+export { createAdminAnalyticsRoute };

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

@@ -1,6 +1,6 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createFileRoute } from "@tanstack/react-router";
-import { filterReadableCollections, getAdminConfig } from "@byline/core";
+import { filterReadableCollections, getAdminConfig, isSingleton } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { AdminDashboard } from "../admin-shell/chrome/dashboard.js";
@@ -15,7 +15,7 @@ function createAdminDashboardRoute(path) {
                 abilities: context.user.abilities
             });
             const statsMap = {};
-            await Promise.all(visible.filter((c)=>true === c.showStats).map(async (c)=>{
+            await Promise.all(visible.filter((resource)=>!isSingleton(resource) && true === resource.showStats).map(async (c)=>{
                 try {
                     statsMap[c.path] = await getCollectionStats(c.path);
                 } catch  {

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

@@ -18,6 +18,7 @@ import { buildLocaleDefinitions } from "../i18n/locale-definitions.js";
 import { bylineAdminServices } from "../integrations/byline-admin-services.js";
 import { BylineAiAdminProvider } from "../integrations/byline-ai.js";
 import { bylineFieldServices } from "../integrations/byline-field-services.js";
+import { getAnalyticsRuntime } from "../server-fns/analytics/index.js";
 import { getCurrentAdminUser } from "../server-fns/auth/index.js";
 import { getScheduledPublicationRuntime } from "../server-fns/collections/index.js";
 import { getActiveLocaleFn, setAdminLocaleFn } from "../server-fns/i18n/index.js";
@@ -28,12 +29,16 @@ function createAdminLayoutRoute(path) {
             const signInPath = getSignInRoutePath();
             try {
                 const user = await getCurrentAdminUser();
-                const activeLocale = await getActiveLocaleFn();
-                const scheduledPublicationRuntime = await getScheduledPublicationRuntime();
+                const [activeLocale, scheduledPublicationRuntime, analyticsRuntime] = await Promise.all([
+                    getActiveLocaleFn(),
+                    getScheduledPublicationRuntime(),
+                    getAnalyticsRuntime()
+                ]);
                 return {
                     user,
                     activeLocale,
-                    scheduledPublicationRuntime
+                    scheduledPublicationRuntime,
+                    analyticsRuntime
                 };
             } catch  {
                 throw redirect({
@@ -45,7 +50,7 @@ function createAdminLayoutRoute(path) {
             }
         },
         component: function() {
-            const { user, activeLocale, scheduledPublicationRuntime } = Route.useRouteContext();
+            const { user, activeLocale, scheduledPublicationRuntime, analyticsRuntime } = Route.useRouteContext();
             const { i18n } = getAdminConfig();
             const localeDefinitions = buildLocaleDefinitions(i18n.admin.locales, i18n.admin.localeDefinitions);
             useEffect(()=>{
@@ -80,6 +85,7 @@ function createAdminLayoutRoute(path) {
                                         className: clsx('byline-admin-layout-main', admin_layout_module.main),
                                         children: [
                                             /*#__PURE__*/ jsx(AdminMenuDrawer, {
+                                                analyticsEnabled: analyticsRuntime.enabled,
                                                 scheduledPublicationEnabled: scheduledPublicationRuntime.enabled
                                             }),
                                             /*#__PURE__*/ jsx(Content, {

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

@@ -1,6 +1,5 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createFileRoute, notFound } from "@tanstack/react-router";
-import { getCollectionDefinition } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { z } from "zod";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
@@ -8,6 +7,7 @@ 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";
+import { getMultiCollectionDefinition } from "./get-multi-collection-definition.js";
 const searchSchema = z.object({
     locale: z.string().optional(),
     depth: z.coerce.number().int().min(0).max(3).optional()
@@ -20,7 +20,7 @@ function createCollectionApiRoute(path) {
                 depth: search.depth
             }),
         loader: async ({ params, deps })=>{
-            const collectionDef = getCollectionDefinition(params.collection);
+            const collectionDef = getMultiCollectionDefinition(params.collection);
             if (!collectionDef) throw notFound();
             const { defaultContentLocale } = getContentLocaleRouteConfig();
             const resolvedLocale = deps.locale ?? defaultContentLocale;
@@ -35,7 +35,7 @@ function createCollectionApiRoute(path) {
             const data = Route.useLoaderData();
             const { collection, id } = Route.useParams();
             const { locale, depth } = Route.useSearch();
-            const collectionDef = getCollectionDefinition(collection);
+            const collectionDef = getMultiCollectionDefinition(collection);
             const { t } = useTranslation('byline-admin');
             const { contentLocales, defaultContentLocale } = getContentLocaleRouteConfig();
             return /*#__PURE__*/ jsxs(Fragment, {

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

@@ -1,11 +1,12 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createFileRoute, notFound } from "@tanstack/react-router";
-import { buildInitialDataFromFields, getCollectionAdminConfig, getCollectionDefinition } from "@byline/core";
+import { buildInitialDataFromFields, getCollectionAdminConfig } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { z } from "zod";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
 import { CreateView } from "../admin-shell/collections/create.js";
 import { getAdminRoutePath } from "./admin-path.js";
+import { getMultiCollectionDefinition } from "./get-multi-collection-definition.js";
 const searchSchema = z.object({
     from: z.string().optional()
 });
@@ -13,7 +14,7 @@ function createCollectionCreateRoute(path) {
     const Route = createFileRoute(path)({
         validateSearch: searchSchema,
         loader: async ({ params })=>{
-            const collectionDef = getCollectionDefinition(params.collection);
+            const collectionDef = getMultiCollectionDefinition(params.collection);
             if (!collectionDef) throw notFound();
             const initialData = await buildInitialDataFromFields(collectionDef.fields, {
                 data: {},
@@ -26,7 +27,7 @@ function createCollectionCreateRoute(path) {
         component: function() {
             const { collection } = Route.useParams();
             const { initialData } = Route.useLoaderData();
-            const collectionDef = getCollectionDefinition(collection);
+            const collectionDef = getMultiCollectionDefinition(collection);
             const adminConfig = getCollectionAdminConfig(collection);
             const { t } = useTranslation('byline-admin');
             const search = Route.useSearch();

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

@@ -1,7 +1,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { createFileRoute, notFound } from "@tanstack/react-router";
-import { getCollectionAdminConfig, getCollectionDefinition } from "@byline/core";
+import { getCollectionAdminConfig } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { useToastManager } from "@byline/ui/react";
 import { z } from "zod";
@@ -11,6 +11,7 @@ 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";
+import { getMultiCollectionDefinition } from "./get-multi-collection-definition.js";
 import { decodeListReturnState } from "./list-return-state.js";
 import { persistListReturnState, readListReturnState } from "./list-return-storage.js";
 const searchSchema = z.object({
@@ -27,7 +28,7 @@ function createCollectionEditRoute(path) {
                 locale: search.locale
             }),
         loader: async ({ params, deps })=>{
-            const collectionDef = getCollectionDefinition(params.collection);
+            const collectionDef = getMultiCollectionDefinition(params.collection);
             if (!collectionDef) throw notFound();
             const data = await getCollectionDocument(params.collection, params.id, deps.locale, void 0, true);
             if (!data) throw notFound();
@@ -41,7 +42,7 @@ function createCollectionEditRoute(path) {
             const { collection, id } = Route.useParams();
             const search = Route.useSearch();
             const { locale } = search;
-            const collectionDef = getCollectionDefinition(collection);
+            const collectionDef = getMultiCollectionDefinition(collection);
             const adminConfig = getCollectionAdminConfig(collection);
             const { t } = useTranslation('byline-admin');
             const toastManager = useToastManager();

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

@@ -1,6 +1,6 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createFileRoute, notFound } from "@tanstack/react-router";
-import { getCollectionAdminConfig, getCollectionDefinition, getWorkflowStatuses } from "@byline/core";
+import { getCollectionAdminConfig, getWorkflowStatuses } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { z } from "zod";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
@@ -8,6 +8,7 @@ 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";
+import { getMultiCollectionDefinition } from "./get-multi-collection-definition.js";
 const searchSchema = z.object({
     page: z.coerce.number().min(1).optional(),
     page_size: z.coerce.number().max(100).optional(),
@@ -31,7 +32,7 @@ function createCollectionHistoryRoute(path) {
                 locale: search.locale
             }),
         loader: async ({ params, deps })=>{
-            const collectionDef = getCollectionDefinition(params.collection);
+            const collectionDef = getMultiCollectionDefinition(params.collection);
             if (!collectionDef) throw notFound();
             const [history, currentDocument, auditLog] = await Promise.all([
                 getCollectionDocumentHistory({
@@ -71,7 +72,7 @@ function createCollectionHistoryRoute(path) {
         component: function() {
             const { history, currentDocument, auditLog } = Route.useLoaderData();
             const { collection } = Route.useParams();
-            const collectionDef = getCollectionDefinition(collection);
+            const collectionDef = getMultiCollectionDefinition(collection);
             const adminConfig = getCollectionAdminConfig(collection);
             const { t } = useTranslation('byline-admin');
             const { contentLocales, defaultContentLocale } = getContentLocaleRouteConfig();

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

@@ -2,7 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef } from "react";
 import { createFileRoute, notFound } from "@tanstack/react-router";
 import { applyRelationColumnFormatters } from "@byline/admin/react";
-import { getCollectionAdminConfig, getCollectionDefinition, getWorkflowStatuses } from "@byline/core";
+import { getCollectionAdminConfig, getWorkflowStatuses } from "@byline/core";
 import { useTranslation } from "@byline/i18n/react";
 import { useToastManager } from "@byline/ui/react";
 import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
@@ -11,6 +11,7 @@ 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";
+import { getMultiCollectionDefinition } from "./get-multi-collection-definition.js";
 import { collectionListSearchSchema } from "./list-return-state.js";
 function createCollectionListRoute(path) {
     const Route = createFileRoute(path)({
@@ -25,7 +26,7 @@ function createCollectionListRoute(path) {
                 status: search.status
             }),
         loader: async ({ params, deps })=>{
-            const collectionDef = getCollectionDefinition(params.collection);
+            const collectionDef = getMultiCollectionDefinition(params.collection);
             if (!collectionDef) throw notFound();
             if (true === collectionDef.tree) return await getCollectionTree({
                 data: {
@@ -59,7 +60,7 @@ function createCollectionListRoute(path) {
             const { collection } = Route.useParams();
             const search = Route.useSearch();
             const navigate = useNavigate();
-            const collectionDef = getCollectionDefinition(collection);
+            const collectionDef = getMultiCollectionDefinition(collection);
             const adminConfig = getCollectionAdminConfig(collection);
             const columns = applyRelationColumnFormatters(adminConfig?.columns || [], collectionDef);
             const workflowStatuses = getWorkflowStatuses(collectionDef);

package/dist/routes/create-singleton-history-route.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 function createSingletonHistoryRoute(path: string): any;

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

@@ -0,0 +1,99 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { createFileRoute, notFound } from "@tanstack/react-router";
+import { getSingletonAdminConfig, getWorkflowStatuses } from "@byline/core";
+import { useTranslation } from "@byline/i18n/react";
+import { z } from "zod";
+import { BreadcrumbsClient } from "../admin-shell/chrome/breadcrumbs/breadcrumbs-client.js";
+import { SingletonHistoryView } from "../admin-shell/singletons/history.js";
+import { getSingleton, getSingletonHistory } from "../server-fns/singletons/index.js";
+import { getAdminRoutePath } from "./admin-path.js";
+import { getContentLocaleRouteConfig } from "./get-content-locale-route-config.js";
+import { getSingletonDefinition } from "./get-singleton-definition.js";
+const searchSchema = z.object({
+    page: z.coerce.number().min(1).optional(),
+    page_size: z.coerce.number().max(100).optional(),
+    order: z.string().optional(),
+    desc: z.coerce.boolean().optional(),
+    locale: z.string().optional()
+});
+function createSingletonHistoryRoute(path) {
+    const Route = createFileRoute(path)({
+        validateSearch: searchSchema,
+        loaderDeps: ({ search })=>({
+                page: search.page,
+                page_size: search.page_size,
+                order: search.order,
+                desc: search.desc,
+                locale: search.locale
+            }),
+        loader: async ({ params, deps })=>{
+            if (null == getSingletonDefinition(params.singleton)) throw notFound();
+            const [history, currentDocument] = await Promise.all([
+                getSingletonHistory({
+                    data: {
+                        singleton: params.singleton,
+                        params: {
+                            page: deps.page,
+                            page_size: deps.page_size,
+                            order: deps.order,
+                            desc: deps.desc,
+                            locale: deps.locale
+                        }
+                    }
+                }),
+                getSingleton({
+                    data: {
+                        singleton: params.singleton,
+                        locale: deps.locale ?? 'all'
+                    }
+                })
+            ]);
+            return {
+                history,
+                currentDocument
+            };
+        },
+        staleTime: 0,
+        gcTime: 0,
+        shouldReload: true,
+        component: function() {
+            const { history, currentDocument } = Route.useLoaderData();
+            const { singleton } = Route.useParams();
+            const definition = getSingletonDefinition(singleton);
+            if (null == definition) throw notFound();
+            const { t } = useTranslation('byline-admin');
+            const { contentLocales, defaultContentLocale } = getContentLocaleRouteConfig();
+            return /*#__PURE__*/ jsxs(Fragment, {
+                children: [
+                    /*#__PURE__*/ jsx(BreadcrumbsClient, {
+                        breadcrumbs: [
+                            {
+                                label: t('chrome.menu.dashboard'),
+                                href: getAdminRoutePath()
+                            },
+                            {
+                                label: definition.label,
+                                href: getAdminRoutePath('singletons', singleton)
+                            },
+                            {
+                                label: t('collections.breadcrumbs.history'),
+                                href: getAdminRoutePath('singletons', singleton, 'history')
+                            }
+                        ]
+                    }),
+                    /*#__PURE__*/ jsx(SingletonHistoryView, {
+                        singletonDefinition: definition,
+                        adminConfig: getSingletonAdminConfig(singleton) ?? void 0,
+                        data: history,
+                        currentDocument: currentDocument,
+                        contentLocales: contentLocales,
+                        defaultContentLocale: defaultContentLocale,
+                        workflowStatuses: getWorkflowStatuses(definition)
+                    })
+                ]
+            });
+        }
+    });
+    return Route;
+}
+export { createSingletonHistoryRoute };

package/dist/routes/create-singleton-route.d.ts

@@ -0,0 +1,35 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { DocumentPublishScheduleInfo } from '@byline/client';
+/**
+ * Load the mapped singleton document and attach the admin-only lifecycle
+ * metadata consumed by the editor. Keeping this composition in the route
+ * layer leaves ordinary singleton reads free of publication timing and actor
+ * capability details.
+ */
+export declare const getSingletonRouteDocument: import("@tanstack/react-start").RequiredFetcher<undefined, (input: {
+    singleton: string;
+    locale?: string;
+}) => {
+    singleton: string;
+    locale?: string;
+}, Promise<{
+    document: null;
+    initialData: Record<string, any>;
+} | {
+    document: {
+        _publishedVersion: Record<string, any> | null;
+        _scheduledPublicationEnabled: boolean;
+        _canSchedulePublication: boolean;
+        _scheduledPublish: DocumentPublishScheduleInfo | null;
+        scheduledPublishAt?: Date | undefined;
+        scheduledPublishVersionId?: string | undefined;
+    };
+    initialData: undefined;
+} | null>>;
+export declare function createSingletonRoute(path: string): any;