swarm-deploy 0.0.0 → 0.2.0

package/dist/tar-protocol/controls.js

@@ -0,0 +1,291 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CONTROL_RECORD_BYTES = exports.CONTROL_VERSION = void 0;
+exports.isTreeMetadata = isTreeMetadata;
+exports.assertSourceParent = assertSourceParent;
+exports.encodeMetadataRecord = encodeMetadataRecord;
+exports.decodeMetadataRecord = decodeMetadataRecord;
+exports.encodeTreeMetadataRecord = encodeTreeMetadataRecord;
+exports.decodeTreeMetadataRecord = decodeTreeMetadataRecord;
+exports.encodeAnyMetadataRecord = encodeAnyMetadataRecord;
+exports.decodeAnyMetadataRecord = decodeAnyMetadataRecord;
+exports.encodeAdmissionRecord = encodeAdmissionRecord;
+exports.decodeAdmissionRecord = decodeAdmissionRecord;
+exports.encodeFinalRecord = encodeFinalRecord;
+exports.decodeFinalRecord = decodeFinalRecord;
+exports.encodeControlFrame = encodeControlFrame;
+const b4a_1 = __importDefault(require("b4a"));
+const errors_js_1 = require("../errors.js");
+const tree_path_js_1 = require("./tree-path.js");
+const ustar_js_1 = require("./ustar.js");
+exports.CONTROL_VERSION = 1;
+exports.MAX_CONTROL_RECORD_BYTES = 4 * 1024;
+const HEX_32 = /^[0-9a-f]{64}$/;
+const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
+const SAFE_SOURCE_PARENT = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,199}$/;
+const HISTORY_PREFIX = 'history-';
+const STABLE_CODES = new Set(Object.values(errors_js_1.ERRORS));
+function isTreeMetadata(value) {
+    return value.kind === 'directory';
+}
+function invalid(message, cause = null) {
+    return new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, message, cause);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function exactKeys(value, expected) {
+    const actual = Object.keys(value).sort();
+    const wanted = [...expected].sort();
+    if (actual.length !== wanted.length || actual.some((key, index) => key !== wanted[index])) {
+        throw invalid('Unexpected control record fields');
+    }
+}
+function assertVersion(value) {
+    if (value !== exports.CONTROL_VERSION)
+        throw invalid('Unsupported control record version');
+}
+function assertSafeUint(value, name) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw invalid(`Invalid ${name}`);
+    }
+}
+function assertHex32(value, name) {
+    if (typeof value !== 'string' || !HEX_32.test(value))
+        throw invalid(`Invalid ${name}`);
+}
+function assertName(value) {
+    if (typeof value !== 'string' ||
+        !SAFE_NAME.test(value) ||
+        value.startsWith(HISTORY_PREFIX) ||
+        b4a_1.default.from(value).byteLength > 100) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Invalid TAR filename');
+    }
+}
+function assertSourceParent(value) {
+    if (typeof value !== 'string' ||
+        !SAFE_SOURCE_PARENT.test(value) ||
+        b4a_1.default.from(value).byteLength > 100) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Invalid source parent');
+    }
+}
+function assertStableCode(value) {
+    if (typeof value !== 'string' || !STABLE_CODES.has(value))
+        throw invalid('Invalid error code');
+}
+function parseRecord(bytes) {
+    if (!b4a_1.default.isBuffer(bytes) || bytes.byteLength === 0)
+        throw invalid('Invalid control record');
+    if (bytes.byteLength > exports.MAX_CONTROL_RECORD_BYTES)
+        throw invalid('Control record too large');
+    let value;
+    try {
+        value = JSON.parse(b4a_1.default.toString(bytes, 'utf8'));
+    }
+    catch (error) {
+        throw invalid('Malformed control record', error);
+    }
+    if (!isRecord(value))
+        throw invalid('Control record must be an object');
+    return value;
+}
+function encodeRecord(value, validate) {
+    const checked = validate(value);
+    const encoded = b4a_1.default.from(JSON.stringify(checked));
+    if (encoded.byteLength > exports.MAX_CONTROL_RECORD_BYTES)
+        throw invalid('Control record too large');
+    return encoded;
+}
+function validateMetadata(value) {
+    if (!isRecord(value))
+        throw invalid('Metadata record must be an object');
+    const expected = [
+        'v',
+        'name',
+        'fileSize',
+        'fileSha256',
+        'tarSize',
+        'tarSha256',
+        'transferId',
+        'reset'
+    ];
+    if (Object.prototype.hasOwnProperty.call(value, 'sourceParent')) {
+        expected.push('sourceParent');
+    }
+    exactKeys(value, expected);
+    assertVersion(value.v);
+    assertName(value.name);
+    if (Object.prototype.hasOwnProperty.call(value, 'sourceParent')) {
+        assertSourceParent(value.sourceParent);
+    }
+    assertSafeUint(value.fileSize, 'file size');
+    assertHex32(value.fileSha256, 'file digest');
+    assertSafeUint(value.tarSize, 'TAR size');
+    if (value.tarSize !== (0, ustar_js_1.deterministicTarSize)(value.fileSize))
+        throw invalid('Noncanonical TAR size');
+    assertHex32(value.tarSha256, 'TAR digest');
+    assertHex32(value.transferId, 'transfer ID');
+    if (typeof value.reset !== 'boolean')
+        throw invalid('Invalid reset flag');
+    return value;
+}
+const TAR_END_BLOCKS = 2 * ustar_js_1.TAR_BLOCK_BYTES;
+/**
+ * The exact set of TAR sizes a canonical generator can produce for these counts.
+ *
+ * Every entry owns one header block and the archive ends with two zero blocks. Only files carry
+ * payload, and each non-empty file pads to a block boundary with at most 511 bytes. At least one
+ * file exists when there is any payload, so the unpadded total is `minimum`, and at most
+ * `min(entryCount, payloadBytes)` files can each hold a padded tail. Real archives are whole blocks,
+ * so the window is the whole-block sizes from `minimum` rounded up to `maximum` rounded down.
+ */
+function assertTreeTarSize(entryCount, payloadBytes, tarSize) {
+    if (payloadBytes > entryCount * ustar_js_1.MAX_USTAR_FILE_BYTES)
+        throw invalid('Invalid tree payload size');
+    if (payloadBytes > 0 && entryCount === 0)
+        throw invalid('Invalid tree payload size');
+    const base = TAR_END_BLOCKS + ustar_js_1.TAR_BLOCK_BYTES * entryCount;
+    const minimum = base + payloadBytes;
+    const maximum = minimum + (ustar_js_1.TAR_BLOCK_BYTES - 1) * Math.min(entryCount, payloadBytes);
+    const lowest = Math.ceil(minimum / ustar_js_1.TAR_BLOCK_BYTES) * ustar_js_1.TAR_BLOCK_BYTES;
+    const highest = Math.floor(maximum / ustar_js_1.TAR_BLOCK_BYTES) * ustar_js_1.TAR_BLOCK_BYTES;
+    if (tarSize % ustar_js_1.TAR_BLOCK_BYTES !== 0 || tarSize < lowest || tarSize > highest) {
+        throw invalid('Noncanonical TAR size');
+    }
+}
+function validateTreeMetadata(value) {
+    if (!isRecord(value))
+        throw invalid('Metadata record must be an object');
+    const expected = [
+        'v',
+        'kind',
+        'name',
+        'entryCount',
+        'payloadBytes',
+        'treeSha256',
+        'tarSize',
+        'tarSha256',
+        'transferId',
+        'reset'
+    ];
+    if (Object.prototype.hasOwnProperty.call(value, 'sourceParent'))
+        expected.push('sourceParent');
+    exactKeys(value, expected);
+    assertVersion(value.v);
+    if (value.kind !== 'directory')
+        throw invalid('Invalid artifact kind');
+    assertName(value.name);
+    if (Object.prototype.hasOwnProperty.call(value, 'sourceParent')) {
+        assertSourceParent(value.sourceParent);
+    }
+    assertSafeUint(value.entryCount, 'tree entry count');
+    if (value.entryCount > tree_path_js_1.MAX_TREE_ENTRIES)
+        throw invalid('Invalid tree entry count');
+    assertSafeUint(value.payloadBytes, 'tree payload size');
+    assertHex32(value.treeSha256, 'tree digest');
+    assertSafeUint(value.tarSize, 'TAR size');
+    assertHex32(value.tarSha256, 'TAR digest');
+    assertHex32(value.transferId, 'transfer ID');
+    if (typeof value.reset !== 'boolean')
+        throw invalid('Invalid reset flag');
+    assertTreeTarSize(value.entryCount, value.payloadBytes, value.tarSize);
+    return value;
+}
+function validateAnyMetadata(value) {
+    if (!isRecord(value))
+        throw invalid('Metadata record must be an object');
+    return Object.prototype.hasOwnProperty.call(value, 'kind')
+        ? validateTreeMetadata(value)
+        : validateMetadata(value);
+}
+function validateAdmission(value) {
+    if (!isRecord(value))
+        throw invalid('Admission record must be an object');
+    assertVersion(value.v);
+    if (value.status === 'ACCEPT') {
+        exactKeys(value, ['v', 'status', 'offset']);
+        if (value.offset !== 0)
+            throw invalid('Invalid ACCEPT offset');
+    }
+    else if (value.status === 'RESUME') {
+        exactKeys(value, ['v', 'status', 'offset', 'prefixSha256']);
+        assertSafeUint(value.offset, 'resume offset');
+        if (value.offset === 0)
+            throw invalid('Invalid resume offset');
+        assertHex32(value.prefixSha256, 'prefix digest');
+    }
+    else if (value.status === 'VERIFIED' || value.status === 'ALREADY_COMMITTED') {
+        exactKeys(value, ['v', 'status']);
+    }
+    else if (value.status === 'REJECTED') {
+        exactKeys(value, ['v', 'status', 'code']);
+        assertStableCode(value.code);
+    }
+    else {
+        throw invalid('Invalid admission status');
+    }
+    return value;
+}
+function validateFinal(value) {
+    if (!isRecord(value))
+        throw invalid('Final record must be an object');
+    assertVersion(value.v);
+    if (value.status === 'COMMITTED') {
+        exactKeys(value, ['v', 'status']);
+    }
+    else if (value.status === 'FAILED') {
+        exactKeys(value, ['v', 'status', 'code']);
+        assertStableCode(value.code);
+    }
+    else {
+        throw invalid('Invalid final status');
+    }
+    return value;
+}
+function encodeMetadataRecord(value) {
+    return encodeRecord(value, validateMetadata);
+}
+function decodeMetadataRecord(bytes) {
+    return validateMetadata(parseRecord(bytes));
+}
+function encodeTreeMetadataRecord(value) {
+    return encodeRecord(value, validateTreeMetadata);
+}
+function decodeTreeMetadataRecord(bytes) {
+    return validateTreeMetadata(parseRecord(bytes));
+}
+function encodeAnyMetadataRecord(value) {
+    return encodeRecord(value, validateAnyMetadata);
+}
+function decodeAnyMetadataRecord(bytes) {
+    return validateAnyMetadata(parseRecord(bytes));
+}
+function encodeAdmissionRecord(value) {
+    return encodeRecord(value, validateAdmission);
+}
+function decodeAdmissionRecord(bytes) {
+    return validateAdmission(parseRecord(bytes));
+}
+function encodeFinalRecord(value) {
+    return encodeRecord(value, validateFinal);
+}
+function decodeFinalRecord(bytes) {
+    return validateFinal(parseRecord(bytes));
+}
+function encodeControlFrame(record) {
+    if (!b4a_1.default.isBuffer(record) || record.byteLength === 0)
+        throw invalid('Invalid control record');
+    if (record.byteLength > exports.MAX_CONTROL_RECORD_BYTES)
+        throw invalid('Control record too large');
+    const frame = b4a_1.default.alloc(4 + record.byteLength);
+    frame[0] = (record.byteLength >>> 24) & 0xff;
+    frame[1] = (record.byteLength >>> 16) & 0xff;
+    frame[2] = (record.byteLength >>> 8) & 0xff;
+    frame[3] = record.byteLength & 0xff;
+    frame.set(record, 4);
+    return frame;
+}
+//# sourceMappingURL=controls.js.map

