@byline/cli 3.9.0 → 3.10.0

package/dist/manifest/deps.d.ts

@@ -31,6 +31,6 @@ export interface DepSpec {
     /** When set, only install if the matching `answers` flag is true. */
     optional?: DepOptionalFlag;
 }
-export declare const BYLINE_VERSION = "^2.5.0";
+export declare const BYLINE_VERSION = "^3.0.0";
 export declare const DEP_SPECS: readonly DepSpec[];
 //# sourceMappingURL=deps.d.ts.map

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;AAQD,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EA2J9B,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,EAiK9B,CAAA"}

package/dist/manifest/deps.js

@@ -14,13 +14,14 @@
  * `src/routes/_byline/`, `src/ui/byline/`). Transitive deps reach the
  * user via the `@byline/*` package boundary and don't need declaring.
  */
-// Floor for installed `@byline/*` versions. Must match the minor that
-// introduced any new API the templates we drop into the host project
-// reference. e.g. `byline/server.config.ts` imports
-// `lexicalEditorEmbedServer` from `@byline/richtext-lexical/server`,
-// which landed in 2.5.0 — so we floor at ^2.5.0 to keep pnpm from
-// resolving an older lockfile pin under `^2.0.0`.
-export const BYLINE_VERSION = '^2.5.0';
+// Floor for installed `@byline/*` versions. The `@byline/*` packages release
+// in lockstep, and the templates we drop into the host project reference
+// 3.x-only APIs throughout (e.g. `i18n.translations` / `adminTranslations`,
+// `source_locale`, the audit log, and `lexicalEditorToMarkdownServer`). A `^2`
+// floor would let pnpm resolve the latest 2.x against these 3.x templates, so
+// we floor at the current major. Bump the minor when a template starts using an
+// API that landed in a later 3.x release.
+export const BYLINE_VERSION = '^3.0.0';
 export const DEP_SPECS = [
     // ---- @byline/* — released in lockstep at BYLINE_VERSION -----------------
     {
@@ -65,6 +66,12 @@ export const DEP_SPECS = [
         group: 'byline',
         note: 'TanStack Start integrations + route stubs',
     },
+    {
+        name: '@byline/i18n',
+        version: BYLINE_VERSION,
+        group: 'byline',
+        note: 'admin-interface translations; imported by byline/i18n.ts (adminTranslations)',
+    },
     {
         name: '@byline/richtext-lexical',
         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/i18n.ts

@@ -7,32 +7,24 @@
  */
 
 /**
- * Shared i18n locale configuration — no upstream dependencies, safe to import
- * from both config entry-points and collection schema files without circular
- * references.
+ * Shared i18n configuration — assembles the `defineServerConfig` /
+ * `defineClientConfig` payload from the host's locale sets and the admin
+ * 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.
  *
  * `interface` locales govern the CMS admin UI language.
  * `content` locales govern the languages a document can be published in.
  */
 
-export interface LocaleDefinition {
-  code: string
-  label: string
-}
+import { adminTranslations } from '@byline/i18n/admin'
 
-/** Locales available in the CMS admin interface. */
-export const interfaceLocales: LocaleDefinition[] = [
-  { code: 'en', label: 'English' },
-  { code: 'es', label: 'Español' },
-]
+import { contentLocales, interfaceLocales, type LocaleDefinition } from './locales.js'
 
-/** Locales a document can be published in. */
-export const contentLocales = [
-  { code: 'en', label: 'English' },
-  { code: 'fr', label: 'Français' },
-  { code: 'es', label: 'Español' },
-  { code: 'de', label: 'Deutsch' },
-] as const
+export { contentLocales, interfaceLocales, type LocaleDefinition }
 
 /** Derived config object — passed directly to defineServerConfig / defineClientConfig. */
 export const i18n = {
@@ -40,7 +32,7 @@ export const i18n = {
     defaultLocale: 'en',
     locales: interfaceLocales.map((l) => l.code),
     // Optional display names for the admin language switcher. Lets you
-    // author `Español` rather than the lowercase `español` that
+    // author `Français` rather than the lowercase `français` that
     // Intl.DisplayNames returns; omit to fall back to Intl per code.
     localeDefinitions: interfaceLocales.map((l) => ({ code: l.code, nativeName: l.label })),
   },
@@ -53,4 +45,14 @@ export const i18n = {
     // hreflang / "read this in…" affordances without a parallel map.
     localeDefinitions: contentLocales.map((l) => ({ code: l.code, nativeName: l.label })),
   },
+  // Admin UI translations. `adminTranslations({...})` ships the `byline-admin`
+  // namespace bundled into `@byline/i18n/admin`. A non-empty `interface.locales`
+  // REQUIRES this — `initBylineCore()` throws at boot otherwise. To extend the
+  // registry with your own namespace (custom fields, plugins), merge bundles:
+  //   import { mergeTranslations } from '@byline/i18n'
+  //   translations: mergeTranslations(
+  //     adminTranslations({ locales: interfaceLocales.map((l) => l.code) }),
+  //     myPluginTranslations({ locales: interfaceLocales.map((l) => l.code) })
+  //   ),
+  translations: adminTranslations({ locales: interfaceLocales.map((l) => l.code) }),
 }

package/dist/templates/byline/locales.ts

@@ -0,0 +1,47 @@
+/**
+ * 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
+ */
+
+/**
+ * Leaf locale definitions — the host's two locale sets, as plain data with
+ * **zero** runtime dependencies (no `@byline/*` imports, no translation
+ * 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.
+ *
+ * `interface` locales govern the CMS admin UI language; `content` locales
+ * govern the languages a document can be published in.
+ */
+
+export interface LocaleDefinition {
+  code: string
+  label: string
+}
+
+/** Locales available in the CMS admin interface. */
+// Every code listed here must have a matching bundle in `@byline/i18n/admin`
+// (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[] = [
+  { code: 'en', label: 'English' },
+  { code: 'fr', label: 'Français' },
+]
+
+/** Locales a document can be published in. */
+export const contentLocales = [
+  { code: 'en', label: 'English' },
+  { code: 'fr', label: 'Français' },
+  { code: 'es', label: 'Español' },
+  { code: 'de', label: 'Deutsch' },
+] as const

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

@@ -27,6 +27,7 @@ import { getAdminBylineClient } from '@byline/host-tanstack-start/integrations/b
 import {
   lexicalEditorEmbedServer,
   lexicalEditorPopulateServer,
+  lexicalEditorToMarkdownServer,
 } from '@byline/richtext-lexical/server'
 import { localStorageProvider } from '@byline/storage-local'
 
@@ -134,6 +135,10 @@ async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
       richText: {
         embed: lexicalEditorEmbedServer({ getClient: getAdminBylineClient }),
         populate: lexicalEditorPopulateServer({ getClient: getAdminBylineClient }),
+        // One-way Lexical → markdown serializer for the agent-readable export
+        // surface (`.md` content routes, `llms.txt`). Pure JSON walk — no
+        // client needed. Remove if you don't expose the markdown surface.
+        toMarkdown: lexicalEditorToMarkdownServer(),
       },
     },
   })

