swarm-deploy 0.0.0 → 0.2.0

package/dist/storage/link-store.d.ts

@@ -0,0 +1,70 @@
+import type { DesiredLink } from '../symlinks.js';
+import type { ArtifactKind } from '../types.js';
+import type { StorageAdapter, StorageLayout, SymlinkCapableStorage } from './types.js';
+export interface ManagedSymlinkRecord {
+    version: 1;
+    name: string;
+    target: string;
+    transferId: string;
+    targetKind: ArtifactKind;
+}
+export interface LinkReconcileResult {
+    created: string[];
+    updated: string[];
+    removed: string[];
+    unchanged: string[];
+}
+export interface LinkReconcileOptions {
+    /** Managed artifact basenames used to prove a crash-residual symlink target. */
+    managedArtifactNames?: ReadonlySet<string>;
+}
+export interface LinkStoreOptions {
+    layout: StorageLayout;
+    /** Must provide `symlink` and `readlink`, or construction fails closed. */
+    storage?: StorageAdapter;
+}
+/**
+ * Owns every server-managed symlink in the storage root.
+ *
+ * A destination is replaceable only when a valid ownership record exists, the
+ * visible destination is a symbolic link, and `readlink()` returns either the
+ * recorded target or the desired target. Anything else is unmanaged: it is left
+ * untouched and the operation fails closed. A link target is always exactly a
+ * sibling basename, and `readlink()` output is only ever compared, never used
+ * to build a path.
+ */
+export declare class LinkStore {
+    readonly layout: StorageLayout;
+    readonly storage: SymlinkCapableStorage;
+    constructor({ layout, storage }: LinkStoreOptions);
+    recordPath(name: string): string;
+    private finalPath;
+    read(name: string): Promise<ManagedSymlinkRecord | null>;
+    /** Every persisted ownership record, keyed by its proven link name. */
+    list(): Promise<ManagedSymlinkRecord[]>;
+    private readRecord;
+    private listRecords;
+    private classify;
+    private writeRecord;
+    private removeRecord;
+    /**
+     * Creates a link where nothing exists. The ownership record is durable first,
+     * so a crash after the link appears never leaves an unrecorded link; the
+     * link itself is created without overwriting, so a path that appeared since
+     * classification is never replaced and its record is withdrawn.
+     */
+    private createLink;
+    /** Removes a temporary symlink with `lstat`/`unlink`, never a regular-file helper. */
+    private removeTemporary;
+    /** Atomically swaps an owned link by renaming a private temporary link over it. */
+    private replaceLink;
+    private removeLink;
+    /**
+     * Converges every desired link and removes the record and visible link of
+     * every name no rule owns. Level-triggered: the same input always produces
+     * the same output, whatever the previous attempt's crash point.
+     */
+    reconcile(desired: readonly DesiredLink[], ruleNames: ReadonlySet<string>, options?: LinkReconcileOptions): Promise<LinkReconcileResult>;
+    private sweepTemporaryLinks;
+    private converge;
+}

package/dist/storage/link-store.js

