chore: implement queryDataApiVersion

src/api/v4/apiv4.ts

@@ -4,6 +4,7 @@ import {
 	backendsResponseGuard,
 	binnedQueryResponseGuard,
 	channelSearchResponseGuard,
+	dataApiVersionResponseGuard,
 	eventsQueryResponseGuard,
 } from './apiv4decoders'
 
@@ -50,6 +51,14 @@ export type DataApiV4ChannelSearchResult = {
 	channels: DataApiV4ChannelSearchResultItem[]
 }
 
+/** response for a data api version query operation */
+export type DataApiV4DataApiVersionResult = {
+	data_api_version: {
+		major: number
+		minor?: number
+	}
+}
+
 /** options for an events query operation */
 export type DataApiV4EventsQueryOptions = {
 	/** the backend where the channel is stored */
@@ -169,6 +178,15 @@ export class DataApiV4Client {
 		return backendsResponseGuard(result)
 	}
 
+	/** query data api version */
+	public async queryDataApiVersion(
+		timeoutMs: number = DEFAULT_TIMEOUT
+	): Promise<DataApiV4DataApiVersionResult> {
+		const url = `${this.baseUrl}/version`
+		const result = await get(url, timeoutMs)
+		return dataApiVersionResponseGuard(result)
+	}
+
 	/** query for data (raw) */
 	public async queryEvents(
 		queryOptions: DataApiV4EventsQueryOptions,