feat: add "watch" option to cms config (#427)

Author: stevenle

.changeset/giant-lamps-matter.md

@@ -0,0 +1,5 @@
+---
+'@blinkk/root-cms': patch
+---
+
+feat: add "watch" option to cms config

packages/root-cms/core/plugin.ts

@@ -162,6 +162,12 @@ export type CMSPluginOptions = {
    * Adjust console output verbosity. Default is `'info'`.
    */
   logLevel?: 'info' | 'warn' | 'error' | 'silent' | 'debug';
+
+  /**
+   * Whether to enable/disable file watching in dev (e.g. for generating
+   * `root-cms.d.ts`). Defaults to `true`.
+   */
+  watch?: boolean;
 };
 
 export type CMSPlugin = Plugin & {
@@ -433,18 +439,6 @@ export function cmsPlugin(options: CMSPluginOptions): CMSPlugin {
       cms: path.resolve(__dirname, './app.js'),
     }),
 
-    /**
-     * Watches for .schema.ts file changes and generates a root-cms.d.ts file.
-     */
-    onFileChange: (
-      eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir',
-      filepath: string
-    ) => {
-      if (filepath.endsWith('.schema.ts')) {
-        generateTypes();
-      }
-    },
-
     /**
      * Attaches CMS-specific middleware to the Root.js server.
      */
@@ -588,6 +582,22 @@ export function cmsPlugin(options: CMSPluginOptions): CMSPlugin {
     },
   };
 
+  if (options.watch !== false) {
+    plugin.onFileChange = (
+      eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir',
+      filepath: string
+    ) => {
+      if (filepath.endsWith('.schema.ts')) {
+        // Avoid loading the `generate-types.js` module if it is not needed.
+        // See: https://github.com/blinkk/rootjs/issues/426
+        import('../cli/generate-types.js').then((generateTypesModule) => {
+          const generateTypes = generateTypesModule.generateTypes;
+          generateTypes();
+        });
+      }
+    };
+  }
+
   return plugin;
 }