package/dist/tar-protocol/controls.js.map

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

package/dist/tar-protocol/direct-wire.d.ts

@@ -0,0 +1,43 @@
+import { type AbortSignalLike } from '../abort.js';
+import type { DirectDhtSocket } from '../direct-dht.js';
+import { decodeAdmissionRecord, decodeAnyMetadataRecord, decodeFinalRecord, type AdmissionRecord, type AnyMetadataRecord, type FinalRecord } from './controls.js';
+import { type ProtocolWriteOptions } from './lifecycle.js';
+/** Exact, bounded, phase-aware reader for a half-closed direct stream. */
+export declare class DirectWireReader {
+    private readonly socket;
+    private readonly chunks;
+    private available;
+    private ended;
+    private failure;
+    private wake;
+    private readonly data;
+    private readonly end;
+    private readonly close;
+    private readonly error;
+    constructor(socket: DirectDhtSocket);
+    private notify;
+    /** Resolves on the next socket event: data, end, close, or error. */
+    private awaitEvent;
+    /**
+     * Returns only once at least one byte is buffered.
+     *
+     * The terminal checks are re-evaluated after every wake, not just on entry: a
+     * peer that half-closes mid-phase wakes this with no data, and resolving
+     * there would hand the caller an empty `chunks` array to dereference.
+     */
+    private wait;
+    exact(bytes: number, signal: AbortSignalLike | null | undefined, timeout: number): Promise<Buffer>;
+    control<T>(decode: (bytes: Uint8Array) => T, signal: AbortSignalLike | null | undefined, timeout: number): Promise<T>;
+    tar(length: number, write: (bytes: Buffer) => Promise<void>, signal: AbortSignalLike | null | undefined, timeout: number): Promise<void>;
+    /** The sender's write-half close is the deterministic no-trailing boundary. */
+    requireEnd(signal: AbortSignalLike | null | undefined, timeout: number): Promise<void>;
+    closeReader(): void;
+}
+export declare function endWrite(socket: DirectDhtSocket): void;
+export declare function writeMetadata(socket: DirectDhtSocket, metadata: AnyMetadataRecord, options?: ProtocolWriteOptions): Promise<void>;
+export declare function writeAdmission(socket: DirectDhtSocket, value: AdmissionRecord, options?: ProtocolWriteOptions): Promise<void>;
+export declare function writeFinal(socket: DirectDhtSocket, value: FinalRecord, options?: ProtocolWriteOptions): Promise<void>;
+export declare function writeTar(socket: DirectDhtSocket, value: Uint8Array, options?: ProtocolWriteOptions): Promise<void>;
+export declare const decodeDirectMetadata: typeof decodeAnyMetadataRecord;
+export declare const decodeDirectAdmission: typeof decodeAdmissionRecord;
+export declare const decodeDirectFinal: typeof decodeFinalRecord;

