swarm-deploy 0.0.0 → 0.2.0

package/dist/direct-dht.js

@@ -0,0 +1,254 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectDhtClient = exports.DirectDhtServer = void 0;
+const hyperdht_1 = __importDefault(require("hyperdht"));
+const b4a_1 = __importDefault(require("b4a"));
+const sodium_native_1 = __importDefault(require("sodium-native"));
+const abort_js_1 = require("./abort.js");
+const errors_js_1 = require("./errors.js");
+const DEFAULT_CONNECT_TIMEOUT = 10_000;
+const MAX_CONNECT_TIMEOUT = 5 * 60_000;
+function copyBytes(value, length, label) {
+    if (!b4a_1.default.isBuffer(value) || value.byteLength !== length) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, `Expected ${length}-byte ${label}`);
+    }
+    return b4a_1.default.from(value);
+}
+function copyKeyPair(keyPair) {
+    if (!keyPair || typeof keyPair !== 'object') {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Expected seeded key pair');
+    }
+    return {
+        publicKey: copyBytes(keyPair.publicKey, 32, 'public key'),
+        secretKey: copyBytes(keyPair.secretKey, 64, 'secret key')
+    };
+}
+function assertTimeout(timeout) {
+    if (!Number.isFinite(timeout) || !Number.isInteger(timeout) || timeout <= 0) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Connect timeout must be positive');
+    }
+    if (timeout > MAX_CONNECT_TIMEOUT) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Connect timeout exceeds maximum');
+    }
+}
+function createNode(options) {
+    if (options.dht !== undefined && options.dhtFactory !== undefined) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Specify either an injected DHT or a DHT factory');
+    }
+    if (options.dht !== undefined)
+        return { dht: options.dht, owned: false };
+    return {
+        dht: options.dhtFactory ? options.dhtFactory() : new hyperdht_1.default(),
+        owned: true
+    };
+}
+function safeDestroy(socket, error) {
+    try {
+        socket.destroy(error);
+    }
+    catch { }
+}
+function transportError(code, message, cause = null) {
+    const error = new errors_js_1.SwarmDeployError(code, message, cause);
+    error.transport = true;
+    return error;
+}
+class DirectDhtServer {
+    publicKey;
+    keyPair;
+    dht;
+    ownedDht;
+    server;
+    allowedClientPublicKeys;
+    onConnection;
+    sockets = new Set();
+    listenPromise = null;
+    closePromise = null;
+    closed = false;
+    constructor(options) {
+        if (!options || typeof options !== 'object') {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Invalid direct DHT server options');
+        }
+        this.keyPair = copyKeyPair(options.keyPair);
+        this.publicKey = b4a_1.default.from(this.keyPair.publicKey);
+        if (!Array.isArray(options.allowedClientPublicKeys)) {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Expected client public key allowlist');
+        }
+        this.allowedClientPublicKeys = options.allowedClientPublicKeys.map((key) => copyBytes(key, 32, 'allowed client public key'));
+        if (options.onConnection !== undefined && typeof options.onConnection !== 'function') {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Invalid connection callback');
+        }
+        this.onConnection = options.onConnection;
+        const created = createNode(options);
+        this.dht = created.dht;
+        this.ownedDht = created.owned;
+        this.dht.on('error', () => { });
+        this.server = this.dht.createServer({
+            firewall: (remotePublicKey) => this.firewall(remotePublicKey)
+        }, (socket) => this.accept(socket));
+        this.server.on('error', () => { });
+    }
+    firewall(remotePublicKey) {
+        return !this.isAllowed(remotePublicKey);
+    }
+    isAllowed(remotePublicKey) {
+        if (!b4a_1.default.isBuffer(remotePublicKey) || remotePublicKey.byteLength !== 32)
+            return false;
+        let accepted = false;
+        for (const allowed of this.allowedClientPublicKeys) {
+            accepted = sodium_native_1.default.sodium_memcmp(remotePublicKey, allowed) || accepted;
+        }
+        return accepted;
+    }
+    accept(socket) {
+        if (this.closed || !this.isAllowed(socket.remotePublicKey)) {
+            safeDestroy(socket);
+            return;
+        }
+        socket.on('error', () => { });
+        this.sockets.add(socket);
+        socket.once('close', () => this.sockets.delete(socket));
+        if (!this.onConnection)
+            return;
+        try {
+            this.onConnection(socket);
+        }
+        catch (error) {
+            safeDestroy(socket, error);
+        }
+    }
+    listen() {
+        if (this.closed) {
+            return Promise.reject(new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Direct DHT server is closed'));
+        }
+        if (!this.listenPromise) {
+            this.listenPromise = this.server.listen(this.keyPair).then(() => this);
+        }
+        return this.listenPromise;
+    }
+    close() {
+        if (!this.closePromise)
+            this.closePromise = this.closeAll();
+        return this.closePromise;
+    }
+    async closeAll() {
+        this.closed = true;
+        for (const socket of this.sockets)
+            safeDestroy(socket);
+        this.sockets.clear();
+        let failure = null;
+        try {
+            await this.server.close();
+        }
+        catch (error) {
+            failure = error;
+        }
+        if (this.ownedDht) {
+            try {
+                await this.dht.destroy();
+            }
+            catch (error) {
+                if (failure === null)
+                    failure = error;
+            }
+        }
+        if (failure !== null)
+            throw failure;
+    }
+}
+exports.DirectDhtServer = DirectDhtServer;
+class DirectDhtClient {
+    publicKey;
+    keyPair;
+    dht;
+    ownedDht;
+    connectTimeout;
+    sockets = new Set();
+    closePromise = null;
+    closed = false;
+    constructor(options) {
+        if (!options || typeof options !== 'object') {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Invalid direct DHT client options');
+        }
+        this.keyPair = copyKeyPair(options.keyPair);
+        this.publicKey = b4a_1.default.from(this.keyPair.publicKey);
+        this.connectTimeout = options.connectTimeout ?? DEFAULT_CONNECT_TIMEOUT;
+        assertTimeout(this.connectTimeout);
+        const created = createNode(options);
+        this.dht = created.dht;
+        this.ownedDht = created.owned;
+        this.dht.on('error', () => { });
+    }
+    async connect(serverPublicKey, options = {}) {
+        if (this.closed) {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Direct DHT client is closed');
+        }
+        (0, abort_js_1.throwIfAborted)(options.signal);
+        const expectedServerPublicKey = copyBytes(serverPublicKey, 32, 'server public key');
+        const timeout = options.timeout ?? this.connectTimeout;
+        assertTimeout(timeout);
+        const socket = this.dht.connect(expectedServerPublicKey, { keyPair: this.keyPair });
+        let socketError = null;
+        socket.on('error', (error) => {
+            if (socketError === null)
+                socketError = error;
+        });
+        this.sockets.add(socket);
+        socket.once('close', () => this.sockets.delete(socket));
+        try {
+            const opened = await this.awaitOpened(socket.opened, timeout, options.signal);
+            if (opened !== true) {
+                throw (socketError ||
+                    transportError(errors_js_1.ERRORS.SERVER_KEY_MISMATCH, 'Unable to authenticate expected direct DHT server'));
+            }
+            const remotePublicKey = socket.remotePublicKey;
+            if (!b4a_1.default.isBuffer(remotePublicKey) ||
+                remotePublicKey.byteLength !== 32 ||
+                !sodium_native_1.default.sodium_memcmp(remotePublicKey, expectedServerPublicKey)) {
+                throw transportError(errors_js_1.ERRORS.SERVER_KEY_MISMATCH, 'Connected direct DHT server key did not match commitment');
+            }
+            return socket;
+        }
+        catch (error) {
+            safeDestroy(socket, error);
+            throw error;
+        }
+    }
+    awaitOpened(opened, timeout, signal) {
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            let removeAbort = () => { };
+            const timer = setTimeout(() => {
+                finish(reject, transportError(errors_js_1.ERRORS.CONNECT_TIMEOUT, 'Direct DHT connection timed out'));
+            }, timeout);
+            const finish = (callback, value) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                removeAbort();
+                callback(value);
+            };
+            removeAbort = (0, abort_js_1.onAbort)(signal, () => finish(reject, (0, abort_js_1.abortError)()));
+            Promise.resolve(opened).then((value) => finish(resolve, value), (error) => finish(reject, error));
+        });
+    }
+    close() {
+        if (!this.closePromise)
+            this.closePromise = this.closeAll();
+        return this.closePromise;
+    }
+    async closeAll() {
+        this.closed = true;
+        for (const socket of this.sockets)
+            safeDestroy(socket);
+        this.sockets.clear();
+        if (this.ownedDht)
+            await this.dht.destroy();
+    }
+}
+exports.DirectDhtClient = DirectDhtClient;
+//# sourceMappingURL=direct-dht.js.map

