swarm-deploy 0.1.0 → 0.3.0

package/dist/release.js

@@ -0,0 +1,419 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReleaseMatcher = exports.MAX_RELEASE_COMPONENT_BYTES = void 0;
+exports.fixedSeriesKey = fixedSeriesKey;
+exports.compareReleaseVersions = compareReleaseVersions;
+exports.releaseVersionGroup = releaseVersionGroup;
+const b4a_1 = __importDefault(require("b4a"));
+const semver_1 = require("semver");
+const files_js_1 = require("./files.js");
+const hash_js_1 = require("./tar-protocol/hash.js");
+const PLACEHOLDER_SERIES = '{series}';
+const PLACEHOLDER_VERSION = '{version}';
+/** Protocol: artifact basenames are one safe path component, max 100 UTF-8 bytes (`+` disallowed). */
+exports.MAX_RELEASE_COMPONENT_BYTES = 100;
+const SAFE_ARTIFACT = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/** Immediate source parent: same 100-byte single-component rule; `+` allowed for SemVer build metadata. */
+const SAFE_SOURCE_PARENT = /^[A-Za-z0-9][A-Za-z0-9._+-]*$/;
+const FIXED_SERIES_PREFIX = 'fixed-';
+/** The exact shape `fixedSeriesKey` produces; captures may not occupy it. */
+const RESERVED_FIXED_SERIES = /^fixed-[0-9a-f]{64}$/;
+/**
+ * The persisted series of a template that captures no `{series}`.
+ *
+ * The template text itself cannot be the key: braces and slashes fail the
+ * commit-record basename rules, so every version-only pattern would reject at
+ * commit time. Hashing gives a safe 70-byte basename that is stable across
+ * restarts and identical on Node and Bare, and distinct templates that happen
+ * to describe the same literals stay distinct releases.
+ */
+function fixedSeriesKey(template) {
+    return `${FIXED_SERIES_PREFIX}${b4a_1.default.toString((0, hash_js_1.sodiumSha256)(b4a_1.default.from(template)), 'hex')}`;
+}
+function placeholderCount(template, placeholder) {
+    let count = 0;
+    let index = 0;
+    while ((index = template.indexOf(placeholder, index)) !== -1) {
+        count++;
+        index += placeholder.length;
+    }
+    return count;
+}
+function assertPlaceholderLayout(template) {
+    if (template.includes(`${PLACEHOLDER_SERIES}${PLACEHOLDER_VERSION}`) ||
+        template.includes(`${PLACEHOLDER_VERSION}${PLACEHOLDER_SERIES}`)) {
+        throw new Error('Invalid release template: adjacent placeholder');
+    }
+}
+/** Literal text is matched verbatim, so a stray brace is always a typo, not a literal. */
+function assertNoResidualBraces(template) {
+    const literals = template.split(PLACEHOLDER_SERIES).join('').split(PLACEHOLDER_VERSION).join('');
+    if (literals.includes('{') || literals.includes('}')) {
+        throw new Error('Invalid release template: unexpected brace');
+    }
+}
+function componentByteLength(value) {
+    return b4a_1.default.from(value).byteLength;
+}
+function isSafeArtifactName(value) {
+    return (typeof value === 'string' &&
+        value.length > 0 &&
+        SAFE_ARTIFACT.test(value) &&
+        componentByteLength(value) <= exports.MAX_RELEASE_COMPONENT_BYTES);
+}
+function isSafeSourceParent(value) {
+    return (typeof value === 'string' &&
+        value.length > 0 &&
+        SAFE_SOURCE_PARENT.test(value) &&
+        componentByteLength(value) <= exports.MAX_RELEASE_COMPONENT_BYTES &&
+        !value.includes('/') &&
+        !value.includes('\\'));
+}
+/**
+ * A captured `{series}` may not take the shape of a derived fixed-series key,
+ * so an upload cannot name itself into the rotation group of a version-only
+ * pattern. The namespace is reserved rather than escaped: a collision is a
+ * non-match, which fails closed as an unmatched offer.
+ */
+function isSafeSeriesCapture(value) {
+    return (SAFE_ARTIFACT.test(value) &&
+        componentByteLength(value) <= exports.MAX_RELEASE_COMPONENT_BYTES &&
+        !RESERVED_FIXED_SERIES.test(value));
+}
+function validateStrictReleaseVersion(raw) {
+    if (raw.length === 0 || componentByteLength(raw) > exports.MAX_RELEASE_COMPONENT_BYTES) {
+        return undefined;
+    }
+    if (raw.trim() !== raw)
+        return undefined;
+    if (/^[vV]/.test(raw))
+        return undefined;
+    if (/[/\\]/.test(raw))
+        return undefined;
+    try {
+        const parsed = new semver_1.SemVer(raw, { loose: false });
+        const core = raw.split('+', 1)[0];
+        if (core !== parsed.version)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeCapturedVersion(raw) {
+    return validateStrictReleaseVersion(raw)?.version;
+}
+function parseReleaseVersion(raw) {
+    const parsed = validateStrictReleaseVersion(raw);
+    if (!parsed)
+        throw new Error('Invalid release version');
+    return parsed;
+}
+function parseSegmentParts(template) {
+    const parts = [];
+    let cursor = 0;
+    while (cursor < template.length) {
+        const seriesAt = template.indexOf(PLACEHOLDER_SERIES, cursor);
+        const versionAt = template.indexOf(PLACEHOLDER_VERSION, cursor);
+        let next = -1;
+        let kind = null;
+        if (seriesAt !== -1 && (versionAt === -1 || seriesAt < versionAt)) {
+            next = seriesAt;
+            kind = 'series';
+        }
+        else if (versionAt !== -1) {
+            next = versionAt;
+            kind = 'version';
+        }
+        if (next === -1) {
+            parts.push({ kind: 'literal', text: template.slice(cursor) });
+            break;
+        }
+        if (next > cursor) {
+            parts.push({ kind: 'literal', text: template.slice(cursor, next) });
+        }
+        parts.push({ kind: kind });
+        cursor = next + (kind === 'series' ? PLACEHOLDER_SERIES.length : PLACEHOLDER_VERSION.length);
+    }
+    return parts;
+}
+function compileSegmentPlan(template) {
+    const seriesCount = placeholderCount(template, PLACEHOLDER_SERIES);
+    const versionCount = placeholderCount(template, PLACEHOLDER_VERSION);
+    if (seriesCount > 1 || versionCount > 1) {
+        throw new Error('Invalid release template: repeated placeholder');
+    }
+    const parts = parseSegmentParts(template);
+    return {
+        plan: { parts },
+        hasSeries: seriesCount > 0,
+        hasVersion: versionCount > 0
+    };
+}
+function compileParentMatcher(parent) {
+    if (placeholderCount(parent, PLACEHOLDER_SERIES) === 0 &&
+        placeholderCount(parent, PLACEHOLDER_VERSION) === 0) {
+        return { literal: parent, plan: null, hasVersion: false };
+    }
+    const compiled = compileSegmentPlan(parent);
+    return { literal: null, plan: compiled.plan, hasVersion: compiled.hasVersion };
+}
+function compileTemplate(template) {
+    assertNoResidualBraces(template);
+    assertPlaceholderLayout(template);
+    const seriesCount = placeholderCount(template, PLACEHOLDER_SERIES);
+    const versionCount = placeholderCount(template, PLACEHOLDER_VERSION);
+    if (seriesCount === 0 && versionCount === 0) {
+        throw new Error('Invalid release template: missing placeholder');
+    }
+    if (seriesCount > 1 || versionCount > 1) {
+        throw new Error('Invalid release template: repeated placeholder');
+    }
+    const segments = template.split('/');
+    if (segments.some((segment) => segment.length === 0)) {
+        throw new Error('Invalid release template: empty segment');
+    }
+    if (segments.length > 2) {
+        throw new Error('Invalid release template: path separator outside parent boundary');
+    }
+    const fixedSeries = seriesCount === 0 ? fixedSeriesKey(template) : null;
+    if (fixedSeries !== null) {
+        try {
+            (0, files_js_1.validateBasename)(fixedSeries);
+        }
+        catch (error) {
+            throw new Error('Invalid release template: unusable fixed series key', { cause: error });
+        }
+    }
+    if (segments.length === 1) {
+        const basename = compileSegmentPlan(template);
+        return {
+            fixedSeries,
+            versionInParent: false,
+            versionInBasename: basename.hasVersion,
+            parent: null,
+            basename: basename.plan
+        };
+    }
+    const parentSegment = segments[0];
+    const basenameSegment = segments[1];
+    const parent = compileParentMatcher(parentSegment);
+    const basename = compileSegmentPlan(basenameSegment);
+    return {
+        fixedSeries,
+        versionInParent: parent.hasVersion,
+        versionInBasename: basename.hasVersion,
+        parent,
+        basename: basename.plan
+    };
+}
+function assignPlaceholderPair(first, second, left, right) {
+    if (first === 'series' && second === 'version') {
+        if (!isSafeSeriesCapture(left))
+            return null;
+        const version = normalizeCapturedVersion(right);
+        return version ? { series: left, version } : null;
+    }
+    if (first === 'version' && second === 'series') {
+        const version = normalizeCapturedVersion(left);
+        if (!version)
+            return null;
+        if (!isSafeSeriesCapture(right))
+            return null;
+        return { series: right, version };
+    }
+    return null;
+}
+function splitSeriesThenVersion(stem) {
+    for (let index = stem.lastIndexOf('-'); index > 0; index = stem.lastIndexOf('-', index - 1)) {
+        const groups = assignPlaceholderPair('series', 'version', stem.slice(0, index), stem.slice(index + 1));
+        if (groups)
+            return groups;
+    }
+    return null;
+}
+function splitVersionThenSeries(stem) {
+    for (let index = stem.indexOf('-'); index > 0; index = stem.indexOf('-', index + 1)) {
+        const groups = assignPlaceholderPair('version', 'series', stem.slice(0, index), stem.slice(index + 1));
+        if (groups)
+            return groups;
+    }
+    return null;
+}
+function tryLiteralSeparator(stem, separator, first, second) {
+    if (separator.length === 0)
+        return null;
+    let index = stem.indexOf(separator);
+    while (index !== -1) {
+        const left = stem.slice(0, index);
+        const right = stem.slice(index + separator.length);
+        const groups = assignPlaceholderPair(first, second, left, right);
+        if (groups)
+            return groups;
+        index = stem.indexOf(separator, index + 1);
+    }
+    return null;
+}
+function matchStem(middle, stem) {
+    if (middle.length === 1) {
+        const part = middle[0];
+        if (part.kind === 'series') {
+            return isSafeSeriesCapture(stem) ? { series: stem } : null;
+        }
+        const version = normalizeCapturedVersion(stem);
+        return version ? { version } : null;
+    }
+    if (middle.length === 3 &&
+        middle[0].kind !== 'literal' &&
+        middle[1].kind === 'literal' &&
+        middle[2].kind !== 'literal') {
+        const first = middle[0].kind;
+        const separator = middle[1].text;
+        const second = middle[2].kind;
+        if (first === 'series' && second === 'version' && separator === '-') {
+            const split = splitSeriesThenVersion(stem);
+            if (split)
+                return split;
+        }
+        if (first === 'version' && second === 'series' && separator === '-') {
+            const split = splitVersionThenSeries(stem);
+            if (split)
+                return split;
+        }
+        return tryLiteralSeparator(stem, separator, first, second);
+    }
+    return null;
+}
+function matchSegmentPlan(plan, value) {
+    const { parts } = plan;
+    if (parts.length === 0)
+        return null;
+    let prefix = '';
+    let start = 0;
+    while (start < parts.length && parts[start].kind === 'literal') {
+        prefix += parts[start].text;
+        start++;
+    }
+    let suffix = '';
+    let end = parts.length - 1;
+    while (end >= start && parts[end].kind === 'literal') {
+        suffix = parts[end].text + suffix;
+        end--;
+    }
+    if (!value.startsWith(prefix) || !value.endsWith(suffix))
+        return null;
+    const stem = value.slice(prefix.length, value.length - suffix.length);
+    if (componentByteLength(stem) > exports.MAX_RELEASE_COMPONENT_BYTES)
+        return null;
+    const middle = parts.slice(start, end + 1);
+    if (middle.length === 0) {
+        return stem.length === 0 ? {} : null;
+    }
+    return matchStem(middle, stem);
+}
+function matchWithParent(pattern, sourceParent, name) {
+    if (!isSafeArtifactName(name))
+        return null;
+    let parentGroups = {};
+    const parent = pattern.parent;
+    if (parent.literal !== null) {
+        if (parent.literal !== sourceParent)
+            return null;
+    }
+    else {
+        const matched = matchSegmentPlan(parent.plan, sourceParent);
+        if (matched === null)
+            return null;
+        parentGroups = matched;
+    }
+    const basenameGroups = matchSegmentPlan(pattern.basename, name);
+    if (basenameGroups === null)
+        return null;
+    return { ...parentGroups, ...basenameGroups };
+}
+function coordinatesFromGroups(pattern, groups, mode) {
+    const series = pattern.fixedSeries ??
+        (typeof groups.series === 'string' && groups.series.length > 0 ? groups.series : null);
+    if (series === null)
+        return null;
+    if (pattern.fixedSeries === null && !isSafeSeriesCapture(series))
+        return null;
+    const normalized = groups.version;
+    const requiresVersion = mode === 'basename'
+        ? pattern.versionInBasename
+        : pattern.versionInBasename || pattern.versionInParent;
+    if (requiresVersion && normalized === undefined)
+        return null;
+    if (normalized !== undefined) {
+        return { series, version: normalized };
+    }
+    return { series };
+}
+class ReleaseMatcher {
+    #patterns;
+    constructor(patterns) {
+        const seen = new Set();
+        const compiled = [];
+        for (const template of patterns) {
+            if (typeof template !== 'string') {
+                throw new Error('Invalid release template');
+            }
+            if (seen.has(template)) {
+                throw new Error('Invalid release template: duplicate template');
+            }
+            seen.add(template);
+            compiled.push(compileTemplate(template));
+        }
+        this.#patterns = compiled;
+    }
+    get size() {
+        return this.#patterns.length;
+    }
+    get hasVersionPattern() {
+        return this.#patterns.some((pattern) => pattern.versionInBasename || pattern.versionInParent);
+    }
+    match(name, sourceParent) {
+        if (!isSafeArtifactName(name))
+            return null;
+        if (sourceParent !== undefined && !isSafeSourceParent(sourceParent))
+            return null;
+        for (const pattern of this.#patterns) {
+            if (pattern.parent !== null) {
+                if (sourceParent === undefined)
+                    continue;
+                const groups = matchWithParent(pattern, sourceParent, name);
+                if (groups) {
+                    const coords = coordinatesFromGroups(pattern, groups, 'full');
+                    if (coords)
+                        return coords;
+                }
+                continue;
+            }
+            const basenameGroups = matchSegmentPlan(pattern.basename, name);
+            if (basenameGroups) {
+                const coords = coordinatesFromGroups(pattern, basenameGroups, 'basename');
+                if (coords)
+                    return coords;
+            }
+        }
+        return null;
+    }
+}
+exports.ReleaseMatcher = ReleaseMatcher;
+function compareReleaseVersions(left, right) {
+    return (0, semver_1.compare)(parseReleaseVersion(left), parseReleaseVersion(right));
+}
+function releaseVersionGroup(version, granularity) {
+    if (granularity !== 'major' && granularity !== 'minor') {
+        throw new Error('Invalid version granularity');
+    }
+    const parsed = parseReleaseVersion(version);
+    if (granularity === 'major')
+        return String(parsed.major);
+    return `${parsed.major}.${parsed.minor}`;
+}
+//# sourceMappingURL=release.js.map

package/dist/release.js.map

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

package/dist/server.d.ts

@@ -1,7 +1,10 @@
 import events from '#events';
 import { type DirectDhtFactory, type DirectDhtNode } from './direct-dht.js';
 import { type ErrorCode } from './errors.js';
+import { type ServerHooks } from './hooks.js';
+import { type VersionGranularity } from './release.js';
 import type { StorageAdapter } from './storage/types.js';
+import { type CompiledSymlinkRule, type SymlinkRule } from './symlinks.js';
 import type { AuthenticationEvent, FingerprintEvent, Logger, PublicKey, PublicKeyInput, SeedInput, ServerScheduler, TransferEvent, TransferLifecycleEvent } from './types.js';
 declare const EventEmitter: typeof events;
 declare const DEFAULT_MAX_CONNECTIONS = 64;
@@ -10,6 +13,15 @@ declare const DEFAULT_MIN_FREE_BYTES: number;
 declare const MAX_CONNECTIONS = 1024;
 declare const MAX_ACTIVE_UPLOADS = 1024;
 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,
+ * 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.
+ */
+export declare const MAX_OWED_POST_COMMIT_RETENTION = 1024;
 export type ServerLogger = Logger;
 export type AllowlistKey = PublicKeyInput | string;
 export interface ServerOptions {
@@ -26,12 +38,21 @@ export interface ServerOptions {
     minFreeBytes?: number;
     maxAge?: number;
     maxStorageBytes?: number;
+    /** Ordered release templates; when non-empty every new offer must match one. */
+    artifactPatterns?: Iterable<string>;
+    maxCount?: number;
+    maxVersions?: number;
+    versionGranularity?: VersionGranularity;
     dht?: DirectDhtNode;
     dhtFactory?: DirectDhtFactory;
     storage?: StorageAdapter;
     scheduler?: ServerScheduler;
     logger?: Logger | null;
     replaceNames?: Iterable<string>;
+    /** Optional deployment lifecycle callbacks; snapshotted at construction. */
+    hooks?: ServerHooks | null;
+    /** Repeatable managed-symlink rules; snapshotted and validated at construction. */
+    symlinks?: Iterable<SymlinkRule>;
 }
 export interface ServerConnectionEvent extends FingerprintEvent {
     connections: number;
@@ -64,11 +85,19 @@ export interface RetentionEvent {
     expiredSessions?: number;
     scrubbed?: number;
     ageDeleted?: number;
+    countDeleted?: number;
+    versionDeleted?: number;
     storageDeleted?: number;
 }
 export interface ServerCloseEvent {
     status: 'closed' | 'failed';
 }
+export interface ServerLinkEvent extends FingerprintEvent {
+    target: string;
+    name: string;
+    status: 'linked' | 'unchanged' | 'rejected' | 'failed';
+    reason?: ErrorCode;
+}
 export interface ServerEventMap {
     authentication: AuthenticationEvent;
     connection: ServerConnectionEvent;
@@ -80,6 +109,7 @@ export interface ServerEventMap {
     commit: ServerTransferLifecycleEvent;
     recovery: RecoveryEvent;
     retention: RetentionEvent;
+    link: ServerLinkEvent;
     failure: FingerprintEvent & {
         reason: ErrorCode;
     };
@@ -108,6 +138,11 @@ export declare class Server extends EventEmitter {
     readonly minFreeBytes: number;
     readonly maxAge: number | undefined;
     readonly maxStorageBytes: number | undefined;
+    readonly artifactPatterns: readonly string[];
+    readonly maxCount: number | undefined;
+    readonly maxVersions: number | undefined;
+    readonly versionGranularity: VersionGranularity | undefined;
+    private readonly releaseMatcher;
     private readonly allowedKeySnapshot;
     readonly logger: SafeLogger;
     readonly dht: DirectDhtNode | undefined;
@@ -115,6 +150,11 @@ export declare class Server extends EventEmitter {
     readonly storage: StorageAdapter;
     readonly scheduler: ServerScheduler;
     readonly replaceNames: ReadonlySet<string>;
+    readonly hooks: Readonly<ServerHooks>;
+    readonly symlinks: readonly CompiledSymlinkRule[];
+    readonly linkNames: ReadonlySet<string>;
+    private managedLinkNamesSnapshot;
+    private links;
     listening: boolean;
     closed: boolean;
     private readonly keyPair;
@@ -122,6 +162,24 @@ export declare class Server extends EventEmitter {
     private readonly abort;
     private readonly active;
     private readonly activeUploads;
+    /**
+     * Transfer IDs this process committed but whose deferred post-commit
+     * retention is still owed because `afterCommit` 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`;
+     * a restart or an eviction loses an entry, and the documented fallback is the
+     * next startup, scheduled, or commit-triggered pass.
+     */
+    private readonly pendingAfterCommit;
+    /**
+     * Authenticated transfer IDs a connection currently owns. One connection
+     * holds at most one entry and releases it in a `finally`, so the set is
+     * bounded by `maxConnections`. A second connection offering the same
+     * transfer is rejected with `FILE_BUSY` rather than running the lifecycle
+     * and its hooks concurrently against one staging and commit identity.
+     */
+    private readonly activeTransfers;
     private readonly receives;
     private layout;
     private sessions;
@@ -132,10 +190,49 @@ export declare class Server extends EventEmitter {
     private listenPromise;
     private closePromise;
     constructor(options: ServerOptions);
+    private artifactKind;
+    private payloadBytes;
+    private payloadDigest;
     private emitSafe;
     private allowed;
     private transfer;
+    private rejectOffer;
+    private hookArtifact;
+    /**
+     * Computes and converges the desired links from durable commit records.
+     * Called with the root lease already held.
+     */
+    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. */
+    private reconcileAfterCommit;
+    private setManagedLinkNames;
+    private refreshManagedLinkNames;
+    private receiveLink;
+    /** 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. */
+    private runFailureHook;
     private receive;
+    /**
+     * Records that a transfer still owes its deferred post-commit retention
+     * pass, keeping at most `MAX_OWED_POST_COMMIT_RETENTION` entries.
+     *
+     * `Set` preserves insertion order, so the oldest owed transfer is evicted
+     * first and eviction is deterministic. An evicted transfer loses nothing
+     * durable: its artifact is already committed and its rotation falls back to
+     * the next startup, scheduled, or commit-triggered pass.
+     */
+    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.
+     */
+    private settleDeferredRetention;
     /**
      * Retires a committed session without letting cleanup undo a durable commit.
      *