feat(templates): refactor CRM and Todo templates to use static imports and improve loading mechanism

Author: hotlong

apps/server/server/templates/crm.ts

@@ -1,32 +1,19 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import * as path from 'node:path';
+// Static relative import — bundle-require/esbuild inlines the CRM bundle
+// into the server's bundled config at boot time, so seeding does not rely
+// on Node resolving a `.ts` file at runtime (which `@example/app-crm`
+// would require, because workspace packages are marked external by the
+// CLI's bundler).
+import crmBundle from '../../../../examples/app-crm/objectstack.config';
 import type { ProjectTemplate } from './types.js';
 
-// Resolve the CRM bundle relative to THIS file so the path survives any
-// compilation/build output layout. Using a file:// URL means we can hand
-// the path to a dynamic import() without TypeScript trying to type-check
-// the target (which lives outside apps/server's rootDir).
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-const BUNDLE_PATH = path.resolve(HERE, '../../../../examples/app-crm/objectstack.config.ts');
-const BUNDLE_URL = pathToFileURL(BUNDLE_PATH).href;
-
-// Lazy dynamic import — the bundle's Zod evaluation is deferred until the
-// template is actually selected, so a schema drift in the example cannot
-// crash control-plane bootstrap.
-const dyn = (spec: string): Promise<any> =>
-    (new Function('s', 'return import(s)') as (s: string) => Promise<any>)(spec);
-
 export const crmTemplate: ProjectTemplate = {
     id: 'crm',
     label: 'CRM Starter',
     description: 'Accounts, Contacts, Opportunities — full CRM example.',
     category: 'business',
     async load() {
-        const mod = await dyn(BUNDLE_URL);
-        // ESM default can be nested under `.default.default` when the
-        // loader double-wraps (tsx + file:// URL). Unwrap defensively.
-        return mod?.default?.manifest ? mod.default : (mod?.default?.default ?? mod?.default ?? mod);
+        return crmBundle;
     },
 };

apps/server/server/templates/todo.ts

@@ -1,17 +1,19 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
 
+// Static relative import — bundle-require/esbuild inlines the Todo bundle
+// into the server's bundled config at boot time, so seeding does not rely
+// on Node resolving a `.ts` file at runtime (which `@example/app-todo`
+// would require, because workspace packages are marked external by the
+// CLI's bundler).
+import todoBundle from '../../../../examples/app-todo/objectstack.config';
 import type { ProjectTemplate } from './types.js';
 
-const dyn = (spec: string) =>
-    (new Function('s', 'return import(s)') as (s: string) => Promise<any>)(spec);
-
 export const todoTemplate: ProjectTemplate = {
     id: 'todo',
     label: 'Todo List',
     description: 'Lightweight task tracker — single-object example.',
     category: 'starter',
     async load() {
-        const mod = await dyn('../../../../examples/app-todo/objectstack.config.ts');
-        return mod.default;
+        return todoBundle;
     },
 };

apps/server/test/multi-project-e2e.test.ts

@@ -67,8 +67,8 @@ function expect(actual: any) {
 }
 
 // ---------------------------------------------------------------------------
-// Env setup must happen BEFORE importing the server — bootstrap.ts reads
-// OBJECTSTACK_DATABASE_URL when selecting the control-plane driver.
+// Env setup must happen BEFORE importing the server — objectstack.config.ts
+// reads OBJECTSTACK_DATABASE_URL when selecting the control-plane driver.
 // ---------------------------------------------------------------------------
 
 const workdir = mkdtempSync(join(tmpdir(), 'objectstack-e2e-'));

apps/server/types/template-bundles.d.ts

@@ -0,0 +1,8 @@
+// Ambient declaration for example-app template bundles statically imported
+// by `server/templates/*.ts`. Those paths live outside this package's
+// `include` scope so TS cannot discover their types; we accept `any` here
+// and rely on the `StackBundle` shape returned by the seeder at runtime.
+declare module '*/objectstack.config' {
+    const bundle: any;
+    export default bundle;
+}