package/dist/direct-dht.js.map

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

package/dist/error-code.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Single source for reading the `code` of an unknown thrown value.
+ *
+ * Every caller previously kept a private copy of these helpers. The one module
+ * that hand-inlined the cast instead dereferenced a null `cause`, so the shared
+ * implementation is deliberately null-safe at every step.
+ */
+export declare function errorCode(error: unknown): string | null;
+/**
+ * True when `error`, or the cause it wraps, reports ENOENT.
+ *
+ * `SwarmDeployError` always defines an own `cause` property, so it is present
+ * even when null; `errorCode` absorbs that case rather than dereferencing it.
+ */
+export declare function isMissing(error: unknown): boolean;

package/dist/error-code.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorCode = errorCode;
+exports.isMissing = isMissing;
+/**
+ * Single source for reading the `code` of an unknown thrown value.
+ *
+ * Every caller previously kept a private copy of these helpers. The one module
+ * that hand-inlined the cast instead dereferenced a null `cause`, so the shared
+ * implementation is deliberately null-safe at every step.
+ */
+function errorCode(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return null;
+    return typeof error.code === 'string' ? error.code : null;
+}
+/**
+ * True when `error`, or the cause it wraps, reports ENOENT.
+ *
+ * `SwarmDeployError` always defines an own `cause` property, so it is present
+ * even when null; `errorCode` absorbs that case rather than dereferencing it.
+ */
+function isMissing(error) {
+    if (errorCode(error) === 'ENOENT')
+        return true;
+    if (typeof error !== 'object' || error === null || !('cause' in error))
+        return false;
+    return errorCode(error.cause) === 'ENOENT';
+}
+//# sourceMappingURL=error-code.js.map

