@shhhum/xftp-web 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# xftp-web
+
+Browser-compatible XFTP file transfer client in TypeScript.
+
+## Prerequisites
+
+- Haskell toolchain with `cabal` (to build `xftp-server`)
+- Node.js 20+
+- Chromium system dependencies (see below)
+
+## Setup
+
+```bash
+# Build the XFTP server binary (from repo root)
+cabal build xftp-server
+
+# Install JS dependencies
+cd xftp-web
+npm install
+
+# Install Chromium for Playwright (browser tests)
+npx playwright install chromium
+```
+
+If Chromium fails to launch due to missing system libraries, install them with:
+
+```bash
+# Requires root
+npx playwright install-deps chromium
+```
+
+## Running tests
+
+```bash
+# Browser round-trip test (vitest + Playwright headless Chromium)
+npm run test
+```
+
+The browser test automatically starts an `xftp-server` instance on port 7000 via `globalSetup`, using certs from `tests/fixtures/`.
+
+## Build
+
+```bash
+npm run build
+```
+
+Output goes to `dist/`.

package/dist/agent.d.ts

@@ -0,0 +1,46 @@
+import { type FileDescription } from "./protocol/description.js";
+import { type XFTPClientAgent } from "./client.js";
+export { newXFTPAgent, closeXFTPAgent, type XFTPClientAgent, type TransportConfig } from "./client.js";
+import type { XFTPServer } from "./protocol/address.js";
+import type { FileHeader } from "./crypto/file.js";
+export interface EncryptedFileMetadata {
+    digest: Uint8Array;
+    key: Uint8Array;
+    nonce: Uint8Array;
+    chunkSizes: number[];
+}
+export interface EncryptedFileInfo extends EncryptedFileMetadata {
+    encData: Uint8Array;
+}
+export interface UploadResult {
+    rcvDescription: FileDescription;
+    sndDescription: FileDescription;
+    uri: string;
+}
+export interface DownloadResult {
+    header: FileHeader;
+    content: Uint8Array;
+}
+export declare function encodeDescriptionURI(fd: FileDescription): string;
+export declare function decodeDescriptionURI(fragment: string): FileDescription;
+export declare function encryptFileForUpload(source: Uint8Array, fileName: string): EncryptedFileInfo;
+export interface UploadOptions {
+    onProgress?: (uploaded: number, total: number) => void;
+    redirectThreshold?: number;
+    readChunk?: (offset: number, size: number) => Promise<Uint8Array>;
+}
+export declare function uploadFile(agent: XFTPClientAgent, server: XFTPServer, encrypted: EncryptedFileMetadata, options?: UploadOptions): Promise<UploadResult>;
+export interface RawDownloadedChunk {
+    chunkNo: number;
+    dhSecret: Uint8Array;
+    nonce: Uint8Array;
+    body: Uint8Array;
+    digest: Uint8Array;
+}
+export interface DownloadRawOptions {
+    onProgress?: (downloaded: number, total: number) => void;
+    concurrency?: number;
+}
+export declare function downloadFileRaw(agent: XFTPClientAgent, fd: FileDescription, onRawChunk: (chunk: RawDownloadedChunk) => Promise<void>, options?: DownloadRawOptions): Promise<FileDescription>;
+export declare function downloadFile(agent: XFTPClientAgent, fd: FileDescription, onProgress?: (downloaded: number, total: number) => void): Promise<DownloadResult>;
+export declare function deleteFile(agent: XFTPClientAgent, sndDescription: FileDescription): Promise<void>;

package/dist/agent.js

