@faable/faable 1.24.0 → 1.25.0

package/dist/api/FaableApi.js

@@ -1,5 +1,13 @@
 import { create_base_client } from './base_client.js';
 
+// Socket-level failures where no response ever arrived: the connection died
+// before the server produced anything, so a single retry is safe for any
+// method (a reset mid-flight means the request was not processed).
+const RESET_CODES = new Set(["ECONNRESET", "EPIPE"]);
+const RETRY_DELAY_MS = 300;
+const is_connection_reset = (e) => e.isAxiosError &&
+    !e.response &&
+    (RESET_CODES.has(e.code ?? "") || e.message.includes("socket hang up"));
 const firstPage = async (res) => {
     const items = (await res).results;
     return items;
@@ -27,6 +35,20 @@ class FaableApi {
             // Do something with request error
             return Promise.reject(error);
         });
+        // Registered before the error-wrapping interceptor so it sees the raw
+        // axios error. Retries once per request; the retried call re-enters the
+        // full chain (auth headers included).
+        const client = this.client;
+        this.client.interceptors.response.use(undefined, async (error) => {
+            const e = error;
+            const config = e.config;
+            if (config && !config._retried && is_connection_reset(e)) {
+                config._retried = true;
+                await new Promise((r) => setTimeout(r, RETRY_DELAY_MS));
+                return client.request(config);
+            }
+            throw error;
+        });
         this.client.interceptors.response.use((response) => response, (error) => {
             const e = error;
             if (e.isAxiosError) {

package/dist/api/strategies/oidc.strategy.js

@@ -22,14 +22,14 @@ const exchangeGithubOidcToken = async (gh_token, target_app_id) => {
             // actionable next step.
             if (status === 404) {
                 throw new Error('No app linked to this repository. Run "faable link" locally to link it, ' +
-                    "or link it from the dashboard (https://dashboard.faable.com).");
+                    "or link it from the dashboard (https://dashboard.faable.com).", { cause: err });
             }
             // Monorepo: several apps are linked to the same repository.
             if (status === 400) {
                 throw new Error(serverMessage ||
-                    "This repository has multiple linked apps. Specify which one with `faable deploy <app_id>`.");
+                    "This repository has multiple linked apps. Specify which one with `faable deploy <app_id>`.", { cause: err });
             }
-            throw new Error(`Faable OIDC token exchange failed (${status ?? "network error"})${serverMessage ? `: ${serverMessage}` : ""}`);
+            throw new Error(`Faable OIDC token exchange failed (${status ?? "network error"})${serverMessage ? `: ${serverMessage}` : ""}`, { cause: err });
         }
         throw err;
     }

package/dist/commands/deploy/index.js

@@ -3,6 +3,7 @@ import { Configuration } from '../../lib/Configuration.js';
 import { log } from '../../log.js';
 import { link } from '../link/index.js';
 import { git_context } from './git_context.js';
+import { propose_release } from './release_version.js';
 import { deploy_remote } from './remote/index.js';
 import { resolve_app_id } from './resolve_app_id.js';
 import { secrets } from './secrets/index.js';
@@ -25,6 +26,10 @@ const deploy = {
             alias: 'w',
             type: 'string',
             description: 'Working directory'
+        })
+            .option('release', {
+            type: 'string',
+            description: 'Release version to record on the deployment (injected as FAABLE_RELEASE). Defaults to FAABLE_RELEASE env or the latest git tag'
         })
             .showHelpOnFail(false);
     },
