Skip to content

xftp: add npm library#1712

Closed
shumvgolove wants to merge 19 commits intoep/xftp-webfrom
sh/xftp-npm
Closed

xftp: add npm library#1712
shumvgolove wants to merge 19 commits intoep/xftp-webfrom
sh/xftp-npm

Conversation

@shumvgolove
Copy link
Collaborator

@shumvgolove shumvgolove commented Feb 18, 2026 •
edited
Loading

npm publishing & API improvements for xftp-web

Public API

  • sendFile — streaming encrypt→upload pipeline in constant memory (64KB + 1 chunk), supports Uint8Array and AsyncIterable<Uint8Array> sources
  • receiveFile — convenience function: URI string → download + decrypt
  • deleteFile — delete uploaded file using sender description
  • XFTPAgent class replacing newXFTPAgent/closeXFTPAgent free functions
  • XFTPAgent.closeServer — per-server disconnect
  • Clean up dead exports from public API surface

Protocol

  • Multi-server parallel uploads with chunk distribution
  • Multi-recipient support with FADD batching
  • FACK protocol command — acknowledge chunks on download
  • BLOCKED error parsing into structured BlockingInfo
  • Auth passthrough for auth-required servers

Internals

  • uploadSingleChunk extraction deduplicating upload logic across 3 call sites
  • prepareEncryption helper for worker-based encryption flows
  • Async non-blocking encryptFileForUpload with onSlice streaming callback

Packaging

  • Prepare for npm publishing (package.json, tsconfig, index.ts exports)
  • README with usage examples, streaming uploads, error handling

Tests

  • Crypto equivalence tests (async, sync, streaming)

@shumvgolove
add README with usage and development instructions
eaa81dc
@shumvgolove
distribute upload chunks across multiple servers
ca2781a
@shumvgolove
implement FACK protocol command and ackXFTPChunk
17995b3
@shumvgolove
parallel upload, FACK on download, multi-recipient, auth passthrough
122d039 
- upload chunks in parallel across server groups (matching Haskell)
- send FACK after each chunk download
- support numRecipients option for multi-recipient uploads
- pass auth option through to createXFTPChunk
- remove dead concurrency option from DownloadRawOptions
@shumvgolove
parse BLOCKED error into structured BlockingInfo
9c131e1
@shumvgolove
FADD batching, parallel delete and redirect download
bc0f5e0
@shumvgolove
update README for multi-server uploads and upload options
e977892
@shumvgolove
add MAX_RECIPIENTS_PER_REQUEST comment
9e64919
@shumvgolove
async non-blocking encryptFileForUpload with 64KB yielding
995944c
@shumvgolove
add async/sync encryption equivalence tests
52f9c00
@shumvgolove
streaming encryption API: onSlice callback for memory-efficient large…
2647a5b 
… file encryption
@shumvgolove
extract uploadSingleChunk helper, deduplicate uploadFile and uploadRe…
eb759ee 
…directDescription
@shumvgolove
streaming sendFile pipeline, receiveFile, prepareEncryption helper
8519a74
@shumvgolove
convert XFTPClientAgent interface to XFTPAgent class
4df6a2c
@shumvgolove
remove dead exports, add XFTPAgent.closeServer method
7d69d9b
@shumvgolove
README: add receiveFile progress, clarify deleteFile takes sndDescrip…
15ef669 
…tion
@shumvgolove
fix worker message race: wait for ready signal before posting messages
7fdc8ea
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@epoberezkin epoberezkin Awaiting requested review from epoberezkin epoberezkin is a code owner

@spaced4ndy spaced4ndy Awaiting requested review from spaced4ndy spaced4ndy is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@shumvgolove

Comments