@byline/cli 3.20.4 → 4.0.0

package/dist/templates/byline/admin.config.ts

@@ -8,20 +8,21 @@
 
 /**
  * Registers Byline's client-side config (collection admin UI configs,
- * field editors, i18n, routes) in the current module graph. Imported as
- * a side-effect from `src/routes/_byline/route.lazy.tsx` so registration
- * fires only when a `_byline/*` URL matches — keeping the Lexical
- * editor module graph out of public-route bundles entirely.
+ * field editors, i18n, routes) in the current module graph. The `_byline`
+ * route registers it from two complementary points: a dynamic import in
+ * `route.tsx` covers child loaders, while the side-effect import in
+ * `route.lazy.tsx` covers component render and initial hydration. Keeping
+ * both imports behind `_byline/*` keeps the admin graph off public routes.
  *
  * This is the minimal scaffold: no example collections registered. Add
- * collection schemas + admin configs to the `collections` and `admin`
- * arrays as you create them.
+ * schemas to `collections/index.ts` and presentation configs to `admin`.
  */
 
 import type { ClientConfig } from '@byline/core'
 import { defineClientConfig } from '@byline/core'
 import { RichTextField as LexicalRichTextField } from '@byline/richtext-lexical'
 
+import { collections } from './collections/index.js'
 import { i18n } from './i18n.js'
 import { DEFAULT_SERVER_URL, routes } from './routes.js'
 
