project hub api -- add function to wait until ready

Author: williamstein

src/packages/conat/project/api/index.ts

@@ -10,7 +10,8 @@ export interface ProjectApi {
   editor: Editor;
   jupyter: Jupyter;
   sync: Sync;
-  isRunning: () => Promise<boolean>;
+  isReady: () => Promise<boolean>;
+  waitUntilReady: () => Promise<void>;
 }
 
 const ProjectApiStructure = {
@@ -20,7 +21,11 @@ const ProjectApiStructure = {
   sync,
 } as const;
 
-export function initProjectApi(callProjectApi, isRunning): ProjectApi {
+export function initProjectApi({
+  callProjectApi,
+  isReady,
+  waitUntilReady,
+}): ProjectApi {
   const projectApi: any = {};
   for (const group in ProjectApiStructure) {
     if (projectApi[group] == null) {
@@ -36,6 +41,7 @@ export function initProjectApi(callProjectApi, isRunning): ProjectApi {
         );
     }
   }
-  projectApi.isRunning = isRunning;
+  projectApi.isReady = isReady;
+  projectApi.waitUntilReady = waitUntilReady;
   return projectApi as ProjectApi;
 }

src/packages/conat/project/api/project-client.ts

@@ -26,10 +26,14 @@ export function projectApiClient({
   }
   const subject = projectSubject({ project_id, compute_server_id, service });
 
-  const isRunning = async () => {
+  const isReady = async () => {
     return await client.interest(subject);
   };
 
+  const waitUntilReady = async ({ timeout }: { timeout?: number } = {}) => {
+    await client.waitForInterest(subject, { timeout });
+  };
+
   const callProjectApi = async ({ name, args }) => {
     return await callProject({
       client,
@@ -39,7 +43,7 @@ export function projectApiClient({
       args,
     });
   };
-  return initProjectApi(callProjectApi, isRunning);
+  return initProjectApi({ callProjectApi, isReady, waitUntilReady });
 }
 
 async function callProject({