@vue-skuilder/express 0.1.1

package/dist/utils/processQueue.js

@@ -0,0 +1,175 @@
+import logger from '../logger.js';
+/**
+ * This queue executes async prcesses sequentially, waiting
+ * for each to complete before launching the next.
+ */
+export default class AsyncProcessQueue {
+    processRequest;
+    queue = [];
+    errors = [];
+    completed = [];
+    processing = false;
+    nextID = 0;
+    /**
+     * Returns 'complete' if the job is complete, 'error' if the
+     * job failed, and the job's position in queue if not yet
+     * completed.
+     *
+     * @param jobID The jobID returned by addRequest
+     */
+    jobStatus(jobID) {
+        let ret = -1; // Default to -1 if job not found
+        this.queue.forEach((req) => {
+            if (req.id === jobID) {
+                ret = this.queue.indexOf(req);
+            }
+        });
+        this.completed.forEach((req) => {
+            if (req.id === jobID) {
+                ret = 'complete';
+            }
+        });
+        this.errors.forEach((req) => {
+            if (req.id === jobID) {
+                ret = 'error';
+            }
+        });
+        return ret;
+    }
+    async recurseGetResult(jobID, depth) {
+        // polling intervals in milliseconds
+        logger.info(`Checking job status of job ${jobID}...`);
+        const intervals = [100, 200, 400, 800, 1000, 2000, 3000, 5000];
+        depth = Math.min(depth, intervals.length - 1);
+        let status;
+        const p = new Promise((resolve, reject) => {
+            setTimeout(() => {
+                status = this.jobStatus(jobID);
+                if (status === 'complete' || status === 'error') {
+                    resolve(null);
+                }
+                else {
+                    reject();
+                }
+            }, intervals[depth]);
+        });
+        return p
+            .then(() => {
+            return this.getResult(jobID);
+        })
+            .catch(() => {
+            return this.recurseGetResult(jobID, depth + 1);
+        });
+    }
+    async getResult(jobID, _depth = 0) {
+        const status = this.jobStatus(jobID);
+        if (status === 'complete') {
+            const res = this.completed.find((val) => {
+                return val.id === jobID;
+            });
+            if (res) {
+                return res.result;
+            }
+            else {
+                return {
+                    error: 'No result found',
+                    ok: false,
+                    status: 'error',
+                };
+            }
+        }
+        else if (status === 'error') {
+            const res = this.errors.find((val) => {
+                return val.id === jobID;
+            });
+            if (!res) {
+                return {
+                    error: 'Job failed - no error log found',
+                    ok: false,
+                    status: 'error',
+                };
+            }
+            if (res.result) {
+                return res.result;
+            }
+            else {
+                // result is null b/c of an uncaugth exception
+                return {
+                    error: res.error,
+                    ok: false,
+                    status: 'error',
+                };
+            }
+        }
+        else {
+            return this.recurseGetResult(jobID, 0);
+        }
+    }
+    addRequest(req) {
+        const id = this.nextID++;
+        this.queue.push({
+            id: id,
+            request: req,
+        });
+        if (!this.processing) {
+            void this.process();
+        }
+        return id;
+    }
+    /**
+     *
+     */
+    constructor(processingFcn) {
+        this.processRequest = processingFcn;
+    }
+    async process() {
+        this.processing = true;
+        while (this.queue.length > 0) {
+            const req = this.queue[0];
+            logger.info(`Processing ${req.id}`);
+            try {
+                const result = await this.processRequest(req.request);
+                if (result.ok) {
+                    this.completed.push({
+                        id: req.id,
+                        request: req.request,
+                        result: result,
+                    });
+                }
+                else {
+                    if (result) {
+                        this.errors.push({
+                            id: req.id,
+                            request: req.request,
+                            result: result,
+                            error: result.error,
+                        });
+                    }
+                    else {
+                        this.errors.push({
+                            id: req.id,
+                            request: req.request,
+                            error: 'error',
+                            result: null,
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                this.errors.push({
+                    id: req.id,
+                    request: req.request,
+                    result: null,
+                    error: e,
+                });
+            }
+            finally {
+                // remove the completed (or errored)
+                // request from the queue
+                this.queue.shift();
+            }
+        }
+        this.processing = false;
+    }
+}
+//# sourceMappingURL=processQueue.js.map

package/dist/utils/processQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processQueue.js","sourceRoot":"","sources":["../../src/utils/processQueue.ts"],"names":[],"mappings":"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"}

package/eslint.config.js

@@ -0,0 +1,19 @@
+import backendConfig from '../../eslint.config.backend.mjs';
+
+export default [
+  ...backendConfig,
+  {
+    ignores: ['node_modules/**', 'dist/**', 'coverage/**', 'eslint.config.js', 'assets/**', 'babel.config.js', 'jest.config.ts', 'test/**'],
+  },
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      // Express-specific rules (backend config already includes most needed rules)
+    },
+  },
+];

package/jest.config.ts

@@ -0,0 +1,24 @@
+import type { JestConfigWithTsJest } from 'ts-jest';
+
+const config: JestConfigWithTsJest = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: true,
+      },
+    ],
+  },
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  testMatch: ['**/?(*.)+(spec|test).[tj]s?(x)'],
+
+  rootDir: './',
+};
+
+export default config;

