fix(appkit): generate a registry before the first operation

Signed-off-by: ditadi <victordperd@gmail.com>

Author: ditadi

packages/appkit/src/type-generator/database/generate-operations.ts

@@ -181,10 +181,11 @@ async function contractsOf(
 /**
  * Discover `server/database/routes/*.ts`, write the lazy `routes.gen.ts` entry
  * that lists every module, and write the browser contract of each published
- * operation. Any malformed or duplicate declaration fails generation and
+ * operation. A schema-only app gets an empty registry so development can
+ * discover its first operation without restarting manually. Any malformed or duplicate declaration fails generation and
  * neutralizes the contracts; a declaration without authorization is skipped
  * with a warning, or fails in strict mode. Both files are created only while
- * the routes directory exists, and emptied once it is gone.
+ * a schema or routes directory exists, and emptied once routes are gone.
  */
 export async function generateDatabaseOperations(
   options: GenerateDatabaseOperationsOptions,
@@ -197,11 +198,14 @@ export async function generateDatabaseOperations(
       })
       ?.isDirectory() ?? false;
   const files = routesPresent ? discoverRouteModules(options.appRoot) : [];
-  if (routesPresent || fsSync.existsSync(routesFile)) {
+  const schemaPresent = fsSync.existsSync(
+    fromRoot(options.appRoot, SCHEMA_FILE),
+  );
+  if (schemaPresent || routesPresent || fsSync.existsSync(routesFile)) {
     await writeIfChanged(routesFile, renderDatabaseRoutes(files));
   }
   if (!routesPresent) {
-    if (fsSync.existsSync(options.outFile)) {
+    if (schemaPresent || fsSync.existsSync(options.outFile)) {
       await writeIfChanged(options.outFile, NEUTRAL_DATABASE_OPERATION_TYPES);
     }
     return;

packages/appkit/src/type-generator/database/tests/generate-operations.test.ts

@@ -181,9 +181,17 @@ export const databaseRoutes = {
     expect(types).not.toMatch(/^\s*import\b/m);
   });
 
-  test("creates nothing for an app without operation routes", async () => {
+  test("creates a canonical empty registry and contracts for a schema-only app", async () => {
     const root = await app();
     await generate(root);
+    expect(await read(root, ROUTES_FILE)).toContain("modules: []");
+    expect(await read(root, TYPES_FILE)).toBe(NEUTRAL_DATABASE_OPERATION_TYPES);
+  });
+
+  test("creates nothing for an app without a schema or operation routes", async () => {
+    const root = await app();
+    await fs.rm(path.join(root, "config"), { recursive: true });
+    await generate(root);
     expect(await exists(root, ROUTES_FILE)).toBe(false);
     expect(await exists(root, TYPES_FILE)).toBe(false);
   });