@molecule/api-code-sandbox-flyio 1.3.2 → 1.3.4

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-17T03:41:21.100Z
+Generated: 2026-10-25T20:03:27.883Z
 -->
 
 # @molecule/api-code-sandbox-flyio
@@ -389,7 +389,7 @@ interface FlyioConfig {
    * `SandboxProvider.defaultIdleAction`. A caller can override it for one sandbox
    * with `SandboxConfig.idleAction` and restore this value afterwards with
    * `Sandbox.setIdleAction` — which is what a production deploy does so its
-   * destination cannot suspend mid-copy (m103, 2026-10-17).
+   * destination cannot suspend mid-copy.
    */
   autostop?: 'off' | 'stop' | 'suspend'
   /**

package/dist/exec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAKjD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAW5C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAkB,CAAA;AA6BxD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAY5C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,0FAA0F;AAC1F,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;AAE7F;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAiBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAmDD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAqBrB"}
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAKjD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAW5C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAkB,CAAA;AA4BxD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAA;AAY5C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,0FAA0F;AAC1F,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;AAE7F;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAiBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAmDD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAqBrB"}

package/dist/exec.js

@@ -55,10 +55,9 @@ export const MAX_CAPTURED_OUTPUT_BYTES = 5 * 1024 * 1024;
  * Fly documents NO output ceiling for the Machines API: the exec response's
  * `flydv1.ExecResponse` schema types `stdout` and `stderr` as plain,
  * unconstrained strings (https://docs.machines.dev/openapi.json). The live API
- * still returns SHORT output with `exit_code: 0` once a response is large —
- * measured 2026-10-18 in production (X1 flash-m175): one read of a
- * 1,421,432-byte database file came back 897,144 bytes long, exactly one
- * 512 KiB slice missing, with no error at all. So the collector asks for no
+ * still returns SHORT output with `exit_code: 0` once a response is large: one
+ * read of a 1,421,432-byte database file came back 897,144 bytes long, exactly
+ * one 512 KiB slice missing, with no error at all. So the collector asks for no
  * more than this per response and checks every response's decoded length
  * against what it asked for, shrinking the request when the transport cuts it.
  */

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAYV,eAAe,EAGhB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAAE,YAAY,EAAgC,MAAM,UAAU,CAAA;AAwBrE,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAEhG,OAAO,KAAK,EAIV,WAAW,EAUZ,MAAM,YAAY,CAAA;AAkBnB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E;AAkyFD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GACzB,eAAe,CAEjB"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAYV,eAAe,EAGhB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAAE,YAAY,EAAgC,MAAM,UAAU,CAAA;AAwBrE,OAAO,EAAmD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAEhG,OAAO,KAAK,EAIV,WAAW,EAUZ,MAAM,YAAY,CAAA;AAkBnB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE5E;AA6yFD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,YAAY,EACrB,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,GACzB,eAAe,CAEjB"}

package/dist/provider.js

@@ -7,7 +7,8 @@
  * @module
  */
 import { createHash } from 'node:crypto';
-import { gzipSync } from 'node:zlib';
+import { promisify } from 'node:util';
+import { gzip } from 'node:zlib';
 import { getLogger } from '@molecule/api-bond';
 import { t } from '@molecule/api-i18n';
 import { FlyApiClient, FlyApiError, normalizeApiUrl } from './api.js';
@@ -230,10 +231,9 @@ const EXEC_BODY_MACHINE_NOT_RUNNING = /machine not running/i;
  * Attempts for one exec when Fly answers a transient 412 — either body of
  * {@link isTransientExecPrecondition}. Four attempts over the three backoffs
  * below is under 12 s of waiting, against the ~75 s each fresh production
- * deploy costs when this is left to a caller: X1 run flash-m85 (2026-10-16)
- * lost three consecutive deploys, and the run, to the dropped connection;
- * flash-m94 (2026-10-16) lost 65 s and a whole redeploy to the same budget not
- * covering `machine not running` on a Machine Fly reported `started`.
+ * deploy costs when this is left to a caller: a dropped connection has cost
+ * three consecutive deploys, and a budget that did not cover `machine not
+ * running` on a Machine Fly reported `started` has cost a whole redeploy.
  */
 const EXEC_PRECONDITION_ATTEMPTS = 4;
 /**
@@ -272,6 +272,13 @@ const IMPORT_WRITE_CHUNK_BASE64 = 12_000;
  * the single download happen back-to-back.
  */
 const IMPORT_PRESIGN_EXPIRY_SECONDS = 3600;
+/**
+ * zlib's gzip on the libuv thread pool. {@link Sandbox.importFiles} compresses
+ * a whole deploy archive (hundreds of MB), and the synchronous form ran on the
+ * caller's event loop for its full duration — seconds in which a server process
+ * hosting this provider answered no request at all.
+ */
+const gzipAsync = promisify(gzip);
 /** Extra seconds allowed for the probe exec beyond its connection budget. */
 const PROBE_EXEC_HEADROOM_SECONDS = 10;
 /**
@@ -2336,7 +2343,8 @@ class FlyioSandboxProvider {
              *
              * The Fly Machines exec endpoint is a single request/response with no
              * stdin, so the archive cannot be piped to `tar` directly. It is buffered,
-             * gzipped (fewer bytes = fewer exec round trips over the base64 channel),
+             * gzipped on the thread pool, never on the caller's event loop (fewer
+             * bytes = fewer exec round trips over the base64 channel),
              * written to a temp file in `WRITE_CHUNK_BASE64`-sized pieces the same way
              * `writeFile` does, then extracted.
              *
@@ -2351,7 +2359,10 @@ class FlyioSandboxProvider {
                 const parts = [];
                 for await (const chunk of archive)
                     parts.push(Buffer.from(chunk));
-                const gz = gzipSync(Buffer.concat(parts));
+                // Off the event loop: the archive is a whole deploy artifact, and
+                // compressing it synchronously stalled every other request this process
+                // was serving for as long as the compression took.
+                const gz = await gzipAsync(Buffer.concat(parts));
                 const quotedPath = shellQuote(path);
                 const failIfError = (result, step) => {
                     if (result.exitCode !== 0) {

package/dist/types.d.ts

@@ -116,7 +116,7 @@ export interface FlyioConfig {
      * `SandboxProvider.defaultIdleAction`. A caller can override it for one sandbox
      * with `SandboxConfig.idleAction` and restore this value afterwards with
      * `Sandbox.setIdleAction` — which is what a production deploy does so its
-     * destination cannot suspend mid-copy (m103, 2026-10-17).
+     * destination cannot suspend mid-copy.
      */
     autostop?: 'off' | 'stop' | 'suspend';
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-code-sandbox-flyio",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Fly.io Machines (Firecracker microVM) code sandbox provider",
   "type": "module",
   "main": "dist/index.js",