@chirag127/oz-file

Framework-agnostic browser file helpers. Zero dependencies — works in Astro, Next, Vue, Svelte, or plain HTML.

API

Export	What it does
readAsArrayBuffer(file)	Promise-wrapped FileReader → ArrayBuffer
readAsDataURL(file)	Promise-wrapped FileReader → base64 data URL
readAsText(file, encoding?)	Promise-wrapped FileReader → text
downloadBlob(blob, filename)	Trigger a browser download of a Blob
onDropZone(el, cb, opts?)	Wire drag-and-drop; returns teardown fn
printToPdf(node?)	window.print() with a scoped print stylesheet
formatBytes(bytes, decimals?)	1536 → "1.5 KB"

Install

npm i @chirag127/oz-file

Usage

import {
	readAsText,
	downloadBlob,
	onDropZone,
	printToPdf,
	formatBytes,
} from '@chirag127/oz-file'

// Read a dropped file
const teardown = onDropZone(document.getElementById('drop')!, async (files) => {
	const text = await readAsText(files[0])
	console.log(`${files[0].name} — ${formatBytes(files[0].size)}`)
})

// Download generated output
downloadBlob(new Blob(['hello'], { type: 'text/plain' }), 'note.txt')

// Print just the invoice node to PDF
printToPdf(document.getElementById('invoice')!)

teardown() // remove drop listeners

License

MIT