@@ -47,6 +52,13 @@ const deploy = {
         // Capture the commit/ref/actor so the deployment records which commit
         // it came from and who pushed it (env in CI, git fallback locally).
         const git = await git_context({ workdir });
+        // Propose the release version (--release > FAABLE_RELEASE > git tag).
+        // Optional: when absent the platform injects no FAABLE_RELEASE and the
+        // app falls back to its own version source.
+        const proposed = await propose_release({ workdir, explicit: args.release });
+        if (proposed) {
+            log.info(`🏷️ Release: ${proposed.release} (from ${proposed.source})`);
+        }
         // Remote build only (arch/deploy/remote-artifact-default-cutover.md): the
         // CLI no longer builds — it uploads the source and the platform builds
         // server-side (framework detection, buildpacks, artifact/image output all
@@ -54,7 +66,13 @@ const deploy = {
         // (build_mode=local opt-out, or the global kill-switch off) or a build
         // error throws and exits red.
         log.info(`🚀 Deploying "${app.name}" (${app.id})`);
-        const deployment = await deploy_remote({ api, app, git, workdir });
+        const deployment = await deploy_remote({
+            api,
+            app,
+            git,
+            release: proposed?.release,
+            workdir
+        });
         const dashboard_url = `https://dashboard.faable.com/deploy/${app.team}/app/${app.id}`;
         log.info(`Preparing to deploy in faable cloud · ${deployment.id}`);
         log.info(`📊 View it in the dashboard -> ${dashboard_url}`);

package/dist/commands/deploy/release_version.js

@@ -0,0 +1,53 @@
+import { exec } from 'child_process';
+
+// Quiet git runner, same contract as git_context's: trimmed stdout or
+// undefined on any failure. A deploy must never fail because a release
+// version couldn't be proposed.
+const gitRunner = (workdir) => command => new Promise(resolve => {
+    exec(command, { cwd: workdir }, (err, stdout) => {
+        if (err)
+            return resolve(undefined);
+        const out = stdout?.toString().trim();
+        resolve(out || undefined);
+    });
+});
+// Loose version shape: "starts like semver". Filters out non-version tags
+// (e.g. "nightly", "deploy-2026-07-01") when falling back to git describe;
+// explicit values (--release / FAABLE_RELEASE) are NEVER validated — the
+// platform treats release as free text.
+const looksLikeVersion = (v) => /^\d+\.\d+\.\d+/.test(v);
+const stripV = (tag) => tag.replace(/^v/, "");
+/**
+ * Propose the release version for a deploy (Sentry propose-version pattern):
+ * explicit `--release` > `FAABLE_RELEASE` env > latest reachable git tag
+ * (`v1.2.3` or `1.2.3`, e.g. the tag semantic-release created) > undefined.
+ * When undefined the field is omitted from the deployment and the platform
+ * injects no FAABLE_RELEASE — the app falls back to its own version source.
+ * No SHA fallback: the commit already travels as `github_commit`.
+ */
+const propose_release = async (opts) => {
+    const env = opts?.env ?? process.env;
+    const run = opts?.run ?? gitRunner(opts?.workdir);
+    if (opts?.explicit)
+        return { release: opts.explicit, source: "--release" };
+    if (env.FAABLE_RELEASE)
+        return { release: env.FAABLE_RELEASE, source: "FAABLE_RELEASE env" };
+    // Latest tag reachable from HEAD. Try version-shaped tags first so a
+    // repo that also tags non-releases still resolves; retry unfiltered for
+    // repos whose release tags carry no `v` prefix.
+    for (const cmd of [
+        `git describe --tags --abbrev=0 --match "v[0-9]*"`,
+        `git describe --tags --abbrev=0`,
+    ]) {
+        const tag = await run(cmd);
+        if (!tag)
+            continue;
+        const version = stripV(tag);
+        if (looksLikeVersion(version)) {
+            return { release: version, source: `git tag ${tag}` };
+        }
+    }
+    return undefined;
+};
+
+export { propose_release };

package/dist/commands/deploy/remote/index.js

@@ -15,7 +15,7 @@ import { upload_missing_blobs } from './upload.js';
  * BUILD_ERROR — throws so the command exits red.
  */
 const deploy_remote = async (props) => {
-    const { api, app, git, workdir } = props;
+    const { api, app, git, release, workdir } = props;
     log.info(`☁️ Remote build`);
     const manifest = await collect_manifest(workdir);
     log.info(`🗂️ ${manifest.length} files in the source manifest`);
@@ -25,6 +25,7 @@ const deploy_remote = async (props) => {
     const deployment = await api.createDeployment({
         app_id: app.id,
         source: { manifest },
+        ...(release ? { release } : {}),
         ...git,
     });
     log.info(`Preparing to build in faable cloud · ${deployment.id}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faable/faable",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "main": "dist/index.js",
   "license": "MIT",
   "author": "Marc Pomar <marc@faable.com>",
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "@actions/core": "^3.0.0",
-    "axios": "^1.13.2",
+    "axios": "^1.18.1",
     "fs-extra": "^11.3.2",
     "handlebars": "^4.7.8",
     "open": "^11.0.0",