@faable/faable 1.5.25 → 1.5.26

package/dist/api/FaableApi.js

@@ -34,9 +34,15 @@ class FaableApi {
                 const url = e.config?.url || "";
                 if (res) {
                     const serverMessage = res.data?.message || res.statusText || "Unknown Error";
-                    throw new Error(`FaableApi ${url} ${res.status}: ${serverMessage}`, {
-                        cause: error,
-                    });
+                    const wrapped = new Error(`FaableApi ${url} ${res.status}: ${serverMessage}`, { cause: error });
+                    // Surface the structured error contract (e.g. the repository-link
+                    // flow returns { code, action }) so callers can branch on it.
+                    wrapped.status = res.status;
+                    if (res.data?.code)
+                        wrapped.code = res.data.code;
+                    if (res.data?.action)
+                        wrapped.action = res.data.action;
+                    throw wrapped;
                 }
                 else {
                     throw new Error(`FaableApi ${url} ${e.message}`, { cause: error });
@@ -69,6 +75,17 @@ class FaableApi {
     async updateApp(app_id, params) {
         return data(this.client.post(`/app/${app_id}`, params));
     }
+    async linkRepository(app_id, params) {
+        return data(this.client.post(`/app/${app_id}/link-repository`, params));
+    }
+    // Organizations/accounts where the Faable GitHub App is installed.
+    async listGithubInstallations() {
+        return data(this.client.get(`/github/installations`)).then((res) => res.installations);
+    }
+    // Top repositories for a single installation (org), optionally filtered.
+    async listGithubRepos(installation_id, params = {}) {
+        return data(this.client.get(`/github/installations/${installation_id}/repositories`, { params })).then((res) => res.repositories);
+    }
     async getMe() {
         return data(this.client.get(`/auth/me`));
     }

package/dist/commands/link/index.js

@@ -84,15 +84,37 @@ const link = {
             return;
         }
         log.info(`Linking to "${selectedApp.name}" (${selectedApp.id})...`);
-        // Update the app in the API
-        if (gitUrl) {
-            await api.updateApp(selectedApp.id, { repository: gitUrl });
-            log.info(`Updated app with github_repo: ${gitUrl}`);
+        if (!gitUrl) {
+            log.error("No git remote URL detected. Add a GitHub 'origin' remote and try again.");
+            return;
         }
-        else {
-            log.warn("No git remote URL detected. Skipping API update for github_repo.");
+        // The API verifies that the user has a connected GitHub identity AND
+        // access to the repository before persisting the link.
+        try {
+            await api.linkRepository(selectedApp.id, { repository: gitUrl });
+        }
+        catch (err) {
+            const code = err?.code;
+            switch (code) {
+                case "github_identity_missing":
+                    log.error("You have not connected a GitHub account to Faable. Connect GitHub in the dashboard, then re-run `faable link`.");
+                    break;
+                case "github_token_invalid":
+                    log.error("Your GitHub authorization has expired. Reconnect GitHub in the dashboard, then re-run `faable link`.");
+                    break;
+                case "github_installation_missing":
+                    log.error("The Faable GitHub App is not installed on your repositories. Install it from the Faable dashboard, then re-run `faable link`.");
+                    break;
+                case "github_repository_not_found":
+                    log.error(`Faable can't access "${gitUrl}". Check the repository name and that the Faable GitHub App is installed on it.`);
+                    break;
+                default:
+                    log.error(`Could not link repository: ${err?.message ?? err}`);
+            }
+            return;
         }
-        // Save locally for CLI convenience
+        log.info(`Linked repository ${gitUrl} to ${selectedApp.name}.`);
+        // Save locally for CLI convenience (only after the API confirms the link)
         Configuration.instance().saveConfig({ app_slug: selectedApp.name, app_id: selectedApp.id });
         log.info(`Successfully linked local repository to ${selectedApp.name}.`);
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faable/faable",
-  "version": "1.5.25",
+  "version": "1.5.26",
   "main": "dist/index.js",
   "license": "MIT",
   "author": "Marc Pomar <marc@faable.com>",