dropspace 0.0.0-stage → 0.1.0

package/dist/client/storage.js

@@ -0,0 +1,463 @@
+export class DropspaceStorageError extends Error {
+    code;
+    causeError;
+    constructor(message, code, causeError) {
+        super(message);
+        this.code = code;
+        this.causeError = causeError;
+        this.name = "DropspaceStorageError";
+    }
+}
+/**
+ * Runtime feature detection for browser storage APIs.
+ * Never accesses browser globals at module import time (SSR safe).
+ */
+export function detectStorageCapabilities() {
+    const g = globalThis;
+    const nav = g.navigator;
+    return {
+        indexedDb: typeof g.indexedDB !== "undefined",
+        opfs: typeof nav?.storage?.getDirectory === "function",
+        fileSystemAccess: typeof g.showDirectoryPicker === "function" ||
+            typeof g.showSaveFilePicker === "function",
+        storageEstimate: typeof nav?.storage?.estimate === "function",
+        persistentStorageRequest: typeof nav?.storage?.persist === "function",
+    };
+}
+export async function getStorageQuotaEstimate() {
+    const nav = globalThis.navigator;
+    if (!nav?.storage?.estimate) {
+        return {
+            usageBytes: 0,
+            quotaBytes: 0,
+            usageRatio: 0,
+            persisted: null,
+            supported: false,
+        };
+    }
+    const est = await nav.storage.estimate();
+    const usageBytes = est.usage ?? 0;
+    const quotaBytes = est.quota ?? 0;
+    let persisted = null;
+    if (typeof nav.storage.persisted === "function") {
+        try {
+            persisted = await nav.storage.persisted();
+        }
+        catch {
+            persisted = null;
+        }
+    }
+    return {
+        usageBytes,
+        quotaBytes,
+        usageRatio: quotaBytes > 0 ? usageBytes / quotaBytes : 0,
+        persisted,
+        supported: true,
+    };
+}
+export async function requestPersistentStorage() {
+    const nav = globalThis.navigator;
+    if (!nav?.storage?.persist) {
+        return false;
+    }
+    try {
+        return await nav.storage.persist();
+    }
+    catch {
+        return false;
+    }
+}
+export function normalizeStorageError(err) {
+    if (err instanceof DropspaceStorageError) {
+        return err;
+    }
+    const name = err?.name ?? "";
+    const message = err?.message ?? String(err);
+    if (name === "QuotaExceededError" ||
+        message.toLowerCase().includes("quota") ||
+        message.includes("NS_ERROR_DOM_QUOTA_REACHED")) {
+        return new DropspaceStorageError(`Storage quota exceeded: ${message}`, "QUOTA_EXCEEDED", err);
+    }
+    if (name === "NotAllowedError" ||
+        name === "SecurityError" ||
+        message.toLowerCase().includes("permission")) {
+        return new DropspaceStorageError(`Storage permission denied: ${message}`, "PERMISSION_DENIED", err);
+    }
+    if (name === "NotFoundError") {
+        return new DropspaceStorageError(`Storage entry not found: ${message}`, "NOT_FOUND", err);
+    }
+    return new DropspaceStorageError(`Storage I/O error: ${message}`, "IO_ERROR", err);
+}
+/**
+ * Sanitizes an untrusted remote filename to prevent path traversal, null bytes,
+ * reserved OS device names, and hidden dot-files.
+ */
+export function sanitizeFileName(rawName) {
+    if (typeof rawName !== "string" || rawName.trim().length === 0) {
+        throw new DropspaceStorageError("Filename must be a non-empty string", "PATH_TRAVERSAL_BLOCKED");
+    }
+    if (rawName.includes("..") ||
+        rawName.includes("/") ||
+        rawName.includes("\\") ||
+        rawName.includes("\0")) {
+        throw new DropspaceStorageError(`Unsafe remote filename rejected (path traversal or separator detected): '${rawName}'`, "PATH_TRAVERSAL_BLOCKED");
+    }
+    const cleaned = rawName.replace(/[\x00-\x1f\x7f<>:"|?*]/g, "_").trim();
+    if (!cleaned || cleaned === "." || cleaned === "..") {
+        throw new DropspaceStorageError(`Invalid filename after sanitization: '${rawName}'`, "PATH_TRAVERSAL_BLOCKED");
+    }
+    return cleaned.slice(0, 200);
+}
+/**
+ * In-memory staging & file storage adapter with configurable quota limit (for deterministic quota testing and SSR).
+ */
+export class InMemoryBinaryStagingAdapter {
+    maxQuotaBytes;
+    kind = "memory";
+    stagingChunks = new Map();
+    completedFiles = new Map();
+    currentBytes = 0;
+    constructor(maxQuotaBytes = Number.POSITIVE_INFINITY) {
+        this.maxQuotaBytes = maxQuotaBytes;
+    }
+    setMaxQuotaBytes(bytes) {
+        this.maxQuotaBytes = bytes;
+    }
+    getUsedBytes() {
+        return this.currentBytes;
+    }
+    async writeChunk(transferId, chunkIndex, data) {
+        let transferMap = this.stagingChunks.get(transferId);
+        if (!transferMap) {
+            transferMap = new Map();
+            this.stagingChunks.set(transferId, transferMap);
+        }
+        const existing = transferMap.get(chunkIndex);
+        const delta = data.byteLength - (existing?.byteLength ?? 0);
+        if (this.currentBytes + delta > this.maxQuotaBytes) {
+            throw new DropspaceStorageError(`Storage quota exceeded (${this.currentBytes + delta} > ${this.maxQuotaBytes} bytes)`, "QUOTA_EXCEEDED");
+        }
+        const copy = new Uint8Array(data.byteLength);
+        copy.set(data);
+        transferMap.set(chunkIndex, copy);
+        this.currentBytes += delta;
+    }
+    async readChunk(transferId, chunkIndex) {
+        const chunk = this.stagingChunks.get(transferId)?.get(chunkIndex);
+        if (!chunk)
+            return null;
+        return new Uint8Array(chunk);
+    }
+    async listWrittenChunks(transferId) {
+        const map = this.stagingChunks.get(transferId);
+        if (!map)
+            return [];
+        return Array.from(map.keys()).sort((a, b) => a - b);
+    }
+    async finalizeTransfer(transferId, rawFileName, totalChunks, options) {
+        const safeName = sanitizeFileName(rawFileName);
+        if (!options?.allowOverwrite && this.completedFiles.has(safeName)) {
+            throw new DropspaceStorageError(`File '${safeName}' already exists and allowOverwrite is false`, "OVERWRITE_BLOCKED");
+        }
+        const map = this.stagingChunks.get(transferId);
+        if (!map) {
+            throw new DropspaceStorageError(`Staging data not found for transfer '${transferId}'`, "NOT_FOUND");
+        }
+        let totalBytes = 0;
+        const ordered = [];
+        for (let i = 0; i < totalChunks; i++) {
+            const part = map.get(i);
+            if (!part) {
+                throw new DropspaceStorageError(`Cannot finalize transfer '${transferId}': missing chunk ${i} of ${totalChunks}`, "IO_ERROR");
+            }
+            ordered.push(part);
+            totalBytes += part.byteLength;
+        }
+        const assembled = new Uint8Array(totalBytes);
+        let offset = 0;
+        for (let i = 0; i < ordered.length; i++) {
+            assembled.set(ordered[i], offset);
+            offset += ordered[i].byteLength;
+        }
+        this.completedFiles.set(safeName, assembled);
+        await this.deleteTransferStaging(transferId);
+        return { finalKey: safeName, byteLength: totalBytes };
+    }
+    async readCompletedFile(finalKey) {
+        const safeName = sanitizeFileName(finalKey);
+        const data = this.completedFiles.get(safeName);
+        return data ? new Uint8Array(data) : null;
+    }
+    async deleteTransferStaging(transferId) {
+        const map = this.stagingChunks.get(transferId);
+        if (map) {
+            for (const chunk of map.values()) {
+                this.currentBytes = Math.max(0, this.currentBytes - chunk.byteLength);
+            }
+            this.stagingChunks.delete(transferId);
+        }
+    }
+    async exportBackup() {
+        const out = {};
+        for (const [key, bytes] of this.completedFiles.entries()) {
+            out[key] = Buffer.from(bytes).toString("base64");
+        }
+        return out;
+    }
+    async importBackup(snapshot) {
+        for (const [key, b64] of Object.entries(snapshot)) {
+            const safe = sanitizeFileName(key);
+            this.completedFiles.set(safe, new Uint8Array(Buffer.from(b64, "base64")));
+        }
+    }
+}
+/**
+ * Origin Private File System (OPFS) adapter for large binary staging and completed files.
+ * Keeps incomplete transfers in `.staging/<transferId>/chunk_<idx>.part` and promotes to `completed/<safeFileName>`.
+ */
+export class OpfsBinaryStagingAdapter {
+    kind = "opfs";
+    async getRootDir() {
+        const nav = globalThis.navigator;
+        if (!nav?.storage?.getDirectory) {
+            throw new DropspaceStorageError("OPFS (navigator.storage.getDirectory) is not supported in this browser", "NOT_SUPPORTED");
+        }
+        try {
+            return await nav.storage.getDirectory();
+        }
+        catch (err) {
+            throw normalizeStorageError(err);
+        }
+    }
+    async getTransferStagingDir(transferId, create) {
+        const root = await this.getRootDir();
+        const stagingRoot = await root.getDirectoryHandle("dropspace_staging", { create });
+        return await stagingRoot.getDirectoryHandle(sanitizeFileName(transferId), { create });
+    }
+    async getCompletedDir(create) {
+        const root = await this.getRootDir();
+        return await root.getDirectoryHandle("dropspace_completed", { create });
+    }
+    async writeChunk(transferId, chunkIndex, data) {
+        try {
+            const dir = await this.getTransferStagingDir(transferId, true);
+            const fileHandle = await dir.getFileHandle(`chunk_${chunkIndex}.part`, { create: true });
+            const writable = await fileHandle.createWritable();
+            await writable.write(data);
+            await writable.close();
+        }
+        catch (err) {
+            throw normalizeStorageError(err);
+        }
+    }
+    async readChunk(transferId, chunkIndex) {
+        try {
+            const dir = await this.getTransferStagingDir(transferId, false);
+            const fileHandle = await dir.getFileHandle(`chunk_${chunkIndex}.part`, { create: false });
+            const file = await fileHandle.getFile();
+            return new Uint8Array(await file.arrayBuffer());
+        }
+        catch {
+            return null;
+        }
+    }
+    async listWrittenChunks(transferId) {
+        try {
+            const dir = await this.getTransferStagingDir(transferId, false);
+            const indices = [];
+            const entriesIter = dir.entries();
+            for await (const [name] of entriesIter) {
+                const match = /^chunk_(\d+)\.part$/.exec(name);
+                if (match && match[1]) {
+                    indices.push(Number(match[1]));
+                }
+            }
+            return indices.sort((a, b) => a - b);
+        }
+        catch {
+            return [];
+        }
+    }
+    async finalizeTransfer(transferId, rawFileName, totalChunks, options) {
+        const safeName = sanitizeFileName(rawFileName);
+        try {
+            const completedDir = await this.getCompletedDir(true);
+            if (!options?.allowOverwrite) {
+                let exists = false;
+                try {
+                    await completedDir.getFileHandle(safeName, { create: false });
+                    exists = true;
+                }
+                catch {
+                    exists = false;
+                }
+                if (exists) {
+                    throw new DropspaceStorageError(`File '${safeName}' already exists in OPFS and allowOverwrite is false`, "OVERWRITE_BLOCKED");
+                }
+            }
+            const outHandle = await completedDir.getFileHandle(safeName, { create: true });
+            const writable = await outHandle.createWritable();
+            let totalBytes = 0;
+            for (let i = 0; i < totalChunks; i++) {
+                const chunk = await this.readChunk(transferId, i);
+                if (!chunk) {
+                    await writable.abort();
+                    throw new DropspaceStorageError(`Missing chunk ${i} during OPFS finalize for '${transferId}'`, "IO_ERROR");
+                }
+                await writable.write(chunk);
+                totalBytes += chunk.byteLength;
+            }
+            await writable.close();
+            await this.deleteTransferStaging(transferId);
+            return { finalKey: safeName, byteLength: totalBytes };
+        }
+        catch (err) {
+            throw normalizeStorageError(err);
+        }
+    }
+    async readCompletedFile(finalKey) {
+        const safeName = sanitizeFileName(finalKey);
+        try {
+            const completedDir = await this.getCompletedDir(false);
+            const fh = await completedDir.getFileHandle(safeName, { create: false });
+            const file = await fh.getFile();
+            return new Uint8Array(await file.arrayBuffer());
+        }
+        catch {
+            return null;
+        }
+    }
+    async deleteTransferStaging(transferId) {
+        try {
+            const root = await this.getRootDir();
+            const stagingRoot = await root.getDirectoryHandle("dropspace_staging", { create: false });
+            await stagingRoot.removeEntry(sanitizeFileName(transferId), { recursive: true });
+        }
+        catch {
+            // Already cleaned up
+        }
+    }
+    async exportBackup() {
+        const out = {};
+        try {
+            const completedDir = await this.getCompletedDir(false);
+            const entriesIter = completedDir.entries();
+            for await (const [name, handle] of entriesIter) {
+                const file = await handle.getFile();
+                const bytes = new Uint8Array(await file.arrayBuffer());
+                let bin = "";
+                for (let i = 0; i < bytes.byteLength; i++) {
+                    bin += String.fromCharCode(bytes[i]);
+                }
+                out[name] = globalThis.btoa(bin);
+            }
+        }
+        catch {
+            // Ignore if directory does not exist yet
+        }
+        return out;
+    }
+    async importBackup(snapshot) {
+        const completedDir = await this.getCompletedDir(true);
+        for (const [name, b64] of Object.entries(snapshot)) {
+            const safeName = sanitizeFileName(name);
+            const bin = globalThis.atob(b64);
+            const bytes = new Uint8Array(bin.length);
+            for (let i = 0; i < bin.length; i++) {
+                bytes[i] = bin.charCodeAt(i);
+            }
+            const fh = await completedDir.getFileHandle(safeName, { create: true });
+            const writable = await fh.createWritable();
+            await writable.write(bytes);
+            await writable.close();
+        }
+    }
+}
+/**
+ * Real user directory adapter using File System Access API (`FileSystemDirectoryHandle`),
+ * strictly distinct from Origin-Private Storage (OPFS).
+ * Handles permission re-prompting on stored handles and download fallback when unsupported.
+ */
+export class UserDirectoryStorageAdapter {
+    directoryHandle;
+    constructor(directoryHandle = null) {
+        this.directoryHandle = directoryHandle;
+    }
+    setDirectoryHandle(handle) {
+        this.directoryHandle = handle;
+    }
+    getDirectoryHandle() {
+        return this.directoryHandle;
+    }
+    async verifyOrRequestPermission(mode = "readwrite") {
+        if (!this.directoryHandle) {
+            throw new DropspaceStorageError("No user directory handle selected", "PERMISSION_DENIED");
+        }
+        const h = this.directoryHandle;
+        try {
+            if (typeof h.queryPermission === "function") {
+                const state = await h.queryPermission({ mode });
+                if (state === "granted")
+                    return true;
+            }
+            if (typeof h.requestPermission === "function") {
+                const requested = await h.requestPermission({ mode });
+                if (requested === "granted")
+                    return true;
+            }
+            return false;
+        }
+        catch (err) {
+            throw normalizeStorageError(err);
+        }
+    }
+    async saveFileToUserDirectory(rawFileName, content, options) {
+        const safeName = sanitizeFileName(rawFileName);
+        const hasPerm = await this.verifyOrRequestPermission("readwrite");
+        if (!hasPerm || !this.directoryHandle) {
+            throw new DropspaceStorageError("User denied write permission to selected directory", "PERMISSION_DENIED");
+        }
+        if (!options?.allowOverwrite) {
+            let exists = false;
+            try {
+                await this.directoryHandle.getFileHandle(safeName, { create: false });
+                exists = true;
+            }
+            catch {
+                exists = false;
+            }
+            if (exists) {
+                throw new DropspaceStorageError(`File '${safeName}' already exists in user directory`, "OVERWRITE_BLOCKED");
+            }
+        }
+        try {
+            const fh = await this.directoryHandle.getFileHandle(safeName, { create: true });
+            const writable = await fh.createWritable();
+            await writable.write(content);
+            await writable.close();
+        }
+        catch (err) {
+            throw normalizeStorageError(err);
+        }
+    }
+    /**
+     * Browser download fallback when File System Access API is unavailable.
+     */
+    triggerBrowserDownloadFallback(rawFileName, content, mimeType = "application/octet-stream") {
+        const safeName = sanitizeFileName(rawFileName);
+        if (typeof document === "undefined" || typeof URL === "undefined") {
+            throw new DropspaceStorageError("Browser download fallback requires DOM environment", "NOT_SUPPORTED");
+        }
+        const blob = new Blob([content], { type: mimeType });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement("a");
+        a.href = url;
+        a.download = safeName;
+        a.style.display = "none";
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        URL.revokeObjectURL(url);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/client/storage.js.map

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

package/dist/files/index.d.ts

@@ -0,0 +1,136 @@
+import { TypedEventEmitter, type BinaryStagingStorageAdapter, type DropspaceClient } from "../client/index.js";
+import { StreamingSha256, sha256HexSync } from "./sha256.js";
+export { StreamingSha256, sha256HexSync };
+export type TransferState = "offered" | "accepted" | "transferring" | "paused" | "verifying" | "completed" | "cancelled" | "failed";
+export type TransferErrorCode = "FILE_TOO_LARGE" | "POLICY_REJECTED" | "SOURCE_FILE_MODIFIED" | "HASH_MISMATCH" | "QUOTA_EXCEEDED" | "PERMISSION_DENIED" | "PATH_TRAVERSAL_BLOCKED" | "OVERWRITE_BLOCKED" | "CANCELLED" | "PEER_DISCONNECTED" | "IO_ERROR";
+export declare class FileTransferError extends Error {
+    readonly code: TransferErrorCode;
+    readonly transferId?: string | undefined;
+    constructor(message: string, code: TransferErrorCode, transferId?: string | undefined);
+}
+/**
+ * Abstract streaming/sliceable file source that avoids loading the whole file into memory.
+ */
+export interface SliceableFileSource {
+    readonly name: string;
+    readonly size: number;
+    readonly mimeType: string;
+    readonly lastModified: number;
+    readSlice(start: number, end: number): Promise<Uint8Array>;
+}
+export declare function createBlobFileSource(blob: Blob & {
+    name?: string;
+    lastModified?: number;
+}, overrideName?: string): SliceableFileSource;
+export interface FileTransferManifest {
+    transferId: string;
+    peerDeviceId: string;
+    direction: "send" | "receive";
+    fileName: string;
+    mimeType: string;
+    totalBytes: number;
+    chunkSize: number;
+    totalChunks: number;
+    fileSha256: string;
+    lastModified: number;
+    state: TransferState;
+    completedChunks: number[];
+    transferredBytes: number;
+    finalStorageKey?: string;
+    error?: {
+        code: TransferErrorCode;
+        message: string;
+    };
+    startedAt: number;
+    updatedAt: number;
+}
+export interface TransferProgressEvent {
+    transferId: string;
+    peerDeviceId: string;
+    direction: "send" | "receive";
+    fileName: string;
+    state: TransferState;
+    transferredBytes: number;
+    totalBytes: number;
+    completedChunks: number;
+    totalChunks: number;
+    progressRatio: number;
+    bytesPerSecond: number;
+}
+export interface FileAcceptancePolicy {
+    maxFileSizeBytes?: number;
+    allowedMimeTypes?: string[];
+    allowOverwrite?: boolean;
+    autoAccept?: boolean;
+    onIncomingOffer?: (manifest: FileTransferManifest) => Promise<boolean> | boolean;
+}
+export interface FileTransferManagerOptions {
+    client: DropspaceClient;
+    storage?: BinaryStagingStorageAdapter;
+    chunkSize?: number;
+    policy?: FileAcceptancePolicy;
+}
+export type FileTransferManagerEvents = {
+    incomingOffer: FileTransferManifest;
+    progress: TransferProgressEvent;
+    stateChange: FileTransferManifest;
+    completed: {
+        manifest: FileTransferManifest;
+        finalStorageKey?: string;
+    };
+    error: {
+        transferId: string;
+        error: FileTransferError;
+    };
+};
+/**
+ * Bounded-memory, chunk-tracked, pausable and resumable file transfer engine over Dropspace DataChannels.
+ */
+export declare class FileTransferManager {
+    private readonly options;
+    readonly events: TypedEventEmitter<FileTransferManagerEvents>;
+    readonly storage: BinaryStagingStorageAdapter;
+    private readonly chunkSize;
+    private readonly policy;
+    private readonly outgoing;
+    private readonly incoming;
+    private readonly unsubscribeClient;
+    constructor(options: FileTransferManagerOptions);
+    /**
+     * Computes the SHA-256 hash of a `SliceableFileSource` in bounded memory (one chunk at a time).
+     */
+    computeSourceSha256(source: SliceableFileSource, chunkSize?: number): Promise<string>;
+    /**
+     * Verifies that the underlying file source has not mutated since the transfer started.
+     */
+    private verifySourceUnchanged;
+    sendFile(peerDeviceId: string, sourceInput: SliceableFileSource | (Blob & {
+        name?: string;
+        lastModified?: number;
+    }), options?: {
+        transferId?: string;
+        chunkSize?: number;
+        waitForCompletion?: boolean;
+        signal?: AbortSignal;
+    }): Promise<FileTransferManifest>;
+    pauseTransfer(transferId: string): Promise<void>;
+    /**
+     * Resumes a paused or interrupted transfer from the exact missing chunks without re-sending
+     * chunks that have already been persisted on the receiver.
+     * Before resuming on the sender side, verifies that the source file has not been modified!
+     */
+    resumeTransfer(transferId: string): Promise<void>;
+    cancelTransfer(transferId: string, reason?: string): Promise<void>;
+    getTransfer(transferId: string): FileTransferManifest | undefined;
+    listTransfers(): FileTransferManifest[];
+    private sendControlFrame;
+    private handleIncomingFrame;
+    private handleIncomingOffer;
+    private pumpOutgoingChunks;
+    private handleIncomingChunk;
+    private verifyAndFinalizeIncoming;
+    private failOutgoingTransfer;
+    private failIncomingTransfer;
+    close(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/files/index.d.ts.map

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