
AVAILABLEFile Upload Module
Available product — files, demo URL and secure download get mapped in EDF 0.3.
What it does
Uploads that check the bytes, not the name.
File uploads done carefully, with no dependencies. A streaming multipart parser, real file-type detection from the bytes (an .exe renamed to .png is refused), an allow-list, dangerous-name blocking (invoice.pdf.exe, .php, .svg), size and count limits, atomic requests (one bad file removes the rest), random storage ids with SHA-256, expiring signed download links, a rate limiter and an authorize hook. A drag-and-drop web component, <edf-upload>, adds previews, progress, retry, paste and keyboard support, checks size and type in the browser first, and has a simulated mode for demos. Local-disk storage with a pluggable interface for S3 or R2. 19 tests including real uploads against a real server. Plain Node.js built-ins only.
Origin: EDF native product (Platform Modules 1.0) · Roadmap window:
Live demo


Package
Placed in the private vault layout (deploy/vault/products). Downloads stay disabled until checkout is connected.
What's included
- Streaming multipart parser, tested at every possible split point, with bounded headers and parts
- Type detection from the first bytes (PNG, JPEG, GIF, WebP, PDF, ZIP/Office, MP3, MP4, text); extension and browser type never trusted
- Allow-list of types, dangerous names blocked, filenames cleaned of paths, control and right-to-left override characters
- Per-file size, file count and total body limits; connection closed on overflow
- Atomic requests: any failure removes every file of that request; cancelled uploads leave nothing behind
- Random 32-hex storage ids, SHA-256 of each file, pluggable store (local disk included; S3 or R2 by implementing four methods)
- Expiring HMAC-signed download links, constant-time check, nosniff, sandboxing CSP, attachment for non-images
- Rate limiter and an authorize hook for sessions and CSRF headers
- <edf-upload> web component: drag and drop, paste, previews, progress, retry, keyboard, live announcements, simulated mode
- Integration guide, security notes with an honest scope (not an antivirus), 19 tests; Node.js 20 or later
FORGE DNA™
TIMEPROOF SCORE — derived from real catalog fields (stack, formats, skill, AI flag), not decoration
Compatibility & relations
Derived by the mapping engine (family · layer · tags · dependency rules). Stored in the catalog as compatibility, dependencies, relations[].
Documentation
- Quick start (planned — every product gets one)
- Customisation guide
- Deployment guide — Vercel / Cloudflare / GitHub
- epic.json / EPIC-DNA.json — machine-readable DNA shipped inside the ZIP
Version history & changelog
| VERSION | STATE | NOTES |
|---|---|---|
| v1.0.0 2026-11-22 | AVAILABLE | Initial release. This package contains: Streaming multipart parser, tested at every possible split point, with bounded headers and parts; Type detection from the first bytes (PNG, JPEG, GIF, WebP, PDF, ZIP/Office, MP3, MP4, text); extension and browser type never trusted; Allow-list of types, dangerous names blocked, filenames cleaned of paths, control and right-to-left override characters; Per-file size, file count and total body limits; connection closed on overflow; Atomic requests: any failure removes every file of that request; cancelled uploads leave nothing behind; Random 32-hex storage ids, SHA-256 of each file, pluggable store (local disk included; S3 or R2 by implementing four methods). |
| → | Roadmap | Target window for the next stage. |
License
Standard (personal or commercial use in one end project or your own business) · Extended ×3 (SaaS, unlimited client projects, finished products only). Agency licence comes later.
Deployment
Activated by 1.0 (download) and 2.0 (one-click deploy). Download will be a 10-minute signed URL from the R2 vault — never a public /files/product.zip.
Related products


Form Factory

Dashboard UI Components