package/dist/error-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-code.js","sourceRoot":"","sources":["../src/error-code.ts"],"names":[],"mappings":";;;;AAAA;;;;;;GAMG;AACH,mBAA0B,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAClF,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC3D,CAAC;AAED;;;;;GAKG;AACH,mBAA0B,KAAc;IACtC,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACpF,OAAO,SAAS,CAAE,KAA4B,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAA;AACpE,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+export declare const ERRORS: {
+    readonly AUTH_REJECTED: 'AUTH_REJECTED';
+    readonly SERVER_KEY_MISMATCH: 'SERVER_KEY_MISMATCH';
+    readonly PROTOCOL_INVALID: 'PROTOCOL_INVALID';
+    readonly INVALID_FILENAME: 'INVALID_FILENAME';
+    readonly INVALID_SEED: 'INVALID_SEED';
+    readonly INVALID_PUBLIC_KEY: 'INVALID_PUBLIC_KEY';
+    readonly FILE_TOO_LARGE: 'FILE_TOO_LARGE';
+    readonly STAGING_LIMIT: 'STAGING_LIMIT';
+    readonly ACTIVE_UPLOAD_LIMIT: 'ACTIVE_UPLOAD_LIMIT';
+    readonly DISK_RESERVE: 'DISK_RESERVE';
+    readonly FILE_EXISTS: 'FILE_EXISTS';
+    readonly FILE_BUSY: 'FILE_BUSY';
+    readonly CHECKSUM_MISMATCH: 'CHECKSUM_MISMATCH';
+    readonly CONNECT_TIMEOUT: 'CONNECT_TIMEOUT';
+    readonly UPLOAD_IDLE_TIMEOUT: 'UPLOAD_IDLE_TIMEOUT';
+    readonly ABORTED: 'ABORTED';
+    readonly COMMIT_FAILED: 'COMMIT_FAILED';
+    readonly LINK_CONFLICT: 'LINK_CONFLICT';
+    readonly LINK_FAILED: 'LINK_FAILED';
+    readonly UNSUPPORTED_STORAGE: 'UNSUPPORTED_STORAGE';
+    readonly HOOK_FAILED: 'HOOK_FAILED';
+    readonly CLEANUP_FAILED: 'CLEANUP_FAILED';
+};
+export type ErrorCode = (typeof ERRORS)[keyof typeof ERRORS];
+export declare class SwarmDeployError extends Error {
+    code: ErrorCode | string;
+    cause: unknown | null;
+    transport?: boolean;
+    constructor(code: ErrorCode | string, message: string, cause?: unknown | null);
+}

