@bakery-framework/cli 2.0.1 → 2.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bakery-framework/cli",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Bakery entry point and process supervision: mode dispatch, dev watcher, cluster.",
   "keywords": [
     "bakery",
@@ -39,10 +39,10 @@
     "bun": ">=1.4.0"
   },
   "dependencies": {
-    "@bakery-framework/core": "^2.0.1"
+    "@bakery-framework/core": "^2.0.2"
   },
   "peerDependencies": {
-    "@bakery-framework/orm": "^2.0.1"
+    "@bakery-framework/orm": "^2.0.2"
   },
   "peerDependenciesMeta": {
     "@bakery-framework/orm": {

package/src/index.ts

@@ -30,6 +30,7 @@ const threadsOption = parseThreadsOption(process.argv.slice(2))
 if (process.argv.includes('--help') || process.argv.includes('-h')) {
   console.log(`
 Usage: bakery [--dev] [--sync] [--threads N] [--port N]
+       bakery --types
 
 Runs the application in the current directory: the one whose
 \`server.config.ts\` sits beside it.
@@ -37,6 +38,10 @@ Runs the application in the current directory: the one whose
 Flags:
   --dev             Development: a supervisor that watches files, compiles on
                     demand and reloads the browser. Without it, production.
+  --types           Write the TypeScript projects (.cache/tsconfig/ and
+                    tsconfig.bakery.json) and exit, without starting a server.
+                    Every dev boot does the same; a fresh clone or a CI job
+                    needs it before tsc can find them.
   --sync, -s        Run the schema sync before starting. Requires
                     @bakery-framework/orm; it is an error rather than a skip
                     when that is missing, because asking for a sync and
@@ -52,6 +57,13 @@ Schema commands have their own help: \`bun run db:sync --help\`.
   process.exit(0)
 }
 
+// Before any mode takes over, for the same reason as `--help`: it is a
+// command, not a server, and every branch below starts one.
+if (process.argv.includes('--types')) {
+  const { writeTypes } = await import('./write-types')
+  process.exit(await writeTypes())
+}
+
 // Before any mode takes over, and before the config is read: `applyPortFlag`
 // writes `process.env.PORT`, which is what the worker, the startup banner and
 // the dev master's advertised URL all resolve from, and what the spawned dev

package/src/write-types.ts

@@ -0,0 +1,56 @@
+import { errorMsg, serveLog } from '@bakery-framework/core/logger'
+
+/**
+ * `bakery --types`: the TypeScript projects a dev boot writes, without the boot.
+ *
+ * The app's `tsconfig.json` reaches its scope projects through
+ * `tsconfig.bakery.json`, and both that file and `.cache/tsconfig/` are
+ * generated. A fresh clone has neither, so `tsc` stops at TS6053 and an editor
+ * leaves every file in an inferred project until something writes them. This
+ * is that something, for a clone, a CI job or a `typecheck` script.
+ *
+ * **Not the whole dev init.** `dev.ts` runs `setupPlugins()` first because a
+ * plugin's `setup()` may add import-map entries, but a setup also does work
+ * (analytics registers a shutdown hook and starts loading its data), and
+ * nothing a setup adds today changes what this writes: the one plugin that
+ * touches the import map, plugin-vue, maps a served URL, which the paths sync
+ * skips. The projects come from each plugin's `tsconfig.project`, which is on
+ * the config and needs no setup.
+ *
+ * **It checks its own result.** `syncTSConfigProjects` logs a failure rather
+ * than throwing, so a dev boot never dies over a tsconfig, and that would let
+ * this exit 0 having written nothing: a step a CI job trusts, passing when it
+ * did not work. So the chain file is read back, and every project it lists
+ * has to exist.
+ *
+ * Returns the exit code.
+ */
+export async function writeTypes(): Promise<number> {
+  try {
+    const { initConfig } = await import('@bakery-framework/core/core/config')
+    const { syncTSConfigPaths, syncTSConfigProjects } = await import(
+      '@bakery-framework/core/compiler/tsconfig-sync'
+    )
+
+    await initConfig()
+    await syncTSConfigPaths()
+    await syncTSConfigProjects()
+
+    const chain = Bun.file(`${process.cwd()}/tsconfig.bakery.json`)
+    if (!(await chain.exists())) {
+      throw new Error('tsconfig.bakery.json was not written')
+    }
+    const { references } = (await chain.json()) as {
+      references?: { path: string }[]
+    }
+    for (const { path } of references ?? []) {
+      if (!(await Bun.file(`${process.cwd()}/${path}`).exists())) {
+        throw new Error(`${path} is listed in tsconfig.bakery.json but missing`)
+      }
+    }
+    return 0
+  } catch (error: any) {
+    serveLog.UNHANDLED_ERR({ error: `bakery --types: ${errorMsg(error)}` })
+    return 1
+  }
+}