@jerrycoderhi/cdnfilev1-sdk

Official high-performance Node.js wrapper for the CdnFile Edge Network. Easily integrate file uploads and remote ingestion into your applications with built-in malware scanning and global edge routing.

🚀 Features

• Global Anycast: Fast uploads via Cloudflare Edge.
• Malware Scanning: Automated scanning via MalwareBazaar.
• Remote Ingestion: Fetch and host files directly from URLs.
• Node.js Optimized: Works on Vercel, Render, and local servers.

📦 Installation

npm install @jerrycoderhi/cdnfilev1

🛠 Usage

1. Initialize the Client

const CdnFile = require('@jerrycoder/cdnfile');
const api = new CdnFile(); // Connects to cdn-file.shaaxaal.workers.dev by default

2. Upload a Local File (Node/Express/Vercel)

Ideal for processing files using fs.readFileSync() or incoming streams.

const fs = require('fs');

async function uploadImage() {
    const buffer = fs.readFileSync('./my-photo.jpg');
    const res = await api.upload(buffer, 'my-photo.jpg');
    
    console.log(res.url); // Output: https://cdnfile.pages.dev/8x2b1c.jpg
}

3. Remote URL Ingestion (Fastest)

The most efficient way to host a file from another server. No data passes through your local server.

const res = await api.uploadUrl('https://example.com/image.png', 'custom_name');
console.log(res.url);

4. Vercel Serverless Function Example

Use this inside your api/upload.js on Vercel:

const CdnFile = require('@jerrycoder/cdnfile');
const api = new CdnFile();

export default async function handler(req, res) {
    if (req.method === 'POST') {
        const { imageUrl } = req.body;
        const data = await api.uploadUrl(imageUrl);
        return res.status(200).json(data);
    }
}

⚙️ API Reference

| Method | Parameters | Description | | :--- | :--- | :--- | | upload(buffer, name) | Buffer, String | Uploads a raw buffer to the CDN. | | uploadUrl(url, name) | String, String | Ingests a file from a remote URL. | | fetch(path, params) | String, Object | Raw GET request to any CDN endpoint. |

🛡 Security

This SDK automatically utilizes the CdnFile Edge Firewall. Every upload is checked against cryptographic signatures of known malware. Malicious uploads will be rejected with a 403 Forbidden status.

📜 Credits

• Developer: JerryCoder
• API Engine: JerryCoder API
• Infrastructure: CdnFile Edge Network

⚖️ License

Released under the GPL-2.0-only License.

© 2026 JerryCoder Ecosystem. All rights reserved.