uploaders: allow deleting files by CID

src/controllers/api/media.ts

@@ -20,7 +20,7 @@ const mediaController: AppController = async (c) => {
 
   try {
     const { file } = result.data;
-    const { cid } = await s3Uploader(file);
+    const { cid } = await s3Uploader.upload(file);
 
     return c.json({
       id: cid,

src/uploaders/ipfs.ts

@@ -3,13 +3,20 @@ import { z } from '@/deps.ts';
 
 import type { Uploader } from './types.ts';
 
-const ipfsAddResultSchema = z.object({
+/** Response schema for POST `/api/v0/add`. */
+const ipfsAddResponseSchema = z.object({
   Name: z.string(),
   Hash: z.string(),
   Size: z.string(),
 });
 
-const ipfsUploader: Uploader = async (file) => {
+/**
+ * IPFS uploader. It expects an IPFS node up and running.
+ * It will try to connect to `http://localhost:5001` by default,
+ * and upload the file using the REST API.
+ */
+const ipfsUploader: Uploader = {
+  async upload(file) {
     const url = new URL('/api/v0/add', Conf.ipfs.apiUrl);
 
     const formData = new FormData();
@@ -20,11 +27,24 @@ const ipfsUploader: Uploader = async (file) => {
       body: formData,
     });
 
-  const { Hash } = ipfsAddResultSchema.parse(await response.json());
+    const { Hash } = ipfsAddResponseSchema.parse(await response.json());
 
     return {
       cid: Hash,
     };
+  },
+  async delete(cid) {
+    const url = new URL('/api/v0/pin/rm', Conf.ipfs.apiUrl);
+
+    const query = new URLSearchParams();
+    query.set('arg', cid);
+
+    url.search = query.toString();
+
+    await fetch(url, {
+      method: 'POST',
+    });
+  },
 };
 
 export { ipfsUploader };

src/uploaders/s3.ts

@@ -5,7 +5,13 @@ import type { Uploader } from './types.ts';
 
 const s3 = new S3Client({ ...Conf.s3 });
 
-const s3Uploader: Uploader = async (file) => {
+/**
+ * S3-compatible uploader for AWS, Wasabi, DigitalOcean Spaces, and more.
+ * Files are named by their IPFS CID and exposed at `/ipfs/<cid>`, letting it
+ * take advantage of IPFS features while not really using IPFS.
+ */
+const s3Uploader: Uploader = {
+  async upload(file) {
     const cid = await IpfsHash.of(file.stream()) as string;
 
     await s3.putObject(`ipfs/${cid}`, file.stream(), {
@@ -18,6 +24,10 @@ const s3Uploader: Uploader = async (file) => {
     return {
       cid,
     };
+  },
+  async delete(cid) {
+    await s3.deleteObject(`ipfs/${cid}`);
+  },
 };
 
 export { s3Uploader };

src/uploaders/types.ts

@@ -1,7 +1,15 @@
+/** Modular uploader interface, to support uploading to different backends. */
+interface Uploader {
+  /** Upload the file to the backend. */
+  upload(file: File): Promise<UploadResult>;
+  /** Delete the file from the backend. */
+  delete(cid: string): Promise<void>;
+}
+
+/** Return value from the uploader after uploading a file. */
 interface UploadResult {
+  /** IPFS CID for the file. */
   cid: string;
 }
 
-type Uploader = (file: File) => Promise<UploadResult>;
-
-export type { Uploader, UploadResult };
+export type { Uploader };