swarm-deploy 0.3.1 → 0.4.2

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { ERRORS, SwarmDeployError, type ErrorCode } from './errors.js';
 export type { Binary, BinaryInput, Digest, FingerprintEvent, KeyPair, Logger, PublicKey, PublicKeyInput, Seed, SeedInput, ServerScheduler } from './types.js';
 export { parseSeed, parsePublicKey, generateSeed, keyPairFromSeed, publicKeyFromSeed } from './identity.js';
-export type { AfterCommitContext, BeforeCommitContext, HookArtifact, HookFailureContext, HookFailurePhase, ServerHooks } from './hooks.js';
+export type { AfterCommitContext, AfterLinkContext, BeforeCommitContext, HookArtifact, HookFailureContext, HookFailurePhase, HookLink, HookLinkMode, HookLinkStatus, HookLinkTrigger, ServerHooks } from './hooks.js';
 export { fixedSeriesKey, type ReleaseCoordinates, type VersionGranularity } from './release.js';
 export { parseAllowlist } from './allowlist.js';
 export type { ArtifactKind } from './types.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAsE;AAA7D,mGAAA,MAAM,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAcjC,6CAMsB;AALpB,wGAAA,SAAS,OAAA;AACT,6GAAA,cAAc,OAAA;AACd,2GAAA,YAAY,OAAA;AACZ,8GAAA,eAAe,OAAA;AACf,gHAAA,iBAAiB,OAAA;AAUnB,2CAA+F;AAAtF,4GAAA,cAAc,OAAA;AACvB,+CAA+C;AAAtC,8GAAA,cAAc,OAAA;AAIvB,yCAgBoB;AAflB,mGAAA,MAAM,OAAA;AAgBR,yCAeoB;AAdlB,mGAAA,MAAM,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAAsE;AAA7D,mGAAA,MAAM,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAcjC,6CAMsB;AALpB,wGAAA,SAAS,OAAA;AACT,6GAAA,cAAc,OAAA;AACd,2GAAA,YAAY,OAAA;AACZ,8GAAA,eAAe,OAAA;AACf,gHAAA,iBAAiB,OAAA;AAenB,2CAA+F;AAAtF,4GAAA,cAAc,OAAA;AACvB,+CAA+C;AAAtC,8GAAA,cAAc,OAAA;AAIvB,yCAgBoB;AAflB,mGAAA,MAAM,OAAA;AAgBR,yCAeoB;AAdlB,mGAAA,MAAM,OAAA"}

package/dist/server.d.ts