package/dist/tar-protocol/direct-wire.js

@@ -0,0 +1,194 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeDirectFinal = exports.decodeDirectAdmission = exports.decodeDirectMetadata = exports.DirectWireReader = void 0;
+exports.endWrite = endWrite;
+exports.writeMetadata = writeMetadata;
+exports.writeAdmission = writeAdmission;
+exports.writeFinal = writeFinal;
+exports.writeTar = writeTar;
+const b4a_1 = __importDefault(require("b4a"));
+const abort_js_1 = require("../abort.js");
+const errors_js_1 = require("../errors.js");
+const controls_js_1 = require("./controls.js");
+const lifecycle_js_1 = require("./lifecycle.js");
+function invalid(message, cause = null) {
+    return new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, message, cause);
+}
+/** Exact, bounded, phase-aware reader for a half-closed direct stream. */
+class DirectWireReader {
+    socket;
+    chunks = [];
+    available = 0;
+    ended = false;
+    failure = null;
+    wake = null;
+    data = (value) => {
+        if (!b4a_1.default.isBuffer(value) || value.byteLength === 0)
+            return;
+        this.chunks.push(b4a_1.default.from(value));
+        this.available += value.byteLength;
+        this.socket.pause?.();
+        this.notify();
+    };
+    end = () => {
+        this.ended = true;
+        this.notify();
+    };
+    close = () => {
+        if (!this.ended)
+            this.failure = invalid('Direct DHT stream closed without protocol completion');
+        this.notify();
+    };
+    error = (error) => {
+        this.failure = error;
+        this.notify();
+    };
+    constructor(socket) {
+        this.socket = socket;
+        this.socket.on('data', this.data);
+        this.socket.on('end', this.end);
+        this.socket.on('close', this.close);
+        this.socket.on('error', this.error);
+        this.socket.pause?.();
+    }
+    notify() {
+        const wake = this.wake;
+        this.wake = null;
+        wake?.();
+    }
+    /** Resolves on the next socket event: data, end, close, or error. */
+    awaitEvent(signal, timeout) {
+        return new Promise((resolve, reject) => {
+            let remove = () => { };
+            const timer = setTimeout(() => finish(new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.UPLOAD_IDLE_TIMEOUT, 'Direct protocol read timed out')), timeout);
+            const finish = (error = null) => {
+                clearTimeout(timer);
+                remove();
+                this.wake = null;
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            };
+            remove = (0, abort_js_1.onAbort)(signal, () => finish((0, abort_js_1.abortError)()));
+            this.wake = () => finish(this.failure);
+            this.socket.resume?.();
+        });
+    }
+    /**
+     * Returns only once at least one byte is buffered.
+     *
+     * The terminal checks are re-evaluated after every wake, not just on entry: a
+     * peer that half-closes mid-phase wakes this with no data, and resolving
+     * there would hand the caller an empty `chunks` array to dereference.
+     */
+    async wait(signal, timeout) {
+        while (this.available === 0) {
+            if (this.failure)
+                throw this.failure;
+            if (this.ended)
+                throw invalid('Truncated direct protocol phase');
+            if (signal?.aborted)
+                throw (0, abort_js_1.abortError)();
+            await this.awaitEvent(signal, timeout);
+        }
+    }
+    async exact(bytes, signal, timeout) {
+        if (!Number.isSafeInteger(bytes) || bytes < 0)
+            throw invalid('Invalid direct stream length');
+        const result = b4a_1.default.alloc(bytes);
+        let offset = 0;
+        while (offset < bytes) {
+            await this.wait(signal, timeout);
+            const chunk = this.chunks[0];
+            const take = Math.min(bytes - offset, chunk.byteLength);
+            result.set(chunk.subarray(0, take), offset);
+            offset += take;
+            this.available -= take;
+            if (take === chunk.byteLength)
+                this.chunks.shift();
+            else
+                this.chunks[0] = chunk.subarray(take);
+        }
+        return result;
+    }
+    async control(decode, signal, timeout) {
+        const prefix = await this.exact(4, signal, timeout);
+        const length = prefix[0] * 0x1000000 + prefix[1] * 0x10000 + prefix[2] * 0x100 + prefix[3];
+        if (length <= 0 || length > controls_js_1.MAX_CONTROL_RECORD_BYTES) {
+            throw invalid('Invalid control frame length');
+        }
+        return decode(await this.exact(length, signal, timeout));
+    }
+    async tar(length, write, signal, timeout) {
+        let remaining = length;
+        while (remaining > 0) {
+            await this.wait(signal, timeout);
+            const chunk = this.chunks[0];
+            const take = Math.min(remaining, chunk.byteLength);
+            const part = chunk.subarray(0, take);
+            this.available -= take;
+            remaining -= take;
+            if (take === chunk.byteLength)
+                this.chunks.shift();
+            else
+                this.chunks[0] = chunk.subarray(take);
+            await write(part);
+        }
+    }
+    /** The sender's write-half close is the deterministic no-trailing boundary. */
+    async requireEnd(signal, timeout) {
+        if (this.available !== 0)
+            throw invalid('Trailing bytes after exact TAR payload');
+        while (!this.ended && !this.failure) {
+            if (signal?.aborted)
+                throw (0, abort_js_1.abortError)();
+            // Waits on the raw event here: reaching end-of-stream is the success
+            // condition for this phase, not a truncation.
+            await this.awaitEvent(signal, timeout);
+            if (this.available !== 0)
+                throw invalid('Trailing bytes after exact TAR payload');
+        }
+        if (this.failure)
+            throw this.failure;
+    }
+    closeReader() {
+        for (const event of ['data', 'end', 'close', 'error']) {
+            const listener = event === 'data'
+                ? this.data
+                : event === 'end'
+                    ? this.end
+                    : event === 'close'
+                        ? this.close
+                        : this.error;
+            this.socket.removeListener(event, listener);
+        }
+        this.socket.resume?.();
+    }
+}
+exports.DirectWireReader = DirectWireReader;
+function endWrite(socket) {
+    const stream = socket;
+    if (typeof stream.end !== 'function')
+        throw invalid('Direct DHT socket cannot close write half');
+    stream.end();
+}
+function writeMetadata(socket, metadata, options = {}) {
+    return (0, lifecycle_js_1.writeFramedProtocolRecord)(socket, (0, controls_js_1.encodeAnyMetadataRecord)(metadata), options);
+}
+function writeAdmission(socket, value, options = {}) {
+    return (0, lifecycle_js_1.writeFramedProtocolRecord)(socket, (0, controls_js_1.encodeAdmissionRecord)(value), options);
+}
+function writeFinal(socket, value, options = {}) {
+    return (0, lifecycle_js_1.writeFramedProtocolRecord)(socket, (0, controls_js_1.encodeFinalRecord)(value), options);
+}
+function writeTar(socket, value, options = {}) {
+    return (0, lifecycle_js_1.writeProtocolBytes)(socket, value, options);
+}
+exports.decodeDirectMetadata = controls_js_1.decodeAnyMetadataRecord;
+exports.decodeDirectAdmission = controls_js_1.decodeAdmissionRecord;
+exports.decodeDirectFinal = controls_js_1.decodeFinalRecord;
+//# sourceMappingURL=direct-wire.js.map

package/dist/tar-protocol/direct-wire.js.map

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

package/dist/tar-protocol/extract.d.ts

@@ -0,0 +1,18 @@
+import { type AbortSignalLike } from '../abort.js';
+import { type MetadataRecord } from './controls.js';
+export interface TarExtractionStaging {
+    writeTar(chunk: Uint8Array): void | Promise<void>;
+    writeFile(chunk: Uint8Array): void | Promise<void>;
+    complete(): void | Promise<void>;
+    abort(error: unknown): void | Promise<void>;
+}
+export interface TarExtractionOptions {
+    signal?: AbortSignalLike | null;
+}
+export interface TarExtractionResult {
+    fileSize: number;
+    fileSha256: Buffer;
+    tarSize: number;
+    tarSha256: Buffer;
+}
+export declare function validateAndExtractTar(source: Iterable<Uint8Array> | AsyncIterable<Uint8Array>, offeredMetadata: MetadataRecord, staging: TarExtractionStaging, { signal }?: TarExtractionOptions): Promise<TarExtractionResult>;