@molecule/api-deploy-rollout-fly 0.0.1-stage → 2.0.0

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-19T18:05:45.688Z
+Generated: 2026-10-20T12:05:18.845Z
 -->
 
 # @molecule/api-deploy-rollout-fly
@@ -216,21 +216,21 @@ function parseFlyMachineList(json: string): FlyMachine[]
 Validate a Machine list as a rollout target set and return what to act on.
 
 Every Machine must be started (a stopped one cannot be reached over SSH, and its
-patch volume would keep an older build), and all must run the SAME image and
-configuration version: a mixed set is a deploy in flight, and changing half of it
-would record a binding that is already stale on the other half.
+patch volume would keep an older build), and all must run the SAME image.
+Configuration versions identify individual Machine instances, so a healthy
+rolling deployment has a different version on each Machine. Preserve those
+versions by id so callers can bind a patch to the Machine receiving it.
 
 ```typescript
-function assertHomogeneousFlyMachines(machines: readonly FlyMachine[]): {
-  ids: string[]
-  imageRef: string
-  version: string
-}
+function assertHomogeneousFlyMachines(
+  machines: readonly FlyMachine[],
+  options?: { appName?: string },
+): { ids: string[]; imageRef: string; machineVersions: Record<string, string> }
 ```
 
 - `machines` — Parsed Machines.
 
-**Returns:** The target set's ids, image ref and configuration version.
+**Returns:** The target set's ids, shared image ref and each Machine's version.
 
 #### `listFlyMachines(options)`
 
@@ -310,7 +310,8 @@ Peer dependencies:
 - **`parseFlyMachineList` is the only JSON the adapter trusts.** A Machine list
   that is not an array is an error, never an empty set.
 - **A mixed set is refused.** `assertHomogeneousFlyMachines` rejects Machines on
-  different images or configuration versions: that is a deploy in flight, and
-  changing half of it records a binding that is already stale on the other half.
+  different images. Each Machine has its own configuration version; the returned
+  `machineVersions` maps Machine ids to those versions. Bind each patch to its
+  target's version so a later image or configuration update retires it.
 - **A restart that parks is started explicitly.** A Machine that comes back
   `stopped`/`suspended` after a restart is started, not left parked.

package/dist/fly.d.ts

@@ -80,12 +80,13 @@ export declare const parseFlyMachineList: (json: string) => FlyMachine[];
  * Validate a Machine list as a rollout target set and return what to act on.
  *
  * Every Machine must be started (a stopped one cannot be reached over SSH, and its
- * patch volume would keep an older build), and all must run the SAME image and
- * configuration version: a mixed set is a deploy in flight, and changing half of it
- * would record a binding that is already stale on the other half.
+ * patch volume would keep an older build), and all must run the SAME image.
+ * Configuration versions identify individual Machine instances, so a healthy
+ * rolling deployment has a different version on each Machine. Preserve those
+ * versions by id so callers can bind a patch to the Machine receiving it.
  *
  * @param machines - Parsed Machines.