package/dist/templates/byline-examples/i18n.ts

@@ -7,32 +7,24 @@
  */
 
 /**
- * Shared i18n locale configuration — no upstream dependencies, safe to import
- * from both config entry-points and collection schema files without circular
- * references.
+ * Shared i18n configuration — assembles the `defineServerConfig` /
+ * `defineClientConfig` payload from the host's locale sets and the admin
+ * 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.
  *
  * `interface` locales govern the CMS admin UI language.
  * `content` locales govern the languages a document can be published in.
  */
 
-export interface LocaleDefinition {
-  code: string
-  label: string
-}
+import { adminTranslations } from '@byline/i18n/admin'
 
-/** Locales available in the CMS admin interface. */
-export const interfaceLocales: LocaleDefinition[] = [
-  { code: 'en', label: 'English' },
-  { code: 'es', label: 'Español' },
-]
+import { contentLocales, interfaceLocales, type LocaleDefinition } from './locales.js'
 
-/** Locales a document can be published in. */
-export const contentLocales = [
-  { code: 'en', label: 'English' },
-  { code: 'fr', label: 'Français' },
-  { code: 'es', label: 'Español' },
-  { code: 'de', label: 'Deutsch' },
-] as const
+export { contentLocales, interfaceLocales, type LocaleDefinition }
 
 /** Derived config object — passed directly to defineServerConfig / defineClientConfig. */
 export const i18n = {
@@ -40,7 +32,7 @@ export const i18n = {
     defaultLocale: 'en',
     locales: interfaceLocales.map((l) => l.code),
     // Optional display names for the admin language switcher. Lets you
-    // author `Español` rather than the lowercase `español` that
+    // author `Français` rather than the lowercase `français` that
     // Intl.DisplayNames returns; omit to fall back to Intl per code.
     localeDefinitions: interfaceLocales.map((l) => ({ code: l.code, nativeName: l.label })),
   },
@@ -53,4 +45,14 @@ export const i18n = {
     // hreflang / "read this in…" affordances without a parallel map.
     localeDefinitions: contentLocales.map((l) => ({ code: l.code, nativeName: l.label })),
   },
+  // Admin UI translations. `adminTranslations({...})` ships the `byline-admin`
+  // namespace bundled into `@byline/i18n/admin`. A non-empty `interface.locales`
+  // REQUIRES this — `initBylineCore()` throws at boot otherwise. To extend the
+  // registry with your own namespace (custom fields, plugins), merge bundles:
+  //   import { mergeTranslations } from '@byline/i18n'
+  //   translations: mergeTranslations(
+  //     adminTranslations({ locales: interfaceLocales.map((l) => l.code) }),
+  //     myPluginTranslations({ locales: interfaceLocales.map((l) => l.code) })
+  //   ),
+  translations: adminTranslations({ locales: interfaceLocales.map((l) => l.code) }),
 }

