@studious-lms/server 1.0.0

package/LICENSE.txt

@@ -0,0 +1,8 @@
+Copyright 2025 Alan Shen <contact@alanshen.me>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

package/README.md

@@ -0,0 +1,143 @@
+# Studious Backend Server
+
+This is the backend server for the Studious application. It provides a RESTful and real-time API for managing users, classes, assignments, attendance, and more, supporting both HTTP (via tRPC) and WebSocket (via Socket.IO) communication.
+
+## Features
+
+- **Express.js** server with CORS support
+- **tRPC** for type-safe API endpoints
+- **Socket.IO** for real-time features
+- **Prisma ORM** with PostgreSQL for database management
+- **User authentication** and session management
+- **Class, assignment, attendance, and file management**
+- **Structured logging** for requests and server events
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js (v18+ recommended)
+- npm (v9+ recommended)
+- PostgreSQL database
+
+### Installation
+
+1. **Clone the repository:**
+   ```bash
+   git clone <repo-url>
+   cd server
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+3. **Set up environment variables:**
+   Create a `.env` file in the root directory with the following variables:
+   ```env
+   DATABASE_URL="postgresql://username:password@localhost:5432/easy_lms"
+   PORT=3001
+   NEXT_PUBLIC_APP_URL=http://localhost:3000
+   NODE_ENV=development
+   LOG_MODE=info
+   ```
+
+4. **Set up the database:**
+   - Create a PostgreSQL database named `easy_lms`
+   - Run the Prisma migrations:
+     ```bash
+     npx prisma migrate dev --name init
+     ```
+   - Generate the Prisma client:
+     ```bash
+     npx prisma generate
+     ```
+
+### Running the Server
+
+- **Development mode (with hot reload):**
+  ```bash
+  npm run dev
+  ```
+
+- **Production build:**
+  ```bash
+  npm run build
+  npm start
+  ```
+
+The server will start on the port specified in your `.env` file (default: `3001`).
+
+## API Overview
+
+- **tRPC endpoints:** Available at `/trpc`
+- **WebSocket:** Available at `/socket.io/`
+- **CORS:** Configured to allow requests from the frontend app URL via `NEXT_PUBLIC_APP_URL`
+
+## Project Structure
+
+```
+src/
+  index.ts         # Main server entry point
+  routers/         # tRPC routers for API endpoints
+  socket/          # Socket.IO event handlers
+  middleware/      # Express and tRPC middleware
+  utils/           # Utility functions (e.g., logger)
+  lib/             # Shared libraries
+  types/           # TypeScript types
+prisma/
+  schema.prisma    # Prisma database schema
+  migrations/      # Database migrations
+```
+
+## Database
+
+- **Database:** PostgreSQL
+- **ORM:** Prisma
+- **Schema:** Defined in `prisma/schema.prisma`
+- **Migrations:** Stored in `prisma/migrations/`
+
+### Database Commands
+
+```bash
+# Generate Prisma client
+npx prisma generate
+
+# Run migrations
+npx prisma migrate dev
+
+# Reset database
+npx prisma migrate reset
+
+# Open Prisma Studio (database GUI)
+npx prisma studio
+```
+
+## Scripts
+
+- `npm run dev` — Start in development mode with hot reload
+- `npm run build` — Compile TypeScript to JavaScript
+- `npm start` — Start the compiled server
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DATABASE_URL` | PostgreSQL connection string | Required |
+| `PORT` | Server port | 3001 |
+| `NEXT_PUBLIC_APP_URL` | Frontend app URL for CORS | http://localhost:3000 |
+| `NODE_ENV` | Environment mode | development |
+| `LOG_MODE` | Logging level | info |
+
+## Development
+
+The server uses TypeScript and includes:
+- **tRPC** for type-safe API development
+- **Socket.IO** for real-time communication
+- **Prisma** for database operations
+- **Express** middleware for CORS and logging
+
+## License
+
+[MIT](LICENSE.txt)

