@vertesia/client 0.71.0 → 0.73.0

package/src/AccountApi.ts

@@ -51,11 +51,10 @@ export default class AccountApi extends ApiTopic {
     /**
      * Fetch Invites for specific account or project
      * @param type Filter for the type of invitation, either "project" or "account"
-     * @param id ID of the project or organization to fetch invitations for
      * @returns UserInviteTokenData[]
      * */
-    listInvitation(id: string, type: "project" | "account" = "project"): Promise<TransientToken<UserInviteTokenData>[]> {
-        return this.get(`/invites/${type}/${id}`);
+    listInvitation(type: "project" | "account" = "project"): Promise<TransientToken<UserInviteTokenData>[]> {
+        return this.get(`/invites/${type}`);
     }
 
     /**

package/src/AppsApi.ts

@@ -1,5 +1,9 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import type { AppInstallation, AppInstallationKind, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData } from "@vertesia/common";
+import { ApiTopic, ClientBase, ServerError } from "@vertesia/api-fetch-client";
+import type { AppInstallation, AppInstallationKind, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData, ProjectRef, RequireAtLeastOne } from "@vertesia/common";
+
+export interface OrphanedAppInstallation extends Omit<AppInstallation, 'manifest'> {
+    manifest: null,
+}
 
 export default class AppsApi extends ApiTopic {
 
@@ -45,6 +49,40 @@ export default class AppsApi extends ApiTopic {
         return this.del(`/install/${installationId}`);
     }
 
+    /**
+     * get an app unstallation given its name or null if the app is not installed
+     * @returns 
+     */
+    getAppInstallationByName(appName: string): Promise<AppInstallationWithManifest | null> {
+        return this.get(`/installations/name/${appName}`).catch((err: ServerError) => {
+            if (err.status === 404) {
+                return null;
+            } else {
+                throw err;
+            }
+        })
+    }
+
+    /**
+     * Get the project refs where the application is visible by the current user.
+     * The application is specified either by id or by name.
+     * @param param0 
+     * @returns 
+     */
+    getAppInstallationProjects(app: RequireAtLeastOne<{ id?: string, name?: string }, 'id' | 'name'>): Promise<ProjectRef[]> {
+        if (!app.id && !app.name) {
+            throw new Error("Invalid arguments: appId or appName must be specified");
+        }
+        const query = app.id ? {
+            id: app.id
+        } : {
+            name: app.name
+        }
+        return this.get("/installations/projects", {
+            query
+        });
+    }
+
     /**
      * Get the apps installed for the current authenticated project
      * @param kind - the kind of app installations to filter by (e.g., 'agent', 'tool', etc.)
@@ -57,25 +95,22 @@ export default class AppsApi extends ApiTopic {
         });
     }
 
-
     /**
-     * Get the apps installed for the given project.
-     * @param projectId - the id of the project to get the installed apps for
-     * @param kind - the kind of app installations to filter by (e.g., 'agent', 'tool', etc.)
+     * This operation will return an array of all the found AppInstallations in the current project
+     * including orphaned installations
+     * This requires project admin since access is not checked on the insytallations.
+     * For a user level list of available installations (with user permission check) use getInstalledApps
+     * @returns 
      */
-    getInstalledAppsForProject(projectId?: string, kind?: AppInstallationKind): Promise<AppInstallationWithManifest[]> {
-        return this.get(`/installations/${projectId}`, {
-            query: {
-                kind,
-            }
-        });
+    getAllAppInstallations(): Promise<(AppInstallationWithManifest | OrphanedAppInstallation)[]> {
+        return this.get('/installations/all');
     }
 
     /**
      * List the app installations of the current project.
      */
     listInstallations(): Promise<AppInstallation[]> {
-        return this.get('/installation-refs');
+        return this.get('/installations/refs');
     }