package/package.json

@@ -0,0 +1,74 @@
+{
+    "name": "@vue-skuilder/express",
+    "publishConfig": {
+        "access": "public"
+    },
+    "version": "0.1.1",
+    "description": "an API",
+    "main": "dist/app.js",
+    "type": "module",
+    "types": "dist/app.d.ts",
+    "scripts": {
+        "clean": "rimraf dist",
+        "dev": "tsx watch src/app.ts",
+        "build": "yarn clean && tsc",
+        "start": "node dist/app.js",
+        "test": "jest --config jest.config.ts",
+        "lint": "npx eslint .",
+        "lint:fix": "npx eslint . --fix",
+        "lint:check": "npx eslint . --max-warnings 0",
+        "type-check": "tsc --noEmit"
+    },
+    "packageManager": "yarn@4.6.0",
+    "author": "Colin Kennedy",
+    "license": "GPL-3.0-or-later",
+    "dependencies": {
+        "@vue-skuilder/common": "workspace:^",
+        "@vue-skuilder/db": "workspace:^",
+        "axios": "^1.7.4",
+        "cookie-parser": "^1.4.7",
+        "cors": "^2.8.5",
+        "dotenv": "^16.4.7",
+        "express": "^4.21.2",
+        "express-rate-limit": "^7.5.0",
+        "ffmpeg-static": "^5.2.0",
+        "hashids": "^2.3.0",
+        "morgan": "^1.10.0",
+        "nano": "^ 9.0.5",
+        "pouchdb": "9.0.0",
+        "winston": "^3.17.0",
+        "winston-daily-rotate-file": "^5.0.0"
+    },
+    "devDependencies": {
+        "@babel/core": "^7.26.9",
+        "@babel/preset-env": "^7.26.9",
+        "@babel/preset-typescript": "^7.26.0",
+        "@tsconfig/node18": "^18.2.4",
+        "@types/cookie-parser": "^1.4.8",
+        "@types/cors": "^2.8.17",
+        "@types/dotenv": "^8.2.3",
+        "@types/express": "4.17.21",
+        "@types/express-rate-limit": "^6.0.2",
+        "@types/ffmpeg-static": "^2.0.0",
+        "@types/hashids": "^1.0.30",
+        "@types/jest": "^29.5.14",
+        "@types/morgan": "^1.9.9",
+        "@types/node": "18",
+        "@types/pouchdb": "^6.4.2",
+        "@typescript-eslint/eslint-plugin": "^8.25.0",
+        "@typescript-eslint/parser": "^8.25.0",
+        "babel-jest": "^29.6.1",
+        "eslint": "^9.21.0",
+        "eslint-config-prettier": "^10.0.2",
+        "eslint-plugin-prettier": "^5.2.3",
+        "jest": "^29.6.1",
+        "jest-environment-node": "^29.7.0",
+        "prettier": "^3.0.0",
+        "rimraf": "*",
+        "ts-jest": "^29.2.5",
+        "ts-node": "^10.9.2",
+        "tsx": "^4.19.2",
+        "typescript": "^5.7.2",
+        "typescript-eslint": "^8.25.0"
+    }
+}

