feat: implement permission-aware search baseline

webui/src/api/search.ts

@@ -0,0 +1,70 @@
+import {
+  apiFetch,
+  apiPath,
+  type ApiSettings
+} from "@govoplan/core-webui";
+
+
+export type SearchExternalReference = {
+  system: string;
+  object_type: string;
+  object_id: string;
+  maturity: string;
+  connector_id?: string | null;
+  canonical_url?: string | null;
+};
+
+export type SearchResult = {
+  provider_id: string;
+  module_id: string;
+  resource_type: string;
+  resource_id: string;
+  title: string;
+  summary?: string | null;
+  url: string;
+  score: number;
+  highlights: string[];
+  breadcrumbs: string[];
+  external_reference?: SearchExternalReference | null;
+  metadata: Record<string, unknown>;
+};
+
+export type SearchResponse = {
+  query: string;
+  results: SearchResult[];
+  diagnostics: Array<{
+    provider_id: string;
+    status: "unavailable";
+    message: string;
+  }>;
+};
+
+export type SearchRequest = {
+  query: string;
+  modules?: string[];
+  resourceTypes?: string[];
+  contextKind?: "global" | "module" | "resource";
+  contextId?: string;
+  limit?: number;
+  offset?: number;
+};
+
+export function search(
+  settings: ApiSettings,
+  request: SearchRequest,
+  signal?: AbortSignal
+): Promise<SearchResponse> {
+  return apiFetch<SearchResponse>(
+    settings,
+    apiPath("/api/v1/search", {
+      q: request.query,
+      module: request.modules,
+      resource_type: request.resourceTypes,
+      context_kind: request.contextKind,
+      context_id: request.contextId,
+      limit: request.limit,
+      offset: request.offset
+    }),
+    { signal }
+  );
+}