@@ -31,7 +32,7 @@ export const config: ClientConfig = {
   serverURL,
   i18n,
   routes,
-  collections: [],
+  collections,
   admin: [],
   fields: {
     richText: { editor: LexicalRichTextField },

package/dist/templates/byline/clients.server.ts

@@ -0,0 +1,77 @@
+/**
+ * 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
+ */
+
+/**
+ * Typed, server-only access to this application's Byline clients.
+ *
+ * ```text
+ * generated/collection-types.ts
+ *   `CollectionFieldsByPath`
+ *              |
+ *              v
+ * collections/index.ts --------------------.
+ *   `BylineCollections`                    |
+ *                                          v
+ * @byline/host-tanstack-start ------> clients.server.ts
+ *   runtime client getters             |
+ *                                      v
+ *                           typed `get*BylineClient()` getters
+ * ```
+ *
+ * Why this boundary exists:
+ *
+ * The TanStack host owns the runtime admin, public, system, and viewer client
+ * singletons. It intentionally knows nothing about an application's collection
+ * schemas, so its getters cannot provide application-specific collection paths
+ * and field shapes. The generated `CollectionFieldsByPath` registry is exported
+ * as `BylineCollections` by `collections/index.ts`; this module joins the host
+ * getters and app registry once instead of repeating a type assertion at every
+ * server call site.
+ *
+ * Typical server usage:
+ *
+ * ```ts
+ * const publicClient = getPublicBylineClient() // anonymous published reads
+ * const viewerClient = getViewerBylineClient() // public or admin-preview reads
+ * const adminClient = getAdminBylineClient() // current admin request authority
+ * const systemClient = getSystemBylineClient() // trusted hooks and maintenance
+ * ```
+ *
+ * Calls to `client.collection('<collection-path>')` are therefore checked
+ * against this application's generated registry and return that collection's
+ * canonical generated field shape. `collection-types.contract.ts` separately
+ * proves that those generated shapes match the runtime schemas exactly.
+ *
+ * The `.server.ts` suffix is intentional. Import these getters only from server
+ * routes, loaders, actions, scripts, or lifecycle-hook modules; browser code
+ * must not cross this boundary.
+ *
+ * This module does not create client singletons, generate collection types, or
+ * configure the host. It only applies the app-specific client type and
+ * re-exports the host-owned getters (plus the viewer preview-state helper).
+ */
+import type { BylineClient } from '@byline/client'
+import {
+  getAdminBylineClient as getHostAdminBylineClient,
+  getSystemBylineClient as getHostSystemBylineClient,
+} from '@byline/host-tanstack-start/integrations/byline-client'
+import { getPublicBylineClient as getHostPublicBylineClient } from '@byline/host-tanstack-start/integrations/byline-public-client'
+import {
+  getViewerBylineClient as getHostViewerBylineClient,
+  isPreviewActive,
+} from '@byline/host-tanstack-start/integrations/byline-viewer-client'
+
+import type { BylineCollections } from './collections/index.js'
+
+type AppBylineClient = BylineClient<BylineCollections>
+
+export const getAdminBylineClient = getHostAdminBylineClient as () => AppBylineClient
+export const getPublicBylineClient = getHostPublicBylineClient as () => AppBylineClient
+export const getSystemBylineClient = getHostSystemBylineClient as () => AppBylineClient
+export const getViewerBylineClient = getHostViewerBylineClient as () => AppBylineClient
+export { isPreviewActive }

package/dist/templates/byline/collection-types.contract.ts

@@ -0,0 +1,67 @@
+/**
+ * Compile-time contract between this application's collection schemas and its
+ * generated collection-type projection.
+ *
+ * ```text
+ * collections/index.ts                  generated/collection-types.ts
+ *   `typeof collections`                 `CollectionFields*ByPath`
+ *            |                                      |
+ *            v                                      v
+ *    inferred registry ----------- Exact -------- generated registry
+ *                                    |
+ *                                    v
+ *                         TypeScript error on drift
+ * ```
+ *
+ * The generated file is deliberately a standalone projection for typed clients
+ * and frontend code; it does not import the runtime schemas. This module joins
+ * those two app-owned sources at compile time and requires their collection
+ * keys, ordinary field shapes, and all-locale field shapes to match exactly.
+ *
+ * This file has no runtime behavior. Keep it application-owned: `@byline/core`
+ * provides the inference and code-generation machinery, but only this
+ * application knows its concrete collection tuple and generated output.
+ */
+
+import type { CollectionFieldData, CollectionFieldDataAllLocales } from '@byline/core'
+
+import type { collections } from './collections/index.js'
+import type {
+  CollectionFieldsAllLocalesByPath,
+  CollectionFieldsByPath,
+} from './generated/collection-types.js'
+
+type InferredFieldsByPath = {
+  [Definition in (typeof collections)[number] as Definition['path']]: CollectionFieldData<Definition>
+}
+
+type InferredFieldsAllLocalesByPath = {
+  [Definition in (typeof collections)[number] as Definition['path']]: CollectionFieldDataAllLocales<Definition>
+}
+
+type IsAny<Value> = 0 extends 1 & Value ? true : false
+type Exact<Left, Right> = IsAny<Left> extends true
+  ? IsAny<Right>
+  : IsAny<Right> extends true
+    ? false
+    : (<Value>() => Value extends Left ? 1 : 2) extends <Value>() =>
+          Value extends Right ? 1 : 2
+      ? (<Value>() => Value extends Right ? 1 : 2) extends <Value>() =>
+          Value extends Left ? 1 : 2
+        ? true
+        : false
+      : false
+type Assert<Value extends true> = Value
+
+type GeneratedKeysMatchRuntimeRegistry = Assert<
+  Exact<keyof CollectionFieldsByPath, keyof InferredFieldsByPath>
+>
+type GeneratedFieldsMatchRuntimeRegistry = Assert<
+  Exact<CollectionFieldsByPath, InferredFieldsByPath>
+>
+type GeneratedAllLocalesKeysMatchRuntimeRegistry = Assert<
+  Exact<keyof CollectionFieldsAllLocalesByPath, keyof InferredFieldsAllLocalesByPath>
+>
+type GeneratedAllLocalesFieldsMatchRuntimeRegistry = Assert<
+  Exact<CollectionFieldsAllLocalesByPath, InferredFieldsAllLocalesByPath>
+>

package/dist/templates/byline/collections/index.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 { InferCollectionRegistry } from '@byline/core'
+
+import type { CollectionFieldsByPath } from '../generated/collection-types.js'
+
+/** Add schema-only collection imports here; keep admin presentation separate. */
+export const collections = [] as const
+
+export type InferredBylineCollections = InferCollectionRegistry<typeof collections>
+export type BylineCollections = CollectionFieldsByPath

package/dist/templates/byline/collections/server-hooks.ts

@@ -0,0 +1,7 @@
+/** Server-only lifecycle hook registry. Imported only by server.config.ts. */
+import type { ServerHooksConfig } from '@byline/core'
+
+export const serverHooks = {
+  collections: {},
+  uploads: {},
+} satisfies ServerHooksConfig

package/dist/templates/byline/generated/collection-types.ts

@@ -0,0 +1,11 @@
+// Generated by @byline/core/codegen
+// Format version: 1
+// Hash: 4ef42b796dc35fceb394f97eaef885c5795c52031ba91f9ca6ca7e0fd2f20608
+
+export type CollectionFieldsByPath = {
+}
+
+export type CollectionFieldsAllLocalesByPath = {
+}
+
+export type CollectionPath = keyof CollectionFieldsByPath

package/dist/templates/byline/i18n.ts

@@ -12,9 +12,9 @@
  * translation bundle.
  *
  * The locale arrays themselves live in `./locales.ts`, a dependency-free leaf
- * module, so the public frontend can import them without pulling in the admin
- * translation graph this file depends on. Re-exported here for back-compat
- * with existing `~/i18n` importers.
+ * module exposed to public frontend code by `./public.ts`, without pulling in
+ * the admin translation graph this file depends on. Re-exported here for
+ * back-compat with existing `~/i18n` importers.
  *
  * `interface` locales govern the CMS admin UI language.
  * `content` locales govern the languages a document can be published in.

package/dist/templates/byline/locales.ts

@@ -12,12 +12,12 @@
  * registry). `byline/i18n.ts` consumes these to assemble the
  * `defineServerConfig` / `defineClientConfig` payload.
  *
- * Kept separate from `byline/i18n.ts` so a public frontend (or a collection
- * schema file loaded outside Vite — e.g. when running seeds via tsx) can
- * import the locale arrays without dragging in the admin translation graph
- * (`@byline/i18n/admin`) that `i18n.ts` depends on. Importing `byline/i18n.ts`
- * would; importing this won't — which keeps the lazy admin/public bundle split
- * (`src/routes/_byline/route.lazy.tsx`) intact.
+ * Kept separate from `byline/i18n.ts` so `byline/public.ts` can expose the
+ * locale arrays to a public frontend (or a collection schema file loaded
+ * outside Vite — e.g. when running seeds via tsx) without dragging in the
+ * admin translation graph (`@byline/i18n/admin`) that `i18n.ts` depends on.
+ * Importing `byline/i18n.ts` would; importing this won't — which keeps the lazy
+ * admin/public bundle split (`src/routes/_byline/route.lazy.tsx`) intact.
  *
  * `interface` locales govern the CMS admin UI language; `content` locales
  * govern the languages a document can be published in.
@@ -33,10 +33,10 @@ export interface LocaleDefinition {
 // (or a third-party plugin merged in via `mergeTranslations(...)`).
 // `adminTranslations({ locales })` in `byline/i18n.ts` throws at boot if a
 // requested code is not bundled — `@byline/i18n/admin` ships English and French.
-export const interfaceLocales: LocaleDefinition[] = [
+export const interfaceLocales = [
   { code: 'en', label: 'English' },
   { code: 'fr', label: 'Français' },
-]
+] as const satisfies readonly LocaleDefinition[]
 
 /** Locales a document can be published in. */
 export const contentLocales = [
@@ -44,4 +44,4 @@ export const contentLocales = [
   { code: 'fr', label: 'Français' },
   { code: 'es', label: 'Español' },
   { code: 'de', label: 'Deutsch' },
-] as const
+] as const satisfies readonly LocaleDefinition[]

package/dist/templates/byline/public.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
+ */
+
+/** Client-safe public configuration. Keep this barrel free of admin and server imports. */
+export { contentLocales, interfaceLocales } from './locales.js'
+export { routes } from './routes.js'
+export type { LocaleDefinition } from './locales.js'

package/dist/templates/byline/routes.ts

@@ -7,17 +7,18 @@
  */
 
 /**
- * URL segments for admin and (future) public API routes. Defaults of
- * `/admin` and `/api` are applied automatically by `resolveRoutes()` —
- * keys only need to be set here when overriding either default.
+ * Client-safe URL paths for admin, sign-in, and the future public API.
+ * Resolve once at this client-safe configuration boundary so consumers only
+ * read canonical paths.
  */
 
-import type { RoutesConfig } from '@byline/core'
+import { resolveRoutes } from '@byline/core'
 
-export const routes: Partial<RoutesConfig> = {
+export const routes = resolveRoutes({
   admin: '/admin',
   api: '/api',
-}
+  signIn: '/sign-in',
+})
 
 /**
  * Fallback used by both server and admin entry points when no

package/dist/templates/byline/scripts/generate-types.ts

@@ -0,0 +1,81 @@
+import { randomUUID } from 'node:crypto'
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+import { emitCollectionTypes } from '@byline/core/codegen'
+
+import { collections } from '../collections/index.js'
+
+const defaultOutputPath = fileURLToPath(
+  new URL('../generated/collection-types.ts', import.meta.url)
+)
+
+export type GenerationStatus = 'current' | 'unchanged' | 'written'
+
+export function writeCollectionTypes(
+  outputPath: string,
+  source: string,
+  check: boolean
+): GenerationStatus {
+  const existing = existsSync(outputPath) ? readFileSync(outputPath, 'utf8') : undefined
+
+  if (check) {
+    if (existing === undefined) {
+      throw new Error(
+        `generated collection types are missing: ${outputPath}. Run pnpm byline:generate`
+      )
+    }
+    if (existing !== source) {
+      throw new Error(
+        `generated collection types are stale: ${outputPath}. Run pnpm byline:generate`
+      )
+    }
+    return 'current'
+  }
+
+  if (existing === source) return 'unchanged'
+
+  mkdirSync(dirname(outputPath), { recursive: true })
+  const temporaryPath = `${outputPath}.${process.pid}.${randomUUID()}.tmp`
+  try {
+    writeFileSync(temporaryPath, source, 'utf8')
+    renameSync(temporaryPath, outputPath)
+  } finally {
+    rmSync(temporaryPath, { force: true })
+  }
+  return 'written'
+}
+
+function parseArgs(args: readonly string[]): { check: boolean } {
+  const unknown = args.filter((arg) => arg !== '--check')
+  if (unknown.length > 0) throw new Error(`unknown argument: ${unknown.join(', ')}`)
+  if (args.filter((arg) => arg === '--check').length > 1) {
+    throw new Error('duplicate argument: --check')
+  }
+  return { check: args.includes('--check') }
+}
+
+export function generateCollectionTypes(
+  outputPath = defaultOutputPath,
+  check = false
+): { hash: string; status: GenerationStatus } {
+  const { source, hash } = emitCollectionTypes(collections)
+  return { hash, status: writeCollectionTypes(outputPath, source, check) }
+}
+
+function main(): void {
+  const { check } = parseArgs(process.argv.slice(2))
+  const { hash, status } = generateCollectionTypes(defaultOutputPath, check)
+  console.log(`collection types: ${collections.length} collections ${hash.slice(0, 12)} ${status}`)
+}
+
+const entryPath = process.argv[1]
+if (entryPath !== undefined && pathToFileURL(resolve(entryPath)).href === import.meta.url) {
+  try {
+    main()
+  } catch (error) {
+    console.error(`collection type generation failed: ${(error as Error).message}`)
+    process.exitCode = 1
+  }
+}

package/dist/templates/byline/server.config.ts

@@ -14,8 +14,7 @@
  * read it back with `getBylineCore<AdminStore>()`.
  *
  * This is the minimal scaffold: no example collections registered. Add
- * collection schemas to the `collections` array as you create them under
- * `byline/collections/<name>/schema.ts`.
+ * collection schemas to the shared tuple in `byline/collections/index.ts`.
  */
 
 import { type AdminStore, registerAdminAbilities } from '@byline/admin'
@@ -23,7 +22,6 @@ import { JwtSessionProvider } from '@byline/admin/auth'
 import { type BylineCore, initBylineCore } from '@byline/core'
 import { pgAdapter } from '@byline/db-postgres'
 import { createAdminStore } from '@byline/db-postgres/admin'
-import { getAdminBylineClient } from '@byline/host-tanstack-start/integrations/byline-client'
 import {
   lexicalEditorEmbedServer,
   lexicalEditorPopulateServer,
@@ -31,13 +29,14 @@ import {
 } from '@byline/richtext-lexical/server'
 import { localStorageProvider } from '@byline/storage-local'
 
+import { getAdminBylineClient } from './clients.server.js'
+import { collections } from './collections/index.js'
+import { serverHooks } from './collections/server-hooks.js'
 import { i18n } from './i18n.js'
 import { DEFAULT_SERVER_URL, routes } from './routes.js'
 
 const serverURL = process.env.VITE_SERVER_URL || DEFAULT_SERVER_URL
 
-const collections: Parameters<typeof pgAdapter>[0]['collections'] = []
-
 // HMR-safe singleton. Vite's program reload re-evaluates this module
 // without disposing the previous module's resources — every reload
 // would otherwise allocate a fresh pg `Pool` (max: 20) inside
@@ -93,6 +92,7 @@ async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
     i18n,
     routes,
     collections,
+    hooks: serverHooks,
     db,
     adminStore,
     // Local filesystem — suitable for development and self-hosted

package/dist/templates/byline-examples/admin.config.ts

@@ -8,13 +8,14 @@
 
 /**
  * Registers Byline's client-side config (collection admin UI configs,
- * field editors, i18n, routes) in the current module graph. Imported as
- * a side-effect from `src/routes/_byline/route.lazy.tsx` so registration
- * fires only when a `_byline/*` URL matches — keeping the Lexical
- * editor module graph out of public-route bundles entirely.
+ * field editors, i18n, routes) in the current module graph. The `_byline`
+ * route registers it from two complementary points: a dynamic import in
+ * `route.tsx` covers child loaders, while the side-effect import in
+ * `route.lazy.tsx` covers component render and initial hydration. Keeping
+ * both imports behind `_byline/*` keeps the admin graph off public routes.
  *
- * In TanStack Start with Vite 6 the server entry (`src/server.ts`) and
- * the SSR rendering context run in separate Vite environments, so
+ * In TanStack Start the server entry (`src/server.ts`) and the SSR rendering
+ * context run in separate Vite environments, so
  * importing this file from `src/server.ts` would NOT propagate the
  * registration into the SSR render module graph.
  */
@@ -28,11 +29,12 @@ import { RichTextField as LexicalRichTextField } from '@byline/richtext-lexical'
 // commented `richText` block below for the exact shape.
 // import { lexicalEditor } from '@byline/richtext-lexical'
 
-import { Docs, DocsAdmin } from './collections/docs/index.js'
-import { Media, MediaAdmin } from './collections/media/index.js'
-import { News, NewsAdmin } from './collections/news/index.js'
-import { NewsCategories, NewsCategoriesAdmin } from './collections/news-categories/index.js'
-import { Pages, PagesAdmin } from './collections/pages/index.js'
+import { DocsAdmin } from './collections/docs/admin.js'
+import { collections } from './collections/index.js'
+import { MediaAdmin } from './collections/media/admin.js'
+import { NewsAdmin } from './collections/news/admin.js'
+import { NewsCategoriesAdmin } from './collections/news-categories/admin.js'
+import { PagesAdmin } from './collections/pages/admin.js'
 import { i18n } from './i18n.js'
 import { DEFAULT_SERVER_URL, routes } from './routes.js'
 
@@ -42,7 +44,7 @@ export const config: ClientConfig = {
   serverURL,
   i18n,
   routes,
-  collections: [Docs, News, Pages, Media, NewsCategories],
+  collections,
   admin: [DocsAdmin, NewsAdmin, PagesAdmin, MediaAdmin, NewsCategoriesAdmin],
   fields: {
     // Default registration — every `type: 'richText'` field gets the full
@@ -58,19 +60,14 @@ export const config: ClientConfig = {
     // mutations are local to this call. Per-field `editorConfig`
     // continues to take precedence over whatever is baked in here.
     //
-    // import {
-    //   lexicalEditor,
-    //   AdmonitionExtension,
-    //   CodeHighlightExtension,
-    //   TableExtension,
-    // } from '@byline/richtext-lexical'
+    // import { builtInExtensions, lexicalEditor } from '@byline/richtext-lexical/config'
     //
     // richText: {
     //   editor: lexicalEditor((c) => {
     //     c.extensions
-    //       .remove(TableExtension)
-    //       .remove(CodeHighlightExtension)
-    //       .remove(AdmonitionExtension)
+    //       .remove(builtInExtensions.Table)
+    //       .remove(builtInExtensions.CodeHighlight)
+    //       .remove(builtInExtensions.Admonition)
     //     c.settings.placeholderText = 'Start writing...'
     //     return c
     //   }),

package/dist/templates/byline-examples/blocks/photo-block.ts

@@ -53,7 +53,8 @@ export type PhotoBlockFields = BlockFieldData<typeof PhotoBlock>
 
 /**
  * Full block instance shape (`_id`, `_type` + fields) as it appears
- * inside a document tree. Use this as the prop type for the photo
- * block renderer.
+ * inside a document tree. This alias is useful for schema-local helpers;
+ * app-facing renderers should import `PhotoBlockData` from
+ * `byline/generated/collection-types.ts` and overlay populated relations.
  */
 export type PhotoBlockData = BlockData<typeof PhotoBlock>

package/dist/templates/byline-examples/clients.server.ts

@@ -0,0 +1,77 @@
+/**
+ * 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
+ */
+
+/**
+ * Typed, server-only access to this application's Byline clients.
+ *
+ * ```text
+ * generated/collection-types.ts
+ *   `CollectionFieldsByPath`
+ *              |
+ *              v
+ * collections/index.ts --------------------.
+ *   `BylineCollections`                    |
+ *                                          v
+ * @byline/host-tanstack-start ------> clients.server.ts
+ *   runtime client getters             |
+ *                                      v
+ *                           typed `get*BylineClient()` getters
+ * ```
+ *
+ * Why this boundary exists:
+ *
+ * The TanStack host owns the runtime admin, public, system, and viewer client
+ * singletons. It intentionally knows nothing about an application's collection
+ * schemas, so its getters cannot provide application-specific collection paths
+ * and field shapes. The generated `CollectionFieldsByPath` registry is exported
+ * as `BylineCollections` by `collections/index.ts`; this module joins the host
+ * getters and app registry once instead of repeating a type assertion at every
+ * server call site.
+ *
+ * Typical server usage:
+ *
+ * ```ts
+ * const publicClient = getPublicBylineClient() // anonymous published reads
+ * const viewerClient = getViewerBylineClient() // public or admin-preview reads
+ * const adminClient = getAdminBylineClient() // current admin request authority
+ * const systemClient = getSystemBylineClient() // trusted hooks and maintenance
+ * ```
+ *
+ * Calls such as `systemClient.collection('docs')` are therefore checked against
+ * this application's generated registry and return the canonical generated
+ * field shape for `docs`. `collection-types.contract.ts` separately proves that
+ * those generated shapes still match the runtime collection schemas exactly.
+ *
+ * The `.server.ts` suffix is intentional. Import these getters only from server
+ * routes, loaders, actions, scripts, or lifecycle-hook modules; browser code
+ * must not cross this boundary.
+ *
+ * This module does not create client singletons, generate collection types, or
+ * configure the host. It only applies the app-specific client type and
+ * re-exports the host-owned getters (plus the viewer preview-state helper).
+ */
+import type { BylineClient } from '@byline/client'
+import {
+  getAdminBylineClient as getHostAdminBylineClient,
+  getSystemBylineClient as getHostSystemBylineClient,
+} from '@byline/host-tanstack-start/integrations/byline-client'
+import { getPublicBylineClient as getHostPublicBylineClient } from '@byline/host-tanstack-start/integrations/byline-public-client'
+import {
+  getViewerBylineClient as getHostViewerBylineClient,
+  isPreviewActive,
+} from '@byline/host-tanstack-start/integrations/byline-viewer-client'
+
+import type { BylineCollections } from './collections/index.js'
+
+type AppBylineClient = BylineClient<BylineCollections>
+
+export const getAdminBylineClient = getHostAdminBylineClient as () => AppBylineClient
+export const getPublicBylineClient = getHostPublicBylineClient as () => AppBylineClient
+export const getSystemBylineClient = getHostSystemBylineClient as () => AppBylineClient
+export const getViewerBylineClient = getHostViewerBylineClient as () => AppBylineClient
+export { isPreviewActive }