package/src/app.ts

@@ -0,0 +1,246 @@
+import {
+  ServerRequestType as RequestEnum,
+  ServerRequest,
+  prepareNote55,
+} from '@vue-skuilder/common';
+import { CourseLookup } from '@vue-skuilder/db';
+import cookieParser from 'cookie-parser';
+import cors from 'cors';
+import type { Request, Response } from 'express';
+import express from 'express';
+import morgan from 'morgan';
+import Nano from 'nano';
+import PostProcess from './attachment-preprocessing/index.js';
+import {
+  ClassroomCreationQueue,
+  ClassroomJoinQueue,
+  ClassroomLeaveQueue,
+} from './client-requests/classroom-requests.js';
+import {
+  CourseCreationQueue,
+  initCourseDBDesignDocInsert,
+} from './client-requests/course-requests.js';
+import { requestIsAuthenticated } from './couchdb/authentication.js';
+import CouchDB, {
+  useOrCreateCourseDB,
+  useOrCreateDB,
+} from './couchdb/index.js';
+import logger from './logger.js';
+import logsRouter from './routes/logs.js';
+import ENV from './utils/env.js';
+
+process.on('unhandledRejection', (reason, promise) => {
+  logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
+});
+
+logger.info(`Express app running version: ${ENV.VERSION}`);
+
+const port = 3000;
+import { classroomDbDesignDoc } from './design-docs.js';
+const app = express();
+
+app.use(cookieParser());
+app.use(express.json());
+app.use(
+  cors({
+    credentials: true,
+    origin: true,
+  })
+);
+app.use(
+  morgan('combined', {
+    stream: { write: (message: string) => logger.info(message.trim()) },
+  })
+);
+app.use('/logs', logsRouter);
+
+export interface VueClientRequest extends express.Request {
+  body: ServerRequest;
+}
+
+app.get('/courses', (_req: Request, res: Response) => {
+  void (async () => {
+    try {
+      const courses = await CourseLookup.allCourses();
+      res.send(courses.map((c) => `${c._id} - ${c.name}`));
+    } catch (error) {
+      logger.error('Error fetching courses:', error);
+      res.status(500).send('Failed to fetch courses');
+    }
+  })();
+});
+
+app.get('/course/:courseID/config', (req: Request, res: Response) => {
+  void (async () => {
+    try {
+      const courseDB = await useOrCreateCourseDB(req.params.courseID);
+      const cfg = await courseDB.get('CourseConfig'); // [ ] pull courseConfig docName into global const
+
+      res.json(cfg);
+    } catch (error) {
+      logger.error('Error fetching course config:', error);
+      res.status(500).send('Failed to fetch course config');
+    }
+  })();
+});
+
+app.delete('/course/:courseID', (req: Request, res: Response) => {
+  void (async () => {
+    try {
+      logger.info(`Delete request made on course ${req.params.courseID}...`);
+      const auth = await requestIsAuthenticated(req);
+      if (auth) {
+        logger.info(`\tAuthenticated delete request made...`);
+        const dbResp = await CouchDB.db.destroy(
+          `coursedb-${req.params.courseID}`
+        );
+        if (!dbResp.ok) {
+          res.json({ success: false, error: dbResp });
+          return;
+        }
+        const delResp = await CourseLookup.delete(req.params.courseID);
+
+        if (delResp.ok) {
+          res.json({ success: true });
+        } else {
+          res.json({ success: false, error: delResp });
+        }
+      } else {
+        res.json({ success: false, error: 'Not authenticated' });
+      }
+    } catch (error) {
+      logger.error('Error deleting course:', error);
+      res.status(500).json({ success: false, error: 'Failed to delete course' });
+    }
+  })();
+});
+
+async function postHandler(
+  req: VueClientRequest,
+  res: express.Response
+): Promise<void> {
+  const auth = await requestIsAuthenticated(req);
+  if (auth) {
+    const body = req.body;
+    logger.info(
+      `Authorized ${
+        body.type ? body.type : '[unspecified request type]'
+      } request made...`
+    );
+
+    if (body.type === RequestEnum.CREATE_CLASSROOM) {
+      const id: number = ClassroomCreationQueue.addRequest(body.data);
+      body.response = await ClassroomCreationQueue.getResult(id);
+      res.json(body.response);
+    } else if (body.type === RequestEnum.DELETE_CLASSROOM) {
+      // [ ] add delete classroom request
+    } else if (body.type === RequestEnum.JOIN_CLASSROOM) {
+      const id: number = ClassroomJoinQueue.addRequest(body.data);
+      body.response = await ClassroomJoinQueue.getResult(id);
+      res.json(body.response);
+    } else if (body.type === RequestEnum.LEAVE_CLASSROOM) {
+      const id: number = ClassroomLeaveQueue.addRequest({
+        username: req.body.user,
+        ...body.data,
+      });
+      body.response = await ClassroomLeaveQueue.getResult(id);
+      res.json(body.response);
+    } else if (body.type === RequestEnum.CREATE_COURSE) {
+      const id: number = CourseCreationQueue.addRequest(body.data);
+      body.response = await CourseCreationQueue.getResult(id);
+      res.json(body.response);
+    } else if (body.type === RequestEnum.ADD_COURSE_DATA) {
+      const payload = prepareNote55(
+        body.data.courseID,
+        body.data.codeCourse,
+        body.data.shape,
+        body.data.data,
+        body.data.author,
+        body.data.tags,
+        body.data.uploads
+      );
+      CouchDB.use(`coursedb-${body.data.courseID}`)
+        .insert(payload as Nano.MaybeDocument)
+        .then((r) => {
+          logger.info(`\t\t\tCouchDB insert result: ${JSON.stringify(r)}`);
+          res.json(r);
+        })
+        .catch((e) => {
+          logger.info(`\t\t\tCouchDB insert error: ${JSON.stringify(e)}`);
+          res.json(e);
+        });
+    }
+  } else {
+    logger.info(`\tREQUEST UNAUTHORIZED!`);
+    res.status(401);
+    res.statusMessage = 'Unauthorized';
+    res.send();
+  }
+}
+
+app.post('/', (req: Request, res: Response) => {
+  void postHandler(req, res);
+});
+
+app.get('/version', (_req: Request, res: Response) => {
+  res.send(ENV.VERSION);
+});
+
+app.get('/', (_req: Request, res: Response) => {
+  let status = `Express service is running.\nVersion: ${ENV.VERSION}\n`;
+
+  CouchDB.session()
+    .then((s) => {
+      if (s.ok) {
+        status += 'Couchdb is running.\n';
+      } else {
+        status += 'Couchdb session is NOT ok.\n';
+      }
+    })
+    .catch((e) => {
+      status += `Problems in the couch session! ${JSON.stringify(e)}`;
+    })
+    .finally(() => {
+      res.send(status);
+    });
+});
+let listening = false;
+
+app.listen(port, () => {
+  listening = true;
+  logger.info(`Express app listening on port ${port}!`);
+});
+
+init().catch((e) => {
+  logger.error(`Error initializing app: ${JSON.stringify(e)}`);
+});
+
+async function init(): Promise<void> {
+  while (!listening) {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  }
+
+  try {
+    // start the change-listener that does post-processing on user
+    // media uploads
+    void PostProcess();
+
+    void initCourseDBDesignDocInsert();
+
+    void useOrCreateDB('classdb-lookup');
+    try {
+      await (
+        await useOrCreateDB('coursedb')
+      ).insert(
+        {
+          validate_doc_update: classroomDbDesignDoc,
+        } as Nano.MaybeDocument,
+        '_design/_auth'
+      );
+    } catch (e) {
+      logger.info(`Error: ${e}`);
+    }
+  } catch (e) {
+    logger.info(`Error: ${JSON.stringify(e)}`);
+  }
+}