package/dist/exportType.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Export types for the server
+ * This is used to export the types for the server
+ * to the client via npmjs
+ */
+export type { AppRouter } from "@/routers/_app";
+export type { RouterInputs } from "@/routers/_app";
+export type { RouterOutputs } from "@/routers/_app";
+//# sourceMappingURL=exportType.d.ts.map

package/dist/exportType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportType.d.ts","sourceRoot":"","sources":["../src/exportType.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/exportType.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Export types for the server
+ * This is used to export the types for the server
+ * to the client via npmjs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const http_1 = require("http");
+const socket_io_1 = require("socket.io");
+const cors_1 = __importDefault(require("cors"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const express_2 = require("@trpc/server/adapters/express");
+const _app_1 = require("@routers/_app");
+const trpc_1 = require("@/trpc");
+const logger_1 = require("@utils/logger");
+const handlers_1 = require("@/socket/handlers");
+dotenv_1.default.config();
+const app = (0, express_1.default)();
+// CORS middleware
+app.use((0, cors_1.default)({
+    origin: process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000',
+    credentials: true,
+}));
+// Response time logging middleware
+app.use((req, res, next) => {
+    const start = Date.now();
+    res.on('finish', () => {
+        const duration = Date.now() - start;
+        logger_1.logger.info('Request completed', {
+            method: req.method,
+            path: req.path,
+            statusCode: res.statusCode,
+            duration: `${duration}ms`
+        });
+    });
+    next();
+});
+// Create HTTP server
+const httpServer = (0, http_1.createServer)(app);
+// Setup Socket.IO
+const io = new socket_io_1.Server(httpServer, {
+    cors: {
+        origin: process.env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000',
+        methods: ['GET', 'POST'],
+        credentials: true,
+        allowedHeaders: ['Access-Control-Allow-Origin']
+    },
+    transports: ['websocket', 'polling'],
+    pingTimeout: 60000,
+    pingInterval: 25000,
+    connectTimeout: 45000,
+    path: '/socket.io/',
+    allowEIO3: true
+});
+// Add server-level logging
+io.engine.on('connection_error', (err) => {
+    logger_1.logger.error('Socket connection error', { error: err.message });
+});
+// Setup socket handlers
+(0, handlers_1.setupSocketHandlers)(io);
+// Create caller
+const createCaller = (0, trpc_1.createCallerFactory)(_app_1.appRouter);
+// Setup tRPC middleware
+app.use('/trpc', (0, express_2.createExpressMiddleware)({
+    router: _app_1.appRouter,
+    createContext: async ({ req, res }) => {
+        return (0, trpc_1.createTRPCContext)({ req, res });
+    },
+}));
+const PORT = process.env.PORT || 3001;
+httpServer.listen(PORT, () => {
+    logger_1.logger.info(`Server running on port ${PORT}`, {
+        port: PORT,
+        services: ['tRPC', 'Socket.IO']
+    });
+});
+// log all env variables
+logger_1.logger.info('Configurations', {
+    NODE_ENV: process.env.NODE_ENV,
+    PORT: process.env.PORT,
+    NEXT_PUBLIC_APP_URL: process.env.NEXT_PUBLIC_APP_URL,
+    LOG_MODE: process.env.LOG_MODE,
+});

package/dist/lib/fileUpload.d.ts

@@ -0,0 +1,38 @@
+export interface FileData {
+    name: string;
+    type: string;
+    size: number;
+    data: string;
+}
+export interface UploadedFile {
+    id: string;
+    name: string;
+    type: string;
+    size: number;
+    path: string;
+    thumbnailId?: string;
+}
+/**
+ * Uploads a single file to Google Cloud Storage and creates a file record
+ * @param file The file data to upload
+ * @param userId The ID of the user uploading the file
+ * @param directory Optional directory to store the file in
+ * @param assignmentId Optional assignment ID to associate the file with
+ * @returns The uploaded file record
+ */
+export declare function uploadFile(file: FileData, userId: string, directory?: string, assignmentId?: string): Promise<UploadedFile>;
+/**
+ * Uploads multiple files
+ * @param files Array of files to upload
+ * @param userId The ID of the user uploading the files
+ * @param directory Optional subdirectory to store the files in
+ * @returns Array of uploaded file information
+ */
+export declare function uploadFiles(files: FileData[], userId: string, directory?: string): Promise<UploadedFile[]>;
+/**
+ * Gets a signed URL for a file
+ * @param filePath The path of the file in Google Cloud Storage
+ * @returns The signed URL
+ */
+export declare function getFileUrl(filePath: string): Promise<string>;
+//# sourceMappingURL=fileUpload.d.ts.map

package/dist/lib/fileUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUpload.d.ts","sourceRoot":"","sources":["../../src/lib/fileUpload.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,YAAY,CAAC,CAsFvB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAWzB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlE"}

package/dist/lib/fileUpload.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFile = uploadFile;
+exports.uploadFiles = uploadFiles;
+exports.getFileUrl = getFileUrl;
+const server_1 = require("@trpc/server");
+const uuid_1 = require("uuid");
+const googleCloudStorage_1 = require("./googleCloudStorage");
+const thumbnailGenerator_1 = require("./thumbnailGenerator");
+const prisma_1 = require("./prisma");
+/**
+ * Uploads a single file to Google Cloud Storage and creates a file record
+ * @param file The file data to upload
+ * @param userId The ID of the user uploading the file
+ * @param directory Optional directory to store the file in
+ * @param assignmentId Optional assignment ID to associate the file with
+ * @returns The uploaded file record
+ */
+async function uploadFile(file, userId, directory, assignmentId) {
+    try {
+        // Create a unique filename
+        const fileExtension = file.name.split('.').pop();
+        const uniqueFilename = `${(0, uuid_1.v4)()}.${fileExtension}`;
+        // Construct the full path
+        const filePath = directory
+            ? `${directory}/${uniqueFilename}`
+            : uniqueFilename;
+        // Upload to Google Cloud Storage
+        const uploadedPath = await (0, googleCloudStorage_1.uploadFile)(file.data, filePath, file.type);
+        // Generate and store thumbnail if supported
+        let thumbnailId;
+        try {
+            // Convert base64 to buffer for thumbnail generation
+            const base64Data = file.data.split(',')[1];
+            const fileBuffer = Buffer.from(base64Data, 'base64');
+            // Generate thumbnail directly from buffer
+            const thumbnailBuffer = await (0, thumbnailGenerator_1.generateMediaThumbnail)(fileBuffer, file.type);
+            if (thumbnailBuffer) {
+                // Store thumbnail in a thumbnails directory
+                const thumbnailPath = `thumbnails/${filePath}`;
+                const thumbnailBase64 = `data:image/jpeg;base64,${thumbnailBuffer.toString('base64')}`;
+                await (0, googleCloudStorage_1.uploadFile)(thumbnailBase64, thumbnailPath, 'image/jpeg');
+                // Create thumbnail file record
+                const thumbnailFile = await prisma_1.prisma.file.create({
+                    data: {
+                        name: `${file.name}_thumb.jpg`,
+                        type: 'image/jpeg',
+                        path: thumbnailPath,
+                        user: {
+                            connect: { id: userId }
+                        }
+                    }
+                });
+                thumbnailId = thumbnailFile.id;
+            }
+        }
+        catch (error) {
+            console.warn('Failed to generate thumbnail:', error);
+        }
+        // Create file record in database
+        const fileRecord = await prisma_1.prisma.file.create({
+            data: {
+                name: file.name,
+                type: file.type,
+                size: file.size,
+                path: uploadedPath,
+                user: {
+                    connect: { id: userId }
+                },
+                ...(thumbnailId && {
+                    thumbnail: {
+                        connect: { id: thumbnailId }
+                    }
+                }),
+                ...(assignmentId && {
+                    assignment: {
+                        connect: { id: assignmentId }
+                    }
+                })
+            },
+        });
+        // Return file information
+        return {
+            id: fileRecord.id,
+            name: file.name,
+            type: file.type,
+            size: file.size,
+            path: uploadedPath,
+            thumbnailId: thumbnailId
+        };
+    }
+    catch (error) {
+        console.error('Error uploading file:', error);
+        throw new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Failed to upload file',
+        });
+    }
+}
+/**
+ * Uploads multiple files
+ * @param files Array of files to upload
+ * @param userId The ID of the user uploading the files
+ * @param directory Optional subdirectory to store the files in
+ * @returns Array of uploaded file information
+ */
+async function uploadFiles(files, userId, directory) {
+    try {
+        const uploadPromises = files.map(file => uploadFile(file, userId, directory));
+        return await Promise.all(uploadPromises);
+    }
+    catch (error) {
+        console.error('Error uploading files:', error);
+        throw new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Failed to upload files',
+        });
+    }
+}
+/**
+ * Gets a signed URL for a file
+ * @param filePath The path of the file in Google Cloud Storage
+ * @returns The signed URL
+ */
+async function getFileUrl(filePath) {
+    try {
+        return await (0, googleCloudStorage_1.getSignedUrl)(filePath);
+    }
+    catch (error) {
+        console.error('Error getting signed URL:', error);
+        throw new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Failed to get file URL',
+        });
+    }
+}