@@ -0,0 +1,363 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkStore = void 0;
+const b4a_1 = __importDefault(require("b4a"));
+const error_code_js_1 = require("../error-code.js");
+const _fs_1 = __importDefault(require("#fs"));
+const _path_1 = __importDefault(require("#path"));
+const sodium_native_1 = __importDefault(require("sodium-native"));
+const errors_js_1 = require("../errors.js");
+const files_js_1 = require("../files.js");
+const hash_js_1 = require("../tar-protocol/hash.js");
+const atomic_file_js_1 = require("./atomic-file.js");
+const layout_js_1 = require("./layout.js");
+const tree_fs_js_1 = require("./tree-fs.js");
+const MAX_LINK_RECORD_BYTES = 4 * 1024;
+const RECORD_FILENAME = /^[0-9a-f]{64}\.json$/;
+const RECORD_KEYS = 'name,target,targetKind,transferId,version';
+function conflict(message) {
+    return new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.LINK_CONFLICT, message);
+}
+function failure(message, cause = null) {
+    return new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.LINK_FAILED, message, cause);
+}
+/**
+ * Maps every failure to a stable link error. The raw error, which may carry an
+ * errno or an absolute path, is kept only as the `cause`, never in the message.
+ */
+function asLinkError(error) {
+    if (error instanceof errors_js_1.SwarmDeployError &&
+        (error.code === errors_js_1.ERRORS.LINK_CONFLICT ||
+            error.code === errors_js_1.ERRORS.LINK_FAILED ||
+            error.code === errors_js_1.ERRORS.UNSUPPORTED_STORAGE)) {
+        return error;
+    }
+    return failure('Managed link operation failed', error);
+}
+/** A link or target name: one safe basename, never reserved, never the internal directory. */
+function assertSafeName(value, message) {
+    if (typeof value !== 'string' ||
+        value.includes('/') ||
+        value.includes('\\') ||
+        value.includes('\u0000') ||
+        value === '.' ||
+        value === '..' ||
+        value === '.swarm-deploy') {
+        throw failure(message);
+    }
+    try {
+        (0, files_js_1.validateBasename)(value);
+    }
+    catch (error) {
+        throw failure(message, error);
+    }
+    if ((0, files_js_1.isReservedHistoryName)(value))
+        throw failure(message);
+    return value;
+}
+function assertRecord(value, expectedName) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw failure('Invalid managed link record');
+    }
+    const candidate = value;
+    if (Object.keys(candidate).sort().join(',') !== RECORD_KEYS ||
+        candidate.version !== 1 ||
+        candidate.name !== expectedName ||
+        (candidate.targetKind !== 'file' && candidate.targetKind !== 'directory') ||
+        typeof candidate.transferId !== 'string' ||
+        !/^[0-9a-f]{64}$/.test(candidate.transferId)) {
+        throw failure('Invalid managed link record');
+    }
+    assertSafeName(candidate.name, 'Invalid managed link record');
+    assertSafeName(candidate.target, 'Invalid managed link record');
+    return candidate;
+}
+function randomSuffix() {
+    const bytes = b4a_1.default.allocUnsafe(16);
+    sodium_native_1.default.randombytes_buf(bytes);
+    return b4a_1.default.toString(bytes, 'hex');
+}
+async function syncDirectory(directory, storage) {
+    const handle = await storage.open(directory, 'r');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Owns every server-managed symlink in the storage root.
+ *
+ * A destination is replaceable only when a valid ownership record exists, the
+ * visible destination is a symbolic link, and `readlink()` returns either the
+ * recorded target or the desired target. Anything else is unmanaged: it is left
+ * untouched and the operation fails closed. A link target is always exactly a
+ * sibling basename, and `readlink()` output is only ever compared, never used
+ * to build a path.
+ */
+class LinkStore {
+    layout;
+    storage;
+    constructor({ layout, storage = _fs_1.default.promises }) {
+        if (!layout || typeof layout !== 'object')
+            throw failure('Invalid storage layout');
+        (0, tree_fs_js_1.assertSymlinkCapable)(storage);
+        this.layout = layout;
+        this.storage = storage;
+    }
+    recordPath(name) {
+        return _path_1.default.join(this.layout.links, `${b4a_1.default.toString((0, hash_js_1.sodiumSha256)(b4a_1.default.from(name)), 'hex')}.json`);
+    }
+    finalPath(name) {
+        return _path_1.default.join(this.layout.root, name);
+    }
+    async read(name) {
+        try {
+            return await this.readRecord(assertSafeName(name, 'Invalid managed link name'));
+        }
+        catch (error) {
+            throw asLinkError(error);
+        }
+    }
+    /** Every persisted ownership record, keyed by its proven link name. */
+    async list() {
+        try {
+            return await this.listRecords();
+        }
+        catch (error) {
+            throw asLinkError(error);
+        }
+    }
+    async readRecord(name) {
+        try {
+            return assertRecord(await (0, atomic_file_js_1.readJson)(this.recordPath(name), this.storage, MAX_LINK_RECORD_BYTES), name);
+        }
+        catch (error) {
+            if ((0, error_code_js_1.isMissing)(error))
+                return null;
+            if (error instanceof atomic_file_js_1.MetadataFormatError) {
+                throw failure('Malformed managed link record', error);
+            }
+            throw error;
+        }
+    }
+    async listRecords() {
+        const filenames = await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.links, this.storage, () => this.storage.readdir(this.layout.links));
+        const records = [];
+        for (const filename of filenames.sort()) {
+            if (!RECORD_FILENAME.test(filename))
+                continue;
+            let parsed;
+            try {
+                parsed = await (0, atomic_file_js_1.readJson)(_path_1.default.join(this.layout.links, filename), this.storage, MAX_LINK_RECORD_BYTES);
+            }
+            catch (error) {
+                throw failure('Malformed managed link record', error);
+            }
+            const record = assertRecord(parsed, typeof parsed.name === 'string' ? parsed.name : '');
+            if (_path_1.default.basename(this.recordPath(record.name)) !== filename) {
+                throw failure('Foreign managed link record');
+            }
+            records.push(record);
+        }
+        return records;
+    }
+    classify(name) {
+        const finalPath = this.finalPath(name);
+        return (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, async () => {
+            let stat;
+            try {
+                stat = await this.storage.lstat(finalPath);
+            }
+            catch (error) {
+                if ((0, error_code_js_1.isMissing)(error))
+                    return { state: 'MISSING' };
+                throw error;
+            }
+            if (!stat.isSymbolicLink())
+                return { state: 'UNMANAGED' };
+            return { state: 'SYMLINK', target: await this.storage.readlink(finalPath) };
+        });
+    }
+    async writeRecord(link) {
+        const record = {
+            version: 1,
+            name: link.name,
+            target: link.target,
+            transferId: link.transferId,
+            targetKind: link.targetKind
+        };
+        assertRecord(record, link.name);
+        await (0, atomic_file_js_1.writeAtomic)(this.recordPath(link.name), b4a_1.default.from(JSON.stringify(record)), this.storage);
+    }
+    async removeRecord(name) {
+        await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.links, this.storage, async () => {
+            try {
+                await this.storage.unlink(this.recordPath(name));
+            }
+            catch (error) {
+                if (!(0, error_code_js_1.isMissing)(error))
+                    throw error;
+            }
+        });
+        await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.links, this.storage, () => syncDirectory(this.layout.links, this.storage));
+    }
+    /**
+     * Creates a link where nothing exists. The ownership record is durable first,
+     * so a crash after the link appears never leaves an unrecorded link; the
+     * link itself is created without overwriting, so a path that appeared since
+     * classification is never replaced and its record is withdrawn.
+     */
+    async createLink(link) {
+        await this.writeRecord(link);
+        try {
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, () => this.storage.symlink(link.target, this.finalPath(link.name)));
+        }
+        catch (error) {
+            await this.removeRecord(link.name).catch(() => { });
+            if ((0, error_code_js_1.errorCode)(error) === 'EEXIST') {
+                throw conflict('Unmanaged path at a configured managed link name');
+            }
+            throw error;
+        }
+        await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, () => syncDirectory(this.layout.root, this.storage));
+    }
+    /** Removes a temporary symlink with `lstat`/`unlink`, never a regular-file helper. */
+    async removeTemporary(temporary) {
+        await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.publications, this.storage, async () => {
+            try {
+                await this.storage.lstat(temporary);
+            }
+            catch (error) {
+                if ((0, error_code_js_1.isMissing)(error))
+                    return;
+                throw error;
+            }
+            await this.storage.unlink(temporary);
+        }).catch(() => { });
+    }
+    /** Atomically swaps an owned link by renaming a private temporary link over it. */
+    async replaceLink(link) {
+        const temporary = _path_1.default.join(this.layout.publications, `.link-${randomSuffix()}`);
+        try {
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.publications, this.storage, () => this.storage.symlink(link.target, temporary));
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.publications, this.storage, () => syncDirectory(this.layout.publications, this.storage));
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, () => (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.publications, this.storage, () => this.storage.rename(temporary, this.finalPath(link.name))));
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, () => syncDirectory(this.layout.root, this.storage));
+            await this.writeRecord(link);
+        }
+        finally {
+            await this.removeTemporary(temporary);
+        }
+    }
+    async removeLink(record, desiredTarget) {
+        const destination = await this.classify(record.name);
+        const allowed = new Set([record.target]);
+        if (desiredTarget)
+            allowed.add(desiredTarget);
+        if (destination.state === 'SYMLINK' && allowed.has(destination.target)) {
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, () => this.storage.unlink(this.finalPath(record.name)));
+            await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.root, this.storage, () => syncDirectory(this.layout.root, this.storage));
+        }
+        else if (destination.state !== 'MISSING') {
+            throw conflict('Unmanaged path at a removed managed link name');
+        }
+        await this.removeRecord(record.name);
+    }
+    /**
+     * Converges every desired link and removes the record and visible link of
+     * every name no rule owns. Level-triggered: the same input always produces
+     * the same output, whatever the previous attempt's crash point.
+     */
+    async reconcile(desired, ruleNames, options = {}) {
+        try {
+            return await this.converge(desired, ruleNames, options);
+        }
+        catch (error) {
+            throw asLinkError(error);
+        }
+    }
+    async sweepTemporaryLinks() {
+        const names = await (0, layout_js_1.withSafeDirectoryIdentity)(this.layout.publications, this.storage, () => this.storage.readdir(this.layout.publications));
+        for (const name of names) {
+            if (!/^\.link-[0-9a-f]{32}$/.test(name))
+                continue;
+            await this.removeTemporary(_path_1.default.join(this.layout.publications, name));
+        }
+    }
+    async converge(desired, ruleNames, { managedArtifactNames } = {}) {
+        await this.sweepTemporaryLinks();
+        const result = { created: [], updated: [], removed: [], unchanged: [] };
+        const desiredByName = new Map(desired.map((link) => [link.name, link]));
+        for (const record of await this.listRecords()) {
+            if (ruleNames.has(record.name)) {
+                if (!desiredByName.has(record.name)) {
+                    const destination = await this.classify(record.name);
+                    const desiredTarget = destination.state === 'SYMLINK' && destination.target !== record.target
+                        ? destination.target
+                        : undefined;
+                    await this.removeLink(record, desiredTarget);
+                    result.removed.push(record.name);
+                }
+                continue;
+            }
+            const destination = await this.classify(record.name);
+            let desiredTarget;
+            if (destination.state === 'SYMLINK' && destination.target !== record.target) {
+                const pending = desiredByName.get(record.name);
+                if (pending)
+                    desiredTarget = pending.target;
+                else if (managedArtifactNames?.has(destination.target)) {
+                    desiredTarget = destination.target;
+                }
+            }
+            await this.removeLink(record, desiredTarget);
+            result.removed.push(record.name);
+        }
+        for (const link of desired) {
+            if (!ruleNames.has(link.name))
+                throw failure('Desired link is not a configured rule');
+            assertSafeName(link.name, 'Invalid managed link name');
+            assertSafeName(link.target, 'Invalid managed link target');
+            if (link.target === link.name)
+                throw failure('Managed link cannot target itself');
+            const record = await this.readRecord(link.name);
+            const destination = await this.classify(link.name);
+            if (destination.state === 'UNMANAGED') {
+                throw conflict('Unmanaged path at a configured managed link name');
+            }
+            if (destination.state === 'MISSING') {
+                await this.createLink(link);
+                result.created.push(link.name);
+                continue;
+            }
+            if (record === null)
+                throw conflict('Unrecorded symlink at a configured managed link name');
+            // Ownership proof: a record exists and the visible link is either the
+            // recorded target or the desired one (a crash after the visible swap).
+            if (destination.target !== record.target && destination.target !== link.target) {
+                throw conflict('Managed link does not match its ownership record');
+            }
+            if (destination.target === link.target) {
+                if (record.target === link.target &&
+                    record.transferId === link.transferId &&
+                    record.targetKind === link.targetKind) {
+                    result.unchanged.push(link.name);
+                    continue;
+                }
+                await this.writeRecord(link);
+                result.updated.push(link.name);
+                continue;
+            }
+            await this.replaceLink(link);
+            result.updated.push(link.name);
+        }
+        return result;
+    }
+}
+exports.LinkStore = LinkStore;
+//# sourceMappingURL=link-store.js.map

