diff --git a/module/services/frontend/code/packages/saas-ui/src/datasources/gateway.ts b/module/services/frontend/code/packages/saas-ui/src/datasources/gateway.ts
index b7d8b8a65..180b9e668 100644
--- a/module/services/frontend/code/packages/saas-ui/src/datasources/gateway.ts
+++ b/module/services/frontend/code/packages/saas-ui/src/datasources/gateway.ts
@@ -265,6 +265,17 @@ export function datasourceClientOverTransport(
// The host starts a GitHub source's first sync as it connects it.
notifySourceSyncRequested(response.datasource?.id ?? "");
},
+ async getCatalog() {
+ const response = await client.getDatasourceCatalog({});
+ return response.providers.map((provider) => ({
+ connector: provider.connector,
+ displayName: provider.displayName,
+ description: provider.description,
+ acceptsNewSources: provider.acceptsNewSources,
+ gap: provider.acceptsNewSources ? "" : provider.conformanceGap,
+ acceptsOperations: provider.acceptsOperations,
+ }));
+ },
async addPersonalApiSource(input) {
// No credential and no OAuth client: the authorization-code grant
// stores only its selector on the source, and the host resolves the
diff --git a/module/services/frontend/code/packages/saas-ui/src/datasources/queries.ts b/module/services/frontend/code/packages/saas-ui/src/datasources/queries.ts
index b249c566a..676fecdf8 100644
--- a/module/services/frontend/code/packages/saas-ui/src/datasources/queries.ts
+++ b/module/services/frontend/code/packages/saas-ui/src/datasources/queries.ts
@@ -38,6 +38,21 @@ export function useListSources(client: DatasourceClient, orgId: string) {
});
}
+/**
+ * The host's connector catalog, which providers a surface may offer. Disabled
+ * for a client that does not read it; the catalog changes only with a release.
+ */
+export function useDatasourceCatalog(client: DatasourceClient) {
+ const getCatalog = client.getCatalog?.bind(client);
+ return useQuery({
+ queryKey: ["datasource-catalog"],
+ queryFn: () => getCatalog?.() ?? [],
+ enabled: !!getCatalog,
+ retry: false,
+ staleTime: Number.POSITIVE_INFINITY,
+ });
+}
+
export function useAddGitHubSource(client: DatasourceClient) {
const queryClient = useQueryClient();
return useMutation({
diff --git a/module/services/frontend/code/packages/saas-ui/src/datasources/types.ts b/module/services/frontend/code/packages/saas-ui/src/datasources/types.ts
index 08640df4f..0b31217bf 100644
--- a/module/services/frontend/code/packages/saas-ui/src/datasources/types.ts
+++ b/module/services/frontend/code/packages/saas-ui/src/datasources/types.ts
@@ -202,6 +202,26 @@ export interface ConnectGitHubInput {
webhookSecret: string;
}
+/**
+ * One provider of the host's connector catalog (`GetDatasourceCatalog`). A
+ * surface offers a provider whose `acceptsNewSources` is true and flags the
+ * rest with their `gap`, which is the host's sentence for why it takes none.
+ */
+export interface DatasourceProviderView {
+ /** The connector's registry key, e.g. "github" or "upload". */
+ connector: string;
+ displayName: string;
+ description: string;
+ acceptsNewSources: boolean;
+ /** Empty when the provider accepts new sources. */
+ gap: string;
+ /**
+ * Whether a source of it may be connected for its operations even though it
+ * takes none to sync (the `api` provider).
+ */
+ acceptsOperations: boolean;
+}
+
/**
* The person's own `api` source, ready for `addPersonalApiSource`: an API base
* URL the person signs in to through the deployment's provider registration.
@@ -419,6 +439,11 @@ export interface DatasourceClient {
listActivity?(orgId: string, sourceId: string): Promise