swarm-deploy 0.0.0 → 0.1.0

package/dist/storage/atomic-file.js

@@ -0,0 +1,172 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SESSION_METADATA_BYTES = exports.MetadataFormatError = exports.ATOMIC_WRITE_PHASE = void 0;
+exports.atomicWriteRenamed = atomicWriteRenamed;
+exports.writeAtomic = writeAtomic;
+exports.readJson = readJson;
+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 layout_js_1 = require("./layout.js");
+// Bounds untrusted on-disk metadata before allocation.
+const MAX_SESSION_METADATA_BYTES = 32 * 1024 * 1024;
+exports.MAX_SESSION_METADATA_BYTES = MAX_SESSION_METADATA_BYTES;
+exports.ATOMIC_WRITE_PHASE = Object.freeze({
+    BEFORE_RENAME: 'before-rename',
+    AFTER_RENAME: 'after-rename'
+});
+class MetadataFormatError extends errors_js_1.SwarmDeployError {
+    metadataFormat;
+    constructor(message, cause = null) {
+        super(errors_js_1.ERRORS.PROTOCOL_INVALID, message, cause);
+        this.metadataFormat = true;
+    }
+}
+exports.MetadataFormatError = MetadataFormatError;
+function storageError(message, cause = null) {
+    return new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, message, cause);
+}
+function markAtomicWriteError(error, phase) {
+    const marked = error instanceof Error ? error : new Error(String(error));
+    marked.atomicWritePhase = phase;
+    return marked;
+}
+function atomicWriteRenamed(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'atomicWritePhase' in error &&
+        error.atomicWritePhase === exports.ATOMIC_WRITE_PHASE.AFTER_RENAME);
+}
+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 assertRegularOrAbsent(filePath, storage) {
+    try {
+        const stat = await storage.lstat(filePath);
+        if (stat.isSymbolicLink() || !stat.isFile()) {
+            throw storageError(`Unsafe metadata file: ${filePath}`);
+        }
+    }
+    catch (error) {
+        if ((0, error_code_js_1.errorCode)(error) === 'ENOENT')
+            return;
+        throw error;
+    }
+}
+async function writeAll(handle, bytes) {
+    let offset = 0;
+    while (offset < bytes.byteLength) {
+        const written = await handle.write(bytes, offset, bytes.byteLength - offset, offset);
+        const count = typeof written === 'number' ? written : written.bytesWritten;
+        if (!Number.isSafeInteger(count) || count <= 0) {
+            throw storageError('Unable to write atomic metadata');
+        }
+        offset += count;
+    }
+}
+async function readAll(handle, size) {
+    const bytes = b4a_1.default.alloc(size);
+    let offset = 0;
+    while (offset < size) {
+        const read = await handle.read(bytes, offset, size - offset, offset);
+        const count = typeof read === 'number' ? read : read.bytesRead;
+        if (!Number.isSafeInteger(count) || count <= 0) {
+            throw storageError('Truncated metadata file');
+        }
+        offset += count;
+    }
+    return bytes;
+}
+async function syncDirectory(directory, storage) {
+    const handle = await storage.open(directory, 'r');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function writeAtomic(filePath, bytes, storage = _fs_1.default.promises) {
+    if (!(b4a_1.default.isBuffer(bytes) || bytes instanceof Uint8Array)) {
+        throw storageError('Atomic metadata must be bytes');
+    }
+    const directory = _path_1.default.dirname(filePath);
+    const temporary = _path_1.default.join(directory, `.${_path_1.default.basename(filePath)}.${randomSuffix()}.tmp`);
+    let renamed = false;
+    try {
+        await (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, () => assertRegularOrAbsent(filePath, storage));
+        await (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, async () => {
+            const handle = await storage.open(temporary, 'wx', 0o600);
+            try {
+                await writeAll(handle, bytes);
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+        });
+        await (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, () => assertRegularOrAbsent(filePath, storage));
+        await (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, async () => {
+            await storage.rename(temporary, filePath);
+            renamed = true;
+        });
+        await (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, () => syncDirectory(directory, storage));
+    }
+    catch (error) {
+        if (!renamed) {
+            await (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, () => storage.unlink(temporary)).catch(() => { });
+        }
+        throw markAtomicWriteError(error, renamed ? exports.ATOMIC_WRITE_PHASE.AFTER_RENAME : exports.ATOMIC_WRITE_PHASE.BEFORE_RENAME);
+    }
+}
+function readJson(filePath, storage = _fs_1.default.promises, maxBytes = MAX_SESSION_METADATA_BYTES) {
+    try {
+        if (!Number.isSafeInteger(maxBytes) || maxBytes < 0) {
+            return Promise.reject(storageError('Invalid metadata size limit'));
+        }
+        const directory = _path_1.default.dirname(filePath);
+        return (0, layout_js_1.withSafeDirectoryIdentity)(directory, storage, async () => {
+            let handle = null;
+            try {
+                handle = await (0, layout_js_1.openSafeRegularFile)(filePath, 'read', storage);
+                const stat = await handle.stat();
+                if (!Number.isSafeInteger(stat.size) || stat.size < 0 || stat.size > maxBytes) {
+                    throw storageError(`Metadata file exceeds ${maxBytes} byte limit`);
+                }
+                const bytes = await readAll(handle, stat.size);
+                let parsed;
+                try {
+                    parsed = JSON.parse(b4a_1.default.toString(bytes, 'utf8'));
+                }
+                catch (error) {
+                    throw new MetadataFormatError(`Malformed metadata file: ${filePath}`, error);
+                }
+                if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                    throw new MetadataFormatError(`Malformed metadata file: ${filePath}`);
+                }
+                return parsed;
+            }
+            catch (error) {
+                if (error instanceof errors_js_1.SwarmDeployError || error instanceof MetadataFormatError)
+                    throw error;
+                throw error;
+            }
+            finally {
+                if (handle)
+                    await handle.close();
+            }
+        });
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+}
+//# sourceMappingURL=atomic-file.js.map

package/dist/storage/atomic-file.js.map

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

package/dist/storage/commit-journal.d.ts

@@ -0,0 +1,83 @@
+import type { StorageAdapter, StorageLayout, StorageStat } from './types.js';
+declare const COMMIT_VERSION = 1;
+declare const REPLACEMENT_COMMIT_VERSION = 2;
+declare const JOURNAL_VERSION = 1;
+declare const REPLACEMENT_JOURNAL_VERSION = 2;
+declare const MAX_COMMIT_METADATA_BYTES: number;
+/** Ordered v2 transaction boundaries; each one is durable before the next. */
+export declare const REPLACEMENT_PHASES: readonly ['journaled', 'deduped', 'history-linked', 'publication-linked', 'final-renamed', 'current-sidecar', 'history-sidecar', 'cleanup'];
+export type ReplacementPhase = (typeof REPLACEMENT_PHASES)[number];
+export declare class CorruptJournalError extends Error {
+    cause: unknown | null;
+    constructor(message: string, cause?: unknown | null);
+}
+export declare function isHex(value: unknown): value is string;
+export declare function fileIdentity(stat: StorageStat): {
+    dev: string;
+    ino: string;
+};
+export declare function identitiesEqual(left: {
+    dev: string;
+    ino: string;
+}, right: {
+    dev: string;
+    ino: string;
+}): boolean;
+/** The mutable name, transfer, and history path one replacement superseded. */
+export interface CommitReplacement {
+    name: string;
+    transferId: string;
+    historyName: string;
+}
+export interface CommitRecord {
+    version: number;
+    name: string;
+    size: number;
+    sha256: string;
+    committedAt: number;
+    uploaderFingerprint: string;
+    transferId: string;
+    replaces?: CommitReplacement;
+}
+/** Validates in place so unknown persisted fields survive a read/write round-trip. */
+export declare function assertCommitRecord(record: unknown): CommitRecord;
+export interface FileIdentity {
+    dev: string;
+    ino: string;
+}
+export interface CommitJournal {
+    version: 1;
+    record: CommitRecord;
+    attemptId: string;
+    sourceStagingIdentity: FileIdentity;
+    state: 'committing' | 'aborting';
+}
+/**
+ * The v2 transaction. It names the mutable final, the pinned old record and
+ * inode, the destination history path, the private publication, every owned
+ * inode identity, and the phase the attempt reached.
+ */
+export interface ReplacementJournal {
+    version: 2;
+    intent: 'replace';
+    state: 'committing' | 'aborting';
+    phase: ReplacementPhase;
+    transferId: string;
+    attemptId: string;
+    name: string;
+    historyName: string;
+    publicationName: string;
+    sourceStagingIdentity: FileIdentity;
+    finalIdentity: FileIdentity;
+    historyIdentity: FileIdentity;
+    publicationIdentity: FileIdentity;
+    dedupHistoryName: string | null;
+    oldRecord: CommitRecord;
+    record: CommitRecord;
+}
+export type AnyCommitJournal = CommitJournal | ReplacementJournal;
+export declare function isReplacementJournal(journal: AnyCommitJournal | null): journal is ReplacementJournal;
+/** The exact durable shape of a journal, for creation and phase transitions. */
+export declare function serializeJournal(journal: AnyCommitJournal): Record<string, unknown>;
+export declare function readCommitJournal(id: string, layout: StorageLayout, storage: StorageAdapter): Promise<AnyCommitJournal | null>;
+export { COMMIT_VERSION, REPLACEMENT_COMMIT_VERSION, JOURNAL_VERSION, REPLACEMENT_JOURNAL_VERSION, MAX_COMMIT_METADATA_BYTES };

package/dist/storage/commit-journal.js

@@ -0,0 +1,279 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_COMMIT_METADATA_BYTES = exports.REPLACEMENT_JOURNAL_VERSION = exports.JOURNAL_VERSION = exports.REPLACEMENT_COMMIT_VERSION = exports.COMMIT_VERSION = exports.CorruptJournalError = exports.REPLACEMENT_PHASES = void 0;
+exports.isHex = isHex;
+exports.fileIdentity = fileIdentity;
+exports.identitiesEqual = identitiesEqual;
+exports.assertCommitRecord = assertCommitRecord;
+exports.isReplacementJournal = isReplacementJournal;
+exports.serializeJournal = serializeJournal;
+exports.readCommitJournal = readCommitJournal;
+const b4a_1 = __importDefault(require("b4a"));
+const error_code_js_1 = require("../error-code.js");
+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 validation_js_1 = require("../validation.js");
+const atomic_file_js_1 = require("./atomic-file.js");
+const layout_js_1 = require("./layout.js");
+const COMMIT_VERSION = 1;
+exports.COMMIT_VERSION = COMMIT_VERSION;
+const REPLACEMENT_COMMIT_VERSION = 2;
+exports.REPLACEMENT_COMMIT_VERSION = REPLACEMENT_COMMIT_VERSION;
+const JOURNAL_VERSION = 1;
+exports.JOURNAL_VERSION = JOURNAL_VERSION;
+const REPLACEMENT_JOURNAL_VERSION = 2;
+exports.REPLACEMENT_JOURNAL_VERSION = REPLACEMENT_JOURNAL_VERSION;
+const MAX_COMMIT_METADATA_BYTES = 16 * 1024;
+exports.MAX_COMMIT_METADATA_BYTES = MAX_COMMIT_METADATA_BYTES;
+function sameTransferId(left, right) {
+    return (isHex(left) &&
+        isHex(right) &&
+        sodium_native_1.default.sodium_memcmp(b4a_1.default.from(left, 'hex'), b4a_1.default.from(right, 'hex')));
+}
+/** Ordered v2 transaction boundaries; each one is durable before the next. */
+exports.REPLACEMENT_PHASES = [
+    'journaled',
+    'deduped',
+    'history-linked',
+    'publication-linked',
+    'final-renamed',
+    'current-sidecar',
+    'history-sidecar',
+    'cleanup'
+];
+function isReplacementPhase(value) {
+    return typeof value === 'string' && exports.REPLACEMENT_PHASES.includes(value);
+}
+class CorruptJournalError extends Error {
+    cause;
+    constructor(message, cause = null) {
+        super(message);
+        this.name = 'CorruptJournalError';
+        this.cause = cause;
+    }
+}
+exports.CorruptJournalError = CorruptJournalError;
+function storageError(message, cause = null) {
+    return new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, message, cause);
+}
+function isHex(value) {
+    return typeof value === 'string' && /^[0-9a-f]{64}$/.test(value);
+}
+function identityValue(value) {
+    if ((typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) &&
+        (typeof value !== 'bigint' || value < 0n)) {
+        throw storageError('Storage file identity is unavailable');
+    }
+    return String(value);
+}
+function fileIdentity(stat) {
+    return { dev: identityValue(stat.dev), ino: identityValue(stat.ino) };
+}
+function identitiesEqual(left, right) {
+    return left.dev === right.dev && left.ino === right.ino;
+}
+function isRecordLike(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertReplacement(value) {
+    if (!isRecordLike(value))
+        throw storageError('Invalid commit replacement metadata');
+    if (typeof value.name !== 'string' || (0, files_js_1.isReservedHistoryName)(value.name)) {
+        throw storageError('Invalid replaced name');
+    }
+    (0, files_js_1.validateBasename)(value.name);
+    if (!isHex(value.transferId))
+        throw storageError('Invalid replaced transfer ID');
+    if (value.historyName !== (0, files_js_1.historyName)(value.transferId)) {
+        throw storageError('Invalid replacement history name');
+    }
+}
+function assertCommitRecordShape(record) {
+    if (!isRecordLike(record))
+        throw storageError('Invalid commit record');
+    const candidate = record;
+    if (candidate.version !== COMMIT_VERSION && candidate.version !== REPLACEMENT_COMMIT_VERSION) {
+        throw storageError('Invalid commit record version');
+    }
+    (0, files_js_1.validateBasename)(typeof candidate.name === 'string' ? candidate.name : '');
+    (0, validation_js_1.assertSafeUint)(candidate.size, 'commit size');
+    if (!isHex(candidate.sha256))
+        throw storageError('Invalid commit digest');
+    (0, validation_js_1.assertSafeUint)(candidate.committedAt, 'commit timestamp');
+    if (!isHex(candidate.uploaderFingerprint))
+        throw storageError('Invalid uploader fingerprint');
+    if (!isHex(candidate.transferId))
+        throw storageError('Invalid commit transfer ID');
+    if (candidate.version === REPLACEMENT_COMMIT_VERSION) {
+        assertReplacement(candidate.replaces);
+    }
+    else if (candidate.replaces !== undefined) {
+        throw storageError('Unexpected commit replacement metadata');
+    }
+}
+/** Validates in place so unknown persisted fields survive a read/write round-trip. */
+function assertCommitRecord(record) {
+    assertCommitRecordShape(record);
+    return record;
+}
+function isReplacementJournal(journal) {
+    return journal !== null && journal.version === REPLACEMENT_JOURNAL_VERSION;
+}
+function parseIdentity(value) {
+    if (!isRecordLike(value))
+        throw new CorruptJournalError('Invalid commit journal');
+    const { dev, ino } = value;
+    if (typeof dev !== 'string' ||
+        typeof ino !== 'string' ||
+        !/^(0|[1-9][0-9]*)$/.test(dev) ||
+        !/^(0|[1-9][0-9]*)$/.test(ino)) {
+        throw new CorruptJournalError('Invalid commit journal');
+    }
+    return { dev, ino };
+}
+function parseRecord(value) {
+    try {
+        return assertCommitRecord(value);
+    }
+    catch (error) {
+        throw new CorruptJournalError('Invalid commit journal record', error);
+    }
+}
+function parseReplacementJournal(id, journal) {
+    if (journal.intent !== 'replace' ||
+        (journal.state !== 'committing' && journal.state !== 'aborting') ||
+        !isReplacementPhase(journal.phase) ||
+        !sameTransferId(journal.transferId, id) ||
+        !isHex(journal.attemptId) ||
+        typeof journal.name !== 'string' ||
+        journal.publicationName !== `${journal.attemptId}.part`) {
+        throw new CorruptJournalError('Invalid replacement journal');
+    }
+    let name;
+    try {
+        name = (0, files_js_1.validateBasename)(journal.name);
+        if ((0, files_js_1.isReservedHistoryName)(name))
+            throw storageError('Reserved replacement name');
+    }
+    catch (error) {
+        throw new CorruptJournalError('Invalid replacement journal name', error);
+    }
+    const record = parseRecord(journal.record);
+    const oldRecord = parseRecord(journal.oldRecord);
+    if (!sameTransferId(record.transferId, id)) {
+        throw new CorruptJournalError('Commit journal ID mismatch');
+    }
+    if (record.name !== name)
+        throw new CorruptJournalError('Replacement journal name mismatch');
+    if (journal.historyName !== (0, files_js_1.historyName)(oldRecord.transferId)) {
+        throw new CorruptJournalError('Invalid replacement history name');
+    }
+    if (sameTransferId(oldRecord.transferId, record.transferId)) {
+        throw new CorruptJournalError('Replacement journal replaces its own transfer');
+    }
+    if (journal.dedupHistoryName !== null &&
+        journal.dedupHistoryName !== (0, files_js_1.historyName)(record.transferId)) {
+        throw new CorruptJournalError('Invalid replacement dedup name');
+    }
+    return {
+        version: REPLACEMENT_JOURNAL_VERSION,
+        intent: 'replace',
+        state: journal.state,
+        phase: journal.phase,
+        transferId: id,
+        attemptId: journal.attemptId,
+        name,
+        historyName: journal.historyName,
+        publicationName: journal.publicationName,
+        sourceStagingIdentity: parseIdentity(journal.sourceStagingIdentity),
+        finalIdentity: parseIdentity(journal.finalIdentity),
+        historyIdentity: parseIdentity(journal.historyIdentity),
+        publicationIdentity: parseIdentity(journal.publicationIdentity),
+        dedupHistoryName: journal.dedupHistoryName,
+        oldRecord,
+        record
+    };
+}
+/** The exact durable shape of a journal, for creation and phase transitions. */
+function serializeJournal(journal) {
+    if (journal.version === REPLACEMENT_JOURNAL_VERSION) {
+        return {
+            version: REPLACEMENT_JOURNAL_VERSION,
+            intent: journal.intent,
+            state: journal.state,
+            phase: journal.phase,
+            transferId: journal.transferId,
+            attemptId: journal.attemptId,
+            name: journal.name,
+            historyName: journal.historyName,
+            publicationName: journal.publicationName,
+            sourceStagingIdentity: journal.sourceStagingIdentity,
+            finalIdentity: journal.finalIdentity,
+            historyIdentity: journal.historyIdentity,
+            publicationIdentity: journal.publicationIdentity,
+            dedupHistoryName: journal.dedupHistoryName,
+            oldRecord: journal.oldRecord,
+            record: journal.record
+        };
+    }
+    return {
+        version: JOURNAL_VERSION,
+        state: journal.state,
+        transferId: journal.record.transferId,
+        attemptId: journal.attemptId,
+        sourceStagingIdentity: journal.sourceStagingIdentity,
+        record: journal.record
+    };
+}
+async function readCommitJournal(id, layout, storage) {
+    if (!isHex(id))
+        throw storageError('Invalid journal ID');
+    const journalPath = _path_1.default.join(layout.journals, `${id}.json`);
+    let journal;
+    try {
+        try {
+            await (0, layout_js_1.assertSafeFile)(journalPath, storage);
+        }
+        catch (err) {
+            if ((0, error_code_js_1.isMissing)(err))
+                return null;
+            throw err;
+        }
+        journal = await (0, atomic_file_js_1.readJson)(journalPath, storage, MAX_COMMIT_METADATA_BYTES);
+        if (journal.version === REPLACEMENT_JOURNAL_VERSION) {
+            return parseReplacementJournal(id, journal);
+        }
+        if (journal.version !== JOURNAL_VERSION ||
+            (journal.state !== 'committing' && journal.state !== 'aborting') ||
+            !sameTransferId(journal.transferId, id) ||
+            !isHex(journal.attemptId)) {
+            throw new CorruptJournalError('Invalid commit journal');
+        }
+        const sourceStagingIdentity = parseIdentity(journal.sourceStagingIdentity);
+        const record = parseRecord(journal.record);
+        if (!sameTransferId(record.transferId, id)) {
+            throw new CorruptJournalError('Commit journal ID mismatch');
+        }
+        return {
+            version: JOURNAL_VERSION,
+            record,
+            attemptId: journal.attemptId,
+            sourceStagingIdentity,
+            state: journal.state
+        };
+    }
+    catch (error) {
+        if (error instanceof CorruptJournalError)
+            throw error;
+        if (error instanceof atomic_file_js_1.MetadataFormatError) {
+            throw new CorruptJournalError('Malformed commit journal', error);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=commit-journal.js.map

package/dist/storage/commit-journal.js.map

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