feat: RefBoard v0.4.0 — collaborative reference board with layers, groups & polished UI

Full-featured PureRef-style collaborative canvas for game dev teams: - Layer panel with visibility, lock, drag reorder, group/ungroup (Ctrl+G/Shift+G) - Arrangement tools (grid, row, column) via right-click context menu - Copy to system clipboard (Ctrl+C writes PNG for external paste in Paint etc.) - Number shortcuts (1-5) for tool selection with visible shortcut badges - Premium dark UI across all pages (Login, Collections, Boards, Editor) - Socket.IO rooms for cursors, transforms, and presence notifications - MinIO image storage with backend proxy, drag/drop and paste upload
2026-03-09 13:57:49 +05:30
commit e47777d237
43 changed files with 10276 additions and 0 deletions
@@ -0,0 +1,113 @@
+const Minio = require('minio');
+const path = require('path');
+
+const MINIO_ENDPOINT = process.env.MINIO_ENDPOINT || 'localhost';
+const MINIO_PORT = parseInt(process.env.MINIO_PORT || '9000', 10);
+const MINIO_ACCESS_KEY = process.env.MINIO_ACCESS_KEY || 'minioadmin';
+const MINIO_SECRET_KEY = process.env.MINIO_SECRET_KEY || 'minioadmin';
+const MINIO_USE_SSL = process.env.MINIO_USE_SSL === 'true';
+const MINIO_BUCKET = process.env.MINIO_BUCKET || 'refboard';
+const PUBLIC_URL = process.env.PUBLIC_URL || `http://${MINIO_ENDPOINT}:${MINIO_PORT}`;
+
+const minioClient = new Minio.Client({
+  endPoint: MINIO_ENDPOINT,
+  port: MINIO_PORT,
+  useSSL: MINIO_USE_SSL,
+  accessKey: MINIO_ACCESS_KEY,
+  secretKey: MINIO_SECRET_KEY,
+});
+
+const MIME_TO_EXT = {
+  'image/png': '.png',
+  'image/jpeg': '.jpg',
+  'image/gif': '.gif',
+  'image/webp': '.webp',
+  'image/svg+xml': '.svg',
+};
+
+/**
+ * Create the bucket if it doesn't already exist.
+ * Sets a public read policy so images are accessible via URL.
+ */
+async function initBucket() {
+  const exists = await minioClient.bucketExists(MINIO_BUCKET);
+  if (!exists) {
+    await minioClient.makeBucket(MINIO_BUCKET, '');
+    // Set public read policy
+    const policy = {
+      Version: '2012-10-17',
+      Statement: [
+        {
+          Effect: 'Allow',
+          Principal: { AWS: ['*'] },
+          Action: ['s3:GetObject'],
+          Resource: [`arn:aws:s3:::${MINIO_BUCKET}/*`],
+        },
+      ],
+    };
+    await minioClient.setBucketPolicy(MINIO_BUCKET, JSON.stringify(policy));
+  }
+  console.log(`[minio] Bucket "${MINIO_BUCKET}" ready`);
+}
+
+/**
+ * Upload an image buffer to MinIO.
+ * Returns the minio object path (used as key for future operations).
+ */
+async function uploadImage(boardId, imageId, buffer, mimeType) {
+  const ext = MIME_TO_EXT[mimeType] || '.bin';
+  const objectName = `boards/${boardId}/${imageId}${ext}`;
+
+  await minioClient.putObject(MINIO_BUCKET, objectName, buffer, buffer.length, {
+    'Content-Type': mimeType,
+  });
+
+  return objectName;
+}
+
+/**
+ * Delete a single object by its minio path.
+ */
+async function deleteImage(minioPath) {
+  await minioClient.removeObject(MINIO_BUCKET, minioPath);
+}
+
+/**
+ * Delete all objects under the boards/{boardId}/ prefix.
+ */
+async function deleteBoardImages(boardId) {
+  const prefix = `boards/${boardId}/`;
+  const objectsList = [];
+
+  return new Promise((resolve, reject) => {
+    const stream = minioClient.listObjectsV2(MINIO_BUCKET, prefix, true);
+    stream.on('data', (obj) => {
+      objectsList.push(obj.name);
+    });
+    stream.on('error', reject);
+    stream.on('end', async () => {
+      if (objectsList.length > 0) {
+        await minioClient.removeObjects(MINIO_BUCKET, objectsList);
+      }
+      resolve(objectsList.length);
+    });
+  });
+}
+
+/**
+ * Build the public URL for an image given its minio path.
+ */
+function getImageUrl(minioPath) {
+  // Return relative URL — images served via backend proxy at /api/images/*
+  return `/api/images/${minioPath}`;
+}
+
+module.exports = {
+  minioClient,
+  initBucket,
+  uploadImage,
+  deleteImage,
+  deleteBoardImages,
+  getImageUrl,
+  MINIO_BUCKET,
+};