@@ -0,0 +1,273 @@
+// XFTP upload/download orchestration + URI encoding -- Simplex.FileTransfer.Client.Main
+//
+// Combines all building blocks: encryption, chunking, XFTP client commands,
+// file descriptions, and DEFLATE-compressed URI encoding.
+import pako from "pako";
+import { encryptFile, encodeFileHeader } from "./crypto/file.js";
+import { generateEd25519KeyPair, encodePubKeyEd25519, encodePrivKeyEd25519, decodePrivKeyEd25519, ed25519KeyPairFromSeed } from "./crypto/keys.js";
+import { sha512Streaming } from "./crypto/digest.js";
+import { prepareChunkSizes, prepareChunkSpecs, getChunkDigest, fileSizeLen, authTagSize } from "./protocol/chunks.js";
+import { encodeFileDescription, decodeFileDescription, validateFileDescription, base64urlEncode, base64urlDecode } from "./protocol/description.js";
+import { createXFTPChunk, uploadXFTPChunk, downloadXFTPChunk, downloadXFTPChunkRaw, deleteXFTPChunk } from "./client.js";
+export { newXFTPAgent, closeXFTPAgent } from "./client.js";
+import { processDownloadedFile, decryptReceivedChunk } from "./download.js";
+import { formatXFTPServer, parseXFTPServer } from "./protocol/address.js";
+// -- URI encoding/decoding (RFC section 4.1: DEFLATE + base64url)
+export function encodeDescriptionURI(fd) {
+    const yaml = encodeFileDescription(fd);
+    const compressed = pako.deflateRaw(new TextEncoder().encode(yaml));
+    return base64urlEncode(compressed);
+}
+export function decodeDescriptionURI(fragment) {
+    const compressed = base64urlDecode(fragment);
+    const yaml = new TextDecoder().decode(pako.inflateRaw(compressed));
+    const fd = decodeFileDescription(yaml);
+    const err = validateFileDescription(fd);
+    if (err)
+        throw new Error("decodeDescriptionURI: " + err);
+    return fd;
+}
+// -- Upload
+export function encryptFileForUpload(source, fileName) {
+    const key = new Uint8Array(32);
+    const nonce = new Uint8Array(24);
+    crypto.getRandomValues(key);
+    crypto.getRandomValues(nonce);
+    const fileHdr = encodeFileHeader({ fileName, fileExtra: null });
+    const fileSize = BigInt(fileHdr.length + source.length);
+    const payloadSize = Number(fileSize) + fileSizeLen + authTagSize;
+    const chunkSizes = prepareChunkSizes(payloadSize);
+    const encSize = BigInt(chunkSizes.reduce((a, b) => a + b, 0));
+    const encData = encryptFile(source, fileHdr, key, nonce, fileSize, encSize);
+    const digest = sha512Streaming([encData]);
+    console.log(`[AGENT-DBG] encrypt: encData.len=${encData.length} digest=${_dbgHex(digest, 64)} chunkSizes=[${chunkSizes.join(',')}]`);
+    return { encData, digest, key, nonce, chunkSizes };
+}
+const DEFAULT_REDIRECT_THRESHOLD = 400;
+export async function uploadFile(agent, server, encrypted, options) {
+    const { onProgress, redirectThreshold, readChunk: readChunkOpt } = options ?? {};
+    const readChunk = readChunkOpt
+        ? readChunkOpt
+        : ('encData' in encrypted
+            ? (off, sz) => Promise.resolve(encrypted.encData.subarray(off, off + sz))
+            : () => { throw new Error("uploadFile: readChunk required when encData is absent"); });
+    const total = encrypted.chunkSizes.reduce((a, b) => a + b, 0);
+    const specs = prepareChunkSpecs(encrypted.chunkSizes);
+    const sentChunks = [];
+    let uploaded = 0;
+    for (let i = 0; i < specs.length; i++) {
+        const spec = specs[i];
+        const chunkNo = i + 1;
+        const sndKp = generateEd25519KeyPair();
+        const rcvKp = generateEd25519KeyPair();
+        const chunkData = await readChunk(spec.chunkOffset, spec.chunkSize);
+        const chunkDigest = getChunkDigest(chunkData);
+        console.log(`[AGENT-DBG] upload chunk=${chunkNo} offset=${spec.chunkOffset} size=${spec.chunkSize} digest=${_dbgHex(chunkDigest, 32)} data[0..8]=${_dbgHex(chunkData)} data[-8..]=${_dbgHex(chunkData.slice(-8))}`);
+        const fileInfo = {
+            sndKey: encodePubKeyEd25519(sndKp.publicKey),
+            size: spec.chunkSize,
+            digest: chunkDigest
+        };
+        const rcvKeysForChunk = [encodePubKeyEd25519(rcvKp.publicKey)];
+        const { senderId, recipientIds } = await createXFTPChunk(agent, server, sndKp.privateKey, fileInfo, rcvKeysForChunk);
+        await uploadXFTPChunk(agent, server, sndKp.privateKey, senderId, chunkData);
+        sentChunks.push({
+            chunkNo, senderId, senderKey: sndKp.privateKey,
+            recipientId: recipientIds[0], recipientKey: rcvKp.privateKey,
+            chunkSize: spec.chunkSize, digest: chunkDigest, server
+        });
+        uploaded += spec.chunkSize;
+        onProgress?.(uploaded, total);
+    }
+    const rcvDescription = buildDescription("recipient", encrypted, sentChunks);
+    const sndDescription = buildDescription("sender", encrypted, sentChunks);
+    let uri = encodeDescriptionURI(rcvDescription);
+    let finalRcvDescription = rcvDescription;
+    const threshold = redirectThreshold ?? DEFAULT_REDIRECT_THRESHOLD;
+    if (uri.length > threshold && sentChunks.length > 1) {
+        finalRcvDescription = await uploadRedirectDescription(agent, server, rcvDescription);
+        uri = encodeDescriptionURI(finalRcvDescription);
+    }
+    return { rcvDescription: finalRcvDescription, sndDescription, uri };
+}
+function buildDescription(party, enc, chunks) {
+    const defChunkSize = enc.chunkSizes[0];
+    return {
+        party,
+        size: enc.chunkSizes.reduce((a, b) => a + b, 0),
+        digest: enc.digest,
+        key: enc.key,
+        nonce: enc.nonce,
+        chunkSize: defChunkSize,
+        chunks: chunks.map(c => ({
+            chunkNo: c.chunkNo,
+            chunkSize: c.chunkSize,
+            digest: c.digest,
+            replicas: [{
+                    server: formatXFTPServer(c.server),
+                    replicaId: party === "recipient" ? c.recipientId : c.senderId,
+                    replicaKey: encodePrivKeyEd25519(party === "recipient" ? c.recipientKey : c.senderKey)
+                }]
+        })),
+        redirect: null
+    };
+}
+async function uploadRedirectDescription(agent, server, innerFd) {
+    const yaml = encodeFileDescription(innerFd);
+    const yamlBytes = new TextEncoder().encode(yaml);
+    const enc = encryptFileForUpload(yamlBytes, "");
+    const specs = prepareChunkSpecs(enc.chunkSizes);
+    const sentChunks = [];
+    for (let i = 0; i < specs.length; i++) {
+        const spec = specs[i];
+        const chunkNo = i + 1;
+        const sndKp = generateEd25519KeyPair();
+        const rcvKp = generateEd25519KeyPair();
+        const chunkData = enc.encData.subarray(spec.chunkOffset, spec.chunkOffset + spec.chunkSize);
+        const chunkDigest = getChunkDigest(chunkData);
+        const fileInfo = {
+            sndKey: encodePubKeyEd25519(sndKp.publicKey),
+            size: spec.chunkSize,
+            digest: chunkDigest
+        };
+        const rcvKeysForChunk = [encodePubKeyEd25519(rcvKp.publicKey)];
+        const { senderId, recipientIds } = await createXFTPChunk(agent, server, sndKp.privateKey, fileInfo, rcvKeysForChunk);
+        await uploadXFTPChunk(agent, server, sndKp.privateKey, senderId, chunkData);
+        sentChunks.push({
+            chunkNo, senderId, senderKey: sndKp.privateKey,
+            recipientId: recipientIds[0], recipientKey: rcvKp.privateKey,
+            chunkSize: spec.chunkSize, digest: chunkDigest, server
+        });
+    }
+    return {
+        party: "recipient",
+        size: enc.chunkSizes.reduce((a, b) => a + b, 0),
+        digest: enc.digest,
+        key: enc.key,
+        nonce: enc.nonce,
+        chunkSize: enc.chunkSizes[0],
+        chunks: sentChunks.map(c => ({
+            chunkNo: c.chunkNo,
+            chunkSize: c.chunkSize,
+            digest: c.digest,
+            replicas: [{
+                    server: formatXFTPServer(c.server),
+                    replicaId: c.recipientId,
+                    replicaKey: encodePrivKeyEd25519(c.recipientKey)
+                }]
+        })),
+        redirect: { size: innerFd.size, digest: innerFd.digest }
+    };
+}
+export async function downloadFileRaw(agent, fd, onRawChunk, options) {
+    const err = validateFileDescription(fd);
+    if (err)
+        throw new Error("downloadFileRaw: " + err);
+    const { onProgress, concurrency = 1 } = options ?? {};
+    // Resolve redirect on main thread (redirect data is small)
+    if (fd.redirect !== null) {
+        console.log(`[AGENT-DBG] resolving redirect: outer size=${fd.size} chunks=${fd.chunks.length}`);
+        fd = await resolveRedirect(agent, fd);
+        console.log(`[AGENT-DBG] resolved: size=${fd.size} chunks=${fd.chunks.length} digest=${Array.from(fd.digest.slice(0, 16)).map(x => x.toString(16).padStart(2, '0')).join('')}…`);
+    }
+    const resolvedFd = fd;
+    // Group chunks by server, sequential within each server, parallel across servers
+    let downloaded = 0;
+    const byServer = new Map();
+    for (const chunk of resolvedFd.chunks) {
+        const srv = chunk.replicas[0]?.server ?? "";
+        if (!byServer.has(srv))
+            byServer.set(srv, []);
+        byServer.get(srv).push(chunk);
+    }
+    await Promise.all([...byServer.entries()].map(async ([srv, chunks]) => {
+        const server = parseXFTPServer(srv);
+        for (const chunk of chunks) {
+            const replica = chunk.replicas[0];
+            if (!replica)
+                throw new Error("downloadFileRaw: chunk has no replicas");
+            const seed = decodePrivKeyEd25519(replica.replicaKey);
+            const kp = ed25519KeyPairFromSeed(seed);
+            const raw = await downloadXFTPChunkRaw(agent, server, kp.privateKey, replica.replicaId);
+            console.log(`[AGENT-DBG] chunk=${chunk.chunkNo} body.len=${raw.body.length} expectedChunkSize=${chunk.chunkSize} digest=${_dbgHex(chunk.digest, 32)} body.byteOffset=${raw.body.byteOffset} body.buffer.byteLength=${raw.body.buffer.byteLength}`);
+            await onRawChunk({
+                chunkNo: chunk.chunkNo,
+                dhSecret: raw.dhSecret,
+                nonce: raw.nonce,
+                body: raw.body,
+                digest: chunk.digest
+            });
+            downloaded += chunk.chunkSize;
+            onProgress?.(downloaded, resolvedFd.size);
+        }
+    }));
+    return resolvedFd;
+}
+export async function downloadFile(agent, fd, onProgress) {
+    const chunks = [];
+    const resolvedFd = await downloadFileRaw(agent, fd, async (raw) => {
+        chunks[raw.chunkNo - 1] = decryptReceivedChunk(raw.dhSecret, raw.nonce, raw.body, raw.digest);
+    }, { onProgress });
+    const totalSize = chunks.reduce((s, c) => s + c.length, 0);
+    if (totalSize !== resolvedFd.size)
+        throw new Error("downloadFile: file size mismatch");
+    const digest = sha512Streaming(chunks);
+    if (!digestEqual(digest, resolvedFd.digest))
+        throw new Error("downloadFile: file digest mismatch");
+    return processDownloadedFile(resolvedFd, chunks);
+}
+async function resolveRedirect(agent, fd) {
+    const plaintextChunks = new Array(fd.chunks.length);
+    for (const chunk of fd.chunks) {
+        const replica = chunk.replicas[0];
+        if (!replica)
+            throw new Error("resolveRedirect: chunk has no replicas");
+        const server = parseXFTPServer(replica.server);
+        const seed = decodePrivKeyEd25519(replica.replicaKey);
+        const kp = ed25519KeyPairFromSeed(seed);
+        const data = await downloadXFTPChunk(agent, server, kp.privateKey, replica.replicaId, chunk.digest);
+        plaintextChunks[chunk.chunkNo - 1] = data;
+    }
+    const totalSize = plaintextChunks.reduce((s, c) => s + c.length, 0);
+    if (totalSize !== fd.size)
+        throw new Error("resolveRedirect: redirect file size mismatch");
+    const digest = sha512Streaming(plaintextChunks);
+    if (!digestEqual(digest, fd.digest))
+        throw new Error("resolveRedirect: redirect file digest mismatch");
+    const { content: yamlBytes } = processDownloadedFile(fd, plaintextChunks);
+    const yamlStr = new TextDecoder().decode(yamlBytes);
+    const innerFd = decodeFileDescription(yamlStr);
+    const innerErr = validateFileDescription(innerFd);
+    if (innerErr)
+        throw new Error("resolveRedirect: inner description invalid: " + innerErr);
+    if (innerFd.size !== fd.redirect.size)
+        throw new Error("resolveRedirect: redirect size mismatch");
+    if (!digestEqual(innerFd.digest, fd.redirect.digest))
+        throw new Error("resolveRedirect: redirect digest mismatch");
+    return innerFd;
+}
+// -- Delete
+export async function deleteFile(agent, sndDescription) {
+    for (const chunk of sndDescription.chunks) {
+        const replica = chunk.replicas[0];
+        if (!replica)
+            throw new Error("deleteFile: chunk has no replicas");
+        const server = parseXFTPServer(replica.server);
+        const seed = decodePrivKeyEd25519(replica.replicaKey);
+        const kp = ed25519KeyPairFromSeed(seed);
+        await deleteXFTPChunk(agent, server, kp.privateKey, replica.replicaId);
+    }
+}
+// -- Internal
+function _dbgHex(b, n = 8) {
+    return Array.from(b.slice(0, n)).map(x => x.toString(16).padStart(2, '0')).join('');
+}
+function digestEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a[i] ^ b[i];
+    return diff === 0;
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+import { type FileResponse, type FileInfo, type XFTPErrorType } from "./protocol/commands.js";
+import type { XFTPServer } from "./protocol/address.js";
+export declare class XFTPRetriableError extends Error {
+    readonly errorType: string;
+    constructor(errorType: string);
+}
+export declare class XFTPPermanentError extends Error {
+    readonly errorType: string;
+    constructor(errorType: string, message: string);
+}
+export declare function isRetriable(e: unknown): boolean;
+export declare function categorizeError(e: unknown): Error;
+export declare function humanReadableMessage(errorType: string | XFTPErrorType): string;
+export interface XFTPClient {
+    baseUrl: string;
+    sessionId: Uint8Array;
+    xftpVersion: number;
+    transport: Transport;
+}
+export interface TransportConfig {
+    timeoutMs: number;
+}
+interface Transport {
+    post(body: Uint8Array, headers?: Record<string, string>): Promise<Uint8Array>;
+    close(): void;
+}
+interface ServerConnection {
+    client: Promise<XFTPClient>;
+    queue: Promise<void>;
+}
+export interface XFTPClientAgent {
+    connections: Map<string, ServerConnection>;
+    /** @internal Injectable for testing — defaults to connectXFTP */
+    _connectFn: (server: XFTPServer) => Promise<XFTPClient>;
+}
+export declare function newXFTPAgent(): XFTPClientAgent;
+export declare function getXFTPServerClient(agent: XFTPClientAgent, server: XFTPServer): Promise<XFTPClient>;
+export declare function reconnectClient(agent: XFTPClientAgent, server: XFTPServer): Promise<XFTPClient>;
+export declare function removeStaleConnection(agent: XFTPClientAgent, server: XFTPServer, failedP: Promise<XFTPClient>): void;
+export declare function closeXFTPServerClient(agent: XFTPClientAgent, server: XFTPServer): void;
+export declare function closeXFTPAgent(agent: XFTPClientAgent): void;
+export declare function connectXFTP(server: XFTPServer, config?: Partial<TransportConfig>): Promise<XFTPClient>;
+export declare function sendXFTPCommand(agent: XFTPClientAgent, server: XFTPServer, privateKey: Uint8Array, entityId: Uint8Array, cmdBytes: Uint8Array, chunkData?: Uint8Array, maxRetries?: number): Promise<{
+    response: FileResponse;
+    body: Uint8Array;
+}>;
+export declare function createXFTPChunk(agent: XFTPClientAgent, server: XFTPServer, spKey: Uint8Array, file: FileInfo, rcvKeys: Uint8Array[], auth?: Uint8Array | null): Promise<{
+    senderId: Uint8Array;
+    recipientIds: Uint8Array[];
+}>;
+export declare function addXFTPRecipients(agent: XFTPClientAgent, server: XFTPServer, spKey: Uint8Array, fId: Uint8Array, rcvKeys: Uint8Array[]): Promise<Uint8Array[]>;
+export declare function uploadXFTPChunk(agent: XFTPClientAgent, server: XFTPServer, spKey: Uint8Array, fId: Uint8Array, chunkData: Uint8Array): Promise<void>;
+export interface RawChunkResponse {
+    dhSecret: Uint8Array;
+    nonce: Uint8Array;
+    body: Uint8Array;
+}
+export declare function downloadXFTPChunkRaw(agent: XFTPClientAgent, server: XFTPServer, rpKey: Uint8Array, fId: Uint8Array): Promise<RawChunkResponse>;
+export declare function downloadXFTPChunk(agent: XFTPClientAgent, server: XFTPServer, rpKey: Uint8Array, fId: Uint8Array, digest?: Uint8Array): Promise<Uint8Array>;
+export declare function deleteXFTPChunk(agent: XFTPClientAgent, server: XFTPServer, spKey: Uint8Array, sId: Uint8Array): Promise<void>;
+export declare function pingXFTP(agent: XFTPClientAgent, server: XFTPServer): Promise<void>;
+export declare function closeXFTP(c: XFTPClient): void;
+export {};