package/dist/errors.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwarmDeployError = exports.ERRORS = void 0;
+exports.ERRORS = {
+    AUTH_REJECTED: 'AUTH_REJECTED',
+    SERVER_KEY_MISMATCH: 'SERVER_KEY_MISMATCH',
+    PROTOCOL_INVALID: 'PROTOCOL_INVALID',
+    INVALID_FILENAME: 'INVALID_FILENAME',
+    INVALID_SEED: 'INVALID_SEED',
+    INVALID_PUBLIC_KEY: 'INVALID_PUBLIC_KEY',
+    FILE_TOO_LARGE: 'FILE_TOO_LARGE',
+    STAGING_LIMIT: 'STAGING_LIMIT',
+    ACTIVE_UPLOAD_LIMIT: 'ACTIVE_UPLOAD_LIMIT',
+    DISK_RESERVE: 'DISK_RESERVE',
+    FILE_EXISTS: 'FILE_EXISTS',
+    FILE_BUSY: 'FILE_BUSY',
+    CHECKSUM_MISMATCH: 'CHECKSUM_MISMATCH',
+    CONNECT_TIMEOUT: 'CONNECT_TIMEOUT',
+    UPLOAD_IDLE_TIMEOUT: 'UPLOAD_IDLE_TIMEOUT',
+    ABORTED: 'ABORTED',
+    COMMIT_FAILED: 'COMMIT_FAILED',
+    LINK_CONFLICT: 'LINK_CONFLICT',
+    LINK_FAILED: 'LINK_FAILED',
+    UNSUPPORTED_STORAGE: 'UNSUPPORTED_STORAGE',
+    HOOK_FAILED: 'HOOK_FAILED',
+    CLEANUP_FAILED: 'CLEANUP_FAILED'
+};
+class SwarmDeployError extends Error {
+    constructor(code, message, cause = null) {
+        super(message);
+        this.name = 'SwarmDeployError';
+        this.code = code;
+        this.cause = cause;
+    }
+}
+exports.SwarmDeployError = SwarmDeployError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAa,QAAA,MAAM,GAAG;IACpB,aAAa,EAAE,eAAe;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;IAC5B,kBAAkB,EAAE,oBAAoB;IACxC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,mBAAmB,EAAE,qBAAqB;IAC1C,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;CACxB,CAAA;AAIV,sBAA8B,SAAQ,KAAK;IAOzC,YAAY,IAAwB,EAAE,OAAe,EAAE,KAAK,GAAmB,IAAI;QACjF,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF"}

package/dist/events-node.d.ts

@@ -0,0 +1,2 @@
+import events from 'node:events';
+export = events;

package/dist/events-node.js

@@ -0,0 +1,7 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const node_events_1 = __importDefault(require("node:events"));
+module.exports = node_events_1.default;
+//# sourceMappingURL=events-node.js.map