package/dist/templates/byline-examples/locales.ts

@@ -0,0 +1,47 @@
+/**
+ * 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
+ */
+
+/**
+ * Leaf locale definitions — the host's two locale sets, as plain data with
+ * **zero** runtime dependencies (no `@byline/*` imports, no translation
+ * 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.
+ *
+ * `interface` locales govern the CMS admin UI language; `content` locales
+ * govern the languages a document can be published in.
+ */
+
+export interface LocaleDefinition {
+  code: string
+  label: string
+}
+
+/** Locales available in the CMS admin interface. */
+// Every code listed here must have a matching bundle in `@byline/i18n/admin`
+// (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[] = [
+  { code: 'en', label: 'English' },
+  { code: 'fr', label: 'Français' },
+]
+
+/** Locales a document can be published in. */
+export const contentLocales = [
+  { code: 'en', label: 'English' },
+  { code: 'fr', label: 'Français' },
+  { code: 'es', label: 'Español' },
+  { code: 'de', label: 'Deutsch' },
+] as const

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

@@ -23,6 +23,7 @@ import { getAdminBylineClient } from '@byline/host-tanstack-start/integrations/b
 import {
   lexicalEditorEmbedServer,
   lexicalEditorPopulateServer,
+  lexicalEditorToMarkdownServer,
 } from '@byline/richtext-lexical/server'
 import { localStorageProvider } from '@byline/storage-local'
 
@@ -206,6 +207,10 @@ async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
       richText: {
         embed: lexicalEditorEmbedServer({ getClient: getAdminBylineClient }),
         populate: lexicalEditorPopulateServer({ getClient: getAdminBylineClient }),
+        // One-way Lexical → markdown serializer for the agent-readable export
+        // surface (`.md` content routes, `llms.txt`). Pure JSON walk — no
+        // client needed. Remove if you don't expose the markdown surface.
+        toMarkdown: lexicalEditorToMarkdownServer(),
       },
     },
   })

package/dist/templates/migrations/{0000_yielding_northstar.sql → 0000_rainy_starjammers.sql}

@@ -65,6 +65,19 @@ CREATE TABLE "byline_admin_users" (
 	CONSTRAINT "byline_admin_users_email_unique" UNIQUE("email")
 );
 --> statement-breakpoint
