@byline/cli 4.9.0 → 4.10.1

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

@@ -0,0 +1,105 @@
+/**
+ * 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-side Byline bootstrap. Imported as a side-effect from
+ * `src/server.ts` and from scripts that need the configured runtime.
+ *
+ * This is the minimal scaffold: no example collections or search provider.
+ */
+
+import { type AdminStore, registerAdminAbilities } from '@byline/admin'
+import { JwtSessionProvider } from '@byline/admin/auth'
+import { getAdminBylineClient } from '@byline/client/server'
+import { type BylineCore, initBylineCore } from '@byline/core'
+import { mysqlAdapter } from '@byline/db-mysql'
+import { createAdminStore } from '@byline/db-mysql/admin'
+import { registerTanstackStartHostBridge } from '@byline/host-tanstack-start/integrations/host-bridge'
+import {
+  lexicalEditorEmbedServer,
+  lexicalEditorPopulateServer,
+  lexicalEditorToMarkdownServer,
+} from '@byline/richtext-lexical/server'
+import { localStorageProvider } from '@byline/storage-local'
+
+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
+
+// HMR-safe singleton. Reusing the resolving Promise prevents development
+// reloads from orphaning MySQL pools and exhausting server connections.
+declare global {
+  // biome-ignore lint: globalThis augmentation requires `var` rather than `let`
+  var __bylineCoreSingleton__: Promise<BylineCore<AdminStore>> | undefined
+}
+
+async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
+  const db = mysqlAdapter({
+    connectionString: process.env.BYLINE_DB_MYSQL_CONNECTION_STRING || '',
+    collections,
+    defaultContentLocale: i18n.content.defaultLocale,
+    // Optional pool tuning. Omit these values to use the adapter defaults:
+    // 20 connections, 2s idle timeout, and 30s connection timeout.
+    connectionLimit: process.env.BYLINE_DB_MYSQL_CONNECTION_LIMIT
+      ? Number(process.env.BYLINE_DB_MYSQL_CONNECTION_LIMIT)
+      : undefined,
+    idleTimeout: process.env.BYLINE_DB_MYSQL_IDLE_TIMEOUT_MILLIS
+      ? Number(process.env.BYLINE_DB_MYSQL_IDLE_TIMEOUT_MILLIS)
+      : undefined,
+    connectTimeout: process.env.BYLINE_DB_MYSQL_CONNECTION_TIMEOUT_MILLIS
+      ? Number(process.env.BYLINE_DB_MYSQL_CONNECTION_TIMEOUT_MILLIS)
+      : undefined,
+  })
+
+  const adminStore = createAdminStore(db.drizzle)
+  const signingSecret = process.env.BYLINE_JWT_SECRET
+  if (!signingSecret || signingSecret.length < 32) {
+    throw new Error(
+      'BYLINE_JWT_SECRET must be set and carry at least 32 bytes of entropy. ' +
+        'Generate one with `openssl rand -base64 48` and add it to your .env.local.'
+    )
+  }
+
+  const sessionProvider = new JwtSessionProvider({
+    store: adminStore,
+    signingSecret,
+  })
+
+  registerTanstackStartHostBridge()
+
+  const core = await initBylineCore<AdminStore>({
+    serverURL,
+    i18n,
+    routes,
+    collections,
+    hooks: serverHooks,
+    db,
+    adminStore,
+    storage: localStorageProvider({
+      uploadDir: './uploads',
+      baseUrl: '/uploads',
+    }),
+    sessionProvider,
+    fields: {
+      richText: {
+        embed: lexicalEditorEmbedServer({ getClient: getAdminBylineClient }),
+        populate: lexicalEditorPopulateServer({ getClient: getAdminBylineClient }),
+        toMarkdown: lexicalEditorToMarkdownServer(),
+      },
+    },
+  })
+
+  registerAdminAbilities(core.abilities)
+  return core
+}
+
+globalThis.__bylineCoreSingleton__ ??= buildBylineCore()
+await globalThis.__bylineCoreSingleton__

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