package/dist/lib/googleCloudStorage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Uploads a file to Google Cloud Storage
+ * @param base64Data Base64 encoded file data
+ * @param filePath The path where the file should be stored
+ * @param contentType The MIME type of the file
+ * @returns The path of the uploaded file
+ */
+export declare function uploadFile(base64Data: string, filePath: string, contentType: string): Promise<string>;
+/**
+ * Gets a signed URL for a file
+ * @param filePath The path of the file in the bucket
+ * @returns The signed URL
+ */
+export declare function getSignedUrl(filePath: string): Promise<string>;
+/**
+ * Deletes a file from Google Cloud Storage
+ * @param filePath The path of the file to delete
+ */
+export declare function deleteFile(filePath: string): Promise<void>;
+//# sourceMappingURL=googleCloudStorage.d.ts.map

package/dist/lib/googleCloudStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"googleCloudStorage.d.ts","sourceRoot":"","sources":["../../src/lib/googleCloudStorage.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAepE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE"}

package/dist/lib/googleCloudStorage.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFile = uploadFile;
+exports.getSignedUrl = getSignedUrl;
+exports.deleteFile = deleteFile;
+const storage_1 = require("@google-cloud/storage");
+const server_1 = require("@trpc/server");
+const storage = new storage_1.Storage({
+    projectId: process.env.GOOGLE_CLOUD_PROJECT_ID,
+    credentials: {
+        client_email: process.env.GOOGLE_CLOUD_CLIENT_EMAIL,
+        private_key: process.env.GOOGLE_CLOUD_PRIVATE_KEY?.replace(/\\n/g, '\n'),
+    },
+});
+const bucket = storage.bucket(process.env.GOOGLE_CLOUD_BUCKET_NAME || '');
+// Short expiration time for signed URLs (5 minutes)
+const SIGNED_URL_EXPIRATION = 5 * 60 * 1000;
+/**
+ * Uploads a file to Google Cloud Storage
+ * @param base64Data Base64 encoded file data
+ * @param filePath The path where the file should be stored
+ * @param contentType The MIME type of the file
+ * @returns The path of the uploaded file
+ */
+async function uploadFile(base64Data, filePath, contentType) {
+    try {
+        // Remove the data URL prefix if present
+        const base64Content = base64Data.includes('base64,')
+            ? base64Data.split('base64,')[1]
+            : base64Data;
+        // Convert base64 to buffer
+        const fileBuffer = Buffer.from(base64Content, 'base64');
+        // Create a new file in the bucket
+        const file = bucket.file(filePath);
+        // Upload the file
+        await file.save(fileBuffer, {
+            metadata: {
+                contentType,
+            },
+        });
+        return filePath;
+    }
+    catch (error) {
+        console.error('Error uploading to Google Cloud Storage:', error);
+        throw new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Failed to upload file to storage',
+        });
+    }
+}
+/**
+ * Gets a signed URL for a file
+ * @param filePath The path of the file in the bucket
+ * @returns The signed URL
+ */
+async function getSignedUrl(filePath) {
+    try {
+        const [url] = await bucket.file(filePath).getSignedUrl({
+            version: 'v4',
+            action: 'read',
+            expires: Date.now() + SIGNED_URL_EXPIRATION,
+        });
+        return url;
+    }
+    catch (error) {
+        console.error('Error getting signed URL:', error);
+        throw new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Failed to get signed URL',
+        });
+    }
+}
+/**
+ * Deletes a file from Google Cloud Storage
+ * @param filePath The path of the file to delete
+ */
+async function deleteFile(filePath) {
+    try {
+        await bucket.file(filePath).delete();
+    }
+    catch (error) {
+        console.error('Error deleting file from Google Cloud Storage:', error);
+        throw new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Failed to delete file from storage',
+        });
+    }
+}