package/dist/events-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-node.js","sourceRoot":"","sources":["../src/events-node.ts"],"names":[],"mappings":";;;;AAAA,8DAAgC;AAEhC,iBAAS,qBAAM,CAAA"}

package/dist/files.d.ts

@@ -0,0 +1,32 @@
+import type { ArtifactKind } from './types.js';
+/** Reserved top-level namespace for server-managed historical artifacts. */
+export declare const HISTORY_NAME_PREFIX = "history-";
+export interface SelectUploadTargetOptions {
+    signal?: {
+        readonly aborted: boolean;
+        addEventListener(event: 'abort', callback: () => void, options?: {
+            once?: boolean;
+        }): void;
+        removeEventListener(event: 'abort', callback: () => void): void;
+    } | null;
+}
+export interface UploadTarget {
+    kind: ArtifactKind;
+    /** The managed artifact basename. */
+    name: string;
+    path: string;
+}
+export declare function validateBasename(name: string): string;
+export declare function isReservedHistoryName(name: unknown): boolean;
+/** The unique top-level path preserving the inode a replacement superseded. */
+export declare function historyName(oldTransferId: string): string;
+/**
+ * Canonicalizes the opt-in mutable-name policy. Values are exact upload names;
+ * the reserved history namespace and duplicate entries are always rejected.
+ */
+export declare function validateReplaceNames(values?: Iterable<string>): Set<string>;
+/**
+ * Classifies one upload input. A directory becomes exactly one recursive
+ * directory artifact; children are never uploaded independently.
+ */
+export declare function selectUploadTarget(inputPath: string, { signal }?: SelectUploadTargetOptions): Promise<UploadTarget>;

