allow $schema in convex.json (#43249)

Stop warning when unrecognized key `"$schema"` is found in convex.json

GitOrigin-RevId: c696b487f585c7215ace5412455ba9f6f20b8d6b

Author: thomasballinger

src/cli/lib/config.test.ts

@@ -941,4 +941,14 @@ test("parseProjectConfig - warns about unknown properties", async () => {
   const stderr4 = stderrSpy.mock.calls.map((call) => call[0]).join("");
   expect(stripVTControlCharacters(stderr4)).not.toContain("Warning");
   expect(stripVTControlCharacters(stderr4)).not.toContain("Unknown");
+
+  // No warning for $schema field (used by JSON schema validation)
+  stderrSpy.mockClear();
+  await parseProjectConfig(ctx, {
+    functions: "convex/",
+    $schema: "../../../convex/schemas/convex.schema.json",
+  });
+  const stderr5 = stderrSpy.mock.calls.map((call) => call[0]).join("");
+  expect(stripVTControlCharacters(stderr5)).not.toContain("Warning");
+  expect(stripVTControlCharacters(stderr5)).not.toContain("Unknown");
 });

src/cli/lib/config.ts

@@ -205,6 +205,9 @@ const createProjectConfigSchema = (strict: boolean) => {
     }),
     generateCommonJSApi: z.boolean().default(false),
 
+    // Optional $schema field for JSON schema validation in editors
+    $schema: z.string().optional(),
+
     // Deprecated fields that have been deprecated for years, only here so we
     // know it's safe to delete them.
     project: z.string().optional(),