@@ -16,7 +16,7 @@ declare const FINGERPRINT_LENGTH = 12;
 /**
  * How many transfers may owe a deferred post-commit retention pass at once.
  *
- * The set grows only when an `afterCommit` hook fails after a durable commit,
+ * The set grows only when an `afterCommit` or `afterLink` hook fails after a durable commit,
  * and entries are removed as soon as a retry succeeds, so reaching the bound
  * means a persistently failing hook. Capping it at the connection ceiling
  * keeps a broken deployment step from growing server memory without limit.
@@ -97,6 +97,12 @@ export interface ServerLinkEvent extends FingerprintEvent {
     name: string;
     status: 'linked' | 'unchanged' | 'rejected' | 'failed';
     reason?: ErrorCode;
+    /**
+     * The durable link outcome when it already applied before the request
+     * failed: `failed` with reason `HOOK_FAILED` means the link did change (or
+     * already matched) and only its `afterLink` hook failed.
+     */
+    result?: 'LINKED' | 'UNCHANGED';
 }
 export interface ServerEventMap {
     authentication: AuthenticationEvent;
@@ -164,7 +170,7 @@ export declare class Server extends EventEmitter {
     private readonly activeUploads;
     /**
      * Transfer IDs this process committed but whose deferred post-commit
-     * retention is still owed because `afterCommit` has not yet succeeded. Only
+     * retention is still owed because `afterCommit` or `afterLink` has not yet succeeded. Only
      * these may start a retention pass from an already-committed retry, so an
      * ordinary duplicate offer cannot be used to force repeated full passes.
      * The set is in-memory only and bounded by `MAX_OWED_POST_COMMIT_RETENTION`;
@@ -180,6 +186,13 @@ export declare class Server extends EventEmitter {
      * and its hooks concurrently against one staging and commit identity.
      */
     private readonly activeTransfers;
+    /**
+     * One first-in, first-out line of `afterLink` calls per link name. A place is
+     * reserved while the root lease orders the link decision, and the hook runs
+     * after the lease is released, so a link's hooks start in decision order
+     * and never overlap, while hook code never runs under the lease.
+     */
+    private readonly linkHookTurns;
     private readonly receives;
     private layout;
     private sessions;
@@ -198,18 +211,45 @@ export declare class Server extends EventEmitter {
     private transfer;
     private rejectOffer;
     private hookArtifact;
+    /** Describes a durably committed artifact from its commit record, as a link hook sees it. */
+    private recordArtifact;
+    private hookLink;
     /**
      * Computes and converges the desired links from durable commit records.
      * Called with the root lease already held.
      */
+    private convergeLinksUnlocked;
     private reconcileLinksUnlocked;
     /** Pins link targets when reconciliation fails but retention must continue. */
     private linkPinsFallbackUnlocked;
-    /** Reconciles after a durable commit; this is the only caller that leases the root. */
+    /**
+     * Reconciles after a durable commit; this is the only caller that leases the
+     * root for it. When an `afterLink` hook is configured it also returns one
+     * pending call for every automatic link that now designates `artifact`,
+     * whether this reconcile changed it or an earlier attempt already had, so a
+     * retry re-runs a hook that failed. The caller owns the returned places in
+     * the hook lines and must release them.
+     */
     private reconcileAfterCommit;
+    /**
+     * Runs pending `afterLink` calls one after another, each once every earlier
+     * hook for its link has finished. No storage lease is held while hook code
+     * runs. `begin` is told which call is starting so a caller can attribute a
+     * failure. The first failure stops the rest; the caller releases the places.
+     */
+    private runLinkHooks;
     private setManagedLinkNames;
     private refreshManagedLinkNames;
     private receiveLink;
+    /**
+     * Closes a connection after its `HOOK_FAILED` answer was written. Destroying
+     * the stream right behind the write can reset it before the peer has read the
+     * record, so the caller would see a reset instead of the stable code. The
+     * write side is ended first and the connection is destroyed once the peer
+     * closes it, or after a grace period if it never does. The work that failed
+     * is already durable, so lingering costs only the connection.
+     */
+    private closeAfterAnswer;
     /** Runs a gating callback; only callback exceptions become HOOK_FAILED. */
     private runHook;
     /** Runs onFailure once; its own failure is logged and never replaces the original. */
@@ -226,11 +266,21 @@ export declare class Server extends EventEmitter {
      */
     private owePostCommitRetention;
     /**
-     * Runs the post-commit retention pass that a configured `afterCommit` hook
-     * deferred, only after that hook succeeded, and then stops owing it. The
-     * retention manager already reports its own failures as non-fatal, so
-     * nothing here can fail the upload; the pass is attempted exactly once per
-     * successful hook, which is why the transfer is cleared either way.
+     * Whether the post-commit retention pass waits for the hooks that follow a
+     * commit. Either one defers it: `afterCommit` so its callback still finds
+     * the artifact, and `afterLink` so this commit's own link reconciliation runs
+     * before this commit's retention pass does. That narrows, but does not remove,
+     * the chance that the link already moved: another commit's retention or
+     * reconciliation can do it first, and the hook then sees `UNCHANGED`.
+     */
+    private defersPostCommitRetention;
+    /**
+     * Runs the post-commit retention pass that configured `afterCommit` or
+     * `afterLink` hooks deferred, only after they succeeded, and then stops
+     * owing it. The retention manager already reports its own failures as
+     * non-fatal, so nothing here can fail the upload; the pass is attempted
+     * exactly once per successful hook run, which is why the transfer is cleared
+     * either way.
      */
     private settleDeferredRetention;
     /**