@faable/faable 4.19.0 → 4.20.0

package/dist/api/FaableApi.js

@@ -290,6 +290,11 @@ class FaableApi {
             headers: projectHeader(team)
         }));
     }
+    // Native GitLab (api §393): link a gitlab.com project; the api creates the
+    // push webhook with the caller's GitLab token.
+    async linkGitlab(app_id, params, team) {
+        return data(this.client.post(`/app/${app_id}/link-gitlab`, params, { headers: projectHeader(team) }));
+    }
     // Organizations/accounts where the Faable GitHub App is installed.
     async listGithubInstallations() {
         return data(this.client.get(`/github/installations`)).then(res => res.installations);

package/dist/commands/link/index.js

@@ -28,6 +28,10 @@ const link = {
             alias: "r",
             type: "string",
             description: "GitHub repository, owner/repo or its URL (defaults to the origin remote of --workdir)",
+        })
+            .option("gitlab", {
+            type: "string",
+            description: "Link a gitlab.com project instead: its Project ID (the number on its page). Needs --app and GitLab connected in the dashboard",
         })
             .option("branch", {
             alias: "b",
@@ -40,9 +44,12 @@ const link = {
             description: "Print the link as JSON: app, repository, branch and how it deploys",
         })
             .example("$0 deploy link --app web --repo acme/web", "Link acme/web to the app web: from now on a push deploys it")
+            .example("$0 deploy link --app web --gitlab 12345678", "Link that gitlab.com project to the app web: pushes deploy it")
             .showHelpOnFail(false);
     },
     handler: async (args) => {
+        if (args.gitlab !== undefined)
+            return link_gitlab(args);
         if (args.app || args.json || is_non_interactive()) {
             return link_to_app(args);
         }
@@ -147,6 +154,39 @@ const link = {
 // repository to an existing app at all (arch/deploy/cli-mcp-fallos-2026-10-16-plan.md,
 // F4; backlog §366). Driven by a program, the repository is spelled out too:
 // the origin remote of whatever directory the process runs in is a guess.
+const link_gitlab = async (args) => {
+    if (!args.app) {
+        throw new CliError("app_required", "Say which app to link: --app <id|name>.");
+    }
+    const project_id = String(args.gitlab ?? "");
+    if (!/^[0-9]+$/.test(project_id)) {
+        throw new CliError("usage", "--gitlab takes the numeric Project ID shown on the GitLab project page, not its path.");
+    }
+    const { api } = await requireApi();
+    const app = await api.getApp(await resolve_app_ref(api, args.app));
+    let linked;
+    try {
+        linked = await api.linkGitlab(app.id, { project_id, ...(args.branch ? { branch: args.branch } : {}) }, app.team);
+    }
+    catch (err) {
+        const e = err;
+        const failed = new CliError("usage", `Could not link GitLab project ${project_id} to ${app.name}: ${e.message}`, { status: e.status, action: e.action, cause: err });
+        // gitlab_identity_missing / gitlab_token_invalid / gitlab_project_not_accessible
+        if (e.code)
+            failed.code = e.code;
+        throw failed;
+    }
+    const result = {
+        app_id: app.id,
+        app_name: app.name,
+        gitlab_project: linked?.gitlab_project_path ?? project_id,
+        branch: linked?.gitlab_branch,
+    };
+    if (args.json)
+        return print_json(result);
+    log.info(`Linked ${result.gitlab_project} (GitLab) to ${app.name} (${app.id}).`);
+    log.info(`Push to deploy is on: the next push to "${result.branch ?? "the default branch"}" deploys.`);
+};
 const link_to_app = async (args) => {
     if (!args.app) {
         throw new CliError("app_required", "Say which app to link: --app <id|name>. Without a terminal there is no list to pick from.");

package/package.json

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