Add built‑in offline file upload support for Convex storage

[mnsuccess]

---

convex-replicate is great for offline‑first apps, but handling file uploads to Convex storage is still manual and repetitive.

It would be very helpful to have a built‑in offline file upload API that:

• Takes a local file path (e.g. from Expo’s Asset or expo-file-system).
• Stores the file path and metadata locally in the replicate SQLite DB.
• Automatically uploads the file to Convex storage when online.
• Saves the storageId back to Convex and syncs it.
• Handles retries and errors.

Example:

const uploadId = await replicate.queueFileUpload({
  localPath: "/assets/photo.jpg",
  mimeType: "image/jpeg",
  target: { table: "posts", field: "coverImageId" }
});

const status = await replicate.getUploadStatus(uploadId);
// → { status: "pending" | "uploading" | "uploaded" | "failed", storageId, error }

This would make it much easier to build offline‑first apps with file uploads on Expo/React Native.

[musicmindmachine]

Hey, I've forked this repo and have been working on my own implementation that integrates with the @gilhrpenner/convex-files-control component recently added.

It uses either OPFS or IDB to score/cache files before uploading or downloading. Also has a separate worker thread for file reconciliation when there are large amounts of stale files, etc.

Give me a few days and I can either create a PR or create a separate convex component if you'd like.

But also @mnsuccess , I'd hate to say it, but just get Opus 4.5 to roll one out for you I had a pretty full-featured implementation in around two hours for the exact functionality you're asking for, and honestly, making something bespoke for your application that handles encryption, local file access authorization, invalidation rules, etc, is likely going to be better than making a more open-format component IMO.