package/dist/storage/link-store.js.map

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

package/dist/storage/recovery.d.ts

@@ -0,0 +1,100 @@
+import type { CommitRecord } from './commit-journal.js';
+import type { StorageAdapter, StorageLayout } from './types.js';
+interface Logger {
+    info?: (message: string, details: Record<string, unknown>) => void;
+    warn?: (message: string, details: Record<string, unknown>) => void;
+}
+interface SessionStore {
+    initialized?: boolean;
+    closed?: boolean;
+    readVerified(transferId: Uint8Array): Promise<{
+        id: string;
+        transferId: Uint8Array;
+        ownerKey: Uint8Array;
+        name: string;
+        size: number;
+        digest: Uint8Array;
+        tarSize: number;
+        tarDigest: Uint8Array;
+        state: string;
+    }>;
+    expire(ttl: number, shouldExpire: (session: {
+        state: string;
+    }) => boolean): Promise<number>;
+    delete?(transferId: Uint8Array): Promise<boolean>;
+}
+interface RecoveryResult {
+    status: 'MISSING' | 'FILE_EXISTS' | 'COMMITTED' | 'ABORTED' | 'RESUMABLE' | 'CORRUPT';
+    record?: CommitRecord;
+    reason?: string;
+}
+interface CommitStore {
+    storage?: StorageAdapter;
+    _readJournal(id: string): Promise<unknown>;
+    retireCorruptAttempt(id: string): Promise<{
+        retired: boolean;
+        removedStaging: boolean;
+    }>;
+    recoverJournal(id: string, sessionStore: SessionStore, options: {
+        isAuthorized: ((ownerKey: Uint8Array) => boolean) | null;
+    }): Promise<RecoveryResult>;
+    list(): Promise<CommitRecord[]>;
+    scrubRecords(): Promise<{
+        records: CommitRecord[];
+        deleted: number;
+    }>;
+    delete(record: CommitRecord): Promise<boolean>;
+    purge(record: CommitRecord, options?: {
+        preservePath?: boolean;
+    }): Promise<false | {
+        purged: true;
+        preservedPath: boolean;
+    }>;
+    sweepTrash(): Promise<number>;
+}
+type RecoveryEvent = {
+    type: 'recovery';
+    status: 'CORRUPT';
+    phase: 'classification';
+    transfer: string;
+} | {
+    type: 'recovery';
+    status: 'failed';
+    phase: 'classification' | 'journal';
+    transfer?: string;
+    reason: string;
+} | {
+    type: 'recovery';
+    status: 'MISSING' | 'FILE_EXISTS' | 'COMMITTED' | 'ABORTED' | 'RESUMABLE' | 'CORRUPT';
+    transfer: string;
+} | {
+    type: 'cleanup';
+    transfer: string;
+    name: null;
+    reason: 'corrupt-journal' | 'trash-residue';
+} | {
+    type: 'scrub';
+    status: 'started';
+} | {
+    type: 'scrub';
+    status: 'completed';
+    deleted: number;
+    unknownCount: number;
+} | {
+    type: 'scrub';
+    status: 'failed';
+    reason: string;
+};
+interface PrepareStorageRecoveryOptions {
+    layout: StorageLayout;
+    commitStore: CommitStore;
+    logger?: Logger | null;
+    onEvent?: ((event: RecoveryEvent) => void) | null;
+}
+interface RecoverStorageOptions extends PrepareStorageRecoveryOptions {
+    sessionStore: SessionStore;
+    isAuthorized?: ((ownerKey: Uint8Array) => boolean) | null;
+}
+declare function prepareStorageRecovery({ layout, commitStore, logger, onEvent }: PrepareStorageRecoveryOptions): Promise<number>;
+declare function recoverStorage({ layout, sessionStore, commitStore, logger, isAuthorized, onEvent }: RecoverStorageOptions): Promise<RecoveryResult[]>;
+export { prepareStorageRecovery, recoverStorage };