package/dist/lib/prisma.d.ts

@@ -0,0 +1,8 @@
+import { PrismaClient } from '@prisma/client';
+declare const prismaClientSingleton: () => PrismaClient<import(".prisma/client").Prisma.PrismaClientOptions, never, import("@prisma/client/runtime/library").DefaultArgs>;
+declare global {
+    var prisma: undefined | ReturnType<typeof prismaClientSingleton>;
+}
+export declare const prisma: PrismaClient<import(".prisma/client").Prisma.PrismaClientOptions, never, import("@prisma/client/runtime/library").DefaultArgs>;
+export {};
+//# sourceMappingURL=prisma.d.ts.map

package/dist/lib/prisma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/lib/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,QAAA,MAAM,qBAAqB,sIAE1B,CAAC;AAGF,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;CAClE;AAED,eAAO,MAAM,MAAM,gIAA+C,CAAC"}

package/dist/lib/prisma.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prisma = void 0;
+const client_1 = require("@prisma/client");
+const prismaClientSingleton = () => {
+    return new client_1.PrismaClient();
+};
+exports.prisma = globalThis.prisma ?? prismaClientSingleton();
+if (process.env.NODE_ENV !== 'production') {
+    globalThis.prisma = exports.prisma;
+}

package/dist/lib/thumbnailGenerator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generates a thumbnail for an image or PDF file
+ * @param fileBuffer The file buffer
+ * @param fileType The MIME type of the file
+ * @returns Thumbnail buffer
+ */
+export declare function generateMediaThumbnail(fileBuffer: Buffer, fileType: string): Promise<Buffer>;
+/**
+ * Generates a thumbnail for a file
+ * @param fileName The name of the file in Google Cloud Storage
+ * @param fileType The MIME type of the file
+ * @returns The thumbnail buffer or null if thumbnail generation is not supported
+ */
+export declare function generateThumbnail(fileName: string, fileType: string): Promise<Buffer | null>;
+/**
+ * Stores a thumbnail in Google Cloud Storage and creates a File entry
+ * @param thumbnailBuffer The thumbnail buffer to store
+ * @param originalFileName The original file name
+ * @param userId The user ID who owns the file
+ * @returns The ID of the created thumbnail File
+ */
+export declare function storeThumbnail(thumbnailBuffer: Buffer, originalFileName: string, userId: string): Promise<string>;
+//# sourceMappingURL=thumbnailGenerator.d.ts.map

package/dist/lib/thumbnailGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnailGenerator.d.ts","sourceRoot":"","sources":["../../src/lib/thumbnailGenerator.ts"],"names":[],"mappings":"AAiDA;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlG;AA4CD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BlG;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBvH"}