.gitea/workflows/ci.yml

@@ -80,8 +80,10 @@ jobs:
       - name: ESLint
         run: npm run check:eslint
 
-      - name: Prettier
-        run: npm run check:prettier
+      - name: Prettier Check and Fix
+        run: |
+          npx prettier --write . 
+          npm run check:prettier
 
       # ── Security (informational — findings shouldn't block a deploy) ─────
       - name: Audit (high/critical)

README.md

@@ -13,7 +13,38 @@ The source code is licensed under [AGPLv3](LICENSE), the same license as the ups
 The Lotus Chat logo (`public/res/Lotus.png`) is a derivative work based on the original Cinny logo by Ajay Bura and contributors, used under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). The modified logo is © Lotus Guild and is also made available under CC BY 4.0.
 
 ---
-
+## Development Environment Setup
+#### Getting correct Node version
+- Ensure you have the correct version of node installed, specified in `.node-version`
+- Use this command from the terminal to install nvm 
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+``` 
+- Reload your terminal shell using (for Ubuntu):
+```bash
+source ~/.bashrc
+```
+- Install the specified Node version 
+```bash
+NODE_VERSION="$(tr -d '[:space:]' < .node-version)"
+nvm install "$NODE_VERSION"
+nvm use "$NODE_VERSION"
+```
+- verify the correct version was installed by running
+```bash
+node --version
+```
+and comparing the output to what is listed in `.node-version`
+#### Install npm packages
+- To install the npm packages listed in `package.json` run: 
+```bash
+ npm i 
+ ```
+### Start Development Server
+```bash
+npm run start
+```
+You should now have an active development server at `localhost:8080`, where you can make changes to the code and see the UI update in real time
 ## Features
 
 ### Messaging

eslint.config.mjs

@@ -109,7 +109,7 @@ export default [
         { argsIgnorePattern: '^_', varsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_' },
       ],
       '@typescript-eslint/no-shadow': 'error',
-      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-explicit-any': 'off',
 
       // jsx-a11y — media captions not required for this app
       'jsx-a11y/media-has-caption': 'off',

package.json

@@ -12,13 +12,12 @@
     "build": "vite build",
     "preview": "vite preview",
     "lint": "npm run check:eslint && npm run check:prettier",
-    "check:eslint": "eslint src/*",
+    "check:eslint": "eslint \"src/**/*.{js,jsx,ts,tsx}\"",
     "check:prettier": "prettier --check .",
     "fix:prettier": "prettier --write .",
     "typecheck": "tsc --noEmit",
     "test": "node --import tsx --test $(find src -name '*.test.ts')",
     "prepare": "husky",
-    "commit": "git-cz",
     "postinstall": "node scripts/patch-folds.mjs",
     "sync:decorations": "node scripts/syncDecorations.mjs"
   },
@@ -26,11 +25,6 @@
     "*.{ts,tsx,js,jsx}": "eslint",
     "*": "prettier --ignore-unknown --write"
   },
-  "config": {
-    "commitizen": {
-      "path": "./node_modules/cz-conventional-changelog"
-    }
-  },
   "keywords": [],
   "author": "Ajay Bura",
   "license": "AGPL-3.0-only",
@@ -43,7 +37,7 @@
     "@fontsource-variable/inter": "5.2.8",
     "@giphy/js-fetch-api": "5.8.0",
     "@giphy/js-types": "5.1.0",
-    "@giphy/js-util": "5.2.0",
+    "@giphy/js-util": "2.0.0",
     "@giphy/react-components": "10.1.2",
     "@sapphi-red/web-noise-suppressor": "0.3.5",
     "@tanstack/react-query": "5.100.13",
@@ -95,7 +89,7 @@
     "react-i18next": "17.0.8",
     "react-range": "1.10.0",
     "react-router-dom": "7.15.1",
-    "sanitize-html": "2.17.4",
+    "sanitize-html": "2.17.6",
     "slate": "0.124.1",
     "slate-dom": "0.124.1",
     "slate-history": "0.113.1",
@@ -130,6 +124,7 @@
     "cz-conventional-changelog": "3.3.0",
     "eslint": "9.39.4",
     "eslint-config-airbnb": "19.0.4",
+    "eslint-config-airbnb-base": "15.0.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-jsx-a11y": "6.10.2",
@@ -149,5 +144,8 @@
       "dompurify": ">=3.3.4"
     },
     "js-cookie": ">=3.0.6"
+  },
+  "allowScripts": {
+    "esbuild@0.28.1": true
   }
 }

src/app/components/math/KaTeX.tsx

@@ -34,7 +34,6 @@ export default function KaTeX({ latex, displayMode = false }: KaTeXProps) {
   return (
     <Wrapper
       // KaTeX output is generated by our own render call (trusted-safe).
-      // eslint-disable-next-line react/no-danger
       dangerouslySetInnerHTML={{ __html: html }}
     />
   );

src/app/components/message/content/PollContent.tsx

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import React, { KeyboardEvent, useCallback, useEffect, useMemo, useState } from 'react';
 import { Box, Chip, color, config, Icon, Icons, Text, toRem } from 'folds';
 import { RelationsEvent } from 'matrix-js-sdk/lib/models/relations';

src/app/features/common-settings/developer-tools/DevelopTools.tsx

@@ -58,7 +58,6 @@ export function DeveloperTools({ requestClose }: DeveloperToolsProps) {
 
   const submitAccountData: AccountDataSubmitCallback = useCallback(
     async (type, content) => {
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       await mx.setRoomAccountData(room.roomId, type as any, content);
     },
     [mx, room.roomId],

src/app/features/common-settings/general/RoomQuality.tsx

@@ -55,7 +55,6 @@ export function RoomQuality({ permissions }: RoomQualityProps) {
   const [submitState, submit] = useAsyncCallback(
     useCallback(
       async (next: RoomQualityContent) => {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         await sendStateEvent(mx, room.roomId, StateEvent.LotusRoomQuality, next);
       },
       [mx, room.roomId],

src/app/features/common-settings/general/RoomRetention.tsx

@@ -31,7 +31,6 @@ export function RoomRetention({ permissions }: RoomRetentionProps) {
         const content: RetentionContent = ms > 0 ? { max_lifetime: ms } : {};
         // Lotus custom-state convention: cast the type key (RoomRetention isn't a
         // typed key in the SDK's StateEvents map).
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         await sendStateEvent(mx, room.roomId, StateEvent.RoomRetention, content);
       },
       [mx, room.roomId],

src/app/features/message-search/useLocalMessageSearch.ts

@@ -46,7 +46,6 @@ const extractText = (event: MatrixEvent): ExtractedText | null => {
   const content = event.getContent();
 
   if (POLL_START_TYPES.includes(evType)) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const poll = (content['m.poll'] ?? content['org.matrix.msc3381.poll.start']) as any;
     if (!poll) return null;
     const qBody =
@@ -57,7 +56,6 @@ const extractText = (event: MatrixEvent): ExtractedText | null => {
       .map(
         (a) =>
           ((a['m.text'] as Array<{ body: string }> | undefined)?.[0]?.body ??
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             (a['org.matrix.msc3381.poll.answer'] as any)?.body ??
             '') as string,
       )
@@ -104,7 +102,6 @@ const rowToResultItem = (row: SearchCacheRow): ResultItem => {
   };
   return {
     rank: 0,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     event: syntheticEvent as any,
     context: { events_before: [], events_after: [], profile_info: {} },
   };
@@ -227,7 +224,6 @@ export const useLocalMessageSearch = () => {
           };
           memoryItems.push({
             rank: 0,
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             event: syntheticEvent as any,
             context: { events_before: [], events_after: [], profile_info: {} },
           });

src/app/features/message-search/useMessageSearch.ts

@@ -146,7 +146,6 @@ export const useMessageSearch = (params: MessageSearchParams) => {
               ...(fromTs !== undefined && { from_ts: fromTs }),
               ...(toTs !== undefined && { to_ts: toTs }),
               ...(containsUrl !== undefined && { contains_url: containsUrl }),
-              // eslint-disable-next-line @typescript-eslint/no-explicit-any
             } as any,
             include_state: false,
             order_by: order as SearchOrderBy.Recent,

src/app/features/room-settings/RoomServerACL.tsx

@@ -341,7 +341,6 @@ export function RoomServerACL({ requestClose }: RoomServerACLProps) {
                       variant="Primary"
                     />
                     <Box direction="Column" gap="0">
-                      {/* eslint-disable-next-line jsx-a11y/label-has-associated-control */}
                       <label
                         htmlFor="allow-ip-literals"
                         style={{ cursor: canEdit ? 'pointer' : 'default' }}

src/app/features/room/message/ForwardMessageDialog.tsx

@@ -318,7 +318,6 @@ export function ForwardMessageDialog({ mEvent, onClose }: Props) {
     const results = await Promise.allSettled(
       ids.map((id) => {
         // threadId-aware overload (P3-8): explicit null = send to the main timeline.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const sendForward = () => mx.sendEvent(id, null, mEvent.getType() as any, fwdContent);
         // Send the optional comment first so it reads as a note above the
         // forwarded content. The room counts as failed if either send rejects.
@@ -327,7 +326,6 @@ export function ForwardMessageDialog({ mEvent, onClose }: Props) {
         const needsComment = commentBody && !commentSentRef.current.has(id);
         const step = needsComment
           ? mx
-              // eslint-disable-next-line @typescript-eslint/no-explicit-any
               .sendMessage(id, null, { msgtype: MsgType.Text, body: commentBody } as any)
               .then(() => {
                 commentSentRef.current.add(id);

src/app/features/room/message/Message.tsx

@@ -1390,7 +1390,6 @@ export const Message = React.memo(
                                   after={<Icon size="100" src={Icons.Send} />}
                                   radii="300"
                                   onClick={() => {
-                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                                     (mx as any).resendEvent(mEvent, room);
                                     closeMenu();
                                   }}
@@ -1409,7 +1408,6 @@ export const Message = React.memo(
                                   after={<Icon size="100" src={Icons.Cross} />}
                                   radii="300"
                                   onClick={() => {
-                                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
                                     (mx as any).cancelPendingEvent(mEvent);
                                     closeMenu();
                                   }}

src/app/features/room/message/MessageEditor.tsx

@@ -187,7 +187,6 @@ export const MessageEditor = as<'div', MessageEditorProps>(
               rel_type: RelationType.Replace,
             },
           };
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
           return mx.sendMessage(roomId, content as any);
         }
 
@@ -236,7 +235,6 @@ export const MessageEditor = as<'div', MessageEditorProps>(
           },
         };
 
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return mx.sendMessage(roomId, content as any);
       }, [
         mx,

src/app/features/room/thread/ThreadTimeline.tsx

@@ -564,7 +564,6 @@ export function ThreadTimeline({ room, thread, editor }: ThreadTimelineProps) {
       mx.sendEvent(
         room.roomId,
         thread.id,
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         MessageEvent.Reaction as any,
         getReactionContent(targetEventId, key, rShortcode),
       );

src/app/features/room/widgets/RoomWidgetView.tsx

@@ -60,7 +60,6 @@ export function RoomWidgetView({ room, widget }: RoomWidgetViewProps) {
       clientApi.stop();
       iframe.remove();
     };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [mx, room.roomId, widget.id, widget.templateUrl]);
 
   if (blocked) {

src/app/features/room/widgets/WidgetsPanel.tsx

@@ -84,7 +84,6 @@ export function WidgetsPanel({ room, requestClose }: WidgetsPanelProps) {
       data: {},
     };
     try {
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       await sendStateEvent(mx, room.roomId, StateEvent.Widget, content, id);
       setAdding(false);
     } catch (e) {
@@ -96,7 +95,6 @@ export function WidgetsPanel({ room, requestClose }: WidgetsPanelProps) {
 
   const handleRemove = (id: string) => {
     if (viewingId === id) setViewingId(null);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     sendStateEvent(mx, room.roomId, StateEvent.Widget, {}, id).catch(() => undefined);
   };
 

src/app/hooks/useRoomMeta.ts

@@ -44,13 +44,7 @@ export function getLocalRoomNamesContent(
   mx: ReturnType<typeof useMatrixClient>,
 ): LocalRoomNamesContent {
   const raw: unknown = getAccountData<unknown>(mx, LOCAL_ROOM_NAMES_KEY);
-  if (
-    raw &&
-    typeof raw === 'object' &&
-    'rooms' in raw &&
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    typeof (raw as any).rooms === 'object'
-  ) {
+  if (raw && typeof raw === 'object' && 'rooms' in raw && typeof (raw as any).rooms === 'object') {
     return raw as LocalRoomNamesContent;
   }
   return { rooms: {} };

src/app/pages/client/ClientNonUIFeatures.tsx

@@ -70,12 +70,12 @@ import {
   THREAD_NOTIFICATIONS_FALLBACK_BEHAVIOR,
 } from '../../utils/threadNotifications';
 
-// Grace period after the initial sync settles before invite notifications arm, so
-// the async invite-atom population lands first and isn't mistaken for new invites.
 const LogoSVG = withOriginBaseUrl(getOriginBaseUrl(), '/public/res/lotus.png');
 const LogoUnreadSVG = withOriginBaseUrl(getOriginBaseUrl(), '/public/res/lotus-unread.png');
 const LogoHighlightSVG = withOriginBaseUrl(getOriginBaseUrl(), '/public/res/lotus-highlight.png');
 
+// Grace period after the initial sync settles before invite notifications arm, so
+// the async invite-atom population lands first and isn't mistaken for new invites.
 const INVITE_NOTIFY_ARM_DELAY_MS = 3000;
 
 function SystemEmojiFeature() {

src/app/state/room/markedUnread.ts

@@ -25,10 +25,8 @@ export const setMarkedUnread = (
   unread: boolean,
 ): Promise<unknown> =>
   Promise.all([
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     mx.setRoomAccountData(roomId, AccountDataEvent.MarkedUnread as any, { unread }),
     // Best-effort mirror for older servers; never fail the primary write on it.
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     mx.setRoomAccountData(roomId, UNSTABLE_MARKED_UNREAD as any, { unread }).catch(() => undefined),
   ]);
 

src/app/utils/accountData.ts

@@ -13,7 +13,6 @@ export function getAccountData<T>(
   mx: MatrixClient,
   eventType: AccountDataEvent | string,
 ): T | undefined {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const event = (mx as any).getAccountData(eventType) as MatrixEvent | undefined;
   return event?.getContent() as T | undefined;
 }
@@ -23,6 +22,5 @@ export function setAccountData<T>(
   eventType: AccountDataEvent | string,
   content: T,
 ): Promise<void> {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   return (mx as any).setAccountData(eventType, content);
 }

src/app/utils/denoisePipeline.ts

@@ -70,7 +70,6 @@ export async function buildModelNode(
   model: DenoiseModelId,
 ): Promise<DenoiseNode> {
   if (model === 'dtln') {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const mod: any = await import(/* @vite-ignore */ `${BASE}workadventure/audio-worklet.js`);
     const handle = await mod.createNoiseSuppressionAudioWorklet(ctx, { bypassUntilReady: true });
     return { node: handle.node, dispose: () => handle.dispose() };
@@ -81,7 +80,6 @@ export async function buildModelNode(
     // deepfilternet/v2/... Override its cdnUrl to our absolute base so nothing
     // hits the upstream CDN. DeepFilterNet3Core builds the worklet node directly.
     const dfnBase = new URL(`${BASE}deepfilternet`, window.location.href).href;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const mod: any = await import(/* @vite-ignore */ `${BASE}deepfilternet/index.esm.js`);
     const core = new mod.DeepFilterNet3Core({
       sampleRate: sampleRateFor(model),

src/app/utils/keyboard.test.ts

@@ -44,12 +44,10 @@ test('onTabPress fires only on Tab', () => {
 
 test('preventScrollWithArrowKey prevents default only on arrows', () => {
   const up = evt('ArrowUp', 38);
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   preventScrollWithArrowKey(up as any);
   assert.equal(up.prevented, true);
 
   const a = evt('a', 65);
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   preventScrollWithArrowKey(a as any);
   assert.equal(a.prevented, false);
 });
@@ -95,14 +93,12 @@ test('stopPropagation: stops unless an editable element is focused', () => {
   // nothing focused → stops, returns true
   withActive(null);
   let k = makeKeyEvt();
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   assert.equal(stopPropagation(k.ev as any), true);
   assert.equal(k.wasStopped(), true);
 
   // input focused → does not stop, returns false
   withActive({ nodeName: 'INPUT', getAttribute: () => null });
   k = makeKeyEvt();
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   assert.equal(stopPropagation(k.ev as any), false);
   assert.equal(k.wasStopped(), false);
 
@@ -112,6 +108,5 @@ test('stopPropagation: stops unless an editable element is focused', () => {
     getAttribute: (a: string) => (a === 'contenteditable' ? 'true' : null),
   });
   k = makeKeyEvt();
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   assert.equal(stopPropagation(k.ev as any), false);
 });

src/app/utils/matrix.declineInvite.test.ts

@@ -22,7 +22,6 @@ const makeMx = (
       if (opts.forgetRejects) throw new Error('forget failed');
       return {};
     },
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
   } as any;
   return { mx, calls };
 };

src/app/utils/poll.ts

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { M_POLL_KIND_DISCLOSED } from 'matrix-js-sdk';
 
 // Pure helpers for poll display. matrix-js-sdk 41.7.0's PollStartEvent /

src/app/utils/room.ts

@@ -58,7 +58,6 @@ export function sendStateEvent<T extends object>(
   content: T,
   stateKey = '',
 ): Promise<ISendEventResponse> {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   return mx.sendStateEvent(roomId, eventType as any, content, stateKey);
 }
 

src/index.tsx

@@ -22,18 +22,40 @@ document.body.classList.add(configClass, varsClass);
 
 // Register Service Worker
 if ('serviceWorker' in navigator) {
-  const swUrl =
-    import.meta.env.MODE === 'production'
-      ? `${trimTrailingSlash(import.meta.env.BASE_URL)}/sw.js`
-      : `/dev-sw.js?dev-sw`;
+  const isProduction = import.meta.env.PROD;
+  const swUrl = isProduction
+    ? `${trimTrailingSlash(import.meta.env.BASE_URL)}/sw.js`
+    : `/dev-sw.js?dev-sw`;
 
   const sendSessionToSW = () => {
     const session = getFallbackSession();
     pushSessionToSW(session?.baseUrl, session?.accessToken);
   };
 
-  navigator.serviceWorker.register(swUrl).then(sendSessionToSW);
-  navigator.serviceWorker.ready.then(sendSessionToSW);
+  const registerServiceWorker = async () => {
+    try {
+      const registration = await navigator.serviceWorker.register(
+        swUrl,
+        isProduction
+          ? undefined
+          : {
+              type: 'module',
+              scope: '/',
+            },
+      );
+
+      sendSessionToSW();
+
+      await navigator.serviceWorker.ready;
+      sendSessionToSW();
+
+      console.info('Service worker registered:', registration.scope);
+    } catch (error) {
+      console.error('Service worker registration failed:', error);
+    }
+  };
+
+  registerServiceWorker();
 
   navigator.serviceWorker.addEventListener('message', (ev) => {
     const { type } = ev.data ?? {};

src/lotus-terminal.css.ts

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { globalStyle, keyframes, style } from '@vanilla-extract/css';
 
 const glitch1 = keyframes({

vite.config.js

@@ -246,7 +246,7 @@ const vendorChunks = (id) => {
 
 export default defineConfig({
   appType: 'spa',
-  publicDir: false,
+  publicDir: './public/res',
   base: buildConfig.base,
   server: {
     port: 8080,