- * @returns The target set's ids, image ref and configuration version.
+ * @returns The target set's ids, shared image ref and each Machine's version.
  * @throws {Error} A plain, operator-readable refusal.
  */
 export declare const assertHomogeneousFlyMachines: (machines: readonly FlyMachine[], options?: {
@@ -93,7 +94,7 @@ export declare const assertHomogeneousFlyMachines: (machines: readonly FlyMachin
 }) => {
     ids: string[];
     imageRef: string;
-    version: string;
+    machineVersions: Record<string, string>;
 };
 /** Where and how the adapter reaches one Fly app. */
 export interface FlyMachinesOptions {

package/dist/fly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fly.d.ts","sourceRoot":"","sources":["../src/fly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EAChB,MAAM,8BAA8B,CAAA;AAErC,uDAAuD;AACvD,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,KAAG,gBAiB7D,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAa5D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,UAAU,EAwC5D,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,SAAS,UAAU,EAAE,EAC/B,UAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,KACjC;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAyCpD,CAAA;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,2DAA2D;IAC3D,GAAG,CAAC,EAAE,gBAAgB,CAAA;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAU,SAAS,kBAAkB,KAAG,OAAO,CAAC,UAAU,EAAE,CASvF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,+DAA+D;IAC/D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,kBAAkB,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3E,WAAW,MAAM,KAChB,OAAO,CAAC,OAAO,CAkBjB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,iBAAiB,KACzB,uBAAuB,CAAC,UAAU,CAqBpC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,iEAAiE;IACjE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC9C,+DAA+D;IAC/D,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD,wDAAwD;IACxD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,uDAAuD;IACvD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,kBAAkB,KAC1B,gBAAgB,CAAC,UAAU,CA8B7B,CAAA"}
+{"version":3,"file":"fly.d.ts","sourceRoot":"","sources":["../src/fly.ts"],"names":[],"mappings":"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"}

package/dist/fly.js

@@ -126,12 +126,13 @@ export const parseFlyMachineList = (json) => {
  * Validate a Machine list as a rollout target set and return what to act on.
  *
  * Every Machine must be started (a stopped one cannot be reached over SSH, and its
- * patch volume would keep an older build), and all must run the SAME image and
- * configuration version: a mixed set is a deploy in flight, and changing half of it
- * would record a binding that is already stale on the other half.
+ * patch volume would keep an older build), and all must run the SAME image.
+ * Configuration versions identify individual Machine instances, so a healthy
+ * rolling deployment has a different version on each Machine. Preserve those
+ * versions by id so callers can bind a patch to the Machine receiving it.
  *
  * @param machines - Parsed Machines.
- * @returns The target set's ids, image ref and configuration version.
+ * @returns The target set's ids, shared image ref and each Machine's version.
  * @throws {Error} A plain, operator-readable refusal.
  */
 export const assertHomogeneousFlyMachines = (machines, options = {}) => {
@@ -157,16 +158,15 @@ export const assertHomogeneousFlyMachines = (machines, options = {}) => {
         }
     }
     const imageRefs = [...new Set(machines.map((machine) => machine.imageRef))];
-    const versions = [...new Set(machines.map((machine) => machine.version))];
-    if (imageRefs.length > 1 || versions.length > 1) {
+    if (imageRefs.length > 1) {
         throw new Error(`${app} Machines are running MIXED builds ` +
-            `(images: ${imageRefs.join(', ')}; versions: ${versions.join(', ')}) — a deploy is in ` +
+            `(images: ${imageRefs.join(', ')}) — a deploy is in ` +
             'flight or a Machine was started separately. Wait for it to settle, then re-run.');
     }
     return {
         ids: machines.map((machine) => machine.id),
         imageRef: imageRefs[0],
-        version: versions[0],
+        machineVersions: Object.fromEntries(machines.map((machine) => [machine.id, machine.version])),
     };
 };
 /**

package/dist/index.d.ts

@@ -27,8 +27,9 @@
  * - **`parseFlyMachineList` is the only JSON the adapter trusts.** A Machine list
  *   that is not an array is an error, never an empty set.
  * - **A mixed set is refused.** `assertHomogeneousFlyMachines` rejects Machines on
- *   different images or configuration versions: that is a deploy in flight, and
- *   changing half of it records a binding that is already stale on the other half.
+ *   different images. Each Machine has its own configuration version; the returned
+ *   `machineVersions` maps Machine ids to those versions. Bind each patch to its
+ *   target's version so a later image or configuration update retires it.
  * - **A restart that parks is started explicitly.** A Machine that comes back
  *   `stopped`/`suspended` after a restart is started, not left parked.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -27,8 +27,9 @@
  * - **`parseFlyMachineList` is the only JSON the adapter trusts.** A Machine list
  *   that is not an array is an error, never an empty set.
  * - **A mixed set is refused.** `assertHomogeneousFlyMachines` rejects Machines on
- *   different images or configuration versions: that is a deploy in flight, and
- *   changing half of it records a binding that is already stale on the other half.
+ *   different images. Each Machine has its own configuration version; the returned
+ *   `machineVersions` maps Machine ids to those versions. Bind each patch to its
+ *   target's version so a later image or configuration update retires it.
  * - **A restart that parks is started explicitly.** A Machine that comes back
  *   `stopped`/`suspended` after a restart is started, not left parked.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-deploy-rollout-fly",
-  "version": "0.0.1-stage",
+  "version": "2.0.0",
   "description": "Fly Machines provider bond for @molecule/api-deploy-rollout: in-place restarts with a restore path and grow-then-shrink clones, over an injected flyctl runner.",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,7 @@
     "@molecule/api-deploy-rollout": "^1.0.0"
   },
   "devDependencies": {
-    "@molecule/api-deploy-rollout": "1.0.0",
+    "@molecule/api-deploy-rollout": "1.1.0",
     "@types/node": "26.1.2",
     "typescript": "6.0.3",
     "vitest": "4.1.11"