feat(appkit): add the database runtime and harden its schema builder

packages/appkit/src/database/contract/index.ts

@@ -1,4 +1,2 @@
-export * from "./column-info";
 export * from "./registry";
-export * from "./relation";
 export * from "./wire";

packages/appkit/src/database/contract/tests/registry.test.ts

@@ -1,10 +1,5 @@
 import { describe, expectTypeOf, it } from "vitest";
-import type {
-  DatabaseRegistryEntry,
-  ReferentialAction,
-  RegisteredEntity,
-  RelationEdge,
-} from "../index";
+import type { DatabaseRegistryEntry, RegisteredEntity } from "../index";
 
 /**
  * Type-level tests for the contract. These are verified by `tsc` during
@@ -57,35 +52,3 @@ describe("DatabaseRegistryEntry shape", () => {
     expectTypeOf<DatabaseRegistryEntry>().toHaveProperty("includes");
   });
 });
-
-describe("RelationEdge shape", () => {
-  it("requires the from/to columns and allows optional referential actions", () => {
-    const edge: RelationEdge = {
-      fromColumn: "author_id",
-      toTable: "users",
-      toColumn: "id",
-      onDelete: "cascade",
-      onUpdate: "no action",
-    };
-    expectTypeOf(edge.fromColumn).toEqualTypeOf<string>();
-    expectTypeOf(edge.toTable).toEqualTypeOf<string>();
-    expectTypeOf(edge.toColumn).toEqualTypeOf<string>();
-    expectTypeOf(edge.onDelete).toEqualTypeOf<ReferentialAction | undefined>();
-    expectTypeOf(edge.onUpdate).toEqualTypeOf<ReferentialAction | undefined>();
-  });
-
-  it("accepts a minimal edge without referential actions", () => {
-    const edge: RelationEdge = {
-      fromColumn: "author_id",
-      toTable: "users",
-      toColumn: "id",
-    };
-    expectTypeOf(edge).toMatchTypeOf<RelationEdge>();
-  });
-
-  it("pins the referential-action union", () => {
-    expectTypeOf<ReferentialAction>().toEqualTypeOf<
-      "cascade" | "set null" | "set default" | "restrict" | "no action"
-    >();
-  });
-});

packages/appkit/src/database/contract/wire.ts

@@ -1,14 +1,13 @@
 /** Max number of values allowed in an `in.(…)` list. */
 export const IN_CAP = 100;
-/** Hard ceiling for `.limit()` clamp. */
+/** Hard ceiling for a runtime query limit. */
 export const MAX_LIMIT = 500;
 /** Default page size when no `.limit()` is supplied. */
 export const DEFAULT_LIMIT = 50;
 /** Max number of relations resolvable in a single `.include()`. */
 export const MAX_INCLUDES = 10;
-
 /** Filter operators usable in the runtime WHERE translator and the `where` spec type. */
-export const FILTER_OPERATORS = [
+export const FILTER_OPERATORS = Object.freeze([
   "eq",
   "neq",
   "gt",
@@ -19,7 +18,7 @@ export const FILTER_OPERATORS = [
   "ilike",
   "in",
   "is",
-] as const;
+] as const);
 
 export type FilterOperator = (typeof FILTER_OPERATORS)[number];