@byline/cli 3.14.0 → 3.15.1

package/dist/manifest/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAA;AAE1C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AASD,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAiK9B,CAAA"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAA;AAE1C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AASD,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAuK9B,CAAA"}

package/dist/manifest/deps.js

@@ -78,6 +78,12 @@ export const DEP_SPECS = [
         group: 'byline',
         note: 'Lexical-backed richtext field + server populate',
     },
+    {
+        name: '@byline/search-postgres',
+        version: BYLINE_VERSION,
+        group: 'byline',
+        note: 'built-in Postgres full-text search provider; registered in byline/server.config.ts, drives collections/docs indexing hooks',
+    },
     {
         name: '@byline/storage-local',
         version: BYLINE_VERSION,

package/dist/manifest/deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../src/manifest/deps.ts"],"names":[],"mappings":"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"}

package/dist/templates/byline-examples/collections/docs/admin.tsx

@@ -6,8 +6,9 @@
  * Copyright (c) Infonomic Company Limited
  */
 
-import { type CollectionAdminConfig, type ColumnDefinition, defineAdmin } from '@byline/core'
 import { DateTimeFormatter } from '@byline/admin/react'
+import { type CollectionAdminConfig, type ColumnDefinition, defineAdmin } from '@byline/core'
+import { ReindexButton } from '@byline/host-tanstack-start/admin-shell/collections/reindex-button'
 
 import { SummaryLength } from '~/components/summary-length.js'
 
@@ -70,12 +71,12 @@ export const DocsAdmin: CollectionAdminConfig = defineAdmin(Docs, {
    * picker modal (opened from a `relation` field widget). Omit to fall back to a
    * single-line render of `useAsTitle` + `path`.
    *
-   * Shape matches `ColumnDefinition` so formatters can be reused across list and picker.
+   * Shape matches `ColumnDefinition` so formatters can be reused across list and item view.
    *
    * @example
-   * picker: [{ fieldName: 'title', label: 'Title' }] // or defined above as `pickerViewColumns`
+   * itemView: [{ fieldName: 'title', label: 'Title' }] // or defined above as `pickerViewColumns`
    */
-  // picker: [],
+  // itemView: [],
 
   /**
    * Custom list-view component that completely replaces the default table-based `ListView`
@@ -89,6 +90,16 @@ export const DocsAdmin: CollectionAdminConfig = defineAdmin(Docs, {
    */
   // listView: undefined,
 
+  /**
+   * Header action components for the default list view — a reusable slot in
+   * the list header (the Payload `beforeList`/`afterList` analog). `ReindexButton`
+   * rebuilds this collection's search index; it self-gates on the
+   * `collections.docs.reindex` ability, so it only appears for actors who
+   * hold it. Drop this (and the `search` config in schema.ts) if you don't
+   * want search on this collection. See docs/05-reading-and-delivery/07-search.md.
+   */
+  listActions: [ReindexButton],
+
   /**
    * Group name for organising this collection in the admin sidebar navigation.
    *

package/dist/templates/byline-examples/collections/docs/hooks.ts

@@ -0,0 +1,112 @@
+/**
+ * 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
+ */
+
+/**
+ * Server-only lifecycle hooks for the `docs` collection.
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ *  Why this file exists (the affordance)
+ * ──────────────────────────────────────────────────────────────────────────
+ * A collection *schema* (`./schema.ts`) is **isomorphic** — Byline bundles it
+ * into the browser admin as well as the server, because the admin reads field
+ * config from it. Anything the schema *statically imports* therefore ships to
+ * the client. Hook *bodies*, however, only ever run server-side.
+ *
+ * Search indexing is the canonical reason this matters: it imports
+ * `getSystemBylineClient` from `@byline/host-tanstack-start`, a server-only
+ * module. Importing that from the schema would drag server code into the
+ * browser bundle (fatal in dev). The schema avoids it by referencing these
+ * hooks through a **dynamic import** instead of an inline object:
+ *
+ *     // schema.ts
+ *     hooks: () => import('./hooks.js')
+ *
+ * Because the schema reaches this module only through `import()`, this file —
+ * and its entire transitive import graph — is **structurally absent** from
+ * the client bundle. `@byline/core` resolves the loader once on the server
+ * (memoized) and calls these hooks exactly as it would inline ones. The
+ * upshot: **inside this file we may statically import server-only modules
+ * directly.** See docs/04-collections → "Hooks must not statically import
+ * server-only code".
+ *
+ * ──────────────────────────────────────────────────────────────────────────
+ *  Search indexing
+ * ──────────────────────────────────────────────────────────────────────────
+ * Indexing rides the same lifecycle hooks. The orchestration lives in
+ * `@byline/client`: `indexDocument` re-reads the *published* view per locale
+ * and upserts / removes (so publish, unpublish, draft-over-published, and
+ * plain edits all converge on the same idempotent path); `removeFromIndex`
+ * drops every locale on delete.
+ *
+ * Resolve the client with `getSystemBylineClient()` (super-admin context, no
+ * session cookies) — NOT the request-scoped `getAdminBylineClient()`.
+ * Indexing is background maintenance that runs from out-of-band write paths
+ * too (the import-docs script, seeds, migrations), where there is no HTTP
+ * request to read a session cookie from. See
+ * docs/05-reading-and-delivery/07-search.md.
+ */
+
+import { defineHooks } from '@byline/core'
+import { getSystemBylineClient } from '@byline/host-tanstack-start/integrations/byline-client'
+
+export default defineHooks({
+  beforeCreate: async ({ data, collectionPath }) => {
+    console.log(`beforeCreate: creating a document in '${collectionPath}'`, data)
+  },
+  afterCreate: async ({ collectionPath, documentId, documentVersionId }) => {
+    console.log(
+      `afterCreate: document ${documentId} (version ${documentVersionId}) created in '${collectionPath}'`
+    )
+    await getSystemBylineClient().collection(collectionPath).indexDocument(documentId)
+  },
+  beforeUpdate: async ({ data, collectionPath }) => {
+    console.log(`beforeUpdate: updating a document in '${collectionPath}'`, data)
+  },
+  afterUpdate: async ({ collectionPath, documentId, documentVersionId }) => {
+    console.log(
+      `afterUpdate: document ${documentId} (version ${documentVersionId}) in '${collectionPath}' updated`
+    )
+    await getSystemBylineClient().collection(collectionPath).indexDocument(documentId)
+  },
+  beforeStatusChange: async ({ documentId, collectionPath, previousStatus, nextStatus }) => {
+    console.log(
+      `beforeStatusChange: ${documentId} in '${collectionPath}' ${previousStatus} → ${nextStatus}`
+    )
+  },
+  // Publish / unpublish flow through the status lifecycle (not afterUpdate),
+  // so re-index here too — this is when content becomes visible / invisible
+  // to anonymous traffic.
+  afterStatusChange: async ({ documentId, collectionPath, previousStatus, nextStatus }) => {
+    console.log(
+      `afterStatusChange: ${documentId} in '${collectionPath}' ${previousStatus} → ${nextStatus}`
+    )
+    await getSystemBylineClient().collection(collectionPath).indexDocument(documentId)
+  },
+  beforeUnpublish: async ({ documentId, collectionPath }) => {
+    console.log(`beforeUnpublish: unpublishing ${documentId} in '${collectionPath}'`)
+  },
+  afterUnpublish: async ({ documentId, collectionPath }) => {
+    console.log(`afterUnpublish: ${documentId} in '${collectionPath}' unpublished`)
+    await getSystemBylineClient().collection(collectionPath).indexDocument(documentId)
+  },
+  beforeDelete: async ({ documentId, collectionPath }) => {
+    console.log(`beforeDelete: deleting ${documentId} in '${collectionPath}'`)
+  },
+  afterDelete: async ({ documentId, collectionPath }) => {
+    console.log(`afterDelete: ${documentId} in '${collectionPath}' deleted`)
+    await getSystemBylineClient().collection(collectionPath).removeFromIndex(documentId)
+  },
+  // Fires on any structural tree change (place / reorder / re-parent /
+  // promote-on-delete) for a `tree: true` collection. The payload carries the
+  // affected set; a docs site typically invalidates its nav / breadcrumb /
+  // prev-next caches here. A tree move doesn't change a document's indexable
+  // text, so there's nothing to re-index.
+  afterTreeChange: async ({ collectionPath }) => {
+    console.log(`afterTreeChange: tree structure changed in '${collectionPath}'`)
+  },
+})

package/dist/templates/byline-examples/collections/docs/schema.ts

@@ -41,90 +41,29 @@ export const Docs = defineCollection({
   // placement from the source directory layout (see
   // byline/scripts/import-docs.ts --tree).
   tree: true,
-  search: { fields: ['title'] },
+  // Collection search config (docs/05-reading-and-delivery/07-search.md).
+  // Each key names the part a field plays in the index: `body` fields feed
+  // the full-text search vector (`title` is display-only unless listed here,
+  // so we include it and boost it into the heaviest weight class); `facets`,
+  // `filters`, and `zones` round out the surface. Opting in here is what
+  // makes the lifecycle hooks in ./hooks.ts index this collection — and it
+  // requires a `search` provider registered in byline/server.config.ts.
+  search: { body: [{ field: 'title', boost: 2 }, 'summary'] },
   useAsTitle: 'title',
   useAsPath: 'title',
   advertiseLocales: true, // Renders the available-locales sidebar widget.
   linksInEditor: true, // See type definition for details.
-  // All hooks can be a single function or an array of functions.
-  // If an array is provided, the functions will be executed in sequence.
-  hooks: {
-    beforeCreate: async ({ data, collectionPath }) => {
-      // Example: beforeCreate hook
-      console.log(
-        `beforeCreate: Creating a new document in collection ${collectionPath} with data:`,
-        data
-      )
-    },
-    afterCreate: async ({ data, collectionPath, documentId, documentVersionId }) => {
-      // Example: log the creation of a new document.
-      console.log(
-        `afterCreate: Document created with ID ${documentId} and version ID ${documentVersionId} in collection ${collectionPath}`
-      )
-    },
-    beforeUpdate: async ({ data, originalData, collectionPath }) => {
-      // Example: prevent a document from being published if it doesn't have a title.
-      console.log(
-        `beforeUpdate: Updating a document in collection ${collectionPath} with data:`,
-        data
-      )
-    },
-    afterUpdate: async ({ data, originalData, collectionPath, documentId, documentVersionId }) => {
-      // Example: log the update of a document.
-      console.log(
-        `afterUpdate: Document with ID ${documentId} and version ID ${documentVersionId} in collection ${collectionPath} was updated`
-      )
-    },
-    beforeStatusChange: async ({
-      documentId,
-      documentVersionId,
-      collectionPath,
-      previousStatus,
-      nextStatus,
-    }) => {
-      console.log(
-        `beforeStatusChange: Changing status of document in collection ${collectionPath} from ${previousStatus} to ${nextStatus} with document ID ${documentId} and version ID ${documentVersionId}`
-      )
-    },
-    afterStatusChange: async ({
-      documentId,
-      documentVersionId,
-      collectionPath,
-      previousStatus,
-      nextStatus,
-    }) => {
-      console.log(
-        `afterStatusChange: Status of document in collection ${collectionPath} changed from ${previousStatus} to ${nextStatus} with document ID ${documentId} and version ID ${documentVersionId}`
-      )
-    },
-    beforeUnpublish: async ({ documentId, collectionPath }) => {
-      console.log(
-        `beforeUnpublish: Unpublishing document in collection ${collectionPath} with document ID ${documentId}.`
-      )
-    },
-    afterUnpublish: async ({ documentId, collectionPath }) => {
-      console.log(
-        `afterUnpublish: Document in collection ${collectionPath} with document ID ${documentId} unpublished.`
-      )
-    },
-    beforeDelete: async ({ documentId, collectionPath }) => {
-      console.log(
-        `beforeDelete: Deleting document in collection ${collectionPath} with document ID ${documentId}.`
-      )
-    },
-    afterDelete: async ({ documentId, collectionPath }) => {
-      console.log(
-        `afterDelete: Document in collection ${collectionPath} with document ID ${documentId} deleted.`
-      )
-    },
-    // Fires on any structural tree change (place / reorder / re-parent /
-    // promote-on-delete) for a `tree: true` collection. The payload carries the
-    // affected set; a docs site typically invalidates its nav / breadcrumb /
-    // prev-next caches here.
-    afterTreeChange: async ({ collectionPath }) => {
-      console.log(`afterTreeChange: tree structure changed in collection ${collectionPath}.`)
-    },
-  },
+  // Collection lifecycle hooks. Hook *bodies* only ever run server-side, but
+  // a collection *schema* is isomorphic — Byline bundles it into the browser
+  // admin too (the admin reads field config from it), so anything the schema
+  // *statically imports* ships to the client. Search indexing needs a
+  // server-only import (`getSystemBylineClient` from
+  // `@byline/host-tanstack-start`), which would crash the browser bundle if
+  // imported here. The **loader form** — a thunk that dynamically imports a
+  // sibling module — keeps `./hooks.ts` and its entire import graph out of
+  // the client bundle while running exactly like inline hooks on the server.
+  // See ./hooks.ts for the worked example and the full explanation.
+  hooks: () => import('./hooks.js'),
   fields: [
     {
       name: 'title',

package/dist/templates/byline-examples/collections/media/admin.tsx

@@ -97,9 +97,9 @@ export const MediaAdmin: CollectionAdminConfig = defineAdmin(Media, {
    * picker modal (opened from a `relation` field widget). Omit to fall back to a
    * single-line render of `useAsTitle` + `path`.
    *
-   * Shape matches `ColumnDefinition` so formatters can be reused across list and picker.
+   * Shape matches `ColumnDefinition` so formatters can be reused across list and item view.
    */
-  picker: pickerViewColumns,
+  itemView: pickerViewColumns,
 
   /**
    * Custom list-view component that completely replaces the default table-based `ListView`

package/dist/templates/byline-examples/collections/news/admin.tsx

@@ -81,12 +81,12 @@ export const NewsAdmin: CollectionAdminConfig = defineAdmin(News, {
    * picker modal (opened from a `relation` field widget). Omit to fall back to a
    * single-line render of `useAsTitle` + `path`.
    *
-   * Shape matches `ColumnDefinition` so formatters can be reused across list and picker.
+   * Shape matches `ColumnDefinition` so formatters can be reused across list and item view.
    *
    * @example
-   * picker: [{ fieldName: 'title', label: 'Title' }] // or defined above as `pickerViewColumns`
+   * itemView: [{ fieldName: 'title', label: 'Title' }] // or defined above as `pickerViewColumns`
    */
-  // picker: [],
+  // itemView: [],
 
   /**
    * Custom list-view component that completely replaces the default table-based `ListView`

package/dist/templates/byline-examples/collections/news-categories/admin.tsx

@@ -74,5 +74,5 @@ const pickerViewColumns: ColumnDefinition[] = [
 
 export const NewsCategoriesAdmin: CollectionAdminConfig = defineAdmin(NewsCategories, {
   columns: listViewColumns,
-  picker: pickerViewColumns,
+  itemView: pickerViewColumns,
 })

package/dist/templates/byline-examples/collections/pages/admin.tsx

@@ -78,12 +78,12 @@ export const PagesAdmin: CollectionAdminConfig = defineAdmin(Pages, {
    * picker modal (opened from a `relation` field widget). Omit to fall back to a
    * single-line render of `useAsTitle` + `path`.
    *
-   * Shape matches `ColumnDefinition` so formatters can be reused across list and picker.
+   * Shape matches `ColumnDefinition` so formatters can be reused across list and item view.
    *
    * @example
-   * picker: [{ fieldName: 'title', label: 'Title' }] // or defined above as `pickerViewColumns`
+   * itemView: [{ fieldName: 'title', label: 'Title' }] // or defined above as `pickerViewColumns`
    */
-  // picker: [],
+  // itemView: [],
 
   /**
    * Custom list-view component that completely replaces the default table-based `ListView`

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

@@ -24,7 +24,9 @@ import {
   lexicalEditorEmbedServer,
   lexicalEditorPopulateServer,
   lexicalEditorToMarkdownServer,
+  lexicalEditorToTextServer,
 } from '@byline/richtext-lexical/server'
+import { migrate, postgresSearch } from '@byline/search-postgres'
 import { localStorageProvider } from '@byline/storage-local'
 
 // Import collection definitions directly from schema files — NOT the full
@@ -103,6 +105,24 @@ async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
     //   : undefined,
   })
 
+  // Ensure the search-index schema before the provider serves any traffic.
+  // `@byline/search-postgres` owns its schema (numbered SQL inside the
+  // package) and applies it via `migrate(pool)` — it is NOT part of the
+  // host's Drizzle migration stream. We run it deliberately here, rather
+  // than relying on the driver's `autoMigrate` option, so startup DDL is an
+  // explicit, awaited step. Reuses the adapter's pool — no second
+  // connection. See docs/05-reading-and-delivery/07-search.md.
+  //
+  // Wrapped defensively: a migration failure degrades search but must not
+  // take down the whole app at boot. We log loudly and continue. (For
+  // locked-down Postgres where the app role can't run DDL, drop this call and
+  // apply `migrations/0001_init.sql` by hand as a deploy step instead.)
+  try {
+    await migrate(db.pool, { log: (m) => console.log(m) })
+  } catch (err) {
+    console.error('[search-postgres] migrate failed — search may be unavailable:', err)
+  }
+
   const adminStore = createAdminStore(db.drizzle)
 
   // Built-in JWT session provider. Signing secret comes from the
@@ -211,8 +231,21 @@ async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
         // surface (`.md` content routes, `llms.txt`). Pure JSON walk — no
         // client needed. Remove if you don't expose the markdown surface.
         toMarkdown: lexicalEditorToMarkdownServer(),
+        // Plain-text extractor for search indexing — flattens rich-text
+        // `body` fields to indexable text for `buildSearchDocument`. Pure
+        // JSON walk, no client. Required by any collection that lists a
+        // richText field in its `search.body`. See
+        // docs/05-reading-and-delivery/07-search.md.
+        toText: lexicalEditorToTextServer(),
       },
     },
+    // Built-in Postgres full-text search provider. Reuses the adapter's pool
+    // (no second connection); the search index lives in the same database.
+    // Collections opt in via their `search` config (see
+    // collections/docs/schema.ts) and keep the index live via lifecycle
+    // hooks (see collections/docs/hooks.ts). Remove this registration if no
+    // collection declares a `search` config.
+    search: postgresSearch({ pool: db.pool, defaultLocale: i18n.content.defaultLocale }),
   })
 
   // Register admin-subsystem abilities (admin.users.*, admin.roles.*) on

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/cli",
   "private": false,
   "license": "MPL-2.0",
-  "version": "3.14.0",
+  "version": "3.15.1",
   "engines": {
     "node": ">=20.9.0"
   },