package/dist/files.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HISTORY_NAME_PREFIX = void 0;
+exports.validateBasename = validateBasename;
+exports.isReservedHistoryName = isReservedHistoryName;
+exports.historyName = historyName;
+exports.validateReplaceNames = validateReplaceNames;
+exports.selectUploadTarget = selectUploadTarget;
+const b4a_1 = __importDefault(require("b4a"));
+const _fs_1 = __importDefault(require("#fs"));
+const _path_1 = __importDefault(require("#path"));
+const abort_js_1 = require("./abort.js");
+const errors_js_1 = require("./errors.js");
+const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
+const TRANSFER_ID_HEX = /^[0-9a-f]{64}$/;
+/** Reserved top-level namespace for server-managed historical artifacts. */
+exports.HISTORY_NAME_PREFIX = 'history-';
+function validateBasename(name) {
+    if (typeof name !== 'string' || !SAFE_NAME.test(name) || b4a_1.default.from(name).byteLength > 100) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Invalid filename');
+    }
+    return name;
+}
+function isReservedHistoryName(name) {
+    return typeof name === 'string' && name.startsWith(exports.HISTORY_NAME_PREFIX);
+}
+/** The unique top-level path preserving the inode a replacement superseded. */
+function historyName(oldTransferId) {
+    if (typeof oldTransferId !== 'string' || !TRANSFER_ID_HEX.test(oldTransferId)) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Invalid history transfer ID');
+    }
+    return `${exports.HISTORY_NAME_PREFIX}${oldTransferId}`;
+}
+/**
+ * Canonicalizes the opt-in mutable-name policy. Values are exact upload names;
+ * the reserved history namespace and duplicate entries are always rejected.
+ */
+function validateReplaceNames(values) {
+    if (values === undefined || values === null)
+        return new Set();
+    if (typeof values === 'string' ||
+        typeof values !== 'object' ||
+        typeof values[Symbol.iterator] !== 'function') {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Invalid replacement names');
+    }
+    const names = new Set();
+    for (const value of values) {
+        if (typeof value !== 'string') {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Invalid filename');
+        }
+        validateBasename(value);
+        if (isReservedHistoryName(value)) {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Reserved replacement name');
+        }
+        if (names.has(value)) {
+            throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.PROTOCOL_INVALID, 'Duplicate replacement name');
+        }
+        names.add(value);
+    }
+    return names;
+}
+/**
+ * Classifies one upload input. A directory becomes exactly one recursive
+ * directory artifact; children are never uploaded independently.
+ */
+async function selectUploadTarget(inputPath, { signal = null } = {}) {
+    (0, abort_js_1.throwIfAborted)(signal);
+    const stat = await _fs_1.default.promises.lstat(inputPath);
+    (0, abort_js_1.throwIfAborted)(signal);
+    if (stat.isSymbolicLink()) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Symlinks are not supported');
+    }
+    if (!stat.isFile() && !stat.isDirectory()) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Path must be a regular file or directory');
+    }
+    const name = validateBasename(_path_1.default.basename(_path_1.default.resolve(inputPath)));
+    if (isReservedHistoryName(name)) {
+        throw new errors_js_1.SwarmDeployError(errors_js_1.ERRORS.INVALID_FILENAME, 'Reserved artifact name');
+    }
+    return { kind: stat.isDirectory() ? 'directory' : 'file', name, path: inputPath };
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,8CAAqB;AACrB,8CAAoB;AACpB,kDAAwB;AACxB,yCAA2C;AAC3C,2CAAsD;AAGtD,MAAM,SAAS,GAAG,oCAAoC,CAAA;AACtD,MAAM,eAAe,GAAG,gBAAgB,CAAA;AAExC,4EAA4E;AAC/D,QAAA,mBAAmB,GAAG,UAAU,CAAA;AAiB7C,0BAAiC,IAAY;IAC3C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;QACzF,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,+BAAsC,IAAa;IACjD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,QAAA,mBAAmB,CAAC,CAAA;AACzE,CAAC;AAED,+EAA+E;AAC/E,qBAA4B,aAAqB;IAC/C,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,6BAA6B,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,GAAG,QAAA,mBAAmB,GAAG,aAAa,EAAE,CAAA;AACjD,CAAC;AAED;;;GAGG;AACH,8BAAqC,MAAyB;IAC5D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,EAAE,CAAA;IAC7D,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAO,MAAM,KAAK,QAAQ;QAC1B,OAAQ,MAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,UAAU,EACnE,CAAC;QACD,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAA;IAClF,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAA;QACzE,CAAC;QACD,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACvB,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAA;QAClF,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAA;QACnF,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACI,KAAK,6BACV,SAAiB,EACjB,EAAE,MAAM,GAAG,IAAI,EAAE,GAA8B,EAAE;IAEjD,IAAA,yBAAc,EAAC,MAAM,CAAC,CAAA;IACtB,MAAM,IAAI,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAA,yBAAc,EAAC,MAAM,CAAC,CAAA;IACtB,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAA;IACnF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,0CAA0C,CAAC,CAAA;IACjG,CAAC;IACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,eAAI,CAAC,QAAQ,CAAC,eAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;IACrE,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,4BAAgB,CAAC,kBAAM,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AACnF,CAAC"}

package/dist/fs-node.d.ts

@@ -0,0 +1,2 @@
+import fs from 'node:fs';
+export = fs;

package/dist/fs-node.js

@@ -0,0 +1,7 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const node_fs_1 = __importDefault(require("node:fs"));
+module.exports = node_fs_1.default;
+//# sourceMappingURL=fs-node.js.map

package/dist/fs-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-node.js","sourceRoot":"","sources":["../src/fs-node.ts"],"names":[],"mappings":";;;;AAAA,sDAAwB;AAExB,iBAAS,iBAAE,CAAA"}

package/dist/hooks-module.d.ts

@@ -0,0 +1,9 @@
+import { type ServerHooks } from './hooks.js';
+/**
+ * Loads a JavaScript hooks module (`.js`, `.mjs` or `.cjs`) and returns the
+ * validated, frozen hook snapshot. Only `beforeCommit`, `afterCommit` and
+ * `onFailure` are picked, by own property name; other exports are ignored.
+ * Defined named exports take precedence over the default export's callbacks. Every failure is a fixed-message configuration
+ * error that never includes module content.
+ */
+export declare function loadHooksModule(modulePath: string, cwd: string): Promise<ServerHooks>;