@momentumcms/core 0.5.4 → 0.5.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@momentumcms/core",
-	"version": "0.5.4",
+	"version": "0.5.6",
 	"description": "Core collection config, fields, hooks, and access control for Momentum CMS",
 	"license": "MIT",
 	"author": "Momentum CMS Contributors",

package/src/index.cjs

@@ -71,6 +71,7 @@ __export(src_exports, {
   richText: () => richText,
   row: () => row,
   select: () => select,
+  shouldSyncSchema: () => shouldSyncSchema,
   slug: () => slug,
   tabs: () => tabs,
   text: () => text,
@@ -676,6 +677,15 @@ function defineMomentumConfig(config) {
     migrations: resolveMigrationConfig(config.migrations)
   };
 }
+function shouldSyncSchema(config) {
+  const explicit = config.db.syncSchema ?? "auto";
+  if (typeof explicit === "boolean")
+    return explicit;
+  if (!config.migrations)
+    return true;
+  const mode = resolveMigrationMode(config.migrations.mode);
+  return mode !== "migrate";
+}
 function getDbAdapter(config) {
   return config.db.adapter;
 }
@@ -832,6 +842,7 @@ function hasVersionDrafts(collection) {
   richText,
   row,
   select,
+  shouldSyncSchema,
   slug,
   tabs,
   text,

package/src/index.js

@@ -594,6 +594,15 @@ function defineMomentumConfig(config) {
     migrations: resolveMigrationConfig(config.migrations)
   };
 }
+function shouldSyncSchema(config) {
+  const explicit = config.db.syncSchema ?? "auto";
+  if (typeof explicit === "boolean")
+    return explicit;
+  if (!config.migrations)
+    return true;
+  const mode = resolveMigrationMode(config.migrations.mode);
+  return mode !== "migrate";
+}
 function getDbAdapter(config) {
   return config.db.adapter;
 }
@@ -749,6 +758,7 @@ export {
   richText,
   row,
   select,
+  shouldSyncSchema,
   slug,
   tabs,
   text,

package/src/lib/config.d.ts

@@ -193,6 +193,17 @@ export interface DatabaseConfig {
      * Use @momentumcms/db-drizzle for Drizzle ORM support.
      */
     adapter: DatabaseAdapter;
+    /**
+     * Whether to auto-sync the database schema on server start.
+     *
+     * - `true`:  Always run `adapter.initialize()` (CREATE TABLE IF NOT EXISTS).
+     * - `false`: Never auto-sync — expect migrations to be run separately.
+     * - `'auto'`: Sync when no migration config or in `push` mode;
+     *             skip when migration mode is `migrate`.
+     *
+     * @default 'auto'
+     */
+    syncSchema?: boolean | 'auto';
 }
 /**
  * Admin component overrides and layout slot registrations.
@@ -459,6 +470,14 @@ export interface ResolvedMomentumConfig extends MomentumConfig {
  * ```
  */
 export declare function defineMomentumConfig(config: MomentumConfig): ResolvedMomentumConfig;
+/**
+ * Determine whether the server should auto-sync the database schema on boot.
+ *
+ * Resolution order:
+ * 1. Explicit `db.syncSchema` (true / false) — always wins.
+ * 2. `'auto'` (or omitted) — sync unless migration mode is `'migrate'`.
+ */
+export declare function shouldSyncSchema(config: MomentumConfig | ResolvedMomentumConfig): boolean;
 /**
  * Gets the database adapter from the config.
  */