+CREATE TABLE "byline_audit_log" (
+	"id" uuid PRIMARY KEY NOT NULL,
+	"document_id" uuid,
+	"collection_id" uuid,
+	"actor_id" uuid,
+	"actor_realm" varchar(16) NOT NULL,
+	"action" varchar(64) NOT NULL,
+	"field" varchar(128),
+	"before" jsonb,
+	"after" jsonb,
+	"occurred_at" timestamp (6) with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
 CREATE TABLE "byline_store_boolean" (
 	"id" uuid PRIMARY KEY NOT NULL,
 	"document_version_id" uuid NOT NULL,
@@ -316,6 +329,9 @@ CREATE INDEX "idx_byline_admin_refresh_tokens_token_hash" ON "byline_admin_refre
 CREATE INDEX "idx_byline_admin_role_admin_user_user" ON "byline_admin_role_admin_user" USING btree ("admin_user_id");--> statement-breakpoint
 CREATE INDEX "idx_byline_admin_roles_machine_name" ON "byline_admin_roles" USING btree ("machine_name");--> statement-breakpoint
 CREATE INDEX "idx_byline_admin_users_email" ON "byline_admin_users" USING btree ("email");--> statement-breakpoint
+CREATE INDEX "idx_audit_log_document_id" ON "byline_audit_log" USING btree ("document_id","id");--> statement-breakpoint
+CREATE INDEX "idx_audit_log_actor_id" ON "byline_audit_log" USING btree ("actor_id","id");--> statement-breakpoint
+CREATE INDEX "idx_audit_log_action" ON "byline_audit_log" USING btree ("action","id");--> statement-breakpoint
 CREATE INDEX "idx_boolean_value" ON "byline_store_boolean" USING btree ("value");--> statement-breakpoint
 CREATE INDEX "idx_boolean_path_value" ON "byline_store_boolean" USING btree ("field_path","value");--> statement-breakpoint
 CREATE INDEX "idx_boolean_collection_value" ON "byline_store_boolean" USING btree ("collection_id","field_path","value");--> statement-breakpoint

package/dist/templates/migrations/meta/0000_snapshot.json

@@ -1,5 +1,5 @@
 {
-  "id": "52560051-1da6-41f4-8a2c-b9a7b5421d26",
+  "id": "00066c6d-bed5-4d32-8431-d950cb3ce641",
   "prevId": "00000000-0000-0000-0000-000000000000",
   "version": "7",
   "dialect": "postgresql",
@@ -562,6 +562,144 @@
       "checkConstraints": {},
       "isRLSEnabled": false
     },
+    "public.byline_audit_log": {
+      "name": "byline_audit_log",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true
+        },
+        "document_id": {
+          "name": "document_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "collection_id": {
+          "name": "collection_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "actor_id": {
+          "name": "actor_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "actor_realm": {
+          "name": "actor_realm",
+          "type": "varchar(16)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "action": {
+          "name": "action",
+          "type": "varchar(64)",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "field": {
+          "name": "field",
+          "type": "varchar(128)",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "before": {
+          "name": "before",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "after": {
+          "name": "after",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "occurred_at": {
+          "name": "occurred_at",
+          "type": "timestamp (6) with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_audit_log_document_id": {
+          "name": "idx_audit_log_document_id",
+          "columns": [
+            {
+              "expression": "document_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_audit_log_actor_id": {
+          "name": "idx_audit_log_actor_id",
+          "columns": [
+            {
+              "expression": "actor_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_audit_log_action": {
+          "name": "idx_audit_log_action",
+          "columns": [
+            {
+              "expression": "action",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
     "public.byline_store_boolean": {
       "name": "byline_store_boolean",
       "schema": "",

package/dist/templates/migrations/meta/_journal.json

@@ -5,8 +5,8 @@
     {
       "idx": 0,
       "version": "7",
-      "when": 1780302968051,
-      "tag": "0000_yielding_northstar",
+      "when": 1781318465897,
+      "tag": "0000_rainy_starjammers",
       "breakpoints": true
     }
   ]

package/package.json

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