@@ -0,0 +1,115 @@
+/**
+ * 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-side Byline bootstrap for the MySQL example scaffold.
+ */
+
+import { type AdminStore, registerAdminAbilities } from '@byline/admin'
+import { JwtSessionProvider } from '@byline/admin/auth'
+import { getAdminBylineClient } from '@byline/client/server'
+import { type BylineCore, initBylineCore } from '@byline/core'
+import { mysqlAdapter } from '@byline/db-mysql'
+import { createAdminStore } from '@byline/db-mysql/admin'
+import { registerTanstackStartHostBridge } from '@byline/host-tanstack-start/integrations/host-bridge'
+import {
+  lexicalEditorEmbedServer,
+  lexicalEditorPopulateServer,
+  lexicalEditorToMarkdownServer,
+  lexicalEditorToTextServer,
+} from '@byline/richtext-lexical/server'
+import { migrate, mysqlSearch } from '@byline/search-mysql'
+import { localStorageProvider } from '@byline/storage-local'
+
+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
+
+// HMR-safe singleton. Reusing the resolving Promise prevents development
+// reloads from orphaning MySQL pools and exhausting server connections.
+declare global {
+  // biome-ignore lint: globalThis augmentation requires `var` rather than `let`
+  var __bylineCoreSingleton__: Promise<BylineCore<AdminStore>> | undefined
+}
+
+async function buildBylineCore(): Promise<BylineCore<AdminStore>> {
+  const db = mysqlAdapter({
+    connectionString: process.env.BYLINE_DB_MYSQL_CONNECTION_STRING || '',
+    collections,
+    defaultContentLocale: i18n.content.defaultLocale,
+    // Optional pool tuning. Omit these values to use the adapter defaults:
+    // 20 connections, 2s idle timeout, and 30s connection timeout.
+    connectionLimit: process.env.BYLINE_DB_MYSQL_CONNECTION_LIMIT
+      ? Number(process.env.BYLINE_DB_MYSQL_CONNECTION_LIMIT)
+      : undefined,
+    idleTimeout: process.env.BYLINE_DB_MYSQL_IDLE_TIMEOUT_MILLIS
+      ? Number(process.env.BYLINE_DB_MYSQL_IDLE_TIMEOUT_MILLIS)
+      : undefined,
+    connectTimeout: process.env.BYLINE_DB_MYSQL_CONNECTION_TIMEOUT_MILLIS
+      ? Number(process.env.BYLINE_DB_MYSQL_CONNECTION_TIMEOUT_MILLIS)
+      : undefined,
+  })
+
+  // Search owns its disposable projection and numbered migration stream.
+  // Apply it explicitly at startup with the adapter's existing pool. A
+  // migration failure degrades search without taking down the application.
+  try {
+    await migrate(db.pool, { log: (message) => console.log(message) })
+  } catch (error) {
+    console.error('[search-mysql] migrate failed — search may be unavailable:', error)
+  }
+
+  const adminStore = createAdminStore(db.drizzle)
+  const signingSecret = process.env.BYLINE_JWT_SECRET
+  if (!signingSecret || signingSecret.length < 32) {
+    throw new Error(
+      'BYLINE_JWT_SECRET must be set and carry at least 32 bytes of entropy. ' +
+        'Generate one with `openssl rand -base64 48` and add it to your .env.local.'
+    )
+  }
+
+  const sessionProvider = new JwtSessionProvider({
+    store: adminStore,
+    signingSecret,
+  })
+
+  registerTanstackStartHostBridge()
+
+  const core = await initBylineCore<AdminStore>({
+    serverURL,
+    i18n,
+    routes,
+    collections,
+    hooks: serverHooks,
+    db,
+    adminStore,
+    storage: localStorageProvider({
+      uploadDir: './uploads',
+      baseUrl: '/uploads',
+    }),
+    sessionProvider,
+    fields: {
+      richText: {
+        embed: lexicalEditorEmbedServer({ getClient: getAdminBylineClient }),
+        populate: lexicalEditorPopulateServer({ getClient: getAdminBylineClient }),
+        toMarkdown: lexicalEditorToMarkdownServer(),
+        toText: lexicalEditorToTextServer(),
+      },
+    },
+    search: mysqlSearch({ pool: db.pool, defaultLocale: i18n.content.defaultLocale }),
+  })
+
+  registerAdminAbilities(core.abilities)
+  return core
+}
+
+globalThis.__bylineCoreSingleton__ ??= buildBylineCore()
+await globalThis.__bylineCoreSingleton__

package/dist/templates/host/vite.config.ts

@@ -44,7 +44,7 @@ const bylineSsrNoExternal = [/^@byline\//]
 // kept external so Node resolves them at runtime instead.
 //   - sharp + @byline/storage-local — image processing (libvips)
 //   - @byline/storage-s3 — bundles the AWS SDK; keep external for Node resolution
-//   - @byline/db-postgres — depends on `pg` native bindings
+//   - @byline/db-postgres + @byline/db-mysql — database drivers
 //   - pino — CJS entrypoints don't execute under Vite's module runner
 //
 // `@byline/admin` is intentionally NOT externalised: it now hosts
@@ -53,7 +53,7 @@ const bylineSsrNoExternal = [/^@byline\//]
 // `import './foo_module.css'`. Node's ESM loader can't handle `.css`,
 // so admin must flow through Vite's SSR pipeline where the CSS plugin
 // resolves the side-effect imports. Server-only admin subpaths reach
-// db-postgres / storage adapters through composition at runtime, not
+// database / storage adapters through composition at runtime, not
 // through `@byline/admin`'s own import graph, so this is safe.
 const ssrExternal = [
   'sharp',
@@ -61,6 +61,7 @@ const ssrExternal = [
   '@byline/storage-local',
   '@byline/storage-s3',
   '@byline/db-postgres',
+  '@byline/db-mysql',
 ]
 
 const config = defineConfig({
@@ -198,7 +199,7 @@ const config = defineConfig({
           'react-dom',
           'pino',
           'sharp',
-          /^@byline\/(db-postgres|storage-local|storage-s3)/,
+          /^@byline\/(db-postgres|db-mysql|storage-local|storage-s3)/,
         ],
       },
     }),