Files
Netcatty/application/state/sftp/utils.ts
T

206 lines
7.2 KiB
TypeScript

import { SftpFileEntry, TransferTask } from "../../../domain/models";
export const formatFileSize = (bytes: number): string => {
if (bytes === 0) return "--";
const units = ["Bytes", "KB", "MB", "GB", "TB"];
const i = Math.floor(Math.log(bytes) / Math.log(1024));
const size = bytes / Math.pow(1024, i);
return `${size.toFixed(i === 0 ? 0 : 2)} ${units[i]}`;
};
/**
* Estimate remaining transfer time from bytes left and current speed.
* Returns null when inputs are too small to be meaningful (WinSCP-style:
* only show ETA after a stable speed sample).
*/
export function estimateTransferEtaSeconds(
remainingBytes: number,
speedBytesPerSec: number,
): number | null {
if (!Number.isFinite(remainingBytes) || remainingBytes <= 0) return null;
if (!Number.isFinite(speedBytesPerSec) || speedBytesPerSec < 1024) return null;
const seconds = Math.ceil(remainingBytes / speedBytesPerSec);
if (!Number.isFinite(seconds) || seconds <= 0) return null;
// Cap absurd ETAs (e.g. speed briefly dips).
if (seconds > 48 * 3600) return null;
return seconds;
}
export function formatTransferEta(seconds: number | null | undefined): string | null {
if (seconds == null || !Number.isFinite(seconds) || seconds <= 0) return null;
const total = Math.floor(seconds);
const h = Math.floor(total / 3600);
const m = Math.floor((total % 3600) / 60);
const s = total % 60;
if (h > 0) return `${h}h ${m}m`;
if (m > 0) return `${m}m ${s}s`;
return `${s}s`;
}
export const formatDate = (timestamp: number): string => {
if (!timestamp) return "--";
const date = new Date(timestamp);
if (isNaN(date.getTime())) return "--";
const pad = (n: number) => n.toString().padStart(2, "0");
return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
};
export const getFileExtension = (name: string): string => {
if (name === "..") return "folder";
const ext = name.split(".").pop()?.toLowerCase();
return ext || "file";
};
// Check if an entry is navigable like a directory (directories or symlinks pointing to directories)
export const isNavigableDirectory = (entry: SftpFileEntry): boolean => {
return entry.type === "directory" || (entry.type === "symlink" && entry.linkTarget === "directory");
};
const getWindowsUncRoot = (path: string): string | null => {
const normalized = path.replace(/\//g, "\\");
const match = normalized.match(/^\\\\([^\\]+)\\([^\\]+)(?:\\|$)/);
return match ? `\\\\${match[1]}\\${match[2]}` : null;
};
// Check if path is Windows-style, including network-share (UNC) paths.
export const isWindowsPath = (path: string): boolean => (
/^[A-Za-z]:/.test(path) || getWindowsUncRoot(path) !== null
);
const normalizeWindowsRoot = (path: string): string => {
const normalized = path.replace(/\//g, "\\");
if (/^[A-Za-z]:\\$/.test(normalized)) return normalized;
if (/^[A-Za-z]:$/.test(normalized)) return `${normalized}\\`;
return normalized;
};
export const isWindowsRoot = (path: string): boolean => {
if (!isWindowsPath(path)) return false;
const normalized = path.replace(/\//g, "\\");
if (/^[A-Za-z]:\\?$/.test(normalized)) return true;
const uncRoot = getWindowsUncRoot(normalized);
return uncRoot !== null && normalized.replace(/[\\]+$/, "") === uncRoot;
};
export const joinPath = (base: string, name: string): string => {
if (isWindowsPath(base)) {
const normalizedBase = normalizeWindowsRoot(base).replace(/[\\/]+$/, "");
return `${normalizedBase}\\${name}`;
}
if (base === "/") return `/${name}`;
return `${base.replace(/\/+$/, "")}/${name}`;
};
/**
* Join a discovered directory entry to a transfer target without allowing a
* server-controlled filename to escape the user-selected destination root.
* Forward slashes are the traversal's internal separators; a backslash is a
* literal POSIX filename character but becomes a separator on Windows targets.
*/
export function joinTransferTargetPath(
base: string,
relativePath: string,
): string {
const unsafe = () => {
throw new Error(`Unsafe transfer path outside the selected destination: ${relativePath}`);
};
if (!relativePath || relativePath.includes("\0")) return unsafe();
if (
relativePath.startsWith("/")
|| relativePath.startsWith("\\")
|| /^[A-Za-z]:[\\/]/.test(relativePath)
) return unsafe();
const parts = relativePath.split("/");
if (parts.some((part) => !part || part === "." || part === "..")) return unsafe();
if (isWindowsPath(base)) {
if (parts.some((part) => (
part.includes("\\")
|| part.includes(":")
|| /[. ]$/.test(part)
))) return unsafe();
return joinPath(base, parts.join("\\"));
}
return joinPath(base, parts.join("/"));
}
export const getParentPath = (path: string): string => {
if (isWindowsPath(path)) {
const normalized = normalizeWindowsRoot(path).replace(/[\\]+$/, "");
const uncRoot = getWindowsUncRoot(normalized);
if (uncRoot) {
const rest = normalized.slice(uncRoot.length).replace(/^[\\]+/, "");
const parts = rest ? rest.split(/[\\]+/).filter(Boolean) : [];
if (parts.length <= 1) return uncRoot;
parts.pop();
return `${uncRoot}\\${parts.join("\\")}`;
}
const drive = normalized.slice(0, 2);
if (/^[A-Za-z]:$/.test(normalized) || /^[A-Za-z]:\\$/.test(normalized)) {
return `${drive}\\`;
}
const rest = normalized.slice(2).replace(/^[\\]+/, "");
const parts = rest ? rest.split(/[\\]+/).filter(Boolean) : [];
if (parts.length <= 1) {
return `${drive}\\`;
}
parts.pop();
const result = `${drive}\\${parts.join("\\")}`;
return result;
}
if (path === "/") {
return "/";
}
const parts = path.split("/").filter(Boolean);
parts.pop();
const result = parts.length ? `/${parts.join("/")}` : "/";
return result;
};
export const isConcreteTransferTargetPath = (task: Pick<TransferTask, "targetPath">): boolean => {
const targetPath = task.targetPath.trim();
return targetPath.length > 0 && targetPath !== "(temp)";
};
export const getFileName = (path: string): string => {
const parts = path.split(/[\\/]/).filter(Boolean);
return parts[parts.length - 1] || "";
};
export const normalizeSftpPathForCompare = (path: string): string => {
if (isWindowsRoot(path)) return path.replace(/\//g, "\\").toLowerCase();
if (isWindowsPath(path)) {
return path.replace(/\//g, "\\").replace(/[\\]+$/, "").toLowerCase();
}
if (path === "/") return "/";
return path.replace(/\/+$/, "");
};
export const isSameSftpPath = (a: string, b: string): boolean => {
return normalizeSftpPathForCompare(a) === normalizeSftpPathForCompare(b);
};
export const shouldClearSftpFilterForPathChange = (
currentPath: string,
nextPath: string,
): boolean => {
return !isSameSftpPath(currentPath, nextPath);
};
export const getSftpFilterAfterPathChange = (
currentPath: string,
nextPath: string,
currentFilter: string,
): string => {
return shouldClearSftpFilterForPathChange(currentPath, nextPath) ? "" : currentFilter;
};
export const getSftpFilterAfterPathChangeError = (
clearFilterForPathChange: boolean,
previousFilter: string,
currentFilter: string,
): string => {
return clearFilterForPathChange ? previousFilter : currentFilter;
};