cyberia 3.2.5 → 3.2.9

package/src/api/file/file.service.js

@@ -27,7 +27,7 @@ const logger = loggerFactory(import.meta);
  * @namespace FileServiceServer.FileServiceDto
  * @memberof FileServiceServer
  */
-const FileServiceDto = {
+class FileServiceDto {
   /**
    * Returns file metadata only (no buffer data).
    * Used for list responses and API integration.
@@ -36,7 +36,7 @@ const FileServiceDto = {
    * @param {Object} file - File document from database.
    * @returns {Object|null} File metadata object, or null if file is falsy.
    */
-  toMetadata: (file) => {
+  static toMetadata = (file) => {
     if (!file) return null;
     return {
       _id: file._id,
@@ -48,7 +48,7 @@ const FileServiceDto = {
       createdAt: file.createdAt,
       updatedAt: file.updatedAt,
     };
-  },
+  };
 
   /**
    * Transforms array of files to metadata only.
@@ -57,10 +57,10 @@ const FileServiceDto = {
    * @param {Array} files - Array of file documents.
    * @returns {Array} Array of file metadata objects.
    */
-  toMetadataArray: (files) => {
+  static toMetadataArray = (files) => {
     if (!Array.isArray(files)) return [];
     return files.map((file) => FileServiceDto.toMetadata(file));
-  },
+  };
 
   /**
    * Ensures UTF-8 encoding for filenames.
@@ -70,14 +70,14 @@ const FileServiceDto = {
    * @param {string} filename - Raw filename from upload.
    * @returns {string} UTF-8 encoded filename.
    */
-  normalizeFilename: (filename) => {
+  static normalizeFilename = (filename) => {
     if (!filename) return '';
     // Ensure string and normalize to UTF-8
     let normalized = String(filename);
     // Replace any incorrectly encoded sequences
     normalized = Buffer.from(normalized, 'utf8').toString('utf8');
     return normalized;
-  },
+  };
 
   /**
    * Get select fields for metadata-only queries.
@@ -86,17 +86,17 @@ const FileServiceDto = {
    * @memberof FileServiceServer.FileServiceDto
    * @returns {string} Space-separated list of field names for metadata selection.
    */
-  metadataSelect: () => {
+  static metadataSelect = () => {
     return '_id name mimetype size encoding md5 cid createdAt updatedAt';
-  },
-};
+  };
+}
 
 /**
  * File Factory for file extraction, upload, and creation utilities.
  * @namespace FileServiceServer.FileFactory
  * @memberof FileServiceServer
  */
-const FileFactory = {
+class FileFactory {
   /**
    * Extract files from request.
    * Handles both standard 'file' field and custom fields.
@@ -105,7 +105,7 @@ const FileFactory = {
    * @param {Object} req - Express request object with files.
    * @returns {Array} Array of extracted file objects.
    */
-  filesExtract: (req) => {
+  static filesExtract = (req) => {
     const files = [];
     if (!req.files || Object.keys(req.files).length === 0) {
       return files;
@@ -139,7 +139,7 @@ const FileFactory = {
     }
 
     return files;
-  },
+  };
 
   /**
    * Upload files to database with UTF-8 encoding.
@@ -150,7 +150,7 @@ const FileFactory = {
    * @param {import('mongoose').Model} File - Mongoose File model.
    * @returns {Promise<Array>} Array of uploaded file metadata objects.
    */
-  upload: async function (req, File) {
+  static async upload(req, File) {
     const results = FileFactory.filesExtract(req);
     let index = -1;
 
@@ -172,7 +172,7 @@ const FileFactory = {
     }
 
     return results;
-  },
+  }
 
   /**
    * Convert string to hexadecimal.
@@ -181,9 +181,9 @@ const FileFactory = {
    * @param {string} [raw=''] - Raw string to convert.
    * @returns {string} Hexadecimal representation of the string.
    */
-  hex: (raw = '') => {
+  static hex = (raw = '') => {
     return Buffer.from(raw, 'utf8').toString('hex');
-  },
+  };
 
   /**
    * Get MIME type from file path based on extension.
@@ -192,7 +192,7 @@ const FileFactory = {
    * @param {string} path - File path or filename with extension.
    * @returns {string} MIME type string.
    */
-  getMymeTypeFromPath: (path) => {
+  static getMymeTypeFromPath = (path) => {
     const ext = String(path || '')
       .toLowerCase()
       .split('.')
@@ -210,7 +210,7 @@ const FileFactory = {
       json: 'application/json',
     };
     return mimeTypes[ext] || 'application/octet-stream';
-  },
+  };
 
   /**
    * Create file object with proper encoding.
@@ -220,7 +220,7 @@ const FileFactory = {
    * @param {string} [name=''] - File name.
    * @returns {Object} File object with name, data, size, encoding, mimetype, and md5.
    */
-  create: (data = Buffer.from([]), name = '') => {
+  static create = (data = Buffer.from([]), name = '') => {
     const normalizedName = FileServiceDto.normalizeFilename(name);
 
     return {
@@ -234,8 +234,8 @@ const FileFactory = {
       md5: crypto.createHash('md5').update(data).digest('hex'),
       cid: undefined,
     };
-  },
-};
+  };
+}
 
 /**
  * File cleanup utilities for preventing orphaned files.
@@ -244,7 +244,7 @@ const FileFactory = {
  * @namespace FileServiceServer.FileCleanup
  * @memberof FileServiceServer
  */
-const FileCleanup = {
+class FileCleanup {
   /**
    * Clean up old file references when document fields are updated.
    * Deletes old files that are being replaced by new file IDs.
@@ -258,7 +258,7 @@ const FileCleanup = {
    * @param {import('mongoose').Model} options.File - Mongoose File model.
    * @returns {Promise<Array>} Array of deleted file IDs.
    */
-  cleanupReplacedFiles: async ({ oldDoc, newData, fileFields, File }) => {
+  static cleanupReplacedFiles = async ({ oldDoc, newData, fileFields, File }) => {
     const deletedFileIds = [];
 
     for (const field of fileFields) {
@@ -281,7 +281,7 @@ const FileCleanup = {
     }
 
     return deletedFileIds;
-  },
+  };
 
   /**
    * Delete all files referenced in a document.
@@ -297,7 +297,7 @@ const FileCleanup = {
    * @param {import('mongoose').Model} options.File - Mongoose File model.
    * @returns {Promise<Array>} Array of deleted file IDs.
    */
-  deleteDocumentFiles: async ({ doc, fileFields, File }) => {
+  static deleteDocumentFiles = async ({ doc, fileFields, File }) => {
     const deletedFileIds = [];
 
     for (const field of fileFields) {
@@ -318,15 +318,15 @@ const FileCleanup = {
     }
 
     return deletedFileIds;
-  },
-};
+  };
+}
 
 /**
  * File Service for handling REST API file operations.
  * @namespace FileServiceServer.FileService
  * @memberof FileServiceServer
  */
-const FileService = {
+class FileService {
   /**
    * POST - Upload files.
    * Returns metadata-only response (no buffer data).
@@ -338,7 +338,7 @@ const FileService = {
    * @param {Object} options - Request options containing host and path.
    * @returns {Promise<Array>} Array of uploaded file metadata objects.
    */
-  post: async (req, res, options) => {
+  static post = async (req, res, options) => {
     // Check that user is authenticated and not a guest
     if (!req.auth || !req.auth.user || req.auth.user.role === 'guest') {
       throw new Error('Authentication required. Guest users cannot upload files.');
@@ -349,7 +349,7 @@ const FileService = {
 
     const uploadedFiles = await FileFactory.upload(req, File);
     return FileServiceDto.toMetadataArray(uploadedFiles);
-  },
+  };
 
   /**
    * GET - Retrieve files.
@@ -365,7 +365,7 @@ const FileService = {
    * @returns {Promise<Array|Buffer>} Array of file metadata objects or Buffer for blob endpoint.
    * @throws {Error} If file not found or user not authorized.
    */
-  get: async (req, res, options) => {
+  static get = async (req, res, options) => {
     /** @type {import('./file.model.js').FileModel} */
     const File = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.File;
     /** @type {import('../document/document.model.js').DocumentModel} */
@@ -467,7 +467,7 @@ const FileService = {
         return FileServiceDto.toMetadataArray(files);
       }
     }
-  },
+  };
 
   /**
    * DELETE - Remove files.
@@ -480,7 +480,7 @@ const FileService = {
    * @returns {Promise<Object>} Deleted file metadata object.
    * @throws {Error} If file not found.
    */
-  delete: async (req, res, options) => {
+  static delete = async (req, res, options) => {
     /** @type {import('./file.model.js').FileModel} */
     const File = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.File;
 
@@ -491,7 +491,7 @@ const FileService = {
     }
 
     return FileServiceDto.toMetadata(result);
-  },
-};
+  };
+}
 
 export { FileService, FileFactory, FileServiceDto, FileCleanup };

package/src/api/instance/instance.controller.js

@@ -3,8 +3,8 @@ import { InstanceService } from './instance.service.js';
 
 const logger = loggerFactory(import.meta);
 
-const InstanceController = {
-  post: async (req, res, options) => {
+class InstanceController {
+  static post = async (req, res, options) => {
     try {
       const result = await InstanceService.post(req, res, options);
       return res.status(200).json({
@@ -18,8 +18,8 @@ const InstanceController = {
         message: error.message,
       });
     }
-  },
-  get: async (req, res, options) => {
+  };
+  static get = async (req, res, options) => {
     try {
       const result = await InstanceService.get(req, res, options);
       return res.status(200).json({
@@ -33,8 +33,8 @@ const InstanceController = {
         message: error.message,
       });
     }
-  },
-  put: async (req, res, options) => {
+  };
+  static put = async (req, res, options) => {
     try {
       const result = await InstanceService.put(req, res, options);
       return res.status(200).json({
@@ -48,8 +48,8 @@ const InstanceController = {
         message: error.message,
       });
     }
-  },
-  delete: async (req, res, options) => {
+  };
+  static delete = async (req, res, options) => {
     try {
       const result = await InstanceService.delete(req, res, options);
       return res.status(200).json({
@@ -63,7 +63,7 @@ const InstanceController = {
         message: error.message,
       });
     }
-  },
-};
+  };
+}
 
 export { InstanceController };

package/src/api/instance/instance.model.js

@@ -1,7 +1,5 @@
 import { Schema, model, Types } from 'mongoose';
-
 // https://mongoosejs.com/docs/2.7.x/docs/schematypes.html
-
 const InstanceSchema = new Schema(
   {
     deployId: { type: String },
@@ -20,9 +18,8 @@ const InstanceSchema = new Schema(
     timestamps: true,
   },
 );
-
-const InstanceDto = {
-  populate: {
+class InstanceDto {
+  static populate = {
     get: () => {
       return {
         path: 'userId',
@@ -30,11 +27,8 @@ const InstanceDto = {
         select: '_id email',
       };
     },
-  },
-};
-
+  };
+}
 const InstanceModel = model('Instance', InstanceSchema);
-
 const ProviderSchema = InstanceSchema;
-
 export { InstanceSchema, InstanceModel, ProviderSchema, InstanceDto };

package/src/api/instance/instance.service.js

@@ -5,13 +5,13 @@ import { InstanceDto } from './instance.model.js';
 
 const logger = loggerFactory(import.meta);
 
-const InstanceService = {
-  post: async (req, res, options) => {
+class InstanceService {
+  static post = async (req, res, options) => {
     /** @type {import('./instance.model.js').InstanceModel} */
     const Instance = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Instance;
     return await new Instance(req.body).save();
-  },
-  get: async (req, res, options) => {
+  };
+  static get = async (req, res, options) => {
     /** @type {import('./instance.model.js').InstanceModel} */
     const Instance = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Instance;
 
@@ -58,18 +58,18 @@ const InstanceService = {
             return { data: dataUser, total: totalUser, page, totalPages: Math.ceil(totalUser / limit) };
         }
     }
-  },
-  put: async (req, res, options) => {
+  };
+  static put = async (req, res, options) => {
     /** @type {import('./instance.model.js').InstanceModel} */
     const Instance = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Instance;
     return await Instance.findByIdAndUpdate(req.params.id, req.body);
-  },
-  delete: async (req, res, options) => {
+  };
+  static delete = async (req, res, options) => {
     /** @type {import('./instance.model.js').InstanceModel} */
     const Instance = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Instance;
     if (req.params.id) return await Instance.findByIdAndDelete(req.params.id);
     else return await Instance.deleteMany();
-  },
-};
+  };
+}
 
 export { InstanceService };

package/src/api/ipfs/ipfs.controller.js

@@ -3,8 +3,8 @@ import { IpfsService } from './ipfs.service.js';
 
 const logger = loggerFactory(import.meta);
 
-const IpfsController = {
-  post: async (req, res, options) => {
+class IpfsController {
+  static post = async (req, res, options) => {
     try {
       const result = await IpfsService.post(req, res, options);
       return res.status(200).json({
@@ -18,8 +18,8 @@ const IpfsController = {
         message: error.message,
       });
     }
-  },
-  get: async (req, res, options) => {
+  };
+  static get = async (req, res, options) => {
     try {
       const { page, limit } = req.query;
       const result = await IpfsService.get(
@@ -38,8 +38,8 @@ const IpfsController = {
         message: error.message,
       });
     }
-  },
-  put: async (req, res, options) => {
+  };
+  static put = async (req, res, options) => {
     try {
       const result = await IpfsService.put(req, res, options);
       return res.status(200).json({
@@ -53,8 +53,8 @@ const IpfsController = {
         message: error.message,
       });
     }
-  },
-  delete: async (req, res, options) => {
+  };
+  static delete = async (req, res, options) => {
     try {
       const result = await IpfsService.delete(req, res, options);
       return res.status(200).json({
@@ -68,8 +68,8 @@ const IpfsController = {
         message: error.message,
       });
     }
-  },
-  verify: async (req, res, options) => {
+  };
+  static verify = async (req, res, options) => {
     try {
       const result = await IpfsService.verify(req, res, options);
       return res.status(200).json({ status: 'success', data: result });
@@ -77,7 +77,7 @@ const IpfsController = {
       logger.error(error, error.stack);
       return res.status(400).json({ status: 'error', message: error.message });
     }
-  },
-};
+  };
+}
 
 export { IpfsController };

package/src/api/ipfs/ipfs.model.js

@@ -21,9 +21,7 @@
  * @module src/api/ipfs/ipfs.model.js
  * @namespace IpfsModel
  */
-
 import { Schema, model } from 'mongoose';
-
 const IpfsSchema = new Schema(
   {
     cid: {
@@ -50,22 +48,16 @@ const IpfsSchema = new Schema(
     timestamps: true,
   },
 );
-
 // One DB record per (CID, resourceType) pair.
 IpfsSchema.index({ cid: 1, resourceType: 1 }, { unique: true });
-
 // Fast look-ups for health-check and garbage-collection by type.
 IpfsSchema.index({ resourceType: 1 });
-
 // Fast look-ups for targeted MFS cleanup.
 IpfsSchema.index({ mfsPath: 1 });
-
 const IpfsModel = model('Ipfs', IpfsSchema);
-
 const ProviderSchema = IpfsSchema;
-
-const IpfsDto = {
-  select: {
+class IpfsDto {
+  static select = {
     get: () => ({
       _id: 1,
       cid: 1,
@@ -74,7 +66,6 @@ const IpfsDto = {
       createdAt: 1,
       updatedAt: 1,
     }),
-  },
-};
-
+  };
+}
 export { IpfsSchema, IpfsModel, ProviderSchema, IpfsDto };

package/src/api/ipfs/ipfs.service.js

@@ -3,9 +3,7 @@ import { loggerFactory } from '../../server/logger.js';
 import { DataQuery } from '../../server/data-query.js';
 import { IpfsClient } from '../../server/ipfs-client.js';
 import { IpfsDto } from './ipfs.model.js';
-
 const logger = loggerFactory(import.meta);
-
 /**
  * Upsert a CID registry entry.
  * Called by asset services (ObjectLayer, AtlasSpriteSheet) after a successful
@@ -28,7 +26,6 @@ const createPinRecord = async ({ cid, resourceType, mfsPath = '', options }) =>
   logger.info(`IPFS registry upserted – CID: ${cid}, type: ${resourceType}, mfsPath: ${mfsPath}`);
   return record;
 };
-
 /**
  * Remove all DB registry entries for a CID, then best-effort unpin from the IPFS node.
  * Always deletes DB records first so the registry stays clean even if the node is down.
@@ -47,22 +44,18 @@ const removePinRecordsAndUnpin = async (cid, options) => {
     logger.warn(`Best-effort IPFS unpin failed for CID ${cid}: ${err.message}`);
   }
 };
-
-const IpfsService = {
+class IpfsService {
   /** Expose helpers so other modules can import them directly. */
-  createPinRecord,
-  removePinRecordsAndUnpin,
-
+  static createPinRecord = createPinRecord;
+  static removePinRecordsAndUnpin = removePinRecordsAndUnpin;
   // ──────────────────────────────────────────────
   //  Standard CRUD
   // ──────────────────────────────────────────────
-
-  post: async (req, res, options) => {
+  static post = async (req, res, options) => {
     const Ipfs = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Ipfs;
     return await new Ipfs(req.body).save();
-  },
-
-  get: async (req, res, options) => {
+  };
+  static get = async (req, res, options) => {
     const Ipfs = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Ipfs;
     if (req.params.id) {
       return await Ipfs.findById(req.params.id).select(IpfsDto.select.get());
@@ -74,14 +67,12 @@ const IpfsService = {
     ]);
     const totalPages = Math.ceil(total / limit);
     return { data, total, page, totalPages };
-  },
-
-  put: async (req, res, options) => {
+  };
+  static put = async (req, res, options) => {
     const Ipfs = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Ipfs;
     return await Ipfs.findByIdAndUpdate(req.params.id, req.body, { returnDocument: 'after' });
-  },
-
-  delete: async (req, res, options) => {
+  };
+  static delete = async (req, res, options) => {
     const Ipfs = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Ipfs;
     if (req.params.id) {
       const record = await Ipfs.findById(req.params.id);
@@ -101,12 +92,10 @@ const IpfsService = {
       return null;
     }
     return await Ipfs.deleteMany();
-  },
-
+  };
   // ──────────────────────────────────────────────
   //  Health / audit
   // ──────────────────────────────────────────────
-
   /**
    * GET /ipfs/verify
    *
@@ -117,10 +106,9 @@ const IpfsService = {
    * Response shape:
    *   { total, pinned, unpinned, errors, entries: [{ cid, resourceType, mfsPath, pinned, error? }] }
    */
-  verify: async (req, res, options) => {
+  static verify = async (req, res, options) => {
     const Ipfs = DataBaseProvider.instance[`${options.host}${options.path}`].mongoose.models.Ipfs;
     const records = await Ipfs.find({}).select(IpfsDto.select.get()).lean();
-
     let pinned = 0;
     let unpinned = 0;
     let errors = 0;
@@ -137,9 +125,7 @@ const IpfsService = {
         }
       }),
     );
-
     return { total: records.length, pinned, unpinned, errors, entries };
-  },
-};
-
+  };
+}
 export { IpfsService, createPinRecord, removePinRecordsAndUnpin };

package/src/api/object-layer/object-layer.controller.js

@@ -3,8 +3,8 @@ import { ObjectLayerService } from './object-layer.service.js';
 
 const logger = loggerFactory(import.meta);
 
-const ObjectLayerController = {
-  post: async (req, res, options) => {
+class ObjectLayerController {
+  static post = async (req, res, options) => {
     try {
       const result = await ObjectLayerService.post(req, res, options);
       return res.status(200).json({
@@ -18,8 +18,8 @@ const ObjectLayerController = {
         message: error.message,
       });
     }
-  },
-  get: async (req, res, options) => {
+  };
+  static get = async (req, res, options) => {
     try {
       if (req && req.headers && req.headers.origin) {
         res.set('Access-Control-Allow-Origin', req.headers.origin);
@@ -37,8 +37,8 @@ const ObjectLayerController = {
         message: error.message,
       });
     }
-  },
-  generateWebp: async (req, res, options) => {
+  };
+  static generateWebp = async (req, res, options) => {
     try {
       const result = await ObjectLayerService.generateWebp(req, res, options);
       if (req && req.headers && req.headers.origin) {
@@ -59,8 +59,8 @@ const ObjectLayerController = {
         message: error.message,
       });
     }
-  },
-  put: async (req, res, options) => {
+  };
+  static put = async (req, res, options) => {
     try {
       const result = await ObjectLayerService.put(req, res, options);
       return res.status(200).json({
@@ -74,8 +74,8 @@ const ObjectLayerController = {
         message: error.message,
       });
     }
-  },
-  delete: async (req, res, options) => {
+  };
+  static delete = async (req, res, options) => {
     try {
       const result = await ObjectLayerService.delete(req, res, options);
       return res.status(200).json({
@@ -89,7 +89,7 @@ const ObjectLayerController = {
         message: error.message,
       });
     }
-  },
-};
+  };
+}
 
 export { ObjectLayerController };