test: define schema contract for topic fact graph

src/types/api.ts

@@ -0,0 +1,22 @@
+import type { JsonValue, TopicCategory, TopicGranularity } from './domain';
+
+export interface UpsertTopicInput {
+  name: string;
+  category?: TopicCategory;
+  granularity?: TopicGranularity;
+  description?: string | null;
+  metadata?: JsonValue | null;
+}
+
+export interface TopicLinkInput extends UpsertTopicInput {
+  role?: string | null;
+}
+
+export interface AddFactInput {
+  statement: string;
+  summary?: string | null;
+  source?: string | null;
+  confidence?: number | null;
+  metadata?: JsonValue | null;
+  topics: TopicLinkInput[];
+}