[ { "path": ".agents/settings.local.json", "content": "{\n \"permissions\": {\n \"allow\": [\n \"Bash(gh pr view:*)\",\n \"Bash(pnpm bump:*)\",\n \"Bash(git add:*)\",\n \"Bash(git commit:*)\",\n \"Bash(ls:*)\",\n \"Bash(npx:*)\",\n \"Bash(git stash:*)\",\n \"Bash(git show:*)\",\n \"Bash(git -C /Users/diygod/Code/Projects/Folo status --short)\",\n \"Bash(git -C /Users/diygod/Code/Projects/Folo add apps/mobile/changelog/next.md)\",\n \"Bash(git -C /Users/diygod/Code/Projects/Folo commit:*)\",\n \"Bash(git checkout:*)\",\n \"Bash(git fetch:*)\",\n \"Bash(git merge:*)\",\n \"Bash(git rm:*)\",\n \"Bash(git push:*)\",\n \"Bash(gh api:*)\",\n \"Bash(pnpm exec vv:*)\"\n ]\n }\n}\n" }, { "path": ".agents/skills/desktop-release/SKILL.md", "content": "---\nname: desktop-release\ndescription: Perform a regular desktop release from the dev branch. Gathers commits since last release, updates changelog, evaluates mainHash changes, bumps version, and creates release PR.\ndisable-model-invocation: true\nallowed-tools: Bash, Read, Write, Edit, Glob, Grep\n---\n\n# Desktop Regular Release\n\nPerform a regular desktop release. This skill handles the full release workflow from the `dev` branch.\n\n## Pre-flight checks\n\n1. Confirm the current branch is `dev`. If not, abort with a warning.\n2. Run `git pull --rebase` in the repo root to ensure the local branch is up to date.\n3. Read `apps/desktop/package.json` to get the current `version` and `mainHash`.\n\n## Step 1: Gather changes since last release\n\n1. Find the last release tag:\n ```bash\n git tag --sort=-creatordate | grep '^desktop/v' | head -1\n ```\n2. Get all commits since that tag on the current branch:\n ```bash\n git log ..HEAD --oneline --no-merges\n ```\n3. Categorize commits into:\n - **Shiny new things** (feat: commits, new features)\n - **Improvements** (refactor:, perf:, chore: improvements, dependency updates)\n - **No longer broken** (fix: commits, bug fixes)\n - **Thanks** (identify external contributor GitHub usernames from commits)\n\n## Step 2: Update changelog\n\n1. Read `apps/desktop/changelog/next.md`.\n2. Present the categorized changes to the user and draft the changelog content.\n3. Wait for user confirmation or edits before writing.\n4. Write the final content to `apps/desktop/changelog/next.md`, following the template format:\n\n ```markdown\n # What's new in vNEXT_VERSION\n\n ## Shiny new things\n\n - description of new feature\n\n ## Improvements\n\n - description of improvement\n\n ## No longer broken\n\n - description of fix\n\n ## Thanks\n\n Special thanks to volunteer contributors @username for their valuable contributions\n ```\n\n5. Keep `NEXT_VERSION` as the placeholder - it will be replaced by `apply-changelog.ts` during bump.\n\n## Step 3: Commit changelog updates before bump\n\n`nbump` requires a clean working tree. Commit changelog edits before running bump.\n\n1. Stage the changelog update:\n ```bash\n git add apps/desktop/changelog/next.md\n ```\n2. Commit it on `dev`:\n ```bash\n git commit -m \"docs(desktop): prepare release changelog\"\n ```\n3. If there are no changes to commit, continue without creating an extra commit.\n\n## Step 4: Evaluate mainHash\n\nThis is critical for determining whether users need a full app update or can use the lightweight renderer hot update.\n\n1. Check what files changed in `apps/desktop/layer/main/` since the last release tag:\n ```bash\n git diff ..HEAD --name-only -- apps/desktop/layer/main/\n ```\n2. Also check changes to `apps/desktop/package.json` fields other than version/mainHash (since package.json is included in the hash calculation):\n ```bash\n git diff ..HEAD -- apps/desktop/package.json\n ```\n\n**Decision logic:**\n\n- If there are **NO changes** in `layer/main/` and no meaningful `package.json` changes (only version/mainHash/changelog-related), then mainHash should NOT be updated. Users will get a fast renderer-only hot update.\n- If there are **trivial changes** in `layer/main/` (typo fixes, comment changes, logging tweaks) that don't affect runtime behavior, recommend NOT updating mainHash. Present the changes to the user and ask for confirmation.\n- If there are **meaningful changes** in `layer/main/` (new features, bug fixes, dependency changes, API changes), mainHash MUST be updated. Users will need a full app update.\n\nPresent your analysis to the user with:\n\n- List of changed files in `layer/main/`\n- A summary of what changed\n- Your recommendation (update or skip mainHash)\n- Ask for explicit confirmation\n\n## Step 5: Save old mainHash and execute bump\n\n1. Save the current mainHash from `apps/desktop/package.json` for later comparison.\n2. Verify working tree is clean before bump:\n ```bash\n git status --short\n ```\n3. Change directory to `apps/desktop/` and run the bump:\n ```bash\n cd apps/desktop && pnpm bump\n ```\n4. This command will:\n - Pull latest changes\n - Apply changelog (rename next.md to {version}.md, create new next.md)\n - Recalculate mainHash and write to package.json\n - Format package.json\n - Bump minor version\n - Commit with message `release(desktop): release v{NEW_VERSION}`\n - Create branch `release/desktop/{NEW_VERSION}`\n - Push branch and create PR to `main`\n\n## Step 6: Restore mainHash if skipping update\n\nIf Step 4 decided mainHash should NOT be updated, restore the old value now. The bump has already committed, pushed, and created the PR on a new release branch, so we amend the commit and force push. This is safe because the release branch was just created.\n\n1. Change back to the repo root first (Step 5 left the working directory at `apps/desktop/`):\n ```bash\n cd ../..\n ```\n2. Ensure you are on the `release/desktop/{NEW_VERSION}` branch (bump should have switched to it).\n3. Replace the recalculated mainHash with the saved old value in `apps/desktop/package.json`.\n4. Stage and amend the release commit:\n ```bash\n git add apps/desktop/package.json && git commit --amend --no-edit\n ```\n5. Force push the release branch:\n ```bash\n git push --force origin release/desktop/{NEW_VERSION}\n ```\n\nIf Step 4 decided mainHash SHOULD be updated, skip this step entirely — the bump already wrote the correct new value.\n\n## Step 7: Verify\n\n1. Confirm the PR was created successfully by checking the output.\n2. Report the new version number and PR URL to the user.\n3. Summarize:\n - New version: v{NEW_VERSION}\n - mainHash updated: yes/no (and why)\n - Changelog highlights\n - PR URL\n\n## Reference\n\n- Bump config: `apps/desktop/bump.config.ts`\n- Changelog dir: `apps/desktop/changelog/`\n- Changelog template: `apps/desktop/changelog/next.template.md`\n- mainHash generator: `apps/desktop/plugins/vite/generate-main-hash.ts`\n- Hot updater logic: `apps/desktop/layer/main/src/updater/hot-updater.ts`\n- CI build workflow: `.github/workflows/build-desktop.yml`\n- Tag workflow: `.github/workflows/tag.yml`\n" }, { "path": ".agents/skills/installing-mobile-preview-builds/SKILL.md", "content": "---\nname: installing-mobile-preview-builds\ndescription: Builds and installs the iOS preview build for apps/mobile using EAS local build and devicectl. Use when the user asks to install a preview/internal iOS build on a connected iPhone for production-like testing.\ndisable-model-invocation: true\nallowed-tools: Bash, Read, Glob, Grep\nargument-hint: \"[device-udid-or-name(optional)]\"\n---\n\n# Install Mobile Preview Build (iOS)\n\nUse this skill to create a fresh local `preview` iOS build and install it on a connected iPhone.\n\n## Inputs\n\n- Optional `$ARGUMENTS`: device identifier (UDID or exact device name).\n- If no argument is provided, auto-select the first paired iPhone from `xcrun devicectl list devices`.\n\n## Workflow\n\n1. Validate repo and tooling.\n - Run from repo root and ensure `apps/mobile` exists.\n - Verify `pnpm`, `xcrun`, `xcodebuild`, and `eas-cli` are available.\n - Verify EAS login:\n ```bash\n cd apps/mobile\n pnpm dlx eas-cli whoami\n ```\n2. Resolve target device.\n - List paired devices:\n ```bash\n xcrun devicectl list devices\n ```\n - Choose device in this order:\n - `$ARGUMENTS` if provided and matches exactly one device.\n - Otherwise, first paired iPhone.\n3. Trigger local `preview` iOS build.\n\n ```bash\n mkdir -p .context/preview-install\n cd apps/mobile\n pnpm dlx eas-cli build -p ios --profile preview --non-interactive --local --output=./build-preview.ipa\n cd ../..\n cp apps/mobile/build-preview.ipa .context/preview-install/folo-preview.ipa\n ```\n\n4. Install to device locally.\n ```bash\n unzip -q -o .context/preview-install/folo-preview.ipa -d .context/preview-install/unpacked\n APP_PATH=$(find .context/preview-install/unpacked/Payload -maxdepth 1 -name '*.app' -type d | head -n 1)\n xcrun devicectl device install app --device \"\" \"$APP_PATH\"\n ```\n5. Try launching app.\n\n ```bash\n xcrun devicectl device process launch --device \"\" is.follow --activate\n ```\n\n - If launch fails due to locked device, instruct the user to unlock iPhone and open `Folo` manually.\n\n## Failure Handling\n\n- If local build fails, report:\n - build mode (`local`)\n - failing command\n - key error message from command output\n- If app config fails with `Assets source directory not found ... /out/rn-web`, prebuild assets then retry once:\n ```bash\n pnpm --filter @follow/rn-micro-web-app build --outDir out/rn-web/html-renderer\n ```\n\n## Output Format\n\nAlways return:\n\n1. Build mode (`local`) and final status.\n2. Local IPA path.\n3. Target device identifier.\n4. Install result (`installed` or `failed`) and launch result.\n5. Next action for the user if manual action is required.\n" }, { "path": ".agents/skills/mobile-e2e/SKILL.md", "content": "---\nname: mobile-e2e\ndescription: Run apps/mobile Maestro end-to-end tests in this repo. Use when an agent needs to validate mobile auth flows on iOS Simulator or Android Emulator. Current maintained coverage is register, sign out, and sign in.\ndisable-model-invocation: true\nallowed-tools: Bash, Read, Write, Edit, Glob, Grep\n---\n\n# Mobile E2E\n\nRun the mobile Maestro tests for `apps/mobile`.\n\n## Files that matter\n\n- Runner: `apps/mobile/e2e/run-maestro.sh`\n- iOS auth flow: `apps/mobile/e2e/flows/ios/auth.yaml`\n- Android auth flow: `apps/mobile/e2e/flows/android/core.yaml`\n- Shared auth flows: `apps/mobile/e2e/flows/shared/*.yaml`\n- Artifacts: `apps/mobile/e2e/artifacts/`\n\n## Always do first\n\nFrom repo root:\n\n```bash\ncd apps/mobile\npnpm run e2e:doctor\npnpm run typecheck\n```\n\n## iOS\n\nUse a simulator `.app` build, not an Expo development client.\n\n### Preferred simulator\n\nPrefer the **latest installed iOS runtime** and a **latest-generation iPhone simulator**.\n\nWhen multiple simulators are available, bias toward the newest iPhone model on the newest installed iOS version.\n\n### Boot simulator\n\n```bash\nxcrun simctl boot \nxcrun simctl bootstatus -b\nopen -a Simulator --args -CurrentDeviceUDID \n```\n\n### App bundle\n\n`run-maestro.sh` can resolve the app bundle from one of these sources:\n\n- `MAESTRO_IOS_APP_PATH`\n- a local `build-*.tar.gz` in `apps/mobile`\n- an existing `DerivedData/.../Release-iphonesimulator/Folo.app`\n\nIf none of those exist, build one first.\n\n### Build simulator app when missing\n\nIf `Folo.app` is not available yet:\n\n```bash\ncd apps/mobile/ios\npod install\nxcodebuild -workspace Folo.xcworkspace \\\n -scheme Folo \\\n -configuration Release \\\n -sdk iphonesimulator \\\n -destination 'id=' \\\n build\n```\n\n### Apple Silicon simulator optimization\n\nWhen running on an Apple Silicon Mac and building only for the simulator used in the current run, prefer compiling only the active `arm64` simulator architecture:\n\n```bash\nxcodebuild ... \\\n ONLY_ACTIVE_ARCH=YES \\\n ARCHS=arm64\n```\n\nUse this optimization only for local self-test / e2e simulator builds tied to the current machine. Do not use it when you need a universal simulator app for other machines or when running on Intel Macs.\n\nExpected output pattern:\n\n```bash\n~/Library/Developer/Xcode/DerivedData/.../Build/Products/Release-iphonesimulator/Folo.app\n```\n\n### Run iOS auth flow\n\n```bash\ncd apps/mobile\nMAESTRO_IOS_DEVICE_ID= \\\nMAESTRO_IOS_APP_PATH= \\\npnpm run e2e:ios\n```\n\n## Android\n\nUse a **release APK**, not an Expo development build.\n\n### Java\n\nUse Android Studio bundled JBR:\n\n```bash\nexport JAVA_HOME=\"/Applications/Android Studio.app/Contents/jbr/Contents/Home\"\nexport PATH=\"$JAVA_HOME/bin:$PATH\"\n```\n\n### Android SDK\n\n```bash\nexport ANDROID_HOME=\"$HOME/Library/Android/sdk\"\nexport ANDROID_SDK_ROOT=\"$HOME/Library/Android/sdk\"\n```\n\nIf `apps/mobile/android/local.properties` is missing, create it with:\n\n```bash\necho \"sdk.dir=$HOME/Library/Android/sdk\" > apps/mobile/android/local.properties\n```\n\n### Build release APK\n\nIf `apps/mobile/android` does not exist locally, generate it first with Expo prebuild / run-android tooling.\n\nThen build the release APK:\n\n```bash\ncd apps/mobile/android\n./gradlew app:assembleRelease --console=plain\n```\n\nExpected APK path:\n\n```bash\napps/mobile/android/app/build/outputs/apk/release/app-release.apk\n```\n\n### Install to emulator\n\n```bash\nadb -s emulator-5554 install -r apps/mobile/android/app/build/outputs/apk/release/app-release.apk\n```\n\n### Run Android auth flow\n\nStart a booted emulator first, then:\n\n```bash\ncd apps/mobile\npnpm run e2e:android\n```\n\n## Result checks\n\nSuccessful auth validation means:\n\n- register flow finishes\n- sign-out reaches `login-screen`\n- login flow makes `login-screen` disappear\n\n## Debugging output\n\nInspect these folders after a run:\n\n```bash\napps/mobile/e2e/artifacts/ios/\napps/mobile/e2e/artifacts/android/\n```\n\nFor a one-off focused run, invoke Maestro directly against a single flow and a custom debug directory.\n" }, { "path": ".agents/skills/mobile-release/SKILL.md", "content": "---\nname: mobile-release\ndescription: Perform a regular mobile release from the dev branch. Gathers commits since last release, updates changelog, bumps version, updates iOS Info.plist, and creates release PR to mobile-main.\ndisable-model-invocation: true\nallowed-tools: Bash, Read, Write, Edit, Glob, Grep\n---\n\n# Mobile Regular Release\n\nPerform a regular mobile release. This skill handles the full release workflow from the `dev` branch.\n\n## Pre-flight checks\n\n1. Confirm the current branch is `dev`. If not, abort with a warning.\n2. Run `git pull --rebase` in the repo root to ensure the local branch is up to date.\n3. Read `apps/mobile/package.json` to get the current `version`.\n\n## Step 1: Gather changes since last release\n\n1. Find the last release tag (both old `mobile@` and new `mobile/v` prefixes exist):\n ```bash\n git tag --sort=-creatordate | grep -E '^mobile[@/]' | head -1\n ```\n2. If no tag found, find the last release commit by matching only the subject line:\n ```bash\n git log --format=\"%H %s\" | grep \"^[a-f0-9]* release(mobile): release v\" | head -1 | awk '{print $1}'\n ```\n3. Get all commits since the last release on the current branch:\n ```bash\n git log ..HEAD --oneline --no-merges\n ```\n4. Categorize commits into:\n - **Shiny new things** (feat: commits, new features)\n - **Improvements** (refactor:, perf:, chore: improvements, dependency updates)\n - **No longer broken** (fix: commits, bug fixes)\n - **Thanks** (identify external contributor GitHub usernames from commits)\n\n## Step 2: Update changelog\n\n1. Read `apps/mobile/changelog/next.md`.\n2. Present the categorized changes to the user and draft the changelog content.\n3. Wait for user confirmation or edits before writing.\n4. Write the final content to `apps/mobile/changelog/next.md`, following the template format:\n\n ```markdown\n # What's New in vNEXT_VERSION\n\n ## Shiny new things\n\n - description of new feature\n\n ## Improvements\n\n - description of improvement\n\n ## No longer broken\n\n - description of fix\n\n ## Thanks\n\n Special thanks to volunteer contributors @username for their valuable contributions\n ```\n\n5. Keep `NEXT_VERSION` as the placeholder - it will be replaced by `apply-changelog.ts` during bump.\n\n## Step 3: Commit changelog updates before bump\n\n`nbump` requires a clean working tree. Commit changelog edits before running bump.\n\n1. Stage the changelog update:\n ```bash\n git add apps/mobile/changelog/next.md\n ```\n2. Commit it on `dev`:\n ```bash\n git commit -m \"docs(mobile): prepare release changelog\"\n ```\n3. If there are no changes to commit, continue without creating an extra commit.\n\n## Step 4: Execute bump\n\n1. Verify working tree is clean before bump:\n ```bash\n git status --short\n ```\n2. Change directory to `apps/mobile/` and run the bump:\n ```bash\n cd apps/mobile && pnpm bump\n ```\n3. This is an interactive `nbump` command that prompts for version selection. It will:\n - Pull latest changes\n - Apply changelog (rename next.md to {version}.md, create new next.md from template)\n - Format package.json with eslint + prettier\n - Bump version in `package.json`\n - Update `ios/Folo/Info.plist`:\n - Set `CFBundleShortVersionString` to the new version\n - Increment `CFBundleVersion` (build number) by 1\n - Commit with message `release(mobile): release v{NEW_VERSION}`\n - Create branch `release/mobile/{NEW_VERSION}`\n - Push branch and create PR to `mobile-main`\n\n## Step 5: Verify\n\n1. Confirm the PR was created successfully by checking the output.\n2. Report the new version number and PR URL to the user.\n3. Summarize:\n - New version: v{NEW_VERSION}\n - Changelog highlights\n - PR URL\n\n## Post-release (manual steps, inform user)\n\nAfter the release PR is merged to `mobile-main`:\n\n1. **Trigger production builds** via GitHub Actions `workflow_dispatch`:\n - Go to \"Build iOS\" workflow, select `mobile-main` branch, profile = `production`\n - Go to \"Build Android\" workflow, select `mobile-main` branch, profile = `production`\n2. Production builds auto-submit to App Store (via `eas submit`) and Google Play (as draft).\n3. After submission, go to App Store Connect and Google Play Console to complete the review/release process.\n\n## Reference\n\n- Bump config: `apps/mobile/bump.config.ts`\n- Changelog dir: `apps/mobile/changelog/`\n- Changelog template: `apps/mobile/changelog/next.template.md`\n- Apply changelog script: `apps/mobile/scripts/apply-changelog.ts`\n- EAS config: `apps/mobile/eas.json`\n- App config: `apps/mobile/app.config.ts`\n- iOS Info.plist: `apps/mobile/ios/Folo/Info.plist`\n- CI build iOS: `.github/workflows/build-ios.yml`\n- CI build Android: `.github/workflows/build-android.yml`\n" }, { "path": ".agents/skills/mobile-self-test/SKILL.md", "content": "---\nname: mobile-self-test\ndescription: Self-test a mobile feature change or bug fix after implementation in `apps/mobile`. Use this whenever the user asks to verify a mobile change, run simulator acceptance, smoke-test a mobile PR, or provide screenshot proof for a mobile fix. This skill decides between prod vs local API mode, starts the local follow-server when needed, builds a release app, uses Maestro only to bootstrap registration for non-auth work, then switches to screenshot-driven visual validation and returns screenshot evidence.\ndisable-model-invocation: true\nallowed-tools: Bash, Read, Write, Edit, Glob, Grep\n---\n\n# Mobile Self Test\n\nValidate a mobile change after implementation.\n\nThis skill extends `../mobile-e2e/SKILL.md`. Read that skill first for the baseline doctor checks, iOS simulator boot rules, Java/Android SDK setup, and Maestro artifact conventions. Then apply the extra rules in this skill.\n\n## Files that matter\n\n- Reference skill: `../mobile-e2e/SKILL.md`\n- Runner: `apps/mobile/e2e/run-maestro.sh`\n- iOS register flow: `apps/mobile/e2e/flows/ios/register.yaml`\n- Android register flow: `apps/mobile/e2e/flows/android/register.yaml`\n- Shared auth flows: `apps/mobile/e2e/flows/shared/*.yaml`\n- Expo config: `apps/mobile/app.config.ts`\n- Build profiles: `apps/mobile/eas.json`\n- Mobile artifacts: `apps/mobile/e2e/artifacts/`\n- Local server repo: `/Users/diygod/Code/Projects/follow-server`\n\n## Default assumptions\n\n- Prefer **iOS simulator** unless the user explicitly asks for Android or the change is Android-specific.\n- Default to **prod API mode** when the user did not specify a mode.\n- Default to **local API mode** when the task also involves local server changes, backend debugging, or modified files in `/Users/diygod/Code/Projects/follow-server`.\n- Keep `EXPO_PUBLIC_E2E_LANGUAGE=en` unless the user explicitly wants another language. The existing Maestro flows assume English UI.\n\n## Simulator and emulator isolation\n\nThis section overrides the shared device-selection guidance from `../mobile-e2e/SKILL.md`.\n\nSelf-test runs must be isolated because other agents may be using simulators or emulators on the same machine.\n\n- Always create a dedicated temporary simulator or emulator for the current run.\n- Never reuse `booted`, an already-running simulator, or a generic Android serial such as `emulator-5554`.\n- Record the temporary device name and identifier immediately after creation, then use only that stored identifier for build, install, launch, screenshots, and Maestro.\n- Register cleanup before booting the device so the temporary simulator or emulator is deleted even if the test fails midway.\n- If cleanup fails, report the leftover device name and identifier in the final response.\n\n## Decide API mode first\n\nUse this decision order:\n\n1. If the user explicitly asks for `prod` or `local`, obey that.\n2. Otherwise, if the task depends on local backend changes or local server behavior, use `local`.\n3. Otherwise, use `prod`.\n\nMap the chosen mode into the release build:\n\n- `prod` mode: `EXPO_PUBLIC_E2E_ENV_PROFILE=prod`\n- `local` mode: `EXPO_PUBLIC_E2E_ENV_PROFILE=local`\n\nDo not silently reuse a build from the other mode. Rebuild the release app when switching between `prod` and `local`.\n\n## Always do first\n\nFrom repo root:\n\n```bash\ncd apps/mobile\npnpm run e2e:doctor\npnpm run typecheck\n```\n\nIf these fail, stop and report the blocker before attempting simulator work.\n\n## Local server mode\n\n`local` mode requires the local server to be available at `http://localhost:3000`.\n\nBefore starting anything, check whether it is already running. Do not start a duplicate server.\n\n```bash\nFOLLOW_SERVER_LOG=/tmp/follow-server-dev-core.log\n\nif pgrep -af \"pnpm dev:core\" >/dev/null 2>&1 || lsof -nP -iTCP:3000 -sTCP:LISTEN >/dev/null 2>&1; then\n echo \"follow-server already running\"\nelse\n (\n cd /Users/diygod/Code/Projects/follow-server\n nohup pnpm dev:core >\"$FOLLOW_SERVER_LOG\" 2>&1 &\n )\nfi\n\nfor _ in $(seq 1 60); do\n nc -z 127.0.0.1 3000 >/dev/null 2>&1 && break\n sleep 2\ndone\n\nnc -z 127.0.0.1 3000 >/dev/null 2>&1\n```\n\nIf the task depends on other local surfaces such as `http://localhost:2233`, call that out explicitly instead of pretending the mobile test fully covers it.\n\n## Release build profiles for self-test\n\nUse release-style builds so the test matches user-facing behavior.\n\n- iOS simulator builds: `PROFILE=e2e-ios-simulator`\n- Android emulator builds: `PROFILE=e2e-android`\n\nAlways pair those with the chosen API mode and language:\n\n```bash\nexport EXPO_PUBLIC_E2E_ENV_PROFILE=\nexport EXPO_PUBLIC_E2E_LANGUAGE=en\n```\n\n## iOS workflow\n\nDo not attach to an existing simulator from `../mobile-e2e/SKILL.md`. Create a dedicated temporary simulator for this run and keep using only its UDID.\n\n### Create a dedicated temporary simulator\n\nPick the latest available iOS runtime and a recent iPhone device type, then create a temporary simulator.\n\n```bash\nIOS_SIM_NAME=\"CodexSelfTest-$(date +%Y%m%d-%H%M%S)\"\nIOS_RUNTIME_ID=\"\"\nIOS_DEVICE_TYPE_ID=\"\"\n\nIOS_UDID=\"$(xcrun simctl create \"$IOS_SIM_NAME\" \"$IOS_DEVICE_TYPE_ID\" \"$IOS_RUNTIME_ID\")\"\n\ncleanup_ios_simulator() {\n xcrun simctl shutdown \"$IOS_UDID\" >/dev/null 2>&1 || true\n xcrun simctl delete \"$IOS_UDID\" >/dev/null 2>&1 || true\n}\n\ntrap cleanup_ios_simulator EXIT\n```\n\nDo not switch to another simulator after `IOS_UDID` is created.\n\n### Boot the dedicated simulator\n\n```bash\nxcrun simctl boot \"$IOS_UDID\"\nxcrun simctl bootstatus \"$IOS_UDID\" -b\nopen -a Simulator --args -CurrentDeviceUDID \"$IOS_UDID\"\n```\n\nIf other simulators are already booted, leave them alone and continue using only `IOS_UDID`.\n\n### Build release simulator app\n\n```bash\ncd apps/mobile/ios\npod install\n\nPROFILE=e2e-ios-simulator \\\nEXPO_PUBLIC_E2E_ENV_PROFILE= \\\nEXPO_PUBLIC_E2E_LANGUAGE=en \\\nxcodebuild -workspace Folo.xcworkspace \\\n -scheme Folo \\\n -configuration Release \\\n -sdk iphonesimulator \\\n -destination \"id=$IOS_UDID\" \\\n clean build\n```\n\nOn Apple Silicon Macs, when the build is only for the dedicated simulator created for the current self-test run, prefer compiling only the active `arm64` simulator architecture:\n\n```bash\nONLY_ACTIVE_ARCH=YES \\\nARCHS=arm64\n```\n\nDo not use that optimization when you need a universal simulator bundle for other machines or when the host Mac is Intel.\n\nExpected output pattern:\n\n```bash\n~/Library/Developer/Xcode/DerivedData/.../Build/Products/Release-iphonesimulator/Folo.app\n```\n\n### Install app on simulator\n\n```bash\nxcrun simctl install \"$IOS_UDID\" \nxcrun simctl launch \"$IOS_UDID\" is.follow\n```\n\n## Android workflow\n\nReuse the Java and Android SDK setup from `../mobile-e2e/SKILL.md`.\n\nDo not attach to a shared emulator. Create a dedicated temporary AVD for this run and keep using only its recorded serial.\n\n### Create a dedicated temporary AVD\n\nCreate a fresh AVD backed by an installed phone system image.\n\n```bash\nANDROID_AVD_NAME=\"codex-self-test-$(date +%Y%m%d-%H%M%S)\"\nANDROID_AVD_PACKAGE=\"\"\nANDROID_AVD_DEVICE=\"\"\n\navdmanager create avd -n \"$ANDROID_AVD_NAME\" -k \"$ANDROID_AVD_PACKAGE\" -d \"$ANDROID_AVD_DEVICE\" --force\n\nANDROID_EMULATOR_PORT=\"\"\nfor port in 5554 5556 5558 5560 5562 5564; do\n if ! lsof -nP -iTCP:$port >/dev/null 2>&1 && ! lsof -nP -iTCP:$((port + 1)) >/dev/null 2>&1; then\n ANDROID_EMULATOR_PORT=\"$port\"\n break\n fi\ndone\n\n[ -n \"$ANDROID_EMULATOR_PORT\" ] || {\n echo \"No free Android emulator port found\"\n exit 1\n}\n\nANDROID_DEVICE_ID=\"emulator-$ANDROID_EMULATOR_PORT\"\n\ncleanup_android_emulator() {\n adb -s \"$ANDROID_DEVICE_ID\" emu kill >/dev/null 2>&1 || true\n avdmanager delete avd -n \"$ANDROID_AVD_NAME\" >/dev/null 2>&1 || true\n}\n\ntrap cleanup_android_emulator EXIT\n```\n\n### Boot the dedicated emulator\n\n```bash\nemulator @\"$ANDROID_AVD_NAME\" -port \"$ANDROID_EMULATOR_PORT\" -no-snapshot -wipe-data &\nadb -s \"$ANDROID_DEVICE_ID\" wait-for-device\n```\n\nIf other emulators are already booted, ignore them and continue using only `ANDROID_DEVICE_ID`.\n\nIf `apps/mobile/android` does not exist locally, generate it first.\n\n```bash\ncd apps/mobile\npnpm expo prebuild android\n```\n\n### Build release APK\n\n```bash\ncd apps/mobile/android\n\nPROFILE=e2e-android \\\nEXPO_PUBLIC_E2E_ENV_PROFILE= \\\nEXPO_PUBLIC_E2E_LANGUAGE=en \\\n./gradlew clean app:assembleRelease --console=plain\n```\n\nExpected APK path:\n\n```bash\napps/mobile/android/app/build/outputs/apk/release/app-release.apk\n```\n\n### Install app on emulator\n\n```bash\nadb -s \"$ANDROID_DEVICE_ID\" install -r apps/mobile/android/app/build/outputs/apk/release/app-release.apk\nadb -s \"$ANDROID_DEVICE_ID\" shell monkey -p is.follow -c android.intent.category.LAUNCHER 1\n```\n\n## Cleanup is mandatory\n\nDelete the temporary simulator or emulator created for the run before returning control to the user.\n\n### iOS cleanup\n\n```bash\nxcrun simctl shutdown \"$IOS_UDID\" >/dev/null 2>&1 || true\nxcrun simctl delete \"$IOS_UDID\" >/dev/null 2>&1 || true\n```\n\n### Android cleanup\n\n```bash\nadb -s \"$ANDROID_DEVICE_ID\" emu kill >/dev/null 2>&1 || true\navdmanager delete avd -n \"$ANDROID_AVD_NAME\" >/dev/null 2>&1 || true\n```\n\nDo not leave temporary devices behind for other agents.\n\n## Choose the auth strategy\n\nThis is the core difference from `mobile-e2e`.\n\n### A. Change is **not** related to login or registration\n\nUse the existing automated **registration** flow first to bootstrap a clean logged-in account, then do the real verification visually.\n\nExamples:\n\n- timeline behavior\n- subscription management\n- onboarding content after auth\n- settings pages unrelated to sign-in state\n- player, reader, share, discover, profile editing\n\nGenerate a unique test account before running the flow:\n\n```bash\nexport E2E_PASSWORD='Password123!'\nexport E2E_EMAIL=\"folo-self-test-$(date +%Y%m%d%H%M%S)@example.com\"\n```\n\nFor non-auth iOS self-tests, bootstrap auth through the standard iOS runner mode after the app has been installed and launched once:\n\n```bash\ncd apps/mobile\npnpm run e2e:ios:bootstrap\n```\n\nThis bootstrap path is the default for `prod` and `local` self-tests. Only skip it when the feature under test is login, registration, sign-out, session restoration, or another auth-specific flow that must be validated visually end-to-end.\n\n#### iOS registration bootstrap\n\n```bash\ncd apps/mobile\nmaestro test --format junit --platform ios --device \"$IOS_UDID\" \\\n --debug-output e2e/artifacts/ios/register-bootstrap \\\n -e E2E_EMAIL=\"$E2E_EMAIL\" \\\n -e E2E_PASSWORD=\"$E2E_PASSWORD\" \\\n e2e/flows/ios/register.yaml\n```\n\n#### Android registration bootstrap\n\n```bash\ncd apps/mobile\nmaestro test --format junit --platform android --device \"$ANDROID_DEVICE_ID\" \\\n --debug-output e2e/artifacts/android/register-bootstrap \\\n -e E2E_EMAIL=\"$E2E_EMAIL\" \\\n -e E2E_PASSWORD=\"$E2E_PASSWORD\" \\\n e2e/flows/android/register.yaml\n```\n\nAfter registration succeeds, continue with screenshot-driven visual testing.\n\n### B. Change **is** related to login, registration, logout, session handling, auth validation, or onboarding gates\n\nDo **not** rely on the existing Maestro auth flows for the actual verification. Use a fully visual/manual run instead so the changed UX itself is what gets tested.\n\nExamples:\n\n- register screen changes\n- login screen changes\n- credential validation changes\n- auth toggle changes\n- logout behavior\n- auth/session restoration\n- onboarding shown or hidden based on auth state\n\nFor auth-related work:\n\n- create the test account manually through the UI if needed\n- use screenshots after every critical step\n- verify success and error states visually\n- keep a clean record of the exact screen sequence shown to the user\n\n## Screenshot-driven visual testing\n\nOnce the app is in the right state, drive the rest of the validation with the visual toolchain available in the current environment. Screenshots are the source of truth for acceptance.\n\nCreate a timestamped artifact folder first:\n\n```bash\nREPO_ROOT=\"$(git rev-parse --show-toplevel)\"\nARTIFACT_DIR=\"$REPO_ROOT/apps/mobile/e2e/artifacts/manual/$(date +%Y%m%d-%H%M%S)--\"\nmkdir -p \"$ARTIFACT_DIR\"\n```\n\nCapture screenshots after each meaningful checkpoint.\n\n### iOS screenshot command\n\n```bash\nxcrun simctl io \"$IOS_UDID\" screenshot \"$ARTIFACT_DIR/.png\"\n```\n\n### Android screenshot command\n\n```bash\nadb -s \"$ANDROID_DEVICE_ID\" exec-out screencap -p > \"$ARTIFACT_DIR/.png\"\n```\n\nMinimum screenshot set for a complete self-test:\n\n1. entry screen before the changed flow\n2. the changed screen or interaction in progress\n3. the final success state or the reproduced bug state\n\nAdd more screenshots when the flow has multiple important states.\n\nDo not report success without screenshot evidence.\n\n## What to validate visually\n\nUse the screenshots to confirm at least these points when relevant:\n\n- the correct screen is reached\n- the changed control, copy, or layout is visible\n- loading, empty, error, and success states look correct\n- the operation completes without obvious regressions or blocking dialogs\n- the app is talking to the intended environment (`prod` or `local`)\n\nIf the UI or behavior is ambiguous, capture another screenshot instead of guessing.\n\n## Final user-facing output\n\nThe final response must include:\n\n- API mode used and why it was chosen\n- platform and dedicated simulator/emulator name plus identifier used\n- cleanup result for the temporary simulator/emulator\n- whether the local server was reused or started, plus log path if started\n- build command used\n- whether auth bootstrap was automated or fully visual\n- concise step-by-step result summary\n- pass/fail conclusion\n- screenshot evidence with absolute file paths\n\nIf the client supports local image rendering, attach the key screenshots as images in the final message. Otherwise, list the absolute paths clearly so the user can open them.\n\n## Failure handling\n\n- If doctor, typecheck, build, install, or server startup fails, stop and report the exact failing command.\n- If `local` mode cannot reach the local server, do not silently fall back to `prod`.\n- If the visual flow cannot be completed because the environment lacks the required interaction tooling, report that limitation clearly and still return the screenshots you captured.\n" }, { "path": ".agents/skills/update-deps/SKILL.md", "content": "---\nname: update-deps\ndescription: Update all dependencies across frontend and backend projects. Reads changelogs for breaking changes, checks affected code, runs tests, and provides a summary. Use when updating npm dependencies across the monorepo.\ndisable-model-invocation: true\nallowed-tools: Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch, Task\n---\n\n# Update All Dependencies\n\nUpdate all npm dependencies across the frontend (current repo) and backend projects. This skill handles the full update workflow including changelog review, code impact analysis, testing, and summarization.\n\n## Step 0: Ask for backend directory\n\nAsk the user for the backend project directory path. Do NOT hardcode any path. Example prompt:\n\n> Please provide the backend project directory path (e.g., `/path/to/backend`).\n\nWait for the user's response before proceeding. Save the path as `BACKEND_DIR` for later use.\n\n## Step 1: Analyze current dependencies\n\n### Frontend (current repo)\n\n1. Run `pnpm outdated --recursive` in the current repo root to identify all outdated dependencies.\n2. Save the full output for later analysis.\n\n### Backend\n\n1. Run `pnpm outdated --recursive` in `BACKEND_DIR` to identify all outdated dependencies.\n2. Save the full output for later analysis.\n\nPresent the user with a summary of how many dependencies are outdated in each project.\n\n## Step 2: Update dependencies\n\n### Strategy\n\nUpdate in two phases to isolate issues:\n\n**Phase 1 — Patch and minor updates (safer):**\n\nFrom the `pnpm outdated` output, identify all dependencies where the update is a patch or minor version bump. Update them in batch:\n\n1. Frontend: For each patch/minor outdated package, run `pnpm update @latest --recursive` in the repo root.\n2. Backend: For each patch/minor outdated package, run `pnpm update @latest --recursive` in `BACKEND_DIR`.\n\n> **Why `@latest`?** Both projects use `save-exact=true`, so versions are pinned without `^` or `~`. Without `--latest`, `pnpm update` only resolves within the existing range, which for exact versions is a no-op.\n\n**Phase 2 — Major updates (requires careful review):**\n\nFor each dependency with a major version update available:\n\n1. Identify the dependency name, current version, and latest version.\n2. **Read the changelog** (Step 3) before updating.\n3. Only update after confirming no blocking breaking changes.\n4. Use `pnpm update @latest --recursive` to update specific packages.\n\n**Important pnpm workspace notes:**\n\n- The frontend project uses `pnpm catalog` in `pnpm-workspace.yaml` for some shared versions. If a dependency is managed via catalog, update the version in `pnpm-workspace.yaml` instead of individual `package.json` files.\n- Both projects use `save-exact=true`, so versions are pinned without `^` or `~`.\n- Check `patchedDependencies` in `pnpm-workspace.yaml` or `package.json` — if a patched dependency is being updated, verify the patch still applies or remove it if no longer needed.\n\n## Step 3: Review changelogs for major updates\n\nFor each dependency with a **major version update**, you MUST read the changelog before updating.\n\n### How to find changelogs\n\nUse these methods in order of preference:\n\n1. **npm registry**: Run `npm view repository.url` to find the repo, then check for `CHANGELOG.md` or GitHub releases.\n2. **GitHub releases**: Search `https://github.com///releases` using WebFetch.\n3. **Web search**: Use WebSearch to find ` changelog to `.\n\n### What to look for\n\n- **Breaking changes**: API removals, renamed exports, changed defaults, dropped Node.js version support.\n- **Deprecated features**: Features being removed in future versions.\n- **Migration guides**: Official upgrade instructions.\n- **Peer dependency changes**: New or changed peer dependency requirements.\n\n### Document findings\n\nFor each major update, record:\n\n- Package name and version change (e.g., `foo: 2.x → 3.x`)\n- Breaking changes summary\n- Whether our code is affected (and how)\n\n## Step 4: Check affected code\n\nFor each dependency with breaking changes identified in Step 3:\n\n1. Use `Grep` to find all imports and usages of the affected package across the relevant project (frontend or backend).\n2. Read the files containing usages.\n3. Compare the usage against the breaking change description.\n4. If our code uses an affected API:\n - Attempt to fix the code following the migration guide.\n - If the fix is complex or risky, **skip updating this dependency** and note it in the summary.\n5. If our code does NOT use any affected API, proceed with the update.\n\n## Step 5: Run tests and checks\n\nAfter all updates are applied:\n\n### Frontend\n\nRun these commands sequentially in the repo root and capture results:\n\n```bash\npnpm install\npnpm typecheck\npnpm test\npnpm lint\n```\n\n### Backend\n\nRun these commands sequentially in `BACKEND_DIR` and capture results:\n\n```bash\npnpm install\npnpm typecheck\npnpm test\npnpm lint\n```\n\n### Handle failures\n\n- **TypeScript errors**: Read the error output, identify which updated dependency caused the issue, and fix the type errors. If unfixable, revert that specific dependency update.\n- **Test failures**: Analyze the failure, check if it's related to a dependency update, and fix or revert.\n- **Lint errors**: Run `pnpm lint:fix` first. If issues persist, fix manually or revert the causing update.\n\nRepeat the test cycle until all checks pass.\n\n## Step 6: Summary\n\nPresent the user with a comprehensive summary:\n\n### Update report\n\n```\n## Dependencies Updated\n\n### Frontend\n- : → (patch/minor/major)\n- ...\n\n### Backend\n- : → (patch/minor/major)\n- ...\n\n## Skipped Updates (with reasons)\n- : \n- ...\n\n## Key Changelog Highlights\n\n### Breaking Changes Applied\n- : \n\n### Notable New Features\n- : \n\n### Deprecation Warnings\n- : \n\n## Test Results\n- Frontend typecheck: ✅/❌\n- Frontend tests: ✅/❌\n- Frontend lint: ✅/❌\n- Backend typecheck: ✅/❌\n- Backend tests: ✅/❌\n- Backend lint: ✅/❌\n```\n\nAsk the user if they want to commit the changes.\n" }, { "path": ".cursorignore", "content": "# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)\n" }, { "path": ".editorconfig", "content": "root = true\n\n[*]\ncharset = utf-8\nindent_style = space\nindent_size = 2\nend_of_line = lf\ninsert_final_newline = true\ntrim_trailing_whitespace = true\n" }, { "path": ".gitattributes", "content": "* text=auto eol=lf\n*.splinecode filter=lfs diff=lfs merge=lfs -text\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.yml", "content": "name: 🐞 Bug report\ndescription: Report an issue\nlabels: [pending triage, bug]\ntype: Bug\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to fill out this bug report!\n\n - type: dropdown\n id: platform\n attributes:\n label: Platform\n description: On which platforms does this bug occur?\n multiple: true\n options:\n - Desktop - macOS\n - Desktop - Windows\n - Desktop - Linux\n - Desktop - Web\n - Mobile - iOS\n - Mobile - Android\n - Mobile - Web\n validations:\n required: true\n\n - type: textarea\n id: bug-description\n attributes:\n label: Describe the bug\n description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us in the description. Thanks!\n placeholder: Bug description\n validations:\n required: true\n\n - type: input\n id: entryId\n attributes:\n label: Entry ID\n description: Please provide the entry id of the entry that is causing the issue. If you are not sure, please provide the entry url.\n\n - type: textarea\n id: relevant-information\n attributes:\n label: Relevant Information\n description: Please provide your user id, feed id, feed url, or any other information that can help us reproduce the issue.\n placeholder: User ID, Feed ID, Feed URL, etc.\n validations:\n required: false\n\n - type: textarea\n id: reproduction\n attributes:\n label: Reproduction Video\n description: If possible, please provide a video that demonstrates the bug.\n validations:\n required: false\n\n - type: textarea\n id: environment\n attributes:\n label: Environment\n description: Please provide the environment in which you are using the application. You can find this information by going to Preferences > About and clicking the copy button next to the version tag.\n\n - type: checkboxes\n id: checkboxes\n attributes:\n label: Validations\n description: Before submitting the issue, please make sure you do the following\n options:\n - label: Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.\n required: true\n - label: Check that this is a concrete bug. For Q&A, please open a GitHub Discussion instead.\n required: true\n - label: This issue is valid\n required: true\n\n - type: checkboxes\n id: contributions\n attributes:\n label: Contributions\n description: Please note that Open Source projects are maintained by volunteers, where your cases might not be always relevant to the others. It would make things move faster if you could help investigate and propose solutions.\n options:\n - label: I am willing to submit a PR to fix this issue\n - label: I am willing to submit a PR with failing tests (actually just go ahead and do it, thanks!)\n" }, { "path": ".github/ISSUE_TEMPLATE/config.yml", "content": "blank_issues_enabled: false\ncontact_links:\n - name: 💬 Follow's Discord Server\n url: https://discord.gg/tUDVZjEr\n about: Want to discuss / chat with the community? Here you go!\n - name: Discuss an issue\n url: https://github.com/RSSNext/Follow/discussions\n about: For general questions, ideas, or non-bug related discussions, please use GitHub Discussions.\n" }, { "path": ".github/ISSUE_TEMPLATE/feature_request.yml", "content": "name: 🚀 New feature proposal\ndescription: Propose a new feature\nlabels: [enhancement]\ntype: Feature\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for your interest in the project and taking the time to fill out this feature report!\n - type: textarea\n id: feature-description\n attributes:\n label: Clear and concise description of the problem\n description: \"As a developer using this project I want [goal / wish] so that [benefit]. If you intend to submit a PR for this issue, tell us in the description. Thanks!\"\n validations:\n required: true\n - type: textarea\n id: suggested-solution\n attributes:\n label: Suggested solution\n description: \"In module [xy] we could provide following implementation...\"\n validations:\n required: true\n - type: textarea\n id: alternative\n attributes:\n label: Alternative\n description: Clear and concise description of any alternative solutions or features you've considered.\n - type: textarea\n id: additional-context\n attributes:\n label: Additional context\n description: Any other context or screenshots about the feature request here.\n - type: checkboxes\n id: checkboxes\n attributes:\n label: Validations\n description: Before submitting the issue, please make sure you do the following\n options:\n - label: Check that there isn't already an issue that request the same feature to avoid creating a duplicate.\n required: true\n - label: This issue is valid\n required: true\n" }, { "path": ".github/ISSUE_TEMPLATE/i18n.yml", "content": "name: 🌐 Internationalization (i18n)\ndescription: Contribute to or report issues with translations\ntitle: \"[i18n]: \"\nlabels: [\"i18n\", \"triage\"]\nbody:\n - type: markdown\n attributes:\n value: |\n Thanks for taking the time to contribute to our internationalization efforts!\n\n Before proceeding, please check our [i18n Contribution Guidelines](https://github.com/RSSNext/Follow/blob/dev/wiki/contribute-i18n.md) for detailed instructions.\n - type: dropdown\n id: type\n attributes:\n label: Type of i18n contribution\n options:\n - New language support\n - Update existing translations\n - Report incorrect translation\n - Other i18n-related issue\n validations:\n required: true\n - type: input\n id: language\n attributes:\n label: Language\n description: What language are you contributing to or reporting about?\n placeholder: e.g., Spanish, French, Japanese\n validations:\n required: true\n - type: textarea\n id: description\n attributes:\n label: Description\n description: Please provide details about your contribution or the issue you're reporting.\n placeholder: |\n For new languages: List any specific challenges or considerations.\n For updates: Describe what you're changing and why.\n For issues: Provide the incorrect translation and suggest a correction.\n validations:\n required: true\n - type: textarea\n id: additional-context\n attributes:\n label: Additional context\n description: Add any other context, screenshots, or file references here.\n - type: checkboxes\n id: terms\n attributes:\n label: Code of Conduct\n description: By submitting this issue, you agree to follow our [Code of Conduct](https://example.com/code-of-conduct)\n options:\n - label: I agree to follow this project's Code of Conduct\n required: true\n - label: This issue is valid\n required: true\n" }, { "path": ".github/ISSUE_TEMPLATE/typo.yml", "content": "name: 👀 Typo / Grammar fix\ndescription: You can just go ahead and send a PR! Thank you!\nlabels: []\nbody:\n - type: markdown\n attributes:\n value: |\n ## PR Welcome!\n\n If the typo / grammar issue is trivial and straightforward, you can help by **directly sending a quick pull request**!\n If you spot multiple of them, we suggest combining them into a single PR. Thanks!\n - type: textarea\n id: context\n attributes:\n label: Additional context\n - type: checkboxes\n id: checkboxes\n attributes:\n label: Validations\n description: Before submitting the issue, please make sure you do the following\n options:\n - label: This issue is valid\n required: true\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "\n\n### Description\n\n\n\n### PR Type\n\n\n\n- [ ] Feature\n- [ ] Bugfix\n- [ ] Hotfix\n- [ ] Other (please describe):\n\n### Screenshots (if UI change)\n\n### Demo Video (if new feature)\n\n### Linked Issues\n\n### Additional context\n\n\n\n### Changelog\n\n\n\n- [ ] I have updated the changelog/next.md with my changes.\n" }, { "path": ".github/actions/setup-version/action.yml", "content": "name: Setup Version\ndescription: \"Setup Version\"\ninputs:\n type:\n required: true\n description: \"Type of the app, either 'desktop' or 'mobile'\"\n default: \"desktop\"\noutputs:\n APP_VERSION:\n description: \"App Version\"\n value: ${{ steps.version.outputs.APP_VERSION }}\nruns:\n using: \"composite\"\n steps:\n - name: \"Write Version\"\n id: version\n shell: bash\n run: |\n if [ \"${{ github.ref_type }}\" == \"tag\" ]; then\n # Handle new tag format: desktop/v1.2.3 or mobile/v1.2.3\n if [[ \"${{ github.ref_name }}\" =~ ^(desktop|mobile)/v(.*)$ ]]; then\n APP_VERSION=\"${BASH_REMATCH[2]}\"\n else\n # Fallback for old format: v1.2.3\n APP_VERSION=$(echo \"${{ github.ref_name }}\" | sed 's/^v//')\n fi\n else\n if [ \"${{ inputs.type }}\" == \"desktop\" ]; then\n APP_VERSION=$(node -p \"require('./apps/desktop/package.json').version\")\n else\n APP_VERSION=$(node -p \"require('./apps/mobile/package.json').version\")\n fi\n fi\n echo $APP_VERSION\n echo \"APP_VERSION=$APP_VERSION\" >> \"$GITHUB_OUTPUT\"\n" }, { "path": ".github/actions/setup-xcode/action.yml", "content": "name: \"Setup Xcode\"\ndescription: \"Setup specific Xcode version for iOS builds\"\ninputs:\n xcode-version:\n description: \"Xcode version to use\"\n required: false\n default: \"26.0.1\"\n\nruns:\n using: \"composite\"\n steps:\n - uses: maxim-lobanov/setup-xcode@v1\n with:\n xcode-version: ${{ inputs.xcode-version }}\n\n - name: Setup Xcode Environment\n run: |\n set -e\n\n echo \"=== Checking CI Environment ===\"\n echo \"Current user: $(whoami)\"\n echo \"User groups: $(groups)\"\n echo \"Sudo available: $(sudo -n true 2>/dev/null && echo 'YES' || echo 'NO')\"\n echo \"Xcode path: $(xcode-select -p 2>/dev/null || echo 'Not set')\"\n\n # Set Xcode path and accept license\n echo \"=== Setting up Xcode ===\"\n if command -v sudo >/dev/null && sudo -n true 2>/dev/null; then\n sudo xcode-select -s /Applications/Xcode_${{ inputs.xcode-version }}.app/Contents/Developer\n sudo xcodebuild -license accept\n echo \"Using sudo for Xcode setup\"\n else\n xcode-select -s /Applications/Xcode_${{ inputs.xcode-version }}.app/Contents/Developer\n xcodebuild -license accept\n echo \"Using direct access for Xcode setup\"\n fi\n\n echo \"Final Xcode path: $(xcode-select -p)\"\n shell: bash\n\n - name: Start Simulator Service\n run: |\n echo \"=== Starting Simulator Service ===\"\n # Try to start simulator service (ignore errors if already running)\n sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.CoreSimulator.CoreSimulatorService.plist 2>/dev/null || {\n echo \"CoreSimulator service might already be running or command unavailable\"\n }\n\n # Alternative for newer macOS versions\n sudo launchctl bootstrap system /System/Library/LaunchDaemons/com.apple.CoreSimulator.CoreSimulatorService.plist 2>/dev/null || {\n echo \"Bootstrap command failed or service already running\"\n }\n\n # Wait a moment for service to start\n sleep 3\n shell: bash\n\n - name: Download iOS Platform\n run: |\n set -e\n\n echo \"=== Checking Available SDKs ===\"\n echo \"Currently available SDKs:\"\n xcodebuild -showsdks | grep -E \"(iOS|Simulator)\" || echo \"No iOS SDKs found yet\"\n\n echo \"=== Attempting iOS Platform Download ===\"\n\n # Method 1: Try standard download\n if xcodebuild -downloadPlatform iOS -quiet 2>/dev/null; then\n echo \"✅ iOS platform downloaded successfully with xcodebuild\"\n elif xcrun xcodebuild -downloadPlatform iOS -quiet 2>/dev/null; then\n echo \"✅ iOS platform downloaded successfully with xcrun xcodebuild\"\n else\n echo \"⚠️ Platform download failed, checking if iOS SDK is already available...\"\n\n # Check if iOS SDK is available\n if xcodebuild -showsdks | grep -q \"iOS\"; then\n echo \"✅ iOS SDK is already available, continuing...\"\n else\n echo \"❌ No iOS SDK found and download failed\"\n echo \"Available SDKs:\"\n xcodebuild -showsdks\n\n # Try alternative download method\n echo \"Trying alternative download method...\"\n xcodebuild -downloadAllPlatforms -quiet || {\n echo \"❌ All download methods failed\"\n exit 1\n }\n fi\n fi\n\n echo \"=== Final SDK Status ===\"\n echo \"Available iOS SDKs:\"\n xcodebuild -showsdks | grep -E \"(iOS|Simulator)\" || echo \"No iOS SDKs found\"\n\n echo \"Available simulators:\"\n xcrun simctl list devices available | head -20 || echo \"No simulators found\"\n shell: bash\n\n - name: Verify Setup\n run: |\n echo \"=== Verification ===\"\n echo \"Xcode version: $(xcodebuild -version | head -1)\"\n echo \"Selected Xcode: $(xcode-select -p)\"\n echo \"iOS SDK available: $(xcodebuild -showsdks | grep -c iOS || echo 0)\"\n\n # Test basic functionality\n if xcodebuild -showsdks | grep -q \"iOS\"; then\n echo \"✅ Setup completed successfully!\"\n else\n echo \"⚠️ Setup completed but iOS SDK may not be fully available\"\n fi\n shell: bash\n" }, { "path": ".github/advanced-issue-labeler.yml", "content": "policy:\n - section:\n - id: [platform]\n block-list: [\"None\", \"Other\"]\n label:\n - name: \"platform: desktop\"\n keys: [\"Desktop - macOS\", \"Desktop - Windows\", \"Desktop - Linux\", \"Desktop - Web\"]\n - name: \"platform: mobile\"\n keys: [\"Mobile - iOS\", \"Mobile - Android\", \"Mobile - Web\"]\n" }, { "path": ".github/copilot-instructions.md", "content": "Before you start, you need to read and follow the rules in @../CLAUDE.md\n" }, { "path": ".github/dependabot.yaml", "content": "version: 2\nupdates:\n - package-ecosystem: npm\n directory: /\n schedule:\n interval: weekly\n day: friday\n time: \"12:00\"\n timezone: Asia/Singapore\n target-branch: dev\n ignore:\n - dependency-name: \"@shopify/flash-list\"\n versions: [\">1.7.3\"]\n\n # Stuck by tailwindcss 4\n - dependency-name: tailwindcss\n versions: [\">=4.0.0\"]\n - dependency-name: daisyui\n versions: [\">=5.0.0\"]\n\n # Stuck by expo 52\n - dependency-name: react-native\n versions: [\">=0.78.0\"]\n\n # It's using export map and metro doesn't support it well\n - dependency-name: unist-util-visit-parents\n versions: [\">=6.0.0\"]\n # electron 35\n - dependency-name: electron\n versions: [\">=35.0.0\"]\n - dependency-name: react-native-sheet-transitions\n versions: [\">0.1.2\"]\n\n # filter not work\n - dependency-name: unplugin-ast\n versions: [\"0.14.5\"]\n\n open-pull-requests-limit: 100\n groups:\n minor-and-patch:\n applies-to: version-updates\n update-types:\n - \"minor\"\n - \"patch\"\n pathed:\n patterns:\n - immer\n - re-resizable\n - electron-context-menu\n - \"@mozilla/readability\"\n - daisyui\n - jsonpointer\n - workbox-precaching\n - \"@pengx17/electron-forge-maker-appimage\"\n - \"@microflash/remark-callout-directives\"\n - react-native-track-player\n - react-native-sheet-transitions\n\n - package-ecosystem: github-actions\n directory: /\n schedule:\n interval: daily\n target-branch: dev\n open-pull-requests-limit: 100\n" }, { "path": ".github/prompts/similar_issues.prompt.yml", "content": "messages:\n - role: system\n content: |-\n You are a GitHub assistant with access to GitHub Model Context Protocol (MCP)\n tools in read-only mode. Your task is to search this repository's issues to find\n previously filed issues similar to the provided issue title and body. Use the\n GitHub tools via MCP to perform the search and retrieve real issue data (do not\n fabricate results).\n\n Consider semantic similarity across title and body. Exclude\n issues with the same ID/number as the current issue. Return up to 3 of the most similar past issues. If none are\n reasonably similar, return an empty list. Output must follow the response schema\n exactly and include only data you actually retrieved from GitHub tools.\n The current GitHub repository is: \"{{repository}}\".\n - role: user\n content: |-\n Find similar issues for this new issue:\n Title: {{issue_title}}\n Body:\n {{issue_body}}\nmodel: openai/gpt-4.1-mini\nresponseFormat: json_schema\njsonSchema: |-\n {\n \"name\": \"similar_issues_result\",\n \"strict\": true,\n \"schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"matches\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"number\": { \"type\": \"integer\" },\n \"title\": { \"type\": \"string\" },\n \"url\": { \"type\": \"string\" },\n \"similarity_score\": { \"type\": \"number\", \"minimum\": 0, \"maximum\": 1 }\n },\n \"required\": [\"number\", \"title\", \"url\", \"similarity_score\"],\n \"additionalProperties\": false\n }\n }\n },\n \"required\": [\"matches\"],\n \"additionalProperties\": false\n }\n }\n" }, { "path": ".github/scripts/extract-release-info.mjs", "content": "#!/usr/bin/env node\n\n/**\n * Extract release version and platform information from git commit messages\n * Used by GitHub Actions to determine if a release tag should be created\n */\n\nimport { execSync } from \"node:child_process\"\nimport { appendFileSync } from \"node:fs\"\n\n// Configuration\nconst RELEASE_PATTERNS = {\n desktop: /release\\(desktop\\): Release (v\\d+\\.\\d+\\.\\d+(-[0-9A-Z-.]+)?)/i,\n mobile: /release\\(mobile\\): Release (v\\d+\\.\\d+\\.\\d+(-[0-9A-Z-.]+)?)/i,\n}\n\nconst EXIT_CODES = {\n SUCCESS: 0,\n GIT_ERROR: 2,\n ENV_ERROR: 3,\n OUTPUT_ERROR: 4,\n}\n\n/**\n * Write environment variable to GitHub Environment\n * @param {string} key - Environment variable key\n * @param {string} value - Environment variable value\n */\nfunction setGitHubEnv(key, value) {\n try {\n if (!process.env.GITHUB_ENV) {\n throw new Error(\"GITHUB_ENV not set - not running in GitHub Actions\")\n }\n appendFileSync(process.env.GITHUB_ENV, `${key}=${value}\\n`)\n } catch (error) {\n console.error(`Failed to set environment variable ${key}:`, error.message)\n process.exit(EXIT_CODES.ENV_ERROR)\n }\n}\n\n/**\n * Write output variable to GitHub Output\n * @param {string} key - Output key\n * @param {string} value - Output value\n */\nfunction setGitHubOutput(key, value) {\n try {\n if (!process.env.GITHUB_OUTPUT) {\n return\n }\n appendFileSync(process.env.GITHUB_OUTPUT, `${key}=${value}\\n`)\n } catch (error) {\n console.error(`Failed to set output variable ${key}:`, error.message)\n process.exit(EXIT_CODES.OUTPUT_ERROR)\n }\n}\n\n/**\n * Get the latest commit message\n * @returns {string} Latest commit message\n */\nfunction getLatestCommitMessage() {\n try {\n return execSync(\"git log -1 --pretty=%B\", { encoding: \"utf-8\" }).toString().trim()\n } catch (error) {\n console.error(\"Failed to get git commit message:\", error.message)\n process.exit(EXIT_CODES.GIT_ERROR)\n }\n}\n\n/**\n * Extract release information from commit message\n * @param {string} commitMessage - Git commit message\n * @returns {Object|null} Release information or null if no release found\n */\nfunction extractReleaseInfo(commitMessage) {\n for (const [platform, regex] of Object.entries(RELEASE_PATTERNS)) {\n const match = commitMessage.match(regex)\n if (match) {\n const version = match[1]\n const tagName = `${platform}/${version}`\n\n return {\n platform,\n version,\n tagName,\n }\n }\n }\n\n return null\n}\n\n/**\n * Main execution function\n */\nfunction main() {\n try {\n console.info(\"Extracting release information from commit message...\")\n\n const commitMessage = getLatestCommitMessage()\n console.info(`Commit message: ${commitMessage}`)\n\n const releaseInfo = extractReleaseInfo(commitMessage)\n\n if (!releaseInfo) {\n console.info(\"No desktop or mobile release found in commit message.\")\n process.exit(EXIT_CODES.SUCCESS)\n }\n\n const { platform, version, tagName } = releaseInfo\n\n // Set GitHub Environment variables\n setGitHubEnv(\"tag_version\", tagName)\n setGitHubEnv(\"platform\", platform)\n setGitHubEnv(\"version\", version)\n setGitHubOutput(\"tag_version\", tagName)\n setGitHubOutput(\"platform\", platform)\n setGitHubOutput(\"version\", version)\n\n console.info(`Found ${platform} release: ${version}`)\n console.info(`Tag will be created: ${tagName}`)\n\n process.exit(EXIT_CODES.SUCCESS)\n } catch (error) {\n console.error(\"Unexpected error:\", error.message)\n process.exit(EXIT_CODES.GIT_ERROR)\n }\n}\n\nmain()\n" }, { "path": ".github/workflows/build-android.yml", "content": "name: 🤖 Build Android\n\non:\n push:\n branches:\n - \"**\"\n paths:\n - \"apps/mobile/**\"\n - \"pnpm-lock.yaml\"\n workflow_dispatch:\n inputs:\n profile:\n type: choice\n default: preview\n options:\n - preview\n - production\n description: \"Build profile\"\n release:\n type: boolean\n default: false\n description: \"Create a release draft for the build\"\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}-${{ github.event.inputs.profile }}\n cancel-in-progress: true\n\njobs:\n build:\n name: Build Android apk for device\n if: github.secret_source != 'None' && (github.event_name != 'push' || !contains(github.event.head_commit.message || '', 'release(mobile):'))\n runs-on: ubuntu-latest\n\n steps:\n - name: 🧹 Claim disk space\n run: |\n df -h /\n sudo rm -rf /usr/share/dotnet\n sudo rm -rf /usr/local/.ghcup\n sudo rm -rf /opt/hostedtoolcache/CodeQL\n sudo rm -rf /usr/share/swift\n sudo rm -rf /usr/local/julia*\n df -h /\n\n - name: 📦 Checkout code\n uses: actions/checkout@v6\n\n - name: 📦 Setup pnpm\n uses: pnpm/action-setup@v4\n\n - name: 🏗 Setup Node.js\n uses: actions/setup-node@v6\n with:\n node-version: 22\n cache: \"pnpm\"\n\n - name: Set up JDK 17\n uses: actions/setup-java@v5\n with:\n java-version: \"17\"\n distribution: \"zulu\"\n\n - name: Setup Android SDK\n uses: android-actions/setup-android@v3\n\n - name: 📱 Setup EAS\n uses: expo/expo-github-action@v8\n with:\n eas-version: latest\n token: ${{ secrets.EXPO_TOKEN }}\n\n - name: Install dependencies\n run: pnpm install\n\n - name: 🔨 Build Android app\n working-directory: apps/mobile\n run: eas build --platform android --profile ${{ github.event.inputs.profile || 'preview' }} --local --output=${{ github.workspace }}/build.${{ github.event.inputs.profile == 'production' && 'aab' || 'apk' }}\n\n - name: 📤 Upload apk Artifact\n if: github.event.inputs.profile != 'production'\n uses: actions/upload-artifact@v7\n with:\n name: app-android\n path: ${{ github.workspace }}/build.apk\n retention-days: 90\n\n - name: 📤 Upload aab Artifact\n if: github.event.inputs.profile == 'production'\n uses: actions/upload-artifact@v7\n with:\n name: aab-android\n path: ${{ github.workspace }}/build.aab\n retention-days: 90\n\n - name: Submit to Google Play\n if: github.event.inputs.profile == 'production'\n working-directory: apps/mobile\n run: eas submit --platform android --path ${{ github.workspace }}/build.aab --non-interactive\n\n - name: Setup Version\n if: github.event.inputs.release == 'true'\n id: version\n uses: ./.github/actions/setup-version\n with:\n type: \"mobile\"\n\n - name: Prepare Release Notes\n if: github.event.inputs.release == 'true'\n id: release_notes\n run: |\n version=\"${{ steps.version.outputs.APP_VERSION }}\"\n changelog_file=\"apps/mobile/changelog/${version}.md\"\n release_notes_file=\"$RUNNER_TEMP/mobile-release-notes.md\"\n\n if [ -f \"$changelog_file\" ]; then\n cp \"$changelog_file\" \"$release_notes_file\"\n else\n {\n echo \"# What's New in v${version}\"\n echo\n echo \"- No changelog file found at ${changelog_file}.\"\n } > \"$release_notes_file\"\n fi\n\n echo \"body_path=${release_notes_file}\" >> \"$GITHUB_OUTPUT\"\n\n - name: Create Release Draft\n if: github.event.inputs.release == 'true'\n uses: softprops/action-gh-release@v2\n with:\n name: Mobile v${{ steps.version.outputs.APP_VERSION }}\n draft: true\n prerelease: true\n tag_name: mobile/v${{ steps.version.outputs.APP_VERSION }}\n body_path: ${{ steps.release_notes.outputs.body_path }}\n # .aab cannot be installed directly on your Android Emulator or device.\n files: ${{ github.workspace }}/build.apk\n" }, { "path": ".github/workflows/build-desktop.yml", "content": "name: 🖥️ Build Desktop\n\non:\n push:\n branches:\n - \"**\"\n paths:\n - \"apps/desktop/**\"\n - \"packages/**\"\n - \"pnpm-lock.yaml\"\n - \".github/workflows/build-desktop.yml\"\n workflow_dispatch:\n inputs:\n tag_version:\n type: boolean\n description: \"Tag Version\"\n store:\n type: boolean\n description: \"Build for Mac App Store and Microsoft Store\"\n build_version:\n type: string\n description: \"Build Version, only available when mas is true\"\n\n# https://docs.github.com/en/enterprise-cloud@latest/actions/writing-workflows/choosing-what-your-workflow-does/control-the-concurrency-of-workflows-and-jobs\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}-${{ github.event_name == 'workflow_dispatch' && (github.event.inputs.tag_version == 'true' && 'tag-version' || github.event.inputs.store == 'true' && 'store' || 'manual') || 'build' }}\n cancel-in-progress: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}\nenv:\n VITE_WEB_URL: ${{ vars.VITE_WEB_URL }}\n VITE_API_URL: ${{ vars.VITE_API_URL }}\n VITE_SENTRY_DSN: ${{ vars.VITE_SENTRY_DSN }}\n VITE_FIREBASE_CONFIG: ${{ vars.VITE_FIREBASE_CONFIG }}\n SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}\n NODE_OPTIONS: --max-old-space-size=8192\n\njobs:\n release:\n if: github.secret_source != 'None' && (github.event_name != 'push' || !contains(github.event.head_commit.message || '', 'release(desktop):'))\n runs-on: ${{ matrix.os }}\n env:\n PROD: ${{ github.event.inputs.tag_version == 'true' || github.ref_type == 'tag' || github.event.inputs.store == 'true' }}\n RELEASE: ${{ github.event.inputs.tag_version == 'true' || github.ref_type == 'tag' }}\n\n strategy:\n fail-fast: false\n matrix:\n os: [macos-latest, ubuntu-latest, windows-latest]\n exclude:\n - os: ${{ github.event.inputs.store == 'true' && 'ubuntu-latest' }}\n\n permissions:\n id-token: write\n contents: write\n attestations: write\n\n steps:\n - name: Check out Git repository Fully\n uses: actions/checkout@v6\n if: env.PROD == 'true'\n with:\n fetch-depth: 0\n lfs: true\n - name: Check out Git repository\n uses: actions/checkout@v6\n if: env.PROD == 'false'\n with:\n fetch-depth: 1\n lfs: true\n\n - name: Setup pnpm\n uses: pnpm/action-setup@v4\n\n - name: Use Node.js\n uses: actions/setup-node@v6\n with:\n node-version: 22\n cache: \"pnpm\"\n\n - name: Install Python setuptools\n if: runner.os == 'macOS'\n run: brew install python-setuptools\n\n - name: Install appdmg\n if: runner.os == 'macOS'\n run: pnpm add -g appdmg\n\n - name: Install the Apple certificate and provisioning profile\n env:\n BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}\n BUILD_CERTIFICATE_MAS_BASE64: ${{ secrets.BUILD_CERTIFICATE_MAS_BASE64 }}\n BUILD_CERTIFICATE_MASPKG_BASE64: ${{ secrets.BUILD_CERTIFICATE_MASPKG_BASE64 }}\n P12_PASSWORD: ${{ secrets.P12_PASSWORD }}\n BUILD_PROVISION_PROFILE_BASE64: ${{ secrets.BUILD_PROVISION_PROFILE_BASE64 }}\n KEYCHAIN_PASSWORD: ${{ secrets.KEYCHAIN_PASSWORD }}\n if: runner.os == 'macOS' && env.BUILD_CERTIFICATE_BASE64 != '' && env.BUILD_CERTIFICATE_MAS_BASE64 != '' && env.BUILD_CERTIFICATE_MASPKG_BASE64 != '' && env.BUILD_PROVISION_PROFILE_BASE64 != ''\n run: |\n # create variables\n CERTIFICATE_PATH=$RUNNER_TEMP/build_certificate.p12\n CERTIFICATE_MAS_PATH=$RUNNER_TEMP/build_certificate_mas.p12\n CERTIFICATE_MASPKG_PATH=$RUNNER_TEMP/build_certificate_maspkg.p12\n PP_PATH=$RUNNER_TEMP/build_pp.provisionprofile\n KEYCHAIN_PATH=$RUNNER_TEMP/app-signing.keychain-db\n\n # import certificate and provisioning profile from secrets\n echo -n \"$BUILD_CERTIFICATE_BASE64\" | base64 --decode -o $CERTIFICATE_PATH\n echo -n \"$BUILD_CERTIFICATE_MAS_BASE64\" | base64 --decode -o $CERTIFICATE_MAS_PATH\n echo -n \"$BUILD_CERTIFICATE_MASPKG_BASE64\" | base64 --decode -o $CERTIFICATE_MASPKG_PATH\n echo -n \"$BUILD_PROVISION_PROFILE_BASE64\" | base64 --decode -o $PP_PATH\n\n # create temporary keychain\n security create-keychain -p \"$KEYCHAIN_PASSWORD\" $KEYCHAIN_PATH\n security set-keychain-settings -lut 21600 $KEYCHAIN_PATH\n security unlock-keychain -p \"$KEYCHAIN_PASSWORD\" $KEYCHAIN_PATH\n\n # import certificate to keychain\n security import $CERTIFICATE_PATH -P \"$P12_PASSWORD\" -A -t cert -f pkcs12 -k $KEYCHAIN_PATH\n security import $CERTIFICATE_MAS_PATH -P \"$P12_PASSWORD\" -A -t cert -f pkcs12 -k $KEYCHAIN_PATH\n security import $CERTIFICATE_MASPKG_PATH -P \"$P12_PASSWORD\" -A -t cert -f pkcs12 -k $KEYCHAIN_PATH\n security set-key-partition-list -S apple-tool:,apple: -k \"$KEYCHAIN_PASSWORD\" $KEYCHAIN_PATH\n security list-keychain -d user -s $KEYCHAIN_PATH\n security find-identity $KEYCHAIN_PATH\n\n # apply provisioning profile\n mkdir -p ~/Library/MobileDevice/Provisioning\\ Profiles\n cp $PP_PATH ~/Library/MobileDevice/Provisioning\\ Profiles\n\n - name: Install dependencies\n run: pnpm i\n\n - name: Prebuild packages (Windows)\n if: runner.os == 'windows'\n run: pnpm run build:packages\n\n - name: Update main hash\n working-directory: apps/desktop\n run: pnpm update:main-hash\n - name: Build - Vite\n working-directory: apps/desktop\n run: pnpm build:electron-vite ${{ env.PROD == 'false' && '--mode staging' || '' }}\n\n - name: Build - Windows and Linux\n if: runner.os == 'Linux' || (runner.os == 'Windows' && github.event.inputs.store != 'true')\n working-directory: apps/desktop\n run: pnpm build:electron-forge ${{ env.PROD == 'false' && '--mode=staging' || '' }}\n\n - name: Build - macOS\n if: runner.os == 'macOS' && github.event.inputs.store != 'true'\n env:\n APPLE_ID: ${{ secrets.APPLE_ID }}\n APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}\n APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}\n OSX_SIGN_KEYCHAIN_PATH: ${{ runner.temp }}/app-signing.keychain-db\n OSX_SIGN_IDENTITY: ${{ secrets.OSX_SIGN_IDENTITY }}\n uses: nick-fields/retry@v3\n with:\n max_attempts: 3\n timeout_minutes: 10\n command: |\n cd apps/desktop\n npx electron-forge make --arch=x64 --platform=darwin ${{ env.PROD == 'false' && '--mode=staging' || '' }}\n npx electron-forge make --arch=arm64 --platform=darwin ${{ env.PROD == 'false' && '--mode=staging' || '' }}\n npx tsx scripts/merge-yml.ts\n\n - name: Build - Mac App Store\n if: runner.os == 'macOS' && github.event.inputs.store == 'true'\n env:\n OSX_SIGN_KEYCHAIN_PATH: ${{ runner.temp }}/app-signing.keychain-db\n OSX_SIGN_IDENTITY: ${{ secrets.OSX_SIGN_IDENTITY_MAS }}\n OSX_SIGN_PROVISIONING_PROFILE_PATH: ${{ runner.temp }}/build_pp.provisionprofile\n BUILD_VERSION: ${{ github.event.inputs.build_version }}\n working-directory: apps/desktop\n run: pnpm build:electron-forge:mas\n\n - name: Build - Microsoft Store\n if: runner.os == 'Windows' && github.event.inputs.store == 'true'\n working-directory: apps/desktop\n run: pnpm build:electron-forge:ms\n\n - name: Build - Renderer\n if: runner.os == 'Linux'\n working-directory: apps/desktop\n run: pnpm build:render\n\n - name: Upload file (macos-arm64-dmg)\n uses: actions/upload-artifact@v7\n if: runner.os == 'macOS'\n with:\n name: macos-arm64-dmg\n path: |\n apps/desktop/out/make/**/*arm64.dmg\n apps/desktop/out/make/**/latest-mac.yml\n retention-days: 90\n\n - name: Upload file (macos-x64-dmg)\n uses: actions/upload-artifact@v7\n if: runner.os == 'macOS'\n with:\n name: macos-x64-dmg\n path: |\n apps/desktop/out/make/**/*x64.dmg\n apps/desktop/out/make/**/latest-mac.yml\n retention-days: 90\n\n - name: Upload file (macos-mas-pkg)\n uses: actions/upload-artifact@v7\n if: runner.os == 'macOS'\n with:\n name: macos-mas-pkg\n path: |\n apps/desktop/out/make/**/*.pkg\n retention-days: 90\n\n - name: Upload file (windows-x64-exe unsigned)\n uses: actions/upload-artifact@v7\n id: upload-unsigned-windows-x64-exe\n if: runner.os == 'windows' && github.event.inputs.store != 'true'\n with:\n name: windows-x64-exe\n path: |\n apps/desktop/out/make/**/*x64.exe\n apps/desktop/out/make/**/latest.yml\n retention-days: 90\n\n - uses: signpath/github-action-submit-signing-request@v2.0\n continue-on-error: true\n if: runner.os == 'windows' && env.RELEASE == 'true' && github.event.inputs.store != 'true'\n with:\n api-token: \"${{ secrets.SIGNPATH_API_TOKEN }}\"\n organization-id: \"8c651516-fdaf-40a1-9fea-001dffde850e\"\n project-slug: \"Folo\"\n signing-policy-slug: \"release-signing\"\n artifact-configuration-slug: \"github\"\n github-artifact-id: \"${{ steps.upload-unsigned-windows-x64-exe.outputs.artifact-id }}\"\n output-artifact-directory: \"apps/desktop/out/make/\"\n\n - name: Update latest.yml\n if: runner.os == 'windows' && env.RELEASE == 'true' && github.event.inputs.store != 'true'\n run: npx tsx apps/desktop/scripts/update-windows-yml.ts\n\n - name: Upload file (windows-x64-exe signed)\n uses: actions/upload-artifact@v7\n if: runner.os == 'windows' && env.RELEASE == 'true' && github.event.inputs.store != 'true'\n with:\n name: windows-x64-exe\n path: |\n apps/desktop/out/make/**/*x64.exe\n apps/desktop/out/make/**/latest.yml\n retention-days: 90\n overwrite: true\n\n - name: Upload file (windows-x64-appx)\n uses: actions/upload-artifact@v7\n if: runner.os == 'windows'\n with:\n name: windows-x64-appx\n path: |\n apps/desktop/out/make/**/*.appx\n retention-days: 90\n\n - name: Upload file (linux-x64-appimage)\n uses: actions/upload-artifact@v7\n if: runner.os == 'linux'\n with:\n name: linux-x64-appimage\n path: |\n apps/desktop/out/make/**/*x64.AppImage\n apps/desktop/out/make/**/latest-linux.yml\n retention-days: 90\n\n - name: Generate artifact attestation\n if: env.RELEASE == 'true'\n continue-on-error: true\n uses: actions/attest-build-provenance@v4\n with:\n subject-path: |\n apps/desktop/out/make/**/Folo-*.dmg\n apps/desktop/out/make/**/Folo-*.zip\n apps/desktop/out/make/**/Folo-*.exe\n apps/desktop/out/make/**/Folo-*.AppImage\n apps/desktop/out/make/**/*.yml\n apps/desktop/dist/manifest.yml\n apps/desktop/dist/*.tar.gz\n\n - run: npx changelogithub\n if: env.RELEASE == 'true'\n continue-on-error: true\n env:\n GITHUB_TOKEN: ${{ github.token }}\n\n - name: Setup Version\n if: env.RELEASE == 'true'\n id: version\n uses: ./.github/actions/setup-version\n with:\n type: \"desktop\"\n\n - name: Prepare Release Notes\n if: env.RELEASE == 'true'\n id: release_notes\n shell: bash\n run: |\n version=\"${{ steps.version.outputs.APP_VERSION }}\"\n changelog_file=\"apps/desktop/changelog/${version}.md\"\n release_notes_file=\"$RUNNER_TEMP/desktop-release-notes.md\"\n\n if [ -f \"$changelog_file\" ]; then\n cp \"$changelog_file\" \"$release_notes_file\"\n else\n {\n echo \"# What's New in v${version}\"\n echo\n echo \"- No changelog file found at ${changelog_file}.\"\n } > \"$release_notes_file\"\n fi\n\n echo \"body_path=${release_notes_file}\" >> \"$GITHUB_OUTPUT\"\n\n - name: Create Release Draft\n if: env.RELEASE == 'true'\n uses: softprops/action-gh-release@v2\n with:\n name: Desktop v${{ steps.version.outputs.APP_VERSION }}\n draft: false\n prerelease: true\n tag_name: desktop/v${{ steps.version.outputs.APP_VERSION }}\n body_path: ${{ steps.release_notes.outputs.body_path }}\n files: |\n apps/desktop/out/make/**/Folo-*.dmg\n apps/desktop/out/make/**/Folo-*.zip\n apps/desktop/out/make/**/Folo-*.exe\n apps/desktop/out/make/**/Folo-*.AppImage\n apps/desktop/out/make/**/*.yml\n apps/desktop/dist/manifest.yml\n apps/desktop/dist/*.tar.gz\n" }, { "path": ".github/workflows/build-ios-development.yml", "content": "name: 📱 Build iOS for development\n\non:\n push:\n branches:\n - \"**\"\n paths:\n - \"apps/mobile/web-app/**\"\n - \"apps/mobile/native/**\"\n - \"apps/mobile/package.json\"\n - \"apps/mobile/app.config.ts\"\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}\n cancel-in-progress: true\n\njobs:\n check-runner:\n runs-on: ubuntu-latest\n outputs:\n runner-label: ${{ steps.set-runner.outputs.runner-label }}\n\n steps:\n - name: Set runner\n id: set-runner\n run: |\n runners=$(curl -s -H \"Accept: application/vnd.github+json\" -H \"Authorization: Bearer ${{ secrets.RUNNER_GITHUB_TOKEN }}\" \"https://api.github.com/repos/${{ github.repository }}/actions/runners\")\n available=$(echo \"$runners\" | jq '.runners[]? | select(.status == \"online\" and .busy == false and .labels[] .name == \"macOS\")')\n if [ -n \"$available\" ]; then\n echo \"runner-label=self-hosted\" >> $GITHUB_OUTPUT\n else\n echo \"runner-label=macos-latest\" >> $GITHUB_OUTPUT\n fi\n\n build-ipa-device-self-hosted:\n name: Build iOS IPA for device (self-hosted)\n if: github.secret_source != 'None' && needs.check-runner.outputs.runner-label == 'self-hosted'\n needs: check-runner\n runs-on: [self-hosted, macOS]\n\n steps:\n - name: 📦 Checkout code\n uses: actions/checkout@v6\n\n - name: 📱 Setup EAS\n uses: expo/expo-github-action@v8\n with:\n eas-version: latest\n token: ${{ secrets.EXPO_TOKEN }}\n\n - name: Install dependencies\n run: pnpm install\n\n - name: 🔨 Build iOS IPA\n working-directory: apps/mobile\n run: eas build --platform ios --profile development --non-interactive --local --output=./build.ipa\n env:\n SENTRY_AUTH_TOKEN: ${{ secrets.RN_SENTRY_AUTH_TOKEN }}\n CI: true\n\n # Optional: Upload artifact\n - name: 📤 Upload IPA\n uses: actions/upload-artifact@v7\n with:\n name: app-ios-development-device\n path: apps/mobile/build.ipa\n retention-days: 90\n\n - name: Clear Xcode cache\n run: |\n rm -rf ~/Library/Developer/Xcode/DerivedData\n\n build-ipa-device-github:\n name: Build iOS IPA for device (GitHub-hosted)\n if: github.secret_source != 'None' && needs.check-runner.outputs.runner-label == 'macos-latest'\n needs: check-runner\n runs-on: macos-latest\n\n steps:\n - name: 📦 Checkout code\n uses: actions/checkout@v6\n\n - name: 🔧 Setup Xcode\n uses: ./.github/actions/setup-xcode\n\n - name: 📦 Setup pnpm\n uses: pnpm/action-setup@v4\n\n - name: 🏗 Setup Node.js\n uses: actions/setup-node@v6\n with:\n node-version: 22\n cache: \"pnpm\"\n\n - name: 📱 Setup EAS\n uses: expo/expo-github-action@v8\n with:\n eas-version: latest\n token: ${{ secrets.EXPO_TOKEN }}\n\n - name: Install dependencies\n run: pnpm install\n\n - name: 🔨 Build iOS IPA\n working-directory: apps/mobile\n run: eas build --platform ios --profile development --non-interactive --local --output=./build.ipa\n env:\n CI: true\n SENTRY_AUTH_TOKEN: ${{ secrets.RN_SENTRY_AUTH_TOKEN }}\n # Optional: Upload artifact\n - name: 📤 Upload IPA\n uses: actions/upload-artifact@v7\n with:\n name: app-ios-development-device\n path: apps/mobile/build.ipa\n retention-days: 90\n\n build-simulator:\n name: Build iOS IPA for simulator\n if: github.secret_source != 'None'\n runs-on: macos-latest\n\n steps:\n - name: 📦 Checkout code\n uses: actions/checkout@v6\n\n - name: 🔧 Setup Xcode\n uses: ./.github/actions/setup-xcode\n\n - name: 📦 Setup pnpm\n uses: pnpm/action-setup@v4\n\n - name: 🏗 Setup Node.js\n uses: actions/setup-node@v6\n with:\n node-version: 22\n cache: \"pnpm\"\n\n - name: 📱 Setup EAS\n uses: expo/expo-github-action@v8\n with:\n eas-version: latest\n token: ${{ secrets.EXPO_TOKEN }}\n\n - name: Install dependencies\n run: pnpm install\n\n - name: 🔨 Build iOS IPA\n working-directory: apps/mobile\n run: eas build --platform ios --profile ios-simulator --non-interactive --local --output=./build-simulator.ipa\n env:\n CI: true\n SENTRY_AUTH_TOKEN: ${{ secrets.RN_SENTRY_AUTH_TOKEN }}\n # Optional: Upload artifact\n - name: 📤 Upload IPA\n uses: actions/upload-artifact@v7\n with:\n name: app-ios-development-simulator\n path: apps/mobile/build-simulator.ipa\n retention-days: 90\n" }, { "path": ".github/workflows/build-ios.yml", "content": "name: 🍎 Build iOS\n\non:\n push:\n branches:\n - \"**\"\n paths:\n - \"apps/mobile/**\"\n - \"pnpm-lock.yaml\"\n workflow_dispatch:\n inputs:\n profile:\n type: choice\n default: preview\n options:\n - preview\n - production\n description: \"Build profile\"\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}-${{ github.event.inputs.profile }}\n cancel-in-progress: true\n\njobs:\n check-runner:\n if: github.secret_source != 'None' && (github.event_name != 'push' || !contains(github.event.head_commit.message || '', 'release(mobile):'))\n runs-on: ubuntu-latest\n outputs:\n runner-label: ${{ steps.set-runner.outputs.runner-label }}\n\n steps:\n - name: Set runner\n id: set-runner\n run: |\n runners=$(curl -s -H \"Accept: application/vnd.github+json\" -H \"Authorization: Bearer ${{ secrets.RUNNER_GITHUB_TOKEN }}\" \"https://api.github.com/repos/${{ github.repository }}/actions/runners\")\n available=$(echo \"$runners\" | jq '.runners[]? | select(.status == \"online\" and .busy == false and .labels[] .name == \"macOS\")')\n if [ -n \"$available\" ]; then\n echo \"runner-label=self-hosted\" >> $GITHUB_OUTPUT\n else\n echo \"runner-label=macos-latest\" >> $GITHUB_OUTPUT\n fi\n\n build-ipa-self-hosted:\n name: Build iOS IPA (self-hosted)\n if: needs.check-runner.outputs.runner-label == 'self-hosted'\n needs: check-runner\n runs-on: [self-hosted, macOS]\n\n steps:\n - name: 📦 Checkout code\n uses: actions/checkout@v6\n\n - name: 📱 Setup EAS\n uses: expo/expo-github-action@v8\n with:\n eas-version: latest\n token: ${{ secrets.EXPO_TOKEN }}\n\n - name: Install dependencies\n run: pnpm install\n\n - name: 🔨 Build iOS IPA\n working-directory: apps/mobile\n run: eas build --platform ios --profile ${{ github.event.inputs.profile || 'preview' }} --non-interactive --local --output=./build.ipa\n env:\n SENTRY_AUTH_TOKEN: ${{ secrets.RN_SENTRY_AUTH_TOKEN }}\n CI: true\n\n # Optional: Upload artifact\n - name: 📤 Upload IPA\n uses: actions/upload-artifact@v7\n with:\n name: app-ios\n path: apps/mobile/build.ipa\n retention-days: 90\n\n - name: Clear Xcode cache\n run: |\n rm -rf ~/Library/Developer/Xcode/DerivedData\n\n - name: Submit to App Store\n if: github.event.inputs.profile == 'production'\n working-directory: apps/mobile\n run: eas submit --platform ios --path build.ipa --non-interactive\n\n build-ipa-github:\n name: Build iOS IPA (GitHub)\n if: needs.check-runner.outputs.runner-label == 'macos-latest'\n needs: check-runner\n runs-on: macos-latest\n\n steps:\n - name: 📦 Checkout code\n uses: actions/checkout@v6\n\n - name: 🔧 Setup Xcode\n uses: ./.github/actions/setup-xcode\n\n - name: 📦 Setup pnpm\n uses: pnpm/action-setup@v4\n\n - name: 🏗 Setup Node.js\n uses: actions/setup-node@v6\n with:\n node-version: 22\n cache: \"pnpm\"\n\n - name: 📱 Setup EAS\n uses: expo/expo-github-action@v8\n with:\n eas-version: latest\n token: ${{ secrets.EXPO_TOKEN }}\n\n - name: Install dependencies\n run: pnpm install\n\n - name: 🔨 Build iOS IPA\n working-directory: apps/mobile\n run: eas build --platform ios --profile ${{ github.event.inputs.profile || 'preview' }} --non-interactive --local --output=./build.ipa\n env:\n CI: true\n SENTRY_AUTH_TOKEN: ${{ secrets.RN_SENTRY_AUTH_TOKEN }}\n # Optional: Upload artifact\n - name: 📤 Upload IPA\n uses: actions/upload-artifact@v7\n with:\n name: app-ios\n path: apps/mobile/build.ipa\n retention-days: 90\n\n - name: Submit to App Store\n if: github.event.inputs.profile == 'production'\n working-directory: apps/mobile\n run: eas submit --platform ios --path build.ipa --non-interactive\n" }, { "path": ".github/workflows/build-web.yml", "content": "on:\n pull_request:\n push:\n branches: [main, dev]\n\nname: 🌐 CI Build web and SSR server\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}-ssr\n cancel-in-progress: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}\njobs:\n build:\n name: Build web and SSR server\n runs-on: ubuntu-latest\n\n strategy:\n matrix:\n node-version: [lts/*]\n steps:\n - name: Checkout code\n uses: actions/checkout@v6\n with:\n lfs: true\n - name: Cache turbo build setup\n uses: actions/cache@v5\n with:\n path: .turbo\n key: ${{ runner.os }}-turbo-${{ github.sha }}\n restore-keys: |\n ${{ runner.os }}-turbo-\n\n - name: Checkout LFS objects\n run: git lfs checkout\n\n - uses: pnpm/action-setup@v4\n\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v6\n with:\n node-version: ${{ matrix.node-version }}\n cache: \"pnpm\"\n - name: Install dependencies\n run: pnpm install\n - name: Build web and SSR server\n run: |\n npm exec turbo run Folo#build:web @follow/ssr#build\n" }, { "path": ".github/workflows/deploy-cloudflare-desktop.yml", "content": "name: \"\\u2601\\ufe0f Deploy Desktop to Cloudflare\"\n\non:\n push:\n branches: [main, dev]\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}\n cancel-in-progress: true\n\njobs:\n deploy:\n name: Build & Deploy Desktop Web\n runs-on: ubuntu-latest\n env:\n VITE_SENTRY_DSN: ${{ vars.VITE_SENTRY_DSN }}\n VITE_FIREBASE_CONFIG: ${{ vars.VITE_FIREBASE_CONFIG }}\n steps:\n - name: Checkout code\n uses: actions/checkout@v6\n with:\n lfs: true\n\n - name: Checkout LFS objects\n run: git lfs checkout\n\n - name: Cache turbo build setup\n uses: actions/cache@v5\n with:\n path: .turbo\n key: ${{ runner.os }}-turbo-${{ github.sha }}\n restore-keys: |\n ${{ runner.os }}-turbo-\n\n - uses: pnpm/action-setup@v4\n\n - name: Use Node.js LTS\n uses: actions/setup-node@v6\n with:\n node-version: lts/*\n cache: \"pnpm\"\n\n - name: Install dependencies\n run: pnpm install\n\n - name: Build desktop web (SPA)\n working-directory: apps/desktop\n env:\n VITE_WEB_URL: ${{ github.ref == 'refs/heads/dev' && 'https://dev.folo.is' || 'https://app.folo.is' }}\n VITE_API_URL: ${{ github.ref == 'refs/heads/dev' && 'https://api.dev.folo.is' || 'https://api.folo.is' }}\n run: pnpm run build:web\n\n - name: Deploy desktop web to Cloudflare (dev)\n if: github.ref == 'refs/heads/dev'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n workingDirectory: apps/desktop\n command: deploy --env dev\n\n - name: Deploy desktop web to Cloudflare (prod)\n if: github.ref == 'refs/heads/main'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n workingDirectory: apps/desktop\n command: 'deploy --env=\"\"'\n" }, { "path": ".github/workflows/deploy-cloudflare-landing.yml", "content": "name: \"\\u2601\\ufe0f Deploy Landing to Cloudflare\"\n\non:\n push:\n branches: [main, dev]\n workflow_dispatch:\n inputs:\n confirm_production_deploy:\n description: Deploy the selected branch to production (folo.is)\n required: true\n default: false\n type: boolean\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.event_name == 'workflow_dispatch' && format('manual-prod-{0}', github.ref) || github.ref }}\n cancel-in-progress: true\n\njobs:\n deploy:\n name: Build & Deploy Landing Worker\n runs-on: ubuntu-latest\n steps:\n - name: Checkout code\n uses: actions/checkout@v6\n with:\n lfs: true\n\n - name: Checkout LFS objects\n run: git lfs checkout\n\n - name: Cache turbo build setup\n uses: actions/cache@v5\n with:\n path: .turbo\n key: ${{ runner.os }}-turbo-${{ github.sha }}\n restore-keys: |\n ${{ runner.os }}-turbo-\n\n - uses: pnpm/action-setup@v4\n\n - name: Use Node.js LTS\n uses: actions/setup-node@v6\n with:\n node-version: lts/*\n cache: \"pnpm\"\n\n - name: Install dependencies\n run: pnpm install\n\n - name: Resolve deployment target\n id: target\n run: |\n if [[ \"${{ github.event_name }}\" == \"workflow_dispatch\" ]]; then\n if [[ \"${{ inputs.confirm_production_deploy }}\" != \"true\" ]]; then\n echo \"Manual production deploy was not confirmed.\" >&2\n exit 1\n fi\n\n echo \"environment=prod\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n if [[ \"${{ github.ref }}\" == \"refs/heads/dev\" ]]; then\n echo \"environment=dev\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n echo \"environment=prod\" >> \"$GITHUB_OUTPUT\"\n\n - name: Build Landing Worker\n run: pnpm exec turbo run @follow/landing#cf:build\n\n - name: Deploy Landing to Cloudflare (dev)\n if: steps.target.outputs.environment == 'dev'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n workingDirectory: apps/landing\n command: deploy --env dev --name landing-next-dev --routes landing.dev.folo.is/*\n\n - name: Deploy Landing to Cloudflare (prod)\n if: steps.target.outputs.environment == 'prod'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n workingDirectory: apps/landing\n command: deploy\n" }, { "path": ".github/workflows/deploy-cloudflare-ssr.yml", "content": "name: \"\\u2601\\ufe0f Deploy SSR to Cloudflare\"\n\non:\n push:\n branches: [main, dev]\n workflow_dispatch:\n inputs:\n confirm_production_deploy:\n description: Deploy the selected branch to production (app.folo.is)\n required: true\n default: false\n type: boolean\n\nconcurrency:\n group: ${{ github.workflow }}-${{ github.event_name == 'workflow_dispatch' && format('manual-prod-{0}', github.ref) || github.ref }}\n cancel-in-progress: true\n\njobs:\n deploy:\n name: Build & Deploy SSR Worker\n runs-on: ubuntu-latest\n env:\n VITE_SENTRY_DSN: ${{ vars.VITE_SENTRY_DSN }}\n VITE_FIREBASE_CONFIG: ${{ vars.VITE_FIREBASE_CONFIG }}\n steps:\n - name: Checkout code\n uses: actions/checkout@v6\n with:\n lfs: true\n\n - name: Checkout LFS objects\n run: git lfs checkout\n\n - name: Cache turbo build setup\n uses: actions/cache@v5\n with:\n path: .turbo\n key: ${{ runner.os }}-turbo-${{ github.sha }}\n restore-keys: |\n ${{ runner.os }}-turbo-\n\n - uses: pnpm/action-setup@v4\n\n - name: Use Node.js LTS\n uses: actions/setup-node@v6\n with:\n node-version: lts/*\n cache: \"pnpm\"\n\n - name: Install dependencies\n run: pnpm install\n\n - name: Resolve deployment target\n id: target\n run: |\n if [[ \"${{ github.event_name }}\" == \"workflow_dispatch\" ]]; then\n if [[ \"${{ inputs.confirm_production_deploy }}\" != \"true\" ]]; then\n echo \"Manual production deploy was not confirmed.\" >&2\n exit 1\n fi\n\n echo \"environment=prod\" >> \"$GITHUB_OUTPUT\"\n echo \"vite_web_url=https://app.folo.is\" >> \"$GITHUB_OUTPUT\"\n echo \"vite_api_url=https://api.folo.is\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n if [[ \"${{ github.ref }}\" == \"refs/heads/dev\" ]]; then\n echo \"environment=dev\" >> \"$GITHUB_OUTPUT\"\n echo \"vite_web_url=https://dev.folo.is\" >> \"$GITHUB_OUTPUT\"\n echo \"vite_api_url=https://api.dev.folo.is\" >> \"$GITHUB_OUTPUT\"\n exit 0\n fi\n\n echo \"environment=prod\" >> \"$GITHUB_OUTPUT\"\n echo \"vite_web_url=https://app.folo.is\" >> \"$GITHUB_OUTPUT\"\n echo \"vite_api_url=https://api.folo.is\" >> \"$GITHUB_OUTPUT\"\n\n - name: Build desktop web (SSR assets)\n working-directory: apps/desktop\n env:\n VITE_WEB_URL: ${{ steps.target.outputs.vite_web_url }}\n VITE_API_URL: ${{ steps.target.outputs.vite_api_url }}\n run: pnpm run build:web\n\n - name: Build SSR Worker\n working-directory: apps/ssr\n run: pnpm run build:worker\n\n - name: Copy WASM file\n run: cp node_modules/@resvg/resvg-wasm/index_bg.wasm apps/ssr/dist/worker/resvg.wasm\n\n - name: Deploy SSR Worker to Cloudflare (dev)\n if: steps.target.outputs.environment == 'dev'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n workingDirectory: apps/ssr\n command: deploy --env dev\n\n - name: Deploy SSR Worker to Cloudflare (prod)\n if: steps.target.outputs.environment == 'prod'\n uses: cloudflare/wrangler-action@v3\n with:\n apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}\n accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}\n workingDirectory: apps/ssr\n command: 'deploy --env=\"\"'\n" }, { "path": ".github/workflows/issue-labeler.yml", "content": "name: 🏷️ Issue labeler\non:\n issues:\n types: [opened]\n\npermissions:\n contents: read\n\njobs:\n label-component:\n runs-on: ubuntu-latest\n\n permissions:\n # required for all workflows\n issues: write\n\n # only required for workflows in private repositories\n actions: read\n contents: read\n\n steps:\n - uses: actions/checkout@v6\n\n - name: Parse issue form\n uses: stefanbuck/github-issue-parser@v3\n id: issue-parser\n with:\n template-path: .github/ISSUE_TEMPLATE/bug_report.yml\n\n - name: Set labels based on platform field\n uses: redhat-plumbers-in-action/advanced-issue-labeler@v3\n with:\n issue-form: ${{ steps.issue-parser.outputs.jsonString }}\n token: ${{ secrets.GITHUB_TOKEN }}\n" }, { "path": ".github/workflows/lint.yml", "content": "on:\n pull_request:\n push:\n branches: [main, dev]\n\n# Do not use secrets or variables to allow for public access\nenv:\n VITE_WEB_URL: https://app.folo.is\n VITE_API_URL: https://api.follow.is\n\nname: ✨ CI Format, Typecheck and Lint\nconcurrency:\n group: ${{ github.workflow }}-${{ github.ref }}-lint\n cancel-in-progress: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/dev' }}\njobs:\n build:\n name: Format, Lint and Typecheck\n runs-on: ubuntu-latest\n\n strategy:\n matrix:\n node-version: [lts/*]\n steps:\n - name: Checkout code\n uses: actions/checkout@v6\n with:\n lfs: true\n - name: Cache turbo build setup\n uses: actions/cache@v5\n with:\n path: .turbo\n key: ${{ runner.os }}-turbo-${{ github.sha }}\n restore-keys: |\n ${{ runner.os }}-turbo-\n\n - name: Checkout LFS objects\n run: git lfs checkout\n\n - uses: pnpm/action-setup@v4\n\n - name: Use Node.js ${{ matrix.node-version }}\n uses: actions/setup-node@v6\n with:\n node-version: ${{ matrix.node-version }}\n cache: \"pnpm\"\n - name: Install dependencies\n run: pnpm install\n - name: Build web and SSR server\n run: |\n npm exec turbo run Folo#build:web @follow/ssr#build\n - name: Format, Lint and Typecheck\n run: |\n export NODE_OPTIONS=\"--max_old_space_size=16384\"\n npm exec turbo run format:check typecheck lint\n - name: Run test\n run: npm exec turbo run test\n" }, { "path": ".github/workflows/pr-title-check.yml", "content": "name: ✅ PR Conventional Commit Validation\n\non:\n pull_request:\n types: [opened, synchronize, reopened, edited]\n\njobs:\n validate-pr-title:\n runs-on: ubuntu-latest\n steps:\n - name: PR Conventional Commit Validation\n uses: ytanikin/PRConventionalCommits@1.3.0\n with:\n task_types: '[\"feat\",\"fix\",\"docs\",\"test\",\"ci\",\"refactor\",\"perf\",\"chore\",\"revert\",\"release\",\"build\"]'\n add_label: false\n" }, { "path": ".github/workflows/similar-issues.yml", "content": "name: Similar Issues via AI MCP\n\non:\n issues:\n types: [opened]\n\njobs:\n find-similar:\n permissions:\n contents: read\n issues: write\n models: read\n runs-on: ubuntu-latest\n steps:\n - name: Check out repository\n uses: actions/checkout@v6\n\n - name: Prepare prompt variables\n id: prepare_input\n uses: actions/github-script@v8\n with:\n script: |\n const issue = context.payload.issue || {};\n const title = issue.title || '';\n const body = issue.body || '';\n const indent = ' ';\n // Indent subsequent lines so YAML block scalar indentation remains valid\n const bodyIndented = body.replace(/\\n/g, '\\n' + indent);\n core.setOutput('issue_title_json', JSON.stringify(title));\n core.setOutput('issue_body_indented_json', JSON.stringify(bodyIndented));\n\n - name: Find similar issues with AI (MCP)\n id: inference\n uses: actions/ai-inference@v2\n with:\n prompt-file: ./.github/prompts/similar_issues.prompt.yml\n input: |\n issue_title: ${{ steps.prepare_input.outputs.issue_title_json }}\n issue_body: ${{ steps.prepare_input.outputs.issue_body_indented_json }}\n repository: ${{ github.repository }}\n enable-github-mcp: true\n token: ${{ secrets.GITHUB_TOKEN }}\n github-mcp-token: ${{ secrets.USER_PAT }}\n endpoint: https://models.github.ai/orgs/RSSNext/inference\n\n - name: Prepare comment body\n id: prepare\n uses: actions/github-script@v8\n env:\n AI_RESPONSE: ${{ steps.inference.outputs.response }}\n with:\n script: |\n let data;\n try {\n data = JSON.parse(process.env.AI_RESPONSE || '{}');\n } catch (e) {\n core.setOutput('has_matches', 'false');\n return;\n }\n const matches = Array.isArray(data.matches) ? data.matches : [];\n const rawIssueNumber = context?.payload?.issue?.number;\n const issueNumber = typeof rawIssueNumber === 'string' ? Number(rawIssueNumber) : rawIssueNumber;\n const filteredMatches = Number.isFinite(issueNumber)\n ? matches.filter((m) => {\n const matchNumber = typeof m?.number === 'string' ? Number(m.number) : m?.number;\n if (Number.isFinite(matchNumber)) {\n return matchNumber !== issueNumber;\n }\n if (typeof m?.url === 'string') {\n const urlMatch = m.url.match(/\\/issues\\/(\\d+)(?:$|[?#])/);\n if (urlMatch) {\n return Number(urlMatch[1]) !== issueNumber;\n }\n }\n return true;\n })\n : matches;\n if (!filteredMatches.length) {\n core.setOutput('has_matches', 'false');\n return;\n }\n const lines = [];\n lines.push('I found similar issues that might help:');\n for (const m of filteredMatches.slice(0, 3)) {\n const num = m.number != null ? `#${m.number}` : '';\n const title = m.title || 'Untitled';\n const url = m.url || '';\n const score = typeof m.similarity_score === 'number' ? ` (similarity: ${m.similarity_score.toFixed(2)})` : '';\n lines.push(`- ${url}${score}`.trim());\n }\n core.setOutput('has_matches', 'true');\n core.setOutput('comment_body', lines.join('\\n'));\n\n - name: Comment similar issues\n if: steps.prepare.outputs.has_matches == 'true'\n uses: actions/github-script@v8\n with:\n script: |\n const body = ${{ toJson(steps.prepare.outputs.comment_body) }};\n await github.rest.issues.createComment({\n owner: context.repo.owner,\n repo: context.repo.repo,\n issue_number: context.payload.issue.number,\n body\n });\n" }, { "path": ".github/workflows/sync.yaml", "content": "name: 🔄 Sync Release Branches To Dev\n\non:\n push:\n branches:\n - main\n - mobile-main\n\npermissions:\n contents: write\n\njobs:\n sync-to-dev:\n runs-on: ubuntu-latest\n if: |\n (github.ref == 'refs/heads/main' && contains(github.event.head_commit.message || '', 'release(desktop):')) ||\n (github.ref == 'refs/heads/mobile-main' && contains(github.event.head_commit.message || '', 'release(mobile):'))\n steps:\n - name: Checkout repository\n uses: actions/checkout@v6\n with:\n fetch-depth: 0\n\n - name: Set up Git\n run: |\n git config --global user.name \"github-actions[bot]\"\n git config --global user.email \"github-actions[bot]@users.noreply.github.com\"\n\n - name: Merge source branch into dev\n run: |\n source_branch=\"${GITHUB_REF_NAME}\"\n git fetch origin main mobile-main dev\n git checkout dev\n git merge --no-ff \"origin/${source_branch}\" -m \"chore(sync): merge ${source_branch} into dev\"\n git push origin dev\n" }, { "path": ".github/workflows/tag.yml", "content": "name: 🏷️ Release Orchestrator\n\non:\n push:\n branches:\n - main\n - mobile-main\n\npermissions:\n contents: write\n actions: write\n\njobs:\n create_tag:\n name: Create Release Tag\n runs-on: ubuntu-latest\n outputs:\n tag_version: ${{ steps.release_info.outputs.tag_version }}\n platform: ${{ steps.release_info.outputs.platform }}\n version: ${{ steps.release_info.outputs.version }}\n ref_name: ${{ steps.release_info.outputs.ref_name }}\n\n steps:\n - name: Checkout repository\n uses: actions/checkout@v6\n\n - name: Setup Node.js\n uses: actions/setup-node@v6\n with:\n node-version: lts/*\n\n - name: Make script executable\n run: |\n chmod +x .github/scripts/extract-release-info.mjs\n\n - name: Extract release information\n id: extract_info\n run: .github/scripts/extract-release-info.mjs\n continue-on-error: true\n\n - name: Expose release outputs\n id: release_info\n run: |\n echo \"tag_version=${tag_version:-}\" >> \"$GITHUB_OUTPUT\"\n echo \"platform=${platform:-}\" >> \"$GITHUB_OUTPUT\"\n echo \"version=${version:-}\" >> \"$GITHUB_OUTPUT\"\n echo \"ref_name=${GITHUB_REF_NAME}\" >> \"$GITHUB_OUTPUT\"\n\n - name: Validate git configuration\n if: steps.release_info.outputs.tag_version != ''\n run: |\n git config --global user.name \"github-actions[bot]\"\n git config --global user.email \"github-actions[bot]@users.noreply.github.com\"\n\n - name: Create and push tag\n if: steps.release_info.outputs.tag_version != ''\n run: |\n git fetch --tags --force\n echo \"Creating tag: ${{ steps.release_info.outputs.tag_version }}\"\n if git rev-parse \"${{ steps.release_info.outputs.tag_version }}\" >/dev/null 2>&1; then\n echo \"Tag ${{ steps.release_info.outputs.tag_version }} already exists, skipping creation\"\n exit 0\n fi\n\n git tag \"${{ steps.release_info.outputs.tag_version }}\"\n git push origin \"${{ steps.release_info.outputs.tag_version }}\"\n echo \"Successfully created and pushed tag: ${{ steps.release_info.outputs.tag_version }}\"\n\n trigger_builds:\n name: Trigger Platform Builds\n needs: create_tag\n if: needs.create_tag.outputs.tag_version != ''\n runs-on: ubuntu-latest\n\n steps:\n - name: Checkout repository\n if: needs.create_tag.outputs.platform == 'desktop' && needs.create_tag.outputs.ref_name == 'main'\n uses: actions/checkout@v6\n with:\n fetch-depth: 0\n\n - name: Configure Git\n if: needs.create_tag.outputs.platform == 'desktop' && needs.create_tag.outputs.ref_name == 'main'\n run: |\n git config --global user.name \"github-actions[bot]\"\n git config --global user.email \"github-actions[bot]@users.noreply.github.com\"\n\n - name: Resolve desktop build version\n id: desktop_build_version\n if: needs.create_tag.outputs.platform == 'desktop' && needs.create_tag.outputs.ref_name == 'main'\n run: |\n git fetch --tags --force\n latest_tag=\"$(git tag -l 'desktop-build/v*' --sort=-v:refname | head -n 1)\"\n if [ -z \"$latest_tag\" ]; then\n last_build=110\n else\n last_build=\"${latest_tag#desktop-build/v}\"\n fi\n\n next_build=$((last_build + 1))\n build_tag=\"desktop-build/v${next_build}\"\n\n if git rev-parse \"$build_tag\" >/dev/null 2>&1; then\n echo \"Build tag $build_tag already exists.\"\n exit 1\n fi\n\n git tag \"$build_tag\"\n git push origin \"$build_tag\"\n echo \"build_version=${next_build}\" >> \"$GITHUB_OUTPUT\"\n echo \"Desktop build version: ${next_build}\"\n\n - name: Trigger Desktop Tag Version Build\n if: needs.create_tag.outputs.platform == 'desktop' && needs.create_tag.outputs.ref_name == 'main'\n uses: actions/github-script@v8\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n const response = await github.rest.actions.createWorkflowDispatch({\n owner: context.repo.owner,\n repo: context.repo.repo,\n workflow_id: 'build-desktop.yml',\n ref: 'main',\n inputs: {\n tag_version: 'true',\n store: 'false'\n }\n });\n console.log('Desktop Tag Version build triggered successfully');\n\n - name: Trigger Desktop Store Build\n if: needs.create_tag.outputs.platform == 'desktop' && needs.create_tag.outputs.ref_name == 'main'\n uses: actions/github-script@v8\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n const response = await github.rest.actions.createWorkflowDispatch({\n owner: context.repo.owner,\n repo: context.repo.repo,\n workflow_id: 'build-desktop.yml',\n ref: 'main',\n inputs: {\n tag_version: 'false',\n store: 'true',\n build_version: '${{ steps.desktop_build_version.outputs.build_version }}'\n }\n });\n console.log('Desktop store build triggered successfully');\n\n - name: Trigger Mobile Preview Release Build\n if: needs.create_tag.outputs.platform == 'mobile' && needs.create_tag.outputs.ref_name == 'mobile-main'\n uses: actions/github-script@v8\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n const response = await github.rest.actions.createWorkflowDispatch({\n owner: context.repo.owner,\n repo: context.repo.repo,\n workflow_id: 'build-android.yml',\n ref: 'mobile-main',\n inputs: {\n profile: 'preview',\n release: 'true'\n }\n });\n console.log('Mobile preview release build triggered successfully');\n\n - name: Trigger Mobile Production Android Build\n if: needs.create_tag.outputs.platform == 'mobile' && needs.create_tag.outputs.ref_name == 'mobile-main'\n uses: actions/github-script@v8\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n const response = await github.rest.actions.createWorkflowDispatch({\n owner: context.repo.owner,\n repo: context.repo.repo,\n workflow_id: 'build-android.yml',\n ref: 'mobile-main',\n inputs: {\n profile: 'production',\n release: 'false'\n }\n });\n console.log('Mobile production Android build triggered successfully');\n\n - name: Trigger Mobile Production iOS Build\n if: needs.create_tag.outputs.platform == 'mobile' && needs.create_tag.outputs.ref_name == 'mobile-main'\n uses: actions/github-script@v8\n with:\n github-token: ${{ secrets.GITHUB_TOKEN }}\n script: |\n const response = await github.rest.actions.createWorkflowDispatch({\n owner: context.repo.owner,\n repo: context.repo.repo,\n workflow_id: 'build-ios.yml',\n ref: 'mobile-main',\n inputs: {\n profile: 'production'\n }\n });\n console.log('Mobile production iOS build triggered successfully');\n" }, { "path": ".github/workflows/translator.yml", "content": "name: \"🌍 translator\"\non:\n issues:\n types: [opened, edited]\n issue_comment:\n types: [created, edited]\n discussion:\n types: [created, edited]\n discussion_comment:\n types: [created, edited]\n\njobs:\n translate:\n permissions:\n issues: write\n discussions: write\n pull-requests: write\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v6\n - uses: lizheming/github-translate-action@c55aac477e98562d4faed9f77c54ab8306ae6ebf\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n with:\n IS_MODIFY_TITLE: true\n" }, { "path": ".gitignore", "content": "node_modules\ndist\nout\n.next\n.open-next\nnext-env.d.ts\n.DS_Store\n*.log*\n.env\n.eslintcache\n.env.*\n!.env.example\n\n# Sentry Config File\n.env.sentry-build-plugin\n.vercel\nstats.html\n\nelectron.vite.config.*.mjs\nvite.config.*.mjs\n\n.generated\n.turbo\n\napps/desktop/src/renderer/dev-dist\ntsconfig.tsbuildinfo\nbuildServer.json\n\n**/**/generated-routes.ts\n\napps/desktop/build/appxmanifest.xml\napps/desktop/resources/cli\n\n.claude/settings.local.json\n.serena\n\n.wrangler\n\n# Local agent artifacts\n.codex/\n\n# E2E outputs\n/apps/desktop/e2e/playwright-report/\n/apps/desktop/e2e/test-results/\n/apps/mobile/e2e/artifacts/\n/apps/mobile/report.xml\n/report.xml\n\n# Mobile local E2E build artifacts\napps/mobile/build-*.tar.gz\n" }, { "path": ".npmrc", "content": "shamefully-hoist=true\nnode-linker=hoisted\nsave-exact=true\n" }, { "path": ".nvmrc", "content": "stable\n" }, { "path": ".prettierignore", "content": "pnpm-lock.yaml\n\nCHANGELOG.md\n.context\n\napps/external/postcss.config.cjs\n\napps/mobile/android\napps/mobile/ios\napps/mobile/native/example\n\napps/mobile/native/android\napps/mobile/native/ios\napps/mobile/.expo\n\ngenerated-routes.ts\n" }, { "path": ".prettierrc.mjs", "content": "/** @type {import(\"prettier\").Config & import(\"prettier-plugin-tailwindcss\").PluginOptions} */\nexport default {\n semi: false,\n singleQuote: false,\n printWidth: 100,\n tabWidth: 2,\n trailingComma: \"all\",\n objectWrap: \"preserve\",\n plugins: [\"prettier-plugin-tailwindcss\"],\n tailwindConfig: \"./apps/desktop/tailwind.config.ts\",\n overrides: [\n {\n files: \"apps/mobile/**/*.{css,js,jsx,ts,tsx}\",\n options: {\n tailwindConfig: \"./apps/mobile/tailwind.config.ts\",\n },\n },\n {\n files: \"apps/mobile/web-app/html-renderer/**/*.{css,js,jsx,ts,tsx}\",\n options: {\n tailwindConfig: \"./apps/mobile/web-app/html-renderer/tailwind.config.ts\",\n },\n },\n {\n files: \"apps/ssr/**/*.{css,html,js,jsx,ts,tsx}\",\n options: {\n tailwindConfig: \"./apps/ssr/tailwind.config.ts\",\n },\n },\n ],\n}\n" }, { "path": ".vscode/extensions.json", "content": "{\n \"recommendations\": [\n \"dbaeumer.vscode-eslint\",\n \"johnsoncodehk.vscode-tsslint\",\n \"esbenp.prettier-vscode\",\n \"bradlc.vscode-tailwindcss\"\n ]\n}\n" }, { "path": ".vscode/launch.json", "content": "{\n \"version\": \"0.2.0\",\n \"configurations\": [\n {\n \"name\": \"Debug Main Process\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"cwd\": \"${workspaceRoot}\",\n \"runtimeExecutable\": \"${workspaceRoot}/node_modules/.bin/electron-vite\",\n \"windows\": {\n \"runtimeExecutable\": \"${workspaceRoot}/node_modules/.bin/electron-vite.cmd\"\n },\n \"runtimeArgs\": [\"--sourcemap\"],\n \"env\": {\n \"REMOTE_DEBUGGING_PORT\": \"9222\"\n }\n },\n {\n \"name\": \"Debug Renderer Process\",\n \"port\": 9222,\n \"request\": \"attach\",\n \"type\": \"chrome\",\n \"webRoot\": \"${workspaceFolder}/src/renderer\",\n \"timeout\": 60000,\n \"presentation\": {\n \"hidden\": true\n }\n }\n ],\n \"compounds\": [\n {\n \"name\": \"Debug All\",\n \"configurations\": [\"Debug Main Process\", \"Debug Renderer Process\"],\n \"presentation\": {\n \"order\": 1\n }\n }\n ]\n}\n" }, { "path": ".vscode/settings.json", "content": "{\n \"editor.formatOnSave\": true,\n \"editor.defaultFormatter\": \"esbenp.prettier-vscode\",\n \"[javascript][javascriptreact][typescript][typescriptreact][json][jsonc]\": {\n \"editor.codeActionsOnSave\": {\n \"source.fixAll.eslint\": \"explicit\"\n }\n },\n \"files.associations\": {\n \"*.css\": \"tailwindcss\"\n },\n \"tailwindCSS.experimental.classRegex\": [\n [\"cva\\\\(([^)]*)\\\\)\", \"[\\\"'`]([^\\\"'`]*).*?[\\\"'`]\"],\n [\"cx\\\\(([^)]*)\\\\)\", \"(?:'|\\\"|`)([^']*)(?:'|\\\"|`)\"],\n [\"tw`([^`]*)`\", \"([^`]*)\"],\n [\"[a-zA-Z]+[cC]lass[nN]ame[\\\"'`]?:\\\\s*[\\\"'`]([^\\\"'`]*)[\\\"'`]\", \"([^\\\"'`]*)\"],\n [\"[a-zA-Z]+[cC]lass[nN]ame\\\\s*=\\\\s*[\\\"'`]([^\\\"'`]*)[\\\"'`]\", \"([^\\\"'`]*)\"]\n ],\n \"github.copilot.chat.codeGeneration.useInstructionFiles\": true,\n \"tailwindCSS.experimental.configFile\": {\n \"apps/mobile/tailwind.config.ts\": \"apps/mobile/**\",\n \"apps/ssr/tailwind.config.ts\": \"apps/ssr/**\",\n \"apps/desktop/tailwind.config.ts\": [\"!apps/mobile/**\", \"!apps/ssr/**\", \"**\"]\n },\n \"typescript.tsserver.maxTsServerMemory\": 8096,\n \"typescript.tsserver.nodePath\": \"node\",\n // If you do not want to autofix some rules on save\n // You can put this in your user settings or workspace settings\n \"eslint.codeActionsOnSave.rules\": [\n \"!prefer-const\",\n \"!unused-imports/no-unused-imports\",\n \"!@stylistic/jsx-self-closing-comp\",\n \"!tailwindcss/classnames-order\",\n \"!arrow-body-style\",\n \"*\"\n ],\n // If you want to silent stylistic rules\n // You can put this in your user settings or workspace settings\n \"eslint.rules.customizations\": [\n {\n \"rule\": \"@stylistic/*\",\n \"severity\": \"off\",\n \"fixable\": true\n },\n {\n \"rule\": \"tailwindcss/classnames-order\",\n \"severity\": \"off\"\n },\n {\n \"rule\": \"antfu/consistent-list-newline\",\n \"severity\": \"off\"\n },\n {\n \"rule\": \"hyoban/jsx-attribute-spacing\",\n \"severity\": \"off\"\n },\n {\n \"rule\": \"simple-import-sort/*\",\n \"severity\": \"off\"\n },\n {\n \"rule\": \"prefer-const\",\n \"severity\": \"off\"\n },\n {\n \"rule\": \"unused-imports/no-unused-imports\",\n \"severity\": \"off\"\n }\n ],\n \"cSpell.words\": [\"Hydable\", \"rsshub\", \"Русский\"],\n // \"editor.foldingImportsByDefault\": true,\n \"commentTranslate.hover.enabled\": false,\n \"typescript.tsdk\": \"node_modules/typescript/lib\",\n \"i18n-ally.enabledFrameworks\": [\"i18next\"],\n \"i18n-ally.displayLanguage\": \"en\",\n \"i18n-ally.localesPaths\": [\"locales\"],\n \"i18n-ally.namespace\": true,\n \"i18n-ally.pathMatcher\": \"{namespaces}/{locale}.json\",\n \"lldb.library\": \"/Applications/Xcode.app/Contents/SharedFrameworks/LLDB.framework/Versions/A/LLDB\",\n \"lldb.launch.expressions\": \"native\",\n \"[swift]\": {\n \"editor.defaultFormatter\": \"swiftlang.swift-vscode\"\n },\n \"npm.exclude\": \"**/packages/**\"\n}\n" }, { "path": "AGENTS.md", "content": "# AGENTS.md\n\nThis file provides concise, agent-focused guidance for working in this monorepo. It consolidates the repository's CLAUDE.md guides, .cursor rules, Cursor rules improvements, and modern agent best practices.\n\n## Project overview\n\n- Monorepo managed by pnpm workspaces + Turbo.\n- Apps:\n - `apps/desktop` – Electron app (Vite + React renderer is the primary web app)\n - `apps/mobile` – React Native app via Expo\n - `apps/ssr` – Minimal SSR site for external sharing\n- Shared packages: `packages/internal` (components, atoms, hooks, store, utils, database, etc.).\n\n## Setup commands\n\n```bash\n# Install deps\npnpm install\n\n# Desktop – recommended (browser renderer)\ncd apps/desktop && pnpm run dev:web\n\n# Desktop – full Electron\ncd apps/desktop && pnpm run dev:electron\n\n# Mobile – Expo\ncd apps/mobile && pnpm run dev\n# or target platforms\ncd apps/mobile && pnpm run ios\ncd apps/mobile && pnpm run android\n\n# SSR\ncd apps/ssr && pnpm run dev\n\n# Build web version (desktop renderer)\npnpm run build:web\n```\n\n## Quality gates (must-pass before commit/PR)\n\n```bash\n# 1) Typecheck first (required)\npnpm run typecheck\n\n# 2) Lint and auto-fix\npnpm run lint:fix\n\n# 3) Tests\npnpm run test\n```\n\n- Run the above at the root, or use per-package variants as needed.\n- Follow this order strictly: typecheck → lint → test.\n- After every modification, run the following checks to catch errors early:\n\n```bash\nnpm exec turbo run format:check typecheck lint\nnpm exec turbo run test\n```\n\n## Code style and conventions\n\n- TypeScript strict; avoid `any` (use precise types). Comments in English. Keep solutions simple and maintainable.\n- Prefer CSS transitions/animations for simple UI interactions. Use JS-driven motion only when necessary to avoid frame drops.\n- Imports: use `pathe` instead of `node:path` for cross‑platform paths.\n- Organize shared, reusable UI in `packages/internal/components`; app-specific UI stays in its app.\n- **Style extraction**: Avoid inline styles in JSX. Extract complex styles (especially those using CSS variables, gradients, or multiple properties) to external style objects similar to React Native's `StyleSheet.create`. Place style objects in a `styles.ts` file alongside the component, using `CSSProperties` type for type safety.\n\n## Team preferences\n\n- Prefer CSS transitions/animations over JS-based motion for simple interactions to avoid frame drops.\n- Prefer simple, easy-to-maintain solutions.\n- Avoid using the `any` type in TypeScript.\n- Write code comments in English.\n\n## Architecture quick reference\n\n- State: Jotai for atoms, Zustand for complex stores, TanStack Query for server state.\n- Database: Drizzle + SQLite (see `packages/internal/database`).\n- Error handling: custom utils in `packages/internal/utils`; Sentry integrated.\n- i18n: i18next with flat keys only; no `defaultValue`. Provide `en`, `zh-CN`, `ja` for each feature. Avoid conflicting dotted keys.\n\n## UI system and design tokens\n\n### Tailwind + Apple UIKit colors (Desktop/Web)\n\n- Use Tailwind classes bound to Apple UIKit color tokens (light/dark adaptive). Prefix by CSS property:\n - System colors: `text-red`, `bg-blue`, `border-gray`, etc. for `red|orange|yellow|green|mint|teal|cyan|blue|indigo|purple|pink|brown|gray`.\n - Fill: `bg-fill[-secondary|-tertiary|-quaternary|-quinary]` and `bg-fill-vibrant[-secondary|-tertiary|-quaternary|-quinary]` (and `border-*` as needed).\n - Text: `text-text`, `text-text-secondary|tertiary|quaternary|quinary`, `text-text-vibrant(-secondary|-tertiary|-quaternary|-quinary)`.\n - Material: `bg-material-ultra-thick|thick|medium|thin|ultra-thin|opaque`.\n - Control: `bg-control-enabled|disabled`.\n - Interface: `bg-menu|popover|titlebar|sidebar|selection-focused|selection-focused-fill|selection-unfocused|selection-unfocused-fill|header-view|tooltip|under-window-background`.\n\nThese classes map to the UIKit color variables (see `.cursor rules/color` and `apps/desktop/AGENTS.md`).\n\n### Icons (Desktop/Web)\n\n- Prefer MingCute with `i-mgc-` prefix (e.g., `i-mgc-copy-cute-re`). Use `i-mingcute-` only if no `i-mgc-` exists.\n\n### Motion (Desktop/Web)\n\n- Use Framer Motion with LazyMotion via `m` from `motion/react` (e.g., `m.div`).\n- Prefer spring presets from `@follow/components/constants/spring.js` (`Spring.presets.smooth|snappy|bouncy`).\n- For simple micro-interactions, prefer CSS transitions first.\n\n### React Native (Mobile)\n\n- Styling: NativewindCSS; do not use external `StyleSheet.create` for new UI.\n- Icons: use `@/apps/mobile/icons` only.\n- Colors: use React Native UIKit color system (via `react-native-uikit-colors`) with Tailwind utilities:\n - Backgrounds: `system-background`, `secondary-system-background`, `tertiary-system-background`.\n - Grouped backgrounds: `system-grouped-background`, `secondary-system-grouped-background`, `tertiary-system-grouped-background`.\n - Labels: `label`, `secondary-label`, `tertiary-label`, `quaternary-label`.\n - Fills: `system-fill`, `secondary-system-fill`, `tertiary-system-fill`, `quaternary-system-fill`.\n - Separators: `separator`, `opaque-separator`, `non-opaque-separator`.\n - Semantic colors: `red|orange|yellow|green|mint|teal|cyan|blue|indigo|purple|pink|brown`, grays `gray..gray6`, and interactive `link`, `placeholder-text`.\n\n## Component placement\n\n1. Check existing components in `apps/desktop/layer/renderer/src/modules/renderer/components` for app-specific UI.\n2. If generic and reusable, implement in `packages/internal/components` and export from the package index.\n\n## Testing & CI tips\n\n- Use Vitest for unit tests; co-locate tests near source files.\n- After moving files or changing imports, run `pnpm lint` and `pnpm typecheck` for the affected package.\n- CI expects `pnpm typecheck`, `pnpm lint`, and `pnpm test` to pass before merge.\n\n## Agent workflow (Cursor-oriented improvements)\n\n- Status updates: provide brief progress notes when running tool batches.\n- Prefer semantic code search to explore unfamiliar areas; use exact grep only for symbols.\n- Default to parallelizing independent searches/reads to reduce latency.\n- Avoid multi-line speculative edits; keep edits minimal and targeted; preserve existing indentation.\n- When editing TypeScript, do not introduce `any`; keep types precise.\n- For UI, prefer CSS transitions for simple effects; use Framer Motion `m.*` only when needed.\n\n## Context7 (up-to-date docs)\n\n- Use Context7 to fetch current library docs before using APIs prone to change.\n- Workflow:\n 1. Resolve a library ID: resolve the library (e.g., React Native, Vite, TanStack Query).\n 2. Fetch docs scoped to the topic (e.g., hooks, routing).\n 3. Integrate code examples following our style rules.\n\n## Sequential Thinking (step-by-step problem solving)\n\n- Break work into small thought steps:\n 1. Define immediate goal/assumption.\n 2. Use suitable tool (search, code edit, error explainer, docs).\n 3. Record the output/results.\n 4. Decide next step or branch alternatives; compare trade-offs.\n- Encourage rollback/iteration if new information contradicts prior steps.\n\n## Subproject guides\n\n- This root AGENTS.md sets global rules. Each app/package should include its own `AGENTS.md` (e.g., `apps/desktop/AGENTS.md`, `apps/mobile/AGENTS.md`). The closest guide to the edited file takes precedence when rules conflict.\n\n## Quick checklists\n\n- Implementation\n - [ ] Is code placed in the right package/app?\n - [ ] Type-safe (no `any`), readable names, English comments where needed.\n - [ ] Uses correct UIKit Tailwind tokens and icon sources.\n - [ ] For motion: CSS first; `m.*` only if necessary.\n\n- Validation\n - [ ] `pnpm typecheck` passes\n - [ ] `pnpm lint:fix` passes cleanly\n - [ ] Tests updated and pass\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as\ncontributors and maintainers pledge to making participation in our project and\nour community a harassment-free experience for everyone, regardless of age, body\nsize, disability, ethnicity, sex characteristics, gender identity and expression,\nlevel of experience, education, socio-economic status, nationality, personal\nappearance, race, religion, or sexual identity and orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment\ninclude:\n\n- Using welcoming and inclusive language\n- Being respectful of differing viewpoints and experiences\n- Gracefully accepting constructive criticism\n- Focusing on what is best for the community\n- Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n- The use of sexualized language or imagery and unwelcome sexual attention or\n advances\n- Trolling, insulting/derogatory comments, and personal or political attacks\n- Public or private harassment\n- Publishing others' private information, such as a physical or electronic\n address, without explicit permission\n- Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable\nbehavior and are expected to take appropriate and fair corrective action in\nresponse to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or\nreject comments, commits, code, wiki edits, issues, and other contributions\nthat are not aligned to this Code of Conduct, or to ban temporarily or\npermanently any contributor for other behaviors that they deem inappropriate,\nthreatening, offensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces\nwhen an individual is representing the project or its community. Examples of\nrepresenting a project or community include using an official project e-mail\naddress, posting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event. Representation of a project may be\nfurther defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported by contacting the project team at follow@rss3.io. All\ncomplaints will be reviewed and investigated and will result in a response that\nis deemed necessary and appropriate to the circumstances. The project team is\nobligated to maintain confidentiality with regard to the reporter of an incident.\nFurther details of specific enforcement policies may be posted separately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good\nfaith may face temporary or permanent repercussions as determined by other\nmembers of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,\navailable at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html\n\n[homepage]: https://www.contributor-covenant.org\n\nFor answers to common questions about this code of conduct, see\nhttps://www.contributor-covenant.org/faq\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing to Folo\n\nThank you for considering contributing to Folo! We welcome contributions from the community to help improve and expand the project.\n\n## Getting Started\n\nBefore you start contributing, please ensure you have enabled [Corepack](https://nodejs.org/api/corepack.html). Corepack ensures you are using the correct version of the package manager specified in the `package.json`.\n\n```sh\ncorepack enable && corepack prepare\n```\n\n### Installing Dependencies\n\nTo install the necessary dependencies, run:\n\n```sh\npnpm install\n```\n\n## Development Setup\n\n### Develop in the Browser\n\nFor a more convenient development experience, we recommend developing in the browser:\n\n```sh\ncd apps/desktop && pnpm run dev:web\n```\n\nThis will open the browser at `https://app.folo.is/__debug_proxy`, allowing you to access the online API environment for development and debugging.\n\n### Develop in Electron\n\nIf you prefer to develop in Electron, follow these steps:\n\n0. Go to the `apps/desktop` directory:\n\n ```sh\n cd apps/desktop\n ```\n\n1. Copy the example environment variables file:\n\n ```sh\n cp .env.example .env\n ```\n\n2. Set `VITE_API_URL` to `https://api.follow.is` in your `.env` file.\n\n3. Run the development server:\n\n ```sh\n pnpm run dev:electron\n ```\n\n> **Tip:** If you encounter login issues, copy the `__Secure-better-auth.session_token` from your browser's cookies into the app.\n\n### Develop in External SSR Web App\n\nTo develop in SSR, follow these steps:\n\n1. Go to the `apps/ssr` directory:\n\n ```sh\n cd apps/ssr\n ```\n\n2. Run the development server:\n\n ```sh\n pnpm run dev\n ```\n\n### Develop in Mobile App\n\nTo develop in the mobile app, follow these steps:\n\n> [!NOTE]\n> You need to have a Mac device to develop in the mobile app.\n>\n> And already installed Xcode and the necessary dependencies.\n\n1. Go to the `apps/mobile` directory:\n\n ```sh\n cd apps/mobile\n ```\n\n2. Copy the example environment variables file:\n\n ```sh\n cp .env.example .env\n ```\n\n Then set the required environment variables in your `.env` file:\n\n ```sh\n echo 'EXPO_PUBLIC_APP_CHECK_DEBUG_TOKEN=\"xxx\"' >> .env\n ```\n\n Or manually edit the `.env` file to add:\n\n ```\n EXPO_PUBLIC_APP_CHECK_DEBUG_TOKEN=\"xxx\"\n ```\n\n the value is any string.\n\n3. Build and install Folo(dev) app from source: (This step will take a while and only need to be done once)\n\n ```sh\n pnpm expo prebuild --clean # Optional\n pnpm run ios\n ```\n\n4. Run the development server:\n\n ```sh\n pnpm run dev\n ```\n\n#### Development Native Modules\n\nTo develop native iOS modules, follow these steps:\n\n1. Go to the `apps/mobile` directory:\n\n ```sh\n cd apps/mobile/ios\n ```\n\n2. Open project in Xcode:\n\n ```sh\n open Folo.xcworkspace\n ```\n\n3. Open `Pods` in left sidebar and select `FollowNative`:\n\n![](https://github.com/user-attachments/assets/a449c087-6d55-4cbd-bc4b-c61a08406e98)\n\n4. Build and run the project.\n\n## Contribution Guidelines\n\n- Ensure your code follows the project's coding standards and conventions.\n- Write clear, concise commit messages.\n- Include relevant tests for your changes.\n- Update documentation as necessary.\n\n## Community\n\nJoin our community to discuss ideas, ask questions, and share your contributions:\n\n- [Discord](https://discord.gg/AwWcAQ7euc)\n- [Twitter](https://x.com/intent/follow?screen_name=folo_is)\n\nWe look forward to your contributions!\n\n## License\n\nBy contributing to Folo, you agree that your contributions will be licensed under the GNU Affero General Public License version 3, with the special exceptions noted in the `README.md`.\n" }, { "path": "LICENSE", "content": " GNU AFFERO GENERAL PUBLIC LICENSE\n Version 3, 19 November 2007\n\n Copyright (C) 2007 Free Software Foundation, Inc. \n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n Preamble\n\n The GNU Affero General Public License is a free, copyleft license for\nsoftware and other kinds of works, specifically designed to ensure\ncooperation with the community in the case of network server software.\n\n The licenses for most software and other practical works are designed\nto take away your freedom to share and change the works. By contrast,\nour General Public Licenses are intended to guarantee your freedom to\nshare and change all versions of a program--to make sure it remains free\nsoftware for all its users.\n\n When we speak of free software, we are referring to freedom, not\nprice. Our General Public Licenses are designed to make sure that you\nhave the freedom to distribute copies of free software (and charge for\nthem if you wish), that you receive source code or can get it if you\nwant it, that you can change the software or use pieces of it in new\nfree programs, and that you know you can do these things.\n\n Developers that use our General Public Licenses protect your rights\nwith two steps: (1) assert copyright on the software, and (2) offer\nyou this License which gives you legal permission to copy, distribute\nand/or modify the software.\n\n A secondary benefit of defending all users' freedom is that\nimprovements made in alternate versions of the program, if they\nreceive widespread use, become available for other developers to\nincorporate. Many developers of free software are heartened and\nencouraged by the resulting cooperation. However, in the case of\nsoftware used on network servers, this result may fail to come about.\nThe GNU General Public License permits making a modified version and\nletting the public access it on a server without ever releasing its\nsource code to the public.\n\n The GNU Affero General Public License is designed specifically to\nensure that, in such cases, the modified source code becomes available\nto the community. It requires the operator of a network server to\nprovide the source code of the modified version running there to the\nusers of that server. Therefore, public use of a modified version, on\na publicly accessible server, gives the public access to the source\ncode of the modified version.\n\n An older license, called the Affero General Public License and\npublished by Affero, was designed to accomplish similar goals. This is\na different license, not a version of the Affero GPL, but Affero has\nreleased a new version of the Affero GPL which permits relicensing under\nthis license.\n\n The precise terms and conditions for copying, distribution and\nmodification follow.\n\n TERMS AND CONDITIONS\n\n 0. Definitions.\n\n \"This License\" refers to version 3 of the GNU Affero General Public License.\n\n \"Copyright\" also means copyright-like laws that apply to other kinds of\nworks, such as semiconductor masks.\n\n \"The Program\" refers to any copyrightable work licensed under this\nLicense. Each licensee is addressed as \"you\". \"Licensees\" and\n\"recipients\" may be individuals or organizations.\n\n To \"modify\" a work means to copy from or adapt all or part of the work\nin a fashion requiring copyright permission, other than the making of an\nexact copy. The resulting work is called a \"modified version\" of the\nearlier work or a work \"based on\" the earlier work.\n\n A \"covered work\" means either the unmodified Program or a work based\non the Program.\n\n To \"propagate\" a work means to do anything with it that, without\npermission, would make you directly or secondarily liable for\ninfringement under applicable copyright law, except executing it on a\ncomputer or modifying a private copy. Propagation includes copying,\ndistribution (with or without modification), making available to the\npublic, and in some countries other activities as well.\n\n To \"convey\" a work means any kind of propagation that enables other\nparties to make or receive copies. Mere interaction with a user through\na computer network, with no transfer of a copy, is not conveying.\n\n An interactive user interface displays \"Appropriate Legal Notices\"\nto the extent that it includes a convenient and prominently visible\nfeature that (1) displays an appropriate copyright notice, and (2)\ntells the user that there is no warranty for the work (except to the\nextent that warranties are provided), that licensees may convey the\nwork under this License, and how to view a copy of this License. If\nthe interface presents a list of user commands or options, such as a\nmenu, a prominent item in the list meets this criterion.\n\n 1. Source Code.\n\n The \"source code\" for a work means the preferred form of the work\nfor making modifications to it. \"Object code\" means any non-source\nform of a work.\n\n A \"Standard Interface\" means an interface that either is an official\nstandard defined by a recognized standards body, or, in the case of\ninterfaces specified for a particular programming language, one that\nis widely used among developers working in that language.\n\n The \"System Libraries\" of an executable work include anything, other\nthan the work as a whole, that (a) is included in the normal form of\npackaging a Major Component, but which is not part of that Major\nComponent, and (b) serves only to enable use of the work with that\nMajor Component, or to implement a Standard Interface for which an\nimplementation is available to the public in source code form. A\n\"Major Component\", in this context, means a major essential component\n(kernel, window system, and so on) of the specific operating system\n(if any) on which the executable work runs, or a compiler used to\nproduce the work, or an object code interpreter used to run it.\n\n The \"Corresponding Source\" for a work in object code form means all\nthe source code needed to generate, install, and (for an executable\nwork) run the object code and to modify the work, including scripts to\ncontrol those activities. However, it does not include the work's\nSystem Libraries, or general-purpose tools or generally available free\nprograms which are used unmodified in performing those activities but\nwhich are not part of the work. For example, Corresponding Source\nincludes interface definition files associated with source files for\nthe work, and the source code for shared libraries and dynamically\nlinked subprograms that the work is specifically designed to require,\nsuch as by intimate data communication or control flow between those\nsubprograms and other parts of the work.\n\n The Corresponding Source need not include anything that users\ncan regenerate automatically from other parts of the Corresponding\nSource.\n\n The Corresponding Source for a work in source code form is that\nsame work.\n\n 2. Basic Permissions.\n\n All rights granted under this License are granted for the term of\ncopyright on the Program, and are irrevocable provided the stated\nconditions are met. This License explicitly affirms your unlimited\npermission to run the unmodified Program. The output from running a\ncovered work is covered by this License only if the output, given its\ncontent, constitutes a covered work. This License acknowledges your\nrights of fair use or other equivalent, as provided by copyright law.\n\n You may make, run and propagate covered works that you do not\nconvey, without conditions so long as your license otherwise remains\nin force. You may convey covered works to others for the sole purpose\nof having them make modifications exclusively for you, or provide you\nwith facilities for running those works, provided that you comply with\nthe terms of this License in conveying all material for which you do\nnot control copyright. Those thus making or running the covered works\nfor you must do so exclusively on your behalf, under your direction\nand control, on terms that prohibit them from making any copies of\nyour copyrighted material outside their relationship with you.\n\n Conveying under any other circumstances is permitted solely under\nthe conditions stated below. Sublicensing is not allowed; section 10\nmakes it unnecessary.\n\n 3. Protecting Users' Legal Rights From Anti-Circumvention Law.\n\n No covered work shall be deemed part of an effective technological\nmeasure under any applicable law fulfilling obligations under article\n11 of the WIPO copyright treaty adopted on 20 December 1996, or\nsimilar laws prohibiting or restricting circumvention of such\nmeasures.\n\n When you convey a covered work, you waive any legal power to forbid\ncircumvention of technological measures to the extent such circumvention\nis effected by exercising rights under this License with respect to\nthe covered work, and you disclaim any intention to limit operation or\nmodification of the work as a means of enforcing, against the work's\nusers, your or third parties' legal rights to forbid circumvention of\ntechnological measures.\n\n 4. Conveying Verbatim Copies.\n\n You may convey verbatim copies of the Program's source code as you\nreceive it, in any medium, provided that you conspicuously and\nappropriately publish on each copy an appropriate copyright notice;\nkeep intact all notices stating that this License and any\nnon-permissive terms added in accord with section 7 apply to the code;\nkeep intact all notices of the absence of any warranty; and give all\nrecipients a copy of this License along with the Program.\n\n You may charge any price or no price for each copy that you convey,\nand you may offer support or warranty protection for a fee.\n\n 5. Conveying Modified Source Versions.\n\n You may convey a work based on the Program, or the modifications to\nproduce it from the Program, in the form of source code under the\nterms of section 4, provided that you also meet all of these conditions:\n\n a) The work must carry prominent notices stating that you modified\n it, and giving a relevant date.\n\n b) The work must carry prominent notices stating that it is\n released under this License and any conditions added under section\n 7. This requirement modifies the requirement in section 4 to\n \"keep intact all notices\".\n\n c) You must license the entire work, as a whole, under this\n License to anyone who comes into possession of a copy. This\n License will therefore apply, along with any applicable section 7\n additional terms, to the whole of the work, and all its parts,\n regardless of how they are packaged. This License gives no\n permission to license the work in any other way, but it does not\n invalidate such permission if you have separately received it.\n\n d) If the work has interactive user interfaces, each must display\n Appropriate Legal Notices; however, if the Program has interactive\n interfaces that do not display Appropriate Legal Notices, your\n work need not make them do so.\n\n A compilation of a covered work with other separate and independent\nworks, which are not by their nature extensions of the covered work,\nand which are not combined with it such as to form a larger program,\nin or on a volume of a storage or distribution medium, is called an\n\"aggregate\" if the compilation and its resulting copyright are not\nused to limit the access or legal rights of the compilation's users\nbeyond what the individual works permit. Inclusion of a covered work\nin an aggregate does not cause this License to apply to the other\nparts of the aggregate.\n\n 6. Conveying Non-Source Forms.\n\n You may convey a covered work in object code form under the terms\nof sections 4 and 5, provided that you also convey the\nmachine-readable Corresponding Source under the terms of this License,\nin one of these ways:\n\n a) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by the\n Corresponding Source fixed on a durable physical medium\n customarily used for software interchange.\n\n b) Convey the object code in, or embodied in, a physical product\n (including a physical distribution medium), accompanied by a\n written offer, valid for at least three years and valid for as\n long as you offer spare parts or customer support for that product\n model, to give anyone who possesses the object code either (1) a\n copy of the Corresponding Source for all the software in the\n product that is covered by this License, on a durable physical\n medium customarily used for software interchange, for a price no\n more than your reasonable cost of physically performing this\n conveying of source, or (2) access to copy the\n Corresponding Source from a network server at no charge.\n\n c) Convey individual copies of the object code with a copy of the\n written offer to provide the Corresponding Source. This\n alternative is allowed only occasionally and noncommercially, and\n only if you received the object code with such an offer, in accord\n with subsection 6b.\n\n d) Convey the object code by offering access from a designated\n place (gratis or for a charge), and offer equivalent access to the\n Corresponding Source in the same way through the same place at no\n further charge. You need not require recipients to copy the\n Corresponding Source along with the object code. If the place to\n copy the object code is a network server, the Corresponding Source\n may be on a different server (operated by you or a third party)\n that supports equivalent copying facilities, provided you maintain\n clear directions next to the object code saying where to find the\n Corresponding Source. Regardless of what server hosts the\n Corresponding Source, you remain obligated to ensure that it is\n available for as long as needed to satisfy these requirements.\n\n e) Convey the object code using peer-to-peer transmission, provided\n you inform other peers where the object code and Corresponding\n Source of the work are being offered to the general public at no\n charge under subsection 6d.\n\n A separable portion of the object code, whose source code is excluded\nfrom the Corresponding Source as a System Library, need not be\nincluded in conveying the object code work.\n\n A \"User Product\" is either (1) a \"consumer product\", which means any\ntangible personal property which is normally used for personal, family,\nor household purposes, or (2) anything designed or sold for incorporation\ninto a dwelling. In determining whether a product is a consumer product,\ndoubtful cases shall be resolved in favor of coverage. For a particular\nproduct received by a particular user, \"normally used\" refers to a\ntypical or common use of that class of product, regardless of the status\nof the particular user or of the way in which the particular user\nactually uses, or expects or is expected to use, the product. A product\nis a consumer product regardless of whether the product has substantial\ncommercial, industrial or non-consumer uses, unless such uses represent\nthe only significant mode of use of the product.\n\n \"Installation Information\" for a User Product means any methods,\nprocedures, authorization keys, or other information required to install\nand execute modified versions of a covered work in that User Product from\na modified version of its Corresponding Source. The information must\nsuffice to ensure that the continued functioning of the modified object\ncode is in no case prevented or interfered with solely because\nmodification has been made.\n\n If you convey an object code work under this section in, or with, or\nspecifically for use in, a User Product, and the conveying occurs as\npart of a transaction in which the right of possession and use of the\nUser Product is transferred to the recipient in perpetuity or for a\nfixed term (regardless of how the transaction is characterized), the\nCorresponding Source conveyed under this section must be accompanied\nby the Installation Information. But this requirement does not apply\nif neither you nor any third party retains the ability to install\nmodified object code on the User Product (for example, the work has\nbeen installed in ROM).\n\n The requirement to provide Installation Information does not include a\nrequirement to continue to provide support service, warranty, or updates\nfor a work that has been modified or installed by the recipient, or for\nthe User Product in which it has been modified or installed. Access to a\nnetwork may be denied when the modification itself materially and\nadversely affects the operation of the network or violates the rules and\nprotocols for communication across the network.\n\n Corresponding Source conveyed, and Installation Information provided,\nin accord with this section must be in a format that is publicly\ndocumented (and with an implementation available to the public in\nsource code form), and must require no special password or key for\nunpacking, reading or copying.\n\n 7. Additional Terms.\n\n \"Additional permissions\" are terms that supplement the terms of this\nLicense by making exceptions from one or more of its conditions.\nAdditional permissions that are applicable to the entire Program shall\nbe treated as though they were included in this License, to the extent\nthat they are valid under applicable law. If additional permissions\napply only to part of the Program, that part may be used separately\nunder those permissions, but the entire Program remains governed by\nthis License without regard to the additional permissions.\n\n When you convey a copy of a covered work, you may at your option\nremove any additional permissions from that copy, or from any part of\nit. (Additional permissions may be written to require their own\nremoval in certain cases when you modify the work.) You may place\nadditional permissions on material, added by you to a covered work,\nfor which you have or can give appropriate copyright permission.\n\n Notwithstanding any other provision of this License, for material you\nadd to a covered work, you may (if authorized by the copyright holders of\nthat material) supplement the terms of this License with terms:\n\n a) Disclaiming warranty or limiting liability differently from the\n terms of sections 15 and 16 of this License; or\n\n b) Requiring preservation of specified reasonable legal notices or\n author attributions in that material or in the Appropriate Legal\n Notices displayed by works containing it; or\n\n c) Prohibiting misrepresentation of the origin of that material, or\n requiring that modified versions of such material be marked in\n reasonable ways as different from the original version; or\n\n d) Limiting the use for publicity purposes of names of licensors or\n authors of the material; or\n\n e) Declining to grant rights under trademark law for use of some\n trade names, trademarks, or service marks; or\n\n f) Requiring indemnification of licensors and authors of that\n material by anyone who conveys the material (or modified versions of\n it) with contractual assumptions of liability to the recipient, for\n any liability that these contractual assumptions directly impose on\n those licensors and authors.\n\n All other non-permissive additional terms are considered \"further\nrestrictions\" within the meaning of section 10. If the Program as you\nreceived it, or any part of it, contains a notice stating that it is\ngoverned by this License along with a term that is a further\nrestriction, you may remove that term. If a license document contains\na further restriction but permits relicensing or conveying under this\nLicense, you may add to a covered work material governed by the terms\nof that license document, provided that the further restriction does\nnot survive such relicensing or conveying.\n\n If you add terms to a covered work in accord with this section, you\nmust place, in the relevant source files, a statement of the\nadditional terms that apply to those files, or a notice indicating\nwhere to find the applicable terms.\n\n Additional terms, permissive or non-permissive, may be stated in the\nform of a separately written license, or stated as exceptions;\nthe above requirements apply either way.\n\n 8. Termination.\n\n You may not propagate or modify a covered work except as expressly\nprovided under this License. Any attempt otherwise to propagate or\nmodify it is void, and will automatically terminate your rights under\nthis License (including any patent licenses granted under the third\nparagraph of section 11).\n\n However, if you cease all violation of this License, then your\nlicense from a particular copyright holder is reinstated (a)\nprovisionally, unless and until the copyright holder explicitly and\nfinally terminates your license, and (b) permanently, if the copyright\nholder fails to notify you of the violation by some reasonable means\nprior to 60 days after the cessation.\n\n Moreover, your license from a particular copyright holder is\nreinstated permanently if the copyright holder notifies you of the\nviolation by some reasonable means, this is the first time you have\nreceived notice of violation of this License (for any work) from that\ncopyright holder, and you cure the violation prior to 30 days after\nyour receipt of the notice.\n\n Termination of your rights under this section does not terminate the\nlicenses of parties who have received copies or rights from you under\nthis License. If your rights have been terminated and not permanently\nreinstated, you do not qualify to receive new licenses for the same\nmaterial under section 10.\n\n 9. Acceptance Not Required for Having Copies.\n\n You are not required to accept this License in order to receive or\nrun a copy of the Program. Ancillary propagation of a covered work\noccurring solely as a consequence of using peer-to-peer transmission\nto receive a copy likewise does not require acceptance. However,\nnothing other than this License grants you permission to propagate or\nmodify any covered work. These actions infringe copyright if you do\nnot accept this License. Therefore, by modifying or propagating a\ncovered work, you indicate your acceptance of this License to do so.\n\n 10. Automatic Licensing of Downstream Recipients.\n\n Each time you convey a covered work, the recipient automatically\nreceives a license from the original licensors, to run, modify and\npropagate that work, subject to this License. You are not responsible\nfor enforcing compliance by third parties with this License.\n\n An \"entity transaction\" is a transaction transferring control of an\norganization, or substantially all assets of one, or subdividing an\norganization, or merging organizations. If propagation of a covered\nwork results from an entity transaction, each party to that\ntransaction who receives a copy of the work also receives whatever\nlicenses to the work the party's predecessor in interest had or could\ngive under the previous paragraph, plus a right to possession of the\nCorresponding Source of the work from the predecessor in interest, if\nthe predecessor has it or can get it with reasonable efforts.\n\n You may not impose any further restrictions on the exercise of the\nrights granted or affirmed under this License. For example, you may\nnot impose a license fee, royalty, or other charge for exercise of\nrights granted under this License, and you may not initiate litigation\n(including a cross-claim or counterclaim in a lawsuit) alleging that\nany patent claim is infringed by making, using, selling, offering for\nsale, or importing the Program or any portion of it.\n\n 11. Patents.\n\n A \"contributor\" is a copyright holder who authorizes use under this\nLicense of the Program or a work on which the Program is based. The\nwork thus licensed is called the contributor's \"contributor version\".\n\n A contributor's \"essential patent claims\" are all patent claims\nowned or controlled by the contributor, whether already acquired or\nhereafter acquired, that would be infringed by some manner, permitted\nby this License, of making, using, or selling its contributor version,\nbut do not include claims that would be infringed only as a\nconsequence of further modification of the contributor version. For\npurposes of this definition, \"control\" includes the right to grant\npatent sublicenses in a manner consistent with the requirements of\nthis License.\n\n Each contributor grants you a non-exclusive, worldwide, royalty-free\npatent license under the contributor's essential patent claims, to\nmake, use, sell, offer for sale, import and otherwise run, modify and\npropagate the contents of its contributor version.\n\n In the following three paragraphs, a \"patent license\" is any express\nagreement or commitment, however denominated, not to enforce a patent\n(such as an express permission to practice a patent or covenant not to\nsue for patent infringement). To \"grant\" such a patent license to a\nparty means to make such an agreement or commitment not to enforce a\npatent against the party.\n\n If you convey a covered work, knowingly relying on a patent license,\nand the Corresponding Source of the work is not available for anyone\nto copy, free of charge and under the terms of this License, through a\npublicly available network server or other readily accessible means,\nthen you must either (1) cause the Corresponding Source to be so\navailable, or (2) arrange to deprive yourself of the benefit of the\npatent license for this particular work, or (3) arrange, in a manner\nconsistent with the requirements of this License, to extend the patent\nlicense to downstream recipients. \"Knowingly relying\" means you have\nactual knowledge that, but for the patent license, your conveying the\ncovered work in a country, or your recipient's use of the covered work\nin a country, would infringe one or more identifiable patents in that\ncountry that you have reason to believe are valid.\n\n If, pursuant to or in connection with a single transaction or\narrangement, you convey, or propagate by procuring conveyance of, a\ncovered work, and grant a patent license to some of the parties\nreceiving the covered work authorizing them to use, propagate, modify\nor convey a specific copy of the covered work, then the patent license\nyou grant is automatically extended to all recipients of the covered\nwork and works based on it.\n\n A patent license is \"discriminatory\" if it does not include within\nthe scope of its coverage, prohibits the exercise of, or is\nconditioned on the non-exercise of one or more of the rights that are\nspecifically granted under this License. You may not convey a covered\nwork if you are a party to an arrangement with a third party that is\nin the business of distributing software, under which you make payment\nto the third party based on the extent of your activity of conveying\nthe work, and under which the third party grants, to any of the\nparties who would receive the covered work from you, a discriminatory\npatent license (a) in connection with copies of the covered work\nconveyed by you (or copies made from those copies), or (b) primarily\nfor and in connection with specific products or compilations that\ncontain the covered work, unless you entered into that arrangement,\nor that patent license was granted, prior to 28 March 2007.\n\n Nothing in this License shall be construed as excluding or limiting\nany implied license or other defenses to infringement that may\notherwise be available to you under applicable patent law.\n\n 12. No Surrender of Others' Freedom.\n\n If conditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot convey a\ncovered work so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you may\nnot convey it at all. For example, if you agree to terms that obligate you\nto collect a royalty for further conveying from those to whom you convey\nthe Program, the only way you could satisfy both those terms and this\nLicense would be to refrain entirely from conveying the Program.\n\n 13. Remote Network Interaction; Use with the GNU General Public License.\n\n Notwithstanding any other provision of this License, if you modify the\nProgram, your modified version must prominently offer all users\ninteracting with it remotely through a computer network (if your version\nsupports such interaction) an opportunity to receive the Corresponding\nSource of your version by providing access to the Corresponding Source\nfrom a network server at no charge, through some standard or customary\nmeans of facilitating copying of software. This Corresponding Source\nshall include the Corresponding Source for any work covered by version 3\nof the GNU General Public License that is incorporated pursuant to the\nfollowing paragraph.\n\n Notwithstanding any other provision of this License, you have\npermission to link or combine any covered work with a work licensed\nunder version 3 of the GNU General Public License into a single\ncombined work, and to convey the resulting work. The terms of this\nLicense will continue to apply to the part which is the covered work,\nbut the work with which it is combined will remain governed by version\n3 of the GNU General Public License.\n\n 14. Revised Versions of this License.\n\n The Free Software Foundation may publish revised and/or new versions of\nthe GNU Affero General Public License from time to time. Such new versions\nwill be similar in spirit to the present version, but may differ in detail to\naddress new problems or concerns.\n\n Each version is given a distinguishing version number. If the\nProgram specifies that a certain numbered version of the GNU Affero General\nPublic License \"or any later version\" applies to it, you have the\noption of following the terms and conditions either of that numbered\nversion or of any later version published by the Free Software\nFoundation. If the Program does not specify a version number of the\nGNU Affero General Public License, you may choose any version ever published\nby the Free Software Foundation.\n\n If the Program specifies that a proxy can decide which future\nversions of the GNU Affero General Public License can be used, that proxy's\npublic statement of acceptance of a version permanently authorizes you\nto choose that version for the Program.\n\n Later license versions may give you additional or different\npermissions. However, no additional obligations are imposed on any\nauthor or copyright holder as a result of your choosing to follow a\nlater version.\n\n 15. Disclaimer of Warranty.\n\n THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY\nAPPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT\nHOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY\nOF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,\nTHE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM\nIS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF\nALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n 16. Limitation of Liability.\n\n IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\nWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS\nTHE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY\nGENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE\nUSE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF\nDATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD\nPARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),\nEVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGES.\n\n 17. Interpretation of Sections 15 and 16.\n\n If the disclaimer of warranty and limitation of liability provided\nabove cannot be given local legal effect according to their terms,\nreviewing courts shall apply local law that most closely approximates\nan absolute waiver of all civil liability in connection with the\nProgram, unless a warranty or assumption of liability accompanies a\ncopy of the Program in return for a fee.\n\n END OF TERMS AND CONDITIONS\n\n How to Apply These Terms to Your New Programs\n\n If you develop a new program, and you want it to be of the greatest\npossible use to the public, the best way to achieve this is to make it\nfree software which everyone can redistribute and change under these terms.\n\n To do so, attach the following notices to the program. It is safest\nto attach them to the start of each source file to most effectively\nstate the exclusion of warranty; and each file should have at least\nthe \"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU Affero General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU Affero General Public License for more details.\n\n You should have received a copy of the GNU Affero General Public License\n along with this program. If not, see .\n\nAlso add information on how to contact you by electronic and paper mail.\n\n If your software can interact with users remotely through a computer\nnetwork, you should also make sure that it provides a way for users to\nget its source. For example, if your program is a web application, its\ninterface could display a \"Source\" link that leads users to an archive\nof the code. There are many ways you could offer source, and different\nsolutions will be better for different programs; see section 13 for the\nspecific requirements.\n\n You should also get your employer (if you work as a programmer) or school,\nif any, to sign a \"copyright disclaimer\" for the program, if necessary.\nFor more information on this, and how to apply and follow the GNU AGPL, see\n.\n\n---\n\nFolo is licensed under the GNU Affero General Public License version 3 with the addition of the following special exception:\n\nAll content in the `icons/mgc` directory is copyrighted by https://mgc.mingcute.com/ and cannot be redistributed.\n" }, { "path": "README.md", "content": "
\n \n \"Logo\"\n \n\n

Folo

\n

\n \n    \n \n
\n
\n \n \n \n \n \n \n
\n \n \n \n \n
\n
\n \n \"Folo\n \"Folo\n
\n
\n\n

\n
\n\nAs they say, your thoughts are what you read—and we’ve been consuming noisy feeds for too long! Folo organizes content into one timeline, keeping you updated on what matters, noise-free. Share lists, explore collections, and enjoy distraction-free browsing.\n\n## 👋🏻 Getting Started & Join Our Community\n\nWhether for users or professional developers, Folo will be your open information playground. Please be aware that Folo is currently under active development, and feedback is welcome for any [issue](https://github.com/RSSNext/Folo/issues) encountered.\n\nFeel free to try it using the following methods:\n\n| Operating System | Source |\n| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| Any | \"Browser\" |\n| iOS | \"App |\n| Android | \"Google \"App |\n| macOS | \"Microsoft \"App |\n| Windows | \"Microsoft \"App |\n| Linux | \"App |\n\nYou can also install using the following methods maintained by our community:\n\n- If you are using Arch Linux, you can install the package [folo-appimage](https://aur.archlinux.org/packages/folo-appimage) that is maintained by [timochan](https://github.com/ttimochan) and [grtsinry43](https://github.com/grtsinry43).\n- If you are using Nix, you can install the package [follow](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/fo/follow/package.nix) that is maintained by [iosmanthus](https://github.com/iosmanthus).\n- If you are using macOS with [Homebrew](https://brew.sh), you can install the cask [folo](https://formulae.brew.sh/cask/folo) that is maintained by [realSunyz](https://github.com/realSunyz).\n- If you are using Windows with [Scoop](https://scoop.sh), you can install the manifest [folo](https://github.com/cscnk52/cetacea/blob/master/bucket/folo.json) that is maintained by [cscnk52](https://github.com/cscnk52).\n\n| [![Discord](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Finvites%2Ffollowapp%3Fwith_counts%3Dtrue&query=approximate_member_count&color=5865F2&label=Discord&labelColor=black&logo=discord&logoColor=white&style=flat-square)](https://discord.gg/AwWcAQ7euc) | Join our Discord server to connect with developers, request features, and receive support. |\n| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------- |\n| [![](https://img.shields.io/badge/any_text-Follow-blue?color=2CA5E0&label=_&logo=x&labelColor=black&style=flat-square)](https://x.com/intent/follow?screen_name=folo_is) | Follow us on X/Twitter for product updates and to join in on reward activities. |\n\n> \\[!IMPORTANT]\n>\n> **Star Us**, You will receive all release notifications from GitHub without any delay \\~\n\n![Image](https://github.com/user-attachments/assets/a08f9437-b24c-4388-8f01-2826e09eeaf2)\n\n\n \n \n \"Performance\n \n\n\n## ✨ Features\n\n### Customized Information Hub\n\nSubscribe to a vast range of feeds and curated lists. Curate your favorites and keep track of what matters most to you.\n\n![](https://github.com/user-attachments/assets/11dc7d21-f5d8-4e41-9269-24fc352aa02b)\n\n### AI At Your Fingertips\n\nA smarter and more efficient browsing with AI-powered features like translation, summary, and more.\n\n![](https://github.com/user-attachments/assets/37cf4f2f-4c5e-4775-86e8-2fa1a1b2ecf5)\n\n### Dynamic Content Support\n\nBecause we know content is more than just text. From articles to videos, images to audio — Folo gets it all covered.\n\n![](https://github.com/user-attachments/assets/d1379fd6-8767-476e-b0dc-d61753715e26)\n\n### More Than Just An App\n\nThis isn’t just another app. Folo is a community — introducing a new era of openness and community-driven experience.\n\n![](https://github.com/user-attachments/assets/62004a04-eaea-4f5d-bfbf-4e68b6b90286)\n\n## 🤝 Contributing\n\nYou are welcome to join the open source community to build together, please check our [Contributing Guide](./CONTRIBUTING.md) for more details.\n\n## 🔏 Code signing policy\n\nFolo for Windows uses free code signing provided by [SignPath.io](https://about.signpath.io/), a certificate by [SignPath Foundation](https://signpath.org/).\n\nFolo for macOS and iOS is signed and notarized by [Apple Developer Program](https://developer.apple.com/programs/).\n\nAll released files are verified with [GitHub artifact attestations](https://github.com/RSSNext/Folo/attestations) to ensure their provenance and integrity.\n\n## 📝 License\n\nFolo is licensed under the GNU Affero General Public License version 3 with the addition of the following special exception:\n\nAll content in the `icons/mgc` directory is copyrighted by https://mgc.mingcute.com/ and cannot be redistributed.\n" }, { "path": "SECURITY.md", "content": "# Security Policy\n\n## Supported Versions\n\nWe always recommend using the latest version of Follow to ensure you get all security updates.\n\n## Reporting a Vulnerability\n\nPlease report security vulnerabilities to follow@rss3.io.\n" }, { "path": "api/vercel_webhook.ts", "content": "import crypto from \"node:crypto\"\n\nimport type { VercelRequest, VercelResponse } from \"@vercel/node\"\nimport getRawBody from \"raw-body\"\n\nexport default async function handler(request: VercelRequest, response: VercelResponse) {\n const { WEBHOOK_SECRET: INTEGRATION_SECRET } = process.env\n\n if (typeof INTEGRATION_SECRET != \"string\") {\n return response.status(400).json({\n code: \"invalid_secret\",\n error: \"No integration secret found\",\n })\n }\n\n const rawBody = await getRawBody(request)\n const bodySignature = sha1(rawBody, INTEGRATION_SECRET)\n\n if (bodySignature !== request.headers[\"x-vercel-signature\"]) {\n return response.status(403).json({\n code: \"invalid_signature\",\n error: \"signature didn't match\",\n })\n }\n\n const json = JSON.parse(rawBody.toString(\"utf-8\"))\n\n switch (json.type) {\n // https://vercel.com/docs/observability/webhooks-overview/webhooks-api#deployment.succeeded\n case \"deployment.succeeded\": {\n const { target } = json.payload || json.data\n\n if (target === \"production\") {\n await purgeCloudflareCache()\n } else {\n console.info(`Skipping non-production deployment: ${target}`, json)\n }\n }\n // ...\n }\n\n return response.status(200).end(\"OK\")\n}\n\nfunction sha1(data: Buffer, secret: string): string {\n return crypto.createHmac(\"sha1\", secret).update(data).digest(\"hex\")\n}\n\nexport const config = {\n api: {\n bodyParser: false,\n },\n}\n\nasync function purgeCloudflareCache() {\n const { CF_TOKEN, CF_ZONE_ID } = process.env\n\n if (typeof CF_TOKEN !== \"string\" || typeof CF_ZONE_ID !== \"string\") {\n throw new TypeError(\"No Cloudflare token or zone ID found\")\n }\n\n const apiUrl = `https://api.cloudflare.com/client/v4/zones/${CF_ZONE_ID}/purge_cache`\n\n const manifestPath = await fetch(`https://app.folo.is/assets/manifest.txt?t=${Date.now()}`).then(\n (res) => res.text(),\n )\n\n try {\n await fetch(apiUrl, {\n method: \"POST\",\n headers: {\n Authorization: CF_TOKEN,\n },\n body: JSON.stringify({\n tags: [\"follow-assets\"],\n }),\n })\n\n console.info(\"Successfully purged Cloudflare cache\")\n } catch {\n console.error(\"Failed to purge Cloudflare cache by tags, fallback to purge by files\")\n const allPath = manifestPath.split(\"\\n\").map((path) => `https://app.folo.is/${path}`)\n\n // Function to delay execution\n const delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))\n\n const taskPromise = [] as Promise[]\n // Batch processing\n for (let i = 0; i < allPath.length; i += 30) {\n const batch = allPath.slice(i, i + 30)\n\n const r = fetch(apiUrl, {\n method: \"POST\",\n headers: {\n Authorization: CF_TOKEN,\n },\n body: JSON.stringify({\n files: batch,\n }),\n })\n\n taskPromise.push(r)\n\n // Delay for 0.5 seconds between batches\n if (i + 30 < allPath.length) {\n await delay(500)\n }\n }\n\n const result = await Promise.allSettled(taskPromise)\n console.info(`Success: ${result.filter((r) => r.status === \"fulfilled\").length}`)\n console.info(`Failed: ${result.filter((r) => r.status === \"rejected\").length}`)\n }\n}\n" }, { "path": "apps/cli/package.json", "content": "{\n \"name\": \"folocli\",\n \"type\": \"module\",\n \"version\": \"0.0.1\",\n \"description\": \"Folo CLI for terminal workflows and automation\",\n \"author\": \"Folo Team\",\n \"license\": \"AGPL-3.0-only\",\n \"homepage\": \"https://github.com/RSSNext/Folo\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"git+https://github.com/RSSNext/Folo.git\"\n },\n \"keywords\": [\n \"folo\",\n \"rss\",\n \"reader\",\n \"cli\",\n \"automation\"\n ],\n \"bin\": {\n \"folo\": \"./dist/index.js\"\n },\n \"files\": [\n \"dist\",\n \"skill.md\"\n ],\n \"engines\": {\n \"node\": \">=18\"\n },\n \"scripts\": {\n \"build\": \"tsup --config tsup.config.ts && chmod +x dist/index.js\",\n \"dev\": \"tsx src/index.ts\",\n \"start\": \"node dist/index.js\",\n \"test\": \"pnpm run build && vitest run\",\n \"typecheck\": \"tsc --noEmit\"\n },\n \"dependencies\": {\n \"@follow-app/client-sdk\": \"catalog:\",\n \"commander\": \"14.0.1\",\n \"pathe\": \"2.0.3\"\n },\n \"devDependencies\": {\n \"@follow/configs\": \"workspace:*\",\n \"@types/node\": \"25.2.3\",\n \"tsup\": \"8.5.0\",\n \"tsx\": \"4.21.0\",\n \"typescript\": \"catalog:\"\n }\n}\n" }, { "path": "apps/cli/skill.md", "content": "# Folo CLI Skill\n\n## Trigger Conditions\n\nUse this skill when a user asks to:\n\n- Manage RSS subscriptions\n- Browse timeline entries\n- Read entry details or readability content\n- Mark entries as read/unread\n- Search feeds/lists or trending sources\n- Import/export OPML\n- Check unread counts\n\n## Preconditions\n\n1. Node.js and npm are installed so the CLI can be executed with `npx`.\n2. Authentication is configured:\n - `npx --yes folocli@latest login` (recommended, opens browser and auto-logins)\n - or `npx --yes folocli@latest login --token `\n - or set `FOLO_TOKEN=`\n\n## Execution Policy\n\n- Prefer `npx --yes folocli@latest ...` for all agent runs.\n- Do not require `npm install -g folocli`.\n- No separate update preflight is needed. Using `folocli@latest` is the update strategy.\n- If a user already has a working global `folo` binary, it is acceptable, but `npx --yes folocli@latest` remains the recommended default in docs and automation.\n\n## Output Contract\n\nDefault output is JSON with a stable envelope:\n\n```json\n{\n \"ok\": true,\n \"data\": {},\n \"error\": null\n}\n```\n\nErrors return:\n\n```json\n{\n \"ok\": false,\n \"data\": null,\n \"error\": {\n \"code\": \"UNAUTHORIZED\",\n \"message\": \"Token is invalid or expired.\"\n }\n}\n```\n\nYou can switch output mode:\n\n- `--format json` (default)\n- `--format table`\n- `--format plain`\n\n## Core Workflows\n\n### 1. Timeline Reading\n\n1. Fetch timeline:\n - `npx --yes folocli@latest timeline --limit 10`\n2. Get entry detail:\n - `npx --yes folocli@latest entry get `\n3. Get readability content:\n - `npx --yes folocli@latest entry read `\n\n### 2. Subscription Management\n\n1. Discover:\n - `npx --yes folocli@latest search discover `\n2. Add subscription:\n - `npx --yes folocli@latest subscription add --feed `\n - or `npx --yes folocli@latest subscription add --list `\n3. List subscriptions:\n - `npx --yes folocli@latest subscription list`\n\n### 3. Unread Processing\n\n1. Check unread total:\n - `npx --yes folocli@latest unread count`\n2. List unread subscriptions:\n - `npx --yes folocli@latest unread list`\n3. Read unread entries:\n - `npx --yes folocli@latest timeline --unread-only --limit 20`\n4. Mark read:\n - `npx --yes folocli@latest entry mark-read `\n - or batch: `npx --yes folocli@latest entry mark-all-read --view articles`\n\n### 4. Collection Operations\n\n- Add: `npx --yes folocli@latest collection add `\n- Remove: `npx --yes folocli@latest collection remove `\n- List: `npx --yes folocli@latest collection list --limit 20`\n\n### 5. OPML Import / Export\n\n- Export:\n - `npx --yes folocli@latest opml export --output backup.opml`\n- Import:\n - `npx --yes folocli@latest opml import feeds.opml`\n\n## Pagination Pattern\n\n`npx --yes folocli@latest timeline` returns:\n\n- `entries`\n- `nextCursor`\n- `hasNext`\n\nLoop until `hasNext` is `false`:\n\n1. `npx --yes folocli@latest timeline --limit 20`\n2. Read `nextCursor`\n3. `npx --yes folocli@latest timeline --limit 20 --cursor `\n4. Repeat\n\n## Command Reference\n\n- `npx --yes folocli@latest login [--timeout ] [--token ]`\n- `npx --yes folocli@latest logout`\n- `npx --yes folocli@latest whoami`\n- `npx --yes folocli@latest auth login [--timeout ] [--token ]`\n- `npx --yes folocli@latest auth logout`\n- `npx --yes folocli@latest auth whoami`\n\n- `npx --yes folocli@latest timeline [--view ] [--limit ] [--unread-only] [--cursor ]`\n- `npx --yes folocli@latest timeline --feed [--limit ] [--cursor ]`\n- `npx --yes folocli@latest timeline --list [--limit ] [--cursor ]`\n- `npx --yes folocli@latest timeline --category [--view ] [--limit ]`\n\n- `npx --yes folocli@latest subscription list [--view ] [--category ]`\n- `npx --yes folocli@latest subscription add --feed [--category ] [--view ] [--private]`\n- `npx --yes folocli@latest subscription add --list [--category ] [--view ]`\n- `npx --yes folocli@latest subscription remove [--target feed|list|url]`\n- `npx --yes folocli@latest subscription update [--target feed|list] [--category ] [--title ] [--view <type>] [--private|--public]`\n\n- `npx --yes folocli@latest entry get <entryId>`\n- `npx --yes folocli@latest entry read <entryId>`\n- `npx --yes folocli@latest entry mark-read <entryId>`\n- `npx --yes folocli@latest entry mark-unread <entryId>`\n- `npx --yes folocli@latest entry mark-all-read [--feed <feedId>] [--list <listId>] [--view <type>]`\n\n- `npx --yes folocli@latest feed get <feedId|feedUrl>`\n- `npx --yes folocli@latest feed refresh <feedId>`\n- `npx --yes folocli@latest feed analytics <feedId>`\n\n- `npx --yes folocli@latest list ls`\n- `npx --yes folocli@latest list get <listId>`\n- `npx --yes folocli@latest list create --title <title> [--description <desc>] [--view <type>] [--fee <n>]`\n- `npx --yes folocli@latest list update <listId> [--title <title>] [--description <desc>] [--view <type>] [--fee <n>]`\n- `npx --yes folocli@latest list delete <listId>`\n- `npx --yes folocli@latest list add-feed <listId> --feed <feedId>`\n- `npx --yes folocli@latest list remove-feed <listId> --feed <feedId>`\n\n- `npx --yes folocli@latest search discover <keyword> [--type feeds|lists]`\n- `npx --yes folocli@latest search rsshub <keyword> [--lang <lang>]`\n- `npx --yes folocli@latest search trending [--range 1d|3d|7d|30d] [--view <type>] [--limit <n>] [--language eng|cmn] [--category <keyword>]`\n\n- `npx --yes folocli@latest collection list [--limit <n>] [--cursor <datetime>]`\n- `npx --yes folocli@latest collection add <entryId> [--view <type>]`\n- `npx --yes folocli@latest collection remove <entryId>`\n\n- `npx --yes folocli@latest opml export [--output <file>]`\n- `npx --yes folocli@latest opml import <file> [--items <url1,url2,...>]`\n\n- `npx --yes folocli@latest unread count`\n- `npx --yes folocli@latest unread list [--view <type>]`\n\n## Error Recovery\n\n- `UNAUTHORIZED`\n - Re-login: `npx --yes folocli@latest login`\n - or `npx --yes folocli@latest login --token <token>`\n - Or set `FOLO_TOKEN`\n- `HTTP_4xx` / `HTTP_5xx`\n - Retry with `--verbose` for request details\n - Verify `--api-url` if using non-default endpoint\n- `INVALID_ARGUMENT`\n - Run `npx --yes folocli@latest <command> --help` to inspect accepted options\n" }, { "path": "apps/cli/src/args.test.ts", "content": "import { describe, expect, it } from \"vitest\"\n\nimport { parseFormat, parseISODate, parseNonNegativeInt, parsePositiveInt, parseView } from \"./args\"\n\ndescribe(\"args parsers\", () => {\n it(\"parses named view values\", () => {\n expect(parseView(\"articles\")).toBe(0)\n expect(parseView(\"social\")).toBe(1)\n expect(parseView(\"pictures\")).toBe(2)\n expect(parseView(\"videos\")).toBe(3)\n expect(parseView(\"audio\")).toBe(4)\n expect(parseView(\"notifications\")).toBe(5)\n })\n\n it(\"parses numeric view values\", () => {\n expect(parseView(\"0\")).toBe(0)\n expect(parseView(\"5\")).toBe(5)\n })\n\n it(\"throws for invalid view values\", () => {\n expect(() => parseView(\"foo\")).toThrowError(/Invalid view/)\n expect(() => parseView(\"6\")).toThrowError(/Invalid view/)\n })\n\n it(\"parses positive integers\", () => {\n expect(parsePositiveInt(\"1\")).toBe(1)\n expect(parsePositiveInt(\"99\")).toBe(99)\n })\n\n it(\"throws for non-positive integers\", () => {\n expect(() => parsePositiveInt(\"0\")).toThrowError(/positive integer/)\n expect(() => parsePositiveInt(\"-1\")).toThrowError(/positive integer/)\n })\n\n it(\"parses non-negative integers\", () => {\n expect(parseNonNegativeInt(\"0\")).toBe(0)\n expect(parseNonNegativeInt(\"3\")).toBe(3)\n })\n\n it(\"throws for negative integers\", () => {\n expect(() => parseNonNegativeInt(\"-1\")).toThrowError(/non-negative integer/)\n })\n\n it(\"parses ISO datetime\", () => {\n expect(parseISODate(\"2026-02-25T10:30:00Z\")).toBe(\"2026-02-25T10:30:00.000Z\")\n })\n\n it(\"throws for invalid datetime\", () => {\n expect(() => parseISODate(\"not-a-date\")).toThrowError(/Invalid datetime/)\n })\n\n it(\"parses output format\", () => {\n expect(parseFormat(\"json\")).toBe(\"json\")\n expect(parseFormat(\"table\")).toBe(\"table\")\n expect(parseFormat(\"plain\")).toBe(\"plain\")\n })\n\n it(\"throws for invalid output format\", () => {\n expect(() => parseFormat(\"yaml\")).toThrowError(/Invalid format/)\n })\n})\n" }, { "path": "apps/cli/src/args.ts", "content": "import type { OutputFormat } from \"./output\"\n\nconst viewMap: Readonly<Record<string, number>> = {\n article: 0,\n articles: 0,\n social: 1,\n socialmedia: 1,\n picture: 2,\n pictures: 2,\n video: 3,\n videos: 3,\n audio: 4,\n notification: 5,\n notifications: 5,\n}\n\nexport const viewHelp =\n \"articles(0) | social(1) | pictures(2) | videos(3) | audio(4) | notifications(5)\"\n\nexport const parseView = (value: string): number => {\n const normalized = value.trim().toLowerCase()\n if (/^\\d+$/.test(normalized)) {\n const parsed = Number.parseInt(normalized, 10)\n if (parsed >= 0 && parsed <= 5) {\n return parsed\n }\n }\n\n const mapped = viewMap[normalized]\n if (mapped !== undefined) {\n return mapped\n }\n\n throw new Error(`Invalid view \"${value}\". Use ${viewHelp}.`)\n}\n\nexport const parsePositiveInt = (value: string): number => {\n const parsed = Number.parseInt(value, 10)\n if (!Number.isInteger(parsed) || parsed <= 0) {\n throw new Error(`Expected a positive integer, got \"${value}\".`)\n }\n return parsed\n}\n\nexport const parseNonNegativeInt = (value: string): number => {\n const parsed = Number.parseInt(value, 10)\n if (!Number.isInteger(parsed) || parsed < 0) {\n throw new Error(`Expected a non-negative integer, got \"${value}\".`)\n }\n return parsed\n}\n\nexport const parseISODate = (value: string): string => {\n const timestamp = Date.parse(value)\n if (Number.isNaN(timestamp)) {\n throw new TypeError(`Invalid datetime value \"${value}\".`)\n }\n return new Date(timestamp).toISOString()\n}\n\nexport const parseFormat = (value: string): OutputFormat => {\n if (value === \"json\" || value === \"table\" || value === \"plain\") {\n return value\n }\n throw new Error(`Invalid format \"${value}\". Use json, table, or plain.`)\n}\n" }, { "path": "apps/cli/src/browser-login.test.ts", "content": "import { describe, expect, it } from \"vitest\"\n\nimport { DEFAULT_VALUES } from \"../../../packages/internal/shared/src/env.common\"\nimport { resolveCLILoginUrl } from \"./browser-login\"\n\ndescribe(\"browser login helpers\", () => {\n it(\"maps production API URL using env.common\", () => {\n const url = resolveCLILoginUrl(DEFAULT_VALUES.PROD.API_URL, \"http://127.0.0.1:12345/callback\")\n const parsed = new URL(url)\n\n expect(parsed.origin).toBe(new URL(DEFAULT_VALUES.PROD.WEB_URL).origin)\n expect(parsed.pathname).toBe(\"/login\")\n expect(parsed.searchParams.get(\"cli_callback\")).toBe(\"http://127.0.0.1:12345/callback\")\n })\n\n it(\"maps dev API URL using env.common\", () => {\n const url = resolveCLILoginUrl(DEFAULT_VALUES.DEV.API_URL, \"http://127.0.0.1:12345/callback\")\n const parsed = new URL(url)\n\n expect(parsed.origin).toBe(new URL(DEFAULT_VALUES.DEV.WEB_URL).origin)\n expect(parsed.pathname).toBe(\"/login\")\n expect(parsed.searchParams.get(\"cli_callback\")).toBe(\"http://127.0.0.1:12345/callback\")\n })\n\n it(\"maps local API URL using env.common\", () => {\n const url = resolveCLILoginUrl(DEFAULT_VALUES.LOCAL.API_URL, \"http://127.0.0.1:12345/callback\")\n const parsed = new URL(url)\n\n expect(parsed.origin).toBe(new URL(DEFAULT_VALUES.LOCAL.WEB_URL).origin)\n expect(parsed.pathname).toBe(\"/login\")\n expect(parsed.searchParams.get(\"cli_callback\")).toBe(\"http://127.0.0.1:12345/callback\")\n })\n\n it(\"falls back to API origin when no mapping exists\", () => {\n const url = resolveCLILoginUrl(\"https://api.follow.is\", \"http://localhost:3456/callback\")\n const parsed = new URL(url)\n\n expect(parsed.origin).toBe(\"https://api.follow.is\")\n expect(parsed.pathname).toBe(\"/login\")\n expect(parsed.searchParams.get(\"cli_callback\")).toBe(\"http://localhost:3456/callback\")\n })\n\n it(\"throws for invalid api url\", () => {\n expect(() => resolveCLILoginUrl(\"not-a-url\", \"http://127.0.0.1:3333/callback\")).toThrowError(\n /Invalid API URL/,\n )\n })\n})\n" }, { "path": "apps/cli/src/browser-login.ts", "content": "import { spawnSync } from \"node:child_process\"\nimport { createServer } from \"node:http\"\nimport type { AddressInfo } from \"node:net\"\n\nimport { DEFAULT_VALUES } from \"../../../packages/internal/shared/src/env.common\"\nimport { CLIError } from \"./output\"\n\nconst LOCAL_CALLBACK_HOST = \"127.0.0.1\"\nconst LOCAL_CALLBACK_PATH = \"/callback\"\nconst DEFAULT_TIMEOUT_MS = 3 * 60 * 1000\n\nconst mappedWebOrigins: Array<{ apiOrigin: string; webOrigin: string }> = [\n {\n apiOrigin: new URL(DEFAULT_VALUES.PROD.API_URL).origin,\n webOrigin: new URL(DEFAULT_VALUES.PROD.WEB_URL).origin,\n },\n {\n apiOrigin: new URL(DEFAULT_VALUES.DEV.API_URL).origin,\n webOrigin: new URL(DEFAULT_VALUES.DEV.WEB_URL).origin,\n },\n {\n apiOrigin: new URL(DEFAULT_VALUES.LOCAL.API_URL).origin,\n webOrigin: new URL(DEFAULT_VALUES.LOCAL.WEB_URL).origin,\n },\n]\n\nconst successPageHtml = `<!doctype html>\n<html lang=\"en\">\n <head>\n <meta charset=\"utf-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n <title>Folo CLI Login\n \n \n

Folo CLI login complete

\n

You can close this window and return to your terminal.

\n \n\n`\n\nconst failurePageHtml = `\n\n \n \n \n Folo CLI Login\n \n \n

Folo CLI login failed

\n

Missing token in callback URL. Please retry in terminal.

\n \n\n`\n\nconst getOpenBrowserCommand = (url: string): { command: string; args: string[] } => {\n if (process.platform === \"darwin\") {\n return { command: \"open\", args: [url] }\n }\n\n if (process.platform === \"win32\") {\n return { command: \"cmd\", args: [\"/c\", \"start\", \"\", url] }\n }\n\n return { command: \"xdg-open\", args: [url] }\n}\n\nconst openBrowser = (url: string) => {\n const { command, args } = getOpenBrowserCommand(url)\n const result = spawnSync(command, args, {\n stdio: \"ignore\",\n })\n\n if (result.error || result.status !== 0) {\n throw new CLIError(\n \"BROWSER_OPEN_FAILED\",\n `Failed to open browser automatically. Open this URL manually: ${url}`,\n )\n }\n}\n\nexport const resolveCLILoginUrl = (apiUrl: string, callbackUrl: string): string => {\n let api: URL\n try {\n api = new URL(apiUrl)\n } catch {\n throw new CLIError(\"INVALID_ARGUMENT\", `Invalid API URL: ${apiUrl}`)\n }\n\n const mappedWebOrigin = mappedWebOrigins.find((item) => item.apiOrigin === api.origin)?.webOrigin\n const webUrl = new URL(mappedWebOrigin ?? api.origin)\n\n webUrl.pathname = \"/login\"\n webUrl.search = \"\"\n webUrl.hash = \"\"\n webUrl.searchParams.set(\"cli_callback\", callbackUrl)\n\n return webUrl.toString()\n}\n\nexport interface BrowserLoginOptions {\n apiUrl: string\n timeoutMs?: number\n onStatus?: (message: string) => void\n}\n\nexport interface BrowserLoginResult {\n token: string\n callbackUrl: string\n loginUrl: string\n}\n\nexport const loginWithBrowser = async (\n options: BrowserLoginOptions,\n): Promise => {\n const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS\n const onStatus = options.onStatus ?? (() => {})\n\n if (timeoutMs <= 0) {\n throw new CLIError(\"INVALID_ARGUMENT\", \"Browser login timeout must be greater than 0.\")\n }\n\n const result = await new Promise((resolve, reject) => {\n let settled = false\n let timer: NodeJS.Timeout | undefined\n\n const settle = (handler: () => void) => {\n if (settled) {\n return\n }\n settled = true\n if (timer) {\n clearTimeout(timer)\n }\n server.close(() => {\n handler()\n })\n }\n\n const server = createServer((req, res) => {\n const requestUrl = new URL(\n req.url ?? \"/\",\n `http://${req.headers.host ?? LOCAL_CALLBACK_HOST}`,\n )\n\n if (requestUrl.pathname !== LOCAL_CALLBACK_PATH) {\n res.statusCode = 404\n res.end(\"Not Found\")\n return\n }\n\n const token = requestUrl.searchParams.get(\"token\")\n if (!token) {\n res.statusCode = 400\n res.setHeader(\"content-type\", \"text/html; charset=utf-8\")\n res.end(failurePageHtml)\n return\n }\n\n res.statusCode = 200\n res.setHeader(\"content-type\", \"text/html; charset=utf-8\")\n res.end(successPageHtml)\n\n const callbackAddress = server.address() as AddressInfo | null\n const callbackUrl = callbackAddress\n ? `http://${LOCAL_CALLBACK_HOST}:${callbackAddress.port}${LOCAL_CALLBACK_PATH}`\n : \"\"\n const loginUrl = resolveCLILoginUrl(options.apiUrl, callbackUrl)\n\n settle(() => {\n resolve({\n token,\n callbackUrl,\n loginUrl,\n })\n })\n })\n\n server.once(\"error\", (error) => {\n settle(() => {\n reject(\n new CLIError(\"NETWORK_ERROR\", `Failed to start local callback server: ${error.message}`),\n )\n })\n })\n\n server.listen(0, LOCAL_CALLBACK_HOST, () => {\n const address = server.address() as AddressInfo | null\n if (!address) {\n settle(() => {\n reject(new CLIError(\"NETWORK_ERROR\", \"Failed to bind local callback server.\"))\n })\n return\n }\n\n const callbackUrl = `http://${LOCAL_CALLBACK_HOST}:${address.port}${LOCAL_CALLBACK_PATH}`\n const loginUrl = resolveCLILoginUrl(options.apiUrl, callbackUrl)\n\n onStatus(`Open this URL to sign in: ${loginUrl}`)\n\n try {\n openBrowser(loginUrl)\n onStatus(\"Browser opened. Waiting for login confirmation...\")\n } catch (error) {\n onStatus((error as Error).message)\n onStatus(\"Waiting for login confirmation...\")\n }\n\n timer = setTimeout(() => {\n settle(() => {\n reject(\n new CLIError(\n \"TIMEOUT\",\n \"Timed out waiting for browser login. Please run `folo login` again.\",\n ),\n )\n })\n }, timeoutMs)\n })\n })\n\n return result\n}\n" }, { "path": "apps/cli/src/cli.e2e.test.ts", "content": "import type { ExecFileException } from \"node:child_process\"\nimport { execFile } from \"node:child_process\"\nimport { mkdtempSync } from \"node:fs\"\nimport { tmpdir } from \"node:os\"\nimport { promisify } from \"node:util\"\n\nimport { resolve } from \"pathe\"\nimport { describe, expect, it } from \"vitest\"\n\nconst execFileAsync = promisify(execFile)\nconst cliPath = resolve(process.cwd(), \"dist/index.js\")\nconst testToken = process.env.FOLO_TEST_TOKEN\nconst isolatedHome = mkdtempSync(resolve(tmpdir(), \"folocli-test-\"))\n\ntype CLIExecution = {\n code: number\n stdout: string\n stderr: string\n}\n\nconst runCLI = async (args: string[]): Promise => {\n try {\n const { stdout, stderr } = await execFileAsync(\"node\", [cliPath, ...args], {\n env: {\n ...process.env,\n HOME: isolatedHome,\n USERPROFILE: isolatedHome,\n FOLO_TOKEN: \"\",\n },\n })\n\n return {\n code: 0,\n stdout,\n stderr,\n }\n } catch (error) {\n const execError = error as ExecFileException & {\n stdout?: string\n stderr?: string\n }\n\n return {\n code: typeof execError.code === \"number\" ? execError.code : 1,\n stdout: execError.stdout ?? \"\",\n stderr: execError.stderr ?? \"\",\n }\n }\n}\n\ndescribe(\"cli e2e\", () => {\n it(\"returns structured unauthorized error without token\", async () => {\n const result = await runCLI([\"timeline\", \"--limit\", \"1\"])\n expect(result.code).not.toBe(0)\n\n const payload = JSON.parse(result.stderr) as {\n ok: boolean\n data: null\n error: { code: string; message: string }\n }\n expect(payload.ok).toBe(false)\n expect(payload.data).toBeNull()\n expect(payload.error.code).toBe(\"UNAUTHORIZED\")\n })\n\n it.runIf(Boolean(testToken))(\"can fetch session with test token\", async () => {\n const result = await runCLI([\"--token\", testToken!, \"whoami\"])\n expect(result.code).toBe(0)\n\n const payload = JSON.parse(result.stdout) as {\n ok: boolean\n data: {\n user: { id: string }\n session: { id: string }\n }\n error: null\n }\n expect(payload.ok).toBe(true)\n expect(payload.error).toBeNull()\n expect(typeof payload.data.user.id).toBe(\"string\")\n expect(typeof payload.data.session.id).toBe(\"string\")\n })\n\n it.runIf(Boolean(testToken))(\"can fetch timeline with test token\", async () => {\n const result = await runCLI([\"--token\", testToken!, \"timeline\", \"--limit\", \"1\"])\n expect(result.code).toBe(0)\n\n const payload = JSON.parse(result.stdout) as {\n ok: boolean\n data: {\n entries: unknown[]\n nextCursor: string | null\n hasNext: boolean\n }\n error: null\n }\n expect(payload.ok).toBe(true)\n expect(Array.isArray(payload.data.entries)).toBe(true)\n expect(typeof payload.data.hasNext).toBe(\"boolean\")\n })\n})\n" }, { "path": "apps/cli/src/client.ts", "content": "import { FollowClient } from \"@follow-app/client-sdk\"\nimport type { Command } from \"commander\"\n\nimport type { FoloCLIConfig } from \"./config\"\nimport { readConfig } from \"./config\"\nimport type { OutputFormat } from \"./output\"\nimport { CLIError } from \"./output\"\n\nexport const defaultApiURL = \"https://api.folo.is\"\n\nconst readString = (value: unknown): string | undefined => {\n return typeof value === \"string\" && value.length > 0 ? value : undefined\n}\n\nconst normalizeToken = (token: string | undefined) => {\n if (!token || !token.includes(\"%\")) {\n return token\n }\n\n try {\n return decodeURIComponent(token)\n } catch {\n return token\n }\n}\n\nexport interface GlobalOptions {\n format: OutputFormat\n apiUrl?: string\n token?: string\n verbose: boolean\n}\n\nexport interface ResolvedGlobalOptions extends GlobalOptions {\n apiUrl: string\n}\n\nexport interface CommandContext {\n client: FollowClient\n options: ResolvedGlobalOptions\n config: FoloCLIConfig\n token?: string\n}\n\nexport const getGlobalOptions = (command: Command): GlobalOptions => {\n const options = command.optsWithGlobals() as Record\n\n return {\n format:\n options.format === \"table\" || options.format === \"plain\" || options.format === \"json\"\n ? options.format\n : \"json\",\n apiUrl: readString(options.apiUrl),\n token: readString(options.token),\n verbose: Boolean(options.verbose),\n }\n}\n\nconst setupVerboseLogging = (client: FollowClient) => {\n client.addRequestInterceptor((ctx) => {\n const method = ctx.options.method || \"GET\"\n console.error(`[request] ${method} ${ctx.url}`)\n return ctx\n })\n\n client.addResponseInterceptor((ctx) => {\n const method = ctx.options.method || \"GET\"\n console.error(`[response] ${method} ${ctx.url} -> ${ctx.response.status}`)\n return ctx.response\n })\n}\n\nexport const createCommandContext = async (\n command: Command,\n requireAuth = true,\n): Promise => {\n const globalOptions = getGlobalOptions(command)\n const config = await readConfig()\n const token = normalizeToken(globalOptions.token ?? process.env.FOLO_TOKEN ?? config.token)\n const apiUrl = globalOptions.apiUrl ?? config.apiUrl ?? defaultApiURL\n\n if (requireAuth && !token) {\n throw new CLIError(\n \"UNAUTHORIZED\",\n \"Missing token. Run `folo login` (browser sign-in) or set FOLO_TOKEN.\",\n )\n }\n\n const client = new FollowClient({\n baseURL: apiUrl,\n })\n\n if (token) {\n client.setAuthToken(token)\n client.setHeaders({\n Cookie: `__Secure-better-auth.session_token=${token}; better-auth.session_token=${token}`,\n })\n }\n\n if (globalOptions.verbose) {\n setupVerboseLogging(client)\n }\n\n return {\n client,\n token,\n config,\n options: {\n ...globalOptions,\n apiUrl,\n },\n }\n}\n" }, { "path": "apps/cli/src/command.ts", "content": "import type { Command } from \"commander\"\n\nimport type { CommandContext } from \"./client\"\nimport { createCommandContext, getGlobalOptions } from \"./client\"\nimport { normalizeError, printFailure, printSuccess } from \"./output\"\n\ninterface RunCommandOptions {\n requireAuth?: boolean\n}\n\nexport const runCommand = async (\n command: Command,\n handler: (context: CommandContext) => Promise,\n options: RunCommandOptions = {},\n) => {\n const fallbackOptions = getGlobalOptions(command)\n const requireAuth = options.requireAuth ?? true\n\n let context: CommandContext | null = null\n try {\n context = await createCommandContext(command, requireAuth)\n const result = await handler(context)\n printSuccess(context.options.format, result)\n } catch (error) {\n const format = context?.options.format ?? fallbackOptions.format\n const verbose = context?.options.verbose ?? fallbackOptions.verbose\n printFailure(format, normalizeError(error, verbose))\n process.exitCode = 1\n }\n}\n" }, { "path": "apps/cli/src/commands/auth.ts", "content": "import type { Command } from \"commander\"\n\nimport { parsePositiveInt } from \"../args\"\nimport { loginWithBrowser } from \"../browser-login\"\nimport { getGlobalOptions } from \"../client\"\nimport { runCommand } from \"../command\"\nimport { clearToken, getConfigPath, updateConfig } from \"../config\"\nimport { CLIError } from \"../output\"\n\ninterface AuthLoginOptions {\n token?: string\n timeout?: number\n}\n\nconst runLoginAction = async function (this: Command, options: AuthLoginOptions) {\n await runCommand(\n this,\n async ({ client, options: globalOptions }) => {\n let token = options.token ?? getGlobalOptions(this).token\n if (!token) {\n const timeoutMs = (options.timeout ?? 180) * 1000\n const browserLogin = await loginWithBrowser({\n apiUrl: globalOptions.apiUrl,\n timeoutMs,\n onStatus: (message) => {\n console.error(`[auth] ${message}`)\n },\n })\n token = browserLogin.token\n }\n\n client.setAuthToken(token)\n const session = await client.api.auth.getSession()\n\n if (!session.user || !session.session) {\n throw new CLIError(\"UNAUTHORIZED\", \"Token is invalid or expired.\")\n }\n\n await updateConfig({\n token,\n apiUrl: globalOptions.apiUrl,\n })\n\n return {\n message: \"Login successful.\",\n configPath: getConfigPath(),\n user: session.user,\n }\n },\n { requireAuth: false },\n )\n}\n\nconst runLogoutAction = async function (this: Command) {\n await runCommand(\n this,\n async () => {\n await clearToken()\n return {\n message: \"Logged out.\",\n configPath: getConfigPath(),\n }\n },\n { requireAuth: false },\n )\n}\n\nconst runWhoamiAction = async function (this: Command) {\n await runCommand(this, async ({ client }) => {\n const session = await client.api.auth.getSession()\n if (!session.user || !session.session) {\n throw new CLIError(\"UNAUTHORIZED\", \"Token is invalid or expired.\")\n }\n\n return {\n user: session.user,\n session: session.session,\n role: session.role,\n roleEndAt: session.roleEndAt ?? null,\n feedSubscriptionLimit: session.feedSubscriptionLimit,\n rsshubSubscriptionLimit: session.rsshubSubscriptionLimit,\n }\n })\n}\n\nconst registerLoginCommand = (program: Command, name: string, description: string) => {\n program\n .command(name)\n .description(description)\n .option(\"--token \", \"Session token from Folo\")\n .option(\n \"--timeout \",\n \"Browser login timeout in seconds (default: 180)\",\n parsePositiveInt,\n )\n .action(runLoginAction)\n}\n\nconst registerLogoutCommand = (program: Command, name: string, description: string) => {\n program.command(name).description(description).action(runLogoutAction)\n}\n\nconst registerWhoamiCommand = (program: Command, name: string, description: string) => {\n program.command(name).description(description).action(runWhoamiAction)\n}\n\nexport const registerAuthCommand = (program: Command) => {\n const authCommand = program.command(\"auth\").description(\"Authentication commands\")\n\n registerLoginCommand(\n authCommand,\n \"login\",\n \"Sign in via browser (or save a provided token) and verify authentication\",\n )\n registerLogoutCommand(authCommand, \"logout\", \"Clear stored token\")\n registerWhoamiCommand(authCommand, \"whoami\", \"Show current session user\")\n\n registerLoginCommand(program, \"login\", \"Sign in and store a CLI session\")\n registerLogoutCommand(program, \"logout\", \"Clear the stored CLI session\")\n registerWhoamiCommand(program, \"whoami\", \"Show the current CLI session user\")\n}\n" }, { "path": "apps/cli/src/commands/collection.ts", "content": "import type { EntryListRequest } from \"@follow-app/client-sdk\"\nimport type { Command } from \"commander\"\n\nimport { parseISODate, parsePositiveInt, parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\n\ninterface CollectionListOptions {\n limit: number\n cursor?: string\n}\n\ninterface CollectionAddOptions {\n view?: number\n}\n\nexport const registerCollectionCommand = (program: Command) => {\n const collectionCommand = program.command(\"collection\").description(\"Manage collections\")\n\n collectionCommand\n .command(\"list\")\n .description(\"List collected entries\")\n .option(\"--limit \", \"Number of entries to fetch\", parsePositiveInt, 20)\n .option(\"--cursor \", \"Pagination cursor\", parseISODate)\n .action(async function (this: Command, options: CollectionListOptions) {\n await runCommand(this, async ({ client }) => {\n const request: EntryListRequest = {\n isCollection: true,\n limit: options.limit,\n publishedAfter: options.cursor,\n }\n\n const response = await client.api.entries.list(request)\n const entries = response.data\n const nextCursor = entries.at(-1)?.entries.publishedAt ?? null\n\n return {\n entries,\n nextCursor,\n hasNext: Boolean(nextCursor) && entries.length >= options.limit,\n }\n })\n })\n\n collectionCommand\n .command(\"add\")\n .description(\"Add entry to collection\")\n .argument(\"\", \"Entry ID\")\n .option(\"--view \", `View type: ${viewHelp}`, parseView)\n .action(async function (this: Command, entryId: string, options: CollectionAddOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.collections.post({\n entryId,\n view: options.view,\n })\n return response.data\n })\n })\n\n collectionCommand\n .command(\"remove\")\n .description(\"Remove entry from collection\")\n .argument(\"\", \"Entry ID\")\n .action(async function (this: Command, entryId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.collections.delete({\n entryId,\n })\n return response.data\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/entry.ts", "content": "import type { MarkAllAsReadRequest } from \"@follow-app/client-sdk\"\nimport type { Command } from \"commander\"\n\nimport { parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\nimport { CLIError } from \"../output\"\n\ninterface MarkAllReadOptions {\n feed?: string\n list?: string\n view?: number\n}\n\nexport const registerEntryCommand = (program: Command) => {\n const entryCommand = program.command(\"entry\").description(\"Read and update entries\")\n\n entryCommand\n .command(\"get\")\n .description(\"Get entry detail\")\n .argument(\"\", \"Entry ID\")\n .action(async function (this: Command, entryId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.entries.get({ id: entryId })\n return response.data\n })\n })\n\n entryCommand\n .command(\"read\")\n .description(\"Get readability content\")\n .argument(\"\", \"Entry ID\")\n .action(async function (this: Command, entryId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.entries.readability({ id: entryId })\n return response.data\n })\n })\n\n entryCommand\n .command(\"mark-read\")\n .description(\"Mark entry as read\")\n .argument(\"\", \"Entry ID\")\n .action(async function (this: Command, entryId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.reads.markAsRead({ entryIds: [entryId] })\n return response.data\n })\n })\n\n entryCommand\n .command(\"mark-unread\")\n .description(\"Mark entry as unread\")\n .argument(\"\", \"Entry ID\")\n .action(async function (this: Command, entryId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.reads.markAsUnread({ entryId })\n return response.data\n })\n })\n\n entryCommand\n .command(\"mark-all-read\")\n .description(\"Mark entries as read in current scope\")\n .option(\"--feed \", \"Mark all entries in a feed as read\")\n .option(\"--list \", \"Mark all entries in a list as read\")\n .option(\"--view \", `View type: ${viewHelp}`, parseView)\n .action(async function (this: Command, options: MarkAllReadOptions) {\n await runCommand(this, async ({ client }) => {\n if (options.feed && options.list) {\n throw new CLIError(\"INVALID_ARGUMENT\", \"Use only one of --feed or --list.\")\n }\n\n const request: MarkAllAsReadRequest = {\n feedId: options.feed,\n listId: options.list,\n view: options.view,\n }\n\n const response = await client.api.reads.markAllAsRead(request)\n return response.data\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/feed.ts", "content": "import type { Command } from \"commander\"\n\nimport { runCommand } from \"../command\"\n\nconst isURL = (value: string) => value.startsWith(\"http://\") || value.startsWith(\"https://\")\n\nexport const registerFeedCommand = (program: Command) => {\n const feedCommand = program.command(\"feed\").description(\"Manage feed data\")\n\n feedCommand\n .command(\"get\")\n .description(\"Get feed detail by feed ID or URL\")\n .argument(\"\", \"Feed ID or URL\")\n .action(async function (this: Command, feedIdOrUrl: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.feeds.get(\n isURL(feedIdOrUrl) ? { url: feedIdOrUrl } : { id: feedIdOrUrl },\n )\n return response.data\n })\n })\n\n feedCommand\n .command(\"refresh\")\n .description(\"Refresh feed\")\n .argument(\"\", \"Feed ID\")\n .action(async function (this: Command, feedId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.feeds.refresh({ id: feedId })\n return response.data\n })\n })\n\n feedCommand\n .command(\"analytics\")\n .description(\"Get feed analytics\")\n .argument(\"\", \"Feed ID\")\n .action(async function (this: Command, feedId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.feeds.analytics({ id: [feedId] })\n return response.data\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/list.ts", "content": "import type { Command } from \"commander\"\n\nimport { parseNonNegativeInt, parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\nimport { CLIError } from \"../output\"\n\ninterface ListCreateOptions {\n title: string\n description?: string\n view?: number\n fee?: number\n image?: string\n}\n\ninterface ListUpdateOptions {\n title?: string\n description?: string\n view?: number\n fee?: number\n image?: string\n}\n\ninterface ListFeedOptions {\n feed: string\n}\n\nexport const registerListCommand = (program: Command) => {\n const listCommand = program.command(\"list\").description(\"Manage lists\")\n\n listCommand\n .command(\"ls\")\n .description(\"List my lists\")\n .action(async function (this: Command) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.lists.list({})\n return response.data\n })\n })\n\n listCommand\n .command(\"get\")\n .description(\"Get list detail\")\n .argument(\"\", \"List ID\")\n .action(async function (this: Command, listId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.lists.get({ listId })\n return response.data\n })\n })\n\n listCommand\n .command(\"create\")\n .description(\"Create a list\")\n .requiredOption(\"--title \", \"List title\")\n .option(\"--description <description>\", \"List description\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--fee <amount>\", \"List fee\", parseNonNegativeInt, 0)\n .option(\"--image <url>\", \"List image URL\")\n .action(async function (this: Command, options: ListCreateOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.lists.create({\n title: options.title,\n description: options.description ?? null,\n view: options.view ?? 0,\n fee: options.fee ?? 0,\n image: options.image ?? null,\n })\n\n return response.data\n })\n })\n\n listCommand\n .command(\"update\")\n .description(\"Update a list\")\n .argument(\"<listId>\", \"List ID\")\n .option(\"--title <title>\", \"List title\")\n .option(\"--description <description>\", \"List description\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--fee <amount>\", \"List fee\", parseNonNegativeInt)\n .option(\"--image <url>\", \"List image URL\")\n .action(async function (this: Command, listId: string, options: ListUpdateOptions) {\n await runCommand(this, async ({ client }) => {\n if (\n options.title === undefined &&\n options.description === undefined &&\n options.view === undefined &&\n options.fee === undefined &&\n options.image === undefined\n ) {\n throw new CLIError(\n \"INVALID_ARGUMENT\",\n \"No update fields provided. Use at least one of --title, --description, --view, --fee, --image.\",\n )\n }\n\n const response = await client.api.lists.update({\n listId,\n title: options.title,\n description: options.description,\n view: options.view,\n fee: options.fee,\n image: options.image,\n })\n\n return response.data\n })\n })\n\n listCommand\n .command(\"delete\")\n .description(\"Delete a list\")\n .argument(\"<listId>\", \"List ID\")\n .action(async function (this: Command, listId: string) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.lists.delete({ listId })\n return response.data\n })\n })\n\n listCommand\n .command(\"add-feed\")\n .description(\"Add feed to a list\")\n .argument(\"<listId>\", \"List ID\")\n .requiredOption(\"--feed <feedId>\", \"Feed ID\")\n .action(async function (this: Command, listId: string, options: ListFeedOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.lists.addFeeds({\n listId,\n feedId: options.feed,\n })\n return response.data\n })\n })\n\n listCommand\n .command(\"remove-feed\")\n .description(\"Remove feed from a list\")\n .argument(\"<listId>\", \"List ID\")\n .requiredOption(\"--feed <feedId>\", \"Feed ID\")\n .action(async function (this: Command, listId: string, options: ListFeedOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.lists.removeFeed({\n listId,\n feedId: options.feed,\n })\n return response.data\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/opml.ts", "content": "import { mkdir, readFile, writeFile } from \"node:fs/promises\"\n\nimport type { Command } from \"commander\"\nimport { basename, dirname } from \"pathe\"\n\nimport { runCommand } from \"../command\"\n\ninterface OpmlExportOptions {\n output?: string\n}\n\ninterface OpmlImportOptions {\n items?: string\n}\n\nconst parseItems = (value?: string): string[] => {\n if (!value) {\n return []\n }\n\n return value\n .split(\",\")\n .map((item) => item.trim())\n .filter((item) => item.length > 0)\n}\n\nexport const registerOPMLCommand = (program: Command) => {\n const opmlCommand = program.command(\"opml\").description(\"Import and export OPML\")\n\n opmlCommand\n .command(\"export\")\n .description(\"Export subscriptions as OPML\")\n .option(\"--output <file>\", \"Write exported OPML to file\")\n .action(async function (this: Command, options: OpmlExportOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.subscriptions.export({\n format: \"opml\",\n })\n\n if (!options.output) {\n return response\n }\n\n await mkdir(dirname(options.output), { recursive: true })\n await writeFile(options.output, response.content, \"utf8\")\n\n return {\n output: options.output,\n filename: response.filename,\n contentType: response.contentType,\n bytes: Buffer.byteLength(response.content),\n }\n })\n })\n\n opmlCommand\n .command(\"import\")\n .description(\"Import subscriptions from OPML file\")\n .argument(\"<file>\", \"Path to OPML or XML file\")\n .option(\"--items <urls>\", \"Comma-separated feed URLs to import from parsed file\")\n .action(async function (this: Command, filePath: string, options: OpmlImportOptions) {\n await runCommand(this, async ({ client }) => {\n const fileBuffer = await readFile(filePath)\n const fileName = basename(filePath)\n const formData = new FormData()\n\n formData.append(\n \"file\",\n new Blob([fileBuffer], {\n type: \"application/octet-stream\",\n }),\n fileName,\n )\n\n const items = parseItems(options.items)\n if (items.length > 0) {\n formData.append(\"items\", JSON.stringify(items))\n }\n\n const response = await client.api.subscriptions.import(formData)\n return response.data\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/search.ts", "content": "import type { Command } from \"commander\"\n\nimport { parsePositiveInt, parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\n\ntype DiscoverTarget = \"feeds\" | \"lists\"\ntype TrendingRange = \"1d\" | \"3d\" | \"7d\" | \"30d\"\ntype TrendingLanguage = \"eng\" | \"cmn\"\n\nconst parseDiscoverTarget = (value: string): DiscoverTarget => {\n if (value === \"feeds\" || value === \"lists\") {\n return value\n }\n throw new Error(`Invalid discover type \"${value}\". Use feeds or lists.`)\n}\n\nconst parseTrendingRange = (value: string): TrendingRange => {\n if (value === \"1d\" || value === \"3d\" || value === \"7d\" || value === \"30d\") {\n return value\n }\n throw new Error(`Invalid range \"${value}\". Use one of 1d, 3d, 7d, 30d.`)\n}\n\nconst parseTrendingLanguage = (value: string): TrendingLanguage => {\n if (value === \"eng\" || value === \"cmn\") {\n return value\n }\n throw new Error(`Invalid language \"${value}\". Use eng or cmn.`)\n}\n\ninterface SearchDiscoverOptions {\n type?: DiscoverTarget\n}\n\ninterface SearchRsshubOptions {\n lang?: string\n}\n\ninterface SearchTrendingOptions {\n category?: string\n range?: TrendingRange\n view?: number\n limit?: number\n language?: TrendingLanguage\n}\n\nexport const registerSearchCommand = (program: Command) => {\n const searchCommand = program.command(\"search\").description(\"Discover feeds and lists\")\n\n searchCommand\n .command(\"discover\")\n .description(\"Discover feeds or lists\")\n .argument(\"<keyword>\", \"Search keyword\")\n .option(\"--type <type>\", \"Discover target: feeds | lists\", parseDiscoverTarget)\n .action(async function (this: Command, keyword: string, options: SearchDiscoverOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.discover.discover({\n keyword,\n target: options.type,\n })\n return response.data\n })\n })\n\n searchCommand\n .command(\"rsshub\")\n .description(\"Search RSSHub routes by category keyword\")\n .argument(\"<keyword>\", \"Category keyword\")\n .option(\"--lang <lang>\", \"Language tag\")\n .action(async function (this: Command, keyword: string, options: SearchRsshubOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.discover.rsshub({\n categories: keyword,\n lang: options.lang,\n })\n return response.data\n })\n })\n\n searchCommand\n .command(\"trending\")\n .description(\"Get trending feeds\")\n .option(\"--category <category>\", \"Filter by category keyword in title/description\")\n .option(\"--range <range>\", \"Trending range: 1d | 3d | 7d | 30d\", parseTrendingRange, \"7d\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--limit <n>\", \"Result limit\", parsePositiveInt, 20)\n .option(\"--language <lang>\", \"Language: eng | cmn\", parseTrendingLanguage)\n .action(async function (this: Command, options: SearchTrendingOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.trending.getFeeds({\n range: options.range,\n view: options.view,\n limit: options.limit,\n language: options.language,\n })\n\n const keyword = options.category?.trim().toLowerCase()\n const feeds = keyword\n ? response.data.filter((item) => {\n const title = item.feed.title?.toLowerCase() || \"\"\n const description = item.feed.description?.toLowerCase() || \"\"\n return title.includes(keyword) || description.includes(keyword)\n })\n : response.data\n\n return {\n feeds,\n }\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/subscription.ts", "content": "import type {\n SubscriptionCreateRequest,\n SubscriptionDeleteRequest,\n SubscriptionUpdateRequest,\n} from \"@follow-app/client-sdk\"\nimport type { Command } from \"commander\"\n\nimport { parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\nimport { CLIError } from \"../output\"\n\ntype SubscriptionTarget = \"feed\" | \"list\" | \"url\"\ntype UpdateTarget = \"feed\" | \"list\"\n\nconst parseSubscriptionTarget = (value: string): SubscriptionTarget => {\n if (value === \"feed\" || value === \"list\" || value === \"url\") {\n return value\n }\n throw new Error(`Invalid target \"${value}\". Use feed, list, or url.`)\n}\n\nconst parseUpdateTarget = (value: string): UpdateTarget => {\n if (value === \"feed\" || value === \"list\") {\n return value\n }\n throw new Error(`Invalid target \"${value}\". Use feed or list.`)\n}\n\ninterface SubscriptionListOptions {\n view?: number\n category?: string\n}\n\ninterface SubscriptionAddOptions {\n feed?: string\n list?: string\n category?: string\n view?: number\n private?: boolean\n title?: string\n}\n\ninterface SubscriptionRemoveOptions {\n target: SubscriptionTarget\n}\n\ninterface SubscriptionUpdateOptions {\n category?: string\n title?: string\n view?: number\n private?: boolean\n public?: boolean\n target: UpdateTarget\n}\n\nexport const registerSubscriptionCommand = (program: Command) => {\n const subscriptionCommand = program.command(\"subscription\").description(\"Manage subscriptions\")\n\n subscriptionCommand\n .command(\"list\")\n .description(\"List subscriptions\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--category <name>\", \"Filter by category\")\n .action(async function (this: Command, options: SubscriptionListOptions) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.subscriptions.get(\n options.view !== undefined ? { view: options.view } : {},\n )\n\n const subscriptions = options.category\n ? response.data.filter((item) => item.category === options.category)\n : response.data\n\n return {\n subscriptions,\n }\n })\n })\n\n subscriptionCommand\n .command(\"add\")\n .description(\"Add a feed or list subscription\")\n .option(\"--feed <url>\", \"Feed URL to subscribe\")\n .option(\"--list <listId>\", \"List ID to subscribe\")\n .option(\"--category <name>\", \"Subscription category\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--private\", \"Mark subscription as private\", false)\n .option(\"--title <title>\", \"Custom subscription title\")\n .action(async function (this: Command, options: SubscriptionAddOptions) {\n await runCommand(this, async ({ client }) => {\n const selected = [options.feed, options.list].filter(Boolean)\n if (selected.length !== 1) {\n throw new CLIError(\"INVALID_ARGUMENT\", \"Use either --feed or --list when adding.\")\n }\n\n const request: SubscriptionCreateRequest = {\n view: options.view ?? 0,\n category: options.category ?? null,\n isPrivate: options.private || false,\n title: options.title ?? null,\n }\n\n if (options.feed) {\n request.url = options.feed\n request.type = \"feed\"\n }\n\n if (options.list) {\n request.listId = options.list\n request.type = \"list\"\n }\n\n const response = await client.api.subscriptions.create(request)\n return {\n feed: response.feed,\n list: response.list,\n unread: response.unread,\n }\n })\n })\n\n subscriptionCommand\n .command(\"remove\")\n .description(\"Remove a subscription target\")\n .argument(\"<id>\", \"Feed ID, list ID, or feed URL\")\n .option(\n \"--target <target>\",\n \"Subscription target type: feed | list | url\",\n parseSubscriptionTarget,\n \"feed\",\n )\n .action(async function (this: Command, id: string, options: SubscriptionRemoveOptions) {\n await runCommand(this, async ({ client }) => {\n const request: SubscriptionDeleteRequest = {}\n\n if (options.target === \"feed\") {\n request.feedId = id\n } else if (options.target === \"list\") {\n request.listId = id\n } else {\n request.url = id\n }\n\n const response = await client.api.subscriptions.delete(request)\n return response.data\n })\n })\n\n subscriptionCommand\n .command(\"update\")\n .description(\"Update a subscription target\")\n .argument(\"<id>\", \"Feed ID or list ID\")\n .option(\"--category <name>\", \"Set category\")\n .option(\"--title <title>\", \"Set custom title\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--private\", \"Set subscription private\", false)\n .option(\"--public\", \"Set subscription public\", false)\n .option(\"--target <target>\", \"Target type: feed | list\", parseUpdateTarget, \"feed\")\n .action(async function (this: Command, id: string, options: SubscriptionUpdateOptions) {\n await runCommand(this, async ({ client }) => {\n if (options.private && options.public) {\n throw new CLIError(\n \"INVALID_ARGUMENT\",\n \"Use only one of --private or --public when updating.\",\n )\n }\n\n const request: SubscriptionUpdateRequest = {\n category: options.category ?? undefined,\n title: options.title ?? undefined,\n view: options.view,\n }\n\n if (options.private) {\n request.isPrivate = true\n } else if (options.public) {\n request.isPrivate = false\n }\n\n if (options.target === \"feed\") {\n request.feedId = id\n } else {\n request.listId = id\n }\n\n if (\n request.category === undefined &&\n request.title === undefined &&\n request.view === undefined &&\n request.isPrivate === undefined\n ) {\n throw new CLIError(\n \"INVALID_ARGUMENT\",\n \"No update fields provided. Use at least one of --category, --title, --view, --private, --public.\",\n )\n }\n\n const response = await client.api.subscriptions.update(request)\n return response.data\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/timeline.ts", "content": "import type { EntryListRequest } from \"@follow-app/client-sdk\"\nimport type { Command } from \"commander\"\n\nimport { parseISODate, parsePositiveInt, parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\nimport { CLIError } from \"../output\"\n\ntype TimelineQuery = EntryListRequest & {\n listId?: string\n}\n\ninterface TimelineOptions {\n view?: number\n limit: number\n unreadOnly?: boolean\n cursor?: string\n feed?: string\n list?: string\n category?: string\n}\n\nexport const registerTimelineCommand = (program: Command) => {\n program\n .command(\"timeline\")\n .description(\"List timeline entries\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .option(\"--limit <n>\", \"Number of entries to fetch\", parsePositiveInt, 20)\n .option(\"--unread-only\", \"Only unread entries\", false)\n .option(\"--cursor <datetime>\", \"Pagination cursor (publishedAfter)\", parseISODate)\n .option(\"--feed <feedId>\", \"Filter timeline by feed\")\n .option(\"--list <listId>\", \"Filter timeline by list\")\n .option(\"--category <name>\", \"Filter timeline by subscription category\")\n .action(async function (this: Command, options: TimelineOptions) {\n await runCommand(this, async ({ client }) => {\n const scopedFilters = [options.feed, options.list, options.category].filter(Boolean)\n if (scopedFilters.length > 1) {\n throw new CLIError(\n \"INVALID_ARGUMENT\",\n \"Use only one of --feed, --list, or --category at the same time.\",\n )\n }\n\n const query: TimelineQuery = {\n limit: options.limit,\n read: options.unreadOnly ? false : undefined,\n view: options.view,\n publishedAfter: options.cursor,\n }\n\n if (options.feed) {\n query.feedId = options.feed\n }\n\n if (options.list) {\n query.listId = options.list\n }\n\n if (options.category) {\n const subscriptions = await client.api.subscriptions.get(\n options.view !== undefined ? { view: options.view } : {},\n )\n\n const feedIdList = subscriptions.data\n .filter((item) => item.category === options.category)\n .map((item) => item.feedId)\n .filter((item): item is string => item.length > 0)\n\n if (feedIdList.length === 0) {\n return {\n entries: [],\n nextCursor: null,\n hasNext: false,\n }\n }\n\n query.feedIdList = feedIdList\n }\n\n const response = await client.api.entries.list(query)\n const entries = response.data\n const nextCursor = entries.at(-1)?.entries.publishedAt ?? null\n\n return {\n entries,\n nextCursor,\n hasNext: Boolean(nextCursor) && entries.length >= options.limit,\n }\n })\n })\n}\n" }, { "path": "apps/cli/src/commands/unread.ts", "content": "import type {\n InboxSubscriptionResponse,\n ListSubscriptionResponse,\n SubscriptionWithFeed,\n} from \"@follow-app/client-sdk\"\nimport type { Command } from \"commander\"\n\nimport { parseView, viewHelp } from \"../args\"\nimport { runCommand } from \"../command\"\n\ninterface UnreadListOptions {\n view?: number\n}\n\nconst isInboxSubscription = (\n value: SubscriptionWithFeed | ListSubscriptionResponse | InboxSubscriptionResponse,\n): value is InboxSubscriptionResponse => {\n return \"inboxes\" in value\n}\n\nconst isListSubscription = (\n value: SubscriptionWithFeed | ListSubscriptionResponse | InboxSubscriptionResponse,\n): value is ListSubscriptionResponse => {\n return \"lists\" in value\n}\n\nconst resolveTitle = (\n value: SubscriptionWithFeed | ListSubscriptionResponse | InboxSubscriptionResponse,\n): string | null => {\n if (value.title) {\n return value.title\n }\n if (\"feeds\" in value) {\n return value.feeds.title ?? null\n }\n if (\"lists\" in value) {\n return value.lists.title ?? null\n }\n if (\"inboxes\" in value) {\n return value.inboxes.title ?? null\n }\n return null\n}\n\nexport const registerUnreadCommand = (program: Command) => {\n const unreadCommand = program.command(\"unread\").description(\"Unread status commands\")\n\n unreadCommand\n .command(\"count\")\n .description(\"Get total unread count\")\n .action(async function (this: Command) {\n await runCommand(this, async ({ client }) => {\n const response = await client.api.reads.getTotalCount()\n return response.data\n })\n })\n\n unreadCommand\n .command(\"list\")\n .description(\"List subscriptions with unread entries\")\n .option(\"--view <type>\", `View type: ${viewHelp}`, parseView)\n .action(async function (this: Command, options: UnreadListOptions) {\n await runCommand(this, async ({ client }) => {\n const [unreadResponse, subscriptionsResponse] = await Promise.all([\n client.api.reads.get(options.view !== undefined ? { view: options.view } : {}),\n client.api.subscriptions.get(options.view !== undefined ? { view: options.view } : {}),\n ])\n\n const unreadMap = unreadResponse.data\n const items = subscriptionsResponse.data\n .map((subscription) => {\n const unreadKey = isInboxSubscription(subscription)\n ? subscription.inboxId\n : subscription.feedId\n const unreadCount = unreadMap[unreadKey] ?? 0\n\n return {\n sourceType: isInboxSubscription(subscription)\n ? \"inbox\"\n : isListSubscription(subscription)\n ? \"list\"\n : \"feed\",\n sourceId: isInboxSubscription(subscription)\n ? subscription.inboxId\n : isListSubscription(subscription)\n ? subscription.listId\n : subscription.feedId,\n feedId: subscription.feedId,\n title: resolveTitle(subscription),\n category: subscription.category ?? null,\n view: subscription.view,\n unreadCount,\n isPrivate: subscription.isPrivate,\n }\n })\n .filter((item) => item.unreadCount > 0)\n .sort((left, right) => right.unreadCount - left.unreadCount)\n\n return {\n total: items.reduce((sum, item) => sum + item.unreadCount, 0),\n items,\n }\n })\n })\n}\n" }, { "path": "apps/cli/src/config.ts", "content": "import { mkdir, readFile, writeFile } from \"node:fs/promises\"\nimport { homedir } from \"node:os\"\n\nimport { join } from \"pathe\"\n\nexport interface FoloCLIConfig {\n token?: string\n apiUrl?: string\n}\n\nconst configDir = join(homedir(), \".folo\")\nconst configPath = join(configDir, \"config.json\")\n\nconst normalizeConfig = (config: unknown): FoloCLIConfig => {\n if (!config || typeof config !== \"object\") {\n return {}\n }\n\n const source = config as Record<string, unknown>\n return {\n token: typeof source.token === \"string\" ? source.token : undefined,\n apiUrl: typeof source.apiUrl === \"string\" ? source.apiUrl : undefined,\n }\n}\n\nexport const getConfigPath = () => configPath\n\nexport const readConfig = async (): Promise<FoloCLIConfig> => {\n try {\n const raw = await readFile(configPath, \"utf8\")\n return normalizeConfig(JSON.parse(raw))\n } catch (error) {\n const nodeError = error as NodeJS.ErrnoException\n if (nodeError.code === \"ENOENT\") {\n return {}\n }\n\n throw error\n }\n}\n\nconst ensureConfigDir = async () => {\n await mkdir(configDir, { recursive: true })\n}\n\nexport const writeConfig = async (config: FoloCLIConfig) => {\n await ensureConfigDir()\n await writeFile(configPath, `${JSON.stringify(config, null, 2)}\\n`, \"utf8\")\n}\n\nexport const updateConfig = async (patch: Partial<FoloCLIConfig>) => {\n const current = await readConfig()\n const next: FoloCLIConfig = {\n ...current,\n ...patch,\n }\n\n if (!next.token) {\n delete next.token\n }\n if (!next.apiUrl) {\n delete next.apiUrl\n }\n\n await writeConfig(next)\n return next\n}\n\nexport const clearToken = async () => {\n const current = await readConfig()\n if (!current.token) {\n return\n }\n\n delete current.token\n await writeConfig(current)\n}\n" }, { "path": "apps/cli/src/index.ts", "content": "import { Command } from \"commander\"\n\nimport packageJSON from \"../package.json\"\nimport { parseFormat } from \"./args\"\nimport { defaultApiURL } from \"./client\"\nimport { registerAuthCommand } from \"./commands/auth\"\nimport { registerCollectionCommand } from \"./commands/collection\"\nimport { registerEntryCommand } from \"./commands/entry\"\nimport { registerFeedCommand } from \"./commands/feed\"\nimport { registerListCommand } from \"./commands/list\"\nimport { registerOPMLCommand } from \"./commands/opml\"\nimport { registerSearchCommand } from \"./commands/search\"\nimport { registerSubscriptionCommand } from \"./commands/subscription\"\nimport { registerTimelineCommand } from \"./commands/timeline\"\nimport { registerUnreadCommand } from \"./commands/unread\"\nimport type { OutputFormat } from \"./output\"\nimport { normalizeError, printFailure } from \"./output\"\n\nconst program = new Command()\n\nprogram\n .name(\"folo\")\n .description(\"Folo CLI client for structured automation\")\n .version(packageJSON.version)\n .option(\"-f, --format <format>\", \"Output format: json | table | plain\", parseFormat, \"json\")\n .option(\"--api-url <url>\", `API base URL (default: ${defaultApiURL})`)\n .option(\"--token <token>\", \"Override stored token\")\n .option(\"--verbose\", \"Enable verbose request/response logging\", false)\n\nregisterAuthCommand(program)\nregisterTimelineCommand(program)\nregisterSubscriptionCommand(program)\nregisterEntryCommand(program)\nregisterFeedCommand(program)\nregisterListCommand(program)\nregisterSearchCommand(program)\nregisterCollectionCommand(program)\nregisterOPMLCommand(program)\nregisterUnreadCommand(program)\n\nconst resolveRequestedFormat = (argv: string[]): OutputFormat => {\n for (let index = 0; index < argv.length; index += 1) {\n const current = argv[index]\n if ((current === \"--format\" || current === \"-f\") && argv[index + 1]) {\n try {\n return parseFormat(argv[index + 1]!)\n } catch {\n return \"json\"\n }\n }\n }\n return \"json\"\n}\n\ntry {\n await program.parseAsync(process.argv)\n} catch (error) {\n const format = resolveRequestedFormat(process.argv)\n printFailure(format, normalizeError(error))\n process.exitCode = 1\n}\n" }, { "path": "apps/cli/src/output.test.ts", "content": "import { afterEach, beforeEach, describe, expect, it, vi } from \"vitest\"\n\nimport { CLIError, normalizeError, printFailure, printSuccess } from \"./output\"\n\ndescribe(\"output helpers\", () => {\n beforeEach(() => {\n vi.restoreAllMocks()\n })\n\n afterEach(() => {\n vi.restoreAllMocks()\n })\n\n it(\"prints JSON success envelope\", () => {\n const infoSpy = vi.spyOn(console, \"info\").mockImplementation(() => {})\n\n printSuccess(\"json\", { value: 1 })\n\n expect(infoSpy).toHaveBeenCalledTimes(1)\n const payload = JSON.parse(infoSpy.mock.calls[0]![0] as string) as {\n ok: boolean\n data: { value: number }\n error: null\n }\n expect(payload.ok).toBe(true)\n expect(payload.data).toEqual({ value: 1 })\n expect(payload.error).toBeNull()\n })\n\n it(\"prints JSON failure envelope\", () => {\n const errorSpy = vi.spyOn(console, \"error\").mockImplementation(() => {})\n\n printFailure(\"json\", { code: \"E_TEST\", message: \"boom\" })\n\n expect(errorSpy).toHaveBeenCalledTimes(1)\n const payload = JSON.parse(errorSpy.mock.calls[0]![0] as string) as {\n ok: boolean\n data: null\n error: { code: string; message: string }\n }\n expect(payload.ok).toBe(false)\n expect(payload.data).toBeNull()\n expect(payload.error).toEqual({ code: \"E_TEST\", message: \"boom\" })\n })\n\n it(\"prints ascii table in table mode\", () => {\n const infoSpy = vi.spyOn(console, \"info\").mockImplementation(() => {})\n\n printSuccess(\"table\", [{ id: \"a\", count: 1 }])\n\n expect(infoSpy).toHaveBeenCalledTimes(1)\n const output = infoSpy.mock.calls[0]![0] as string\n expect(output).toContain(\"| id\")\n expect(output).toContain(\"| a\")\n })\n\n it(\"normalizes CLIError\", () => {\n const normalized = normalizeError(new CLIError(\"E_CODE\", \"message\"))\n expect(normalized).toEqual({\n code: \"E_CODE\",\n message: \"message\",\n })\n })\n\n it(\"normalizes generic Error\", () => {\n const normalized = normalizeError(new Error(\"generic\"))\n expect(normalized).toEqual({\n code: \"UNKNOWN_ERROR\",\n message: \"generic\",\n })\n })\n})\n" }, { "path": "apps/cli/src/output.ts", "content": "import { inspect } from \"node:util\"\n\nimport { FollowAPIError, FollowAuthError } from \"@follow-app/client-sdk\"\n\nexport type OutputFormat = \"json\" | \"table\" | \"plain\"\n\nexport interface OutputError {\n code: string\n message: string\n}\n\nexport class CLIError extends Error {\n readonly code: string\n\n constructor(code: string, message: string) {\n super(message)\n this.name = \"CLIError\"\n this.code = code\n }\n}\n\nconst stringifyJSON = (value: unknown) => {\n return JSON.stringify(\n value,\n (_key, currentValue) => {\n if (typeof currentValue === \"bigint\") {\n return currentValue.toString()\n }\n return currentValue\n },\n 2,\n )\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => {\n return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n\nconst toCellValue = (value: unknown): string | number | boolean | null => {\n if (\n value === null ||\n typeof value === \"string\" ||\n typeof value === \"number\" ||\n typeof value === \"boolean\"\n ) {\n return value as string | number | boolean | null\n }\n if (value === undefined) {\n return \"\"\n }\n return stringifyJSON(value)\n}\n\nconst toTableRow = (value: unknown): Record<string, string | number | boolean | null> => {\n if (!isRecord(value)) {\n return {\n value: toCellValue(value),\n }\n }\n\n const row: Record<string, string | number | boolean | null> = {}\n for (const [key, currentValue] of Object.entries(value)) {\n row[key] = toCellValue(currentValue)\n }\n return row\n}\n\nconst renderAsciiTable = (\n rows: Array<Record<string, string | number | boolean | null>>,\n): string => {\n if (rows.length === 0) {\n return \"(empty)\"\n }\n\n const columns = Array.from(new Set(rows.flatMap((row) => Object.keys(row))))\n const widths = columns.map((column) =>\n Math.max(column.length, ...rows.map((row) => String(row[column] ?? \"\").length)),\n )\n\n const formatLine = (values: string[]) => {\n return `| ${values.map((value, index) => value.padEnd(widths[index]!)).join(\" | \")} |`\n }\n\n const border = `+-${widths.map((width) => \"-\".repeat(width)).join(\"-+-\")}-+`\n const header = formatLine(columns)\n const body = rows.map((row) => formatLine(columns.map((column) => String(row[column] ?? \"\"))))\n\n return [border, header, border, ...body, border].join(\"\\n\")\n}\n\nconst renderTable = (data: unknown) => {\n const rows = Array.isArray(data) ? data.map(toTableRow) : [toTableRow(data)]\n console.info(renderAsciiTable(rows))\n}\n\nconst renderPlain = (data: unknown) => {\n if (Array.isArray(data)) {\n console.info(data.map((item) => inspect(item, { depth: null, colors: false })).join(\"\\n\"))\n return\n }\n\n if (typeof data === \"string\") {\n console.info(data)\n return\n }\n\n if (data === null || data === undefined) {\n console.info(\"\")\n return\n }\n\n console.info(\n inspect(data, {\n depth: null,\n colors: false,\n compact: false,\n }),\n )\n}\n\nexport const printSuccess = (format: OutputFormat, data: unknown) => {\n if (format === \"json\") {\n const payload = {\n ok: true as const,\n data,\n error: null,\n }\n console.info(stringifyJSON(payload))\n return\n }\n\n if (format === \"table\") {\n renderTable(data)\n return\n }\n\n renderPlain(data)\n}\n\nexport const printFailure = (format: OutputFormat, error: OutputError) => {\n if (format === \"json\") {\n const payload = {\n ok: false as const,\n data: null,\n error,\n }\n console.error(stringifyJSON(payload))\n return\n }\n\n console.error(`[${error.code}] ${error.message}`)\n}\n\nconst firstLine = (message: string) => {\n const [head] = message.split(\"\\n\")\n return head?.trim() || message\n}\n\nexport const normalizeError = (error: unknown, verbose = false): OutputError => {\n if (error instanceof CLIError) {\n return {\n code: error.code,\n message: error.message,\n }\n }\n\n if (error instanceof FollowAuthError) {\n return {\n code: \"UNAUTHORIZED\",\n message: verbose ? error.message : firstLine(error.message),\n }\n }\n\n if (error instanceof FollowAPIError) {\n return {\n code: error.code ?? `HTTP_${error.status}`,\n message: verbose ? error.message : firstLine(error.message),\n }\n }\n\n if (error instanceof Error) {\n return {\n code: \"UNKNOWN_ERROR\",\n message: error.message,\n }\n }\n\n return {\n code: \"UNKNOWN_ERROR\",\n message: \"An unknown error occurred\",\n }\n}\n" }, { "path": "apps/cli/tsconfig.json", "content": "{\n \"extends\": \"@follow/configs/tsconfig.extend.json\",\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"lib\": [\"ES2022\"],\n \"moduleResolution\": \"Bundler\",\n \"types\": [\"node\"],\n \"noEmit\": true\n },\n \"include\": [\"src/**/*.ts\", \"tsup.config.ts\"]\n}\n" }, { "path": "apps/cli/tsup.config.ts", "content": "import { defineConfig } from \"tsup\"\n\nexport default defineConfig({\n entry: [\"src/index.ts\"],\n format: [\"esm\"],\n target: \"node18\",\n outDir: \"dist\",\n clean: true,\n sourcemap: false,\n dts: false,\n splitting: false,\n shims: false,\n banner: {\n js: \"#!/usr/bin/env node\",\n },\n})\n" }, { "path": "apps/cli/vitest.config.ts", "content": "import { defineProject } from \"vitest/config\"\n\nexport default defineProject({\n test: {\n environment: \"node\",\n },\n})\n" }, { "path": "apps/desktop/.env.example", "content": "VITE_WEB_URL=http://localhost:5173\nVITE_API_URL=http://localhost:3000\nVITE_IMGPROXY_URL=http://localhost:2873\nVITE_SENTRY_DSN=\nVITE_BUILD_TYPE=production\nVITE_INBOXES_EMAIL=@follow.re\n\nVITE_EDITOR=cursor\n\nVITE_PUBLIC_POSTHOG_KEY=\nVITE_PUBLIC_POSTHOG_HOST=\n" }, { "path": "apps/desktop/AGENTS.md", "content": "# AGENTS.md\n\nThis file provides specific guidance for developing the Electron desktop application.\n\n## Architecture\n\n- **Main Process** (`layer/main/`) - Electron main process handling system integration\n- **Renderer Process** (`layer/renderer/`) - Vite + React renderer (primary web app)\n\nThe renderer is the **primary web application** - a Vite + React SPA that can run both in Electron and as a standalone web app.\n\n## UI Style\n\n- **UI Design Style**: Follow Vercel and Linear SaaS UI aesthetics - clean, modern, minimal design with subtle shadows, rounded corners, and excellent typography\n- **Tailwind CSS** for styling across all platforms\n- Platform-specific Tailwind configs in each app\n\n## Development Commands\n\n```bash\n# Recommended: Browser development (faster)\npnpm run dev:web\n\n# Full Electron development\npnpm run dev:electron\n\n# Build web version\npnpm run build:web\n```\n\n## UIKit Colors for Desktop Components\n\nFor desktop components (`apps/desktop/**/*`) and shared UI components (`packages/internal/components/**/*`), use Apple UIKit color system with Tailwind classes. **Important**: Always use the correct Tailwind prefix for each color category:\n\n**System Colors**: `text-red`, `bg-red`, `border-red` (same for `orange`, `yellow`, `green`, `mint`, `teal`, `cyan`, `blue`, `indigo`, `purple`, `pink`, `brown`, `gray`)\n\n**Fill Colors**:\n\n- Background: `bg-fill`, `bg-fill-secondary`, `bg-fill-tertiary`, `bg-fill-quaternary`, `bg-fill-quinary`, `bg-fill-vibrant`, `bg-fill-vibrant-secondary`, `bg-fill-vibrant-tertiary`, `bg-fill-vibrant-quaternary`, `bg-fill-vibrant-quinary`\n- Border: `border-fill`, `border-fill-secondary`, etc.\n\n**Text Colors**: `text-text`, `text-text-secondary`, `text-text-tertiary`, `text-text-quaternary`, `text-text-quinary`, `text-text-vibrant`, `text-text-vibrant-secondary`, `text-text-vibrant-tertiary`, `text-text-vibrant-quaternary`, `text-text-vibrant-quinary`\n\n**Material Colors**: `bg-material-ultra-thick`, `bg-material-thick`, `bg-material-medium`, `bg-material-thin`, `bg-material-ultra-thin`, `bg-material-opaque`\n\n**Control Colors**: `bg-control-enabled`, `bg-control-disabled`\n\n**Interface Colors**: `bg-menu`, `bg-popover`, `bg-titlebar`, `bg-sidebar`, `bg-selection-focused`, `bg-selection-focused-fill`, `bg-selection-unfocused`, `bg-selection-unfocused-fill`, `bg-header-view`, `bg-tooltip`, `bg-under-window-background`\n\nThese colors automatically adapt to light/dark mode following Apple's design system. Remember to use the appropriate prefix (`text-`, `bg-`, `border-`) based on the CSS property you're styling.\n\n## Icons\n\nFor icon usage, prioritize the MingCute icon library with the `i-mgc-` prefix. Icons are available in the format `i-mgc-[icon-name]-[style]` where style can be `re` (regular), `fi` (filled), etc.\n\n**Important**: Always try to find an appropriate icon with the `i-mgc-` prefix first. Only use the `i-mingcute-` prefix as a fallback when no suitable `i-mgc-` icon exists.\n\nExamples:\n\n- Preferred: `i-mgc-copy-cute-re`, `i-mgc-external-link-cute-re`\n- Fallback only: `i-mingcute-copy-line` (only if no mgc equivalent exists)\n\n## Using Framer Motion\n\n- **LazyMotion Integration**: Project uses Framer Motion with LazyMotion for optimized bundle size\n- **Usage Rule**: Always use `m.` instead of `motion.` when creating animated components\n- **Import**: `import { m } from 'motion/react'`\n- **Examples**: `m.div`, `m.button`, `m.span` (not `motion.div`, `motion.button`, etc.)\n- **Benefits**: Reduces bundle size while maintaining all Framer Motion functionality\n- **Prefer Spring Presets**: Use predefined spring animations from `@follow/components/constants/spring.js`\n- **Available Presets Constants**: `Spring.presets.smooth`, `Spring.presets.snappy`, `Spring.presets.bouncy` (extracted from Apple's spring parameters)\n- **Usage Example**: `transition={Spring.presets.smooth}` or `transition={Spring.snappy(0.3, 0.1)}`\n- **Customization**: All presets accept optional `duration` and `extraBounce` parameters\n\n## Reusable UI Components\n\nWhen building UI components, follow this hierarchy:\n\n1. **Check Existing Components First**: Look in `apps/desktop/layer/renderer/src/modules/renderer/components` for app-specific components\n2. **Create Reusable Components**: If the component doesn't exist and is **generic/reusable** (not tied to specific app business logic), create it in `packages/internal/components`\n\n### Guidelines for Reusable Components (`packages/internal/components`)\n\n- **Purpose**: Components should be generic and reusable across different apps/contexts\n- **No Business Logic**: Avoid coupling with specific app business logic, APIs, or state management\n- **Follow All Style Rules**: Must adhere to UIKit colors, MingCute icons (`i-mgc-` prefix), and Framer Motion (`m.` prefix) guidelines\n- **Export Pattern**: Export components from appropriate index files for clean imports\n- **TypeScript**: Use proper TypeScript interfaces for props and maintain type safety\n\n**Example Structure**:\n\n```\npackages/internal/components/\n├── ui/ # Basic UI primitives (Button, Input, Modal)\n├── layout/ # Layout components (Grid, Stack, Container)\n├── feedback/ # User feedback (Toast, Loading, Alert)\n└── index.ts # Main exports\n```\n\n**Import Examples**:\n\n```tsx\n// Correct - from shared components\nimport { Button, Modal } from \"@follow/components\"\n\n// App-specific components stay in name/components\nimport { FeedList } from \"~/modules/name/components\"\n```\n\n## Glassmorphic Depth Design System\n\nFollow uses a sophisticated glassmorphic depth design system for elevated UI components (modals, toasts, floating panels, etc.). This design provides visual hierarchy through layered transparency and subtle color accents.\n\n### Design Principles\n\n- **Multi-layer Depth**: Create visual depth through stacked transparent layers\n- **Subtle Color Accents**: Use brand colors at very low opacity (5-20%) for borders, glows, and backgrounds\n- **Refined Blur**: Heavy backdrop blur (backdrop-blur-2xl) for frosted glass effect\n- **Minimal Shadows**: Combine multiple soft shadows with accent colors for depth perception\n- **Smooth Animations**: Use Spring presets for all transitions\n\n### Color Usage\n\n- **Primary Accent**: Use CSS variable `--fo-a` (HSL: `331.7 84% 67%`) at 5-20% opacity for borders, glows, and highlights\n- **Border**: `hsl(var(--fo-a) / 0.2)` for main borders\n- **Inner Glow**: `hsl(var(--fo-a) / 0.05)` for subtle radial/linear gradients inside containers\n- **Shadows**: Layered shadows with accent tint:\n - `0 8px 32px hsl(var(--fo-a) / 0.08)` - large soft glow\n - `0 4px 16px hsl(var(--fo-a) / 0.06)` - medium shadow\n - `0 2px 8px rgba(0, 0, 0, 0.1)` - close depth\n\n### Component Structure\n\n```tsx\n<div\n className=\"rounded-2xl backdrop-blur-2xl\"\n style={{\n backgroundImage:\n \"linear-gradient(to bottom right, rgba(var(--color-background) / 0.98), rgba(var(--color-background) / 0.95))\",\n borderWidth: \"1px\",\n borderStyle: \"solid\",\n borderColor: \"hsl(var(--fo-a) / 0.2)\",\n boxShadow:\n \"0 8px 32px hsl(var(--fo-a) / 0.08), 0 4px 16px hsl(var(--fo-a) / 0.06), 0 2px 8px rgba(0, 0, 0, 0.1)\",\n }}\n>\n {/* Inner glow layer */}\n <div\n className=\"absolute inset-0 rounded-2xl\"\n style={{\n background:\n \"linear-gradient(to bottom right, hsl(var(--fo-a) / 0.05), transparent, hsl(var(--fo-a) / 0.05))\",\n }}\n />\n\n {/* Content */}\n <div className=\"relative\">{/* Your content here */}</div>\n</div>\n```\n\n### Interactive Elements\n\nFor hover states on buttons or interactive areas within glass containers:\n\n```tsx\n<button\n onMouseEnter={(e) => {\n e.currentTarget.style.background =\n \"linear-gradient(to right, hsl(var(--fo-a) / 0.08), hsl(var(--fo-a) / 0.05))\"\n }}\n onMouseLeave={(e) => {\n e.currentTarget.style.background = \"transparent\"\n }}\n>\n {/* Subtle shine effect */}\n <div className=\"absolute inset-0 -translate-x-full bg-gradient-to-r from-transparent via-gray/5 to-transparent transition-transform duration-700 group-hover:translate-x-full dark:via-white/5\" />\n</button>\n```\n\n### Dividers\n\nUse gradient dividers within glass containers:\n\n```tsx\n<div\n className=\"mx-4 h-px\"\n style={{\n background: \"linear-gradient(to right, transparent, hsl(var(--fo-a) / 0.2), transparent)\",\n }}\n/>\n```\n\n### Animation Guidelines\n\n- Entry animations: `initial={{ y: 8, opacity: 0 }}` → `animate={{ y: 0, opacity: 1 }}`\n- Use `Spring.presets.snappy` for quick interactions\n- Use `Spring.presets.smooth` for larger movements\n- Keep scale animations subtle (1.0 ↔ 1.02)\n\n### When to Use\n\nApply this design system to:\n\n- Toast notifications\n- Modal dialogs\n- Floating panels and popovers\n- Ambient UI prompts\n- Contextual menus\n- Elevated cards with actions\n\n### Accessibility\n\n- Ensure sufficient contrast for text over glass backgrounds\n- Maintain border visibility in both light and dark modes\n- Preserve keyboard focus indicators\n- Keep animations respectful of `prefers-reduced-motion`\n\n## Build Outputs\n\n- Desktop: `apps/desktop/out/` for packaged applications\n- Web: `apps/desktop/out/web/` for static web assets\n" }, { "path": "apps/desktop/build/appxmanifest-template.xml", "content": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Package\n xmlns=\"http://schemas.microsoft.com/appx/manifest/foundation/windows10\"\n xmlns:uap=\"http://schemas.microsoft.com/appx/manifest/uap/windows10\"\n xmlns:rescap=\"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities\"\n xmlns:mp=\"http://schemas.microsoft.com/appx/2014/phone/manifest\">\n <Identity Name=\"{identityName}\"\n ProcessorArchitecture=\"x64\"\n Publisher=\"{publisherName}\"\n Version=\"{packageVersion}\" />\n <Properties>\n <DisplayName>{packageDisplayName}</DisplayName>\n <PublisherDisplayName>{publisherDisplayName}</PublisherDisplayName>\n <Description>No description entered</Description>\n <Logo>assets\\SampleAppx.50x50.png</Logo>\n </Properties>\n <Resources>\n <Resource Language=\"en-us\" />\n <Resource Language=\"zh-cn\" />\n <Resource Language=\"zh-tw\" />\n <Resource Language=\"ja\" />\n </Resources>\n <Dependencies>\n <TargetDeviceFamily Name=\"Windows.Desktop\" MinVersion=\"10.0.14316.0\" MaxVersionTested=\"10.0.14316.0\" />\n </Dependencies>\n <Capabilities>\n <rescap:Capability Name=\"runFullTrust\"/>\n </Capabilities>\n <Applications>\n <Application Id=\"{packageName}\" Executable=\"{packageExecutable}\" EntryPoint=\"Windows.FullTrustApplication\">\n <uap:VisualElements\n BackgroundColor=\"{packageBackgroundColor}\"\n DisplayName=\"{packageDisplayName}\"\n Square150x150Logo=\"assets\\SampleAppx.150x150.png\"\n Square44x44Logo=\"assets\\SampleAppx.44x44.png\"\n Description=\"{packageDescription}\">\n <uap:DefaultTile Wide310x150Logo=\"assets\\SampleAppx.310x150.png\" />\n </uap:VisualElements>\n <Extensions>{protocol}\n </Extensions>\n </Application>\n </Applications>\n</Package>\n" }, { "path": "apps/desktop/build/entitlements.mac.plist", "content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n <dict>\n <key>com.apple.security.cs.allow-jit</key>\n <true/>\n </dict>\n</plist>\n" }, { "path": "apps/desktop/build/entitlements.mas.child.plist", "content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n <dict>\n <key>com.apple.security.app-sandbox</key>\n <true/>\n <key>com.apple.security.inherit</key>\n <true/>\n </dict>\n</plist>\n" }, { "path": "apps/desktop/build/entitlements.mas.plist", "content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n <dict>\n <key>com.apple.security.app-sandbox</key>\n <true/>\n <key>com.apple.security.files.user-selected.read-write</key>\n <true/>\n <key>com.apple.security.files.bookmarks.app-scope</key>\n <true/>\n <key>com.apple.security.network.client</key>\n <true/>\n </dict>\n</plist>\n" }, { "path": "apps/desktop/bump.config.ts", "content": "/* eslint-disable no-template-curly-in-string */\nimport { defineConfig } from \"nbump\"\n\nexport default defineConfig({\n leading: [\n \"git pull --rebase\",\n \"tsx scripts/apply-changelog.ts ${NEW_VERSION}\",\n \"git add changelog\",\n \"tsx plugins/vite/generate-main-hash.ts\",\n \"pnpm eslint --fix package.json\",\n \"pnpm prettier --ignore-unknown --write package.json\",\n \"git add package.json\",\n ],\n trailing: [\"git checkout -b release/desktop/${NEW_VERSION}\"],\n finally: [\n \"git push origin release/desktop/${NEW_VERSION}\",\n \"gh pr create --title 'release(desktop): Release v${NEW_VERSION}' --body 'v${NEW_VERSION}' --base main --head release/desktop/${NEW_VERSION}\",\n ],\n push: false,\n commitMessage: \"release(desktop): release v${NEW_VERSION}\",\n tagPrefix: \"desktop@\",\n changelog: false,\n allowedBranches: [\"dev\"],\n})\n" }, { "path": "apps/desktop/bump.hotfix.config.js", "content": "/* eslint-disable no-template-curly-in-string */\nimport { execSync } from \"node:child_process\"\n\nimport { defineConfig } from \"nbump\"\n\nconst currentBranch = execSync(\"git rev-parse --abbrev-ref HEAD\").toString().trim()\n\nexport default defineConfig({\n before: [\"git pull --rebase\"],\n after: [\n `gh pr create --title 'chore(desktop): Release v\\${NEW_VERSION} for hotfix' --body 'v\\${NEW_VERSION}' --base main --head ${currentBranch}`,\n ],\n commit_message: \"release(desktop): hotfix to release v${NEW_VERSION}\",\n tag: false,\n changelog: false,\n allowedBranches: [\"hotfix/*\"],\n})\n" }, { "path": "apps/desktop/changelog/0.1.2.md", "content": "# What's new in v0.1.2\n\n## Features\n\n- Custom CSS is now supported, so you can add any CSS style and apply it to the Entry content view.\n- New Zen mode has been added, so you can now read the full text in full screen without interruption, and we've optimized the user experience of the ToC component in full screen mode as well as added a new brief timeline on the left side.\n- Support for hiding extra badges around the feed, such as Claim or Boost, which you may not want to see.\n\n## Improvements\n\n- Fixed the issue that Entry list cannot be loaded offline.\n- Optimized the performance experience of some scenarios.\n- The UI of some components has been fine-tuned to look more natural.\n" }, { "path": "apps/desktop/changelog/0.2.0.md", "content": "# What's new in v0.2.0\n\n## New Features\n\n- Feed owners can now reset their feeds.\n- Image Gallery: Clicking on the image button in the entry opens the Image gallery modal (only if there are multiple large images in the entry!).\n- Now you can export the data from the local database.\n- App: In consideration of your hard drive, now it supports clearing cache and limiting the size of cache.\n- Added a new feature to allow minimizing to the system tray by enabling a switch in the settings.\n- Discover Page: Enhance RSSHub recommendations with filters\n- Quickly update views or categories at once by dragging and dropping.\n\n## Improvements\n\n- Optimized the Zen mode experience on macOS.\n- Improvement web app global shortcuts.\n- Optimized the Timeline's data cache, reducing data reloads within a short period of time. You can go to Settings -> General -> Timeline -> Reduce timeline refetch to control this feature, default is enabled.\n\n## Bug Fixes\n\n- Fixed the issue where the Volume of VideoPlayer was not clickable.\n- While using arrow keys to switch between entries, the entry view will not scroll unexpexted.\n" }, { "path": "apps/desktop/changelog/0.2.1.md", "content": "# What's new in v0.2.1\n\n## New Features\n\n- Added zoom functionality for viewing pictures.\n- Set `Show Unread Only` as the default option.\n- Merged the redirect page with the login page.\n- Introduced entry conditions for actions.\n- Added `all` language filter in dicover page.\n\n## Improvements\n\n- Enhanced the logic for multi-selection and dragging.\n\n## Bug Fixes\n\n- Resolved issue with loading Instagram images.\n" }, { "path": "apps/desktop/changelog/0.2.2.md", "content": "# What's new in v0.2.2\n\n## New Features\n\n- And Or conditions for actions\n- Add achievement badge\n\n## Improvements\n\n- electron: Prompt when opening an external link whether to open the app\n- Improve the smoothness of some animations\n" }, { "path": "apps/desktop/changelog/0.2.3.md", "content": "# What's new in v0.2.3\n\n## New Features\n\n- Hold shift to quickly select multiple Feeds\n- Collect entry from List\n\n## Improvements\n\n## Bug Fixes\n\n- Action settings are invalid after loading archive entry\n- Redundant parameter on the transform form\n- Can't play normal video in video view\n" }, { "path": "apps/desktop/changelog/0.2.4.md", "content": "# What's new in v0.2.4-web\n\n## New Features\n\n🎉 HUGE NEWS! Follow finally goes mobile!\n\nEver wished you could Follow your favorite feeds while lounging on your couch? Well, now you can! We've made Follow fully responsive and mobile-friendly. Whether you're on your phone during your commute or browsing from bed (we won't judge), Follow's got your back!\n" }, { "path": "apps/desktop/changelog/0.2.5.md", "content": "# What's new in v0.2.5\n\n## New Features\n\n- Customizable columns for masonry view\n- Manually trigger AI summary or translation\n\n![](https://fastly.jsdelivr.net/gh/RSSNext/assets@main/masonry.mp4)\n\n## Improvements\n\n## Bug Fixes\n\n- Fixed some display and operation issues on mobile\n" }, { "path": "apps/desktop/changelog/0.2.6.md", "content": "# What's new in v0.2.6\n\nWe've made some ux optimizations:\n\n- [Mobile]: Now when returning to the list from the entry details, it will not return to the top of the page.\n- [Social Media]: Optimized the arrangement of multiple images with different aspect ratios.\n- [Social Media]: Long text auto-collapse.\n\nAnd many other bug fixes and improvements.\n" }, { "path": "apps/desktop/changelog/0.2.7.md", "content": "# What's new in v0.2.7\n\n## New Features\n\n1. New `Move to Category` operation in feed subscription context menu\n\n![](https://github.com/RSSNext/assets/blob/main/0.2.7/move-category.png?raw=true)\n\n2. New `Expand long social media` setting to automatically expand social media entries containing long text.\n\n![](https://github.com/RSSNext/assets/blob/main/0.2.7/expand-long-social-media.png?raw=true)\n\n3. New `Back Top` button and read progress indicator in entry content\n\n![](https://github.com/RSSNext/assets/blob/main/0.2.7/read-indicator.png?raw=true)\n\n4. Independent Action page\n\n## Bug Fixes\n\n- Resolved issue where back navigation to the pending view would not behave correctly after changing orientation in some device.\n- Fixed issue can't filter entries with no picture in the picture view.\n" }, { "path": "apps/desktop/changelog/0.2.8.md", "content": "# What's new in v0.2.8\n\n## New Features\n\n- Register or Login with email and password\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.2.9.md", "content": "# What's new in v0.2.9\n\n## New Features\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.0.md", "content": "# What's new in v0.3.0\n\n## New Features\n\n- **Custom RSSHub Instances**: Use custom RSSHub instances to improve data acquisition efficiency. Contribute your self-deployed RSSHub instances to earn additional $POWER.\n ![Custom RSSHub](https://github.com/RSSNext/assets/blob/main/custom-rsshub.png?raw=true)\n- **OPML Export Options**: Optionally specify the RSSHub URL and folder classification mode when exporting OPML files.\n ![Export OPML](https://github.com/RSSNext/assets/blob/main/export-options.png?raw=true)\n- **Account Management**: Update your email and manage linked social accounts easily.\n ![Account Management](https://github.com/RSSNext/assets/blob/main/account-management.png?raw=true)\n\n## Improvements\n\n- Update email and manage linked social accounts\n- Scroll to top when re-navigating to Discover page while already on it\n\n## Bug Fixes\n\nSome bugs are fixed.\n" }, { "path": "apps/desktop/changelog/0.3.1.md", "content": "# What's new in v0.3.1\n\n## New Features\n\n- **Customize toolbar**: Customize the toolbar to display the items you most frequently use.\n ![Customize toolbar](https://github.com/RSSNext/assets/blob/main/customize-toolbar.mp4?raw=true)\n\n## Improvements\n\n- **Podcast Player**: Re-designed the podcast player in mobile to be more user-friendly.\n ![Podcast Player](https://github.com/RSSNext/assets/blob/8f778dac8bb2e765acab2157497e4a77a60c5a0b/mobile-audio-player.png?raw=true)\n- **Social Media View Action**: Redesigned the toolbar style in the social media view. Now, the toolbar no longer jitters or gets obstructed when hovering over entries.\n ![Social Media View Action](https://github.com/RSSNext/assets/blob/main/social-media-actions.png?raw=true)\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.10.md", "content": "# What's new in v0.3.10\n\n## New Features\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.11.md", "content": "# What's new in v0.3.11\n\n## New Features\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.12.md", "content": "# What's new in v0.3.12\n\n## New Features\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.13.md", "content": "# What's new in v0.3.13\n\n## New Features\n\n- New Action Language setting\n- Export entry content to a PDF file\n\n## Improvements\n\n## Bug Fixes\n\n- Unable to update subscription information in time\n" }, { "path": "apps/desktop/changelog/0.3.2.md", "content": "# What's new in v0.3.2\n\n## New Features\n\n- Added support for Two-Factor Authentication (2FA) for login and large transactions.\n\n## Improvements\n\n- Enhanced detection for translation needs and improved display of translated text.\n\n## Bug Fixes\n\n- Resolved an issue where some read marks were missed during fast scrolling.\n- Unable to copy inbox email address correctly\n" }, { "path": "apps/desktop/changelog/0.3.3.md", "content": "# What's new in v0.3.3\n\n## New Features\n\n## Improvements\n\n- Merge actions for toggling state\n- Action supports matching custom title\n\n## Bug Fixes\n\n- `Failed to set voice` error message appears every time the app starts\n- Can not replay TTS\n- Login state lost when restarting the app\n" }, { "path": "apps/desktop/changelog/0.3.4.md", "content": "# What's new in v0.3.4\n\n## New Features\n\n- The audio and notification views have been merged into the article view, being included in a new timeline selector\n ![Timeline selector1](https://github.com/RSSNext/assets/blob/main/timeline-selector1.png?raw=true)\n ![Timeline selector2](https://github.com/RSSNext/assets/blob/main/timeline-selector2.png?raw=true)\n- Support custom font and line height for content\n- Support custom date format for entry title date\n ![Custom content styles](https://github.com/RSSNext/assets/blob/main/custom-content-styles.png?raw=true)\n\n## Improvements\n\n- Optimize translation display\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.5.md", "content": "# What's new in v0.3.5\n\n## New Features\n\n- Restore audio and notification views\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.3.6.md", "content": "# What's new in v0.3.6\n\n## New Features\n\n- Added a quick selector to the timeline column.\n\n![](https://github.com/RSSNext/assets/raw/refs/heads/main/timeline-selector.mp4)\n\n## Improvements\n\n## Bug Fixes\n\n- Resolved the issue of being unable to reset it to empty after using the proxy.\n" }, { "path": "apps/desktop/changelog/0.3.7.md", "content": "# What's new in v0.3.7\n\n## New Features\n\n- Revert to the previous list display styles.\n ![Timeline selector3](https://github.com/RSSNext/assets/blob/main/timeline-selector3.png?raw=true)\n- The entries of the list is now displayed directly in the timeline.\n" }, { "path": "apps/desktop/changelog/0.3.8.md", "content": "# What's new in v0.3.8\n\n## New Features\n\n## Improvements\n\n## Bug Fixes\n\n- The app is stuck after closing the dialog\n- Can not sign in with email in the desktop app\n" }, { "path": "apps/desktop/changelog/0.3.9.md", "content": "# What's new in v0.3.9\n\n## New Features\n\n## Improvements\n\n## Bug Fixes\n" }, { "path": "apps/desktop/changelog/0.4.0.md", "content": "# What's New in v0.4.0\n\n## New Features\n\n- New global settings for AI summary and translation (#3294)\n- Display estimated audio duration for entry titles (#3292)\n- Simplify settings via an enhanced settings toggle (217e1a8)\n\n## Improvements\n\n- Enhanced translation quality for entry content (#3294)\n- Refine toolbar customization (#3284)\n- Sign Windows executable files using SignPath (#3286)\n- Remove email verification toast notifications (9bb723a)\n- Restrict Zen mode display width (d107127)\n- Update MGC Icon to v1.36 (#3310)\n- Enhance UX for the withdraw modal (#3311)\n- Improve visibility and layout of the action settings button (0d5cb13)\n\n## Bug Fixes\n\n- Fix reCAPTCHA being unclickable (305c4bc)\n- Correct store not updating after marking items as read in the list (e8305f8)\n" }, { "path": "apps/desktop/changelog/0.4.1.md", "content": "# What's New in v0.4.1\n\n## New Features\n\n- Added a \"Mark Above as Read\" button at the bottom of the entry list (88963a9)\n\n## Improvements\n\n- Enable linking social accounts with a different email (#3355)\n- Integrated a more advanced AI model for enhanced performance\n- Increased the number of invitation codes that users can create\n- Excluded entries without images from the picture view for a streamlined browsing experience\n\n## Bug Fixes\n\n- Updated the icon for \"View Source Content\" to distinguish it from \"Open in Browser\" (#3373)\n- Fixed the problem of unread entries being incorrectly marked as read (#3305)\n- Corrected an issue where the modal's close button was unresponsive in certain scenarios (#3387)\n- Addressed a bug that prevented actions from being saved when empty (a997329)\n- Corrected an issue where unread statuses were not properly displayed in some instances\n- Fixed the timing of new content notifications to ensure they are sent only after the content is available\n" }, { "path": "apps/desktop/changelog/0.4.2.md", "content": "# What's New in v0.4.2\n\n## Shiny new things\n\n- Added Cubox integration (#3385)\n- Included document links on the actions and discover pages (acdca33)\n\n## Improvements\n\n- Optimized AI summary styles\n- Redesigned the search card in Discover; now displaying feed update time and frequency more intuitively\n- Revamped the header UI and interactions for a more concise, dynamic experience\n- Removed the mark-as-read confirmation (04e8a48)\n- Added pulse animation to the skeleton component (#3369)\n- Refined the sorting logic for RSSHub instances (a824343)\n- Enabled AI summary by default (8da8a71)\n- Enhanced the entry sharing copy by including both title and description (#3462)\n- Displayed text content within video modal preview (#3458)\n\n## No longer broken\n\n- Fixed incorrect translation results and formatting (55524b) (#3421)\n- Restored the entry list header in the inbox\n- Resolved issues with masonry layout column adjustments failing in certain cases (#3425)\n- Hid the \"open in browser\" option when it is unavailable (ffada7c)\n- Corrected the inbox unread count to ensure it is up to date (82baf0b)\n- Prevented updates to the inbox unread count for read entries during deletion (c6024e3)\n- Fixed an issue where videos were not displayed correctly at times (935e39b)\n" }, { "path": "apps/desktop/changelog/0.4.3.md", "content": "# What's New in v0.4.3\n\n## Shiny new things\n\n- Added server‑side readability with AI‑powered summaries and translation support (#3498)\n- You can now delete RSSHub instances (2d33a22)\n- Unread counts are displayed in the system tray (665221d)\n- Copy feed badge from the context menu (144f709)\n\n## Improvements\n\n- Option to save AI summaries as the Cubox description (#3478)\n- Improved email validation and smoother reCAPTCHA closure on the sign‑in and sign‑up pages (#3510)\n- Added new action icons and updated the share and AI icons (f526edf, f447d6a, 34da9d2)\n- Enhanced security with one‑time tokens (#3482)\n- Translated titles and their original text now appear on separate lines (49f3cc2)\n- TTS action is hidden by default (3157ecf)\n\n## No longer broken\n\n- Fixed TTS playback failure (a4d1653)\n- Fixed corner player not navigating to the correct entry (#1401)\n- Fixed issue that prevented saving to Readwise (53da938)\n- Fixed missing “Mark above as read” option in the picture masonry layout footer (e018736)\n- Fixed a potential login drop issue (0ee8510)\n" }, { "path": "apps/desktop/changelog/0.4.4.md", "content": "# What's new in v0.4.4\n\n## Shiny new things\n\n- Added status action that allows you to send notifications or trigger webhooks for starred entries (9222553)\n\n## Improvements\n\n- Refreshed color palette and numerous style tweaks for a cleaner look\n- Redesigned context and dropdown menus for faster, more intuitive navigation (c995da3)\n- Balances now display a maximum of two decimal places (#3564)\n\n## No longer broken\n\n- Fixed an issue that stopped local settings from syncing with the cloud (7048aa9)\n- Corrected mis-redirects caused by malformed site URLs (2bbb00c)\n- Resolved tap-selection problems in entry lists on iPad Web (9da9dec)\n- Eliminated a crash in the Settings menu (5120c2c)\n\n## Thanks\n\nSpecial thanks to external contributors @kovsu @Vixb1122 @johnsoncodehk for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.4.5.md", "content": "# What's new in v0.4.5\n\n## Shiny new things\n\n- Translation view toggle – choose between “translation-only” or bilingual display (#3568)\n- Mark Above/Below as Read option in the context menu (#3570)\n- Automation actions: auto start entries that match your rules (#3625)\n- Trending Feeds now spotlighted on the Discover page (eb6a409)\n- Timeline previews for feeds you haven’t subscribed to yet (eb26cde)\n- Invite-code gates removed – no invite code needed anymore (cee647c)\n\n## Improvements\n\n- Seamless fallback to client-side readability if the server parser fails (e6aa58e)\n- Onboarding completely redesigned and streamlined (0357b7d)\n- Removed long-unmaintained language packs (f48697c)\n- Faster search performance\n- AI summaries now render Markdown (#3641)\n- Upgraded to React 19 and React Native 0.79 (#3661)\n- Cleaner category layout in the Discover page\n- Smoother sign-up / sign-in flow (e7f88b7)\n- Dozens of visual polish tweaks across the app\n\n## No longer broken\n\n- Fixed occasional misplacement of the scroll indicator (87c9a48)\n- Font settings now apply correctly (5aed9a7)\n- Different views no longer clash with one another’s scroll positions (#3627)\n- Picture and video view sizes no longer interfere with each other (#3645)\n- Correct sorting icon in the feed list (#3675)\n- Custom fonts containing spaces now render properly (#3674)\n\n## Thanks\n\nSpecial thanks to external contributors @kovsu @ericyzhu @cuikaipeng @grtsinry43 @cscnk52 for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.4.6.md", "content": "# What's new in v0.4.6\n\n## Shiny new things\n\n- Hide read subscriptions. You can now hide subscriptions with no unread items. Enable it in Settings → General → Subscriptions → Hide Read. (1b88d72)\n- Vim-style keyboard navigation with smarter focus detection: (262a7ce c2d8ffa)\n - Timeline focus: `j`/`k` or ↓/↑ to move between entries; `Enter` to open the selected entry.\n - Entry focus: `h`/`l` or ←/→ to jump to previous/next entry, `j`/`k` or ↓/↑ to scroll, `Esc` or `Backspace` to return to the Timeline.\n - Subscription list focus: `j`/`k` or ↓/↑ to move, `Enter` to open the Timeline, `Z` to collapse/expand a folder.\n\n## Improvements\n\n- Clearer RSSHub error messages. (ed95fb6b)\n- AI summary is now enabled by default. (f329ae9)\n- Social-media view shows a richer action bar. (b06d8ff)\n- No more notification-permission prompts when your actions don’t need them. (450b759)\n- Discover page now remembers your language preference. (180933b)\n\n## No longer broken\n\n- Fixed incorrect language display in Shiki code blocks. (20049b0)\n- Fixed occasional subscription-status errors. (9b0691a)\n- Fixed default view in the subscription dialog. (bf26a3e)\n- Fixed login dialog styling in dark mode. (e18f052)\n- Fixed duplicated action bar in social-media view. (a917231)\n\n## Thanks\n\nSpecial thanks to external contributors @cleves0315 @grtsinry43 for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.4.8.md", "content": "# What's new in v0.4.8\n\n## Shiny new things\n\n- Keyboard Shortcuts – a full-featured command system covering global actions, layout control, timeline navigation, content rendering, subscription management, and entry operations. Browse and remap shortcuts under `Preferences → Shortcuts`.\n- Zotero Integration – connect with the popular open-source reference manager to streamline your research workflow (#3738)\n- Discover now includes the complete RSSHub route catalogue with a dedicated RSSHub category page featuring route search, trending routes, and popular examples (5f06de0)\n- Notifications settings – explore and test every available notification channel in one place (0db149f)\n- New option to hide private subscriptions in the Timeline: `Preferences → General → Subscription → Hide Private` (#3773)\n\n## Improvements\n\n- Suscription form now shows each list’s subscriber count and last-updated time (e525edc)\n- Video view now displays the video’s total duration (2234b4b)\n- Added compatibility for both `folo` and `follow` URI schemes (4fa171b)\n\n## No longer broken\n\n- Resolved blur effect not applying on the macOS Electron vibrancy layer (33ef0c4)\n- “More” label stays hidden when the entry-history limit isn’t reached (04583a3)\n- Fixed certain videos failing to render inside entries (c48b94a)\n\n## Thanks\n\nSpecial thanks to external contributors @kovsu, @cscnk52, @cleves0315, @ericyzhu, @1411430556, and @ufec for their valuable contributions.\n" }, { "path": "apps/desktop/changelog/0.5.0.md", "content": "# What's New in v0.5.0\n\n## Shiny new things\n\n- Double-clicking the draggable edge on either side of the entry list resets it to its default position (26c6853)\n- Brand-new Feed Manager panel (dbd43ae)\n- OPML import now offers a preview and lets you choose specific feeds to import (de6c2ff)\n- All-new Share sheet (5bbd96e)\n\n## Improvements\n\n- Switched to hCaptcha for a smoother human-verification experience (22aec92)\n- Gradually rolling out an experimental unified local database for mobile and desktop (#3809)\n- Implemented smooth scrolling (6c73ae5)\n- Significant overall performance boost\n- AI will skip summarising extra-short articles to avoid trivial summaries (852fb1d)\n- Added “Reset to defaults” button to the shortcuts page (#3834)\n- Added a border around 2-factor QR codes for better scan reliability (f7faf78)\n- RSSHub routes top-feed list now respects your Discover-language setting (14d4da3)\n- Audio player now prefers episode artwork over feed artwork (#3855)\n- You can now manually paste your login token to bypass Microsoft Store deeplink issues (47e07a4)\n- Added “Check for updates” button in Settings (ef304cd)\n\n## No longer broken\n\n- Dropdown menus now keep keyboard focus when opened (f31d43d)\n- “Mark as read” button is now perfectly centred (#3836)\n- Entry list no longer displays stale cached items (0a167ac)\n- Squashed numerous shortcut-key bugs\n\n## Thanks\n\nSpecial thanks to external contributors @ericyzhu @kovsu @yeeway0609 @cscnk52 for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.6.0.md", "content": "# What's New in v0.6.0\n\nThis version has been withdrawn.\n" }, { "path": "apps/desktop/changelog/0.6.1.md", "content": "# What's New in v0.6.1\n\n## Shiny New Things\n\n- Import and export your Actions (394d00f)\n- Add a bio, website, and social links to your profile (507a525)\n- Upload a profile picture\n- Use video duration as an Action condition\n\n## Improvements\n\n- A snazzy new look for your personal profile\n- Redesigned the Actions page (1ace5ea)\n- Redesigned the RSSHub page (f9aca60)\n- Added length limits to certain profile fields\n- Simplified default commands in the entry tool (85122fb)\n- Enhanced UI labels and descriptions for clarity (2ed9f70)\n- Gradually rolling out an experimental unified local database for mobile and desktop (#3897 #3902)\n- Polished image-preview styling (cf72753)\n- Refined toast notifications (73f8011)\n\n## No Longer Broken\n\n- More reliable automatic recovery after database-migration failures (c2e0c3d)\n- Fixed unread counts not clearing in the macOS Docker build (70255af)\n- Fixed old entries showing during initial load (24ae065)\n- Fixed handling of links starting with `.` (de8eac8)\n- Fixed text-to-speech not working (82952b0)\n- Fixed star/unstar status not syncing across devices (fbd0b3)\n\n## Thanks\n\nSpecial thanks to volunteer contributors @kovsu @huanfe1 @cscnk52 @Olexandr88 @0-o0 @kingsword09 @ericyzhu for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.6.2.md", "content": "# What's new in v0.6.2\n\n## Shiny new things\n\n- New “Fade Read Items” option dims read entries in the timeline (eeeea47)\n- YouTube videos now play directly in the Articles view (#4096)\n- Choose your own accent color for the interface (47129d5)\n\n## Improvements\n\n- Clearer podcast duration display (#4001)\n- Added a Sign In / Sign Up toggle on the email page (81c544a)\n- Smarter visibility logic for the picture action bar (#4033)\n- Edit Feed now shows only categories relevant to the current view (#4094)\n- “Mark above as read” button no longer appear in the Starred list (#4083)\n- RSSHub and Trending queries persist between sessions (7a95a15)\n- Refined profile layout (#4101)\n\n## No longer broken\n\n- Discover page scroll indicator now can reach 100% (#3962)\n- “Mark as Read” keyboard shortcut works again (24113f7)\n- Fixed infinite scrolling when dragging in Customize Toolbar settings (#4018)\n- Fixed the bug that you can’t mark an entry as Unread (8ea13a3)\n- Clicking Read more in Social Media view no longer refreshes the page (#4027)\n- Entries with special characters in the title can be saved to Obsidian (f6cff2a)\n- Image downloads are now reliable (#4095)\n- Corrected Inbox “Mark as Read” logic (7c1bf99)\n- Prevented feed click event from bubbling to route item (#4113)\n- Fixed the bug that source content not triggered automatically (c5edc76)\n\n## Thanks\n\nSpecial thanks to volunteer contributors @ericyzhu @cscnk52 @kovsu @Fatpandac @dai @LitoMore @kira-offgrid @AkaShark @RtYkk for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.6.3.md", "content": "# What's new in v0.6.3\n\n## Shiny new things\n\n- Hide From Timeline option for subscriptions to make your timeline cleaner.\n- BitTorrent attachment support and qBittorrent integration.\n\n## Improvements\n\n- Clearer loading indicators for both the entry list and the subscription list (e81220d)\n- The hyperlink in the article preview has been added with an emphasis color. (db67ec8)\n- Search results now persist across navigation.\n- Sort feed by subscription count or update per week in feed management.\n- Notification support for inbox.\n\n## No longer broken\n\n- Fresh entries are no longer incorrectly auto‑marked as read after a list refresh. (d3d1e05)\n- Fixed the timing of masonry column width calculations to avoid layout glitches. (17389d9)\n- Removed placeholders in the picture waterfall view to prevent incorrectly layout redraws. (3c4b152)\n- Corrected initial height calculation for items in the picture waterfall view. (82a3537)\n- Fixed the Microsoft Store build not being recognized by deep links. (943ef31)\n- Right-click context menu shortcut can't trigger the context menu. (b44bf71)\n- Text in the social media view is now selectable.\n- Translation settings can not be toggled.\n- Fixed can not mark read/unread for starred entries.\n- Feeds with invalid site URLs being hidden in the feed list.\n- List with unread entries being hidden when Hide Read option is enabled.\n- Inbox can not receive text only emails like Gmail Forward verification.\n\n## Thanks\n\nSpecial thanks to volunteer contributors @kovsu, @cscnk52, @yansq, @hellosunghyun for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.7.0.md", "content": "# What's new in v0.7.0\n\n## Shiny new things\n\n- Add custom integration configurations to adapt to more apps\n\n## Improvements\n\n- Redesign integration settings page for better user experience and support integration settings export and import.\n\n## No longer broken\n\n## Thanks\n\nSpecial thanks to volunteer contributors @ for their valuable contributions\n" }, { "path": "apps/desktop/changelog/0.8.0.md", "content": "# What's new in v0.8.0\n\n## Shiny new things\n\n- Smart onboarding that gets you started in seconds.\n- One place for all your feeds.\n- A cleaner, consistent reading experience for social media posts, picture galleries, videos, and articles.\n- Support subtitles for podcasts and videos.\n- Redesigned Actions for easier setup.\n\n## Improvements\n\n- We have made countless improvements and bug fixes in this version.\n" }, { "path": "apps/desktop/changelog/0.9.0.md", "content": "# What's new in v0.9.0\n\n## Improvements\n\n- Removed the limit on the maximum number of views (b69a935)\n- Allow hiding the “All” view (0882e47)\n- Introduced a right-click menu for views, allowing quick access to hide or open settings (60dcd42)\n- Added a smooth sliding animation when opening entry details (1720ebb)\n\n## No longer broken\n\n- Fixed an issue where the scrollbar didn’t reset when switching between entry details (21124f5)\n" }, { "path": "apps/desktop/changelog/1.0.0.md", "content": "# What's new in v1.0.0\n\n## Shiny new things\n\n- 🌟 **Folo is now the AI Reader** — a smarter way to follow everything.\n\n## Improvements\n\n- Added support for multilingual `params` in YouTube video previews (#4610)\n- Redirects now go to your configured first view instead of always defaulting to All (a82b0e9)\n\n## No longer broken\n\n- Fixed the hover indicator style on the audio player progress bar (#4600)\n- Fixed video autoplay in media previews (#4531)\n\n## Thanks\n\nSpecial thanks to volunteer contributors @yeeway0609 @kovsu @unixzii for their valuable contributions\n" }, { "path": "apps/desktop/changelog/1.1.0.md", "content": "# What's new in v1.1.0\n\n## Shiny new things\n\n- Reintroduced the clean, efficient three-column layout for a smoother reading experience.\n- Added out-of-the-box Fabric integration for MCP users.\n\n## Improvements\n\n- Automatically generate chat titles during live sessions.\n- Simplified AI usage metrics display with improved styling.\n- Added a progress bar to the onboarding feed subscription step.\n- Adopted a more reliable mechanism for checking software updates.\n- Windows now starts minimized to the system tray by default.\n- Timeline AI summaries now trigger automatically in all views.\n- Simplified the AI reasoning display for better clarity.\n- Onboarding flow now allows manual skipping.\n- Merged AI chat history and AI task history into a single dropdown for easier access.\n\n## No longer broken\n\n- Fixed an issue where the Windows EXE software update check failed to run properly.\n- Fixed a bug preventing category movement in the “All” view.\n- Fixed occasional AI chat interruptions under certain conditions.\n\n## Thanks\n\nSpecial thanks to volunteer contributors @kovsu for their valuable contributions\n" }, { "path": "apps/desktop/changelog/1.2.2.md", "content": "# What's new in v1.2\n\n## Shiny new things\n\n- **AI**\n - Added **BYOK (Bring Your Own Key)** support — choose your own AI provider freely.\n - Improved **AI Memory**: you can now update or refine past memories whenever you need.\n - Reduced the “guiding tone” in **AI Summary** so summaries feel more natural and personal.\n - Introduced **AI Timeline Sort (Beta)**: your timeline can now rearrange itself based on your reading preferences.\n\n![](https://cdn.follow.is/ai-memory.mp4)\n\n![](https://cdn.follow.is/share.mp4)\n\n- **UI**\n - Several UI components have been refined with an improved design system for a cleaner, more consistent feel.\n\n- **Subscription**\n - Added a new **Basic Plan (non-AI version)** for users who prefer a lighter subscription option.\n\n- **Selection**\n - Added **underline sharing** and **Ask AI** directly from selected text to make reading actions smoother.\n\n## Improvements\n\n- **Feed**\n - RSSHub subscriptions now include a clear identifier, making source management easier.\n\n- **Web**\n - You can now browse recommended content without logging in — explore before committing.\n\n- **Onboarding**\n - The onboarding flow has been fully redesigned for a smoother, more intuitive first-time experience.\n\n- **Entry**\n - Entries now come with AI-generated labels to help you sort and revisit content effortlessly.\n\n## No longer broken\n\nWe fixed several bugs to make everything feel more stable and reliable.\n" }, { "path": "apps/desktop/changelog/1.2.6.md", "content": "# What's new in v1.2.6\n\n## Shiny new things\n\n- Optimize Stripe subscription management UI with dynamic billing portal and status indicators\n\n## Improvements\n\n- Update AI SDK to v6.0.5\n- Refresh translation cache on mode changes\n\n## No longer broken\n\n- Fix AI chat message types alignment\n- Fix default custom integration fetch\n\n## Thanks\n\nSpecial thanks to volunteer contributors @TonyRL for their valuable contributions\n" }, { "path": "apps/desktop/changelog/1.3.0.md", "content": "# What's new in v1.3.0\n\n## Shiny new things\n\n- Markdown link supports open share feed link directly in the app\n\n## No longer broken\n\n- Fix preserve session when switching API domain\n- Fix handle invalid URL parsing in useFeedSafeUrl hook\n- Fix shortcuts page freeze\n- Fix icon service URL and image proxy URL\n\n## Thanks\n\nSpecial thanks to volunteer contributors @cuikaipeng @yjl9903 for their valuable contributions\n" }, { "path": "apps/desktop/changelog/1.3.1.md", "content": "# What's new in v1.3.1\n\n## Shiny new things\n\n- Supported French localization.\n\n## Improvements\n\n- Migrated error tracking to PostHog for better diagnostics.\n- Improved Japanese localization coverage.\n\n## No longer broken\n\n- Hardened external protocol handling to prevent potential security issues.\n- Fixed sorting crash when importing subscriptions with missing titles.\n\n## Thanks\n\nSpecial thanks to volunteer contributors @Kowyo and @q1uf3ng for their valuable contributions\n" }, { "path": "apps/desktop/changelog/1.4.0.md", "content": "# What's new in v1.4.0\n\n## Shiny new things\n\n- Added in-app review prompts\n\n## Improvements\n\n- Expanded desktop end-to-end coverage for auth and user flows\n\n## No longer broken\n\n- Removed the unwanted text selection toolbar\n- Fixed AI onboarding asset loading by switching the spline asset domain\n- Hardened setting sync authentication lifecycle\n\n## Thanks\n\nSpecial thanks to volunteer contributors for their valuable contributions\n" }, { "path": "apps/desktop/changelog/next.md", "content": "# What's new in vNEXT_VERSION\n\n## Shiny new things\n\n## Improvements\n\n## No longer broken\n\n## Thanks\n\nSpecial thanks to volunteer contributors @ for their valuable contributions\n" }, { "path": "apps/desktop/changelog/next.template.md", "content": "# What's new in vNEXT_VERSION\n\n## Shiny new things\n\n## Improvements\n\n## No longer broken\n\n## Thanks\n\nSpecial thanks to volunteer contributors @ for their valuable contributions\n" }, { "path": "apps/desktop/configs/vite.electron-render.config.ts", "content": "import { fileURLToPath } from \"node:url\"\n\nimport { dirname, resolve } from \"pathe\"\nimport type { UserConfig } from \"vite\"\nimport { routeBuilderPlugin } from \"vite-plugin-route-builder\"\n\nimport { cleanupUnnecessaryFilesPlugin } from \"../plugins/vite/cleanup\"\nimport { createPlatformSpecificImportPlugin } from \"../plugins/vite/specific-import\"\nimport { viteRenderBaseConfig } from \"./vite.render.config\"\n\nconst root = resolve(fileURLToPath(dirname(import.meta.url)), \"..\")\n\nconst VITE_ROOT = resolve(root, \"layer/renderer\")\n\nconst mode = process.argv.find((arg) => arg.startsWith(\"--mode\"))?.split(\"=\")[1]\nconst isStaging = mode === \"staging\"\n\nexport default {\n ...viteRenderBaseConfig,\n\n plugins: [\n ...viteRenderBaseConfig.plugins,\n createPlatformSpecificImportPlugin(\"electron\"),\n routeBuilderPlugin({\n pagePattern: \"src/pages/**/*.tsx\",\n outputPath: \"src/generated-routes.ts\",\n enableInDev: true,\n }),\n cleanupUnnecessaryFilesPlugin([\n \"og-image.png\",\n \"icon-512x512.png\",\n \"opengraph-image.png\",\n \"favicon.ico\",\n \"icon-192x192.png\",\n \"favicon-dev.ico\",\n \"apple-touch-icon-180x180.png\",\n \"maskable-icon-512x512.png\",\n \"pwa-64x64.png\",\n \"pwa-192x192.png\",\n \"pwa-512x512.png\",\n ]),\n ],\n\n root: VITE_ROOT,\n build: {\n outDir: resolve(root, \"dist/renderer\"),\n sourcemap: isStaging || !!process.env.CI,\n target: \"esnext\",\n rollupOptions: {\n input: {\n main: resolve(VITE_ROOT, \"index.html\"),\n },\n },\n minify: !isStaging,\n },\n define: {\n ...viteRenderBaseConfig.define,\n ELECTRON: \"true\",\n },\n} satisfies UserConfig\n" }, { "path": "apps/desktop/configs/vite.render.config.ts", "content": "import { readFileSync } from \"node:fs\"\nimport { fileURLToPath } from \"node:url\"\n\nimport react from \"@vitejs/plugin-react\"\nimport { codeInspectorPlugin } from \"code-inspector-plugin\"\nimport { dirname, resolve } from \"pathe\"\nimport { prerelease } from \"semver\"\nimport type { UserConfig } from \"vite\"\n\nimport { getGitHash } from \"../../../scripts/lib\"\nimport { astPlugin } from \"../plugins/vite/ast\"\nimport { circularImportRefreshPlugin } from \"../plugins/vite/hmr\"\nimport { customI18nHmrPlugin } from \"../plugins/vite/i18n-hmr\"\nimport { localesJsonPlugin } from \"../plugins/vite/locales-json\"\nimport i18nCompleteness from \"../plugins/vite/utils/i18n-completeness\"\n\nconst pkgDir = resolve(dirname(fileURLToPath(import.meta.url)), \"..\")\nconst pkg = JSON.parse(readFileSync(resolve(pkgDir, \"./package.json\"), \"utf8\"))\n\nconst getChangelogFileContent = () => {\n const { version: pkgVersion } = pkg\n const isDev = process.env.NODE_ENV === \"development\"\n // get major-minor-patch, e.g. 0.2.0-beta.2 -> 0.2.0\n const version = pkgVersion.split(\"-\")[0]\n try {\n return readFileSync(resolve(pkgDir, \"./changelog\", `${isDev ? \"next\" : version}.md`), \"utf8\")\n } catch {\n return \"\"\n }\n}\n\nconst changelogFile = getChangelogFileContent()\nexport const viteRenderBaseConfig = {\n worker: {\n format: \"es\",\n },\n optimizeDeps: {\n exclude: [\"sqlocal\", \"wa-sqlite\", \"@follow-app/client-sdk\"],\n },\n resolve: {\n alias: {\n \"~\": resolve(\"layer/renderer/src\"),\n \"@pkg\": resolve(\"package.json\"),\n \"@locales\": resolve(\"../../locales\"),\n \"@follow/electron-main\": resolve(\"layer/main/src\"),\n },\n },\n base: \"/\",\n\n plugins: [\n {\n name: \"import-sql\",\n transform(code, id) {\n if (id.endsWith(\".sql\")) {\n const json = JSON.stringify(code)\n .replaceAll(\"\\u2028\", \"\\\\u2028\")\n .replaceAll(\"\\u2029\", \"\\\\u2029\")\n\n return {\n code: `export default ${json}`,\n }\n }\n },\n },\n localesJsonPlugin(),\n codeInspectorPlugin({\n bundler: \"vite\",\n hotKeys: [\"altKey\"],\n }),\n react({\n // jsxImportSource: \"@welldone-software/why-did-you-render\", // <-----\n }),\n circularImportRefreshPlugin(),\n\n astPlugin,\n customI18nHmrPlugin(),\n ],\n define: {\n APP_VERSION: JSON.stringify(pkg.version),\n APP_NAME: JSON.stringify(pkg.productName),\n APP_DEV_CWD: JSON.stringify(process.cwd()),\n\n GIT_COMMIT_SHA: JSON.stringify(process.env.VERCEL_GIT_COMMIT_SHA || getGitHash()),\n\n RELEASE_CHANNEL: JSON.stringify((prerelease(pkg.version)?.[0] as string) || \"stable\"),\n\n DEBUG: process.env.DEBUG === \"true\",\n\n I18N_COMPLETENESS_MAP: JSON.stringify({ ...i18nCompleteness, en: 100 }),\n CHANGELOG_CONTENT: JSON.stringify(changelogFile),\n \"process.env.NODE_ENV\": JSON.stringify(process.env.NODE_ENV),\n },\n} satisfies UserConfig\n" }, { "path": "apps/desktop/dev-only/dev-app-update.yml", "content": "provider: custom\nchannel: latest\n" }, { "path": "apps/desktop/e2e/playwright.config.ts", "content": "import { defineConfig, devices } from \"@playwright/test\"\n\nimport { resolveDesktopE2EEnv } from \"./support/env\"\n\nconst env = resolveDesktopE2EEnv()\n\nexport default defineConfig({\n testDir: \"./tests\",\n fullyParallel: false,\n workers: 1,\n timeout: 120_000,\n expect: {\n timeout: 15_000,\n },\n reporter: [[\"list\"], [\"html\", { open: \"never\", outputFolder: \"playwright-report\" }]],\n outputDir: \"test-results\",\n use: {\n baseURL: env.webBaseURL,\n trace: \"retain-on-failure\",\n screenshot: \"only-on-failure\",\n video: \"retain-on-failure\",\n serviceWorkers: \"block\",\n },\n webServer: {\n command: \"pnpm run dev:web\",\n cwd: env.desktopAppDir,\n env: {\n ...process.env,\n VITE_API_URL: process.env.FOLO_E2E_WEB_DEV_API_URL ?? env.apiURL,\n VITE_WEB_URL: process.env.FOLO_E2E_WEB_DEV_WEB_URL ?? env.webURL,\n },\n url: env.webDevServerURL,\n timeout: 120_000,\n reuseExistingServer: !process.env.CI,\n },\n projects: [\n {\n name: \"web\",\n testMatch: /tests\\/web\\/.*\\.spec\\.ts/,\n use: {\n ...devices[\"Desktop Chrome\"],\n channel: \"chromium\",\n ignoreHTTPSErrors: true,\n launchOptions: {\n args: [\"--disable-web-security\"],\n },\n },\n },\n {\n name: \"electron\",\n testMatch: /tests\\/electron\\/.*\\.spec\\.ts/,\n },\n ],\n})\n" }, { "path": "apps/desktop/e2e/scripts/capture-ui-audit.ts", "content": "import { mkdir } from \"node:fs/promises\"\n\nimport { chromium } from \"@playwright/test\"\nimport { join } from \"pathe\"\n\nimport { createTestAccount, tryDeleteCurrentUser } from \"../support/account\"\nimport {\n closeSettings,\n dismissFeedForm,\n followOnboardingFeed,\n openSettings,\n openWebApp,\n} from \"../support/app\"\nimport { bootstrapAuthenticatedWebSession } from \"../support/auth-bootstrap\"\nimport { buildWebAppURL, resolveDesktopE2EEnv } from \"../support/env\"\n\nconst SETTING_TABS = [\n \"general\",\n \"appearance\",\n \"notifications\",\n \"shortcuts\",\n \"ai\",\n \"integration\",\n \"feeds\",\n \"list\",\n \"profile\",\n \"data-control\",\n \"cli\",\n \"plan\",\n \"about\",\n] as const\n\nconst SUBVIEW_ROUTES = [\"discover\", \"power\", \"action\", \"rsshub\", \"ai\"] as const\n\nconst waitForUiSettled = async (page: import(\"@playwright/test\").Page, delay = 1200) => {\n await page.waitForLoadState(\"domcontentloaded\")\n await page.waitForTimeout(delay)\n}\n\nconst waitForRouteReady = async (\n page: import(\"@playwright/test\").Page,\n route: (typeof SUBVIEW_ROUTES)[number],\n) => {\n await waitForUiSettled(page, route === \"power\" ? 3500 : 1200)\n\n if (route === \"power\") {\n await page\n .waitForFunction(\n () =>\n document.body.textContent?.includes(\"Your Balance\") ||\n document.body.textContent?.includes(\"Transactions\") ||\n document.body.textContent?.includes(\"Create Wallet\"),\n undefined,\n { timeout: 15_000 },\n )\n .catch(() => {})\n }\n}\n\nasync function main() {\n const env = resolveDesktopE2EEnv()\n const outputDir = join(\n env.desktopAppDir,\n \"e2e\",\n \"artifacts\",\n \"ui-audit\",\n `run-${new Date().toISOString().replaceAll(\":\", \"-\")}`,\n )\n\n await mkdir(outputDir, { recursive: true })\n\n const browser = await chromium.launch({\n channel: \"chromium\",\n headless: true,\n args: [\"--disable-web-security\"],\n })\n\n const context = await browser.newContext({\n ignoreHTTPSErrors: true,\n viewport: {\n width: 1440,\n height: 980,\n },\n colorScheme: \"light\",\n })\n\n let page = await context.newPage()\n const account = createTestAccount(\"ui-audit\")\n\n let screenshotIndex = 1\n const capture = async (name: string) => {\n const path = join(outputDir, `${String(screenshotIndex).padStart(2, \"0\")}-${name}.png`)\n screenshotIndex += 1\n await page.screenshot({ path, fullPage: false })\n console.info(path)\n }\n\n const bootstrapAccount = async () => {\n for (let attempt = 1; attempt <= 3; attempt += 1) {\n try {\n await bootstrapAuthenticatedWebSession(page, env, account)\n return\n } catch (error) {\n await capture(`auth-bootstrap-attempt-${attempt}-failed`)\n if (attempt === 3) {\n throw error\n }\n\n await page.goto(buildWebAppURL(env, \"/\"), { waitUntil: \"domcontentloaded\" })\n await waitForUiSettled(page)\n }\n }\n }\n\n try {\n await openWebApp(page, env)\n await waitForUiSettled(page)\n await capture(\"00-login-modal\")\n await page.close()\n page = await context.newPage()\n\n await bootstrapAccount()\n await waitForUiSettled(page)\n await capture(\"01-home-articles\")\n\n await followOnboardingFeed(page, env)\n await waitForUiSettled(page)\n await capture(\"02-discover-follow\")\n await dismissFeedForm(page)\n\n const timelineTabs = await page.locator('[data-testid^=\"timeline-tab-\"]').all()\n for (const tab of timelineTabs) {\n const testId = await tab.getAttribute(\"data-testid\")\n if (!testId) continue\n await tab.click()\n await waitForUiSettled(page)\n await capture(`timeline-${testId.replace(\"timeline-tab-\", \"\")}`)\n }\n\n for (const route of SUBVIEW_ROUTES) {\n await page.goto(buildWebAppURL(env, route), { waitUntil: \"domcontentloaded\" })\n await waitForRouteReady(page, route)\n await capture(`subview-${route}`)\n }\n\n await page.goto(buildWebAppURL(env, \"/\"), { waitUntil: \"domcontentloaded\" })\n await waitForUiSettled(page)\n\n await openSettings(page)\n await waitForUiSettled(page)\n\n for (const tab of SETTING_TABS) {\n if (tab === \"general\") {\n await capture(\"settings-general\")\n continue\n }\n\n const tabTrigger = page.getByTestId(`settings-tab-${tab}`)\n if (!(await tabTrigger.isVisible().catch(() => false))) {\n continue\n }\n\n await tabTrigger.click()\n await waitForUiSettled(page)\n await capture(`settings-${tab}`)\n }\n\n await closeSettings(page)\n await waitForUiSettled(page)\n await capture(\"home-after-settings\")\n } finally {\n await tryDeleteCurrentUser(page, env).catch(() => null)\n await context.close().catch(() => {})\n await browser.close().catch(() => {})\n }\n}\n\nvoid main()\n" }, { "path": "apps/desktop/e2e/support/account.ts", "content": "import type { Page } from \"@playwright/test\"\n\nimport type { DesktopE2EEnv } from \"./env\"\n\nexport interface TestAccount {\n email: string\n password: string\n}\n\nexport const createTestAccount = (name: string): TestAccount => {\n const suffix = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n\n return {\n email: `folo-e2e-${name}-${suffix}@example.com`,\n password: process.env.FOLO_E2E_PASSWORD ?? \"Password123!\",\n }\n}\n\nexport const tryDeleteCurrentUser = async (page: Page, env: DesktopE2EEnv) => {\n return page.evaluate(async ({ apiURL }) => {\n try {\n const response = await fetch(`${apiURL}/better-auth/delete-user-custom`, {\n method: \"POST\",\n credentials: \"include\",\n headers: {\n \"content-type\": \"application/json\",\n },\n body: JSON.stringify({}),\n })\n\n return {\n ok: response.ok,\n status: response.status,\n text: await response.text(),\n }\n } catch (error) {\n return {\n ok: false,\n status: -1,\n text: error instanceof Error ? error.message : String(error),\n }\n }\n }, env)\n}\n" }, { "path": "apps/desktop/e2e/support/app.ts", "content": "import type { Locator, Page } from \"@playwright/test\"\nimport { expect } from \"@playwright/test\"\n\nimport type { TestAccount } from \"./account\"\nimport type { DesktopE2EEnv } from \"./env\"\nimport { buildWebAppURL } from \"./env\"\n\nconst ONBOARDING_FEED_URL = \"folo://onboarding\"\n\nconst isVisible = async (locator: Locator) => locator.isVisible().catch(() => false)\nconst visibleByTestId = (page: Page, testId: string) =>\n page.locator(`[data-testid=\"${testId}\"]:visible`).last()\n\nexport const injectRecaptchaToken = async (page: Page, env?: DesktopE2EEnv) => {\n await page.addInitScript(\n (nextEnv) => {\n window.__FOLO_E2E_RECAPTCHA_TOKEN__ = \"e2e-token\"\n\n const originalFetch = globalThis.fetch.bind(globalThis)\n const authEndpoints = [\n \"/better-auth/sign-in/email\",\n \"/better-auth/sign-up/email\",\n \"/better-auth/forget-password\",\n ]\n\n globalThis.fetch = async (input, init) => {\n const request = input instanceof Request ? input : new Request(input, init)\n const requestURL = new URL(request.url, globalThis.location.origin)\n const shouldInjectToken = authEndpoints.some((path) => requestURL.pathname.includes(path))\n\n if (!shouldInjectToken) {\n return originalFetch(input, init)\n }\n\n const headers = new Headers(request.headers)\n if (!headers.has(\"x-token\")) {\n headers.set(\"x-token\", \"r3:e2e-token\")\n }\n\n return originalFetch(new Request(request, { headers }))\n }\n\n if (!nextEnv) {\n return\n }\n\n const fixedEnv = {\n VITE_API_URL: nextEnv.apiURL,\n VITE_EXTERNAL_API_URL: nextEnv.apiURL,\n VITE_WEB_URL: nextEnv.webURL,\n }\n\n const target =\n (globalThis as typeof globalThis & { __followEnv?: Record<string, string> }).__followEnv ??\n {}\n\n const proxy = new Proxy(target, {\n get(currentTarget, property, receiver) {\n if (typeof property === \"string\" && property in fixedEnv) {\n return fixedEnv[property as keyof typeof fixedEnv]\n }\n\n return Reflect.get(currentTarget, property, receiver)\n },\n set(currentTarget, property, value, receiver) {\n if (typeof property === \"string\" && property in fixedEnv) {\n return true\n }\n\n return Reflect.set(currentTarget, property, value, receiver)\n },\n ownKeys(currentTarget) {\n return Array.from(new Set([...Reflect.ownKeys(currentTarget), ...Object.keys(fixedEnv)]))\n },\n getOwnPropertyDescriptor(currentTarget, property) {\n if (typeof property === \"string\" && property in fixedEnv) {\n return {\n configurable: true,\n enumerable: true,\n writable: false,\n value: fixedEnv[property as keyof typeof fixedEnv],\n }\n }\n\n return Reflect.getOwnPropertyDescriptor(currentTarget, property)\n },\n })\n\n Object.defineProperty(globalThis, \"__followEnv\", {\n configurable: true,\n enumerable: false,\n get() {\n return proxy\n },\n set() {},\n })\n },\n env ? { apiURL: env.apiURL, webURL: env.webURL } : undefined,\n )\n}\n\nexport const openWebApp = async (page: Page, env: DesktopE2EEnv, route = \"/\") => {\n await injectRecaptchaToken(page, env)\n await page.goto(buildWebAppURL(env, route), { waitUntil: \"domcontentloaded\" })\n}\n\nexport const waitForAuthenticated = async (page: Page) => {\n const isAuthenticatedUiReady = async () => {\n const profileVisible = await page\n .getByTestId(\"profile-menu-trigger\")\n .isVisible()\n .catch(() => false)\n const loginModalVisible = await page\n .getByTestId(\"login-modal\")\n .isVisible()\n .catch(() => false)\n\n return profileVisible && !loginModalVisible\n }\n\n await expect.poll(isAuthenticatedUiReady, { timeout: 30_000 }).toBe(true)\n}\n\nexport const waitForLoggedOut = async (page: Page) => {\n await expect\n .poll(\n async () => {\n const loginButtonVisible = await page\n .getByTestId(\"login-button\")\n .last()\n .isVisible()\n .catch(() => false)\n const loginModalVisible = await page\n .getByTestId(\"login-modal\")\n .last()\n .isVisible()\n .catch(() => false)\n const loginInputVisible = await page\n .getByTestId(\"login-email-input\")\n .last()\n .isVisible()\n .catch(() => false)\n const registerInputVisible = await page\n .getByTestId(\"register-email-input\")\n .last()\n .isVisible()\n .catch(() => false)\n\n return loginButtonVisible || loginModalVisible || loginInputVisible || registerInputVisible\n },\n { timeout: 30_000 },\n )\n .toBe(true)\n}\n\nexport const ensureLoginModal = async (page: Page) => {\n await expect\n .poll(\n async () => {\n const loginModalVisible = await page\n .getByTestId(\"login-modal\")\n .last()\n .isVisible()\n .catch(() => false)\n const loginButtonVisible = await page\n .getByTestId(\"login-button\")\n .last()\n .isVisible()\n .catch(() => false)\n const loginInputVisible = await page\n .getByTestId(\"login-email-input\")\n .last()\n .isVisible()\n .catch(() => false)\n const registerInputVisible = await page\n .getByTestId(\"register-email-input\")\n .last()\n .isVisible()\n .catch(() => false)\n\n return loginModalVisible || loginButtonVisible || loginInputVisible || registerInputVisible\n },\n { timeout: 30_000 },\n )\n .toBe(true)\n}\n\nconst ensureCredentialForm = async (page: Page, mode: \"register\" | \"login\") => {\n await ensureLoginModal(page)\n\n const targetInput = visibleByTestId(\n page,\n mode === \"register\" ? \"register-email-input\" : \"login-email-input\",\n )\n const loginButton = visibleByTestId(page, \"login-button\")\n const loginModal = visibleByTestId(page, \"login-modal\")\n const activeDialog = page.locator('[role=\"dialog\"]:visible').last()\n const credentialProvider = visibleByTestId(page, \"login-provider-credential\")\n const targetForm = visibleByTestId(page, mode === \"register\" ? \"register-form\" : \"login-form\")\n const oppositeForm = visibleByTestId(page, mode === \"register\" ? \"login-form\" : \"register-form\")\n const oppositeFormSwitcher = visibleByTestId(\n page,\n mode === \"register\" ? \"login-switch-register\" : \"register-switch-login\",\n )\n\n if (await isVisible(targetInput)) {\n return\n }\n\n if (\n (await isVisible(loginButton)) &&\n !(await isVisible(loginModal)) &&\n !(await isVisible(activeDialog))\n ) {\n await expect(loginButton).toBeVisible({ timeout: 30_000 })\n await loginButton.click({ noWaitAfter: true })\n }\n\n if (await isVisible(targetInput)) {\n return\n }\n\n if (!(await isVisible(targetForm)) && !(await isVisible(oppositeForm))) {\n await expect(credentialProvider).toBeVisible({ timeout: 30_000 })\n await credentialProvider.click({ timeout: 30_000, noWaitAfter: true })\n await expect\n .poll(async () => (await isVisible(targetForm)) || (await isVisible(oppositeForm)), {\n timeout: 30_000,\n })\n .toBe(true)\n }\n\n if (await isVisible(oppositeForm)) {\n await expect(oppositeFormSwitcher).toBeVisible({ timeout: 30_000 })\n await oppositeFormSwitcher.click({ timeout: 30_000, noWaitAfter: true })\n }\n\n await expect(targetInput).toBeVisible({ timeout: 30_000 })\n}\n\nexport const registerWithCredential = async (page: Page, account: TestAccount) => {\n await ensureCredentialForm(page, \"register\")\n await visibleByTestId(page, \"register-email-input\").fill(account.email)\n await visibleByTestId(page, \"register-password-input\").fill(account.password)\n const confirmPasswordInput = visibleByTestId(page, \"register-confirm-password-input\")\n await confirmPasswordInput.fill(account.password)\n const submit = visibleByTestId(page, \"register-submit\")\n await expect(submit).toBeEnabled({ timeout: 30_000 })\n\n await submit.click()\n await waitForAuthenticated(page)\n}\n\nexport const loginWithCredential = async (page: Page, account: TestAccount) => {\n await ensureCredentialForm(page, \"login\")\n await visibleByTestId(page, \"login-email-input\").fill(account.email)\n const passwordInput = visibleByTestId(page, \"login-password-input\")\n await passwordInput.fill(account.password)\n const submit = visibleByTestId(page, \"login-submit\")\n await expect(submit).toBeEnabled({ timeout: 30_000 })\n\n await submit.click()\n await waitForAuthenticated(page)\n}\n\nexport const logoutFromProfileMenu = async (page: Page) => {\n await page.keyboard.press(\"Escape\").catch(() => {})\n if (page.url().startsWith(\"app://\")) {\n await returnToMainShell(page)\n }\n await page.getByTestId(\"profile-menu-trigger\").click()\n\n const signOutResponse = page\n .waitForResponse(\n (response) =>\n response.request().method() === \"POST\" && response.url().includes(\"/better-auth/sign-out\"),\n { timeout: 30_000 },\n )\n .catch(() => null)\n\n await page.getByTestId(\"profile-menu-logout\").click()\n await signOutResponse\n await waitForLoggedOut(page)\n}\n\nconst waitForMainShell = async (page: Page) => {\n await expect\n .poll(\n async () => {\n const profileVisible = await page\n .getByTestId(\"profile-menu-trigger\")\n .isVisible()\n .catch(() => false)\n const timelineVisible = await page\n .getByTestId(\"timeline-tab-articles\")\n .isVisible()\n .catch(() => false)\n\n return profileVisible || timelineVisible\n },\n { timeout: 30_000 },\n )\n .toBe(true)\n}\n\nconst returnToMainShell = async (page: Page) => {\n const discoverInput = page.getByTestId(\"discover-form-input\")\n if (await discoverInput.isVisible().catch(() => false)) {\n const backButton = page.getByTestId(\"subview-back\")\n\n if (await backButton.isVisible().catch(() => false)) {\n await backButton.click()\n } else {\n await page.keyboard.press(\"Escape\").catch(() => {})\n }\n\n if (await discoverInput.isVisible().catch(() => false)) {\n await page.keyboard.press(\"Escape\").catch(() => {})\n }\n\n await expect\n .poll(async () => discoverInput.isVisible().catch(() => false), { timeout: 15_000 })\n .toBe(false)\n }\n\n await waitForMainShell(page)\n\n const activeDialog = page.locator('[role=\"dialog\"]:visible').last()\n if (await activeDialog.isVisible().catch(() => false)) {\n await page.keyboard.press(\"Escape\").catch(() => {})\n\n if (await activeDialog.isVisible().catch(() => false)) {\n const modalClose = activeDialog.getByTestId(\"modal-close\").first()\n if (await modalClose.isVisible().catch(() => false)) {\n await modalClose.click().catch(() => {})\n }\n }\n\n await expect\n .poll(async () => activeDialog.isVisible().catch(() => false), { timeout: 10_000 })\n .toBe(false)\n }\n}\n\nconst waitForSettingsTabContent = async (page: Page, tab: \"general\" | \"feeds\") => {\n if (tab === \"general\") {\n await expect(page.getByTestId(\"settings-language-select\")).toBeVisible({ timeout: 15_000 })\n return\n }\n\n await expect\n .poll(async () => page.locator('[data-testid^=\"settings-feed-row-\"]').count(), {\n timeout: 15_000,\n })\n .toBeGreaterThan(0)\n}\n\nexport const openSettings = async (page: Page, tab: \"general\" | \"feeds\" = \"general\") => {\n await waitForAuthenticated(page)\n\n const settingsModal = page.locator(\"#setting-modal\").first()\n\n const openSettingsFromMenu = async () => {\n await returnToMainShell(page)\n const profileTrigger = page.getByTestId(\"profile-menu-trigger\")\n await expect(profileTrigger).toBeVisible({ timeout: 15_000 })\n await profileTrigger.click()\n\n const preferencesItem = page.getByTestId(\"profile-menu-preferences\")\n await expect(preferencesItem).toBeVisible({ timeout: 15_000 })\n await preferencesItem.click()\n\n await expect(settingsModal).toBeVisible({ timeout: 15_000 })\n }\n\n if (!(await settingsModal.isVisible().catch(() => false))) {\n try {\n await openSettingsFromMenu()\n } catch {\n await openSettingsFromMenu()\n }\n }\n\n await openSettingsTab(page, tab)\n}\n\nexport const openSettingsTab = async (page: Page, tab: \"general\" | \"feeds\") => {\n const settingsTab = page.getByTestId(`settings-tab-${tab}`)\n await expect(settingsTab).toBeVisible({ timeout: 15_000 })\n\n if (tab === \"feeds\") {\n await expect\n .poll(\n async () => {\n const className = (await settingsTab.getAttribute(\"class\")) ?? \"\"\n return !className.includes(\"opacity-50\")\n },\n { timeout: 15_000 },\n )\n .toBe(true)\n }\n\n await settingsTab.click()\n await waitForSettingsTabContent(page, tab)\n}\n\nexport const closeSettings = async (page: Page) => {\n const settingsModal = page.locator(\"#setting-modal\").first()\n if (!(await settingsModal.isVisible().catch(() => false))) {\n return\n }\n\n await page.keyboard.press(\"Escape\").catch(() => {})\n\n if (await settingsModal.isVisible().catch(() => false)) {\n const modalClose = settingsModal.getByTestId(\"modal-close\").first()\n if (await isVisible(modalClose)) {\n await modalClose.click().catch(() => {})\n }\n }\n\n await expect\n .poll(async () => settingsModal.isVisible().catch(() => false), { timeout: 10_000 })\n .toBe(false)\n}\n\nexport const setLanguage = async (page: Page, label: string) => {\n await page.getByTestId(\"settings-language-select\").click()\n await page.getByRole(\"option\", { name: label }).click()\n}\n\nexport const getLanguageLabel = async (page: Page) => {\n return page.getByTestId(\"settings-language-select\").textContent()\n}\n\nexport const openOnboardingFeedForm = async (\n page: Page,\n _env?: DesktopE2EEnv,\n _options?: { electron?: boolean },\n) => {\n const discoverInput = page.getByTestId(\"discover-form-input\")\n if (!(await discoverInput.isVisible().catch(() => false))) {\n await returnToMainShell(page)\n const discoverTrigger = page.getByTestId(\"subscription-discover-trigger\")\n await expect(discoverTrigger).toBeVisible({ timeout: 15_000 })\n await discoverTrigger.click()\n }\n\n await expect(discoverInput).toBeVisible({ timeout: 15_000 })\n await discoverInput.fill(ONBOARDING_FEED_URL)\n await discoverInput.press(\"Enter\")\n await expect(page.getByText(\"Welcome to Folo\").first()).toBeVisible({ timeout: 15_000 })\n}\n\nexport const followOnboardingFeed = async (\n page: Page,\n env: DesktopE2EEnv,\n options?: { electron?: boolean },\n) => {\n await openOnboardingFeedForm(page, env, options)\n const onboardingDiscoverCard = page\n .locator(\"[data-feed-id]\")\n .filter({ hasText: \"Welcome to Folo\" })\n .first()\n const followButton = onboardingDiscoverCard.getByRole(\"button\", { name: /^Follow$/i })\n if (await followButton.isVisible().catch(() => false)) {\n await expect(followButton).toBeEnabled({ timeout: 15_000 })\n await followButton.click()\n }\n await expect(page.getByText(\"Welcome to Folo\").first()).toBeVisible({ timeout: 15_000 })\n}\n\nexport const dismissFeedForm = async (page: Page) => {\n const cancelButton = visibleByTestId(page, \"feed-form-cancel\")\n const dialog = page.locator('[role=\"dialog\"]').last()\n\n if (!(await cancelButton.isVisible().catch(() => false))) {\n if (await dialog.isVisible().catch(() => false)) {\n await page.keyboard.press(\"Escape\").catch(() => {})\n }\n return\n }\n\n await cancelButton.click()\n\n if (\n (await cancelButton.isVisible().catch(() => false)) ||\n (await dialog.isVisible().catch(() => false))\n ) {\n await page.keyboard.press(\"Escape\").catch(() => {})\n }\n}\n\nconst findSettingsFeedRow = async (page: Page, onboardingFeedId: string | null) => {\n const targetedFeedRow = onboardingFeedId\n ? page.getByTestId(`settings-feed-row-${onboardingFeedId}`)\n : null\n const fallbackFeedRow = page\n .locator('[data-testid^=\"settings-feed-row-\"]')\n .filter({\n hasText: \"Welcome to Folo\",\n })\n .first()\n const settingsViewport = page.locator(\"#setting-modal [data-radix-scroll-area-viewport]\").first()\n\n await settingsViewport\n .evaluate((element) => {\n if (element instanceof HTMLElement) {\n element.scrollTop = 0\n }\n })\n .catch(() => {})\n\n for (let attempt = 0; attempt < 24; attempt++) {\n if (targetedFeedRow && (await targetedFeedRow.isVisible().catch(() => false))) {\n return targetedFeedRow\n }\n\n if (await fallbackFeedRow.isVisible().catch(() => false)) {\n return fallbackFeedRow\n }\n\n await settingsViewport.hover().catch(() => {})\n await page.mouse.wheel(0, 1200)\n await page.waitForTimeout(150)\n }\n\n return targetedFeedRow && (await targetedFeedRow.count()) > 0 ? targetedFeedRow : fallbackFeedRow\n}\n\nexport const unsubscribeFirstFeedFromSettings = async (page: Page, _env?: DesktopE2EEnv) => {\n const onboardingFeedItem = page\n .locator(\"[data-feed-id]\")\n .filter({\n hasText: \"Welcome to Folo\",\n })\n .first()\n const onboardingFeedId =\n (await onboardingFeedItem.count()) > 0\n ? await onboardingFeedItem.getAttribute(\"data-feed-id\")\n : null\n\n await openSettings(page)\n await openSettingsTab(page, \"feeds\")\n const feedRow = await findSettingsFeedRow(page, onboardingFeedId)\n\n await expect(feedRow).toBeVisible({ timeout: 15_000 })\n await feedRow.scrollIntoViewIfNeeded().catch(() => {})\n const feedRowTestId = await feedRow.getAttribute(\"data-testid\")\n await feedRow.click()\n\n const unsubscribeButton = page.getByTestId(\"feeds-batch-unsubscribe\")\n await expect(unsubscribeButton).toBeVisible({ timeout: 15_000 })\n await unsubscribeButton.click()\n await page.getByTestId(\"confirm-destroy\").click()\n\n if (feedRowTestId) {\n await expect(page.getByTestId(feedRowTestId)).toHaveCount(0, { timeout: 15_000 })\n } else {\n await expect(feedRow).toHaveCount(0, { timeout: 15_000 })\n }\n}\n\nexport const expectOnboardingFeedUnsubscribed = async (\n page: Page,\n _env?: DesktopE2EEnv,\n _options?: { electron?: boolean },\n) => {\n await openOnboardingFeedForm(page)\n await expect(page.getByTestId(\"feed-form-cancel\")).toHaveCount(0)\n}\n\nexport const expectTimelineSwitchAndEntryReadFlow = async (page: Page) => {\n await returnToMainShell(page)\n\n const videosTab = page.getByTestId(\"timeline-tab-videos\")\n await videosTab.click()\n await expect(videosTab).toHaveAttribute(\"aria-pressed\", \"true\", { timeout: 15_000 })\n await expect.poll(async () => page.locator(\"[data-entry-id]\").count()).toBeGreaterThan(0)\n\n const articlesTab = page.getByTestId(\"timeline-tab-articles\")\n await articlesTab.click()\n await expect(articlesTab).toHaveAttribute(\"aria-pressed\", \"true\", { timeout: 15_000 })\n await expect.poll(async () => page.locator(\"[data-entry-id]\").count()).toBeGreaterThan(0)\n\n const unreadOnboardingEntry = page\n .locator('[data-entry-id][data-read=\"false\"]:visible')\n .filter({ has: page.locator(\"a[href]\") })\n .first()\n await expect(unreadOnboardingEntry).toBeVisible({ timeout: 15_000 })\n\n const onboardingEntryId = await unreadOnboardingEntry.getAttribute(\"data-entry-id\")\n expect(onboardingEntryId).toBeTruthy()\n\n const onboardingEntry = page.locator(`[data-entry-id=\"${onboardingEntryId}\"]`)\n const onboardingEntryLink = unreadOnboardingEntry.locator(\"a[href]\").first()\n\n await unreadOnboardingEntry.scrollIntoViewIfNeeded().catch(() => {})\n await expect(onboardingEntryLink).toBeVisible({ timeout: 15_000 })\n await onboardingEntryLink.click()\n\n const entryRender = page.getByTestId(\"entry-render\")\n await expect(entryRender).toBeVisible({ timeout: 15_000 })\n await expect(onboardingEntry).toHaveAttribute(\"data-active\", \"true\", { timeout: 15_000 })\n await expect(onboardingEntry).toHaveAttribute(\"data-read\", \"true\", { timeout: 15_000 })\n\n const toggleReadButton = page.getByTestId(\"command-action-entry-read\").last()\n await expect(toggleReadButton).toBeVisible({ timeout: 15_000 })\n await expect(toggleReadButton).toBeEnabled({ timeout: 15_000 })\n\n await toggleReadButton.click()\n await expect(onboardingEntry).toHaveAttribute(\"data-read\", \"false\", { timeout: 15_000 })\n\n await toggleReadButton.click()\n await expect(onboardingEntry).toHaveAttribute(\"data-read\", \"true\", { timeout: 15_000 })\n}\n" }, { "path": "apps/desktop/e2e/support/auth-bootstrap.ts", "content": "import type { BrowserContext, Page } from \"@playwright/test\"\nimport { nanoid } from \"nanoid\"\n\nimport type { TestAccount } from \"./account\"\nimport { injectRecaptchaToken, waitForAuthenticated } from \"./app\"\nimport type { DesktopE2EEnv } from \"./env\"\nimport { buildWebAppURL } from \"./env\"\n\ntype AuthBootstrapResponse = {\n token?: string | null\n error?: {\n message?: string\n } | null\n}\n\ntype ParsedCookie = {\n expires?: number\n httpOnly: boolean\n name: string\n path: string\n sameSite: \"Lax\" | \"None\" | \"Strict\"\n secure: boolean\n value: string\n}\n\nconst splitSetCookieHeader = (header: string) => {\n const parts: string[] = []\n let buffer = \"\"\n\n for (const char of header) {\n if (char === \",\") {\n const recent = buffer.toLowerCase()\n const hasExpires = recent.includes(\"expires=\")\n const hasGmt = /gmt/i.test(recent)\n\n if (hasExpires && !hasGmt) {\n buffer += char\n continue\n }\n\n if (buffer.trim()) {\n parts.push(buffer.trim())\n }\n buffer = \"\"\n continue\n }\n\n buffer += char\n }\n\n if (buffer.trim()) {\n parts.push(buffer.trim())\n }\n\n return parts\n}\n\nconst parseSetCookieHeader = (header: string): ParsedCookie[] => {\n return splitSetCookieHeader(header)\n .map((cookie) => {\n const [nameValue, ...attributes] = cookie.split(\";\").map((part) => part.trim())\n const [name, ...valueParts] = nameValue?.split(\"=\") ?? []\n if (!name) {\n return null\n }\n\n const parsedCookie: ParsedCookie = {\n name,\n value: valueParts.join(\"=\"),\n path: \"/\",\n httpOnly: false,\n secure: false,\n sameSite: \"Lax\",\n }\n\n for (const attribute of attributes) {\n const [rawKey, ...rawValueParts] = attribute.split(\"=\")\n const key = rawKey?.toLowerCase()\n const value = rawValueParts.join(\"=\")\n\n switch (key) {\n case \"expires\": {\n const expires = new Date(value)\n if (!Number.isNaN(expires.getTime())) {\n parsedCookie.expires = expires.getTime() / 1000\n }\n break\n }\n case \"httponly\": {\n parsedCookie.httpOnly = true\n break\n }\n case \"path\": {\n parsedCookie.path = value || \"/\"\n break\n }\n case \"samesite\": {\n if (value === \"None\" || value === \"Strict\" || value === \"Lax\") {\n parsedCookie.sameSite = value\n }\n break\n }\n case \"secure\": {\n parsedCookie.secure = true\n break\n }\n }\n }\n\n return parsedCookie\n })\n .filter(Boolean)\n}\n\nconst requestAuth = async ({\n apiURL,\n path,\n body,\n}: {\n apiURL: string\n body: Record<string, unknown>\n path: string\n}) => {\n const response = await fetch(new URL(path, apiURL), {\n method: \"POST\",\n headers: {\n \"Cache-Control\": \"no-store\",\n \"content-type\": \"application/json\",\n \"x-app-name\": \"Folo Web\",\n \"x-app-platform\": \"desktop/web\",\n \"x-app-version\": \"1.4.0\",\n \"x-client-id\": nanoid(),\n \"x-session-id\": nanoid(),\n \"x-token\": \"ac:fallback\",\n },\n body: JSON.stringify(body),\n })\n\n return {\n response,\n body: (await response.json().catch(() => null)) as AuthBootstrapResponse | null,\n setCookie: response.headers.get(\"set-cookie\"),\n }\n}\n\nconst signIn = (env: DesktopE2EEnv, account: TestAccount) =>\n requestAuth({\n apiURL: env.apiURL,\n path: \"/better-auth/sign-in/email\",\n body: {\n email: account.email,\n password: account.password,\n rememberMe: true,\n },\n })\n\nconst signUp = (env: DesktopE2EEnv, account: TestAccount) =>\n requestAuth({\n apiURL: env.apiURL,\n path: \"/better-auth/sign-up/email\",\n body: {\n email: account.email,\n password: account.password,\n name: account.email.split(\"@\")[0] ?? account.email,\n callbackURL: `${env.webURL}/login`,\n },\n })\n\nconst applyCookiesToContext = async (\n context: BrowserContext,\n env: DesktopE2EEnv,\n setCookieHeader: string,\n) => {\n const cookies = parseSetCookieHeader(setCookieHeader)\n await context.addCookies(\n cookies.map((cookie) => ({\n url: env.apiURL,\n name: cookie.name,\n value: cookie.value,\n httpOnly: cookie.httpOnly,\n secure: cookie.secure,\n sameSite: cookie.sameSite,\n expires: cookie.expires,\n })),\n )\n}\n\nexport const bootstrapAuthenticatedWebSession = async (\n page: Page,\n env: DesktopE2EEnv,\n account: TestAccount,\n) => {\n let signInResult = await signIn(env, account)\n\n if (!signInResult.response.ok || signInResult.body?.error || !signInResult.setCookie) {\n const signUpResult = await signUp(env, account)\n const signUpError = signUpResult.body?.error?.message?.toLowerCase() ?? \"\"\n const isExistingAccount =\n signUpError.includes(\"exist\") ||\n signUpError.includes(\"already\") ||\n signUpError.includes(\"taken\")\n\n if ((!signUpResult.response.ok || signUpResult.body?.error) && !isExistingAccount) {\n throw new Error(\n signUpResult.body?.error?.message ||\n signInResult.body?.error?.message ||\n `auth bootstrap failed with ${signUpResult.response.status}`,\n )\n }\n\n signInResult = await signIn(env, account)\n }\n\n if (!signInResult.response.ok || signInResult.body?.error || !signInResult.setCookie) {\n throw new Error(\n signInResult.body?.error?.message || `sign in failed with ${signInResult.response.status}`,\n )\n }\n\n await applyCookiesToContext(page.context(), env, signInResult.setCookie)\n await injectRecaptchaToken(page, env)\n await page.goto(buildWebAppURL(env, \"/\"), { waitUntil: \"domcontentloaded\" })\n await waitForAuthenticated(page)\n}\n" }, { "path": "apps/desktop/e2e/support/electron.ts", "content": "import { execSync } from \"node:child_process\"\nimport { mkdtemp, rm } from \"node:fs/promises\"\nimport { tmpdir } from \"node:os\"\n\nimport type { ElectronApplication, Page } from \"@playwright/test\"\nimport { _electron as electron } from \"@playwright/test\"\nimport { join } from \"pathe\"\n\nimport type { DesktopE2EEnv } from \"./env\"\n\nlet buildSignature: string | null = null\n\nconst ensureElectronBuilt = (env: DesktopE2EEnv) => {\n const nextSignature = `${env.apiURL}|${env.webURL}`\n if (buildSignature === nextSignature) {\n return\n }\n\n execSync(\"pnpm run build:electron-vite\", {\n cwd: env.desktopAppDir,\n env: {\n ...process.env,\n VITE_API_URL: env.apiURL,\n VITE_WEB_URL: env.webURL,\n },\n stdio: \"inherit\",\n })\n\n buildSignature = nextSignature\n}\n\nexport const launchElectronApp = async (env: DesktopE2EEnv) => {\n ensureElectronBuilt(env)\n\n const userDataDir = await mkdtemp(join(tmpdir(), \"folo-e2e-\"))\n const electronApp = await electron.launch({\n args: [env.desktopAppDir],\n cwd: env.desktopAppDir,\n env: {\n ...process.env,\n CI: process.env.CI ?? \"1\",\n NODE_ENV: \"test\",\n VITE_API_URL: env.apiURL,\n VITE_WEB_URL: env.webURL,\n FOLO_E2E_USER_DATA_DIR: userDataDir,\n },\n timeout: 120_000,\n })\n\n const page = await electronApp.firstWindow()\n await page.waitForLoadState(\"domcontentloaded\")\n await page.evaluate(() => {\n window.__FOLO_E2E_RECAPTCHA_TOKEN__ = \"e2e-token\"\n\n const originalFetch = globalThis.fetch.bind(globalThis)\n const authEndpoints = [\n \"/better-auth/sign-in/email\",\n \"/better-auth/sign-up/email\",\n \"/better-auth/forget-password\",\n ]\n\n globalThis.fetch = async (input, init) => {\n const request = input instanceof Request ? input : new Request(input, init)\n const requestURL = new URL(request.url, globalThis.location.origin)\n const shouldInjectToken = authEndpoints.some((path) => requestURL.pathname.includes(path))\n\n if (!shouldInjectToken) {\n return originalFetch(input, init)\n }\n\n const headers = new Headers(request.headers)\n if (!headers.has(\"x-token\")) {\n headers.set(\"x-token\", \"r3:e2e-token\")\n }\n\n return originalFetch(new Request(request, { headers }))\n }\n })\n\n return {\n electronApp,\n page,\n userDataDir,\n }\n}\n\nexport const closeElectronApp = async (app: {\n electronApp: ElectronApplication\n page: Page\n userDataDir: string\n}) => {\n await app.electronApp.close().catch(() => {})\n await rm(app.userDataDir, { force: true, recursive: true })\n}\n" }, { "path": "apps/desktop/e2e/support/env.ts", "content": "import { fileURLToPath } from \"node:url\"\n\nimport { join } from \"pathe\"\n\nexport type DesktopE2EProfile = \"local\" | \"prod\"\n\nconst DESKTOP_E2E_PROFILES = {\n local: {\n apiURL: \"http://localhost:3000\",\n webURL: \"http://localhost:2233\",\n webBaseURL: \"http://localhost:2233\",\n webUsesHashRouter: false,\n },\n prod: {\n apiURL: \"https://api.folo.is\",\n webURL: \"https://app.folo.is\",\n webBaseURL: null,\n webUsesHashRouter: true,\n },\n} as const\n\nexport interface DesktopE2EEnv {\n profile: DesktopE2EProfile\n apiURL: string\n webURL: string\n webBaseURL: string\n webUsesHashRouter: boolean\n webDevServerURL: string\n debugProxyPath: string\n desktopAppDir: string\n}\n\nconst supportDir = fileURLToPath(new URL(\".\", import.meta.url))\nconst desktopAppDir = join(supportDir, \"..\", \"..\")\n\nconst normalizeRoute = (route: string) => {\n if (!route || route === \"/\") {\n return \"/\"\n }\n\n return route.startsWith(\"/\") ? route : `/${route}`\n}\n\nexport const resolveDesktopE2EEnv = (): DesktopE2EEnv => {\n const profile = (process.env.FOLO_E2E_PROFILE ?? \"local\") as DesktopE2EProfile\n const resolvedProfile = profile in DESKTOP_E2E_PROFILES ? profile : \"local\"\n const profileConfig = DESKTOP_E2E_PROFILES[resolvedProfile]\n const webDevServerURL = process.env.FOLO_E2E_WEB_DEV_SERVER_URL ?? \"http://localhost:2233\"\n const debugProxyPath = process.env.FOLO_E2E_WEB_DEBUG_PROXY_PATH ?? \"/__debug_proxy.html\"\n\n const webBaseURL =\n resolvedProfile === \"prod\"\n ? new URL(\n `${debugProxyPath}?debug-host=${encodeURIComponent(webDevServerURL)}`,\n profileConfig.webURL,\n ).toString()\n : profileConfig.webBaseURL\n\n return {\n profile: resolvedProfile,\n apiURL: process.env.FOLO_E2E_API_URL ?? profileConfig.apiURL,\n webURL: process.env.FOLO_E2E_WEB_URL ?? profileConfig.webURL,\n webBaseURL,\n webUsesHashRouter: profileConfig.webUsesHashRouter,\n webDevServerURL,\n debugProxyPath,\n desktopAppDir,\n }\n}\n\nexport const buildWebAppURL = (env: DesktopE2EEnv, route = \"/\") => {\n const normalizedRoute = normalizeRoute(route)\n\n if (env.webUsesHashRouter) {\n const url = new URL(env.webBaseURL)\n url.hash = normalizedRoute\n return url.toString()\n }\n\n return new URL(normalizedRoute, `${env.webBaseURL}/`).toString()\n}\n\nexport const buildHashRoute = (route = \"/\") => normalizeRoute(route)\n" }, { "path": "apps/desktop/e2e/tests/electron/core.spec.ts", "content": "import { expect, test } from \"@playwright/test\"\n\nimport { createTestAccount, tryDeleteCurrentUser } from \"../../support/account\"\nimport {\n dismissFeedForm,\n expectTimelineSwitchAndEntryReadFlow,\n followOnboardingFeed,\n loginWithCredential,\n logoutFromProfileMenu,\n registerWithCredential,\n unsubscribeFirstFeedFromSettings,\n} from \"../../support/app\"\nimport { closeElectronApp, launchElectronApp } from \"../../support/electron\"\nimport { resolveDesktopE2EEnv } from \"../../support/env\"\n\ntest.describe(\"electron core flows\", () => {\n test(\"covers registration, login, follow, unfollow, timeline and read state\", async () => {\n test.setTimeout(240_000)\n\n const env = resolveDesktopE2EEnv()\n const account = createTestAccount(\"electron-core\")\n let electronApp = await launchElectronApp(env)\n\n try {\n await test.step(\"registers a new account\", async () => {\n await registerWithCredential(electronApp.page, account)\n })\n\n await test.step(\"logs out and logs back in\", async () => {\n await logoutFromProfileMenu(electronApp.page)\n await closeElectronApp(electronApp)\n electronApp = await launchElectronApp(env)\n await loginWithCredential(electronApp.page, account)\n })\n\n await test.step(\"follows onboarding feed\", async () => {\n await followOnboardingFeed(electronApp.page, env)\n await dismissFeedForm(electronApp.page)\n })\n\n await test.step(\"switches timeline, opens an entry, and toggles read state\", async () => {\n await expectTimelineSwitchAndEntryReadFlow(electronApp.page)\n })\n\n await test.step(\"unsubscribes onboarding feed from settings\", async () => {\n await unsubscribeFirstFeedFromSettings(electronApp.page)\n })\n\n const cleanup = await tryDeleteCurrentUser(electronApp.page, env)\n expect(cleanup.status).toBeGreaterThanOrEqual(-1)\n test.info().annotations.push({\n type: \"cleanup\",\n description: `delete-user-custom status=${cleanup.status}`,\n })\n } finally {\n await closeElectronApp(electronApp)\n }\n })\n})\n" }, { "path": "apps/desktop/e2e/tests/web/core.spec.ts", "content": "import { expect, test } from \"@playwright/test\"\n\nimport { createTestAccount, tryDeleteCurrentUser } from \"../../support/account\"\nimport {\n closeSettings,\n dismissFeedForm,\n expectOnboardingFeedUnsubscribed,\n expectTimelineSwitchAndEntryReadFlow,\n followOnboardingFeed,\n loginWithCredential,\n logoutFromProfileMenu,\n openWebApp,\n registerWithCredential,\n unsubscribeFirstFeedFromSettings,\n} from \"../../support/app\"\nimport { resolveDesktopE2EEnv } from \"../../support/env\"\n\ntest.describe(\"web core flows\", () => {\n test(\"covers registration, login, follow, unfollow, timeline and read state\", async ({\n page,\n browser,\n }) => {\n test.setTimeout(180_000)\n\n const env = resolveDesktopE2EEnv()\n const account = createTestAccount(\"web-core\")\n let activePage = page\n let loginContext: Awaited<ReturnType<typeof browser.newContext>> | null = null\n\n try {\n await openWebApp(activePage, env)\n\n await test.step(\"registers a new account\", async () => {\n await registerWithCredential(activePage, account)\n })\n\n await test.step(\"follows onboarding feed\", async () => {\n await followOnboardingFeed(activePage, env)\n await dismissFeedForm(activePage)\n })\n\n await test.step(\"logs out and logs back in\", async () => {\n await logoutFromProfileMenu(activePage)\n\n loginContext = await browser.newContext()\n activePage = await loginContext.newPage()\n await openWebApp(activePage, env)\n await loginWithCredential(activePage, account)\n })\n\n await test.step(\"switches timeline, opens an entry, and toggles read state\", async () => {\n await expectTimelineSwitchAndEntryReadFlow(activePage)\n })\n\n await test.step(\"unsubscribes onboarding feed from settings\", async () => {\n await unsubscribeFirstFeedFromSettings(activePage)\n await closeSettings(activePage)\n await expectOnboardingFeedUnsubscribed(activePage, env)\n })\n\n await test.step(\"re-subscribes onboarding feed\", async () => {\n await followOnboardingFeed(activePage, env)\n await dismissFeedForm(activePage)\n })\n\n await test.step(\"tries to clean up the temporary account\", async () => {\n const cleanup = await tryDeleteCurrentUser(activePage, env)\n expect(cleanup.status).toBeGreaterThanOrEqual(-1)\n test.info().annotations.push({\n type: \"cleanup\",\n description: `delete-user-custom status=${cleanup.status}`,\n })\n })\n } finally {\n await loginContext?.close().catch(() => {})\n }\n })\n})\n" }, { "path": "apps/desktop/e2e/tests/web/settings-sync.spec.ts", "content": "import type { BrowserContext } from \"@playwright/test\"\nimport { expect, test } from \"@playwright/test\"\n\nimport { createTestAccount, tryDeleteCurrentUser } from \"../../support/account\"\nimport {\n getLanguageLabel,\n loginWithCredential,\n openSettings,\n openWebApp,\n registerWithCredential,\n setLanguage,\n} from \"../../support/app\"\nimport { resolveDesktopE2EEnv } from \"../../support/env\"\n\nconst closeContextSafely = async (context: BrowserContext) => {\n try {\n await context.close()\n } catch (error) {\n if (error instanceof Error && error.message.includes(\"ENOENT\")) {\n return\n }\n\n throw error\n }\n}\n\ntest.describe(\"web multi-session sync\", () => {\n test(\"syncs settings between two browser sessions\", async ({ browser }) => {\n test.setTimeout(180_000)\n\n const env = resolveDesktopE2EEnv()\n const account = createTestAccount(\"web-sync\")\n\n const contextA = await browser.newContext()\n const contextB = await browser.newContext()\n const pageA = await contextA.newPage()\n const pageB = await contextB.newPage()\n\n try {\n await openWebApp(pageA, env)\n await registerWithCredential(pageA, account)\n\n await openWebApp(pageB, env)\n await loginWithCredential(pageB, account)\n\n await openSettings(pageA)\n await openSettings(pageB)\n\n await test.step(\"session A change syncs to session B\", async () => {\n await setLanguage(pageA, \"日本語\")\n await expect\n .poll(async () => getLanguageLabel(pageA), { timeout: 15_000 })\n .toContain(\"日本語\")\n await expect\n .poll(\n async () => {\n await pageB.reload({ waitUntil: \"domcontentloaded\" })\n await openSettings(pageB)\n return getLanguageLabel(pageB)\n },\n { timeout: 30_000 },\n )\n .toContain(\"日本語\")\n })\n\n await test.step(\"session B change syncs back to session A\", async () => {\n await setLanguage(pageB, \"English\")\n await expect\n .poll(async () => getLanguageLabel(pageB), { timeout: 15_000 })\n .toContain(\"English\")\n await expect\n .poll(\n async () => {\n await pageA.reload({ waitUntil: \"domcontentloaded\" })\n await openSettings(pageA)\n return getLanguageLabel(pageA)\n },\n { timeout: 60_000 },\n )\n .toContain(\"English\")\n })\n\n const cleanup = await tryDeleteCurrentUser(pageA, env)\n expect(cleanup.status).toBeGreaterThanOrEqual(-1)\n test.info().annotations.push({\n type: \"cleanup\",\n description: `delete-user-custom status=${cleanup.status}`,\n })\n } finally {\n await closeContextSafely(contextA)\n await closeContextSafely(contextB)\n }\n })\n})\n" }, { "path": "apps/desktop/electron.vite.config.ts", "content": "import { defineConfig } from \"electron-vite\"\nimport { resolve } from \"pathe\"\n\nimport { getGitHash } from \"../../scripts/lib\"\nimport rendererConfig from \"./configs/vite.electron-render.config\"\n\nexport default defineConfig({\n main: {\n build: {\n outDir: \"dist/main\",\n lib: {\n entry: \"./layer/main/src/index.ts\",\n },\n },\n resolve: {\n alias: {\n \"@shared\": resolve(\"packages/shared/src\"),\n \"@pkg\": resolve(\"./package.json\"),\n \"@locales\": resolve(\"../../locales\"),\n \"~\": resolve(\"./layer/main/src\"),\n \"utf-8-validate\": resolve(\"./layer/main/src/shims/utf-8-validate.cjs\"),\n },\n },\n define: {\n ELECTRON: \"true\",\n GIT_COMMIT_HASH: JSON.stringify(getGitHash()),\n },\n },\n preload: {\n build: {\n outDir: \"dist/preload\",\n lib: {\n entry: \"./layer/main/preload/index.ts\",\n },\n },\n resolve: {\n alias: {\n \"@pkg\": resolve(\"./package.json\"),\n \"@locales\": resolve(\"../../locales\"),\n },\n },\n },\n renderer: rendererConfig,\n})\n" }, { "path": "apps/desktop/forge.config.cts", "content": "import crypto from \"node:crypto\"\nimport fs, { readdirSync } from \"node:fs\"\nimport { cp, readdir } from \"node:fs/promises\"\n\nimport { FuseV1Options, FuseVersion } from \"@electron/fuses\"\nimport { MakerAppX } from \"@electron-forge/maker-appx\"\nimport { MakerDMG } from \"@electron-forge/maker-dmg\"\nimport { MakerPKG } from \"@electron-forge/maker-pkg\"\nimport { MakerSquirrel } from \"@electron-forge/maker-squirrel\"\nimport { MakerZIP } from \"@electron-forge/maker-zip\"\nimport { FusesPlugin } from \"@electron-forge/plugin-fuses\"\nimport type { ForgeConfig } from \"@electron-forge/shared-types\"\nimport MakerAppImage from \"@pengx17/electron-forge-maker-appimage\"\nimport setLanguages from \"electron-packager-languages\"\nimport yaml from \"js-yaml\"\nimport path, { resolve } from \"pathe\"\nimport { rimraf, rimrafSync } from \"rimraf\"\n\nconst ResolvedMakerAppImage: typeof MakerAppImage = (MakerAppImage as any).default || MakerAppImage\nconst platform = process.argv.find((arg) => arg.startsWith(\"--platform\"))?.split(\"=\")[1]\nconst mode = process.argv.find((arg) => arg.startsWith(\"--mode\"))?.split(\"=\")[1]\nconst isMicrosoftStore =\n process.argv.find((arg) => arg.startsWith(\"--ms\"))?.split(\"=\")[1] === \"true\"\n\nconst isStaging = mode === \"staging\"\n\nconst artifactRegex = /.*\\.(?:exe|dmg|AppImage|zip)$/\nconst platformNamesMap = {\n darwin: \"macos\",\n linux: \"linux\",\n win32: \"windows\",\n}\nconst ymlMapsMap = {\n darwin: \"latest-mac.yml\",\n linux: \"latest-linux.yml\",\n win32: \"latest.yml\",\n}\n\nconst keepModules = new Set([\"font-list\", \"vscode-languagedetection\"])\nconst keepLanguages = new Set([\"en\", \"en_GB\", \"en-US\", \"en_US\"])\n\n// remove folders & files not to be included in the app\nasync function cleanSources(buildPath, _electronVersion, platform, _arch, callback) {\n // folders & files to be included in the app\n const appItems = new Set([\"dist\", \"node_modules\", \"package.json\", \"resources\"])\n\n if (platform === \"darwin\" || platform === \"mas\") {\n const frameworkResourcePath = resolve(\n buildPath,\n \"../../Frameworks/Electron Framework.framework/Versions/A/Resources\",\n )\n\n for (const file of readdirSync(frameworkResourcePath)) {\n if (file.endsWith(\".lproj\") && !keepLanguages.has(file.split(\".\")[0]!)) {\n rimrafSync(resolve(frameworkResourcePath, file))\n }\n }\n }\n\n // Keep only node_modules to be included in the app\n\n await Promise.all([\n ...(await readdir(buildPath).then((items) =>\n items.filter((item) => !appItems.has(item)).map((item) => rimraf(path.join(buildPath, item))),\n )),\n ...(await readdir(path.join(buildPath, \"node_modules\")).then((items) =>\n items\n .filter((item) => !keepModules.has(item))\n .map((item) => rimraf(path.join(buildPath, \"node_modules\", item))),\n )),\n ])\n\n // copy needed node_modules to be included in the app\n await Promise.all(\n Array.from(keepModules.values()).map((item) => {\n // Check is exist\n if (fs.existsSync(path.join(buildPath, \"node_modules\", item))) {\n // eslint-disable-next-line array-callback-return\n return\n }\n return cp(\n path.join(process.cwd(), \"../../node_modules\", item),\n path.join(buildPath, \"node_modules\", item),\n {\n recursive: true,\n },\n )\n }),\n )\n\n callback()\n}\n\nconst noopAfterCopy = (_buildPath, _electronVersion, _platform, _arch, callback) => callback()\n\nconst ignorePattern = new RegExp(`^/node_modules/(?!${[...keepModules].join(\"|\")})`)\n\nconst config: ForgeConfig = {\n packagerConfig: {\n name: isStaging ? \"Folo Staging\" : \"Folo\",\n appCategoryType: \"public.app-category.news\",\n buildVersion: process.env.BUILD_VERSION || undefined,\n appBundleId: \"is.follow\",\n icon: isStaging ? \"resources/icon-staging\" : \"resources/icon\",\n extraResource: [\"./resources/app-update.yml\"],\n protocols: [\n {\n name: \"Folo\",\n schemes: [\"follow\"],\n },\n {\n name: \"Folo\",\n schemes: [\"folo\"],\n },\n ],\n\n afterCopy: [\n cleanSources,\n process.platform !== \"win32\" ? noopAfterCopy : setLanguages([...keepLanguages.values()]),\n ],\n asar: true,\n ignore: [ignorePattern],\n\n prune: false,\n extendInfo: {\n ITSAppUsesNonExemptEncryption: false,\n },\n osxSign: {\n optionsForFile:\n platform === \"mas\"\n ? (filePath) => {\n const entitlements = filePath.includes(\".app/\")\n ? \"build/entitlements.mas.child.plist\"\n : \"build/entitlements.mas.plist\"\n return {\n hardenedRuntime: false,\n entitlements,\n }\n }\n : () => ({\n entitlements: \"build/entitlements.mac.plist\",\n }),\n keychain: process.env.OSX_SIGN_KEYCHAIN_PATH,\n identity: process.env.OSX_SIGN_IDENTITY,\n provisioningProfile: process.env.OSX_SIGN_PROVISIONING_PROFILE_PATH,\n },\n ...(process.env.APPLE_ID &&\n process.env.APPLE_PASSWORD &&\n process.env.APPLE_TEAM_ID && {\n osxNotarize: {\n appleId: process.env.APPLE_ID!,\n appleIdPassword: process.env.APPLE_PASSWORD!,\n teamId: process.env.APPLE_TEAM_ID!,\n },\n }),\n },\n rebuildConfig: {},\n makers: [\n new MakerZIP({}, [\"darwin\"]),\n new MakerDMG(\n {\n overwrite: true,\n background: \"static/dmg-background.png\",\n icon: \"static/dmg-icon.icns\",\n iconSize: 160,\n additionalDMGOptions: {\n window: {\n size: {\n width: 660,\n height: 400,\n },\n },\n },\n contents: (opts) => [\n {\n x: 180,\n y: 170,\n type: \"file\",\n path: (opts as any).appPath,\n },\n {\n x: 480,\n y: 170,\n type: \"link\",\n path: \"/Applications\",\n },\n ],\n },\n [\"darwin\", \"mas\"],\n ),\n new ResolvedMakerAppImage({\n config: {\n icons: [\n {\n file: isStaging ? \"resources/icon-staging.png\" : \"resources/icon.png\",\n size: 256,\n },\n ],\n },\n }),\n new MakerPKG(\n {\n name: \"Folo\",\n keychain: process.env.KEYCHAIN_PATH,\n },\n [\"mas\"],\n ),\n // Only include AppX maker for Microsoft Store builds\n ...(isMicrosoftStore\n ? [\n new MakerAppX({\n publisher: \"CN=7CBBEB6A-9B0E-4387-BAE3-576D0ACA279E\",\n packageDisplayName: \"Folo - Follow everything in one place\",\n devCert: \"build/dev.pfx\",\n assets: \"static/appx\",\n manifest: \"build/appxmanifest.xml\",\n // @ts-ignore\n publisherDisplayName: \"Natural Selection Labs\",\n identityName: \"NaturalSelectionLabs.Follow-Yourfavoritesinoneinbo\",\n packageBackgroundColor: \"#FF5C00\",\n protocol: \"folo\",\n }),\n ]\n : [\n new MakerSquirrel({\n name: \"Folo\",\n setupIcon: isStaging ? \"resources/icon-staging.ico\" : \"resources/icon.ico\",\n iconUrl: \"https://app.folo.is/favicon.ico\",\n }),\n ]),\n ],\n plugins: [\n // Fuses are used to enable/disable various Electron functionality\n // at package time, before code signing the application\n new FusesPlugin({\n version: FuseVersion.V1,\n [FuseV1Options.RunAsNode]: false,\n [FuseV1Options.EnableNodeOptionsEnvironmentVariable]: false,\n [FuseV1Options.EnableNodeCliInspectArguments]: false,\n [FuseV1Options.EnableEmbeddedAsarIntegrityValidation]: true,\n [FuseV1Options.OnlyLoadAppFromAsar]: true,\n }),\n ],\n publishers: [\n {\n name: \"@electron-forge/publisher-github\",\n config: {\n repository: {\n owner: \"RSSNext\",\n name: \"follow\",\n },\n draft: true,\n },\n },\n ],\n hooks: {\n postMake: async (_config, makeResults) => {\n const yml: {\n version?: string\n files: {\n url: string\n sha512: string\n size: number\n }[]\n releaseDate?: string\n } = {\n version: makeResults[0]?.packageJSON?.version,\n files: [],\n }\n let basePath = \"\"\n makeResults = makeResults.map((result) => {\n result.artifacts = result.artifacts\n .map((artifact) => {\n if (artifactRegex.test(artifact)) {\n if (!basePath) {\n basePath = path.dirname(artifact)\n }\n const newArtifact = `${path.dirname(artifact)}/${\n result.packageJSON.productName\n }-${result.packageJSON.version}-${\n platformNamesMap[result.platform]\n }-${result.arch}${path.extname(artifact)}`\n fs.renameSync(artifact, newArtifact)\n\n try {\n const fileData = fs.readFileSync(newArtifact)\n const hash = crypto.createHash(\"sha512\").update(fileData).digest(\"base64\")\n const { size } = fs.statSync(newArtifact)\n\n yml.files.push({\n url: path.basename(newArtifact),\n sha512: hash,\n size,\n })\n } catch {\n console.error(`Failed to hash ${newArtifact}`)\n }\n return newArtifact\n } else if (!artifact.endsWith(\".tmp\")) {\n return artifact\n } else {\n return null\n }\n })\n .filter((artifact) => artifact !== null)\n return result\n })\n yml.releaseDate = new Date().toISOString()\n\n if (makeResults[0]?.platform && ymlMapsMap[makeResults[0].platform] && basePath) {\n const ymlPath = path.join(basePath, ymlMapsMap[makeResults[0].platform])\n\n const ymlStr = yaml.dump(yml, {\n lineWidth: -1,\n })\n fs.writeFileSync(ymlPath, ymlStr)\n\n makeResults.push({\n artifacts: [ymlPath],\n platform: makeResults[0]!.platform,\n arch: makeResults[0]!.arch,\n packageJSON: makeResults[0]!.packageJSON,\n })\n }\n\n return makeResults\n },\n },\n}\n\nexport default config\n" }, { "path": "apps/desktop/layer/main/export.ts", "content": "// Export types for renderer to use\nexport type { IpcServices } from \"./src/ipc\"\n" }, { "path": "apps/desktop/layer/main/global.d.ts", "content": "import \"../../types/vite\"\n\ndeclare global {\n const GIT_COMMIT_HASH: string\n}\nexport {}\n" }, { "path": "apps/desktop/layer/main/package.json", "content": "{\n \"name\": \"@follow/electron-main\",\n \"type\": \"module\",\n \"private\": true,\n \"author\": \"Folo Team\",\n \"license\": \"GPL-3.0-only\",\n \"homepage\": \"https://github.com/RSSNext\",\n \"repository\": {\n \"url\": \"https://github.com/RSSNext/follow\",\n \"type\": \"git\"\n },\n \"exports\": {\n \".\": {\n \"types\": \"./dist/export.d.ts\",\n \"import\": \"./dist/export.js\"\n }\n },\n \"types\": \"./dist/export.d.ts\",\n \"scripts\": {\n \"build\": \"tsc\",\n \"test\": \"vitest\",\n \"typecheck\": \"tsc --noEmit\"\n },\n \"dependencies\": {\n \"@electron-toolkit/preload\": \"3.0.2\",\n \"@electron-toolkit/utils\": \"4.0.0\",\n \"@eneris/push-receiver\": \"4.3.0\",\n \"@follow-app/client-sdk\": \"catalog:\",\n \"@follow-app/readability\": \"workspace:*\",\n \"@follow/shared\": \"workspace:*\",\n \"@follow/utils\": \"workspace:*\",\n \"builder-util-runtime\": \"9.5.1\",\n \"electron-context-menu\": \"4.1.1\",\n \"electron-ipc-decorator\": \"0.2.0\",\n \"electron-log\": \"5.4.3\",\n \"electron-squirrel-startup\": \"1.0.1\",\n \"electron-store\": \"11.0.2\",\n \"electron-updater\": \"6.7.3\",\n \"es-toolkit\": \"1.44.0\",\n \"font-list\": \"2.0.2\",\n \"i18next\": \"25.8.6\",\n \"js-yaml\": \"4.1.1\",\n \"ky\": \"1.14.3\",\n \"linkedom\": \"0.18.12\",\n \"lowdb\": \"7.0.1\",\n \"msedge-tts\": \"2.0.4\",\n \"node-machine-id\": \"1.1.12\",\n \"ofetch\": \"1.5.1\",\n \"pathe\": \"2.0.3\",\n \"semver\": \"7.7.4\",\n \"tar\": \"7.5.7\",\n \"vscode-languagedetection\": \"npm:@vscode/vscode-languagedetection@1.0.22\"\n },\n \"devDependencies\": {\n \"@follow/models\": \"workspace:*\",\n \"@follow/types\": \"workspace:*\",\n \"@types/js-yaml\": \"4.0.9\",\n \"@types/node\": \"25.2.3\",\n \"electron\": \"38.3.0\",\n \"electron-devtools-installer\": \"4.0.0\",\n \"typescript\": \"catalog:\"\n }\n}\n" }, { "path": "apps/desktop/layer/main/preload/index.d.ts", "content": "import type { ElectronAPI } from \"@electron-toolkit/preload\"\n\ndeclare global {\n interface Window {\n electron?: ElectronAPI\n api?: { canWindowBlur: boolean }\n platform: NodeJS.Platform\n }\n}\n" }, { "path": "apps/desktop/layer/main/preload/index.ts", "content": "import os from \"node:os\"\nimport { platform } from \"node:process\"\n\nimport { electronAPI } from \"@electron-toolkit/preload\"\nimport { clipboard, contextBridge } from \"electron\"\n\nexport const isMacOS = platform === \"darwin\"\n\nexport const isWindows = platform === \"win32\"\n\nexport const isLinux = platform === \"linux\"\n\n/**\n * @see https://learn.microsoft.com/en-us/windows/release-health/windows11-release-information\n * Windows 11 buildNumber starts from 22000.\n */\nconst detectingWindows11 = () => {\n if (!isWindows) return false\n\n const release = os.release()\n const majorVersion = Number.parseInt(release.split(\".\")[0]!)\n const buildNumber = Number.parseInt(release.split(\".\")[2]!)\n\n return majorVersion === 10 && buildNumber >= 22000\n}\n\nexport const isWindows11 = detectingWindows11()\n\n// Custom APIs for renderer\nconst api = {\n canWindowBlur: process.platform === \"darwin\" || (process.platform === \"win32\" && isWindows11),\n isWindowsStore: Boolean((process as typeof process & { windowsStore?: boolean }).windowsStore),\n}\n\n// Use `contextBridge` APIs to expose Electron APIs to\n// renderer only if context isolation is enabled, otherwise\n// just add to the DOM global.\nif (process.contextIsolated) {\n try {\n contextBridge.exposeInMainWorld(\"electron\", electronAPI)\n contextBridge.exposeInMainWorld(\"api\", api)\n contextBridge.exposeInMainWorld(\"platform\", process.platform)\n } catch (error) {\n console.error(error)\n }\n} else {\n // @ts-ignore (define in dts)\n window.electron = electronAPI\n // @ts-ignore (define in dts)\n window.api = api\n // @ts-ignore (define in dts)\n window.platform = process.platform\n\n Object.defineProperty(window.navigator, \"clipboard\", {\n get: () => {\n return clipboard\n },\n })\n}\n" }, { "path": "apps/desktop/layer/main/src/@types/constants.ts", "content": "const langs = [\"en\", \"zh-CN\", \"zh-TW\", \"ja\"] as const\nexport const currentSupportedLanguages = [...langs].sort() as string[]\nexport type MainSupportedLanguages = (typeof langs)[number]\n\nexport const ns = [\"native\"] as const\nexport const defaultNS = \"native\" as const\n" }, { "path": "apps/desktop/layer/main/src/@types/i18next.d.ts", "content": "import type { defaultNS, ns } from \"./constants\"\nimport type { resources } from \"./resources\"\n\ndeclare module \"i18next\" {\n interface CustomTypeOptions {\n ns: typeof ns\n resources: (typeof resources)[\"en\"]\n defaultNS: typeof defaultNS\n // if you see an error like: \"Argument of type 'DefaultTFuncReturn' is not assignable to parameter of type xyz\"\n // set returnNull to false (and also in the i18next init options)\n // returnNull: false;\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/@types/resources.ts", "content": "import en from \"@locales/native/en.json\"\nimport ja from \"@locales/native/ja.json\"\nimport zhCn from \"@locales/native/zh-CN.json\"\nimport zhTw from \"@locales/native/zh-TW.json\"\n\nimport type { MainSupportedLanguages, ns } from \"./constants\"\n\nexport const resources = {\n en: {\n native: en,\n },\n \"zh-CN\": {\n native: zhCn,\n },\n\n \"zh-TW\": {\n native: zhTw,\n },\n ja: {\n native: ja,\n },\n} satisfies Record<MainSupportedLanguages, Record<(typeof ns)[number], Record<string, string>>>\n" }, { "path": "apps/desktop/layer/main/src/before-bootstrap.ts", "content": "import { app, protocol } from \"electron\"\nimport path from \"pathe\"\n\nconst e2eUserDataDir = process.env.FOLO_E2E_USER_DATA_DIR\n\nif (e2eUserDataDir) {\n app.setPath(\"userData\", e2eUserDataDir)\n} else if (import.meta.env.DEV) {\n app.setPath(\"userData\", path.join(app.getPath(\"appData\"), \"Folo(dev)\"))\n}\n\nprotocol.registerSchemesAsPrivileged([\n {\n scheme: \"app\",\n privileges: {\n standard: true,\n bypassCSP: true,\n supportFetchAPI: true,\n secure: true,\n },\n },\n])\n" }, { "path": "apps/desktop/layer/main/src/bootstrap.ts", "content": "import { app } from \"electron\"\nimport squirrelStartup from \"electron-squirrel-startup\"\n\nimport { DEVICE_ID } from \"./constants/system\"\nimport { BootstrapManager } from \"./manager/bootstrap\"\n\nconsole.info(\"[main] device id:\", DEVICE_ID)\nif (squirrelStartup) {\n app.quit()\n}\n\nBootstrapManager.start()\n" }, { "path": "apps/desktop/layer/main/src/constants/app.ts", "content": "import { app } from \"electron\"\nimport path from \"pathe\"\n\nexport const UNREAD_BACKGROUND_POLLING_INTERVAL = 1000 * 60 * 5\n\nexport const HOTUPDATE_RENDER_ENTRY_DIR = path.resolve(app.getPath(\"userData\"), \"render\")\n\nexport const GITHUB_OWNER = process.env.GITHUB_OWNER || \"RSSNext\"\nexport const GITHUB_REPO = process.env.GITHUB_REPO || \"follow\"\n\n// https://github.com/electron/electron/issues/25081\nexport const START_IN_TRAY_ARGS = \"--start-in-tray\"\n\nexport const BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN = \"better-auth.session_token\"\n" }, { "path": "apps/desktop/layer/main/src/constants/system.ts", "content": "import { machineIdSync } from \"node-machine-id\"\n\nexport const DEVICE_ID = machineIdSync()\n" }, { "path": "apps/desktop/layer/main/src/env.ts", "content": "import os from \"node:os\"\n\nimport { DEV } from \"@follow/shared/constants\"\n\nexport const channel: \"development\" | \"beta\" | \"alpha\" | \"stable\" = DEV ? \"development\" : \"stable\"\n\nconst { platform } = process\nexport const isMacOS = platform === \"darwin\"\nexport const isMAS = process.mas\n\nexport const isWindows = platform === \"win32\"\n\nexport const isLinux = platform === \"linux\"\n\n/**\n * @see https://learn.microsoft.com/en-us/windows/release-health/windows11-release-information\n * Windows 11 buildNumber starts from 22000.\n */\nconst detectingWindows11 = () => {\n if (!isWindows) return false\n\n const release = os.release()\n const majorVersion = Number.parseInt(release.split(\".\")[0]!)\n const buildNumber = Number.parseInt(release.split(\".\")[2]!)\n\n return majorVersion === 10 && buildNumber >= 22000\n}\n\nexport const isWindows11 = detectingWindows11()\n" }, { "path": "apps/desktop/layer/main/src/helper.ts", "content": "import { fileURLToPath, pathToFileURL } from \"node:url\"\n\nimport { MODE, ModeEnum } from \"@follow/shared/constants\"\nimport path from \"pathe\"\n\nimport { isMacOS, isWindows } from \"./env\"\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url))\nconst iconMap = {\n [ModeEnum.production]: path.join(__dirname, \"../../resources/icon.png\"),\n [ModeEnum.development]: path.join(__dirname, \"../../resources/icon-dev.png\"),\n [ModeEnum.staging]: path.join(__dirname, \"../../resources/icon-staging.png\"),\n}\nexport const getIconPath = () => iconMap[MODE]\nexport const getTrayIconPath = () => {\n if (isMacOS) {\n return path.join(__dirname, \"../../resources/icon-tray.png\")\n }\n if (isWindows) {\n // https://www.electronjs.org/docs/latest/api/tray#:~:text=Windows,best%20visual%20effects.\n return MODE === ModeEnum.staging\n ? path.join(__dirname, \"../../resources/icon-tray-staging.ico\")\n : path.join(__dirname, \"../../resources/icon-tray.ico\")\n }\n return getIconPath()\n}\n\nexport const filePathToAppUrl = (filePath: string) => {\n return `app://folo.is${pathToFileURL(filePath).pathname}`\n}\n" }, { "path": "apps/desktop/layer/main/src/index.ts", "content": "import \"./before-bootstrap\"\nimport \"./bootstrap\"\n" }, { "path": "apps/desktop/layer/main/src/ipc/index.ts", "content": "import type { MergeIpcService } from \"electron-ipc-decorator\"\nimport { createServices } from \"electron-ipc-decorator\"\n\nimport { AppService } from \"./services/app\"\nimport { AuthService } from \"./services/auth\"\nimport { CliService } from \"./services/cli\"\nimport { DebugService } from \"./services/debug\"\nimport { DockService } from \"./services/dock\"\nimport { IntegrationService } from \"./services/integration\"\nimport { MenuService } from \"./services/menu\"\nimport { ReaderService } from \"./services/reader\"\nimport { SettingService } from \"./services/setting\"\n\n// Initialize all services\nconst services = createServices([\n AppService,\n AuthService,\n CliService,\n DebugService,\n DockService,\n MenuService,\n ReaderService,\n SettingService,\n IntegrationService,\n])\n// Extract method types automatically from services\nexport type IpcServices = MergeIpcService<typeof services>\n\n// Initialize all services (this will register all IPC handlers)\nexport function initializeIpcServices() {\n // Services are already initialized in the services constant above\n console.info(\"IPC services initialized\")\n void services\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/app.ts", "content": "import fsp from \"node:fs/promises\"\nimport { fileURLToPath } from \"node:url\"\n\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport { DEV } from \"@follow/shared/constants\"\nimport { app, BrowserWindow, clipboard, dialog, shell } from \"electron\"\nimport type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\nimport path from \"pathe\"\n\nimport { START_IN_TRAY_ARGS } from \"~/constants/app\"\nimport { getCacheSize } from \"~/lib/cleaner\"\nimport { i18n } from \"~/lib/i18n\"\nimport { store, StoreKey } from \"~/lib/store\"\nimport { registerAppTray } from \"~/lib/tray\"\nimport { logger, revealLogFile } from \"~/logger\"\nimport { AppManager } from \"~/manager/app\"\nimport { WindowManager } from \"~/manager/window\"\nimport { cleanupOldRender, loadDynamicRenderEntry } from \"~/updater/hot-updater\"\n\nimport { downloadFile } from \"../../lib/download\"\nimport { checkForAppUpdates, quitAndInstall } from \"../../updater\"\n\ninterface WindowActionInput {\n action: \"close\" | \"minimize\" | \"maximum\"\n}\n\ninterface SearchInput {\n text: string\n options: Electron.FindInPageOptions\n}\n\ninterface Sender extends Electron.WebContents {\n getOwnerBrowserWindow: () => Electron.BrowserWindow | null\n}\n\nexport class AppService extends IpcService {\n static override readonly groupName = \"app\"\n\n @IpcMethod()\n getAppVersion(): string {\n return app.getVersion()\n }\n\n @IpcMethod()\n async checkForUpdates(): Promise<{ hasUpdate: boolean; error?: string }> {\n return checkForAppUpdates()\n }\n\n @IpcMethod()\n switchAppLocale(context: IpcContext, input: string): void {\n i18n.changeLanguage(input)\n AppManager.registerMenuAndContextMenu()\n registerAppTray()\n\n app.commandLine.appendSwitch(\"lang\", input)\n }\n\n @IpcMethod()\n rendererUpdateReload(): void {\n const __dirname = fileURLToPath(new URL(\".\", import.meta.url))\n const allWindows = BrowserWindow.getAllWindows()\n const dynamicRenderEntry = loadDynamicRenderEntry()\n\n const appLoadEntry = dynamicRenderEntry || path.resolve(__dirname, \"../renderer/index.html\")\n logger.info(\"appLoadEntry\", appLoadEntry)\n const mainWindow = WindowManager.getMainWindow()\n\n for (const window of allWindows) {\n if (window === mainWindow) {\n if (DEV) {\n logger.verbose(\"[rendererUpdateReload]: skip reload in dev\")\n break\n }\n window.loadFile(appLoadEntry)\n } else window.destroy()\n }\n\n setTimeout(() => {\n cleanupOldRender()\n }, 1000)\n }\n\n @IpcMethod()\n async openExternal(_context: IpcContext, url: string): Promise<void> {\n if (!url) return\n\n await shell.openExternal(url)\n }\n\n @IpcMethod()\n windowAction(context: IpcContext, input: WindowActionInput): void {\n if (context.sender.getType() === \"window\") {\n const window: BrowserWindow | null = (context.sender as Sender).getOwnerBrowserWindow()\n\n if (!window) return\n switch (input.action) {\n case \"close\": {\n window.close()\n break\n }\n case \"minimize\": {\n window.minimize()\n break\n }\n case \"maximum\": {\n if (window.isMaximized()) {\n window.unmaximize()\n } else {\n window.maximize()\n }\n break\n }\n }\n }\n }\n\n @IpcMethod()\n quitAndInstall(_context: IpcContext): void {\n quitAndInstall()\n }\n\n @IpcMethod()\n readClipboard(_context: IpcContext): string {\n return clipboard.readText()\n }\n\n @IpcMethod()\n async search(context: IpcContext, input: SearchInput): Promise<Electron.Result | null> {\n const { sender: webContents } = context\n\n const { promise, resolve } = Promise.withResolvers<Electron.Result | null>()\n\n let requestId = -1\n webContents.once(\"found-in-page\", (_, result) => {\n resolve(result.requestId === requestId ? result : null)\n })\n requestId = webContents.findInPage(input.text, input.options)\n return promise\n }\n\n @IpcMethod()\n clearSearch(context: IpcContext): void {\n context.sender.stopFindInPage(\"keepSelection\")\n }\n\n @IpcMethod()\n async download(context: IpcContext, input: string): Promise<void> {\n const result = await dialog.showSaveDialog({\n defaultPath: input.split(\"/\").pop(),\n })\n if (result.canceled) return\n\n try {\n await downloadFile(input, result.filePath)\n\n const senderWindow = (context.sender as Sender).getOwnerBrowserWindow()\n if (senderWindow) {\n callWindowExpose(senderWindow).toast.success(\"Download success!\", {\n duration: 1000,\n })\n }\n } catch (err) {\n const senderWindow = (context.sender as Sender).getOwnerBrowserWindow()\n if (senderWindow) {\n callWindowExpose(senderWindow).toast.error(\"Download failed!\", {\n duration: 1000,\n })\n }\n throw err\n }\n }\n\n @IpcMethod()\n getAppPath(_context: IpcContext): string {\n return app.getAppPath()\n }\n\n @IpcMethod()\n resolveAppAsarPath(context: IpcContext, input: string): string {\n if (input.startsWith(\"file://\")) {\n input = fileURLToPath(input)\n }\n\n if (path.isAbsolute(input)) {\n return input\n }\n\n return path.join(app.getAppPath(), input)\n }\n\n @IpcMethod()\n readyToShowMainWindow(_context: IpcContext) {\n const shouldShowWindow =\n !app.getLoginItemSettings().wasOpenedAsHidden && !process.argv.includes(START_IN_TRAY_ARGS)\n if (shouldShowWindow) {\n const window = WindowManager.getMainWindow()\n if (window) window.show()\n }\n }\n\n @IpcMethod()\n openCacheFolder(_context: IpcContext): void {\n const dir = path.join(app.getPath(\"userData\"), \"cache\")\n shell.openPath(dir)\n }\n\n @IpcMethod()\n getCacheLimit(_context: IpcContext): number {\n return store.get(StoreKey.CacheSizeLimit) || 0\n }\n\n @IpcMethod()\n async clearCache(_context: IpcContext): Promise<void> {\n const cachePath = path.join(app.getPath(\"userData\"), \"cache\", \"Cache_Data\")\n if (process.platform === \"win32\") {\n // Request elevation on Windows\n\n try {\n // Create a bat file to delete cache with elevated privileges\n const batPath = path.join(app.getPath(\"temp\"), \"clear_cache.bat\")\n await fsp.writeFile(batPath, `@echo off\\nrd /s /q \"${cachePath}\"\\ndel \"%~f0\"`, \"utf-8\")\n\n // Execute the bat file with admin privileges\n await shell.openPath(batPath)\n return\n } catch (err) {\n logger.error(\"Failed to clear cache with elevation\", { error: err })\n }\n }\n await fsp.rm(cachePath, { recursive: true, force: true }).catch(() => {\n logger.error(\"Failed to clear cache\")\n })\n }\n\n @IpcMethod()\n limitCacheSize(_context: IpcContext, input: number): void {\n if (input === 0) {\n store.delete(StoreKey.CacheSizeLimit)\n } else {\n store.set(StoreKey.CacheSizeLimit, input)\n }\n }\n\n @IpcMethod()\n revealLogFile(_context: IpcContext) {\n return revealLogFile()\n }\n\n @IpcMethod()\n getCacheSize(_context: IpcContext) {\n return getCacheSize()\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/auth.ts", "content": "import { env } from \"@follow/shared/env.desktop\"\nimport { createDesktopAPIHeaders } from \"@follow/utils/headers\"\nimport PKG from \"@pkg\"\nimport type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\n\nimport { BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN } from \"~/constants/app\"\nimport { WindowManager } from \"~/manager/window\"\n\nimport { getSessionTokenFromCookies, syncSessionToCliConfig } from \"../../lib/cli-session-sync\"\nimport { deleteNotificationsToken, updateNotificationsToken } from \"../../lib/user\"\nimport { logger } from \"../../logger\"\n\nexport class AuthService extends IpcService {\n static override readonly groupName = \"auth\"\n\n private async applySessionToken(token: string): Promise<void> {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow || !token) {\n return\n }\n\n const apiURL = env.VITE_API_URL\n const url = new URL(apiURL)\n const isSecure =\n url.protocol === \"https:\" || url.hostname === \"localhost\" || url.hostname === \"127.0.0.1\"\n const isLocalhost = url.hostname === \"localhost\" || url.hostname === \"127.0.0.1\"\n const cookieNames = [\n BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN,\n ...(isSecure && !isLocalhost ? [\"__Secure-better-auth.session_token\"] : []),\n ]\n\n await Promise.all(\n cookieNames.map((name) =>\n mainWindow.webContents.session.cookies.set({\n url: apiURL,\n name,\n value: token,\n ...(isLocalhost ? {} : { domain: url.hostname }),\n path: \"/\",\n httpOnly: true,\n secure: isSecure,\n sameSite: \"no_restriction\",\n expirationDate: new Date().setDate(new Date().getDate() + 30),\n }),\n ),\n )\n }\n\n private async clearSessionToken(): Promise<void> {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) {\n return\n }\n\n const { session } = mainWindow.webContents\n const apiURL = env.VITE_API_URL\n await Promise.allSettled([\n session.cookies.remove(apiURL, BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN),\n session.cookies.remove(apiURL, \"__Secure-better-auth.session_token\"),\n session.cookies.remove(apiURL, \"better-auth.last_used_login_method\"),\n ])\n }\n\n private async requestCredentialAuth(\n path: \"/sign-in/email\" | \"/sign-up/email\",\n payload: Record<string, unknown>,\n headers?: Record<string, string>,\n ) {\n const response = await fetch(`${env.VITE_API_URL}/better-auth${path}`, {\n method: \"POST\",\n headers: {\n \"content-type\": \"application/json\",\n ...createDesktopAPIHeaders({ version: PKG.version }),\n ...headers,\n },\n body: JSON.stringify(payload),\n })\n\n const data = (await response\n .json()\n .catch(async () => ({ message: await response.text() }))) as Record<string, unknown>\n\n const setCookie = response.headers.get(\"set-cookie\") || \"\"\n const sessionCookieMatch = setCookie.match(/better-auth\\.session_token=([^;]+)/)\n const sessionToken = sessionCookieMatch?.[1] ?? null\n const token = typeof data.token === \"string\" ? data.token : null\n const persistedSessionToken = sessionToken ?? token\n if (response.ok && persistedSessionToken) {\n await this.applySessionToken(persistedSessionToken)\n }\n\n if (sessionToken) {\n data.sessionToken = sessionToken\n }\n\n return {\n data,\n error: response.ok\n ? null\n : {\n message: typeof data.message === \"string\" ? data.message : response.statusText,\n status: response.status,\n },\n }\n }\n\n @IpcMethod()\n async sessionChanged(_context: IpcContext): Promise<void> {\n await updateNotificationsToken()\n\n // Sync the current desktop session to the npm CLI login.\n const token = await getSessionTokenFromCookies()\n await syncSessionToCliConfig(token).catch((err) => {\n logger.error(\"Failed to sync session to CLI config:\", err)\n })\n }\n\n @IpcMethod()\n async signOut(_context: IpcContext): Promise<void> {\n await deleteNotificationsToken()\n\n // Clear the synced CLI login on sign out.\n await syncSessionToCliConfig().catch((err) => {\n logger.error(\"Failed to clear CLI config token:\", err)\n })\n }\n\n @IpcMethod()\n async signOutRemote(_context: IpcContext, token?: string): Promise<void> {\n await fetch(`${env.VITE_API_URL}/better-auth/sign-out`, {\n method: \"POST\",\n headers: {\n ...createDesktopAPIHeaders({ version: PKG.version }),\n ...(token\n ? {\n Cookie: `__Secure-better-auth.session_token=${token}; better-auth.session_token=${token}`,\n }\n : {}),\n },\n }).catch(() => {})\n\n await this.clearSessionToken()\n }\n\n @IpcMethod()\n async signInWithCredential(\n _context: IpcContext,\n payload: { email: string; password: string; headers?: Record<string, string> },\n ) {\n return this.requestCredentialAuth(\n \"/sign-in/email\",\n {\n email: payload.email,\n password: payload.password,\n },\n payload.headers,\n )\n }\n\n @IpcMethod()\n async signUpWithCredential(\n _context: IpcContext,\n payload: {\n email: string\n password: string\n name: string\n callbackURL: string\n headers?: Record<string, string>\n },\n ) {\n return this.requestCredentialAuth(\n \"/sign-up/email\",\n {\n email: payload.email,\n password: payload.password,\n name: payload.name,\n callbackURL: payload.callbackURL,\n },\n payload.headers,\n )\n }\n\n @IpcMethod()\n async setSessionToken(_context: IpcContext, token: string): Promise<void> {\n await this.applySessionToken(token)\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/cli.ts", "content": "import type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\n\nimport {\n CLI_NPM_PACKAGE_NAME,\n getCliConfigPath,\n getCliInstallCommand,\n getCliLoginCommand,\n getSessionTokenFromCookies,\n isCliRunnerAvailable,\n readCliConfig,\n syncSessionToCliConfig,\n} from \"../../lib/cli-session-sync\"\n\nexport interface CliInstallStatus {\n connected: boolean\n configPath: string\n hasDesktopSession: boolean\n installCommand: string\n loginCommand: string\n npxAvailable: boolean\n packageName: string\n}\n\nexport class CliService extends IpcService {\n static override readonly groupName = \"cli\"\n\n @IpcMethod()\n async getInstallStatus(_context: IpcContext): Promise<CliInstallStatus> {\n const [config, npxAvailable, desktopToken] = await Promise.all([\n readCliConfig(),\n isCliRunnerAvailable(),\n getSessionTokenFromCookies(),\n ])\n\n return {\n connected: Boolean(config.token),\n configPath: getCliConfigPath(),\n hasDesktopSession: Boolean(desktopToken),\n installCommand: getCliInstallCommand(),\n loginCommand: getCliLoginCommand(),\n npxAvailable,\n packageName: CLI_NPM_PACKAGE_NAME,\n }\n }\n\n @IpcMethod()\n async installCli(_context: IpcContext): Promise<{ success: boolean; error?: string }> {\n try {\n if (!(await isCliRunnerAvailable())) {\n return { success: false, error: \"npx is not available. Install Node.js and npm first.\" }\n }\n\n const token = await getSessionTokenFromCookies()\n if (!token) {\n return { success: false, error: \"Sign in to Folo Desktop first.\" }\n }\n\n await syncSessionToCliConfig(token)\n return { success: true }\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Failed to sync CLI login\",\n }\n }\n }\n\n @IpcMethod()\n async uninstallCli(_context: IpcContext): Promise<{ success: boolean; error?: string }> {\n try {\n await syncSessionToCliConfig()\n return { success: true }\n } catch (error) {\n return {\n success: false,\n error: error instanceof Error ? error.message : \"Failed to clear CLI login\",\n }\n }\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/debug.ts", "content": "import type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\n\ninterface InspectElementInput {\n x: number\n y: number\n}\n\nexport class DebugService extends IpcService {\n static override readonly groupName = \"debug\"\n\n @IpcMethod()\n inspectElement(context: IpcContext, input: InspectElementInput): void {\n context.sender.inspectElement(input.x, input.y)\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/dock.ts", "content": "import type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\n\nimport { UNREAD_BACKGROUND_POLLING_INTERVAL } from \"../../constants/app\"\nimport { apiClient } from \"../../lib/api-client\"\nimport { setDockCount } from \"../../lib/dock\"\n\nclass PollingManager {\n private abortController: AbortController | null = null\n private isPolling = false\n\n async startPolling(pollingFn: () => Promise<void>, interval: number): Promise<void> {\n if (this.isPolling) {\n return // Already polling, prevent duplicate instances\n }\n\n this.isPolling = true\n this.abortController = new AbortController()\n\n try {\n while (!this.abortController.signal.aborted) {\n await pollingFn()\n\n // Use AbortSignal with sleep for proper cancellation\n await this.sleepWithAbortSignal(interval, this.abortController.signal)\n }\n } catch (error) {\n if (error instanceof Error && error.name !== \"AbortError\") {\n console.error(\"Polling error:\", error)\n }\n } finally {\n this.isPolling = false\n this.abortController = null\n }\n }\n\n stopPolling(): void {\n if (this.abortController) {\n this.abortController.abort()\n }\n }\n\n get active(): boolean {\n return this.isPolling\n }\n\n private async sleepWithAbortSignal(ms: number, signal: AbortSignal): Promise<void> {\n return new Promise((resolve, reject) => {\n const timeoutId = setTimeout(resolve, ms)\n\n signal.addEventListener(\"abort\", () => {\n clearTimeout(timeoutId)\n reject(new DOMException(\"Aborted\", \"AbortError\"))\n })\n })\n }\n}\n\nexport class DockService extends IpcService {\n private unreadPollingManager = new PollingManager()\n\n static override readonly groupName = \"dock\"\n\n @IpcMethod()\n async pollingUpdateUnreadCount(): Promise<void> {\n await this.unreadPollingManager.startPolling(\n () => this.updateUnreadCount(),\n UNREAD_BACKGROUND_POLLING_INTERVAL,\n )\n }\n\n @IpcMethod()\n async cancelPollingUpdateUnreadCount(): Promise<void> {\n this.unreadPollingManager.stopPolling()\n }\n\n @IpcMethod()\n async updateUnreadCount(): Promise<void> {\n const res = await apiClient.reads.getTotalCount()\n\n setDockCount(res.data.count)\n }\n\n @IpcMethod()\n setDockBadge(_context: IpcContext, count: number): void {\n setDockCount(count)\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/integration.ts", "content": "import { existsSync } from \"node:fs\"\nimport fsp from \"node:fs/promises\"\n\nimport { shell } from \"electron\"\nimport type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\nimport path from \"pathe\"\n\nimport { store } from \"~/lib/store\"\nimport { logger } from \"~/logger\"\n\n// Taken from https://github.com/rollup/rollup/blob/4f69d33af3b2ec9320c43c9e6c65ea23a02bdde3/src/utils/sanitizeFileName.ts\n// https://datatracker.ietf.org/doc/html/rfc2396\n// eslint-disable-next-line no-control-regex\nconst INVALID_CHAR_REGEX = /[\\u0000-\\u001F\"#$%&*+,:;<=>?[\\]^`{|}\\u007F]/g\nconst DRIVE_LETTER_REGEX = /^[a-z]:/i\n\nfunction sanitizeFileName(name: string): string {\n const match = DRIVE_LETTER_REGEX.exec(name)\n const driveLetter = match ? match[0] : \"\"\n\n // A `:` is only allowed as part of a windows drive letter (ex: C:\\foo)\n // Otherwise, avoid them because they can refer to NTFS alternate data streams.\n return driveLetter + name.slice(driveLetter.length).replaceAll(INVALID_CHAR_REGEX, \"_\")\n}\n\n// Input types\ninterface SaveToEagleInput {\n url: string\n mediaUrls: string[]\n}\n\ninterface LoginToQBittorrentInput {\n host: string\n username: string\n password: string\n}\n\ninterface CheckQBittorrentAuthInput {\n host: string\n}\n\ninterface AddMagnetInput {\n host: string\n urls: string[]\n}\n\ninterface CustomFetchInput {\n url: string\n method: string\n headers: Record<string, string>\n body?: string\n timeout?: number\n}\n\nexport class IntegrationService extends IpcService {\n static override readonly groupName = \"integration\"\n\n @IpcMethod()\n async saveToObsidian(\n context: IpcContext,\n input: {\n url: string\n title: string\n content: string\n author: string\n publishedAt: string\n vaultPath: string\n },\n ) {\n try {\n const { url, title, content, author, publishedAt, vaultPath } = input\n\n const fileName = `${sanitizeFileName(title || publishedAt)\n .trim()\n .slice(0, 20)}.md`\n const filePath = path.join(vaultPath, fileName)\n const exists = existsSync(filePath)\n if (exists) {\n return { success: false, error: \"File already exists\" }\n }\n\n const markdown = `---\nurl: ${url}\nauthor: ${author}\npublishedAt: ${publishedAt}\n---\n\n# ${title}\n\n${content}\n`\n\n await fsp.writeFile(filePath, markdown, \"utf-8\")\n return { success: true }\n } catch (error) {\n console.error(\"Failed to save to Obsidian:\", error)\n const errorMessage = error instanceof Error ? error.message : String(error)\n return { success: false, error: errorMessage }\n }\n }\n\n @IpcMethod()\n async saveToEagle(context: IpcContext, input: SaveToEagleInput): Promise<any> {\n try {\n const res = await fetch(\"http://localhost:41595/api/item/addFromURLs\", {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n items: input.mediaUrls?.map((media) => ({\n url: media,\n website: input.url,\n headers: {\n referer: input.url,\n },\n })),\n }),\n })\n return await res.json()\n } catch {\n return null\n }\n }\n\n @IpcMethod()\n async loginToQBittorrent(context: IpcContext, input: LoginToQBittorrentInput) {\n const { host, username, password } = input\n\n const existingSID = store.get(\"qbittorrentSID\")\n if (existingSID) {\n const errorMessage = await this.checkQBittorrentAuth(context, { host })\n if (!errorMessage) {\n return\n }\n }\n\n const res = await fetch(`${host}/api/v2/auth/login`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n },\n body: `username=${encodeURIComponent(username)}&password=${encodeURIComponent(password)}`,\n })\n\n if (!res.ok) {\n return `Failed to log in to qBittorrent: ${await res.text()}`\n }\n\n const cookies = res.headers.get(\"set-cookie\") || \"\"\n const match = cookies.match(/SID=([^;]+)/)\n if (!match || !match[1]) {\n return \"Failed to get SID from qBittorrent\"\n }\n\n store.set(\"qbittorrentSID\", match[1])\n return\n }\n\n async checkQBittorrentAuth(context: IpcContext, input: CheckQBittorrentAuthInput) {\n const { host } = input\n const sid = store.get(\"qbittorrentSID\")\n if (!sid) {\n return \"Not logged in to qBittorrent\"\n }\n const res = await fetch(`${host}/api/v2/auth/check`, {\n method: \"GET\",\n headers: {\n Cookie: `SID=${sid}`,\n },\n credentials: \"omit\",\n })\n\n if (!res.ok) {\n return await res.text()\n }\n }\n\n @IpcMethod()\n async addMagnet(context: IpcContext, input: AddMagnetInput) {\n const { host, urls } = input\n const sid = store.get(\"qbittorrentSID\")\n if (!sid) {\n return \"Not logged in to qBittorrent\"\n }\n const res = await fetch(`${host}/api/v2/torrents/add`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/x-www-form-urlencoded\",\n Cookie: `SID=${sid}`,\n },\n credentials: \"omit\",\n body: `urls=${encodeURIComponent(urls.join(\"\\n\"))}`,\n })\n\n if (!res.ok) {\n const text = await res.text()\n return `Failed to add magnet links: ${text}`\n }\n\n // eslint-disable-next-line no-console\n console.log(`Added magnet links to qBittorrent: ${urls.join(\", \")}`)\n }\n\n @IpcMethod()\n async customFetch(context: IpcContext, input: CustomFetchInput) {\n const requestId = Math.random().toString(36).slice(2, 8)\n const { url, method, headers, body, timeout = 10_000 } = input\n\n // Log request start\n logger.info(`[CustomFetch:${requestId}] Starting request`, {\n url: url.replaceAll(/(\\?|&)([^=]+)=([^&]+)/g, (_, prefix, key, value) =>\n // Mask potential sensitive query parameters\n key.toLowerCase().includes(\"token\") ||\n key.toLowerCase().includes(\"key\") ||\n key.toLowerCase().includes(\"password\")\n ? `${prefix}${key}=***`\n : `${prefix}${key}=${value}`,\n ),\n method,\n timeout,\n hasBody: !!body,\n bodyLength: body?.length || 0,\n headerCount: Object.keys(headers || {}).length,\n })\n\n // Log request headers (mask sensitive headers)\n const safeHeaders = { ...headers }\n Object.keys(safeHeaders).forEach((key) => {\n if (\n key.toLowerCase().includes(\"authorization\") ||\n key.toLowerCase().includes(\"token\") ||\n key.toLowerCase().includes(\"key\")\n ) {\n safeHeaders[key] = \"***\"\n }\n })\n logger.debug(`[CustomFetch:${requestId}] Request headers`, { headers: safeHeaders })\n\n // Log request body (truncated for large bodies)\n if (body) {\n const truncatedBody =\n body.length > 500\n ? `${body.slice(0, 500)}... [truncated, total: ${body.length} chars]`\n : body\n logger.debug(`[CustomFetch:${requestId}] Request body`, { body: truncatedBody })\n }\n\n const startTime = Date.now()\n\n try {\n const controller = new AbortController()\n const timeoutId = setTimeout(() => {\n logger.warn(`[CustomFetch:${requestId}] Request timeout triggered after ${timeout}ms`)\n controller.abort()\n }, timeout)\n\n logger.debug(`[CustomFetch:${requestId}] Sending request...`)\n\n const response = await fetch(url, {\n method,\n headers,\n body: body && [\"POST\", \"PUT\", \"PATCH\"].includes(method.toUpperCase()) ? body : undefined,\n signal: controller.signal,\n })\n\n clearTimeout(timeoutId)\n const duration = Date.now() - startTime\n\n // Log response info\n logger.info(`[CustomFetch:${requestId}] Request completed`, {\n status: response.status,\n statusText: response.statusText,\n ok: response.ok,\n duration: `${duration}ms`,\n })\n\n // Convert response headers to plain object\n const responseHeaders: Record<string, string> = {}\n response.headers.forEach((value, key) => {\n responseHeaders[key] = value\n })\n\n logger.debug(`[CustomFetch:${requestId}] Response headers`, {\n headers: responseHeaders,\n contentType: responseHeaders[\"content-type\"],\n contentLength: responseHeaders[\"content-length\"],\n })\n\n // Get response text\n const text = await response.text()\n const responseSize = text.length\n\n logger.debug(`[CustomFetch:${requestId}] Response body received`, {\n size: `${responseSize} chars`,\n preview: text.length > 200 ? `${text.slice(0, 200)}...` : text,\n })\n\n // Try to parse as JSON, fallback to text\n let data: any\n try {\n data = JSON.parse(text)\n logger.debug(`[CustomFetch:${requestId}] Response successfully parsed as JSON`)\n } catch {\n data = text\n logger.debug(`[CustomFetch:${requestId}] Response kept as text (not valid JSON)`)\n }\n\n const result = {\n ok: response.ok,\n status: response.status,\n statusText: response.statusText,\n headers: responseHeaders,\n data,\n text,\n }\n\n logger.info(`[CustomFetch:${requestId}] Request successful`, {\n finalStatus: result.ok ? \"success\" : \"http_error\",\n responseSize: `${responseSize} chars`,\n totalDuration: `${Date.now() - startTime}ms`,\n })\n\n return result\n } catch (error) {\n const duration = Date.now() - startTime\n\n if (error instanceof Error && error.name === \"AbortError\") {\n logger.error(`[CustomFetch:${requestId}] Request timeout`, {\n duration: `${duration}ms`,\n timeout: `${timeout}ms`,\n url: url.split(\"?\")[0], // Remove query params for privacy\n })\n throw new Error(`Request timeout after ${timeout}ms`)\n }\n\n logger.error(`[CustomFetch:${requestId}] Request failed`, {\n error: error instanceof Error ? error.message : String(error),\n errorName: error instanceof Error ? error.name : \"Unknown\",\n duration: `${duration}ms`,\n url: url.split(\"?\")[0], // Remove query params for privacy\n })\n\n throw error\n }\n }\n\n @IpcMethod()\n async openURLScheme(context: IpcContext, scheme: string) {\n const requestId = Math.random().toString(36).slice(2, 8)\n\n try {\n // Validate URL scheme format\n if (!scheme.includes(\"://\")) {\n throw new Error(\"Invalid URL scheme format. Must include protocol (e.g., 'app://')\")\n }\n\n // Log URL scheme execution (mask sensitive data)\n const safeScheme = scheme.replaceAll(/(\\?|&)([^=]+)=([^&]+)/g, (_, prefix, key, value) =>\n // Mask potential sensitive query parameters\n key.toLowerCase().includes(\"token\") ||\n key.toLowerCase().includes(\"key\") ||\n key.toLowerCase().includes(\"password\")\n ? `${prefix}${key}=***`\n : `${prefix}${key}=${value}`,\n )\n\n logger.info(`[URLScheme:${requestId}] Opening URL scheme`, {\n scheme: safeScheme,\n protocol: scheme.split(\"://\")[0],\n })\n\n // Use Electron's shell.openExternal to open URL scheme\n // This will trigger the system's default handler for the scheme\n await shell.openExternal(scheme)\n\n logger.info(`[URLScheme:${requestId}] URL scheme opened successfully`)\n\n return { success: true }\n } catch (error) {\n logger.error(`[URLScheme:${requestId}] Failed to open URL scheme`, {\n error: error instanceof Error ? error.message : String(error),\n scheme: scheme.split(\"://\")[0], // Only log protocol for privacy\n })\n\n throw error\n }\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/menu.ts", "content": "import type { MenuItemConstructorOptions, MessageBoxOptions } from \"electron\"\nimport { dialog, Menu, ShareMenu } from \"electron\"\nimport type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\n\ntype SerializableMenuItem = Omit<MenuItemConstructorOptions, \"click\" | \"submenu\"> & {\n submenu?: SerializableMenuItem[]\n}\n\ninterface ShowContextMenuInput {\n items: SerializableMenuItem[]\n}\n\ninterface ShowConfirmDialogInput {\n title: string\n message: string\n options?: Partial<MessageBoxOptions>\n}\n\nexport class MenuService extends IpcService {\n static override readonly groupName = \"menu\"\n\n private normalizeMenuItems(\n items: SerializableMenuItem[],\n context: IpcContext,\n path: number[] = [],\n ): MenuItemConstructorOptions[] {\n return items.map((item, index) => {\n const curPath = [...path, index]\n return {\n ...item,\n click() {\n context.sender.send(\"menu-click\", {\n id: item.id,\n path: curPath,\n })\n },\n submenu: item.submenu ? this.normalizeMenuItems(item.submenu, context, curPath) : undefined,\n }\n })\n }\n\n @IpcMethod()\n async showContextMenu(context: IpcContext, input: ShowContextMenuInput): Promise<void> {\n const defer = Promise.withResolvers<void>()\n const normalizedMenuItems = this.normalizeMenuItems(input.items, context)\n\n const menu = Menu.buildFromTemplate(normalizedMenuItems)\n menu.popup({\n callback: () => defer.resolve(),\n })\n return defer.promise\n }\n\n @IpcMethod()\n async showConfirmDialog(_context: IpcContext, input: ShowConfirmDialogInput): Promise<boolean> {\n const result = await dialog.showMessageBox({\n message: input.title,\n detail: input.message,\n buttons: [\"Confirm\", \"Cancel\"],\n ...input.options,\n })\n return result.response === 0\n }\n\n @IpcMethod()\n async showShareMenu(context: IpcContext, input: string): Promise<void> {\n const menu = new ShareMenu({\n urls: [input],\n })\n\n menu.popup({\n callback: () => {\n context.sender.send(\"menu-closed\")\n },\n })\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/reader.ts", "content": "import fs from \"node:fs\"\n\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport { readability } from \"@follow-app/readability\"\nimport { app, BrowserWindow } from \"electron\"\nimport type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\nimport { MsEdgeTTS, OUTPUT_FORMAT } from \"msedge-tts\"\nimport path from \"pathe\"\nimport type { ModelResult } from \"vscode-languagedetection\"\n\nimport { detectCodeStringLanguage } from \"../../modules/language-detection\"\n\nconst tts = new MsEdgeTTS()\n\ninterface ReadabilityInput {\n url: string\n html?: string\n}\n\ninterface TtsInput {\n id: string\n text: string\n voice: string\n}\n\ninterface DetectCodeStringLanguageInput {\n codeString: string\n}\n\nexport class ReaderService extends IpcService {\n static override readonly groupName = \"reader\"\n\n @IpcMethod()\n async readability(_context: IpcContext, input: ReadabilityInput) {\n const { url } = input\n\n if (!url) {\n return null\n }\n const result = await readability(url)\n\n return result\n }\n\n @IpcMethod()\n async tts(context: IpcContext, input: TtsInput): Promise<string | null> {\n const { id, text, voice } = input\n if (!text) {\n return null\n }\n\n const window = BrowserWindow.fromWebContents(context.sender)\n if (!window) return null\n\n try {\n await tts.setMetadata(voice, OUTPUT_FORMAT.AUDIO_24KHZ_96KBITRATE_MONO_MP3, {})\n } catch (error: unknown) {\n console.error(\"Failed to set voice\", error)\n if (error instanceof Error) {\n callWindowExpose(window).toast.error(error.message, {\n duration: 1000,\n })\n } else {\n callWindowExpose(window).toast.error(\"Failed to set voice\", {\n duration: 1000,\n })\n }\n return null\n }\n\n const dirPath = path.join(app.getPath(\"userData\"), \"Cache\", \"tts\", id)\n const possibleFilePathList = [\"mp3\", \"webm\"].map((ext) => {\n return path.join(dirPath, `audio.${ext}`)\n })\n const filePath = possibleFilePathList.find((p) => fs.existsSync(p))\n if (filePath) {\n return filePath\n } else {\n fs.mkdirSync(dirPath, { recursive: true })\n const { audioFilePath } = await tts.toFile(dirPath, text)\n return audioFilePath\n }\n }\n\n @IpcMethod()\n async getVoices(context: IpcContext) {\n const window = BrowserWindow.fromWebContents(context.sender)\n try {\n const voices = await tts.getVoices()\n return voices\n } catch (error) {\n console.error(\"Failed to get voices\", error)\n if (!window) return\n if (error instanceof Error) {\n void callWindowExpose(window).toast.error(error.message, { duration: 1000 })\n return\n }\n callWindowExpose(window).toast.error(\"Failed to get voices\", { duration: 1000 })\n }\n }\n\n @IpcMethod()\n async detectCodeStringLanguage(\n _context: IpcContext,\n input: DetectCodeStringLanguageInput,\n ): Promise<ModelResult | undefined> {\n const { codeString } = input\n const languages = detectCodeStringLanguage(codeString)\n\n let finalLanguage: ModelResult | undefined\n for await (const language of languages) {\n if (!finalLanguage) {\n finalLanguage = language\n continue\n }\n if (language.confidence > finalLanguage.confidence) {\n finalLanguage = language\n }\n }\n\n return finalLanguage\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/ipc/services/setting.ts", "content": "import { createRequire } from \"node:module\"\n\nimport { app, nativeTheme } from \"electron\"\nimport type { IpcContext } from \"electron-ipc-decorator\"\nimport { IpcMethod, IpcService } from \"electron-ipc-decorator\"\n\nimport { WindowManager } from \"~/manager/window\"\n\nimport { setProxyConfig, updateProxy } from \"../../lib/proxy\"\nimport { store } from \"../../lib/store\"\nimport { getTrayConfig, setTrayConfig } from \"../../lib/tray\"\n\nconst require = createRequire(import.meta.url)\n\ninterface SetLoginItemSettingsInput {\n openAtLogin: boolean\n openAsHidden?: boolean\n path?: string\n args?: string[]\n}\n\nexport class SettingService extends IpcService {\n static override readonly groupName = \"setting\"\n\n @IpcMethod()\n getLoginItemSettings(_context: IpcContext): Electron.LoginItemSettings {\n return app.getLoginItemSettings()\n }\n\n @IpcMethod()\n setLoginItemSettings(_context: IpcContext, input: SetLoginItemSettingsInput): void {\n app.setLoginItemSettings(input)\n }\n\n @IpcMethod()\n openSettingWindow(_context: IpcContext): void {\n WindowManager.showSetting()\n }\n\n @IpcMethod()\n async getSystemFonts(_context: IpcContext): Promise<string[]> {\n const fonts = await require(\"font-list\").getFonts()\n return fonts.map((font: string) => font.replaceAll('\"', \"\"))\n }\n\n @IpcMethod()\n getAppearance(_context: IpcContext): \"light\" | \"dark\" | \"system\" {\n return nativeTheme.themeSource\n }\n\n @IpcMethod()\n setAppearance(_context: IpcContext, appearance: \"light\" | \"dark\" | \"system\"): void {\n nativeTheme.themeSource = appearance\n store.set(\"appearance\", appearance)\n }\n\n @IpcMethod()\n getMinimizeToTray(_context: IpcContext): boolean {\n return getTrayConfig()\n }\n\n @IpcMethod()\n setMinimizeToTray(_context: IpcContext, minimize: boolean): void {\n setTrayConfig(minimize)\n }\n\n @IpcMethod()\n getProxyConfig(_context: IpcContext) {\n const proxy = store.get(\"proxy\")\n return proxy ?? undefined\n }\n\n @IpcMethod()\n setProxyConfig(_context: IpcContext, config: string) {\n const result = setProxyConfig(config)\n updateProxy()\n return result\n }\n\n @IpcMethod()\n getMessagingToken(_context: IpcContext): string | null {\n return store.get(\"notifications-credentials\") as string | null\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/api-client.ts", "content": "import { env } from \"@follow/shared/env.desktop\"\nimport { createDesktopAPIHeaders } from \"@follow/utils/headers\"\nimport { FollowClient } from \"@follow-app/client-sdk\"\nimport PKG, { mainHash, version as appVersion } from \"@pkg\"\nimport { gte } from \"semver\"\n\nimport { BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN } from \"~/constants/app\"\nimport { WindowManager } from \"~/manager/window\"\nimport { getCurrentRendererManifest } from \"~/updater/hot-updater\"\n\nimport { logger } from \"../logger\"\n\nexport const followClient = new FollowClient({\n credentials: \"include\",\n timeout: 10000,\n\n baseURL: env.VITE_API_URL,\n fetch: async (input, options = {}) =>\n fetch(input.toString(), {\n ...options,\n cache: \"no-store\",\n }),\n})\n\nexport const apiClient = followClient.api\n\nfollowClient.addRequestInterceptor(async (ctx) => {\n const { options } = ctx\n const header = options.headers || {}\n\n const apiHeader = createDesktopAPIHeaders({ version: PKG.version })\n const rendererManifest = getCurrentRendererManifest()\n const rendererVersion = gte(rendererManifest?.version ?? appVersion, appVersion)\n ? (rendererManifest?.version ?? appVersion)\n : appVersion\n\n // Get cookies for authentication\n const window = WindowManager.getMainWindow()\n const cookies = await window?.webContents.session.cookies.get({\n domain: new URL(env.VITE_API_URL).hostname,\n })\n const sessionCookie = cookies?.find((cookie) =>\n cookie.name.includes(BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN),\n )\n const headerCookie = sessionCookie ? `${sessionCookie.name}=${sessionCookie.value}` : \"\"\n const userAgent = window?.webContents.getUserAgent() || `Folo/${PKG.version}`\n\n options.headers = {\n ...header,\n ...apiHeader,\n Cookie: headerCookie,\n \"User-Agent\": userAgent,\n\n \"X-Follow-Main-Hash\": mainHash,\n \"X-Follow-Renderer-Version\": rendererVersion,\n \"X-Follow-App-Version\": appVersion,\n \"X-Follow-Platform\": process.platform,\n }\n return ctx\n})\nfollowClient.addResponseInterceptor(({ response }) => {\n logger.info(`API Response: ${response.status} ${response.statusText}`)\n return response\n})\n\nfollowClient.addErrorInterceptor(async ({ response, error }) => {\n if (!response) {\n logger.error(\"API Request failed - no response\", error)\n return error\n }\n})\n\nfollowClient.addResponseInterceptor(async ({ response }) => {\n // Handle specific error cases if needed in main process\n if (response.status === 401) {\n logger.warn(\"Authentication failed in main process\")\n }\n\n try {\n await response.clone().json()\n } catch (error) {\n logger.error(\"API Error details:\", error)\n }\n\n return response\n})\n" }, { "path": "apps/desktop/layer/main/src/lib/auth-cookie-migration.ts", "content": "import type { Cookie, CookiesSetDetails, Session } from \"electron\"\n\nimport { BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN } from \"~/constants/app\"\n\nimport { logger } from \"../logger\"\n\nconst LEGACY_PROD_API_URL = \"https://api.follow.is\"\nconst BETTER_AUTH_SESSION_DATA_COOKIE_NAME = \"better-auth.session_data\"\n\nconst isBetterAuthSessionTokenCookie = (cookieName: string) => {\n return cookieName.includes(BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN)\n}\n\nconst isBetterAuthSessionCookie = (cookieName: string) => {\n return (\n cookieName.includes(BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN) ||\n cookieName.includes(BETTER_AUTH_SESSION_DATA_COOKIE_NAME)\n )\n}\n\nconst toCookieSetDetails = (cookie: Cookie, url: string, domain: string): CookiesSetDetails => {\n const details: CookiesSetDetails = {\n url,\n name: cookie.name,\n value: cookie.value,\n domain,\n path: cookie.path,\n secure: cookie.secure,\n httpOnly: cookie.httpOnly,\n sameSite: cookie.sameSite,\n }\n\n if (!cookie.session && cookie.expirationDate) {\n details.expirationDate = cookie.expirationDate\n }\n\n return details\n}\n\nexport const migrateAuthCookiesToNewApiDomain = async (\n cookieSession: Session,\n options: {\n currentApiURL: string\n legacyApiURL?: string\n },\n) => {\n const legacyApiURL = options.legacyApiURL ?? LEGACY_PROD_API_URL\n if (!options.currentApiURL || options.currentApiURL === legacyApiURL) {\n return\n }\n\n const currentHost = new URL(options.currentApiURL).hostname\n const legacyHost = new URL(legacyApiURL).hostname\n\n if (currentHost === legacyHost) {\n return\n }\n\n const currentDomainCookies = await cookieSession.cookies.get({\n domain: currentHost,\n })\n const hasCurrentDomainSessionTokenCookie = currentDomainCookies.some((cookie) =>\n isBetterAuthSessionTokenCookie(cookie.name),\n )\n if (hasCurrentDomainSessionTokenCookie) {\n return\n }\n\n const legacyDomainCookies = await cookieSession.cookies.get({\n domain: legacyHost,\n })\n const legacySessionCookies = legacyDomainCookies.filter((cookie) =>\n isBetterAuthSessionCookie(cookie.name),\n )\n\n if (legacySessionCookies.length === 0) {\n return\n }\n\n await Promise.all(\n legacySessionCookies.map((cookie) => {\n return cookieSession.cookies.set(\n toCookieSetDetails(cookie, options.currentApiURL, currentHost),\n )\n }),\n )\n\n logger.info(\n `Migrated ${legacySessionCookies.length} auth cookie(s) from ${legacyHost} to ${currentHost}`,\n )\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/cleaner.ts", "content": "import { statSync } from \"node:fs\"\nimport fsp from \"node:fs/promises\"\n\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport { app, dialog } from \"electron\"\nimport path from \"pathe\"\n\nimport { getIconPath } from \"~/helper\"\nimport { logger } from \"~/logger\"\nimport { WindowManager } from \"~/manager/window\"\n\nimport { t } from \"./i18n\"\nimport { store, StoreKey } from \"./store\"\n\nconst getFolderSize = async (dir: string): Promise<number> => {\n try {\n const files = await fsp.readdir(dir, { withFileTypes: true })\n const sizes = await Promise.all(\n files.map(async (file) => {\n const filePath = path.join(dir, file.name)\n\n if (file.isSymbolicLink()) {\n return 0\n }\n\n if (file.isDirectory()) {\n return await getFolderSize(filePath)\n }\n\n if (file.isFile()) {\n try {\n const { size } = await fsp.stat(filePath)\n return size\n } catch {\n return 0\n }\n }\n return 0\n }),\n )\n return sizes.reduce((acc, size) => acc + size, 0)\n } catch {\n return 0\n }\n}\n\nexport const clearAllDataAndConfirm = async () => {\n const win = WindowManager.getMainWindow()\n if (!win) return\n\n // Dialog to confirm\n const result = await dialog.showMessageBox({\n type: \"warning\",\n icon: getIconPath(),\n message: t(\"dialog.clearAllData\"),\n buttons: [t(\"dialog.yes\"), t(\"dialog.no\")],\n cancelId: 1,\n })\n\n if (result.response === 1) {\n return\n }\n return clearAllData()\n}\n\nexport const clearAllData = async () => {\n const win = WindowManager.getMainWindow()\n if (!win) return\n const ses = win.webContents.session\n const caller = callWindowExpose(win)\n\n try {\n await ses.clearCache()\n\n await ses.clearStorageData({\n storages: [\n \"websql\",\n \"filesystem\",\n \"indexdb\",\n \"localstorage\",\n \"shadercache\",\n \"websql\",\n \"serviceworkers\",\n \"cookies\",\n ],\n })\n\n caller.toast.success(\"App data reset successfully\")\n\n // reload the app\n win.reload()\n } catch (error: any) {\n caller.toast.error(`Error resetting app data: ${error.message}`)\n }\n}\n\nexport const getCacheSize = async () => {\n const cachePath = path.join(app.getPath(\"userData\"), \"cache\")\n\n // Size is in bytes\n const sizeInBytes = await getFolderSize(cachePath).catch((error) => {\n logger.error(error)\n })\n return sizeInBytes || 0\n}\n\nconst getCachedFilesRecursive = async (dir: string, result: string[] = []) => {\n const files = await fsp.readdir(dir)\n\n for (const file of files) {\n const filePath = path.join(dir, file)\n const stat = await fsp.stat(filePath)\n if (stat.isDirectory()) {\n const files = await getCachedFilesRecursive(filePath)\n result.push(...files)\n } else {\n result.push(filePath)\n }\n }\n return result\n}\n\nlet timer: any = null\n\nexport const clearCacheCronJob = () => {\n if (timer) {\n timer = clearInterval(timer)\n }\n timer = setInterval(\n async () => {\n const hasLimit = store.get(StoreKey.CacheSizeLimit)\n\n if (!hasLimit) {\n return\n }\n\n const cacheSize = await getCacheSize()\n\n const limitByteSize = hasLimit * 1024 * 1024\n if (cacheSize > limitByteSize) {\n const shouldCleanSize = cacheSize - limitByteSize - 1024 * 1024 * 50 // 50MB\n\n const cachePath = path.join(app.getPath(\"userData\"), \"cache\")\n const files = await getCachedFilesRecursive(cachePath)\n // Sort by last modified\n files.sort((a, b) => {\n const aStat = statSync(a)\n const bStat = statSync(b)\n return bStat.mtime.getTime() - aStat.mtime.getTime()\n })\n\n let cleanedSize = 0\n for (const file of files) {\n try {\n const fileSize = statSync(file).size\n await fsp.rm(file, { force: true })\n cleanedSize += fileSize\n if (cleanedSize >= shouldCleanSize) {\n logger.info(`Cleaned ${cleanedSize} bytes cache`)\n break\n }\n } catch (error) {\n logger.error(`Failed to delete cache file ${file}:`, error)\n }\n }\n }\n },\n 10 * 60 * 1000,\n ) // 10 min\n\n return () => {\n if (!timer) return\n timer = clearInterval(timer)\n }\n}\n\nexport const checkAndCleanCodeCache = async () => {\n const cachePath = path.join(app.getPath(\"userData\"), \"Code Cache\")\n\n const size = await getFolderSize(cachePath).catch((error) => {\n logger.error(error)\n })\n\n if (!size) return\n\n const threshold = 1024 * 1024 * 100 // 100MB\n if (size > threshold) {\n await fsp\n .rm(cachePath, { force: true, recursive: true })\n .then(() => {\n logger.info(`Cleaned ${size} bytes code cache`)\n })\n .catch((error) => {\n logger.error(`clean code cache failed: ${error.message}`)\n })\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/cli-session-sync.ts", "content": "import { execFile } from \"node:child_process\"\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\"\nimport { homedir } from \"node:os\"\nimport { promisify } from \"node:util\"\n\nimport { env } from \"@follow/shared/env.desktop\"\nimport { join } from \"pathe\"\n\nimport { BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN } from \"~/constants/app\"\nimport { WindowManager } from \"~/manager/window\"\n\nimport { logger } from \"../logger\"\n\nconst execFileAsync = promisify(execFile)\nexport const CLI_NPM_PACKAGE_NAME = \"folocli\"\nconst CLI_NPX_PACKAGE_SPEC = `${CLI_NPM_PACKAGE_NAME}@latest`\nconst CLI_CONFIG_DIR = join(homedir(), \".folo\")\nconst CLI_CONFIG_PATH = join(CLI_CONFIG_DIR, \"config.json\")\nconst getNpxCommand = () => (process.platform === \"win32\" ? \"npx.cmd\" : \"npx\")\n\nexport interface CliConfig {\n token?: string\n apiUrl?: string\n}\n\nexport const readCliConfig = async (): Promise<CliConfig> => {\n try {\n const raw = await readFile(CLI_CONFIG_PATH, \"utf8\")\n return JSON.parse(raw) as CliConfig\n } catch {\n return {}\n }\n}\n\nconst writeCliConfig = async (config: CliConfig): Promise<void> => {\n await mkdir(CLI_CONFIG_DIR, { recursive: true })\n await writeFile(CLI_CONFIG_PATH, `${JSON.stringify(config, null, 2)}\\n`, \"utf8\")\n}\n\nexport const getCliConfigPath = () => CLI_CONFIG_PATH\n\nexport const getCliInstallCommand = () => `npx --yes ${CLI_NPX_PACKAGE_SPEC} --help`\n\nexport const getCliLoginCommand = () =>\n `npx --yes ${CLI_NPX_PACKAGE_SPEC} login --token <session-token>`\n\nconst runCliCommand = async (args: string[]) => {\n await execFileAsync(getNpxCommand(), [\"--yes\", CLI_NPX_PACKAGE_SPEC, ...args], {\n windowsHide: true,\n timeout: 120_000,\n maxBuffer: 1024 * 1024,\n })\n}\n\nexport const isCliRunnerAvailable = async (): Promise<boolean> => {\n try {\n await execFileAsync(getNpxCommand(), [\"--version\"], {\n windowsHide: true,\n timeout: 10_000,\n maxBuffer: 128 * 1024,\n })\n return true\n } catch {\n return false\n }\n}\n\nconst clearCliConfigToken = async () => {\n const config = await readCliConfig()\n if (!config.token) {\n return\n }\n\n delete config.token\n await writeCliConfig(config)\n}\n\nexport const getSessionTokenFromCookies = async (): Promise<string | undefined> => {\n const window = WindowManager.getMainWindow()\n if (!window) return undefined\n\n const cookies = await window.webContents.session.cookies.get({\n domain: new URL(env.VITE_API_URL).hostname,\n })\n\n const sessionCookie = cookies.find((cookie) =>\n cookie.name.includes(BETTER_AUTH_COOKIE_NAME_SESSION_TOKEN),\n )\n\n return sessionCookie?.value\n}\n\nexport const syncSessionToCliConfig = async (token?: string): Promise<void> => {\n if (token) {\n const config = await readCliConfig()\n if (config.token === token && config.apiUrl === env.VITE_API_URL) {\n return\n }\n\n if (!(await isCliRunnerAvailable())) {\n throw new Error(\"npx is not available\")\n }\n\n await runCliCommand([\"login\", \"--token\", token, \"--api-url\", env.VITE_API_URL])\n logger.info(\"CLI login synced via npx\")\n return\n }\n\n if (await isCliRunnerAvailable()) {\n try {\n await runCliCommand([\"logout\"])\n logger.info(\"CLI login cleared via npx\")\n return\n } catch (error) {\n logger.error(\n \"Failed to clear CLI login via npx, falling back to local config cleanup:\",\n error,\n )\n }\n }\n\n await clearCliConfigToken()\n logger.info(\"CLI login cleared from local config\")\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/dock.ts", "content": "import { app } from \"electron\"\n\nimport { isWindows } from \"../env\"\n\nexport const setDockCount = (input: number) => {\n // TODO use Electron Overlay API\n if (isWindows) return\n if (app.dock) {\n app.dock.setBadge(input === 0 ? \"\" : input < 10000 ? input.toString() : \"9999+\")\n } else {\n app.setBadgeCount(input)\n }\n}\n\nexport const getDockCount = () => {\n if (isWindows) return null\n if (app.dock) {\n return app.dock.getBadge()\n } else {\n return app.getBadgeCount()\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/download.ts", "content": "import { createHash } from \"node:crypto\"\nimport { createWriteStream } from \"node:fs\"\nimport { mkdir } from \"node:fs/promises\"\nimport { pipeline } from \"node:stream\"\nimport { promisify } from \"node:util\"\n\nimport ky from \"ky\"\nimport path from \"pathe\"\n\nconst streamPipeline = promisify(pipeline)\n\nexport interface DownloadOptions {\n url: string\n outputPath: string\n expectedHash?: string\n onProgress?: (downloadedSize: number, totalSize: number, percentage: number) => void\n onLog?: (message: string) => void\n}\n\nexport async function downloadFile(url: string, dest: string) {\n const res = await fetch(url)\n\n // Check whether it responds successfully.\n if (!res.ok) {\n throw new Error(`Failed to fetch ${url}: ${res.statusText}`)\n }\n if (!res.body) {\n throw new Error(`Failed to get response body`)\n }\n await streamPipeline(res.body as any, createWriteStream(dest))\n}\n\nexport async function downloadFileWithProgress(options: DownloadOptions): Promise<boolean> {\n const { url, outputPath, expectedHash, onProgress, onLog } = options\n\n try {\n // Create download directory\n await mkdir(path.dirname(outputPath), { recursive: true })\n\n let lastProgressTime = Date.now()\n const sha256 = expectedHash ? createHash(\"sha256\") : null\n\n onLog?.(`Starting download: ${path.basename(outputPath)}`)\n\n // Use ky with onDownloadProgress\n const response = await ky.get(url, {\n onDownloadProgress: (progress) => {\n const now = Date.now()\n // Call progress callback every 500ms to avoid spam\n if (now - lastProgressTime > 500 || progress.percent === 1) {\n const percentage = progress.percent * 100\n const downloadedMB = (progress.transferredBytes / 1024 / 1024).toFixed(2)\n const totalMB = (progress.totalBytes / 1024 / 1024).toFixed(2)\n\n onLog?.(`Download progress: ${percentage.toFixed(1)}% (${downloadedMB}/${totalMB} MB)`)\n\n // Call progress callback if provided\n if (onProgress) {\n onProgress(progress.transferredBytes, progress.totalBytes, percentage)\n }\n\n lastProgressTime = now\n }\n },\n })\n\n if (!response.ok) {\n onLog?.(`Failed to download file: ${response.status} ${response.statusText}`)\n return false\n }\n\n // Get the response as array buffer\n const arrayBuffer = await response.arrayBuffer()\n const buffer = Buffer.from(arrayBuffer)\n\n // Verify hash if provided\n if (expectedHash && sha256) {\n sha256.update(buffer)\n const hash = sha256.digest(\"hex\")\n if (hash !== expectedHash) {\n onLog?.(`Hash verification failed. Expected: ${expectedHash}, Got: ${hash}`)\n return false\n }\n onLog?.(\"Hash verification passed\")\n }\n\n // Write to file\n const writeStream = createWriteStream(outputPath)\n\n return new Promise<boolean>((resolve) => {\n writeStream.on(\"error\", (error) => {\n onLog?.(`Write stream error: ${error}`)\n resolve(false)\n })\n\n writeStream.on(\"finish\", () => {\n onLog?.(`Download completed: ${outputPath}`)\n resolve(true)\n })\n\n writeStream.end(buffer)\n })\n } catch (error) {\n onLog?.(`Download error: ${error}`)\n return false\n }\n}\n\n// async function testDownload() {\n// console.info(\"Testing ky onDownloadProgress implementation...\")\n\n// const result = await downloadFileWithProgress({\n// url: \"https://github.com/Innei/Follow/releases/download/desktop/v1.2.5/manifest.yml\",\n// outputPath: path.resolve(os.tmpdir(), \"follow-render-update\", \"manifest.yml\"),\n// onLog(message) {\n// console.info(`[LOG] ${message}`)\n// },\n// })\n\n// console.info(`Download result: ${result}`)\n// }\n\n// testDownload().catch(console.error)\n" }, { "path": "apps/desktop/layer/main/src/lib/i18n.ts", "content": "import i18next from \"i18next\"\n\nimport { resources } from \"../@types/resources\"\n\nexport const defaultNS = \"native\"\n\nexport const i18n = i18next.createInstance() as typeof i18next\n\ni18n.init({\n fallbackLng: {\n default: [\"en\"],\n \"zh-TW\": [\"zh-CN\", \"en\"],\n },\n defaultNS,\n resources,\n})\n\nexport const { t } = i18n\n" }, { "path": "apps/desktop/layer/main/src/lib/proxy.test.ts", "content": "import { session } from \"electron\"\nimport type { Mock } from \"vitest\"\nimport { beforeEach, describe, expect, it, vi } from \"vitest\"\n\nimport { logger } from \"../logger\"\nimport { getProxyConfig, setProxyConfig, updateProxy } from \"./proxy\"\nimport { store } from \"./store\"\n\nvi.mock(\"electron\", () => ({\n session: {\n defaultSession: {\n setProxy: vi.fn(),\n },\n },\n}))\n\nvi.mock(\"./store\", () => ({\n store: {\n set: vi.fn(),\n get: vi.fn(),\n delete: vi.fn(),\n },\n}))\n\nvi.mock(\"../logger\", () => ({\n logger: {\n log: vi.fn(),\n },\n}))\n\ndescribe(\"proxy\", () => {\n beforeEach(() => {\n vi.clearAllMocks()\n })\n\n describe(\"setProxyConfig\", () => {\n it(\"should set proxy config and return true for valid proxy\", () => {\n const proxy = \"http://localhost:8080\"\n const result = setProxyConfig(proxy)\n expect(store.set).toHaveBeenCalledWith(\"proxy\", \"http://localhost:8080\")\n expect(result).toBe(true)\n })\n\n it(\"should set sock proxy config\", () => {\n const proxy = \"socks://localhost:8080\"\n const result = setProxyConfig(proxy)\n expect(store.set).toHaveBeenCalledWith(\"proxy\", \"socks://localhost:8080\")\n expect(result).toBe(true)\n })\n\n it(\"should handle default port\", () => {\n // https://github.com/RSSNext/Follow/issues/1197\n const proxy = \"http://example.com:80\"\n const result = setProxyConfig(proxy)\n expect(store.set).toHaveBeenCalledWith(\"proxy\", \"http://example.com\")\n expect(result).toBe(true)\n })\n\n it(\"should return false for invalid proxy\", () => {\n const proxy = \"invalid-proxy\"\n const result = setProxyConfig(proxy)\n expect(store.delete).toHaveBeenCalledWith(\"proxy\")\n expect(result).toBe(false)\n })\n })\n\n describe(\"getProxyConfig\", () => {\n it(\"should return normalized proxy config if set\", () => {\n ;(store.get as Mock).mockReturnValue(\"http://localhost:8080\")\n const result = getProxyConfig()\n expect(result).toBe(\"http://localhost:8080\")\n })\n\n it(\"should compatible dirty data\", () => {\n ;(store.get as Mock).mockReturnValue(\"http://localhost:8080,direct://\")\n const result = getProxyConfig()\n expect(result).toBe(\"http://localhost:8080\")\n })\n })\n\n describe(\"updateProxy\", () => {\n it(\"should set system proxy mode if no proxy config is set\", () => {\n ;(store.get as Mock).mockReturnValue(\"\")\n updateProxy()\n expect(session.defaultSession.setProxy).toHaveBeenCalledWith({ mode: \"system\" })\n })\n\n it(\"should set proxy rules if proxy config is set\", () => {\n ;(store.get as Mock).mockReturnValue(\"http://localhost:8080\")\n updateProxy()\n expect(logger.log).toHaveBeenCalledWith(\"Loading proxy: http://localhost:8080,direct://\")\n expect(session.defaultSession.setProxy).toHaveBeenCalledWith({\n proxyRules: \"http://localhost:8080,direct://\",\n proxyBypassRules: \"<local>\",\n })\n })\n })\n})\n" }, { "path": "apps/desktop/layer/main/src/lib/proxy.ts", "content": "import { session } from \"electron\"\nimport { ProxyAgent, setGlobalDispatcher } from \"undici\"\n\nimport { logger } from \"../logger\"\nimport { store } from \"./store\"\n\n// Sets up the proxy configuration for the app.\n//\n// See https://www.electronjs.org/docs/latest/api/session#sessetproxyconfig\n// for more information about the proxy API.\n//\n// The open-source project [poooi/poi](https://github.com/poooi/poi) is doing well in proxy configuration\n// refer the following files for more details:\n//\n// https://github.com/poooi/poi/blob/5741d0d02c0a08626dd53196b094223457014491/lib/proxy.ts#L36\n// https://github.com/poooi/poi/blob/5741d0d02c0a08626dd53196b094223457014491/views/components/settings/network/index.es\n\nexport const setProxyConfig = (inputProxy: string) => {\n const proxyUri = normalizeProxyUri(inputProxy)\n if (!proxyUri) {\n store.delete(\"proxy\")\n return false\n }\n store.set(\"proxy\", proxyUri)\n return true\n}\n\nexport const getProxyConfig = () => {\n const proxyConfig = store.get(\"proxy\")\n if (!proxyConfig) {\n return\n }\n const proxyUri = normalizeProxyUri(proxyConfig)\n return proxyUri\n}\n\nconst URL_SCHEME = new Set([\"http:\", \"https:\", \"ftp:\", \"socks:\", \"socks4:\", \"socks5:\"])\n\nconst normalizeProxyUri = (userProxy: string) => {\n if (!userProxy) {\n return\n }\n // Only use the first proxy if there are multiple urls\n const firstInput = userProxy.split(\",\")[0]!\n\n try {\n const proxyUrl = new URL(firstInput)\n if (!URL_SCHEME.has(proxyUrl.protocol) || !proxyUrl.hostname) {\n return\n }\n // There are multiple ways to specify a proxy in Electron,\n // but for security reasons, we only support simple proxy URLs for now.\n return `${proxyUrl.protocol}//${proxyUrl.hostname}${proxyUrl.port ? `:${proxyUrl.port}` : \"\"}`\n } catch {\n return\n }\n}\n\nconst BYPASS_RULES = [\"<local>\"].join(\";\")\n\nexport const updateProxy = () => {\n const proxyUri = getProxyConfig()\n if (!proxyUri) {\n session.defaultSession.setProxy({\n // Note that the system mode is different from setting no proxy configuration.\n // In the latter case, Electron falls back to the system settings only if no command-line options influence the proxy configuration.\n mode: \"system\",\n })\n return\n }\n const proxyRules = [\n proxyUri,\n // Failing over to using no proxy if the proxy is unavailable\n \"direct://\",\n ].join(\",\")\n\n logger.log(`Loading proxy: ${proxyRules}`)\n session.defaultSession.setProxy({\n proxyRules,\n proxyBypassRules: BYPASS_RULES,\n })\n\n // https://github.com/nodejs/undici/issues/2224\n // Error occurred in handler for 'setProxyConfig': InvalidArgumentError: Invalid URL protocol: the URL must start with `http:` or `https:`.\n const { protocol } = new URL(proxyUri)\n if (protocol !== \"http:\" && protocol !== \"https:\") {\n // undici doesn't support socks proxy\n logger.warn(\"undici only supports http and https proxy, skipping undici proxy setup\")\n return\n }\n // Currently, Session.setProxy is not working for native fetch, which is used by readability.\n // So we need to set proxy for native fetch manually, refer to https://stackoverflow.com/a/76503362/14676508\n const dispatcher = new ProxyAgent({ uri: new URL(proxyUri).toString() })\n setGlobalDispatcher(dispatcher)\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/router.ts", "content": "import { callWindowExpose } from \"@follow/shared/bridge\"\nimport { extractElectronWindowOptions } from \"@follow/shared/electron\"\nimport type { BrowserWindow } from \"electron/main\"\n\nimport { logger } from \"~/logger\"\nimport { WindowManager } from \"~/manager/window\"\n\nexport const handleUrlRouting = (url: string) => {\n const options = extractElectronWindowOptions(url)\n\n // For example, the url is \"follow://add?id=123&type=list&url=https://example.com\"\n const doubleSlash = url.indexOf(\"://\")\n if (doubleSlash === -1) {\n logger.error(\"url routing error: no protocol found\", url)\n return\n }\n // Remove the protocol\n // For example, the uri is \"/add?id=123&type=list&url=https://example.com\"\n const uri = url.slice(doubleSlash + 2)\n try {\n const { pathname, searchParams } = new URL(uri, \"https://follow.dev\")\n\n const pathnameTrimmed = pathname.endsWith(\"/\") ? pathname.slice(0, -1) : pathname\n\n switch (pathnameTrimmed) {\n case \"/add\": {\n callMainWindow(url, (mainWindow) => {\n const caller = callWindowExpose(mainWindow)\n\n const id = searchParams.get(\"id\") ?? undefined\n const isList = searchParams.get(\"type\") === \"list\"\n const urlParam = searchParams.get(\"url\") ?? undefined\n if (!id && !urlParam) return\n caller.follow({ isList, id, url: urlParam })\n })\n return\n }\n case \"/discover\": {\n callMainWindow(url, (mainWindow) => {\n const caller = callWindowExpose(mainWindow)\n\n const route = searchParams.get(\"route\") ?? undefined\n\n if (!route) return\n caller.rsshubRoute(route)\n })\n return\n }\n case \"/feed\": {\n callMainWindow(url, (mainWindow) => {\n const caller = callWindowExpose(mainWindow)\n\n const id = searchParams.get(\"id\") ?? undefined\n const view = searchParams.get(\"view\") ?? \"0\"\n if (!id) return\n caller.goToFeed({\n id,\n view: Number.parseInt(view, 10),\n })\n })\n return\n }\n case \"/list\": {\n callMainWindow(url, (mainWindow) => {\n const caller = callWindowExpose(mainWindow)\n\n const id = searchParams.get(\"id\") ?? undefined\n const view = searchParams.get(\"view\") ?? \"0\"\n if (!id) return\n caller.goToList({\n id,\n view: Number.parseInt(view, 10),\n })\n })\n return\n }\n case \"/refresh\": {\n callMainWindow(url, (mainWindow) => {\n const caller = callWindowExpose(mainWindow)\n caller.refreshSession()\n })\n return\n }\n case \"/\": {\n callMainWindow(url, (mainWindow) => {\n mainWindow.restore()\n mainWindow.focus()\n })\n return\n }\n\n default: {\n const { height, resizable = true, width } = options || {}\n WindowManager.createWindow({\n extraPath: `#${uri}`,\n width: width ?? 800,\n height: height ?? 700,\n minWidth: 600,\n minHeight: 600,\n resizable,\n })\n return\n }\n }\n } catch (err) {\n logger.error(\"routing error:\", err)\n }\n}\n\nconst callMainWindow = (url: string, fn: (mainWindow: BrowserWindow) => any) => {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) {\n WindowManager.createMainWindow()\n\n return handleUrlRouting(url)\n }\n mainWindow.restore()\n mainWindow.focus()\n fn(mainWindow)\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/store.ts", "content": "import type { Credentials } from \"@eneris/push-receiver/dist/types\"\nimport Store from \"electron-store\"\n\n// @keep-sorted\ntype StoreData = {\n \"notifications-credentials\"?: Credentials | null\n \"notifications-persistent-ids\"?: string[] | null\n appearance?: \"light\" | \"dark\" | \"system\" | null\n cacheSizeLimit?: number | null\n minimizeToTray?: boolean | null\n proxy?: string | null\n qbittorrentSID?: string | null\n user?: string | null\n windowState?: {\n height: number\n width: number\n x: number\n y: number\n } | null\n}\nexport const store = new Store<StoreData>({ name: \"db\" })\n\nexport enum StoreKey {\n CacheSizeLimit = \"cacheSizeLimit\",\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/tray.ts", "content": "import { name } from \"@pkg\"\nimport { app, Menu, nativeImage, Tray } from \"electron\"\n\nimport { isMacOS, isMAS, isWindows } from \"~/env\"\nimport { getTrayIconPath } from \"~/helper\"\nimport { logger, revealLogFile } from \"~/logger\"\nimport { WindowManager } from \"~/manager/window\"\nimport { checkForAppUpdates } from \"~/updater\"\n\nimport { getDockCount } from \"./dock\"\nimport { t } from \"./i18n\"\nimport { store } from \"./store\"\n\n// https://www.electronjs.org/docs/latest/tutorial/tray\n\nlet tray: Tray | null = null\n\nconst getTrayContextMenu = () => {\n const count = getDockCount()\n return Menu.buildFromTemplate([\n ...(count\n ? [\n {\n label: `${t(\"menu.unread\")} ${count}`,\n enabled: false,\n },\n ]\n : []),\n {\n label: t(\"menu.open\", { name }),\n click: showWindow,\n },\n {\n label: t(\"menu.help\"),\n submenu: [\n {\n label: t(\"menu.reload\"),\n click: () => {\n const mainWindow = WindowManager.getMainWindowOrCreate()\n mainWindow.webContents.reload()\n },\n },\n {\n label: t(\"menu.toggleDevTools\"),\n click: () => {\n const mainWindow = WindowManager.getMainWindowOrCreate()\n mainWindow.webContents.toggleDevTools()\n },\n },\n {\n label: t(\"menu.openLogFile\"),\n click: async () => {\n await revealLogFile()\n },\n },\n ...(!isMAS\n ? [\n {\n label: t(\"menu.checkForUpdates\"),\n click: async () => {\n showWindow()\n await checkForAppUpdates()\n },\n },\n ]\n : []),\n ],\n },\n {\n label: t(\"menu.quit\", { name }),\n click: () => {\n logger.info(\"Quit app from tray\")\n app.quit()\n },\n },\n ])\n}\nexport const registerAppTray = () => {\n if (!getTrayConfig()) return\n if (tray) {\n destroyAppTray()\n }\n\n const icon = nativeImage.createFromPath(getTrayIconPath())\n // See https://stackoverflow.com/questions/41664208/electron-tray-icon-change-depending-on-dark-theme/41998326#41998326\n const trayIcon = isMacOS ? icon.resize({ width: 16 }) : icon\n trayIcon.setTemplateImage(true)\n tray = new Tray(trayIcon)\n\n tray.setContextMenu(getTrayContextMenu())\n tray.setToolTip(app.getName())\n tray.on(\"mouse-enter\", () => {\n tray?.setContextMenu(getTrayContextMenu())\n })\n if (isWindows) {\n tray.on(\"click\", showWindow)\n }\n}\n\nconst showWindow = () => {\n const mainWindow = WindowManager.getMainWindowOrCreate()\n if (mainWindow.isMinimized()) {\n mainWindow.restore()\n } else {\n mainWindow.show()\n }\n}\n\nconst destroyAppTray = () => {\n if (tray) {\n tray.destroy()\n tray = null\n }\n}\n\nconst DEFAULT_MINIMIZE_TO_TRAY = false\n\nexport const getTrayConfig = () => store.get(\"minimizeToTray\") ?? DEFAULT_MINIMIZE_TO_TRAY\n\nexport const setTrayConfig = (input: boolean) => {\n store.set(\"minimizeToTray\", input)\n if (input) {\n registerAppTray()\n } else {\n destroyAppTray()\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/user.ts", "content": "import type { Credentials } from \"@eneris/push-receiver/dist/types\"\n\nimport { isLinux, isMacOS, isWindows } from \"~/env\"\nimport { logger } from \"~/logger\"\n\nimport { apiClient } from \"./api-client\"\nimport { store } from \"./store\"\n\nconst notificationChannel = isMacOS\n ? \"macos\"\n : isWindows\n ? \"windows\"\n : isLinux\n ? \"linux\"\n : \"desktop\"\n\nexport const updateNotificationsToken = async (newCredentials?: Credentials) => {\n if (newCredentials) {\n store.set(\"notifications-credentials\", newCredentials)\n }\n const credentials = newCredentials || store.get(\"notifications-credentials\")\n if (credentials?.fcm?.token) {\n try {\n await apiClient.messaging.createToken({\n token: credentials.fcm.token,\n channel: notificationChannel,\n })\n logger.info(\"updateNotificationsToken success: \", credentials.fcm.token)\n } catch (error) {\n logger.error(\"updateNotificationsToken error: \", error)\n }\n }\n}\n\nexport const deleteNotificationsToken = async () => {\n await apiClient.messaging.deleteToken({\n channel: notificationChannel,\n })\n}\n" }, { "path": "apps/desktop/layer/main/src/lib/utils.ts", "content": "import type { BrowserWindow } from \"electron\"\n\nexport const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))\n// To solve the vibrancy losing issue when leaving full screen mode\n// @see https://github.com/toeverything/AFFiNE/blob/280e24934a27557529479a70ab38c4f5fc65cb00/packages/frontend/electron/src/main/windows-manager/main-window.ts:L157\nexport function refreshBound(window: BrowserWindow, timeout = 0) {\n setTimeout(() => {\n // FIXME: workaround for theme bug in full screen mode\n const size = window?.getSize()\n window?.setSize(size[0]! + 1, size[1]! + 1)\n window?.setSize(size[0]!, size[1]!)\n }, timeout)\n}\n" }, { "path": "apps/desktop/layer/main/src/logger.ts", "content": "import { app, shell } from \"electron\"\nimport log from \"electron-log\"\n\nexport const logger = log.scope(\"main\")\nlog.initialize()\n\nexport function getLogFilePath() {\n return log.transports.file.getFile().path\n}\n\nexport async function revealLogFile() {\n const filePath = getLogFilePath()\n return await shell.openPath(filePath)\n}\n\napp.on(\"before-quit\", () => {\n logger.info(\"App is quitting\")\n log.transports.console.level = false\n})\n\napp.on(\"will-quit\", () => {\n logger.info(\"App will quit\")\n})\n" }, { "path": "apps/desktop/layer/main/src/manager/app.ts", "content": "import { PushReceiver } from \"@eneris/push-receiver\"\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport { APP_PROTOCOL, DEV, LEGACY_APP_PROTOCOL } from \"@follow/shared/constants\"\nimport { env } from \"@follow/shared/env.desktop\"\nimport { app, nativeTheme, Notification, shell } from \"electron\"\nimport contextMenu from \"electron-context-menu\"\nimport path from \"pathe\"\n\nimport { WindowManager } from \"~/manager/window\"\n\nimport { getIconPath } from \"../helper\"\nimport { initializeIpcServices } from \"../ipc\"\nimport { checkAndCleanCodeCache, clearCacheCronJob } from \"../lib/cleaner\"\nimport { getSessionTokenFromCookies, syncSessionToCliConfig } from \"../lib/cli-session-sync\"\nimport { t } from \"../lib/i18n\"\nimport { updateProxy } from \"../lib/proxy\"\nimport { store } from \"../lib/store\"\nimport { registerAppTray } from \"../lib/tray\"\nimport { updateNotificationsToken } from \"../lib/user\"\nimport { logger } from \"../logger\"\nimport { registerAppMenu } from \"../menu\"\nimport { registerUpdater } from \"../updater\"\nimport { LifecycleManager } from \"./lifecycle\"\n\nclass AppManagerStatic {\n private static instance: AppManagerStatic\n\n public static getInstance(): AppManagerStatic {\n if (!AppManagerStatic.instance) {\n AppManagerStatic.instance = new AppManagerStatic()\n }\n return AppManagerStatic.instance\n }\n\n public init() {\n initializeIpcServices()\n LifecycleManager.onReady(this.onReady.bind(this))\n }\n\n private onReady() {\n this.registerProtocols()\n this.setupAppVisuals()\n this.setupSystemConfigs()\n this.runCronJobs()\n this.registerMenuAndContextMenu()\n this.registerPushNotifications()\n\n updateProxy()\n registerUpdater()\n registerAppTray()\n\n // Sync the desktop session to the npm CLI after cookies are ready.\n setTimeout(async () => {\n try {\n const token = await getSessionTokenFromCookies()\n if (token) {\n await syncSessionToCliConfig(token)\n }\n } catch (err) {\n logger.error(\"Failed to sync session to CLI on startup:\", err)\n }\n }, 5000)\n }\n\n private registerProtocols() {\n const protocols = [LEGACY_APP_PROTOCOL, APP_PROTOCOL]\n\n for (const protocolName of protocols) {\n if (process.defaultApp) {\n if (process.argv.length >= 2) {\n app.setAsDefaultProtocolClient(protocolName, process.execPath, [\n path.resolve(process.argv[1]!),\n ])\n }\n } else {\n app.setAsDefaultProtocolClient(protocolName)\n }\n }\n }\n\n private setupAppVisuals() {\n if (app.dock) {\n app.dock.setIcon(getIconPath())\n }\n }\n\n private setupSystemConfigs() {\n const appearance = store.get(\"appearance\")\n if (appearance && [\"light\", \"dark\", \"system\"].includes(appearance)) {\n nativeTheme.themeSource = appearance\n }\n }\n\n private runCronJobs() {\n clearCacheCronJob()\n checkAndCleanCodeCache()\n }\n\n private async registerPushNotifications() {\n if (!env.VITE_FIREBASE_CONFIG) {\n return\n }\n\n const credentialsKey = \"notifications-credentials\"\n const persistentIdsKey = \"notifications-persistent-ids\"\n const credentials = store.get(credentialsKey)\n const persistentIds = store.get(persistentIdsKey)\n\n const instance = new PushReceiver({\n debug: true,\n firebase: JSON.parse(env.VITE_FIREBASE_CONFIG),\n persistentIds: persistentIds || [],\n credentials: credentials || undefined,\n bundleId: \"is.follow\",\n chromeId: \"is.follow\",\n })\n logger.info(\n `PushReceiver initialized with credentials ${JSON.stringify(credentials)} and firebase config ${\n env.VITE_FIREBASE_CONFIG\n }`,\n )\n\n instance.onReady(() => {\n logger.info(\"PushReceiver ready\")\n })\n\n instance.onCredentialsChanged(({ newCredentials }) => {\n logger.info(`PushReceiver credentials changed to ${newCredentials?.fcm?.token}`)\n updateNotificationsToken(newCredentials)\n })\n\n instance.onNotification((notification) => {\n logger.info(\n `PushReceiver received notification: ${JSON.stringify(notification.message.data)}`,\n )\n const { data } = notification.message\n if (!data) {\n return\n }\n switch (data.type) {\n case \"new-entry\": {\n const notification = new Notification({\n title: data.title as string,\n body: data.description as string,\n })\n notification.on(\"click\", () => {\n const mainWindow = WindowManager.getMainWindowOrCreate()\n mainWindow.restore()\n mainWindow.focus()\n const handlers = callWindowExpose(mainWindow)\n handlers.navigateEntry({\n feedId: data.feedId as string,\n entryId: data.entryId as string,\n view: Number.parseInt(data.view as string),\n })\n })\n notification.show()\n break\n }\n default: {\n break\n }\n }\n store.set(persistentIdsKey, instance.persistentIds)\n })\n\n try {\n await instance.connect()\n } catch (error) {\n logger.error(`PushReceiver error: ${error instanceof Error ? error.stack : error}`)\n }\n\n logger.info(\"PushReceiver connected\")\n }\n\n private contextMenuDisposer?: () => void\n public registerMenuAndContextMenu() {\n registerAppMenu()\n if (this.contextMenuDisposer) {\n this.contextMenuDisposer()\n }\n\n this.contextMenuDisposer = contextMenu({\n showSaveImageAs: true,\n showCopyLink: true,\n showCopyImageAddress: true,\n showCopyImage: true,\n showInspectElement: DEV,\n showSelectAll: true,\n showCopyVideoAddress: true,\n showSaveVideoAs: true,\n\n labels: {\n saveImageAs: t(\"contextMenu.saveImageAs\"),\n copyLink: t(\"contextMenu.copyLink\"),\n copyImageAddress: t(\"contextMenu.copyImageAddress\"),\n copyImage: t(\"contextMenu.copyImage\"),\n copyVideoAddress: t(\"contextMenu.copyVideoAddress\"),\n saveVideoAs: t(\"contextMenu.saveVideoAs\"),\n inspect: t(\"contextMenu.inspect\"),\n copy: t(\"contextMenu.copy\"),\n cut: t(\"contextMenu.cut\"),\n paste: t(\"contextMenu.paste\"),\n saveImage: t(\"contextMenu.saveImage\"),\n saveVideo: t(\"contextMenu.saveVideo\"),\n selectAll: t(\"contextMenu.selectAll\"),\n services: t(\"contextMenu.services\"),\n searchWithGoogle: t(\"contextMenu.searchWithGoogle\"),\n learnSpelling: t(\"contextMenu.learnSpelling\"),\n lookUpSelection: t(\"contextMenu.lookUpSelection\"),\n saveLinkAs: t(\"contextMenu.saveLinkAs\"),\n },\n\n prepend: (_defaultActions, params) => {\n return [\n {\n label: t(\"contextMenu.openImageInBrowser\"),\n visible: params.mediaType === \"image\",\n click: () => {\n shell.openExternal(params.srcURL)\n },\n },\n {\n label: t(\"contextMenu.openLinkInBrowser\"),\n visible: params.linkURL !== \"\",\n click: () => {\n shell.openExternal(params.linkURL)\n },\n },\n {\n role: \"undo\",\n label: t(\"menu.undo\"),\n accelerator: \"CmdOrCtrl+Z\",\n visible: params.isEditable,\n },\n {\n role: \"redo\",\n label: t(\"menu.redo\"),\n accelerator: \"CmdOrCtrl+Shift+Z\",\n visible: params.isEditable,\n },\n ]\n },\n })\n }\n}\n\nexport const AppManager = AppManagerStatic.getInstance()\n" }, { "path": "apps/desktop/layer/main/src/manager/bootstrap.ts", "content": "import { rmSync } from \"node:fs\"\n\nimport { electronApp, optimizer } from \"@electron-toolkit/utils\"\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport { DEV, LEGACY_APP_PROTOCOL } from \"@follow/shared/constants\"\nimport { env } from \"@follow/shared/env.desktop\"\nimport { createBuildSafeHeaders } from \"@follow/utils/headers\"\nimport { IMAGE_PROXY_URL } from \"@follow/utils/img-proxy\"\nimport { parse } from \"cookie-es\"\nimport { app, BrowserWindow, net, protocol, session } from \"electron\"\nimport { join } from \"pathe\"\n\nimport { WindowManager } from \"~/manager/window\"\n\nimport { isMacOS } from \"../env\"\nimport { migrateAuthCookiesToNewApiDomain } from \"../lib/auth-cookie-migration\"\nimport { handleUrlRouting } from \"../lib/router\"\nimport { store } from \"../lib/store\"\nimport { updateNotificationsToken } from \"../lib/user\"\nimport { logger } from \"../logger\"\nimport { cleanupOldRender } from \"../updater/hot-updater\"\nimport { AppManager } from \"./app\"\n\nconst apiURL = process.env[\"VITE_API_URL\"] || import.meta.env.VITE_API_URL\nconst buildSafeHeaders = createBuildSafeHeaders(env.VITE_WEB_URL, [\n IMAGE_PROXY_URL,\n env.VITE_API_URL,\n \"https://readwise.io\",\n])\n\nexport class BootstrapManager {\n public static start() {\n AppManager.init()\n\n const gotTheLock = app.requestSingleInstanceLock()\n if (!gotTheLock) {\n app.quit()\n return\n }\n\n this.registerAppEvents()\n }\n\n private static registerAppEvents() {\n app.on(\"second-instance\", (_, commandLine) => {\n const mainWindow = WindowManager.getMainWindow()\n if (mainWindow) {\n if (mainWindow.isMinimized()) mainWindow.restore()\n mainWindow.show()\n }\n\n const url = commandLine.pop()\n if (url) {\n this.handleOpen(url)\n }\n })\n\n app.whenReady().then(async () => {\n protocol.handle(\"app\", (request) => {\n try {\n const urlObj = new URL(request.url)\n return net.fetch(`file://${urlObj.pathname}`)\n } catch {\n logger.error(\"app protocol error\", request.url)\n return new Response(\"Not found\", { status: 404 })\n }\n })\n\n app.on(\"browser-window-created\", (_, window) => {\n optimizer.watchWindowShortcuts(window)\n })\n\n electronApp.setAppUserModelId(`re.${LEGACY_APP_PROTOCOL}`)\n\n session.defaultSession.webRequest.onBeforeSendHeaders((details, callback) => {\n details.requestHeaders = buildSafeHeaders({\n url: details.url,\n headers: details.requestHeaders,\n })\n\n callback({ cancel: false, requestHeaders: details.requestHeaders })\n })\n\n await migrateAuthCookiesToNewApiDomain(session.defaultSession, {\n currentApiURL: env.VITE_API_URL,\n })\n\n // Bypass CORS for PostHog analytics\n session.defaultSession.webRequest.onHeadersReceived((details, callback) => {\n const url = new URL(details.url)\n\n if (url.hostname === \"us.i.posthog.com\") {\n const responseHeaders = details.responseHeaders || {}\n\n responseHeaders[\"access-control-allow-origin\"] = [\"*\"]\n responseHeaders[\"access-control-allow-methods\"] = [\n \"GET\",\n \"POST\",\n \"PUT\",\n \"DELETE\",\n \"OPTIONS\",\n ]\n responseHeaders[\"access-control-allow-headers\"] = [\"*\"]\n responseHeaders[\"access-control-allow-credentials\"] = [\"true\"]\n\n callback({\n cancel: false,\n responseHeaders,\n })\n } else {\n callback({ cancel: false })\n }\n })\n\n WindowManager.getMainWindowOrCreate()\n\n app.on(\"open-url\", (_, url) => {\n const mainWindow = WindowManager.getMainWindowOrCreate()\n if (mainWindow && !mainWindow.isDestroyed()) {\n if (mainWindow.isMinimized()) mainWindow.restore()\n mainWindow.focus()\n }\n url && this.handleOpen(url)\n })\n\n if (DEV) {\n this.installDevTools()\n }\n })\n\n app.on(\"before-quit\", async () => {\n const window = WindowManager.getMainWindow()\n if (!window || window.isDestroyed()) return\n const bounds = window.getBounds()\n\n store.set(WindowManager.windowStateStoreKey, {\n width: bounds.width,\n height: bounds.height,\n x: bounds.x,\n y: bounds.y,\n })\n await session.defaultSession.cookies.flushStore()\n await cleanupOldRender()\n })\n\n app.on(\"window-all-closed\", () => {\n if (!isMacOS) {\n app.quit()\n }\n })\n\n app.on(\"before-quit\", () => {\n const windows = BrowserWindow.getAllWindows()\n windows.forEach((window) => window.destroy())\n\n if (import.meta.env.DEV) {\n const cacheDir = join(app.getPath(\"userData\"), \"Cache\")\n const codeCacheDir = join(app.getPath(\"userData\"), \"Code Cache\")\n\n rmSync(cacheDir, { recursive: true, force: true })\n rmSync(codeCacheDir, { recursive: true, force: true })\n }\n })\n }\n\n private static installDevTools() {\n import(\"electron-devtools-installer\").then(\n ({ default: installExtension, REDUX_DEVTOOLS, REACT_DEVELOPER_TOOLS }) => {\n ;[\n REDUX_DEVTOOLS,\n REACT_DEVELOPER_TOOLS,\n { id: \"acndjpgkpaclldomagafnognkcgjignd\" },\n ].forEach((extension) => {\n installExtension(extension, {\n loadExtensionOptions: { allowFileAccess: true },\n })\n .then((extension) => console.info(`Added Extension: ${extension.name}`))\n .catch((err) => console.info(\"An error occurred:\", err))\n })\n\n session.defaultSession.getAllExtensions().forEach((e) => {\n session.defaultSession.loadExtension(e.path)\n })\n },\n )\n }\n\n private static async handleOpen(url: string) {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) return\n\n const isValid = URL.canParse(url)\n if (!isValid) return\n const urlObj = new URL(url)\n\n if (urlObj.hostname === \"auth\" || urlObj.pathname === \"//auth\") {\n const token = urlObj.searchParams.get(\"token\")\n\n if (token) {\n await callWindowExpose(mainWindow).applyOneTimeToken(token)\n } else {\n const ck = urlObj.searchParams.get(\"ck\")\n const userId = urlObj.searchParams.get(\"userId\")\n\n if (ck && apiURL) {\n const cookie = parse(atob(ck), { decode: (value) => value })\n Object.keys(cookie).forEach(async (name) => {\n const value = cookie[name]!\n await mainWindow.webContents.session.cookies.set({\n url: apiURL,\n name,\n value,\n secure: true,\n httpOnly: true,\n domain: new URL(apiURL).hostname,\n sameSite: \"no_restriction\",\n expirationDate: new Date().setDate(new Date().getDate() + 30),\n })\n })\n\n if (userId) {\n await callWindowExpose(mainWindow).clearIfLoginOtherAccount(userId)\n }\n mainWindow.reload()\n\n updateNotificationsToken()\n }\n }\n } else {\n handleUrlRouting(url)\n }\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/manager/lifecycle.ts", "content": "import { app } from \"electron\"\n\nimport { WindowManager } from \"~/manager/window\"\n\nclass LifecycleManagerStatic {\n private static instance: LifecycleManagerStatic\n\n private constructor() {\n this.registerListeners()\n }\n\n public static getInstance(): LifecycleManagerStatic {\n if (!LifecycleManagerStatic.instance) {\n LifecycleManagerStatic.instance = new LifecycleManagerStatic()\n }\n return LifecycleManagerStatic.instance\n }\n\n private registerListeners() {\n app.on(\"window-all-closed\", this.onWindowAllClosed.bind(this))\n app.on(\"activate\", this.onActivate.bind(this))\n }\n\n private onWindowAllClosed() {\n if (process.platform !== \"darwin\") {\n app.quit()\n }\n }\n\n private onActivate() {\n const mainWindow = WindowManager.getMainWindowOrCreate()\n mainWindow.show()\n mainWindow.focus()\n }\n\n public onReady(callback: () => void) {\n if (app.isReady()) {\n callback()\n } else {\n app.on(\"ready\", callback)\n }\n }\n}\n\nexport const LifecycleManager = LifecycleManagerStatic.getInstance()\n" }, { "path": "apps/desktop/layer/main/src/manager/window.ts", "content": "import { fileURLToPath } from \"node:url\"\n\nimport { is } from \"@electron-toolkit/utils\"\nimport { LEGACY_APP_PROTOCOL } from \"@follow/shared\"\nimport { callWindowExpose, WindowState } from \"@follow/shared/bridge\"\nimport { APP_PROTOCOL, DEV } from \"@follow/shared/constants\"\nimport type { BrowserWindowConstructorOptions } from \"electron\"\nimport { BrowserWindow, screen, shell } from \"electron\"\nimport type { Event } from \"electron/main\"\nimport path from \"pathe\"\n\nimport { isMacOS, isWindows, isWindows11 } from \"~/env\"\nimport { filePathToAppUrl, getIconPath } from \"~/helper\"\nimport { t } from \"~/lib/i18n\"\nimport { store } from \"~/lib/store\"\nimport { getTrayConfig } from \"~/lib/tray\"\nimport { refreshBound } from \"~/lib/utils\"\nimport { logger } from \"~/logger\"\nimport { loadDynamicRenderEntry } from \"~/updater/hot-updater\"\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url))\n\nclass WindowManagerStatic {\n static get mainWindowDefaultSize() {\n const primaryDisplay = screen.getPrimaryDisplay()\n const { workAreaSize } = primaryDisplay\n return {\n height: workAreaSize.height,\n width: workAreaSize.width,\n }\n }\n\n // Window configuration properties for better DX\n private readonly config = {\n windowStateStoreKey: \"windowState\",\n minWindowSize: {\n width: 1024,\n height: 500,\n },\n macOSTrafficLight: {\n x: 18,\n y: 18,\n },\n refreshBoundDelay: 1000,\n devToolsFont: {\n family:\n 'consolas, operator mono, Cascadia Code, OperatorMonoSSmLig Nerd Font, \"Agave Nerd Font\", \"Cascadia Code PL\", monospace',\n size: \"13px\",\n },\n ignoreProtocols: [\n \"http\",\n \"https\",\n LEGACY_APP_PROTOCOL,\n APP_PROTOCOL,\n \"file\",\n \"code\",\n \"cursor\",\n \"app\",\n ] as const,\n vibrancy: {\n macOS: {\n type: \"sidebar\" as const,\n state: \"followWindow\" as const,\n },\n },\n windowPreferences: {\n preloadScript: path.join(__dirname, \"../preload/index.mjs\"),\n },\n } as const\n\n readonly windowStateStoreKey = this.config.windowStateStoreKey\n\n private windows = {\n mainWindow: null as BrowserWindow | null,\n }\n\n private bindEvents(window: BrowserWindow) {\n window.on(\"leave-html-full-screen\", () => {\n // To solve the vibrancy losing issue when leaving full screen mode\n // @see https://github.com/toeverything/AFFiNE/blob/280e24934a27557529479a70ab38c4f5fc65cb00/packages/frontend/electron/src/main/windows-manager/main-window.ts:L157\n refreshBound(window)\n refreshBound(window, this.config.refreshBoundDelay)\n })\n\n const parseProtocol = (url: string) => {\n try {\n return new URL(url).protocol.slice(0, -1)\n } catch {\n logger.warn(\"Blocked external URL with invalid format\", { url })\n return null\n }\n }\n\n const isIgnoredProtocol = (\n protocol: string,\n ): protocol is (typeof this.config.ignoreProtocols)[number] => {\n return this.config.ignoreProtocols.includes(\n protocol as (typeof this.config.ignoreProtocols)[number],\n )\n }\n\n const confirmAndOpenExternalProtocol = async (url: string) => {\n const caller = callWindowExpose(window)\n const confirm = await caller.dialog.ask({\n title: t(\"dialog.openExternalApp.title\"),\n message: t(\"dialog.openExternalApp.message\", {\n url,\n interpolation: { escapeValue: false },\n }),\n confirmText: t(\"dialog.open\"),\n cancelText: t(\"dialog.cancel\"),\n })\n if (!confirm) {\n return\n }\n void shell.openExternal(url)\n }\n\n window.webContents.setWindowOpenHandler((details) => {\n const protocol = parseProtocol(details.url)\n if (!protocol) {\n return { action: \"deny\" }\n }\n\n if (protocol === \"http\" || protocol === \"https\") {\n void shell.openExternal(details.url)\n return { action: \"deny\" }\n }\n\n if (isIgnoredProtocol(protocol)) {\n logger.warn(\"Blocked window.open for ignored protocol\", {\n protocol,\n url: details.url,\n })\n return { action: \"deny\" }\n }\n\n void confirmAndOpenExternalProtocol(details.url)\n return { action: \"deny\" }\n })\n\n const handleExternalProtocol = async (e: Event, url: string) => {\n const protocol = parseProtocol(url)\n if (!protocol) {\n e.preventDefault()\n return\n }\n\n if (isIgnoredProtocol(protocol)) {\n return\n }\n e.preventDefault()\n\n await confirmAndOpenExternalProtocol(url)\n }\n\n // Handle main window external links\n window.webContents.on(\"will-navigate\", (e, url) => {\n void handleExternalProtocol(e, url)\n })\n\n // Handle webview external links\n window.webContents.on(\"did-attach-webview\", (_, webContents) => {\n webContents.on(\"will-navigate\", (e, url) => {\n void handleExternalProtocol(e, url)\n })\n })\n\n if (isWindows) {\n // Change the default font-family and font-size of the devtools.\n // Make it consistent with Chrome on Windows, instead of SimSun.\n // ref: [[Feature Request]: Add possibility to change DevTools font · Issue #42055 · electron/electron](https://github.com/electron/electron/issues/42055)\n window.webContents.on(\"devtools-opened\", () => {\n this.setupDevToolsFont(window)\n })\n }\n\n this.bindWindowStateEvents(window)\n }\n\n private setupDevToolsFont(window: BrowserWindow) {\n // source-code-font: For code such as Elements panel\n // monospace-font: For sidebar such as Event Listener Panel\n const css = `:root {--devtool-font-family: ${this.config.devToolsFont.family};--source-code-font-family:var(--devtool-font-family);--source-code-font-size: ${this.config.devToolsFont.size};--monospace-font-family: var(--devtool-font-family);--monospace-font-size: ${this.config.devToolsFont.size};}`\n const js = `\n const overriddenStyle = document.createElement('style');\n overriddenStyle.innerHTML = '${css.replaceAll(\"\\n\", \" \")}';\n document.body.append(overriddenStyle);\n document.querySelectorAll('.platform-windows').forEach(el => el.classList.remove('platform-windows'));\n addStyleToAutoComplete();\n const observer = new MutationObserver((mutationList, observer) => {\n for (const mutation of mutationList) {\n if (mutation.type === 'childList') {\n for (let i = 0; i < mutation.addedNodes.length; i++) {\n const item = mutation.addedNodes[i];\n if (item instanceof HTMLElement && item.classList.contains('editor-tooltip-host')) {\n addStyleToAutoComplete();\n }\n }\n }\n }\n });\n observer.observe(document.body, {childList: true});\n function addStyleToAutoComplete() {\n document.querySelectorAll('.editor-tooltip-host').forEach(element => {\n if (element.shadowRoot && element.shadowRoot.querySelectorAll('[data-key=\"overridden-dev-tools-font\"]').length === 0) {\n const overriddenStyle = document.createElement('style');\n overriddenStyle.setAttribute('data-key', 'overridden-dev-tools-font');\n overriddenStyle.innerHTML = '.cm-tooltip-autocomplete ul[role=listbox] {font-family: consolas !important;}';\n element.shadowRoot.append(overriddenStyle);\n }\n });\n }\n `\n window.webContents.devToolsWebContents?.executeJavaScript(js)\n }\n\n private bindWindowStateEvents(window: BrowserWindow) {\n // async render and main state\n window.on(\"maximize\", async () => {\n const caller = callWindowExpose(window)\n await caller.setWindowState(WindowState.MAXIMIZED)\n })\n\n window.on(\"unmaximize\", async () => {\n const caller = callWindowExpose(window)\n await caller.setWindowState(WindowState.NORMAL)\n })\n\n window.on(\"minimize\", async () => {\n const caller = callWindowExpose(window)\n await caller.setWindowState(WindowState.MINIMIZED)\n })\n\n window.on(\"restore\", async () => {\n const caller = callWindowExpose(window)\n await caller.setWindowState(WindowState.NORMAL)\n })\n }\n\n private bindMainWindowCloseHandlers(window: BrowserWindow) {\n window.on(\"close\", () => {\n if (isWindows11) {\n const windowStoreKey = Symbol.for(\"maximized\")\n if (window[windowStoreKey]) {\n const stored = window[windowStoreKey]\n store.set(this.windowStateStoreKey, {\n width: stored.size[0],\n height: stored.size[1],\n x: stored.position[0],\n y: stored.position[1],\n })\n\n return\n }\n }\n\n const bounds = window.getBounds()\n store.set(this.windowStateStoreKey, {\n width: bounds.width,\n height: bounds.height,\n x: bounds.x,\n y: bounds.y,\n })\n })\n\n window.on(\"close\", (event) => {\n const minimizeToTray = getTrayConfig()\n if (isMacOS || minimizeToTray) {\n event.preventDefault()\n if (window.isFullScreen()) {\n window.once(\"leave-full-screen\", () => {\n window.hide()\n })\n window.setFullScreen(false)\n } else {\n window.hide()\n }\n\n const caller = callWindowExpose(window)\n caller.onWindowClose()\n } else {\n this.windows.mainWindow = null\n }\n })\n }\n\n private getPlatformSpecificWindowConfig(): Partial<BrowserWindowConstructorOptions> {\n const { platform } = process\n\n switch (platform) {\n case \"darwin\": {\n return {\n titleBarStyle: \"hiddenInset\",\n trafficLightPosition: {\n x: this.config.macOSTrafficLight.x,\n y: this.config.macOSTrafficLight.y,\n },\n vibrancy: this.config.vibrancy.macOS.type,\n visualEffectState: this.config.vibrancy.macOS.state,\n transparent: true,\n }\n }\n\n case \"win32\": {\n return {\n icon: getIconPath(),\n titleBarStyle: \"hidden\",\n // Electron material bug, comment this for now\n // backgroundMaterial: isWindows11 ? \"mica\" : undefined,\n frame: true,\n }\n }\n\n default: {\n return {\n icon: getIconPath(),\n }\n }\n }\n }\n\n createWindow = (\n options: {\n extraPath?: string\n height: number\n width: number\n } & BrowserWindowConstructorOptions,\n ) => {\n const { extraPath, height, width, ...configs } = options\n\n const baseWindowConfig: Electron.BrowserWindowConstructorOptions = {\n width,\n height,\n show: false,\n resizable: configs?.resizable ?? true,\n autoHideMenuBar: true,\n alwaysOnTop: false,\n webPreferences: {\n preload: this.config.windowPreferences.preloadScript,\n sandbox: false,\n webviewTag: true,\n webSecurity: !DEV,\n nodeIntegration: true,\n contextIsolation: false,\n },\n ...this.getPlatformSpecificWindowConfig(),\n }\n\n // Create the browser window.\n const window = new BrowserWindow({\n ...baseWindowConfig,\n ...configs,\n })\n\n this.bindEvents(window)\n\n // HMR for renderer base on electron-vite cli.\n // Load the remote URL for development or the local html file for production.\n if (is.dev && process.env[\"ELECTRON_RENDERER_URL\"]) {\n window.loadURL(process.env[\"ELECTRON_RENDERER_URL\"] + (options?.extraPath || \"\"))\n logger.log(process.env[\"ELECTRON_RENDERER_URL\"] + (options?.extraPath || \"\"))\n } else {\n // Production entry\n const dynamicRenderEntry = loadDynamicRenderEntry()\n if (dynamicRenderEntry) logger.info(\"load dynamic render entry\", dynamicRenderEntry)\n const appLoadFileEntry =\n dynamicRenderEntry || path.resolve(__dirname, \"../renderer/index.html\")\n\n const appLoadEntry = `${filePathToAppUrl(appLoadFileEntry)}${options?.extraPath || \"\"}`\n\n window.loadURL(appLoadEntry)\n logger.log(\"load URL\", appLoadEntry)\n }\n\n return window\n }\n\n private ensureWindowBoundsInScreen(windowState?: {\n width?: number\n height?: number\n x?: number\n y?: number\n }) {\n const primaryDisplay = screen.getPrimaryDisplay()\n const { workArea } = primaryDisplay\n\n const maxWidth = workArea.width\n const maxHeight = workArea.height\n\n const defaultSize = WindowManagerStatic.mainWindowDefaultSize\n\n const width = windowState?.width ? Math.min(windowState.width, maxWidth) : defaultSize.width\n const height = windowState?.height\n ? Math.min(windowState.height, maxHeight)\n : defaultSize.height\n\n const ensureInBounds = (value: number, min: number, max: number): number => {\n return Math.max(min, Math.min(value, max))\n }\n\n const x =\n windowState?.x !== undefined\n ? ensureInBounds(windowState.x, workArea.x, workArea.x + workArea.width - width)\n : undefined\n\n const y =\n windowState?.y !== undefined\n ? ensureInBounds(windowState.y, workArea.y, workArea.y + workArea.height - height)\n : undefined\n\n return { width, height, x, y, maxWidth, maxHeight }\n }\n\n createMainWindow = () => {\n const windowState = store.get(this.windowStateStoreKey) as\n | {\n width?: number\n height?: number\n x?: number\n y?: number\n }\n | undefined\n const { width, height, x, y, maxWidth, maxHeight } =\n this.ensureWindowBoundsInScreen(windowState)\n\n const window = this.createWindow({\n width,\n height,\n x,\n y,\n minWidth: Math.min(this.config.minWindowSize.width, maxWidth),\n minHeight: Math.min(this.config.minWindowSize.height, maxHeight),\n })\n\n this.bindMainWindowCloseHandlers(window)\n\n this.windows.mainWindow = window\n\n return window\n }\n\n showSetting = (path?: string) => {\n // We need to open the setting modal in the main window when the main window exists,\n // if we open a new window then the state between the two windows will be out of sync.\n if (this.windows.mainWindow) {\n if (this.windows.mainWindow.isMinimized()) {\n this.windows.mainWindow.restore()\n }\n this.windows.mainWindow.show()\n\n callWindowExpose(this.windows.mainWindow).showSetting(path)\n return\n } else {\n this.windows.mainWindow = this.createMainWindow()\n this.windows.mainWindow.show()\n callWindowExpose(this.windows.mainWindow).showSetting(path)\n }\n }\n\n getMainWindow = () => this.windows.mainWindow\n\n getMainWindowOrCreate = () => {\n if (!this.windows.mainWindow) {\n return this.createMainWindow()\n }\n return this.windows.mainWindow\n }\n\n destroyMainWindow = () => {\n this.windows.mainWindow?.destroy()\n this.windows.mainWindow = null\n }\n}\n\nexport const WindowManager = new WindowManagerStatic()\n" }, { "path": "apps/desktop/layer/main/src/menu.ts", "content": "import { callWindowExpose } from \"@follow/shared/bridge\"\nimport { DEV } from \"@follow/shared/constants\"\nimport { dispatchEventOnWindow } from \"@follow/shared/event\"\nimport { name } from \"@pkg\"\nimport type { BrowserWindow, MenuItem, MenuItemConstructorOptions } from \"electron\"\nimport { Menu } from \"electron\"\n\nimport { isMacOS, isMAS } from \"./env\"\nimport { clearAllDataAndConfirm } from \"./lib/cleaner\"\nimport { t } from \"./lib/i18n\"\nimport { revealLogFile } from \"./logger\"\nimport { WindowManager } from \"./manager/window\"\nimport { checkForAppUpdates, quitAndInstall } from \"./updater\"\n\nexport const registerAppMenu = () => {\n const menus: Array<MenuItemConstructorOptions | MenuItem> = [\n ...(isMacOS\n ? ([\n {\n label: name,\n submenu: [\n {\n type: \"normal\",\n label: t(\"menu.about\", { name }),\n click: () => {\n WindowManager.showSetting(\"about\")\n },\n },\n { type: \"separator\" },\n {\n label: t(\"menu.settings\"),\n accelerator: \"CmdOrCtrl+,\",\n click: () => WindowManager.showSetting(),\n },\n { type: \"separator\" },\n { role: \"services\", label: t(\"menu.services\") },\n { type: \"separator\" },\n { role: \"hide\", label: t(\"menu.hide\", { name }) },\n { role: \"hideOthers\", label: t(\"menu.hideOthers\") },\n { type: \"separator\" },\n {\n label: t(\"menu.clearAllData\"),\n click: clearAllDataAndConfirm,\n },\n { role: \"quit\", label: t(\"menu.quit\", { name }) },\n ],\n },\n ] as MenuItemConstructorOptions[])\n : []),\n\n {\n role: \"fileMenu\",\n label: t(\"menu.file\"),\n submenu: [\n {\n type: \"normal\",\n label: t(\"menu.quickAdd\"),\n accelerator: \"CmdOrCtrl+N\",\n click: () => {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) return\n mainWindow.show()\n const caller = callWindowExpose(mainWindow)\n caller.quickAdd()\n },\n },\n\n {\n type: \"normal\",\n label: t(\"menu.discover\"),\n accelerator: \"CmdOrCtrl+T\",\n click: () => {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) return\n mainWindow.show()\n\n const caller = callWindowExpose(mainWindow)\n caller.goToDiscover()\n },\n },\n\n { type: \"separator\" },\n { role: \"close\", label: t(\"menu.close\") },\n ],\n },\n {\n label: t(\"menu.edit\"),\n submenu: [\n { role: \"undo\", label: t(\"menu.undo\") },\n { role: \"redo\", label: t(\"menu.redo\") },\n { type: \"separator\" },\n { role: \"cut\", label: t(\"menu.cut\") },\n { role: \"copy\", label: t(\"menu.copy\") },\n { role: \"paste\", label: t(\"menu.paste\") },\n { type: \"separator\" },\n {\n type: \"normal\",\n label: t(\"menu.search\"),\n accelerator: \"CmdOrCtrl+F\",\n click(_e, window) {\n if (!window) return\n dispatchEventOnWindow(window as BrowserWindow, \"OpenSearch\")\n },\n },\n ...((isMacOS\n ? [\n { role: \"pasteAndMatchStyle\", label: t(\"menu.pasteAndMatchStyle\") },\n { role: \"delete\", label: t(\"menu.delete\") },\n { role: \"selectAll\", label: t(\"menu.selectAll\") },\n { type: \"separator\" },\n {\n label: t(\"menu.speech\"),\n submenu: [\n { role: \"startSpeaking\", label: t(\"menu.startSpeaking\") },\n { role: \"stopSpeaking\", label: t(\"menu.stopSpeaking\") },\n ],\n },\n ]\n : [\n { role: \"delete\", label: t(\"menu.delete\") },\n { type: \"separator\" },\n { role: \"selectAll\", label: t(\"menu.selectAll\") },\n ]) as MenuItemConstructorOptions[]),\n ],\n },\n {\n role: \"viewMenu\",\n label: t(\"menu.view\"),\n submenu: [\n { role: \"reload\", label: t(\"menu.reload\") },\n { role: \"forceReload\", label: t(\"menu.forceReload\") },\n { role: \"toggleDevTools\", label: t(\"menu.toggleDevTools\") },\n { type: \"separator\" },\n\n { role: \"togglefullscreen\", label: t(\"menu.toggleFullScreen\") },\n ],\n },\n {\n role: \"windowMenu\",\n label: t(\"menu.window\"),\n submenu: [\n {\n role: \"minimize\",\n label: t(\"menu.minimize\"),\n },\n {\n role: \"zoom\",\n label: t(\"menu.zoom\"),\n },\n {\n type: \"separator\",\n },\n {\n role: \"front\",\n label: t(\"menu.front\"),\n },\n {\n label: \"Always on top\",\n type: \"checkbox\",\n checked: WindowManager.getMainWindow()?.isAlwaysOnTop(),\n click: () => {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) return\n mainWindow.setAlwaysOnTop(!mainWindow.isAlwaysOnTop())\n registerAppMenu()\n },\n },\n ],\n },\n {\n role: \"help\",\n label: t(\"menu.help\"),\n submenu: [\n {\n label: t(\"menu.openLogFile\"),\n click: async () => {\n await revealLogFile()\n },\n },\n ...(!isMAS\n ? [\n {\n label: t(\"menu.checkForUpdates\"),\n click: async () => {\n WindowManager.getMainWindow()?.show()\n await checkForAppUpdates()\n },\n },\n ]\n : []),\n ],\n },\n ]\n\n if (DEV) {\n menus.push({\n label: t(\"menu.debug\"),\n submenu: [\n {\n label: t(\"menu.followReleases\"),\n click: () => {\n WindowManager.createWindow({\n extraPath: `#add?url=${encodeURIComponent(\n \"https://github.com/RSSNext/follow/releases.atom\",\n )}`,\n width: 800,\n height: 600,\n })\n },\n },\n {\n type: \"normal\",\n label: t(\"menu.quitAndInstallUpdate\"),\n click() {\n quitAndInstall()\n },\n },\n ],\n })\n }\n Menu.setApplicationMenu(Menu.buildFromTemplate(menus))\n}\n" }, { "path": "apps/desktop/layer/main/src/modules/language-detection/index.ts", "content": "// @see https://github.dev/microsoft/vscode/blob/main/src/vs/workbench/services/languageDetection/browser/languageDetectionSimpleWorker.ts\nimport { createRequire } from \"node:module\"\n\nimport type { ModelResult } from \"vscode-languagedetection\"\nimport type vsld from \"vscode-languagedetection\"\n\nimport { logger } from \"~/logger\"\n\nconst expectedRelativeConfidence = 0.1\nconst positiveConfidenceCorrectionBucket1 = 0.05\nconst positiveConfidenceCorrectionBucket2 = 0.025\nconst negativeConfidenceCorrection = 0.5\n\nconst adjustLanguageConfidence = (modelResult: vsld.ModelResult): vsld.ModelResult => {\n switch (modelResult.languageId) {\n // For the following languages, we increase the confidence because\n // these are commonly used languages in VS Code and supported\n // by the model.\n case \"js\":\n case \"html\":\n case \"json\":\n case \"ts\":\n case \"css\":\n case \"py\":\n case \"xml\":\n case \"php\": {\n modelResult.confidence += positiveConfidenceCorrectionBucket1\n break\n }\n // case 'yaml': // YAML has been know to cause incorrect language detection because the language is pretty simple. We don't want to increase the confidence for this.\n case \"cpp\":\n case \"sh\":\n case \"java\":\n case \"cs\":\n case \"c\": {\n modelResult.confidence += positiveConfidenceCorrectionBucket2\n break\n }\n\n // For the following languages, we need to be extra confident that the language is correct because\n // we've had issues like #131912 that caused incorrect guesses. To enforce this, we subtract the\n // negativeConfidenceCorrection from the confidence.\n\n // languages that are provided by default in VS Code\n case \"bat\":\n case \"ini\":\n case \"makefile\":\n case \"sql\":\n case \"csv\":\n case \"toml\": {\n // Other considerations for negativeConfidenceCorrection that\n // aren't built in but suportted by the model include:\n // * Assembly, TeX - These languages didn't have clear language modes in the community\n // * Markdown, Dockerfile - These languages are simple but they embed other languages\n modelResult.confidence -= negativeConfidenceCorrection\n break\n }\n\n default: {\n break\n }\n }\n return modelResult\n}\nconst require = createRequire(import.meta.url)\n\nexport const detectCodeStringLanguage = async function* (codeString: string) {\n const { ModelOperations } =\n require(\"vscode-languagedetection\") as typeof import(\"vscode-languagedetection\")\n const modelOperations = new ModelOperations()\n const modelResults = await modelOperations.runModel(codeString)\n if (modelResults.length === 0) {\n logger.debug(\"no model results\", codeString)\n return\n }\n const firstModelResult = adjustLanguageConfidence(modelResults[0]!)\n if (firstModelResult.confidence < expectedRelativeConfidence) {\n logger.debug(\"first model result confidence is less than expected relative confidence\")\n return\n }\n\n const possibleLanguages: ModelResult[] = [firstModelResult]\n\n for (let current of modelResults) {\n if (current === firstModelResult) {\n continue\n }\n\n current = adjustLanguageConfidence(current)\n const currentHighest = possibleLanguages.at(-1)\n if (!currentHighest) {\n logger.debug(\"no current highest\")\n continue\n }\n\n if (currentHighest.confidence - current.confidence >= expectedRelativeConfidence) {\n while (possibleLanguages.length > 0) {\n yield possibleLanguages.shift()!\n }\n if (current.confidence > expectedRelativeConfidence) {\n possibleLanguages.push(current)\n continue\n }\n return\n } else {\n if (current.confidence > expectedRelativeConfidence) {\n possibleLanguages.push(current)\n continue\n }\n return\n }\n }\n\n return possibleLanguages\n}\n" }, { "path": "apps/desktop/layer/main/src/shims/utf-8-validate.cjs", "content": "\"use strict\"\n\nconst { isUtf8 } = require(\"node:buffer\")\n\nmodule.exports = function isValidUTF8(buffer) {\n if (typeof isUtf8 === \"function\") {\n return isUtf8(buffer)\n }\n\n try {\n new TextDecoder(\"utf-8\", { fatal: true }).decode(buffer)\n return true\n } catch {\n return false\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/updater/api.ts", "content": "import type {\n DistributionStatusPayload,\n GetLatestReleaseQuery,\n LatestReleasePayload,\n} from \"@follow-app/client-sdk\"\n\nimport { apiClient } from \"~/lib/api-client\"\n\nlet cachedLatestRelease: LatestReleasePayload | null = null\n\nexport const getUpdateInfo = async (\n query: GetLatestReleaseQuery = {},\n): Promise<LatestReleasePayload> => {\n const response = await apiClient.updates.getLatestRelease(query)\n cachedLatestRelease = response.data\n return cachedLatestRelease\n}\n\nexport const getDistributionUpdateInfo = async (): Promise<DistributionStatusPayload | null> => {\n const distribution = process.mas ? \"mas\" : process.windowsStore ? \"mss\" : undefined\n if (!distribution) {\n return null\n }\n const response = await apiClient.updates.getDistributionStatus({ distribution })\n return response.data\n}\n" }, { "path": "apps/desktop/layer/main/src/updater/configs.ts", "content": "import { DEV, MICROSOFT_STORE_BUILD, MODE, ModeEnum } from \"@follow/shared/constants\"\n\nconst isStoreDistribution = Boolean(process.mas || MICROSOFT_STORE_BUILD)\n\nexport const appUpdaterConfig = {\n // Disable renderer hot update will trigger app update when available\n enableRenderHotUpdate: !DEV && MODE !== ModeEnum.staging,\n enableCoreUpdate: !isStoreDistribution,\n\n // Disable app update will also disable renderer hot update and core update\n enableAppUpdate: true,\n enableDistributionStoreUpdate: isStoreDistribution,\n\n app: {\n autoCheckUpdate: true,\n autoDownloadUpdate: true,\n checkUpdateInterval: 15 * 60 * 1000,\n },\n}\n" }, { "path": "apps/desktop/layer/main/src/updater/follow-update-provider.ts", "content": "import { URL } from \"node:url\"\n\nimport type {\n AppUpdate,\n LatestReleasePayload,\n PlatformUpdate,\n PlatformUpdateFile,\n} from \"@follow-app/client-sdk\"\nimport type { UpdateFileInfo, UpdateInfo } from \"builder-util-runtime\"\nimport { newError } from \"builder-util-runtime\"\nimport type { AppUpdater } from \"electron-updater\"\nimport type { ProviderRuntimeOptions } from \"electron-updater/out/providers/Provider\"\nimport { Provider } from \"electron-updater/out/providers/Provider\"\nimport type { ResolvedUpdateFileInfo } from \"electron-updater/out/types\"\n\nimport { logger } from \"../logger\"\nimport { getUpdateInfo } from \"./api\"\n\ninterface FollowProviderOptions {\n provider: \"custom\"\n}\n\ntype FollowProviderContext = {\n payload: LatestReleasePayload\n platform: PlatformUpdate\n}\n\nexport class FollowUpdateProvider extends Provider<UpdateInfo> {\n private static context: FollowProviderContext | null = null\n\n static setContext(context: FollowProviderContext) {\n FollowUpdateProvider.context = context\n }\n\n static clearContext() {\n FollowUpdateProvider.context = null\n }\n\n static getContext() {\n return FollowUpdateProvider.context\n }\n\n constructor(\n _options: FollowProviderOptions,\n _updater: AppUpdater,\n runtimeOptions: ProviderRuntimeOptions,\n ) {\n super(runtimeOptions)\n }\n\n async getLatestVersion(): Promise<UpdateInfo> {\n const context = await this.ensureContext()\n return this.buildUpdateInfo(context)\n }\n\n resolveFiles(updateInfo: UpdateInfo): Array<ResolvedUpdateFileInfo> {\n return updateInfo.files.map((file) => ({\n info: file,\n url: new URL(file.url),\n }))\n }\n\n private buildUpdateInfo(context: FollowProviderContext): UpdateInfo {\n const { payload, platform } = context\n const files = this.mapFiles(platform.files)\n\n if (files.length === 0) {\n throw newError(\n `No downloadable files found for platform ${platform.platform}`,\n \"ERR_UPDATER_CHANNEL_FILE_NOT_FOUND\",\n )\n }\n\n const primaryFile = files[0]\n if (!primaryFile) {\n throw newError(\n `Platform ${platform.platform} provides no downloadable file`,\n \"ERR_UPDATER_CHANNEL_FILE_NOT_FOUND\",\n )\n }\n\n let primaryPath = primaryFile.url\n const primaryUrl = this.safeParseUrl(primaryFile.url)\n if (primaryUrl) {\n const filename = primaryUrl.pathname.split(\"/\").pop()\n if (filename) {\n primaryPath = filename\n }\n }\n\n const { release } = payload\n\n return {\n version: platform.version,\n files,\n path: primaryPath,\n sha512: primaryFile.sha512,\n releaseName: release.name,\n releaseNotes: release.body,\n releaseDate: platform.releaseDate || release.publishedAt || new Date().toISOString(),\n }\n }\n\n private mapFiles(files: PlatformUpdate[\"files\"]): UpdateFileInfo[] {\n if (!files) return []\n\n return files\n .map((file) => this.mapFile(file))\n .filter((file): file is UpdateFileInfo => file !== null)\n }\n\n private mapFile(file: PlatformUpdateFile): UpdateFileInfo | null {\n if (!file.downloadUrl || !file.sha512) {\n logger.warn(\"Skip platform file without downloadUrl or sha512\", file)\n return null\n }\n\n const mapped: UpdateFileInfo = {\n url: file.downloadUrl,\n sha512: file.sha512,\n }\n\n if (typeof file.size === \"number\") {\n mapped.size = file.size\n }\n\n return mapped\n }\n\n private safeParseUrl(value: string): URL | null {\n try {\n return new URL(value)\n } catch (error) {\n logger.debug?.(\"Unable to parse update file URL\", error)\n return null\n }\n }\n\n private async ensureContext(): Promise<FollowProviderContext> {\n const context = FollowUpdateProvider.getContext()\n if (context) return context\n\n const fetched = await this.fetchContext()\n FollowUpdateProvider.setContext(fetched)\n return fetched\n }\n\n private async fetchContext(): Promise<FollowProviderContext> {\n const payload = await getUpdateInfo({})\n const { decision } = payload\n\n if (!decision || decision.type !== \"app\" || !decision.app) {\n throw newError(\n \"No app update metadata available from provider\",\n \"ERR_UPDATER_NO_PUBLISHED_VERSIONS\",\n )\n }\n\n const platform = this.pickPlatform(decision.app)\n if (!platform) {\n throw newError(\n `No matching platform update for ${process.platform}/${process.arch}`,\n \"ERR_UPDATER_CHANNEL_FILE_NOT_FOUND\",\n )\n }\n\n return { payload, platform }\n }\n\n private pickPlatform(appDecision: AppUpdate): PlatformUpdate | null {\n const platforms = appDecision.platforms ?? []\n const selected = appDecision.selectedPlatform\n if (selected) {\n return selected\n }\n\n const candidates = this.resolvePlatformCandidates()\n const matched = platforms.find((platform) =>\n candidates.includes(platform.platform.toLowerCase()),\n )\n\n return matched ?? platforms[0] ?? null\n }\n\n private resolvePlatformCandidates(): string[] {\n const base = new Set<string>()\n base.add(process.platform)\n base.add(`${process.platform}-${process.arch}`)\n base.add(process.arch)\n\n if (process.platform === \"darwin\") {\n base.add(\"mac\")\n base.add(\"macos\")\n }\n\n if (process.platform === \"win32\") {\n base.add(\"windows\")\n base.add(\"win\")\n }\n\n return Array.from(base).map((value) => value.toLowerCase())\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/updater/hot-updater.ts", "content": "import { existsSync, readFileSync } from \"node:fs\"\nimport { mkdir, readdir, rename, rm, stat, writeFile } from \"node:fs/promises\"\nimport os from \"node:os\"\n\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport type { LatestReleasePayload, RendererUpdate } from \"@follow-app/client-sdk\"\nimport { mainHash, version as appVersion } from \"@pkg\"\nimport log from \"electron-log\"\nimport { dump, load } from \"js-yaml\"\nimport path from \"pathe\"\nimport { x } from \"tar\"\n\nimport { HOTUPDATE_RENDER_ENTRY_DIR } from \"~/constants/app\"\nimport { downloadFileWithProgress } from \"~/lib/download\"\nimport { WindowManager } from \"~/manager/window\"\n\nimport { appUpdaterConfig } from \"./configs\"\n\ndeclare const GIT_COMMIT_HASH: string | undefined\n\nexport type RendererManifest = RendererUpdate & {\n downloadUrl: string\n downloadedAt?: string\n}\n\nexport enum RendererEligibilityStatus {\n NoManifest,\n RequiresFullAppUpdate,\n AlreadyCurrent,\n Eligible,\n}\n\nexport interface RendererEligibilityResult {\n status: RendererEligibilityStatus\n manifest?: RendererManifest\n reason?: string\n}\n\nclass RendererHotUpdater {\n private readonly logger = log.scope(\"updater:renderer\")\n private readonly tempDir = path.resolve(os.tmpdir(), \"follow-render-update\")\n private readonly manifestPath = path.resolve(HOTUPDATE_RENDER_ENTRY_DIR, \"manifest.yml\")\n\n extractManifest(payload: LatestReleasePayload | null): RendererManifest | null {\n if (!payload) return null\n\n const { decision } = payload\n if (!decision || decision.type !== \"renderer\") {\n return null\n }\n\n return this.toManifest(decision.renderer)\n }\n\n extractManifestFromRendererUpdate(renderer: RendererUpdate | null): RendererManifest | null {\n return this.toManifest(renderer)\n }\n\n evaluateManifest(manifest: RendererManifest | null): RendererEligibilityResult {\n if (!manifest) {\n return { status: RendererEligibilityStatus.NoManifest }\n }\n\n if (manifest.mainHash && manifest.mainHash !== mainHash) {\n return {\n status: RendererEligibilityStatus.RequiresFullAppUpdate,\n manifest,\n reason: `Renderer payload requires main hash ${manifest.mainHash}, current main hash is ${mainHash}`,\n }\n }\n\n if (manifest.version === appVersion) {\n return {\n status: RendererEligibilityStatus.AlreadyCurrent,\n reason: \"Renderer version matches current app version\",\n }\n }\n\n if (manifest.commit && GIT_COMMIT_HASH && manifest.commit === GIT_COMMIT_HASH) {\n return {\n status: RendererEligibilityStatus.AlreadyCurrent,\n reason: \"Renderer commit matches current main commit\",\n }\n }\n\n const installedManifest = this.getCurrentManifest()\n if (installedManifest) {\n if (installedManifest.version === manifest.version) {\n return {\n status: RendererEligibilityStatus.AlreadyCurrent,\n reason: \"Installed renderer manifest already at target version\",\n }\n }\n\n if (\n installedManifest.commit &&\n manifest.commit &&\n installedManifest.commit === manifest.commit\n ) {\n return {\n status: RendererEligibilityStatus.AlreadyCurrent,\n reason: \"Installed renderer manifest commit matches target commit\",\n }\n }\n }\n\n return {\n status: RendererEligibilityStatus.Eligible,\n manifest,\n }\n }\n\n private toManifest(renderer: RendererUpdate | null): RendererManifest | null {\n if (!renderer) {\n this.logger.debug(\"Renderer decision payload missing renderer field\")\n return null\n }\n\n if (!renderer.downloadUrl) {\n this.logger.warn(\"Renderer decision missing downloadUrl, skip renderer hot update\")\n return null\n }\n\n if (!renderer.filename) {\n this.logger.warn(\"Renderer decision missing filename, skip renderer hot update\")\n return null\n }\n\n if (!renderer.hash) {\n this.logger.warn(\"Renderer decision missing hash, skip renderer hot update\")\n return null\n }\n\n return {\n ...renderer,\n downloadUrl: renderer.downloadUrl,\n }\n }\n\n async applyManifest(manifest: RendererManifest): Promise<void> {\n if (!appUpdaterConfig.enableRenderHotUpdate) {\n this.logger.info(\"Renderer hot update skipped because it is disabled in config\")\n return\n }\n\n const archivePath = await this.downloadArchive(manifest)\n\n await mkdir(HOTUPDATE_RENDER_ENTRY_DIR, { recursive: true })\n this.logger.info(`Extracting renderer bundle to ${HOTUPDATE_RENDER_ENTRY_DIR}`)\n\n await x({\n f: archivePath,\n cwd: HOTUPDATE_RENDER_ENTRY_DIR,\n })\n\n const extractedDir = path.resolve(HOTUPDATE_RENDER_ENTRY_DIR, \"renderer\")\n const targetDir = path.resolve(HOTUPDATE_RENDER_ENTRY_DIR, manifest.version)\n\n const extractedStats = await stat(extractedDir).catch(() => null)\n if (!extractedStats) {\n throw new Error(`Extracted renderer directory not found at ${extractedDir}`)\n }\n\n await rm(targetDir, { recursive: true, force: true })\n await rename(extractedDir, targetDir)\n\n await this.writeManifest({ ...manifest, downloadedAt: new Date().toISOString() })\n\n try {\n await rm(archivePath, { force: true })\n } catch (error) {\n this.logger.warn(\"Failed to clean renderer archive\", error)\n }\n\n this.logger.info(`Renderer hot update applied successfully: ${manifest.version}`)\n\n const mainWindow = WindowManager.getMainWindow()\n if (mainWindow) {\n callWindowExpose(mainWindow).readyToUpdate()\n }\n }\n\n getCurrentManifest(): RendererManifest | null {\n if (!existsSync(this.manifestPath)) {\n return null\n }\n\n try {\n const content = readFileSync(this.manifestPath, \"utf-8\")\n const parsed = load(content)\n if (parsed && typeof parsed === \"object\") {\n return parsed as RendererManifest\n }\n } catch (error) {\n this.logger.warn(\"Failed to read renderer manifest from disk\", error)\n }\n\n return null\n }\n\n async cleanup(): Promise<void> {\n const manifest = this.getCurrentManifest()\n if (!manifest) {\n await rm(HOTUPDATE_RENDER_ENTRY_DIR, { recursive: true, force: true })\n return\n }\n\n const keepDir = path.resolve(HOTUPDATE_RENDER_ENTRY_DIR, manifest.version)\n let entries: string[] = []\n\n try {\n entries = await readdir(HOTUPDATE_RENDER_ENTRY_DIR)\n } catch (error) {\n this.logger.warn(\"Failed to read renderer directory for cleanup\", error)\n return\n }\n\n await Promise.all(\n entries.map(async (entryName) => {\n const entryPath = path.resolve(HOTUPDATE_RENDER_ENTRY_DIR, entryName)\n const entryStat = await stat(entryPath).catch(() => null)\n if (!entryStat?.isDirectory()) return\n if (entryPath === keepDir) return\n await rm(entryPath, { recursive: true, force: true })\n }),\n )\n }\n\n loadDynamicEntry() {\n if (!appUpdaterConfig.enableRenderHotUpdate) return\n\n const manifest = this.getCurrentManifest()\n if (!manifest) return\n if (manifest.mainHash && manifest.mainHash !== mainHash) return\n\n const dir = path.resolve(HOTUPDATE_RENDER_ENTRY_DIR, manifest.version)\n const entryFile = path.resolve(dir, \"index.html\")\n if (!existsSync(entryFile)) return\n\n return entryFile\n }\n\n private async downloadArchive(manifest: RendererManifest) {\n const archivePath = path.resolve(this.tempDir, manifest.filename)\n\n this.logger.info(\n `Downloading renderer bundle ${manifest.filename} from ${manifest.downloadUrl}`,\n )\n\n const success = await downloadFileWithProgress({\n url: manifest.downloadUrl,\n outputPath: archivePath,\n expectedHash: manifest.hash,\n onLog: (message) => this.logger.info(message),\n })\n\n if (!success) {\n throw new Error(\"Failed to download renderer bundle\")\n }\n\n return archivePath\n }\n\n private async writeManifest(manifest: RendererManifest) {\n await writeFile(this.manifestPath, dump(manifest), \"utf-8\")\n }\n}\n\nexport const rendererUpdater = new RendererHotUpdater()\n\nexport const getCurrentRendererManifest = () => rendererUpdater.getCurrentManifest()\n\nexport const cleanupOldRenderer = async () => {\n await rendererUpdater.cleanup()\n}\n\nexport const cleanupOldRender = cleanupOldRenderer\n\nexport const loadDynamicRenderEntry = () => rendererUpdater.loadDynamicEntry()\n" }, { "path": "apps/desktop/layer/main/src/updater/index.ts", "content": "import { fileURLToPath } from \"node:url\"\n\nimport { callWindowExpose } from \"@follow/shared/bridge\"\nimport { DEV } from \"@follow/shared/constants\"\nimport type {\n DistributionStatusPayload,\n LatestReleasePayload,\n PlatformUpdate,\n RendererUpdate,\n} from \"@follow-app/client-sdk\"\nimport { mainHash, version as appVersion } from \"@pkg\"\nimport log from \"electron-log\"\nimport type { AppUpdater } from \"electron-updater\"\nimport { autoUpdater as defaultAutoUpdater } from \"electron-updater\"\nimport { join } from \"pathe\"\nimport { gt, valid as isValidSemver } from \"semver\"\n\nimport { WindowManager } from \"~/manager/window\"\nimport type { RendererManifest } from \"~/updater/hot-updater\"\nimport { RendererEligibilityStatus, rendererUpdater } from \"~/updater/hot-updater\"\n\nimport { channel, isWindows } from \"../env\"\nimport { getDistributionUpdateInfo, getUpdateInfo } from \"./api\"\nimport { appUpdaterConfig } from \"./configs\"\nimport { FollowUpdateProvider } from \"./follow-update-provider\"\nimport { WindowsUpdater } from \"./windows-updater\"\n\nconst logger = log.scope(\"app-updater\")\ntype UpdateCheckOptions = {\n refresh?: boolean\n}\n\ntype UpdateCheckResult = {\n hasUpdate: boolean\n error?: string\n}\n\nclass FollowUpdater {\n private readonly disabled: boolean\n private checkingUpdate = false\n private downloadingUpdate = false\n\n private pollingTimer: NodeJS.Timeout | null = null\n\n constructor(\n private readonly autoUpdater: AppUpdater,\n private readonly renderer = rendererUpdater,\n ) {\n this.disabled = !appUpdaterConfig.enableAppUpdate\n }\n\n register() {\n if (this.disabled) {\n logger.info(\"App auto-update disabled; updater not registered\")\n return\n }\n\n this.autoUpdater.autoDownload = false\n this.autoUpdater.allowPrerelease = channel !== \"stable\"\n this.autoUpdater.autoInstallOnAppQuit = true\n this.autoUpdater.autoRunAppAfterInstall = true\n this.autoUpdater.forceDevUpdateConfig = DEV\n\n if (import.meta.env.DEV) {\n const __dirname = fileURLToPath(new URL(\".\", import.meta.url))\n this.autoUpdater.updateConfigPath = join(__dirname, \"../../dev-only/dev-app-update.yml\")\n }\n\n this.autoUpdater.setFeedURL({\n provider: \"custom\",\n updateProvider: FollowUpdateProvider,\n })\n\n this.registerAutoUpdaterEvents()\n\n if (appUpdaterConfig.app.autoCheckUpdate) {\n logger.info(\"Initial update check, mainHash:\", mainHash)\n void this.checkForUpdates().catch((error) =>\n logger.error(\"Initial update check failed\", error),\n )\n }\n\n if (this.pollingTimer) {\n clearInterval(this.pollingTimer)\n }\n\n const updatePollingHandler = async () => {\n if (!appUpdaterConfig.app.autoCheckUpdate) {\n return\n }\n\n void this.checkForUpdates().catch((error) => {\n logger.error(\"Scheduled update check failed\", error)\n })\n }\n updatePollingHandler()\n this.pollingTimer = setInterval(updatePollingHandler, appUpdaterConfig.app.checkUpdateInterval)\n }\n\n async checkForUpdates(options: UpdateCheckOptions = {}): Promise<UpdateCheckResult> {\n if (this.disabled) {\n return { hasUpdate: false }\n }\n\n if (this.checkingUpdate) {\n logger.info(\"Update check already in progress, skipping\")\n return { hasUpdate: false }\n }\n\n this.checkingUpdate = true\n\n try {\n if (appUpdaterConfig.enableDistributionStoreUpdate) {\n logger.info(\"Distribution store update enabled, checking for distribution update\")\n return this.handleDistributionAppDecision()\n }\n\n const payload = await getUpdateInfo(options.refresh ? { refresh: true } : {})\n\n return this.handleDirectAppDecision(payload)\n } catch (error) {\n logger.error(\"Failed to check for updates\", error)\n return { hasUpdate: false, error: error instanceof Error ? error.message : \"Unknown error\" }\n } finally {\n this.checkingUpdate = false\n }\n }\n\n async handleDirectAppDecision(payload: LatestReleasePayload): Promise<UpdateCheckResult> {\n const { decision } = payload\n\n if (!decision || decision.type === \"none\") {\n logger.info(\"Update decision: none\")\n return { hasUpdate: false }\n }\n\n if (decision.type === \"renderer\") {\n logger.info(\"Update decision: renderer\")\n return await this.handleRendererDecision(payload)\n }\n\n if (decision.type === \"app\") {\n logger.info(\"Update decision: app\")\n return await this.handleAppDecision(payload)\n }\n\n logger.warn(\"Unknown update decision type\", { type: decision.type })\n return { hasUpdate: false }\n }\n\n async downloadAppUpdate(): Promise<void> {\n if (this.disabled || this.downloadingUpdate) {\n return\n }\n\n this.downloadingUpdate = true\n\n try {\n await this.autoUpdater.downloadUpdate()\n logger.info(\"App update download requested\")\n } catch (error) {\n this.downloadingUpdate = false\n logger.error(\"Failed to download app update\", error)\n throw error\n }\n }\n\n quitAndInstall() {\n const mainWindow = WindowManager.getMainWindow()\n logger.info(\"Quit and install triggered\", { windowId: mainWindow?.id })\n WindowManager.destroyMainWindow()\n\n setTimeout(() => {\n logger.info(\"Main window closed, quitting to install update\")\n this.autoUpdater.quitAndInstall()\n }, 1000)\n }\n\n private resolvePlatformCandidates() {\n const base = new Set<string>()\n base.add(process.platform)\n base.add(`${process.platform}-${process.arch}`)\n base.add(process.arch)\n\n if (process.platform === \"darwin\") {\n base.add(\"mac\")\n base.add(\"macos\")\n }\n\n if (process.platform === \"win32\") {\n base.add(\"windows\")\n base.add(\"win\")\n }\n\n return Array.from(base).map((value) => value.toLowerCase())\n }\n\n private pickPlatformUpdate(\n platforms: PlatformUpdate[] | null | undefined,\n selected?: PlatformUpdate | null,\n ): PlatformUpdate | null {\n if (!platforms || platforms.length === 0) {\n return null\n }\n\n if (selected) {\n return selected\n }\n\n const candidates = this.resolvePlatformCandidates()\n\n const matched = platforms.find((platform) =>\n candidates.includes(platform.platform.toLowerCase()),\n )\n\n return matched ?? platforms[0] ?? null\n }\n\n private async handleAppDecision(payload: LatestReleasePayload): Promise<UpdateCheckResult> {\n const appDecision = payload.decision.app\n\n if (!appUpdaterConfig.enableCoreUpdate) {\n logger.info(\"Core app update disabled by configuration\")\n return { hasUpdate: false }\n }\n\n if (!appDecision) {\n logger.warn(\"App update decision missing app payload\")\n return { hasUpdate: false, error: \"App update metadata unavailable\" }\n }\n\n const platformUpdate = this.pickPlatformUpdate(\n appDecision.platforms,\n appDecision.selectedPlatform,\n )\n if (!platformUpdate) {\n logger.warn(\"No matching platform update found\", {\n platform: process.platform,\n arch: process.arch,\n })\n return { hasUpdate: false, error: \"No installer available for this platform\" }\n }\n\n FollowUpdateProvider.setContext({ payload, platform: platformUpdate })\n logger.info(\"FollowUpdateProvider context set\", { platform: platformUpdate.platform })\n\n try {\n await this.autoUpdater.checkForUpdates()\n } catch (error) {\n logger.warn(\n \"autoUpdater.checkForUpdates failed after preparing FollowUpdateProvider context\",\n error,\n )\n return {\n hasUpdate: false,\n error: error instanceof Error ? error.message : \"Failed to check app update\",\n }\n } finally {\n FollowUpdateProvider.clearContext()\n }\n\n return { hasUpdate: true }\n }\n\n private async handleDistributionAppDecision(): Promise<UpdateCheckResult> {\n try {\n if (!appUpdaterConfig.enableDistributionStoreUpdate) {\n return { hasUpdate: false }\n }\n\n const info = await getDistributionUpdateInfo()\n\n if (!info) {\n logger.info(\n \"Distribution update info unavailable for current build, falling back to direct app decision\",\n )\n const payload = await getUpdateInfo()\n return this.handleDirectAppDecision(payload)\n }\n\n const rendererResult = await this.tryDistributionRendererUpdate(info.rendererUpdate)\n if (rendererResult) {\n return rendererResult\n }\n\n if (!this.shouldPromptDistributionStoreUpdate(info)) {\n logger.info(\"Distribution update does not require store action\")\n return { hasUpdate: false }\n }\n\n logger.info(\"Distribution store update required\")\n return await this.notifyDistributionUpdate(info)\n } catch (error) {\n logger.error(\"Failed to handle distribution app update\", error)\n return {\n hasUpdate: false,\n error: error instanceof Error ? error.message : \"Failed to handle distribution update\",\n }\n }\n }\n\n private async tryDistributionRendererUpdate(\n renderer: RendererUpdate | null,\n ): Promise<UpdateCheckResult | null> {\n if (!renderer) {\n return null\n }\n\n if (!appUpdaterConfig.enableRenderHotUpdate) {\n logger.info(\"Renderer hot update disabled for distribution build\")\n return null\n }\n\n const manifest = this.renderer.extractManifestFromRendererUpdate(renderer)\n if (!manifest) {\n logger.warn(\"Distribution renderer update missing manifest\")\n return null\n }\n\n const eligibility = this.renderer.evaluateManifest(manifest)\n\n switch (eligibility.status) {\n case RendererEligibilityStatus.NoManifest: {\n if (eligibility.reason) {\n logger.warn(\"Distribution renderer update missing manifest data\", {\n reason: eligibility.reason,\n })\n }\n return null\n }\n\n case RendererEligibilityStatus.AlreadyCurrent: {\n if (eligibility.reason) {\n logger.info(eligibility.reason)\n }\n return { hasUpdate: false }\n }\n\n case RendererEligibilityStatus.RequiresFullAppUpdate: {\n logger.info(\n eligibility.reason ??\n \"Renderer payload requires main process update, delegating to distribution store flow\",\n )\n return null\n }\n\n case RendererEligibilityStatus.Eligible: {\n const manifestToApply = eligibility.manifest as RendererManifest | undefined\n if (!manifestToApply) {\n logger.warn(\"Distribution renderer update missing manifest payload\")\n return null\n }\n\n try {\n await this.renderer.applyManifest(manifestToApply)\n return { hasUpdate: true }\n } catch (error) {\n logger.error(\"Renderer hot update failed for distribution build\", error)\n return {\n hasUpdate: false,\n error: error instanceof Error ? error.message : \"Renderer hot update failed\",\n }\n }\n }\n\n default: {\n return null\n }\n }\n }\n\n private shouldPromptDistributionStoreUpdate(info: DistributionStatusPayload): boolean {\n if (!info.storeUrl) {\n logger.info(\"Distribution store update skipped: missing store URL\", {\n distribution: info.distribution,\n })\n return false\n }\n\n const { storeVersion } = info\n\n const currentVersion = appVersion\n\n if (!storeVersion) {\n logger.info(\"Distribution store update skipped: missing store version\")\n return false\n }\n\n if (!currentVersion) {\n return true\n }\n\n const storeValid = isValidSemver(storeVersion)\n const currentValid = isValidSemver(currentVersion)\n\n if (storeValid && currentValid) {\n const needsUpdate = gt(storeVersion, currentVersion)\n if (!needsUpdate) {\n logger.info(\"Distribution store version matches current version\", {\n storeVersion,\n currentVersion,\n })\n }\n return needsUpdate\n }\n\n if (storeVersion === currentVersion) {\n logger.info(\"Distribution store version identical to current version\", {\n storeVersion,\n currentVersion,\n })\n return false\n }\n\n return true\n }\n\n private async notifyDistributionUpdate(\n info: DistributionStatusPayload,\n ): Promise<UpdateCheckResult> {\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) {\n logger.warn(\"Main window unavailable when notifying distribution update\")\n return { hasUpdate: true }\n }\n\n if (!info.storeUrl) {\n logger.warn(\"Distribution update missing store URL\", {\n distribution: info.distribution,\n })\n return { hasUpdate: false }\n }\n\n await callWindowExpose(mainWindow).distributionUpdateAvailable({\n distribution: info.distribution,\n storeUrl: info.storeUrl,\n storeVersion: info.storeVersion ?? null,\n currentVersion: appVersion,\n })\n\n return { hasUpdate: true }\n }\n\n private async handleRendererDecision(payload: LatestReleasePayload): Promise<UpdateCheckResult> {\n if (!appUpdaterConfig.enableRenderHotUpdate) {\n logger.info(\"Renderer hot update disabled; falling back to app decision if present\")\n if (payload.decision.app) {\n return this.handleAppDecision(payload)\n }\n return { hasUpdate: false }\n }\n\n const manifest = this.renderer.extractManifest(payload)\n const eligibility = this.renderer.evaluateManifest(manifest)\n\n switch (eligibility.status) {\n case RendererEligibilityStatus.NoManifest: {\n return { hasUpdate: false, error: eligibility.reason }\n }\n\n case RendererEligibilityStatus.AlreadyCurrent: {\n if (eligibility.reason) {\n logger.info(eligibility.reason)\n }\n return { hasUpdate: false }\n }\n\n case RendererEligibilityStatus.RequiresFullAppUpdate: {\n logger.info(\n eligibility.reason,\n\n \"Renderer payload requires main process update, delegating to app updater\",\n )\n if (payload.decision.app) {\n return this.handleAppDecision(payload)\n }\n logger.warn(\"Renderer update requested full app upgrade but no app payload provided\")\n return { hasUpdate: false, error: \"Renderer update requires full app upgrade\" }\n }\n\n case RendererEligibilityStatus.Eligible: {\n const manifestToApply = eligibility.manifest as RendererManifest | undefined\n if (!manifestToApply) {\n return { hasUpdate: false }\n }\n\n try {\n await this.renderer.applyManifest(manifestToApply)\n return { hasUpdate: true }\n } catch (error) {\n logger.error(\"Renderer hot update failed\", error)\n return {\n hasUpdate: false,\n error: error instanceof Error ? error.message : \"Renderer hot update failed\",\n }\n }\n }\n\n default: {\n return { hasUpdate: false }\n }\n }\n }\n\n private registerAutoUpdaterEvents() {\n this.autoUpdater.on(\"checking-for-update\", () => {\n logger.info(\"autoUpdater: checking for update\")\n })\n\n this.autoUpdater.on(\"update-available\", (info) => {\n logger.info(\"autoUpdater: update available\", info)\n\n if (appUpdaterConfig.app.autoDownloadUpdate && appUpdaterConfig.enableCoreUpdate) {\n void this.downloadAppUpdate().catch((error) =>\n logger.error(\"Automatic download failed\", error),\n )\n }\n })\n\n this.autoUpdater.on(\"update-not-available\", (info) => {\n logger.info(\"autoUpdater: update not available\", info)\n })\n\n this.autoUpdater.on(\"download-progress\", (progress) => {\n logger.info(`autoUpdater: download progress ${progress.percent.toFixed(2)}%`)\n })\n\n this.autoUpdater.on(\"update-downloaded\", (ev) => {\n this.downloadingUpdate = false\n logger.info(\"autoUpdater: update downloaded\", ev.downloadedFile, ev.version)\n\n const mainWindow = WindowManager.getMainWindow()\n if (!mainWindow) return\n\n callWindowExpose(mainWindow).updateDownloaded()\n })\n\n this.autoUpdater.on(\"error\", (error) => {\n logger.error(\"autoUpdater: error\", error)\n })\n }\n}\n\nconst autoUpdater = isWindows ? new WindowsUpdater() : defaultAutoUpdater\nconst followUpdater = new FollowUpdater(autoUpdater)\n\nexport const registerUpdater = () => {\n followUpdater.register()\n}\n\nexport const checkForAppUpdates = (options: UpdateCheckOptions = {}) =>\n followUpdater.checkForUpdates(options)\n\nexport const quitAndInstall = () => followUpdater.quitAndInstall()\n" }, { "path": "apps/desktop/layer/main/src/updater/logger.ts", "content": "import log from \"electron-log\"\n\n/**\n * Logger for updater module with scoped prefix\n * All logs are prefixed with [Updater] for easy identification\n */\nexport const updaterLogger = log.scope(\"updater\")\n\n/**\n * Logger specifically for GitHub provider operations\n */\nexport const githubProviderLogger = log.scope(\"updater:github\")\n\n/**\n * Helper to log object properties in a formatted way\n */\nexport function logObject(logger: typeof updaterLogger, prefix: string, obj: Record<string, any>) {\n logger.info(`${prefix}:`)\n for (const [key, value] of Object.entries(obj)) {\n logger.info(` ${key}: ${value}`)\n }\n}\n" }, { "path": "apps/desktop/layer/main/src/updater/windows-updater.ts", "content": "import { app } from \"electron\"\nimport { NsisUpdater } from \"electron-updater\"\nimport { DownloadedUpdateHelper } from \"electron-updater/out/DownloadedUpdateHelper\"\n\nexport class WindowsUpdater extends NsisUpdater {\n protected override downloadedUpdateHelper: DownloadedUpdateHelper = new DownloadedUpdateHelper(\n app.getPath(\"sessionData\"),\n )\n}\n" }, { "path": "apps/desktop/layer/main/tsconfig.json", "content": "{\n \"extends\": \"@electron-toolkit/tsconfig/tsconfig.node.json\",\n \"compilerOptions\": {\n \"composite\": true,\n \"outDir\": \"dist\",\n \"types\": [\"electron-vite/node\", \"@follow/types/vite\", \"@follow/types/global\"],\n \"moduleResolution\": \"Bundler\",\n \"noImplicitReturns\": false,\n \"noUnusedLocals\": false,\n \"noUnusedParameters\": false,\n \"noUncheckedIndexedAccess\": true,\n \"noImplicitOverride\": true,\n \"experimentalDecorators\": true,\n \"baseUrl\": \".\",\n \"paths\": {\n \"@pkg\": [\"../../package.json\"],\n \"@locales/*\": [\"../../../../locales/*\"],\n \"~/*\": [\"./src/*\"]\n }\n }\n}\n" }, { "path": "apps/desktop/layer/main/vitest.config.ts", "content": "import { fileURLToPath } from \"node:url\"\n\nimport tsconfigPath from \"vite-tsconfig-paths\"\nimport { defineProject } from \"vitest/config\"\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url))\n\nexport default defineProject({\n root: \"./\",\n test: {\n globals: true,\n environment: \"node\",\n },\n\n plugins: [\n tsconfigPath({\n projects: [\"./tsconfig.json\"],\n }),\n ],\n})\n" }, { "path": "apps/desktop/layer/renderer/debug_proxy.html", "content": "<!doctype html>\n<html lang=\"en\">\n <head>\n <title>Debug Proxy\n\n \n \n \n\n" }, { "path": "apps/desktop/layer/renderer/global.d.ts", "content": "import type { ElectronAPI } from \"@electron-toolkit/preload\"\n\ndeclare global {\n interface Window {\n electron?: ElectronAPI\n api?: { canWindowBlur: boolean; isWindowsStore: boolean }\n platform: NodeJS.Platform\n }\n export const APP_NAME = \"Folo\"\n}\n\ndeclare module \"virtual:pwa-register/react\" {\n import type { Dispatch, SetStateAction } from \"react\"\n import type { RegisterSWOptions } from \"vite-plugin-pwa/types\"\n\n export function useRegisterSW(options?: RegisterSWOptions): {\n needRefresh: [boolean, Dispatch>]\n offlineReady: [boolean, Dispatch>]\n updateServiceWorker: (reloadPage?: boolean) => Promise\n }\n}\n\nexport {}\n\nexport { type RegisterSWOptions } from \"vite-plugin-pwa/types\"\n" }, { "path": "apps/desktop/layer/renderer/index.html", "content": "\n\n \n \n \n \n\n \n \n \n \n \n \n \n \n\n Folo - AI Reader | Follow Everything\n \n \n \n \n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n\n \n \n \n \n\n \n \n \n \n
\n\n
\n \n \n
\n
\n
\n
\n
\n\n \n \n\n" }, { "path": "apps/desktop/layer/renderer/package.json", "content": "{\n \"name\": \"@follow/web\",\n \"type\": \"module\",\n \"private\": true,\n \"main\": \"./dist/main/index.js\",\n \"scripts\": {\n \"build:web\": \"cd ../.. && pnpm build:web\",\n \"db:generate\": \"pnpm --filter @follow/database run generate\",\n \"dev\": \"cd ../.. && pnpm dev:web\",\n \"dev:ssl\": \"cd ../.. && SSL=true pnpm dev:web\",\n \"generate-pwa-assets\": \"pwa-assets-generator public/icon.svg\",\n \"test\": \"vitest --typecheck\",\n \"typecheck\": \"tsc --noEmit\"\n },\n \"dependencies\": {\n \"@dnd-kit/core\": \"6.3.1\",\n \"@dnd-kit/sortable\": \"10.0.0\",\n \"@electron-toolkit/preload\": \"3.0.2\",\n \"@follow-app/client-sdk\": \"catalog:\",\n \"@follow/database\": \"workspace:*\",\n \"@follow/electron-main\": \"workspace:*\",\n \"@follow/shared\": \"workspace:*\",\n \"@follow/store\": \"workspace:*\",\n \"@follow/tracker\": \"workspace:*\",\n \"@fontsource/sn-pro\": \"5.2.6\",\n \"@headlessui/react\": \"2.2.9\",\n \"@hookform/resolvers\": \"5.2.2\",\n \"@lexical/markdown\": \"0.40.0\",\n \"@lexical/react\": \"0.40.0\",\n \"@number-flow/react\": \"0.5.11\",\n \"@radix-ui/react-avatar\": \"1.1.11\",\n \"@radix-ui/react-context-menu\": \"2.2.16\",\n \"@radix-ui/react-dialog\": \"1.1.15\",\n \"@radix-ui/react-dropdown-menu\": \"2.1.16\",\n \"@radix-ui/react-hover-card\": \"1.1.15\",\n \"@radix-ui/react-label\": \"2.1.8\",\n \"@radix-ui/react-popover\": \"1.1.15\",\n \"@radix-ui/react-slider\": \"1.3.6\",\n \"@radix-ui/react-slot\": \"1.2.4\",\n \"@shikijs/transformers\": \"3.22.0\",\n \"@splinetool/react-spline\": \"4.1.0\",\n \"@tanstack/query-sync-storage-persister\": \"5.90.22\",\n \"@tanstack/react-query\": \"5.90.21\",\n \"@tanstack/react-query-devtools\": \"5.91.3\",\n \"@tanstack/react-query-persist-client\": \"5.90.22\",\n \"@tanstack/react-virtual\": \"3.13.18\",\n \"@toon-format/toon\": \"2.1.0\",\n \"@use-gesture/react\": \"10.3.1\",\n \"@welldone-software/why-did-you-render\": \"10.0.1\",\n \"@xyflow/react\": \"12.10.0\",\n \"@yornaath/batshit\": \"0.14.0\",\n \"ai\": \"6.0.85\",\n \"camelcase-keys\": \"10.0.2\",\n \"chrono-node\": \"2.9.0\",\n \"class-variance-authority\": \"0.7.1\",\n \"clsx\": \"2.1.1\",\n \"cmdk\": \"1.1.1\",\n \"cookie-es\": \"2.0.0\",\n \"dayjs\": \"1.11.19\",\n \"dnum\": \"2.17.0\",\n \"electron-ipc-decorator\": \"0.2.0\",\n \"embla-carousel-react\": \"8.6.0\",\n \"embla-carousel-wheel-gestures\": \"8.1.0\",\n \"es-toolkit\": \"1.44.0\",\n \"firebase\": \"12.9.0\",\n \"foxact\": \"0.2.52\",\n \"franc-min\": \"6.2.0\",\n \"fuse.js\": \"7.1.0\",\n \"hast-util-to-jsx-runtime\": \"2.3.6\",\n \"hast-util-to-mdast\": \"10.1.2\",\n \"i18next\": \"25.8.6\",\n \"i18next-browser-languagedetector\": \"8.2.1\",\n \"idb-keyval\": \"6.2.2\",\n \"immer\": \"11.1.4\",\n \"jotai\": \"2.17.1\",\n \"lethargy\": \"1.0.9\",\n \"lexical\": \"0.40.0\",\n \"masonic\": \"4.1.0\",\n \"mdast-util-gfm-table\": \"2.0.0\",\n \"mdast-util-to-markdown\": \"2.1.2\",\n \"motion\": \"12.34.0\",\n \"nanoid\": \"5.1.6\",\n \"ofetch\": \"1.5.1\",\n \"plain-shiki\": \"0.3.2\",\n \"re-resizable\": \"6.11.2\",\n \"react\": \"19.0.0\",\n \"react-blurhash\": \"0.3.0\",\n \"react-dom\": \"19.0.0\",\n \"react-error-boundary\": \"6.1.0\",\n \"react-fast-compare\": \"3.2.2\",\n \"react-fast-marquee\": \"1.6.5\",\n \"react-google-recaptcha-v3\": \"1.11.0\",\n \"react-hook-form\": \"7.71.1\",\n \"react-hotkeys-hook\": \"5.2.4\",\n \"react-i18next\": \"16.5.4\",\n \"react-intersection-observer\": \"10.0.2\",\n \"react-ios-pwa-prompt\": \"2.0.6\",\n \"react-markdown\": \"10.1.0\",\n \"react-qr-code\": \"2.0.18\",\n \"react-resizable-layout\": \"npm:@innei/react-resizable-layout@0.7.3-fork.1\",\n \"react-router\": \"7.13.0\",\n \"react-selecto\": \"1.26.3\",\n \"react-shadow\": \"20.6.0\",\n \"react-zoom-pan-pinch\": \"3.7.0\",\n \"rehype-raw\": \"7.0.0\",\n \"shiki\": \"3.22.0\",\n \"sonner\": \"2.0.7\",\n \"tinykeys\": \"3.0.0\",\n \"title-case\": \"4.3.2\",\n \"tldts\": \"7.0.23\",\n \"ufo\": \"1.6.3\",\n \"use-context-selector\": \"2.0.0\",\n \"use-sync-external-store\": \"1.6.0\",\n \"usehooks-ts\": \"3.1.1\",\n \"zod\": \"3.25.76\",\n \"zustand\": \"5.0.11\"\n },\n \"devDependencies\": {\n \"@follow/atoms\": \"workspace:*\",\n \"@follow/components\": \"workspace:*\",\n \"@follow/constants\": \"workspace:*\",\n \"@follow/hooks\": \"workspace:*\",\n \"@follow/logger\": \"workspace:*\",\n \"@follow/models\": \"workspace:*\",\n \"@follow/types\": \"workspace:*\",\n \"@follow/utils\": \"workspace:*\",\n \"@folo-services/ai-tools\": \"catalog:\",\n \"@types/node\": \"25.2.3\",\n \"@vite-pwa/assets-generator\": \"1.0.2\",\n \"fake-indexeddb\": \"6.2.5\",\n \"happy-dom\": \"20.6.1\",\n \"react-scan\": \"0.4.3\",\n \"typescript\": \"catalog:\"\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/pwa-assets.config.ts", "content": "import type { Preset } from \"@vite-pwa/assets-generator/config\"\nimport { defineConfig } from \"@vite-pwa/assets-generator/config\"\n\nconst minimal2023Preset: Preset = {\n transparent: {\n sizes: [64, 192, 512],\n favicons: [[48, \"favicon.ico\"]],\n padding: 0.05,\n // rgba(255, 92, 0, 1)\n resizeOptions: {\n fit: \"contain\",\n background: {\n r: 255,\n g: 92,\n b: 0,\n alpha: 1,\n },\n },\n },\n maskable: {\n sizes: [512],\n padding: 0,\n resizeOptions: {\n fit: \"contain\",\n background: {\n r: 255,\n g: 92,\n b: 0,\n alpha: 1,\n },\n },\n },\n apple: {\n sizes: [180],\n padding: 0,\n resizeOptions: {\n fit: \"contain\",\n background: {\n r: 255,\n g: 92,\n b: 0,\n alpha: 1,\n },\n },\n },\n}\n\nexport default defineConfig({\n headLinkOptions: {\n preset: \"2023\",\n },\n preset: minimal2023Preset,\n images: [\"public/logo.svg\"],\n})\n" }, { "path": "apps/desktop/layer/renderer/setup-file.ts", "content": "// @ts-nocheck\nimport \"fake-indexeddb/auto\"\n\nimport { enableMapSet } from \"immer\"\n\nglobalThis.window = {\n location: new URL(\"https://example.com\"),\n __dbIsReady: true,\n addEventListener: () => {},\n get navigator() {\n return globalThis.navigator\n },\n}\n\nif (!globalThis.navigator) {\n globalThis.navigator = {\n onLine: true,\n userAgent: \"node\",\n }\n}\nenableMapSet()\n" }, { "path": "apps/desktop/layer/renderer/src/@types/constants.ts", "content": "// DONT EDIT THIS FILE MANUALLY\nconst langs = [\"en\", \"zh-CN\", \"zh-TW\", \"ja\", \"fr-FR\"] as const\nexport const currentSupportedLanguages = langs as readonly string[]\nexport type RendererSupportedLanguages = (typeof langs)[number]\n\nexport const dayjsLocaleImportMap = {\n en: [\"en\", () => import(\"dayjs/locale/en\")],\n [\"zh-CN\"]: [\"zh-cn\", () => import(\"dayjs/locale/zh-cn\")],\n [\"ja\"]: [\"ja\", () => import(\"dayjs/locale/ja\")],\n [\"zh-TW\"]: [\"zh-tw\", () => import(\"dayjs/locale/zh-tw\")],\n [\"fr-FR\"]: [\"fr\", () => import(\"dayjs/locale/fr\")],\n}\nexport const ns = [\"common\", \"lang\", \"errors\", \"app\", \"settings\", \"shortcuts\", \"ai\"] as const\nexport const defaultNS = \"app\" as const\n" }, { "path": "apps/desktop/layer/renderer/src/@types/default-resource.electron.ts", "content": "// DONT EDIT THIS FILE MANUALLY\nimport ai_en from \"@locales/ai/en.json\"\nimport ai_frFR from \"@locales/ai/fr-FR.json\"\nimport ai_ja from \"@locales/ai/ja.json\"\nimport en from \"@locales/app/en.json\"\nimport app_frFR from \"@locales/app/fr-FR.json\"\nimport app_ja from \"@locales/app/ja.json\"\nimport app_zhCN from \"@locales/app/zh-CN.json\"\nimport app_zhTW from \"@locales/app/zh-TW.json\"\nimport common_en from \"@locales/common/en.json\"\nimport common_frFR from \"@locales/common/fr-FR.json\"\nimport common_ja from \"@locales/common/ja.json\"\nimport common_zhCN from \"@locales/common/zh-CN.json\"\nimport common_zhTW from \"@locales/common/zh-TW.json\"\nimport errors_en from \"@locales/errors/en.json\"\nimport errors_frFR from \"@locales/errors/fr-FR.json\"\nimport errors_ja from \"@locales/errors/ja.json\"\nimport errors_zhCN from \"@locales/errors/zh-CN.json\"\nimport errors_zhTW from \"@locales/errors/zh-TW.json\"\nimport lang_en from \"@locales/lang/en.json\"\nimport lang_frFR from \"@locales/lang/fr-FR.json\"\nimport lang_ja from \"@locales/lang/ja.json\"\nimport lang_zhCN from \"@locales/lang/zh-CN.json\"\nimport lang_zhTW from \"@locales/lang/zh-TW.json\"\nimport settings_en from \"@locales/settings/en.json\"\nimport settings_frFR from \"@locales/settings/fr-FR.json\"\nimport settings_ja from \"@locales/settings/ja.json\"\nimport settings_zhCN from \"@locales/settings/zh-CN.json\"\nimport settings_zhTW from \"@locales/settings/zh-TW.json\"\nimport shortcuts_en from \"@locales/shortcuts/en.json\"\nimport shortcuts_frFR from \"@locales/shortcuts/fr-FR.json\"\nimport shortcuts_ja from \"@locales/shortcuts/ja.json\"\nimport shortcuts_zhCN from \"@locales/shortcuts/zh-CN.json\"\nimport shortcuts_zhTW from \"@locales/shortcuts/zh-TW.json\"\n\nimport type { ns, RendererSupportedLanguages } from \"./constants\"\n\n/**\n * This file is the language resource that is loaded in full when the app is initialized.\n * In electron, we can load all the language resources synchronously.\n */\nexport const defaultResources = {\n en: {\n app: en,\n lang: lang_en,\n common: common_en,\n settings: settings_en,\n shortcuts: shortcuts_en,\n errors: errors_en,\n ai: ai_en,\n },\n \"zh-CN\": {\n app: app_zhCN,\n lang: lang_zhCN,\n common: common_zhCN,\n settings: settings_zhCN,\n shortcuts: shortcuts_zhCN,\n errors: errors_zhCN,\n ai: ai_en, // Fallback to English until Chinese translation is available\n },\n\n ja: {\n app: app_ja,\n lang: lang_ja,\n common: common_ja,\n settings: settings_ja,\n shortcuts: shortcuts_ja,\n errors: errors_ja,\n ai: ai_ja,\n },\n \"zh-TW\": {\n app: app_zhTW,\n lang: lang_zhTW,\n common: common_zhTW,\n settings: settings_zhTW,\n shortcuts: shortcuts_zhTW,\n errors: errors_zhTW,\n ai: ai_en, // Fallback to English until Traditional Chinese translation is available\n },\n \"fr-FR\": {\n app: app_frFR,\n lang: lang_frFR,\n common: common_frFR,\n settings: settings_frFR,\n shortcuts: shortcuts_frFR,\n errors: errors_frFR,\n ai: ai_frFR,\n },\n} satisfies Record<\n RendererSupportedLanguages,\n Partial>>\n>\n" }, { "path": "apps/desktop/layer/renderer/src/@types/default-resource.ts", "content": "// DONT EDIT THIS FILE MANUALLY\nimport ai_en from \"@locales/ai/en.json\"\nimport en from \"@locales/app/en.json\"\nimport common_en from \"@locales/common/en.json\"\nimport common_frFR from \"@locales/common/fr-FR.json\"\nimport common_ja from \"@locales/common/ja.json\"\nimport common_zhCN from \"@locales/common/zh-CN.json\"\nimport common_zhTW from \"@locales/common/zh-TW.json\"\nimport errors_en from \"@locales/errors/en.json\"\nimport lang_en from \"@locales/lang/en.json\"\nimport lang_frFR from \"@locales/lang/fr-FR.json\"\nimport lang_ja from \"@locales/lang/ja.json\"\nimport lang_zhCN from \"@locales/lang/zh-CN.json\"\nimport lang_zhTW from \"@locales/lang/zh-TW.json\"\nimport settings_en from \"@locales/settings/en.json\"\nimport shortcuts_en from \"@locales/shortcuts/en.json\"\n\nimport type { ns, RendererSupportedLanguages } from \"./constants\"\n\n/**\n * This file is the language resource that is loaded in full when the app is initialized.\n * When switching languages, the app will automatically download the required language resources,\n * we will not load all the language resources to minimize the first screen loading time of the app.\n * Generally, we only load english resources synchronously by default.\n * In addition, we attach common resources for other languages, and the size of the common resources must be controlled.\n */\nexport const defaultResources = {\n en: {\n app: en,\n lang: lang_en,\n common: common_en,\n settings: settings_en,\n shortcuts: shortcuts_en,\n errors: errors_en,\n ai: ai_en,\n },\n \"zh-CN\": {\n lang: lang_zhCN,\n common: common_zhCN,\n },\n\n ja: {\n lang: lang_ja,\n common: common_ja,\n },\n \"zh-TW\": { lang: lang_zhTW, common: common_zhTW },\n \"fr-FR\": { lang: lang_frFR, common: common_frFR },\n} satisfies Record<\n RendererSupportedLanguages,\n Partial>>\n>\n" }, { "path": "apps/desktop/layer/renderer/src/@types/i18next.d.ts", "content": "import type { defaultNS, ns } from \"./constants\"\nimport type { defaultResources as resources } from \"./default-resource\"\n\ndeclare module \"i18next\" {\n interface CustomTypeOptions {\n // ns: [\"app\", \"common\", \"external\", \"lang\", \"settings\", \"shortcuts\"]\n ns: typeof ns\n resources: (typeof resources)[\"en\"]\n defaultNS: typeof defaultNS\n // if you see an error like: \"Argument of type 'DefaultTFuncReturn' is not assignable to parameter of type xyz\"\n // set returnNull to false (and also in the i18next init options)\n // returnNull: false;\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/App.tsx", "content": "import { isMobile } from \"@follow/components/hooks/useMobile.js\"\nimport { IN_ELECTRON } from \"@follow/shared/constants\"\nimport { tracker } from \"@follow/tracker\"\nimport { nextFrame } from \"@follow/utils\"\nimport { cn, getOS } from \"@follow/utils/utils\"\nimport { useEffect, useLayoutEffect, useRef } from \"react\"\nimport { Outlet } from \"react-router\"\n\nimport { useAppIsReady } from \"./atoms/app\"\nimport { useUISettingKey } from \"./atoms/settings/ui\"\nimport { applyAfterReadyCallbacks } from \"./initialize/queue\"\nimport { removeAppSkeleton } from \"./lib/app\"\nimport { ipcServices } from \"./lib/client\"\nimport { appLog } from \"./lib/log\"\nimport { Titlebar } from \"./modules/app/Titlebar\"\nimport { RootProviders } from \"./providers/root-providers\"\n\nfunction App() {\n const windowsElectron = IN_ELECTRON && getOS() === \"Windows\"\n return (\n \n {IN_ELECTRON && (\n \n {windowsElectron && }\n \n )}\n\n \n \n )\n}\n\nconst AppLayer = () => {\n const appIsReady = useAppIsReady()\n\n const onceReady = useRef(false)\n useLayoutEffect(() => {\n if (appIsReady && !onceReady.current) {\n onceReady.current = true\n ipcServices?.app.readyToShowMainWindow()\n nextFrame(removeAppSkeleton)\n }\n }, [appIsReady])\n\n useEffect(() => {\n const doneTime = Math.trunc(performance.now())\n tracker.uiRenderInit(doneTime)\n appLog(\"App is ready\", `${doneTime}ms`)\n applyAfterReadyCallbacks()\n\n if (isMobile()) {\n const handler = (e: MouseEvent) => {\n e.preventDefault()\n }\n document.addEventListener(\"contextmenu\", handler)\n\n return () => {\n document.removeEventListener(\"contextmenu\", handler)\n }\n }\n }, [appIsReady])\n\n return appIsReady ? : \n}\n\nconst AppSkeleton = () => {\n const feedColWidth = useUISettingKey(\"feedColWidth\")\n return (\n
\n \n
\n )\n}\n\nexport { App as Component }\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/ai-summary.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nimport { useGeneralSettingKey } from \"./settings/general\"\n\nexport const [, , useShowAISummaryOnce, , getShowAISummaryOnce, setShowAISummaryOnce] =\n createAtomHooks(atom(false))\n\nexport const toggleShowAISummaryOnce = () => setShowAISummaryOnce((prev) => !prev)\nexport const enableShowAISummaryOnce = () => setShowAISummaryOnce(true)\nexport const disableShowAISummaryOnce = () => setShowAISummaryOnce(false)\n\nexport const useShowAISummaryAuto = (settings?: boolean | null) => {\n return useGeneralSettingKey(\"summary\") || !!settings\n}\n\nexport const useShowAISummary = (settings?: boolean | null) => {\n const showAISummaryAuto = useShowAISummaryAuto(settings)\n const showAISummaryOnce = useShowAISummaryOnce()\n return showAISummaryAuto || showAISummaryOnce || !!settings\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/ai-translation.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nimport { useGeneralSettingKey } from \"./settings/general\"\n\n// NOTE: We have three levels of settings can enable AI translation or Summary:\n// 1. General setting, which is the global settings for all entries.\n// 2. Action setting, which is defined in an action and applied to specific entries.\n// 3. Toolbar control, which is a temporary setting for the current entry.\n//\n// When general setting or action setting is enabled, we should hide the toolbar control, which can save some space.\n//\n// Different from AI summary, AI translation also can show up in the entry list, which should only be controlled by the General setting or Action setting.\n\nexport const [, , useShowAITranslationOnce, , getShowAITranslationOnce, setShowAITranslationOnce] =\n createAtomHooks(atom(false))\n\nexport const toggleShowAITranslationOnce = () => setShowAITranslationOnce((prev) => !prev)\nexport const enableShowAITranslationOnce = () => setShowAITranslationOnce(true)\nexport const disableShowAITranslationOnce = () => setShowAITranslationOnce(false)\n\nexport const useShowAITranslationAuto = (settings?: boolean | null) => {\n return useGeneralSettingKey(\"translation\") || !!settings\n}\n\nexport const useShowAITranslation = (settings?: boolean | null) => {\n const showAITranslationAuto = useShowAITranslationAuto(settings)\n const showAITranslationOnce = useShowAITranslationOnce()\n return showAITranslationAuto || showAITranslationOnce\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/app.ts", "content": "import { WindowState } from \"@follow/shared/bridge\"\nimport { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport const [, , useAppIsReady, , appIsReady, setAppIsReady] = createAtomHooks(atom(false))\nexport const [, , useAppMessagingToken, , appMessagingToken, setAppMessagingToken] =\n createAtomHooks(atom(null))\n\nexport const [, , useAppSearchOpen, , , setAppSearchOpen] = createAtomHooks(atom(false))\n\n// For electron\nexport const [, , useWindowState, , windowState, setWindowState] = createAtomHooks(\n atom(WindowState.NORMAL),\n)\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/context-menu.ts", "content": "import { IN_ELECTRON } from \"@follow/shared/constants\"\nimport { getOS, transformShortcut } from \"@follow/utils/utils\"\nimport { atom } from \"jotai\"\nimport { useCallback } from \"react\"\n\nimport { useRequireLogin } from \"~/hooks/common/useRequireLogin\"\nimport { ipcServices } from \"~/lib/client\"\nimport { createAtomHooks } from \"~/lib/jotai\"\nimport type { ElectronMenuItem } from \"~/lib/native-menu\"\nimport { showElectronContextMenu } from \"~/lib/native-menu\"\n\n// Atom\n\ntype ContextMenuState =\n | { open: false }\n | {\n open: true\n position: { x: number; y: number }\n menuItems: FollowMenuItem[]\n // Just for abort callback\n // Also can be optimized by using the `atomWithListeners`\n abortController: AbortController\n }\n\nexport const [contextMenuAtom, useContextMenuState, useContextMenuValue, useSetContextMenu] =\n createAtomHooks(atom({ open: false }))\n\nconst useShowWebContextMenu = () => {\n const setContextMenu = useSetContextMenu()\n\n const showWebContextMenu = useCallback(\n async (menuItems: Array, e: MouseEvent | React.MouseEvent) => {\n const abortController = new AbortController()\n const resolvers = Promise.withResolvers()\n setContextMenu({\n open: true,\n position: { x: e.clientX, y: e.clientY },\n menuItems,\n abortController,\n })\n\n abortController.signal.addEventListener(\"abort\", () => {\n resolvers.resolve()\n })\n return resolvers.promise\n },\n [setContextMenu],\n )\n\n return showWebContextMenu\n}\n\n// Menu\n\nexport type FollowMenuItem = MenuItemText | MenuItemSeparator\n\nexport type MenuItemInput = MenuItemText | MenuItemSeparator | NilValue\n\nfunction sortShortcutsString(shortcut: string) {\n const order = [\"Shift\", \"Ctrl\", \"Meta\", \"Alt\"]\n const nextShortcut = transformShortcut(shortcut)\n\n const arr = nextShortcut.split(\"+\")\n\n const sortedModifiers = arr\n .filter((key) => order.includes(key))\n .sort((a, b) => order.indexOf(a) - order.indexOf(b))\n\n const otherKeys = arr.filter((key) => !order.includes(key))\n\n return [...sortedModifiers, ...otherKeys].join(\"+\")\n}\n\nfunction filterNullableMenuItems(items: MenuItemInput[]): FollowMenuItem[] {\n return items\n .filter((item) => item !== null && item !== undefined && item !== false && item !== \"\")\n .filter((item) => !item.hide)\n .map((item) => {\n if (item instanceof MenuItemSeparator) {\n return MENU_ITEM_SEPARATOR\n }\n\n if (item.submenu && item.submenu.length > 0) {\n return item.extend({\n submenu: filterNullableMenuItems(item.submenu),\n })\n }\n\n return item\n })\n}\n\n// MenuItem must have at least one of label, role or type\nfunction transformMenuItemsForNative(nextItems: FollowMenuItem[]): ElectronMenuItem[] {\n return nextItems.map((item) => {\n if (item instanceof MenuItemSeparator) {\n return { type: \"separator\" }\n }\n return {\n type: typeof item.checked === \"boolean\" ? \"checkbox\" : undefined,\n label: item.label,\n click: item.click,\n enabled:\n (!item.disabled && item.click !== undefined) || (!!item.submenu && item.submenu.length > 0),\n accelerator: item.shortcut?.replace(\"$mod\", \"CmdOrCtrl\"),\n checked: typeof item.checked === \"boolean\" ? item.checked : undefined,\n submenu:\n item.submenu.length > 0\n ? transformMenuItemsForNative(filterNullableMenuItems(item.submenu))\n : undefined,\n }\n })\n}\n\nfunction withDebugMenu(menuItems: Array, e: MouseEvent | React.MouseEvent) {\n if (import.meta.env.DEV && e) {\n menuItems.push(\n MENU_ITEM_SEPARATOR,\n new MenuItemText({\n label: \"Inspect Element\",\n click: () => {\n ipcServices?.debug.inspectElement({\n x: e.pageX,\n y: e.pageY,\n })\n },\n }),\n )\n }\n return menuItems\n}\n\nexport enum MenuItemType {\n Separator,\n Action,\n}\n\nexport const useShowContextMenu = () => {\n const showWebContextMenu = useShowWebContextMenu()\n const { withLoginGuard } = useRequireLogin()\n\n const guardMenuItems = useCallback(\n (items: FollowMenuItem[]): FollowMenuItem[] =>\n items.map((item) => {\n if (item instanceof MenuItemSeparator) {\n return item\n }\n\n const nextSubmenu = item.submenu.length > 0 ? guardMenuItems(item.submenu) : item.submenu\n let nextItem = nextSubmenu !== item.submenu ? item.extend({ submenu: nextSubmenu }) : item\n\n if (item.requiresLogin) {\n nextItem = nextItem.extend({\n click: withLoginGuard(nextItem.click),\n })\n }\n\n return nextItem\n }),\n [withLoginGuard],\n )\n\n const showContextMenu = useCallback(\n async (inputMenu: Array, e: MouseEvent | React.MouseEvent) => {\n const menuItems = guardMenuItems(filterNullableMenuItems(inputMenu))\n // only show native menu on macOS electron, because in other platform, the native ui is not good\n if (IN_ELECTRON && getOS() === \"macOS\") {\n withDebugMenu(menuItems, e)\n await showElectronContextMenu(transformMenuItemsForNative(menuItems))\n return\n }\n await showWebContextMenu(menuItems, e)\n },\n [guardMenuItems, showWebContextMenu],\n )\n\n return showContextMenu\n}\n\nexport class MenuItemSeparator {\n readonly type = MenuItemType.Separator\n constructor(public hide = false) {}\n static default = new MenuItemSeparator()\n}\n\nconst noop = () => void 0\nexport type BaseMenuItemTextConfig = {\n label: string\n click?: () => void\n /** only work in web app */\n icon?: React.ReactNode\n shortcut?: string\n disabled?: boolean\n checked?: boolean\n supportMultipleSelection?: boolean\n requiresLogin?: boolean\n}\n\nexport class BaseMenuItemText {\n readonly type = MenuItemType.Action\n\n private __sortedShortcut: string | null = null\n\n constructor(private configs: BaseMenuItemTextConfig) {\n this.__sortedShortcut = this.configs.shortcut\n ? sortShortcutsString(this.configs.shortcut)\n : null\n }\n\n public get label() {\n return this.configs.label\n }\n\n public get click() {\n return this.configs.click?.bind(this.configs) || noop\n }\n\n public get onClick() {\n return this.click\n }\n public get icon() {\n return this.configs.icon\n }\n\n public get shortcut() {\n return this.__sortedShortcut\n }\n\n public get disabled() {\n return this.configs.disabled || false\n }\n\n public get checked() {\n return this.configs.checked\n }\n\n public get supportMultipleSelection() {\n return this.configs.supportMultipleSelection\n }\n\n public get requiresLogin() {\n return this.configs.requiresLogin || false\n }\n}\n\nexport type MenuItemTextConfig = Prettify<\n BaseMenuItemTextConfig & {\n hide?: boolean\n submenu?: MenuItemInput[]\n }\n>\n\nexport class MenuItemText extends BaseMenuItemText {\n protected __submenu: FollowMenuItem[]\n constructor(protected config: MenuItemTextConfig) {\n super(config)\n\n this.__submenu = this.config.submenu ? filterNullableMenuItems(this.config.submenu) : []\n }\n\n public get submenu() {\n return this.__submenu\n }\n\n public get hide() {\n return this.config.hide || false\n }\n\n extend(config: Partial) {\n return new MenuItemText({\n ...this.config,\n ...config,\n })\n }\n}\nexport const MENU_ITEM_SEPARATOR = MenuItemSeparator.default\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/corner-player.ts", "content": "import { getStorageNS } from \"@follow/utils/ns\"\nimport { atomWithStorage } from \"jotai/utils\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\ntype CornerPlayerAtomValue = {\n show: boolean\n type?: \"audio\"\n entryId?: string\n url?: string\n}\n\nconst cornerPlayerInitialValue: CornerPlayerAtomValue = {\n show: false,\n}\n\nexport const [\n cornerPlayerAtom,\n useCornerPlayerAtom,\n useCornerPlayerAtomValue,\n useSetCornerPlayerAtom,\n getCornerPlayerAtomValue,\n setCornerPlayerAtomValue,\n] = createAtomHooks(\n atomWithStorage(getStorageNS(\"corner-player\"), cornerPlayerInitialValue, undefined, {\n getOnInit: true,\n }),\n)\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/debug-feature.ts", "content": "import { createAtomHooks } from \"@follow/utils/jotai\"\nimport { getStorageNS } from \"@follow/utils/ns\"\nimport { atomWithStorage } from \"jotai/utils\"\n\n// Shape: { __override?: boolean, [featureKey: string]: boolean }\nexport const [\n ,\n ,\n useDebugFeatureValue,\n useSetDebugFeatureValue,\n getDebugFeatureValue,\n setDebugFeatureValue,\n] = createAtomHooks(atomWithStorage>(getStorageNS(\"debug-feature\"), {}))\n\nexport { useDebugFeatureValue as useDebugFeatures }\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/dom.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport const [, , useMainContainerElement, , getMainContainerElement, setMainContainerElement] =\n createAtomHooks(atom(null))\n\nexport const [, , useRootContainerElement, , getRootContainerElement, setRootContainerElement] =\n createAtomHooks(atom(null))\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/lang.ts", "content": "import { atom } from \"jotai\"\n\nexport const langLoadingLockMapAtom = atom({} as Record)\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/network.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport enum NetworkStatus {\n ONLINE,\n OFFLINE,\n}\n\nexport const [, , useNetworkStatus, , getNetworkStatus, setNetworkStatus] = createAtomHooks(\n atom(navigator.onLine ? NetworkStatus.ONLINE : NetworkStatus.OFFLINE),\n)\n\nexport const [, , useApiStatus, , getApiStatus, setApiStatus] = createAtomHooks(\n atom(NetworkStatus.ONLINE),\n)\n\nexport const subscribeNetworkStatus = () => {\n const handleOnline = () => setNetworkStatus(NetworkStatus.ONLINE)\n const handleOffline = () => setNetworkStatus(NetworkStatus.OFFLINE)\n\n window.addEventListener(\"online\", handleOnline)\n window.addEventListener(\"offline\", handleOffline)\n\n setNetworkStatus(navigator.onLine ? NetworkStatus.ONLINE : NetworkStatus.OFFLINE)\n\n return () => {\n window.removeEventListener(\"online\", handleOnline)\n window.removeEventListener(\"offline\", handleOffline)\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/player.ts", "content": "import { getStorageNS } from \"@follow/utils/ns\"\nimport { parseSafeUrl } from \"@follow/utils/utils\"\nimport { noop } from \"foxact/noop\"\nimport { atomWithStorage, createJSONStorage } from \"jotai/utils\"\nimport type { SyncStorage } from \"jotai/vanilla/utils/atomWithStorage\"\n\nimport { getRouteParams } from \"~/hooks/biz/useRouteParams\"\nimport { createAtomHooks } from \"~/lib/jotai\"\n\ntype PlayerAtomValue = {\n show: boolean\n type?: \"audio\"\n entryId?: string\n src?: string\n status?: \"playing\" | \"paused\" | \"loading\"\n duration?: number\n currentTime?: number\n isMute?: boolean\n volume?: number\n playbackRate?: number\n /** the listId from the route to indicate that the audio is triggered from a list */\n listId?: string\n isStream?: boolean\n}\n\nconst playerInitialValue: PlayerAtomValue = {\n show: false,\n volume: 0.8,\n duration: 0,\n playbackRate: 1,\n isStream: false,\n}\n\nconst jsonStorage = createJSONStorage()\nlet hydrationDone = false\nconst patchedLocalStorage: SyncStorage = {\n setItem: jsonStorage.setItem,\n getItem: (key, initialValue) => {\n const value = jsonStorage.getItem(key, initialValue)\n if (value.isStream) {\n return playerInitialValue\n }\n if (value && !hydrationDone) {\n // patch status to `paused` when hydration\n value.status = \"paused\"\n value.isStream = false\n hydrationDone = true\n }\n return value\n },\n removeItem: jsonStorage.removeItem,\n}\nexport const [\n ,\n ,\n useAudioPlayerAtomValue,\n useAudioSetPlayerAtom,\n getAudioPlayerAtomValue,\n setAudioPlayerAtomValue,\n useAudioPlayerAtomSelector,\n] = createAtomHooks(\n atomWithStorage(getStorageNS(\"player\"), playerInitialValue, patchedLocalStorage, {\n getOnInit: true,\n }),\n)\n\nexport const AudioPlayer = {\n audio: new Audio(),\n currentTimeTimer: null as ReturnType | null,\n\n __currentActionId: 0,\n get() {\n return getAudioPlayerAtomValue()\n },\n mount(v: Omit) {\n const curV = getAudioPlayerAtomValue()\n if (!v.src || (curV.src === v.src && curV.status === \"playing\")) {\n return\n }\n\n const routeParams = getRouteParams()\n\n setAudioPlayerAtomValue({\n ...curV,\n ...v,\n status: \"loading\",\n show: true,\n listId: routeParams.listId,\n isStream: false,\n })\n const currentUrl = parseSafeUrl(this.audio.src)?.toString() ?? this.audio.src\n const newUrl = parseSafeUrl(v.src)?.toString() ?? v.src\n\n // It seems that audio load from local file has some limitations, i think reset the audio should be fine here\n if (currentUrl !== newUrl || newUrl.startsWith(\"file://\")) {\n this.audio.src = v.src\n this.audio.currentTime = v.currentTime ?? curV.currentTime ?? 0\n }\n this.audio.volume = curV.volume ?? 0.8\n this.audio.playbackRate = curV.playbackRate ?? 1\n\n this.currentTimeTimer && clearInterval(this.currentTimeTimer)\n this.currentTimeTimer = setInterval(() => {\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n currentTime: this.audio.currentTime,\n })\n }, 1000)\n\n this.audio.onloadedmetadata = () => {\n if (Number.isNaN(this.audio.duration) || this.audio.duration === Infinity) {\n this.audio.currentTime = 0\n }\n }\n\n const currentActionId = this.__currentActionId\n return this.audio\n .play()\n .then(() => {\n if (currentActionId !== this.__currentActionId) return\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n status: \"playing\",\n duration: this.audio.duration === Infinity ? 0 : this.audio.duration,\n })\n })\n .catch(noop)\n },\n teardown() {\n this.currentTimeTimer && clearInterval(this.currentTimeTimer)\n this.audio.pause()\n },\n play() {\n ++this.__currentActionId\n const curV = getAudioPlayerAtomValue()\n\n if (curV.isStream) {\n void this.audio.play().catch(noop)\n setAudioPlayerAtomValue({\n ...curV,\n status: \"playing\",\n })\n return\n }\n\n this.mount(curV)\n },\n pause() {\n ++this.__currentActionId\n const curV = getAudioPlayerAtomValue()\n if (curV.status === \"paused\") {\n return\n }\n\n setAudioPlayerAtomValue({\n ...curV,\n status: \"paused\",\n currentTime: this.audio.currentTime,\n })\n this.teardown()\n return\n },\n togglePlayAndPause() {\n const curV = getAudioPlayerAtomValue()\n if (curV.isStream) {\n if (curV.status === \"playing\") {\n return this.pause()\n }\n if (curV.status === \"paused\") {\n return this.play()\n }\n return this.pause()\n }\n if (curV.status === \"playing\") {\n return this.pause()\n } else if (curV.status === \"paused\") {\n return this.mount(curV)\n } else {\n return this.pause()\n }\n },\n close() {\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n show: false,\n status: \"paused\",\n isStream: false,\n })\n\n this.teardown()\n },\n seek(time: number) {\n if (getAudioPlayerAtomValue().isStream) {\n return\n }\n this.audio.currentTime = time\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n currentTime: time,\n })\n },\n setPlaybackRate(speed: number) {\n if (getAudioPlayerAtomValue().isStream) {\n return\n }\n this.audio.playbackRate = speed\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n playbackRate: speed,\n })\n },\n back(time: number) {\n if (getAudioPlayerAtomValue().isStream) {\n return\n }\n this.seek(Math.max(this.audio.currentTime - time, 0))\n },\n forward(time: number) {\n if (getAudioPlayerAtomValue().isStream) {\n return\n }\n this.seek(Math.min(this.audio.currentTime + time, this.audio.duration))\n },\n toggleMute() {\n this.audio.muted = !this.audio.muted\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n isMute: this.audio.muted,\n })\n },\n setVolume(volume: number) {\n this.audio.volume = volume\n setAudioPlayerAtomValue({\n ...getAudioPlayerAtomValue(),\n volume,\n })\n },\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/popover.ts", "content": "import type { PopoverContentProps } from \"@radix-ui/react-popover\"\nimport { atom } from \"jotai\"\nimport type { ReactNode } from \"react\"\n\nimport { createAtomHooks, jotaiStore } from \"~/lib/jotai\"\n\n// Atom\n\nexport interface PopoverProps extends Omit {\n /** Custom z-index for popover */\n zIndex?: number\n /** Whether the popover should close when clicked outside */\n modal?: boolean\n}\n\ntype PopoverState =\n | { open: false }\n | {\n open: true\n position: { x: number; y: number }\n content: ReactNode\n props?: PopoverProps\n // Just for abort callback\n abortController: AbortController\n }\n\nexport const [popoverAtom, usePopoverState, usePopoverValue, useSetPopover] = createAtomHooks(\n atom({ open: false }),\n)\n\nexport const showPopover = (\n mouseXY: { x: number; y: number },\n element: ReactNode,\n props?: PopoverProps,\n) => {\n jotaiStore.set(popoverAtom, {\n open: true,\n position: mouseXY,\n content: element,\n props,\n abortController: new AbortController(),\n })\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/preview.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport const [, , , , previewBackPath, setPreviewBackPath] = createAtomHooks(atom())\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/readability.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nconst mergeObjectSetter =\n (setter: (prev: T) => void, getter: () => T) =>\n (value: Partial) =>\n setter({ ...getter(), ...value })\n\nexport enum ReadabilityStatus {\n INITIAL = 1,\n WAITING = 2,\n SUCCESS = 3,\n FAILURE = 4,\n}\nexport const [\n ,\n ,\n useReadabilityStatus,\n ,\n getReadabilityStatus,\n __setReadabilityStatus,\n useReadabilityStatusSelector,\n] = createAtomHooks(atom>({}))\nexport const setReadabilityStatus = mergeObjectSetter(__setReadabilityStatus, getReadabilityStatus)\n\nexport const useEntryIsInReadability = (entryId?: string) =>\n useReadabilityStatusSelector(\n (map) => (entryId ? (map[entryId] ? isInReadability(map[entryId]) : false) : false),\n [entryId],\n )\n\nexport const useEntryIsInReadabilitySuccess = (entryId?: string) =>\n useReadabilityStatusSelector(\n (map) => (entryId ? map[entryId] === ReadabilityStatus.SUCCESS : false),\n [entryId],\n )\n\nexport const useEntryInReadabilityStatus = (entryId?: string) =>\n useReadabilityStatusSelector(\n (map) => (entryId ? map[entryId] || ReadabilityStatus.INITIAL : ReadabilityStatus.INITIAL),\n [entryId],\n )\n\nexport const isInReadability = (status: ReadabilityStatus) =>\n status !== ReadabilityStatus.INITIAL && !!status\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/server-configs.ts", "content": "import { getStorageNS } from \"@follow/utils/ns\"\nimport type { ExtractResponseData, GetStatusConfigsResponse } from \"@follow-app/client-sdk\"\nimport PKG from \"@pkg\"\nimport { atomWithStorage } from \"jotai/utils\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport const [, , useServerConfigs, , getServerConfigs, setServerConfigs] = createAtomHooks(\n atomWithStorage>>(\n getStorageNS(\"server-configs\"),\n null,\n undefined,\n {\n getOnInit: true,\n },\n ),\n)\n\nexport type ServerConfigs = ExtractResponseData\nexport type PaymentPlan = ServerConfigs[\"PAYMENT_PLAN_LIST\"][number]\nexport type PaymentFeature = PaymentPlan[\"limit\"]\n\nexport const useIsInMASReview = () => {\n const serverConfigs = useServerConfigs()\n return (\n typeof process !== \"undefined\" &&\n process.mas &&\n serverConfigs?.MAS_IN_REVIEW_VERSION === PKG.version\n )\n}\n\nexport const getIsInMASReview = () => {\n const serverConfigs = getServerConfigs()\n return (\n typeof process !== \"undefined\" &&\n process.mas &&\n serverConfigs?.MAS_IN_REVIEW_VERSION === PKG.version\n )\n}\n\nexport const useIsPaymentEnabled = () => {\n const serverConfigs = useServerConfigs()\n const isInMASReview = useIsInMASReview()\n return !isInMASReview && serverConfigs?.PAYMENT_ENABLED\n}\n\nexport const getIsPaymentEnabled = () => {\n const serverConfigs = getServerConfigs()\n const isInMASReview = getIsInMASReview()\n return !isInMASReview && serverConfigs?.PAYMENT_ENABLED\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/settings/ai.ts", "content": "import { createSettingAtom } from \"@follow/atoms/helper/setting.js\"\nimport { defaultAISettings } from \"@follow/shared/settings/defaults\"\nimport type {\n AISettings,\n AIShortcut,\n AIShortcutTarget,\n MCPService,\n} from \"@follow/shared/settings/interface\"\nimport { DEFAULT_SHORTCUT_TARGETS } from \"@follow/shared/settings/interface\"\nimport { jotaiStore } from \"@follow/utils\"\nimport type { ExtractResponseData, GetStatusConfigsResponse } from \"@follow-app/client-sdk\"\nimport { clamp } from \"es-toolkit\"\nimport { atom, useAtomValue } from \"jotai\"\n\nimport { getFeature } from \"~/hooks/biz/useFeature\"\n\nexport interface WebAISettings extends AISettings {\n panelStyle: AIChatPanelStyle\n showSplineButton: boolean\n}\n\ntype ServerShortcutConfig = ExtractResponseData[\"AI_SHORTCUTS\"][number]\n\nconst FALLBACK_SHORTCUT_ICON = \"i-mgc-hotkey-cute-re\"\nconst VALID_SHORTCUT_TARGETS = new Set(DEFAULT_SHORTCUT_TARGETS)\n\nconst isValidShortcutTarget = (target: string): target is AIShortcutTarget =>\n VALID_SHORTCUT_TARGETS.has(target as AIShortcutTarget)\n\nconst sanitizeShortcutTargets = (targets?: readonly string[]): AIShortcutTarget[] => {\n if (!targets || targets.length === 0) {\n return [...DEFAULT_SHORTCUT_TARGETS]\n }\n\n const filtered = targets.filter(isValidShortcutTarget) as AIShortcutTarget[]\n return filtered.length > 0 ? [...filtered] : [...DEFAULT_SHORTCUT_TARGETS]\n}\n\nconst normalizeShortcut = (shortcut: AIShortcut): AIShortcut => {\n return {\n ...shortcut,\n displayTargets: sanitizeShortcutTargets(shortcut.displayTargets),\n enabled: typeof shortcut.enabled === \"boolean\" ? shortcut.enabled : true,\n }\n}\n\nconst normalizeShortcuts = (shortcuts: readonly AIShortcut[] | undefined): AIShortcut[] =>\n (shortcuts ?? []).map((shortcut) => normalizeShortcut({ ...shortcut }))\n\nconst mergeWithServerShortcuts = (\n localShortcuts: readonly AIShortcut[],\n serverShortcuts: readonly ServerShortcutConfig[],\n): AIShortcut[] => {\n const normalizedLocal = normalizeShortcuts(localShortcuts)\n if (serverShortcuts.length === 0) {\n return normalizedLocal\n }\n\n const serverShortcutMap = new Map()\n serverShortcuts.forEach((shortcut) => {\n serverShortcutMap.set(shortcut.id, shortcut)\n })\n\n const seenServerShortcutIds = new Set()\n const mergedShortcuts: AIShortcut[] = []\n\n normalizedLocal.forEach((shortcut) => {\n const serverShortcut = serverShortcutMap.get(shortcut.id)\n if (!serverShortcut) {\n mergedShortcuts.push(shortcut)\n return\n }\n\n seenServerShortcutIds.add(serverShortcut.id)\n const shouldClearPrompt = shortcut.prompt === serverShortcut.defaultPrompt\n\n mergedShortcuts.push({\n ...shortcut,\n name: shortcut.name || serverShortcut.name,\n prompt: shouldClearPrompt ? \"\" : shortcut.prompt,\n defaultPrompt: serverShortcut.defaultPrompt,\n displayTargets: sanitizeShortcutTargets(\n shortcut.displayTargets || serverShortcut.displayTargets,\n ),\n })\n })\n\n serverShortcuts.forEach((serverShortcut) => {\n if (seenServerShortcutIds.has(serverShortcut.id)) return\n\n mergedShortcuts.push({\n id: serverShortcut.id,\n name: serverShortcut.name,\n prompt: \"\",\n defaultPrompt: serverShortcut.defaultPrompt,\n enabled: true,\n icon: FALLBACK_SHORTCUT_ICON,\n displayTargets: sanitizeShortcutTargets(serverShortcut.displayTargets),\n })\n })\n\n return mergedShortcuts\n}\n\nexport const getShortcutEffectivePrompt = (shortcut: AIShortcut): string => {\n return shortcut.prompt || shortcut.defaultPrompt || \"\"\n}\n\nexport const isServerShortcut = (shortcut: AIShortcut) => !!shortcut.defaultPrompt\n\nexport const createDefaultSettings = (): WebAISettings => ({\n ...defaultAISettings,\n shortcuts: normalizeShortcuts(defaultAISettings.shortcuts),\n panelStyle: AIChatPanelStyle.Floating,\n showSplineButton: true,\n})\n\nexport const {\n useSettingKey: useAISettingKey,\n useSettingSelector: useAISettingSelector,\n setSetting: setAISetting,\n clearSettings: clearAISettings,\n initializeDefaultSettings,\n getSettings: getAISettings,\n useSettingValue: useAISettingValue,\n settingAtom: __aiSettingAtom,\n} = createSettingAtom(\"ai\", createDefaultSettings)\nexport const aiServerSyncWhiteListKeys = []\n\nexport const syncServerShortcuts = (\n serverShortcuts: readonly ServerShortcutConfig[] | null | undefined,\n) => {\n const storedShortcuts = getAISettings().shortcuts ?? []\n const serverShortcutList = Array.isArray(serverShortcuts) ? serverShortcuts : []\n const mergedShortcuts = mergeWithServerShortcuts(storedShortcuts, serverShortcutList)\n\n setAISetting(\"shortcuts\", mergedShortcuts)\n}\n\n////////// AI Panel Style\nexport enum AIChatPanelStyle {\n Fixed = \"fixed\",\n Floating = \"floating\",\n}\n\nexport const useAIChatPanelStyle = () => useAISettingKey(\"panelStyle\")\nexport const setAIChatPanelStyle = (style: AIChatPanelStyle) => {\n setAISetting(\"panelStyle\", style)\n}\nexport const getAIChatPanelStyle = () => getAISettings().panelStyle\n\n// Floating panel state atoms\ninterface FloatingPanelState {\n width: number\n height: number\n x: number\n y: number\n}\n\nconst DEFAULT_FLOATING_PANEL_WIDTH = 500\nconst DEFAULT_FLOATING_PANEL_HEIGHT = clamp(window.innerHeight * 0.9, 600, 1000)\nconst DEFAULT_FLOATING_PANEL_X = window.innerWidth - DEFAULT_FLOATING_PANEL_WIDTH - 20\nconst DEFAULT_FLOATING_PANEL_Y = window.innerHeight - DEFAULT_FLOATING_PANEL_HEIGHT - 20\n\nconst defaultFloatingPanelState: FloatingPanelState = {\n width: DEFAULT_FLOATING_PANEL_WIDTH,\n height: DEFAULT_FLOATING_PANEL_HEIGHT,\n x: DEFAULT_FLOATING_PANEL_X,\n y: DEFAULT_FLOATING_PANEL_Y,\n}\n\nconst floatingPanelStateAtom = atom(defaultFloatingPanelState)\n\nexport const useFloatingPanelState = () => useAtomValue(floatingPanelStateAtom)\nexport const setFloatingPanelState = (state: Partial) => {\n const currentState = jotaiStore.get(floatingPanelStateAtom)\n jotaiStore.set(floatingPanelStateAtom, { ...currentState, ...state })\n}\nexport const getFloatingPanelState = () => jotaiStore.get(floatingPanelStateAtom)\n\n////////// AI Panel Visibility\n\nconst aiPanelVisibilityAtom = atom(false)\nexport const useAIPanelVisibility = () => useAtomValue(aiPanelVisibilityAtom)\nexport const setAIPanelVisibility = (visibility: boolean) => {\n const aiEnabled = getFeature(\"ai\")\n if (aiEnabled) {\n jotaiStore.set(aiPanelVisibilityAtom, visibility)\n }\n}\nexport const getAIPanelVisibility = () => jotaiStore.get(aiPanelVisibilityAtom)\n\n////////// MCP Services\nexport const useMCPEnabled = () => useAISettingKey(\"mcpEnabled\")\nexport const setMCPEnabled = (enabled: boolean) => {\n setAISetting(\"mcpEnabled\", enabled)\n}\n\nexport const useMCPServices = () => useAISettingKey(\"mcpServices\")\nexport const addMCPService = (service: Omit) => {\n const services = getAISettings().mcpServices\n const newService = {\n ...service,\n id: Date.now().toString(),\n }\n setAISetting(\"mcpServices\", [...services, newService])\n return newService.id\n}\n\nexport const updateMCPService = (id: string, updates: Partial) => {\n const services = getAISettings().mcpServices\n const updatedServices = services.map((service) =>\n service.id === id ? { ...service, ...updates } : service,\n )\n setAISetting(\"mcpServices\", updatedServices)\n}\n\nexport const removeMCPService = (id: string) => {\n const services = getAISettings().mcpServices\n const filteredServices = services.filter((service) => service.id !== id)\n setAISetting(\"mcpServices\", filteredServices)\n}\n\n//// Enhance Init Ai Settings\nexport const initializeDefaultAISettings = () => {\n initializeDefaultSettings()\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/settings/general.ts", "content": "import { createSettingAtom } from \"@follow/atoms/helper/setting.js\"\nimport { defaultGeneralSettings } from \"@follow/shared/settings/defaults\"\nimport { hookEnhancedSettings as baseHookEnhancedSettings } from \"@follow/shared/settings/hook\"\nimport type { GeneralSettings } from \"@follow/shared/settings/interface\"\nimport type { SupportedLanguages } from \"@follow-app/client-sdk\"\n\nimport { jotaiStore } from \"~/lib/jotai\"\nimport { getDefaultLanguage } from \"~/lib/language\"\n\nexport const DEFAULT_ACTION_LANGUAGE = \"default\"\n\nexport const createDefaultGeneralSettings = (): GeneralSettings => ({\n ...defaultGeneralSettings,\n language: getDefaultLanguage(),\n})\n\nconst {\n useSettingKey: useGeneralSettingKeyInternal,\n useSettingSelector: useGeneralSettingSelectorInternal,\n useSettingKeys: useGeneralSettingKeysInternal,\n setSetting: setGeneralSetting,\n clearSettings: clearGeneralSettings,\n initializeDefaultSettings: initializeDefaultGeneralSettings,\n getSettings: getGeneralSettingsInternal,\n useSettingValue: useGeneralSettingValueInternal,\n\n settingAtom: __generalSettingAtom,\n} = createSettingAtom(\"general\", createDefaultGeneralSettings)\nexport const hookEnhancedSettings = <\n T1 extends (key: any) => any,\n T2 extends (selector: (s: any) => any) => any,\n T3 extends (keys: any) => any,\n T4 extends () => any,\n T5 extends () => any,\n>(\n useSettingKey: T1,\n useSettingSelector: T2,\n useSettingKeys: T3,\n getSettings: T4,\n useSettingValue: T5,\n\n enhancedSettingKeys: Set,\n defaultSettings: Record,\n): [T1, T2, T3, T4, T5] => {\n return baseHookEnhancedSettings(\n useSettingKey,\n useSettingSelector,\n useSettingKeys,\n getSettings,\n useSettingValue,\n\n enhancedSettingKeys,\n defaultSettings,\n {\n useEnhancedEnabled: () => useGeneralSettingKeyInternal(\"enhancedSettings\"),\n getEnhancedEnabled: () => jotaiStore.get(__generalSettingAtom).enhancedSettings,\n },\n )\n}\n\nexport function useActionLanguage() {\n const actionLanguage = useGeneralSettingSelectorInternal((s) => s.actionLanguage)\n const language = useGeneralSettingSelectorInternal((s) => s.language)\n return (\n actionLanguage === DEFAULT_ACTION_LANGUAGE ? language : actionLanguage\n ) as SupportedLanguages\n}\n\nexport function getActionLanguage() {\n const { actionLanguage, language } = getGeneralSettingsInternal()\n return (\n actionLanguage === DEFAULT_ACTION_LANGUAGE ? language : actionLanguage\n ) as SupportedLanguages\n}\n\nexport function useHideAllReadSubscriptions() {\n const hideAllReadSubscriptions = useGeneralSettingKey(\"hideAllReadSubscriptions\")\n const unreadOnly = useGeneralSettingKey(\"unreadOnly\")\n return hideAllReadSubscriptions && unreadOnly\n}\n\nexport const generalServerSyncWhiteListKeys: (keyof GeneralSettings)[] = [\n \"appLaunchOnStartup\",\n \"sendAnonymousData\",\n \"language\",\n \"voice\",\n]\n\nexport const enhancedGeneralSettingKeys = new Set([\n \"groupByDate\",\n \"autoExpandLongSocialMedia\",\n])\n\nconst [\n useGeneralSettingKey,\n useGeneralSettingSelector,\n useGeneralSettingKeys,\n getGeneralSettings,\n useGeneralSettingValue,\n] = hookEnhancedSettings(\n useGeneralSettingKeyInternal,\n useGeneralSettingSelectorInternal,\n useGeneralSettingKeysInternal,\n getGeneralSettingsInternal,\n useGeneralSettingValueInternal,\n\n enhancedGeneralSettingKeys,\n defaultGeneralSettings,\n)\nexport {\n __generalSettingAtom,\n clearGeneralSettings,\n getGeneralSettings,\n initializeDefaultGeneralSettings,\n setGeneralSetting,\n useGeneralSettingKey,\n useGeneralSettingKeys,\n useGeneralSettingSelector,\n useGeneralSettingValue,\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/settings/integration.ts", "content": "import { createSettingAtom } from \"@follow/atoms/helper/setting.js\"\nimport { IN_ELECTRON } from \"@follow/shared/constants\"\nimport { defaultIntegrationSettings } from \"@follow/shared/settings/defaults\"\nimport type { IntegrationSettings } from \"@follow/shared/settings/interface\"\n\nexport const createDefaultSettings = (): IntegrationSettings => {\n const defaultSettings = { ...defaultIntegrationSettings }\n\n // Only include useBrowserFetch setting in Electron environment\n if (!IN_ELECTRON) {\n // Remove useBrowserFetch setting for non-Electron environments\n const { useBrowserFetch, ...settingsWithoutBrowserFetch } = defaultSettings\n return settingsWithoutBrowserFetch as IntegrationSettings\n }\n\n // Check if we have stored settings that might need migration\n const storedSettings = (() => {\n try {\n const stored = localStorage.getItem(\"follow:integration\")\n return stored ? JSON.parse(stored) : null\n } catch {\n return null\n }\n })()\n\n if (storedSettings?.customIntegration) {\n return {\n ...defaultSettings,\n ...storedSettings,\n }\n }\n\n return defaultSettings\n}\n\nexport const {\n useSettingKey: useIntegrationSettingKey,\n useSettingSelector: useIntegrationSettingSelector,\n setSetting: setIntegrationSetting,\n clearSettings: clearIntegrationSettings,\n initializeDefaultSettings: initializeDefaultIntegrationSettings,\n getSettings: getIntegrationSettings,\n useSettingValue: useIntegrationSettingValue,\n} = createSettingAtom(\"integration\", createDefaultSettings)\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/settings/ui.ts", "content": "import { createSettingAtom } from \"@follow/atoms/helper/setting.js\"\nimport { defaultUISettings } from \"@follow/shared/settings/defaults\"\nimport type { UISettings } from \"@follow/shared/settings/interface\"\n\nimport { getDefaultLanguage } from \"~/lib/language\"\nimport { DEFAULT_ACTION_ORDER } from \"~/modules/customize-toolbar/constant\"\n\nimport { hookEnhancedSettings } from \"./general\"\n\nexport const createDefaultUISettings = (): UISettings => ({\n ...defaultUISettings,\n // Action Order\n toolbarOrder: DEFAULT_ACTION_ORDER,\n // Discover\n discoverLanguage: getDefaultLanguage().startsWith(\"zh\") ? \"all\" : \"eng\",\n accentColor: \"orange\",\n})\n\nconst {\n useSettingKey: useUISettingKeyInternal,\n useSettingSelector: useUISettingSelectorInternal,\n useSettingKeys: useUISettingKeysInternal,\n setSetting: setUISetting,\n clearSettings: clearUISettings,\n initializeDefaultSettings: initializeDefaultUISettings,\n getSettings: getUISettingsInternal,\n useSettingValue: useUISettingValueInternal,\n settingAtom: __uiSettingAtom,\n} = createSettingAtom(\"ui\", createDefaultUISettings)\n\nexport const uiServerSyncWhiteListKeys: (keyof UISettings)[] = [\n \"uiFontFamily\",\n \"readerFontFamily\",\n \"opaqueSidebar\",\n \"accentColor\",\n // \"customCSS\",\n]\n\nexport const enhancedUISettingKeys = new Set([\n \"hideExtraBadge\",\n \"codeHighlightThemeLight\",\n \"codeHighlightThemeDark\",\n \"dateFormat\",\n \"readerRenderInlineStyle\",\n \"modalOverlay\",\n \"reduceMotion\",\n \"usePointerCursor\",\n \"opaqueSidebar\",\n])\n\nconst [useUISettingKey, useUISettingSelector, useUISettingKeys, getUISettings, useUISettingValue] =\n hookEnhancedSettings(\n useUISettingKeyInternal,\n useUISettingSelectorInternal,\n useUISettingKeysInternal,\n getUISettingsInternal,\n useUISettingValueInternal,\n\n enhancedUISettingKeys,\n defaultUISettings,\n )\nexport {\n __uiSettingAtom,\n clearUISettings,\n getUISettings,\n initializeDefaultUISettings,\n setUISetting,\n useUISettingKey,\n useUISettingKeys,\n useUISettingSelector,\n useUISettingValue,\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/sidebar.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nconst [\n ,\n ,\n internal_useSubscriptionColumnShow,\n ,\n internal_getSubscriptionShow,\n setTimelineColumnShow,\n] = createAtomHooks(atom(true))\n\nexport const useSubscriptionColumnShow = internal_useSubscriptionColumnShow\n\nexport const getSubscriptionColumnShow = internal_getSubscriptionShow\n\nexport { setTimelineColumnShow }\n\nexport const [\n ,\n ,\n useSubscriptionColumnTempShow,\n ,\n getSubscriptionColumnTempShow,\n setSubscriptionColumnTempShow,\n] = createAtomHooks(atom(false))\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/source-content.tsx", "content": "import { atom } from \"jotai\"\nimport { useCallback } from \"react\"\n\nimport { useModalStack } from \"~/components/ui/modal/stacked/hooks\"\nimport { createAtomHooks } from \"~/lib/jotai\"\nimport { SourceContentView } from \"~/modules/entry-content/components/SourceContentView\"\n\nexport const [, , useShowSourceContent, , getShowSourceContent, setShowSourceContent] =\n createAtomHooks(atom(false))\n\nexport const toggleShowSourceContent = () => setShowSourceContent(!getShowSourceContent())\nexport const enableShowSourceContent = () => setShowSourceContent(true)\nexport const resetShowSourceContent = () => setShowSourceContent(false)\n\nexport const useSourceContentModal = () => {\n const { present } = useModalStack()\n\n return useCallback(\n ({ title, src }: { title?: string; src: string }) => {\n present({\n id: src,\n title,\n content: () => ,\n resizeable: true,\n clickOutsideToDismiss: true,\n max: true,\n })\n },\n [present],\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/updater.ts", "content": "import type { StoreDistribution } from \"@follow-app/client-sdk\"\nimport { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport type UpdaterStatus = \"ready\"\ntype UpdaterStatusKind = \"app\" | \"renderer\" | \"pwa\" | \"distribution\"\n\ntype BaseUpdaterStatus = {\n type: T\n status: UpdaterStatus\n finishUpdate?: () => void\n}\n\ntype AppUpdaterStatus = BaseUpdaterStatus<\"app\">\n\ntype RendererUpdaterStatus = BaseUpdaterStatus<\"renderer\">\n\ntype PwaUpdaterStatus = BaseUpdaterStatus<\"pwa\">\n\ntype DistributionUpdaterStatus = BaseUpdaterStatus<\"distribution\"> & {\n distribution: StoreDistribution\n storeUrl: string\n storeVersion: string | null\n currentVersion: string | null\n}\n\nexport type UpdaterStatusAtom =\n | AppUpdaterStatus\n | RendererUpdaterStatus\n | PwaUpdaterStatus\n | DistributionUpdaterStatus\n | null\nexport const [, , useUpdaterStatus, , getUpdaterStatus, setUpdaterStatus] = createAtomHooks(\n atom(null as UpdaterStatusAtom),\n)\n" }, { "path": "apps/desktop/layer/renderer/src/atoms/user.ts", "content": "import { atom } from \"jotai\"\n\nimport { createAtomHooks } from \"~/lib/jotai\"\n\nexport const [, , useLoginModalShow, useSetLoginModalShow, getLoginModalShow, setLoginModalShow] =\n createAtomHooks(atom(false))\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/AppErrorBoundary.tsx", "content": "import type { FC, PropsWithChildren } from \"react\"\nimport { createElement, Suspense, useCallback } from \"react\"\n\nimport { getErrorFallback } from \"../errors\"\nimport type { ErrorComponentType } from \"../errors/enum\"\nimport PageErrorFallback from \"../errors/PageError\"\nimport type { FallbackRender } from \"./ErrorBoundary\"\nimport { ErrorBoundary } from \"./ErrorBoundary\"\n\nexport interface AppErrorBoundaryProps extends PropsWithChildren {\n height?: number | string\n errorType: ErrorComponentType\n}\n\nexport const AppErrorBoundary: FC<\n Omit & {\n errorType: ErrorComponentType[] | ErrorComponentType\n }\n> = ({ errorType, children }) => {\n if (Array.isArray(errorType)) {\n return (\n <>\n {errorType.reduceRight(\n (acc, type) => (\n \n {acc}\n \n ),\n children,\n )}\n \n )\n }\n\n return {children}\n}\n\ntype ErrorFallbackProps = Parameters[\"0\"]\nexport type AppErrorFallbackProps = ErrorFallbackProps & {}\nconst AppErrorBoundaryItem: FC = ({ errorType, children }) => {\n const fallbackRender = useCallback(\n (fallbackProps: ErrorFallbackProps) => {\n const errorElement = getErrorFallback(errorType)\n if (!errorElement) {\n return \n }\n return {createElement(getErrorFallback(errorType), fallbackProps)}\n },\n [errorType],\n )\n\n return {children}\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ErrorBoundary.tsx", "content": "import { tracker } from \"@follow/tracker\"\nimport type { PropsWithChildren, ReactNode } from \"react\"\nimport type { FallbackProps } from \"react-error-boundary\"\nimport { ErrorBoundary as ReactErrorBoundary } from \"react-error-boundary\"\n\nexport type ErrorFallbackProps = Omit &\n FallbackProps & {\n resetError: () => void\n }\nexport type FallbackRender = (props: ErrorFallbackProps) => ReactNode\n\ninterface ErrorBoundaryProps extends PropsWithChildren {\n fallback?: FallbackRender\n fallbackRender?: FallbackRender\n handled?: boolean\n beforeCapture?: (scope: unknown, error: unknown) => unknown\n}\n\nconst emptyFallback: FallbackRender = () => null\n\nexport const ErrorBoundary = ({\n children,\n fallback,\n fallbackRender,\n beforeCapture,\n}: ErrorBoundaryProps) => {\n const renderFallback = fallbackRender ?? fallback ?? emptyFallback\n\n const handleError = (rawError: unknown, info: { componentStack?: string | null }) => {\n const error = rawError instanceof Error ? rawError : new Error(String(rawError))\n\n if (beforeCapture?.(info, error) === false) {\n return\n }\n\n void tracker.manager.captureException(error, {\n source: \"desktop_error_boundary\",\n component_stack: info.componentStack,\n })\n }\n\n return (\n \n renderFallback({\n ...props,\n resetError: props.resetErrorBoundary,\n })\n }\n >\n {children}\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ErrorElement.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport { tracker } from \"@follow/tracker\"\nimport { useEffect, useRef } from \"react\"\nimport { isRouteErrorResponse, useNavigate, useRouteError } from \"react-router\"\nimport { toast } from \"sonner\"\n\nimport { removeAppSkeleton } from \"~/lib/app\"\nimport { attachOpenInEditor } from \"~/lib/dev\"\nimport { getNewIssueUrl } from \"~/lib/issues\"\nimport { clearLocalPersistStoreData } from \"~/store/utils/clear\"\n\nimport { PoweredByFooter } from \"./PoweredByFooter\"\n\nexport function ErrorElement() {\n const error = useRouteError()\n const navigate = useNavigate()\n const message = isRouteErrorResponse(error)\n ? `${error.status} ${error.statusText}`\n : error instanceof Error\n ? error.message\n : JSON.stringify(error)\n const stack = error instanceof Error ? error.stack : null\n\n useEffect(() => {\n removeAppSkeleton()\n }, [])\n\n useEffect(() => {\n console.error(\"Error handled by React Router default ErrorBoundary:\", error)\n void tracker.manager.captureException(error, {\n source: \"desktop_router_error_element\",\n })\n }, [error])\n\n const reloadRef = useRef(false)\n if (\n message.startsWith(\"Failed to fetch dynamically imported module\") &&\n window.sessionStorage.getItem(\"reload\") !== \"1\"\n ) {\n if (reloadRef.current) return null\n toast.info(\"Web app has been updated so it needs to be reloaded.\")\n window.sessionStorage.setItem(\"reload\", \"1\")\n window.location.reload()\n reloadRef.current = true\n return null\n }\n\n return (\n
\n
\n
\n \n

Sorry, {APP_NAME} has encountered an error

\n
\n

{message}

\n {import.meta.env.DEV && stack ? (\n 
\n          {attachOpenInEditor(stack)}\n
\n ) : null}\n\n

\n {APP_NAME} has a temporary problem, click the button below to try reloading the app or\n another solution?\n

\n\n
\n {\n clearLocalPersistStoreData()\n window.location.href = \"/\"\n }}\n >\n Reset Local Database\n \n {\n navigate(\"/\")\n window.location.reload()\n }}\n >\n Reload\n \n
\n\n \n
\n\n \n
\n )\n}\n\nexport const FeedbackIssue = (_props: {\n message: string\n stack: string | null | undefined\n error?: unknown\n}) => (\n

\n Still having this issue? Please give feedback in GitHub, thanks!\n \n Submit Issue\n \n

\n)\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ErrorTooltip.tsx", "content": "import {\n Tooltip,\n TooltipContent,\n TooltipPortal,\n TooltipTrigger,\n} from \"@follow/components/ui/tooltip/index.js\"\nimport dayjs from \"dayjs\"\nimport { useTranslation } from \"react-i18next\"\n\nexport function ErrorTooltip({\n errorAt,\n errorMessage,\n children,\n showWhenError = false,\n}: {\n errorMessage?: string | null\n errorAt?: string | null\n children: React.ReactNode\n showWhenError?: boolean\n}) {\n const { t } = useTranslation()\n if (!errorAt || !errorMessage) {\n return showWhenError ? children : null\n }\n return (\n \n {children}\n \n \n
\n \n {t(\"feed_item.error_since\")}{\" \"}\n {dayjs.duration(dayjs(errorAt).diff(dayjs(), \"minute\"), \"minute\").humanize(true)}\n
\n {!!errorMessage && (\n
\n \n {errorMessage}\n
\n )}\n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ExPromise.tsx", "content": "import { useLayoutEffect, useState } from \"react\"\nimport type { JSX } from \"react/jsx-runtime\"\n\nconst NOT_RESOLVED = Symbol(\"NOT_RESOLVED\")\nexport const ExPromise = ({\n children,\n promise,\n}: {\n promise: Promise\n children: (value: T) => JSX.Element\n}) => {\n // use() is a hook that returns the value of the promise, but in react 19\n\n const [value, setValue] = useState(NOT_RESOLVED)\n useLayoutEffect(() => {\n promise.then(setValue)\n }, [promise])\n\n return value === NOT_RESOLVED ? null : children(value as T)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/Focusable.tsx", "content": "import type { FocusableProps } from \"@follow/components/common/Focusable/Focusable.js\"\nimport { Focusable as FocusableComponent } from \"@follow/components/common/Focusable/Focusable.js\"\n\nimport { FloatingLayerScope, HotkeyScope } from \"~/constants\"\n\ninterface BizFocusableProps extends Omit {\n scope: HotkeyScope\n}\nexport const Focusable = FocusableComponent as Component<\n Prettify &\n React.DetailedHTMLProps, HTMLDivElement>\n>\n\nexport const FocusablePresets = {\n isNotFloatingLayerScope: (v: Set) => !FloatingLayerScope.some((s) => v.has(s)),\n isSubscriptionList: (scope: Set) => {\n return (\n scope.has(HotkeyScope.SubscriptionList) || (scope.has(HotkeyScope.Home) && scope.size === 1)\n )\n },\n\n isSubscriptionOrTimeline: (v: Set) => {\n return v.has(HotkeyScope.SubscriptionList) || v.has(HotkeyScope.Timeline) || v.size === 0\n },\n isTimeline: (v) => v.has(HotkeyScope.Timeline) && !v.has(HotkeyScope.EntryRender),\n isEntryRender: (v) => v.has(HotkeyScope.EntryRender),\n isAIChat: (v) => v.has(HotkeyScope.AIChat),\n} satisfies Record) => boolean>\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/Fragment.tsx", "content": "import type { FC, ReactNode } from \"react\"\nimport { Fragment } from \"react\"\n\nexport const SafeFragment: FC<{ children: ReactNode }> = ({ children, ..._rest }) => (\n {children}\n)\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ImpressionTracker.tsx", "content": "import type { AllTrackers, TrackerPoints } from \"@follow/tracker\"\nimport { tracker } from \"@follow/tracker\"\nimport { memo, useState } from \"react\"\nimport { useInView } from \"react-intersection-observer\"\n\ntype ImpressionProps = {\n event: T\n onTrack?: () => any\n // @ts-expect-error FIXME\n properties?: Parameters\n children: React.ReactNode\n}\n\nexport function ImpressionView(\n props: ImpressionProps & { shouldTrack?: boolean },\n) {\n const { shouldTrack = true, ...rest } = props\n if (!shouldTrack) {\n return <>{props.children}\n }\n return \n}\n\nfunction ImpressionViewImpl(props: ImpressionProps) {\n const [impression, setImpression] = useState(false)\n\n const { ref } = useInView({\n initialInView: false,\n triggerOnce: true,\n onChange(inView) {\n if (!inView) {\n return\n }\n setImpression(true)\n\n // @ts-expect-error\n tracker[props.event]?.apply(null, props.properties)\n props.onTrack?.()\n },\n })\n\n return (\n <>\n {props.children}\n {!impression && }\n \n )\n}\nconst MemoImpressionViewImpl = memo(ImpressionViewImpl)\nMemoImpressionViewImpl.displayName = \"ImpressionView\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/LCPEndDetector.tsx", "content": "import { jotaiStore } from \"@follow/utils\"\nimport { atom } from \"jotai\"\nimport { useEffect } from \"react\"\n\nconst LCPEndAtom = atom(false)\n\n/**\n * To skip page transition when first load, improve LCP\n */\nexport const LCPEndDetector = () => {\n useEffect(() => {\n let hasEnded = false\n\n const timeoutIds: Array> = []\n const rafIds: number[] = []\n const idleCallbackIds: number[] = []\n\n const scheduleRaf = (cb: FrameRequestCallback) => {\n if (typeof window !== \"undefined\" && window.requestAnimationFrame) {\n const id = window.requestAnimationFrame(cb)\n rafIds.push(id)\n } else {\n const id = setTimeout(() => cb(performance.now()), 16)\n timeoutIds.push(id)\n }\n }\n\n const markEnded = () => {\n if (hasEnded) return\n hasEnded = true\n\n // Defer to ensure layout/paint and initial CSS transitions settle\n scheduleRaf(() => {\n scheduleRaf(() => {\n // Prefer idle if available to avoid jank\n const ric = (typeof window !== \"undefined\" && (window as any).requestIdleCallback) as\n | ((cb: () => void, opts?: { timeout?: number }) => number)\n | undefined\n if (ric) {\n const id = ric(() => jotaiStore.set(LCPEndAtom, true), {\n timeout: 200,\n }) as unknown as number\n idleCallbackIds.push(id)\n } else {\n const id = setTimeout(() => jotaiStore.set(LCPEndAtom, true), 0)\n timeoutIds.push(id)\n }\n })\n })\n }\n\n // If PerformanceObserver for LCP is available, prefer it\n const supportsPO = typeof PerformanceObserver !== \"undefined\"\n let po: PerformanceObserver | undefined\n\n const onHidden = () => markEnded()\n const onVisibilityChange = () => {\n if (document.visibilityState === \"hidden\") onHidden()\n }\n const onPageHide = onHidden\n const onLoad = () => markEnded()\n\n let safetyTimer: ReturnType | undefined\n let fallbackEndTimer: ReturnType | undefined\n\n if (supportsPO) {\n try {\n po = new PerformanceObserver((list) => {\n const entries = list.getEntries()\n if (entries && entries.length > 0) {\n // Any LCP entry indicates a meaningful paint; we can mark end soon\n markEnded()\n }\n })\n // buffered: true ensures we get entries that occurred before observer creation\n po.observe({ type: \"largest-contentful-paint\", buffered: true } as PerformanceObserverInit)\n } catch {\n // Ignore observer errors and rely on fallback\n }\n\n // When the page is hidden or unloaded, LCP is finalized\n window.addEventListener(\"visibilitychange\", onVisibilityChange, { once: true })\n window.addEventListener(\"pagehide\", onPageHide, { once: true })\n window.addEventListener(\"load\", onLoad, { once: true })\n\n // Absolute safety net: if nothing fires, end after 3s\n safetyTimer = setTimeout(() => markEnded(), 3000)\n timeoutIds.push(safetyTimer)\n } else {\n // Ultimate fallback for environments without PO\n fallbackEndTimer = setTimeout(() => {\n jotaiStore.set(LCPEndAtom, true)\n }, 2000)\n timeoutIds.push(fallbackEndTimer)\n }\n\n return () => {\n if (po) po.disconnect()\n const caf = typeof window !== \"undefined\" && window.cancelAnimationFrame\n if (caf) {\n rafIds.forEach((id) => (window.cancelAnimationFrame as (h: number) => void)(id))\n }\n const cic = (typeof window !== \"undefined\" && (window as any).cancelIdleCallback) as\n | ((id: number) => void)\n | undefined\n if (cic) idleCallbackIds.forEach((id) => cic(id))\n timeoutIds.forEach((id) => clearTimeout(id))\n if (safetyTimer) clearTimeout(safetyTimer)\n if (fallbackEndTimer) clearTimeout(fallbackEndTimer)\n\n window.removeEventListener(\"visibilitychange\", onVisibilityChange)\n window.removeEventListener(\"pagehide\", onPageHide)\n window.removeEventListener(\"load\", onLoad)\n }\n }, [])\n return null\n}\n\n// eslint-disable-next-line react-refresh/only-export-components\nexport const isLCPEnded = () => jotaiStore.get(LCPEndAtom)\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/LoadMoreIndicator.tsx", "content": "import { LoadingCircle } from \"@follow/components/ui/loading/index.jsx\"\nimport { useInView } from \"react-intersection-observer\"\n\nexport const LoadMoreIndicator: Component<{\n onLoading: () => void\n}> = ({ onLoading, children, className }) => {\n const { ref } = useInView({\n rootMargin: \"1px\",\n onChange(inView) {\n if (inView) onLoading()\n },\n })\n return (\n
\n {children ?? }\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/LoadRemixAsyncComponent.tsx", "content": "import { LoadingCircle } from \"@follow/components/ui/loading/index.jsx\"\nimport type { FC, ReactNode } from \"react\"\nimport { createElement, useEffect, useState } from \"react\"\n\nexport const LoadRemixAsyncComponent: FC<{\n loader: () => Promise\n Header: FC<{ loader: () => any; [key: string]: any }>\n}> = ({ loader, Header }) => {\n const [loading, setLoading] = useState(true)\n\n const [Component, setComponent] = useState<{ c: () => ReactNode }>({\n c: () => null,\n })\n\n useEffect(() => {\n let isUnmounted = false\n setLoading(true)\n loader()\n .then((module) => {\n if (!module.Component) {\n return\n }\n if (isUnmounted) return\n\n const { loader } = module\n setComponent({\n c: () => (\n <>\n
\n \n \n ),\n })\n })\n .finally(() => {\n setLoading(false)\n })\n return () => {\n isUnmounted = true\n }\n }, [Header, loader])\n\n if (loading) {\n return (\n
\n \n
\n )\n }\n\n return createElement(Component.c)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/Motion.tsx", "content": "import type { TargetAndTransition } from \"motion/react\"\nimport { m as M } from \"motion/react\"\nimport { createElement } from \"react\"\n\nimport { useReduceMotion } from \"~/hooks/biz/useReduceMotion\"\n\nimport { isLCPEnded } from \"./LCPEndDetector\"\n\ntype WithLCPOptimization

= P & { lcpOptimization?: boolean }\n// Narrow exported proxy type so each motion component accepts `lcpOptimization`\nexport type MotionProxy = {\n [K in keyof typeof M]: (typeof M)[K] extends React.ComponentType\n ? React.ComponentType>\n : (typeof M)[K]\n}\n\nconst cacheMap = new Map()\nexport const m: MotionProxy = new Proxy(M, {\n get(target, p: string) {\n const Component = target[p]\n\n if (cacheMap.has(p)) {\n return cacheMap.get(p)\n }\n const MotionComponent = ({ ref, lcpOptimization, ...props }) => {\n const shouldReduceMotion = useReduceMotion()\n const nextProps = { ...props }\n if (shouldReduceMotion) {\n if (props.exit) {\n nextProps.exit = {\n opacity: 0,\n transition: (props.exit as TargetAndTransition).transition,\n }\n }\n\n if (props.initial) {\n nextProps.initial = {\n opacity: 0,\n }\n }\n nextProps.animate = {\n opacity: 1,\n }\n }\n\n // Disable initial animation before hydration ends to optimize LCP\n if (lcpOptimization && !isLCPEnded()) {\n nextProps.initial = false\n }\n\n return createElement(Component, { ...nextProps, ref })\n }\n\n cacheMap.set(p, MotionComponent)\n\n return MotionComponent\n },\n})\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/NotFound.tsx", "content": "import { Logo } from \"@follow/components/icons/logo.jsx\"\nimport { Button } from \"@follow/components/ui/button/index.js\"\nimport { ELECTRON_BUILD } from \"@follow/shared/constants\"\nimport { useEffect } from \"react\"\nimport type { Location } from \"react-router\"\nimport { Navigate, useLocation, useNavigate } from \"react-router\"\n\nimport { useSyncTheme } from \"~/hooks/common\"\nimport { removeAppSkeleton } from \"~/lib/app\"\n\nimport { PoweredByFooter } from \"./PoweredByFooter\"\n\nclass AccessNotFoundError extends Error {\n constructor(\n message: string,\n public path: string,\n public location: Location,\n ) {\n super(message)\n this.name = \"AccessNotFoundError\"\n }\n\n override toString() {\n return `${this.name}: ${this.message} at ${this.path}`\n }\n}\nexport const NotFound = () => {\n const location = useLocation()\n useSyncTheme()\n\n useEffect(() => {\n if (!ELECTRON_BUILD) {\n return\n }\n console.error(\n new AccessNotFoundError(\n \"Electron app got to a 404 page, this should not happen\",\n location.pathname,\n location,\n ),\n )\n }, [location])\n\n useEffect(() => {\n removeAppSkeleton()\n }, [])\n const navigate = useNavigate()\n\n if (location.pathname.endsWith(\"/index.html\")) {\n return \n }\n\n return (\n

\n
\n
\n \n
\n

\n You have come to a desert of knowledge where there is nothing.\n

\n

\n Current path: {location.pathname}\n

\n\n

\n \n

\n
\n\n \n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/PoweredByFooter.tsx", "content": "import { Folo } from \"@follow/components/icons/folo.js\"\nimport { Logo } from \"@follow/components/icons/logo.jsx\"\nimport { cn } from \"@follow/utils/utils\"\nimport pkg from \"@pkg\"\n\nexport const PoweredByFooter: Component = ({ className }) => (\n
\n {new Date().getFullYear()}\n {\" \"}\n \n \n \n
\n)\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ProviderComposer.tsx", "content": "\"use client\"\n\nimport type { JSX } from \"react\"\nimport { cloneElement } from \"react\"\n\nexport const ProviderComposer: Component<{\n contexts: JSX.Element[]\n}> = ({ contexts, children }) =>\n contexts.reduceRight(\n (kids: any, parent: any) => cloneElement(parent, { children: kids }),\n children,\n )\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ReloadPrompt.tsx", "content": "import { useEffect } from \"react\"\nimport { useRegisterSW } from \"virtual:pwa-register/react\"\n\nimport { setUpdaterStatus } from \"~/atoms/updater\"\n\n// check for updates every hour\nconst period = 60 * 60 * 1000\n\nexport function ReloadPrompt() {\n const {\n needRefresh: [needRefresh],\n updateServiceWorker,\n } = useRegisterSW({\n onRegisteredSW(swUrl, r) {\n if (period <= 0) return\n if (r?.active?.state === \"activated\") {\n registerPeriodicSync(period, swUrl, r)\n } else if (r?.installing) {\n r.installing.addEventListener(\"statechange\", (e) => {\n const sw = e.target as ServiceWorker\n if (sw.state === \"activated\") registerPeriodicSync(period, swUrl, r)\n })\n }\n },\n })\n\n useEffect(() => {\n if (needRefresh) {\n setUpdaterStatus({\n type: \"pwa\",\n status: \"ready\",\n finishUpdate: () => {\n updateServiceWorker(true)\n },\n })\n }\n }, [needRefresh, updateServiceWorker])\n\n return null\n}\n\n/**\n * This function will register a periodic sync check every hour, you can modify the interval as needed.\n */\nfunction registerPeriodicSync(period: number, swUrl: string, r: ServiceWorkerRegistration) {\n if (period <= 0) return\n\n setInterval(async () => {\n if (\"onLine\" in navigator && !navigator.onLine) return\n\n const resp = await fetch(swUrl, {\n cache: \"no-store\",\n headers: {\n cache: \"no-store\",\n \"cache-control\": \"no-cache\",\n },\n })\n\n if (resp?.status === 200) await r.update()\n }, period)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/ShadowDOM.tsx", "content": "import { MemoedDangerousHTMLStyle } from \"@follow/components/common/MemoedDangerousHTMLStyle.js\"\nimport { useIsDark } from \"@follow/hooks\"\nimport { getAccentColorValue } from \"@follow/shared/settings/constants\"\nimport { hexToHslString } from \"@follow/utils\"\nimport { nanoid } from \"nanoid\"\nimport type { FC, PropsWithChildren, ReactNode } from \"react\"\nimport { createContext, createElement, use, useLayoutEffect, useMemo, useState } from \"react\"\nimport root from \"react-shadow\"\n\nimport { useUISettingKeys } from \"~/atoms/settings/ui\"\nimport { useReduceMotion } from \"~/hooks/biz/useReduceMotion\"\nimport type { TextSelectionEvent } from \"~/lib/simple-text-selection\"\nimport { addTextSelectionListener } from \"~/lib/simple-text-selection\"\n\nconst ShadowDOMContext = createContext(false)\n\nconst weakMapElementKey = new WeakMap()\nconst cloneStylesElement = () => {\n const $styles = document.head.querySelectorAll(\"style\").values()\n const reactNodes = [] as ReactNode[]\n\n for (const $style of $styles) {\n let key = weakMapElementKey.get($style)\n\n if (!key) {\n key = nanoid(8)\n\n weakMapElementKey.set($style, key)\n }\n\n reactNodes.push(\n createElement(MemoedDangerousHTMLStyle, {\n key,\n children: $style.innerHTML,\n }),\n )\n\n const styles = getLinkedStaticStyleSheets()\n\n for (const style of styles) {\n let key = weakMapElementKey.get(style.ref)\n if (!key) {\n key = nanoid(8)\n weakMapElementKey.set(style.ref, key)\n }\n\n reactNodes.push(\n createElement(MemoedDangerousHTMLStyle, {\n key,\n children: style.cssText,\n [\"data-href\"]: style.ref.href,\n }),\n )\n }\n }\n\n return reactNodes\n}\nexport const ShadowDOM: FC<\n PropsWithChildren> & {\n injectHostStyles?: boolean\n textSelectionEnabled?: boolean\n onTextSelect?: (event: TextSelectionEvent) => void\n onSelectionClear?: () => void\n }\n> & {\n useIsShadowDOM: () => boolean\n} = (props) => {\n const {\n injectHostStyles = true,\n textSelectionEnabled = false,\n onTextSelect,\n onSelectionClear,\n ...rest\n } = props\n\n const [stylesElements, setStylesElements] = useState(() =>\n injectHostStyles ? cloneStylesElement() : [],\n )\n\n const [el, setEl] = useState<{ shadowRoot: ShadowRoot } | null>(null)\n\n useLayoutEffect(() => {\n if (!el) return\n const { shadowRoot } = el\n\n if (!textSelectionEnabled || !shadowRoot || !onTextSelect) return\n\n return addTextSelectionListener(shadowRoot, onTextSelect, onSelectionClear)\n }, [textSelectionEnabled, onTextSelect, onSelectionClear, el])\n\n useLayoutEffect(() => {\n if (!injectHostStyles) return\n const mutationObserver = new MutationObserver(() => {\n setStylesElements(cloneStylesElement())\n })\n mutationObserver.observe(document.head, {\n childList: true,\n subtree: true,\n })\n\n return () => {\n mutationObserver.disconnect()\n }\n }, [injectHostStyles])\n\n const dark = useIsDark()\n\n const reduceMotion = useReduceMotion()\n const [uiFont, usePointerCursor, accentColor] = useUISettingKeys([\n \"uiFontFamily\",\n \"usePointerCursor\",\n \"accentColor\",\n ])\n\n return (\n // @ts-expect-error\n \n \n ({\n fontFamily: `${uiFont},\"SN Pro\", system-ui, sans-serif`,\n \"--pointer\": usePointerCursor ? \"pointer\" : \"default\",\n \"--fo-a\": hexToHslString(getAccentColorValue(accentColor)[dark ? \"dark\" : \"light\"]),\n }),\n [uiFont, usePointerCursor, accentColor, dark],\n )}\n id=\"shadow-html\"\n data-motion-reduce={reduceMotion}\n data-theme={dark ? \"dark\" : \"light\"}\n className=\"font-theme\"\n >\n {injectHostStyles ? stylesElements : null}\n {props.children}\n
\n \n \n )\n}\n\nShadowDOM.useIsShadowDOM = () => use(ShadowDOMContext)\n\nconst cacheCssTextMap = {} as Record\n\nfunction getLinkedStaticStyleSheets() {\n const $links = document.head\n .querySelectorAll(\"link[rel=stylesheet]\")\n .values() as unknown as HTMLLinkElement[]\n\n const styleSheetMap = new WeakMap()\n\n const cssArray = [] as { cssText: string; ref: HTMLLinkElement }[]\n\n for (const sheet of document.styleSheets) {\n if (!sheet.href) continue\n if (!sheet.ownerNode) continue\n styleSheetMap.set(sheet.ownerNode, sheet)\n }\n\n for (const $link of $links) {\n const sheet = styleSheetMap.get($link)\n if (!sheet) continue\n if (!sheet.href) continue\n const hasCache = cacheCssTextMap[sheet.href]\n if (!hasCache) {\n if (!sheet.href) continue\n try {\n const rules = sheet.cssRules || sheet.rules\n let cssText = \"\"\n for (const rule of rules) {\n cssText += rule.cssText\n }\n cacheCssTextMap[sheet.href] = cssText\n } catch (err) {\n console.error(\"Failed to get cssText for\", sheet.href, err)\n }\n }\n\n cssArray.push({\n cssText: cacheCssTextMap[sheet.href]!,\n ref: $link,\n })\n }\n\n return cssArray\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/SharePanel.tsx", "content": "import { IN_ELECTRON } from \"@follow/shared/constants\"\nimport { getEntry } from \"@follow/store/entry/getter\"\nimport { cn } from \"@follow/utils/utils\"\nimport { useCallback } from \"react\"\nimport { useTranslation } from \"react-i18next\"\nimport { toast } from \"sonner\"\n\nimport { ipcServices } from \"~/lib/client\"\nimport { copyToClipboard } from \"~/lib/clipboard\"\n\ninterface SharePanelProps {\n entryId: string\n}\n\ninterface ShareOption {\n id: string\n label: string\n icon: string\n action: () => Promise | void\n color?: string\n bgColor?: string\n}\n\ninterface SocialShareOption {\n id: string\n label: string\n icon: string\n url: string\n color: string\n bgColor: string\n}\n\nconst socialOptions: SocialShareOption[] = [\n {\n id: \"twitter\",\n label: \"X\",\n icon: tw`i-mgc-social-x-cute-re`,\n url: \"https://x.com/intent/tweet?text={text}&url={url}\",\n color: \"text-white\",\n bgColor: \"bg-black\",\n },\n {\n id: \"facebook\",\n label: \"Facebook\",\n icon: tw`i-mgc-facebook-cute-re`,\n url: \"https://www.facebook.com/sharer/sharer.php?u={url}\",\n color: \"text-white\",\n bgColor: \"bg-[#1877F2]\",\n },\n {\n id: \"telegram\",\n label: \"Telegram\",\n icon: tw`i-mgc-telegram-cute-re`,\n url: \"https://t.me/share/url?url={url}&text={text}\",\n color: \"text-white\",\n bgColor: \"bg-[#0088CC]\",\n },\n {\n id: \"weibo\",\n label: \"微博\",\n icon: tw`i-mgc-weibo-cute-re`,\n url: \"https://service.weibo.com/share/share.php?url={url}&title={text}\",\n color: \"text-white\",\n bgColor: \"bg-[#E6162D]\",\n },\n]\n\nconst getShareUrl = (entryId: string) => {\n const entry = getEntry(entryId)\n if (!entry) return \"\"\n\n // Temporarily use the original link\n return entry.url!\n // const params = getRouteParams()\n\n // let subscriptionId = \"all\"\n\n // if (params.feedId) {\n // subscriptionId = params.feedId\n // } else if (params.inboxId) {\n // subscriptionId = params.inboxId\n // } else if (params.listId) {\n // subscriptionId = params.listId\n // }\n\n // return UrlBuilder.shareEntry(entryId, {\n // view: params.view,\n // subscriptionId,\n // })\n}\n\nexport const SharePanel = ({ entryId }: SharePanelProps) => {\n const { t } = useTranslation()\n\n const generateShareContent = useCallback(\n (entry: ReturnType) => {\n if (!entry) return null\n\n const { title, description } = entry\n const shareUrl = getShareUrl(entryId)\n\n // Limit text to 50 characters with ellipsis\n const truncateText = (text: string, maxLength = 50) => {\n return text.length > maxLength ? `${text.slice(0, maxLength)}...` : text\n }\n\n const shareTitle = `${title || t(\"share.default_title\")} - Folo`\n const baseText = description || title || t(\"share.default_description\")\n const truncatedText = truncateText(baseText)\n const shareText = `${truncatedText} | ${t(\"share.discover_more\")}`\n\n return {\n title: shareTitle,\n text: shareText,\n url: shareUrl,\n }\n },\n [entryId, t],\n )\n\n const handleNativeShare = useCallback(async () => {\n const entry = getEntry(entryId)\n const shareContent = generateShareContent(entry)\n\n if (!shareContent) return\n\n try {\n if (IN_ELECTRON) {\n // Use Electron's share menu\n await ipcServices?.menu.showShareMenu(shareContent.url)\n } else if (navigator.share) {\n // Use Web Share API\n await navigator.share({\n title: shareContent.title,\n text: shareContent.text,\n url: shareContent.url,\n })\n } else {\n // Fallback to copying link\n await copyToClipboard(shareContent.url)\n toast.success(t(\"share.link_copied\"))\n }\n } catch {\n // If sharing fails, copy link as fallback\n try {\n await copyToClipboard(shareContent.url)\n toast.success(t(\"share.link_copied\"))\n } catch {\n toast.error(t(\"share.copy_failed\"))\n }\n }\n }, [entryId, generateShareContent, t])\n\n const handleCopyLink = useCallback(async () => {\n const shareUrl = getShareUrl(entryId)\n try {\n await copyToClipboard(shareUrl)\n toast.success(t(\"share.link_copied\"))\n } catch {\n toast.error(t(\"share.copy_failed\"))\n }\n }, [entryId, t])\n\n const handleSocialShare = useCallback(\n (shareUrlTemplate: string) => {\n const entry = getEntry(entryId)\n const shareContent = generateShareContent(entry)\n\n if (!shareContent) return\n\n const encodedUrl = encodeURIComponent(shareContent.url)\n const shareTitle = encodeURIComponent(shareContent.title)\n const shareText = encodeURIComponent(shareContent.text)\n\n const finalUrl = shareUrlTemplate\n .replace(\"{url}\", encodedUrl)\n .replace(\"{title}\", shareTitle)\n .replace(\"{text}\", shareText)\n\n window.open(finalUrl, \"_blank\", \"width=600,height=400\")\n },\n [entryId, generateShareContent],\n )\n\n const actionOptions: ShareOption[] = [\n ...(IN_ELECTRON || (typeof navigator !== \"undefined\" && \"share\" in navigator)\n ? [\n {\n id: \"native-share\",\n label: t(\"share.system_share\"),\n icon: \"i-mgc-share-forward-cute-re\",\n action: handleNativeShare,\n color: \"text-blue-500\",\n },\n ]\n : []),\n {\n id: \"copy-link\",\n label: t(\"share.copy_link\"),\n icon: \"i-mgc-link-cute-re\",\n action: handleCopyLink,\n },\n ]\n\n return (\n
\n
\n

{t(\"share.title\")}

\n {(() => {\n const entry = getEntry(entryId)\n const title = entry?.title\n return title ? (\n

\n {title}\n

\n ) : null\n })()}\n
\n\n
\n
\n

\n {t(\"share.social_media\")}\n

\n
\n
\n {socialOptions.map((option) => (\n handleSocialShare(option.url)}\n >\n \n \n
\n {option.label}\n \n ))}\n
\n
\n\n
\n
\n

\n {t(\"share.actions\")}\n

\n
\n
\n {actionOptions.map((option) => (\n option.action()}\n >\n
\n \n \n
\n {option.label}\n
\n \n ))}\n
\n
\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/common/withAppErrorBoundary.tsx", "content": "import type { FC } from \"react\"\nimport { createElement } from \"react\"\n\nimport type { ErrorComponentType } from \"../errors/enum\"\nimport { AppErrorBoundary } from \"./AppErrorBoundary\"\n\ninterface WithErrorBoundaryOptions {\n errorType: ErrorComponentType | ErrorComponentType[]\n height?: number | string\n}\n\n/**\n * Higher-order component that wraps a component with AppErrorBoundary\n * @param Component - The component to wrap with ErrorBoundary\n * @param options - Configuration options for the ErrorBoundary wrapper\n * @returns A new component wrapped with ErrorBoundary\n */\nexport function withAppErrorBoundary

(\n Component: FC

,\n options: WithErrorBoundaryOptions,\n): FC

{\n const { errorType, height } = options\n\n const WrappedComponent = (props: P) => {\n return createElement(AppErrorBoundary, { errorType, height }, createElement(Component, props))\n }\n\n WrappedComponent.displayName = `withErrorBoundary(${Component.displayName || Component.name || \"Component\"})`\n\n return WrappedComponent as FC

\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/EntryNotFound.tsx", "content": "import { Logo } from \"@follow/components/icons/logo.jsx\"\nimport { Button } from \"@follow/components/ui/button/index.js\"\nimport type { FC } from \"react\"\nimport { useNavigate } from \"react-router\"\n\nimport { CustomSafeError } from \"../../errors/CustomSafeError\"\nimport type { AppErrorFallbackProps } from \"../common/AppErrorBoundary\"\nimport { useResetErrorWhenRouteChange } from \"./helper\"\n\nconst EntryNotFoundErrorFallback: FC = ({ resetError, error }) => {\n if (!(error instanceof EntryNotFound)) {\n throw error\n }\n\n useResetErrorWhenRouteChange(resetError)\n const navigate = useNavigate()\n return (\n

\n
\n
\n \n
\n

\n The entry you're looking for could not be found. It may have been removed or the URL is\n incorrect.\n

\n\n
\n {\n navigate(\"/\")\n setTimeout(() => {\n resetError()\n }, 100)\n }}\n >\n Back\n \n
\n
\n
\n )\n}\nexport default EntryNotFoundErrorFallback\n\nexport class EntryNotFound extends CustomSafeError {\n constructor() {\n super(\"Entry 404\")\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/FeedNotFound.tsx", "content": "import { Logo } from \"@follow/components/icons/logo.jsx\"\nimport { Button } from \"@follow/components/ui/button/index.js\"\nimport type { FC } from \"react\"\nimport { useNavigate } from \"react-router\"\n\nimport { CustomSafeError } from \"../../errors/CustomSafeError\"\nimport type { AppErrorFallbackProps } from \"../common/AppErrorBoundary\"\nimport { useResetErrorWhenRouteChange } from \"./helper\"\n\nconst FeedNotFoundErrorFallback: FC = ({ resetError, error }) => {\n if (!(error instanceof FeedNotFound)) {\n throw error\n }\n\n useResetErrorWhenRouteChange(resetError)\n const navigate = useNavigate()\n return (\n
\n
\n
\n \n
\n

\n There is no feed with the given ID. Please check the URL and retry.\n

\n\n
\n {\n navigate(\"/\")\n setTimeout(() => {\n resetError()\n }, 100)\n }}\n >\n Back\n \n
\n
\n
\n )\n}\nexport default FeedNotFoundErrorFallback\n\nexport class FeedNotFound extends CustomSafeError {\n constructor() {\n super(\"Feed 404\")\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/ModalError.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport type { FC } from \"react\"\n\nimport { attachOpenInEditor } from \"~/lib/dev\"\n\nimport type { AppErrorFallbackProps } from \"../common/AppErrorBoundary\"\nimport { FeedbackIssue } from \"../common/ErrorElement\"\nimport { m } from \"../common/Motion\"\nimport { useCurrentModal } from \"../ui/modal/stacked/hooks\"\nimport { parseError } from \"./helper\"\n\nconst ModalErrorFallback: FC = (props) => {\n const { message, stack } = parseError(props.error)\n const modal = useCurrentModal()\n return (\n \n
\n
\n \n
\n
{message}
\n {import.meta.env.DEV && stack ? (\n 
\n            {attachOpenInEditor(stack)}\n
\n ) : null}\n\n

\n {APP_NAME} has a temporary problem, click the button below to try reloading the app or\n another solution?\n

\n\n
\n \n \n
\n\n \n
\n \n )\n}\nexport default ModalErrorFallback\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/PageError.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport type { FC } from \"react\"\n\nimport { attachOpenInEditor } from \"~/lib/dev\"\n\nimport type { AppErrorFallbackProps } from \"../common/AppErrorBoundary\"\nimport { FeedbackIssue } from \"../common/ErrorElement\"\nimport { parseError, useResetErrorWhenRouteChange } from \"./helper\"\n\nconst PageErrorFallback: FC = (props) => {\n const { message, stack } = parseError(props.error)\n useResetErrorWhenRouteChange(props.resetError)\n return (\n
\n
\n
\n \n
\n
{message}
\n {import.meta.env.DEV && stack ? (\n 
\n            {attachOpenInEditor(stack)}\n
\n ) : null}\n\n

\n {APP_NAME} has a temporary problem, click the button below to try reloading the app or\n another solution?\n

\n\n
\n \n\n \n
\n\n \n
\n
\n )\n}\n\nexport default PageErrorFallback\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/RSSHubError.tsx", "content": "import type { FC } from \"react\"\n\nimport { attachOpenInEditor } from \"~/lib/dev\"\n\nimport type { AppErrorFallbackProps } from \"../common/AppErrorBoundary\"\nimport { FeedbackIssue } from \"../common/ErrorElement\"\nimport { parseError } from \"./helper\"\n\nconst RSSHubErrorFallback: FC = (props) => {\n const { message, stack } = parseError(props.error)\n\n return (\n
\n
\n

\n \n RSSHub has a temporary problem, please contact the our team.\n

\n
{message}
\n {import.meta.env.DEV && stack ? (\n 
\n            {attachOpenInEditor(stack)}\n
\n ) : null}\n\n \n
\n
\n )\n}\nexport default RSSHubErrorFallback\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/enum.ts", "content": "export enum ErrorComponentType {\n Modal = \"Modal\",\n Page = \"Page\",\n\n // Feed\n FeedFoundCanBeFollow = \"FeedFoundCanBeFollow\",\n FeedNotFound = \"FeedNotFound\",\n // Section\n RSSHubDiscoverError = \"RSSHubDiscoverError\",\n EntryNotFound = \"EntryNotFound\",\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/helper.ts", "content": "import type { FC } from \"react\"\nimport { createElement, useEffect, useRef } from \"react\"\nimport { useLocation } from \"react-router\"\n\nimport type { AppErrorFallbackProps } from \"../common/AppErrorBoundary\"\n\nexport const parseError = (error: unknown): { message?: string; stack?: string } => {\n if (error instanceof Error) {\n return {\n message: error.message,\n stack: error.stack,\n }\n } else {\n return {\n message: String(error),\n stack: undefined,\n }\n }\n}\n\nexport const useResetErrorWhenRouteChange = (resetError: () => void) => {\n const location = useLocation()\n const currentPathnameRef = useRef(location.pathname)\n const onceRef = useRef(false)\n useEffect(() => {\n if (onceRef.current) {\n return\n }\n if (currentPathnameRef.current !== location.pathname) {\n resetError()\n onceRef.current = true\n }\n }, [location.pathname])\n}\n\nexport const withErrorGrand = T>(\n error: S,\n Component: FC,\n): FC => {\n return (props: AppErrorFallbackProps) => {\n if (!(props.error instanceof error)) {\n throw error\n }\n\n return createElement(Component, props)\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/errors/index.ts", "content": "import { lazy } from \"react\"\n\nimport { ErrorComponentType } from \"./enum\"\n\nconst ErrorFallbackMap = {\n [ErrorComponentType.Modal]: lazy(() => import(\"./ModalError\")),\n [ErrorComponentType.Page]: lazy(() => import(\"./PageError\")),\n [ErrorComponentType.FeedNotFound]: lazy(() => import(\"./FeedNotFound\")),\n [ErrorComponentType.RSSHubDiscoverError]: lazy(() => import(\"./RSSHubError\")),\n [ErrorComponentType.EntryNotFound]: lazy(() => import(\"./EntryNotFound\")),\n}\n\nexport const getErrorFallback = (type: ErrorComponentType) => ErrorFallbackMap[type]\n" }, { "path": "apps/desktop/layer/renderer/src/components/mobile/button.tsx", "content": "import { MotionButtonBase } from \"@follow/components/ui/button/index.js\"\nimport { cn } from \"@follow/utils/utils\"\n\nexport const HeaderTopReturnBackButton: Component<{ to?: string }> = ({ className, to }) => (\n window.history.returnBack(to)}\n className={cn(\"center size-8\", className)}\n >\n \n\n Back\n \n)\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/ai-summary-card/AISummaryCardBase.tsx", "content": "import { AutoResizeHeight } from \"@follow/components/ui/auto-resize-height/index.js\"\nimport { MotionButtonBase } from \"@follow/components/ui/button/index.js\"\nimport { cn } from \"@follow/utils/utils\"\nimport { FollowAPIError } from \"@follow-app/client-sdk\"\nimport type { ReactNode } from \"react\"\nimport { useTranslation } from \"react-i18next\"\n\nimport { useIsPaymentEnabled } from \"~/atoms/server-configs\"\nimport { CopyButton } from \"~/components/ui/button/CopyButton\"\nimport { Markdown } from \"~/components/ui/markdown/Markdown\"\nimport { useFeature } from \"~/hooks/biz/useFeature\"\nimport { useSettingModal } from \"~/modules/settings/modal/useSettingModal\"\n\ninterface AISummaryCardBaseProps {\n /** Summary content to display */\n content?: string | null\n /** Whether the summary is currently loading */\n isLoading?: boolean\n /** Additional className for the container */\n className?: string\n /** Custom header content (replaces default AI Summary header) */\n headerContent?: ReactNode\n /** Additional content to render below the summary */\n footerContent?: ReactNode\n /** Custom loading state component */\n loadingComponent?: ReactNode\n /** Title text for the AI Summary header */\n title?: string\n /** Whether to show the copy button */\n showCopyButton?: boolean\n /** Whether to show the Ask AI button when there's content */\n showAskAIButton?: boolean\n /** Callback when Ask AI button is clicked */\n onAskAI?: () => void\n\n error?: Error | null\n}\n\nconst DefaultLoadingState = () => (\n
\n
\n
\n
\n
\n)\n\nconst DefaultEmptyState = ({\n message,\n shouldSuggestUpgrade,\n}: {\n message: string\n shouldSuggestUpgrade?: boolean\n}) => {\n const settingModalPresent = useSettingModal()\n const { t } = useTranslation(\"app\")\n\n if (shouldSuggestUpgrade) {\n return (\n settingModalPresent(\"plan\")}\n className=\"group/upgrade relative flex items-start gap-3 text-left\"\n >\n {/* Icon with glow */}\n
\n
\n \n
\n
\n\n
\n {/* Title */}\n

{message}

\n\n {/* Description */}\n

\n {t(\"ai.summary_upgrade_required_description\")}\n

\n\n {/* CTA */}\n
\n {t(\"ai.summary_upgrade_view_plans\")}\n \n
\n
\n \n )\n }\n\n return (\n
\n

{message}

\n
\n )\n}\n\nexport const AISummaryCardBase: React.FC = ({\n content,\n isLoading = false,\n className,\n headerContent,\n footerContent,\n loadingComponent,\n title = \"AI Summary\",\n showCopyButton = true,\n showAskAIButton = false,\n onAskAI,\n error,\n}) => {\n const { t } = useTranslation(\"app\")\n const aiEnabled = useFeature(\"ai\")\n\n const hasContent = !isLoading && content\n const shouldSuggestUpgrade =\n useIsPaymentEnabled() && error instanceof FollowAPIError ? error.status === 402 : undefined\n\n return (\n \n {/* Animated background gradient */}\n \n\n {/* Subtle shine effect on hover */}\n
\n\n {/* Header */}\n
\n {headerContent || (\n
\n {/* Glowing AI icon */}\n
\n \n \n
\n \n {title}\n \n
\n )}\n\n
\n {aiEnabled && showAskAIButton && hasContent && onAskAI && (\n \n \n Ask AI\n \n )}\n\n {showCopyButton && hasContent && (\n \n )}\n
\n
\n\n {/* Content */}\n \n {isLoading ? (\n loadingComponent || \n ) : hasContent ? (\n {String(content)}\n ) : shouldSuggestUpgrade ? (\n \n ) : (\n \n )}\n \n\n {footerContent}\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/ai-summary-card/index.ts", "content": "export { AISummaryCardBase } from \"./AISummaryCardBase\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/auto-completion/AutoCompletion.tsx", "content": "import { Input } from \"@follow/components/ui/input/index.js\"\nimport { RootPortal } from \"@follow/components/ui/portal/index.jsx\"\nimport { useCorrectZIndex } from \"@follow/components/ui/z-index/ctx.js\"\nimport { stopPropagation } from \"@follow/utils/dom\"\nimport { cn } from \"@follow/utils/utils\"\nimport { Combobox, ComboboxInput, ComboboxOption, ComboboxOptions } from \"@headlessui/react\"\nimport Fuse from \"fuse.js\"\nimport { AnimatePresence, m } from \"motion/react\"\nimport { Fragment, memo, useCallback, useEffect, useState } from \"react\"\n\nexport type Suggestion = {\n name: string\n value: string\n}\nexport interface AutocompleteProps extends React.InputHTMLAttributes {\n suggestions: Suggestion[]\n renderSuggestion?: (suggestion: Suggestion) => any\n\n onSuggestionSelected: (suggestion: NoInfer | null) => void\n\n // classnames\n\n searchKeys?: string[]\n maxHeight?: number\n}\n\nconst defaultSearchKeys = [\"name\", \"value\"]\nconst defaultRenderSuggestion = (suggestion: any) => suggestion?.name\nexport const Autocomplete = ({\n ref: forwardedRef,\n suggestions,\n renderSuggestion = defaultRenderSuggestion,\n onSuggestionSelected,\n maxHeight,\n value,\n searchKeys = defaultSearchKeys,\n defaultValue,\n ...inputProps\n}: AutocompleteProps & { ref?: React.Ref }) => {\n const [selectedOptions, setSelectedOptions] = useState | null>(\n () => suggestions.find((suggestion) => suggestion.value === value) || null,\n )\n\n const [filterableSuggestions, setFilterableSuggestions] = useState(suggestions)\n\n const doFilter = useCallback(() => {\n const fuse = new Fuse(suggestions, {\n keys: searchKeys,\n })\n\n const trimInputValue = (value as string)?.trim()\n\n if (!trimInputValue) return setFilterableSuggestions(suggestions)\n\n const results = fuse.search(trimInputValue)\n\n setFilterableSuggestions(results.map((result) => result.item))\n }, [suggestions, value, searchKeys])\n useEffect(() => {\n doFilter()\n }, [doFilter])\n\n const zIndex = useCorrectZIndex(9)\n return (\n {\n setSelectedOptions(suggestion)\n onSuggestionSelected(suggestion)\n }}\n >\n {({ open }) => {\n return (\n \n \n \n {open && filterableSuggestions.length > 0 && (\n \n \n
\n {filterableSuggestions.map((suggestion) => (\n \n ))}\n
\n \n \n )}\n \n \n )\n }}\n \n )\n}\n\nconst MemoizedComboboxOption = memo(({ suggestion }: { suggestion: Suggestion }) => {\n return (\n \n {suggestion.name}\n \n )\n})\n\nAutocomplete.displayName = \"Autocomplete\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/auto-completion/index.ts", "content": "export * from \"./AutoCompletion\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/background/WindowUnderBlur.tsx", "content": "import { SYSTEM_CAN_UNDER_BLUR_WINDOW } from \"@follow/shared/constants\"\nimport { cn } from \"@follow/utils/utils\"\nimport type * as React from \"react\"\nimport type { ComponentPropsWithoutRef, ElementType } from \"react\"\n\nimport { useUISettingKey } from \"~/atoms/settings/ui\"\n\ntype Props = {\n as?: T\n ref?: React.Ref\n} & ComponentPropsWithoutRef\n\nconst MacOSVibrancy = ({ children, as, ...rest }: Props) => {\n const Component = as || \"div\"\n return {children}\n}\n\nconst Noop = ({ children, className, as, ...rest }: Props) => {\n const Component = as || \"div\"\n return (\n \n {children}\n \n )\n}\n\nexport const WindowUnderBlur = SYSTEM_CAN_UNDER_BLUR_WINDOW\n ? (props: Props) => {\n const opaqueSidebar = useUISettingKey(\"opaqueSidebar\")\n if (opaqueSidebar) {\n return \n }\n\n if (!window.electron) {\n return \n }\n switch (window.electron.process.platform) {\n case \"darwin\": {\n return \n }\n case \"win32\": {\n return \n }\n default: {\n return \n }\n }\n }\n : Noop\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/background/index.ts", "content": "export * from \"./WindowUnderBlur\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/button/AnimatedCommandButton.tsx", "content": "import { MotionButtonBase } from \"@follow/components/ui/button/index.js\"\nimport { useTypeScriptHappyCallback } from \"@follow/hooks\"\nimport { cn } from \"@follow/utils/utils\"\nimport type { VariantProps } from \"class-variance-authority\"\nimport { cva } from \"class-variance-authority\"\nimport type { HTMLMotionProps, Variants } from \"motion/react\"\nimport { AnimatePresence, m } from \"motion/react\"\nimport type { FC } from \"react\"\nimport * as React from \"react\"\nimport { cloneElement, useRef, useState } from \"react\"\n\nconst animatedCommandButtonVariants = cva(\n [\"center pointer-events-auto flex text-xs\", \"rounded-md p-1.5 duration-200\"],\n {\n variants: {\n variant: {\n solid: [\"border-accent/5 bg-accent/80 text-white border backdrop-blur\"],\n outline: [\"text-accent hover:bg-material-ultra-thick\"],\n ghost: [\n \"border-accent/5 bg-accent/80 text-accent border backdrop-blur\",\n \"bg-theme-item-active hover:bg-theme-item-hover\",\n ],\n },\n },\n defaultVariants: {\n variant: \"solid\",\n },\n },\n)\n\ninterface AnimatedCommandButtonProps extends VariantProps {\n icon: React.JSX.Element\n}\n\nconst iconVariants: Variants = {\n initial: {\n opacity: 1,\n scale: 1,\n },\n animate: {\n opacity: 1,\n scale: 1,\n },\n exit: {\n opacity: 0,\n scale: 0,\n },\n}\n\nexport const AnimatedCommandButton: FC> = ({\n icon,\n className,\n style,\n variant,\n ...props\n}) => {\n const [pressed, setPressed] = useState(false)\n const timerRef = useRef(undefined)\n\n return (\n {\n setPressed(true)\n props.onClick?.(e)\n timerRef.current = setTimeout(() => {\n setPressed(false)\n }, 2000)\n },\n [props.onClick],\n )}\n style={style}\n >\n \n {pressed ? (\n \n ) : (\n cloneElement(icon, {\n className: cn(icon.props.className, \"size-4\"),\n ...iconVariants,\n })\n )}\n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/button/CommandActionButton.tsx", "content": "import type { ActionButtonProps } from \"@follow/components/ui/button/action-button.js\"\nimport { ActionButton } from \"@follow/components/ui/button/action-button.js\"\n\nimport { useCommand } from \"~/modules/command/hooks/use-command\"\nimport type { FollowCommandId } from \"~/modules/command/types\"\n\nexport interface CommandActionButtonProps extends ActionButtonProps {\n commandId: FollowCommandId\n onClick: () => void\n}\nexport const CommandActionButton = ({\n ref,\n ...props\n}: CommandActionButtonProps & { ref?: React.Ref }) => {\n const { commandId, ...rest } = props\n const command = useCommand(commandId)\n if (!command) return null\n const { icon, label } = command\n\n return (\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/button/CopyButton.tsx", "content": "import { useCallback, useRef } from \"react\"\n\nimport { m } from \"~/components/common/Motion\"\nimport { copyToClipboard } from \"~/lib/clipboard\"\n\nimport { AnimatedCommandButton } from \"./AnimatedCommandButton\"\n\nexport const CopyButton: Component<{\n value: string\n style?: React.CSSProperties\n variant?: \"solid\" | \"outline\" | \"ghost\"\n}> = ({ value, className, style, variant = \"solid\" }) => {\n const copiedTimerRef = useRef(undefined)\n const handleCopy = useCallback(() => {\n copyToClipboard(value)\n\n clearTimeout(copiedTimerRef.current)\n }, [value])\n return (\n }\n onClick={handleCopy}\n />\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/button/GlassButton.tsx", "content": "import { Spring } from \"@follow/components/constants/spring.js\"\nimport {\n Tooltip,\n TooltipContent,\n TooltipPortal,\n TooltipTrigger,\n} from \"@follow/components/ui/tooltip/index.js\"\nimport { cn } from \"@follow/utils/utils\"\nimport { cva } from \"class-variance-authority\"\nimport { m } from \"motion/react\"\nimport type { FC, ReactNode } from \"react\"\n\nexport interface GlassButtonProps {\n description?: string\n onClick?: () => void\n className?: string\n testId?: string\n children: ReactNode\n /**\n * Custom animation variants for hover and tap states\n */\n hoverScale?: number\n tapScale?: number\n /**\n * Size variant\n */\n size?: \"sm\" | \"md\" | \"lg\"\n /**\n * Color theme\n */\n theme?: \"light\" | \"dark\" | \"auto\"\n /**\n * Visual variant\n */\n variant?: \"glass\" | \"flat\"\n}\n\nconst glassButtonVariants = cva(\n [\n // Base styles - perfect 1:1 circle\n \"pointer-events-auto relative flex items-center justify-center rounded-full\",\n \"transition-all duration-300 ease-out no-drag-region\",\n ],\n {\n variants: {\n size: {\n sm: \"size-8 text-sm\",\n md: \"size-10 text-lg\",\n lg: \"size-12 text-xl\",\n },\n theme: {\n light: [\"text-gray-700 hover:text-gray-900\"],\n dark: [\"text-white hover:text-white\"],\n auto: [\"text-text hover:text-text-vibrant\"],\n },\n variant: {\n glass: [\"backdrop-blur-md border shadow-lg\"],\n flat: [\"border shadow-sm hover:shadow-md\"],\n },\n },\n compoundVariants: [\n // Glass variant themes\n {\n variant: \"glass\",\n theme: \"light\",\n className: [\n \"bg-material-thin hover:bg-material-medium\",\n \"border-gray/30 hover:border-gray/40\",\n \"shadow-gray/30\",\n ],\n },\n {\n variant: \"glass\",\n theme: \"dark\",\n className: [\n \"bg-material-ultra-thin hover:bg-material-thin\",\n \"border-gray/10 hover:border-gray/20\",\n \"shadow-black/25\",\n ],\n },\n {\n variant: \"glass\",\n theme: \"auto\",\n className: [\n \"bg-material-thin hover:bg-material-medium\",\n \"border-gray/30 hover:border-gray/40\",\n \"shadow-gray/30\",\n ],\n },\n // Flat variant themes\n {\n variant: \"flat\",\n theme: \"light\",\n className: [\n \"bg-white/80 hover:bg-white/90\",\n \"border-gray/20 hover:border-gray/30\",\n // Subtle shadow color for clearer hover feedback\n \"shadow-gray/10 hover:shadow-gray/25\",\n ],\n },\n {\n variant: \"flat\",\n theme: \"dark\",\n className: [\n \"bg-fill-secondary hover:bg-fill-tertiary\",\n \"border-gray/20 hover:border-gray/30\",\n \"shadow-black/10 hover:shadow-black/25\",\n ],\n },\n {\n variant: \"flat\",\n theme: \"auto\",\n className: [\n \"bg-white/80 hover:bg-white/90 dark:bg-fill-secondary dark:hover:bg-fill-tertiary\",\n \"border-gray/20 hover:border-gray/30\",\n \"shadow-gray/10 hover:shadow-gray/25 dark:shadow-black/10 dark:hover:shadow-black/25\",\n ],\n },\n ],\n defaultVariants: {\n size: \"md\",\n theme: \"auto\",\n variant: \"glass\",\n },\n },\n)\n\nconst glassOverlayVariants = cva(\n \"absolute inset-0 rounded-full bg-gradient-to-t opacity-0 transition-opacity duration-300 hover:opacity-100\",\n {\n variants: {\n theme: {\n light: \"from-material-opaque/10 to-material-opaque/30\",\n dark: \"from-material-opaque/5 to-material-opaque/20\",\n auto: \"from-material-opaque/10 to-material-opaque/30\",\n },\n },\n defaultVariants: {\n theme: \"auto\",\n },\n },\n)\n\nconst glassInnerShadowVariants = cva(\"absolute inset-0 rounded-full shadow-inner\", {\n variants: {\n theme: {\n light: \"shadow-gray/20\",\n dark: \"shadow-black/10\",\n auto: \"shadow-gray/20 dark:shadow-black/10\",\n },\n },\n defaultVariants: {\n theme: \"auto\",\n },\n})\n\nexport const GlassButton: FC = ({\n description,\n onClick,\n className,\n testId,\n children,\n hoverScale = 1.1,\n tapScale = 0.95,\n size = \"md\",\n theme = \"auto\",\n variant = \"flat\",\n}) => {\n return (\n \n \n {\n e.stopPropagation()\n onClick?.()\n }}\n className={cn(glassButtonVariants({ size, theme, variant }), className)}\n initial={{ scale: 1 }}\n whileHover={\n variant === \"flat\"\n ? undefined\n : {\n scale: hoverScale,\n }\n }\n whileTap={{ scale: tapScale }}\n transition={Spring.presets.snappy}\n >\n {/* Glass effect overlay - only for glass variant */}\n {variant === \"glass\" &&
}\n\n {/* Icon container */}\n
{children}
\n\n {/* Subtle inner shadow for depth - only for glass variant */}\n {variant === \"glass\" &&
}\n \n \n {description && (\n \n {description}\n \n )}\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/button/HeaderActionButton.tsx", "content": "import { cn } from \"@follow/utils/utils\"\nimport { m } from \"motion/react\"\nimport type { ReactNode } from \"react\"\n\ninterface HeaderActionButtonProps {\n children: ReactNode\n onClick?: () => void\n disabled?: boolean\n loading?: boolean\n variant?: \"primary\" | \"accent\" | \"neutral\"\n className?: string\n icon?: string\n iconClassName?: string\n \"data-testid\"?: string\n}\n\nexport const HeaderActionButton = ({\n children,\n onClick,\n disabled = false,\n loading = false,\n variant = \"neutral\",\n className,\n icon,\n iconClassName,\n \"data-testid\": testId,\n}: HeaderActionButtonProps) => {\n const getVariantStyles = () => {\n if (disabled) {\n return [\n \"text-text-tertiary cursor-not-allowed opacity-50\",\n \"bg-fill-quaternary border border-transparent\",\n ]\n }\n\n switch (variant) {\n case \"primary\": {\n return [\n \"bg-blue/10 text-blue hover:bg-blue/20\",\n \"border border-blue/20 hover:border-blue/30\",\n \"active:bg-blue/30 active:scale-95\",\n ]\n }\n case \"accent\": {\n return [\n \"bg-accent/10 text-accent hover:bg-accent/20\",\n \"border border-accent/20 hover:border-accent/30\",\n \"active:bg-accent/30 active:scale-95\",\n ]\n }\n default: {\n return [\n \"bg-fill/10 text-text hover:bg-fill/20\",\n \"border border-fill/20 hover:border-fill/30\",\n \"active:bg-fill/30 active:scale-95\",\n ]\n }\n }\n }\n\n const iconClass = loading ? \"i-mgc-loading-3-cute-re animate-spin duration-500\" : icon\n\n return (\n \n {iconClass && (\n \n )}\n {children}\n \n )\n}\n\ninterface HeaderActionGroupProps {\n children: ReactNode\n className?: string\n}\n\nexport const HeaderActionGroup = ({ children, className }: HeaderActionGroupProps) => {\n return
{children}
\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/constants/index.tsx", "content": "const LanguageAlias = {\n ts: \"typescript\",\n js: \"javascript\",\n\n tsx: \"typescriptreact\",\n jsx: \"javascriptreact\",\n md: \"markdown\",\n}\n\nconst languageToIconMap = {\n javascriptreact: ,\n typescriptreact: ,\n javascript: ,\n typescript: ,\n html: ,\n css: ,\n markdown: ,\n json: ,\n yaml: ,\n bash: ,\n}\n\nexport const getLanguageIcon = (language?: string) => {\n if (!language) return null\n\n const alias = LanguageAlias[language]\n if (alias) {\n return languageToIconMap[alias]\n }\n\n return languageToIconMap[language]\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/index.ts", "content": "export * from \"./shiki\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/shiki/Shiki.tsx", "content": "import { ELECTRON_BUILD } from \"@follow/shared/constants\"\nimport { cn } from \"@follow/utils/utils\"\nimport { useIsomorphicLayoutEffect } from \"foxact/use-isomorphic-layout-effect\"\nimport type { FC } from \"react\"\nimport { memo, useInsertionEffect, useMemo, useRef, useState } from \"react\"\nimport type {\n BundledLanguage,\n BundledTheme,\n DynamicImportLanguageRegistration,\n DynamicImportThemeRegistration,\n} from \"shiki\"\n\nimport { useUISettingKey } from \"~/atoms/settings/ui\"\nimport { ipcServices } from \"~/lib/client\"\n\nimport { CopyButton } from \"../../button/CopyButton\"\nimport { getLanguageIcon } from \"../constants\"\nimport { useShikiDefaultTheme } from \"./hooks\"\nimport { shiki, shikiTransformers } from \"./shared\"\nimport styles from \"./shiki.module.css\"\n\nexport interface ShikiProps {\n language: string | undefined\n code: string\n\n attrs?: string\n className?: string\n\n transparent?: boolean\n showCopy?: boolean\n\n theme?: string\n}\n\nlet langModule: Record | null = null\nlet themeModule: Record | null = null\nlet bundledLanguagesKeysSet: Set | null = null\n\nexport const ShikiHighLighter: FC = (props) => {\n const { code, language, className, theme: overrideTheme } = props\n const [currentLanguage, setCurrentLanguage] = useState(language || \"plaintext\")\n\n const guessCodeLanguage = useUISettingKey(\"guessCodeLanguage\")\n useInsertionEffect(() => {\n if (!guessCodeLanguage) return\n if (language || !ELECTRON_BUILD) return\n\n if (!bundledLanguagesKeysSet) {\n import(\"shiki/langs\")\n .then(({ bundledLanguages }) => {\n langModule = bundledLanguages\n bundledLanguagesKeysSet = new Set(Object.keys(bundledLanguages))\n })\n .then(guessLanguage)\n } else {\n guessLanguage()\n }\n\n function guessLanguage() {\n return ipcServices?.reader.detectCodeStringLanguage({ codeString: code }).then((result) => {\n if (!result) {\n return\n }\n if (bundledLanguagesKeysSet?.has(result.languageId)) {\n setCurrentLanguage(result.languageId)\n }\n })\n }\n }, [guessCodeLanguage])\n\n const loadThemesRef = useRef([] as string[])\n const loadLanguagesRef = useRef([] as string[])\n\n const [loaded, setLoaded] = useState(false)\n\n const codeTheme = useShikiDefaultTheme(overrideTheme)\n\n useIsomorphicLayoutEffect(() => {\n let isMounted = true\n setLoaded(false)\n\n async function loadShikiLanguage(language: string, languageModule: any) {\n if (!shiki) return\n if (!shiki.getLoadedLanguages().includes(language)) {\n await shiki.loadLanguage(await languageModule())\n }\n }\n async function loadShikiTheme(theme: string, themeModule: any) {\n if (!shiki) return\n if (!shiki.getLoadedThemes().includes(theme)) {\n await shiki.loadTheme(await themeModule())\n }\n }\n\n async function register() {\n if (!currentLanguage || !codeTheme) return\n\n const [{ bundledLanguages }, { bundledThemes }] =\n langModule && themeModule\n ? [\n {\n bundledLanguages: langModule,\n },\n { bundledThemes: themeModule },\n ]\n : await Promise.all([import(\"shiki/langs\"), import(\"shiki/themes\")])\n\n langModule = bundledLanguages\n themeModule = bundledThemes\n\n if (\n currentLanguage &&\n loadLanguagesRef.current.includes(currentLanguage) &&\n codeTheme &&\n loadThemesRef.current.includes(codeTheme)\n ) {\n return\n }\n return Promise.all([\n (async () => {\n if (currentLanguage) {\n const importFn = (bundledLanguages as any)[currentLanguage]\n if (!importFn) return\n await loadShikiLanguage(currentLanguage || \"\", importFn)\n loadLanguagesRef.current.push(currentLanguage)\n }\n })(),\n (async () => {\n if (codeTheme) {\n const importFn = (bundledThemes as any)[codeTheme]\n if (!importFn) return\n await loadShikiTheme(codeTheme || \"\", importFn)\n loadThemesRef.current.push(codeTheme)\n }\n })(),\n ])\n }\n register().then(() => {\n if (isMounted) {\n setLoaded(true)\n }\n })\n return () => {\n isMounted = false\n }\n }, [codeTheme, currentLanguage])\n\n if (!loaded) {\n return (\n 
\n        {code}\n
\n )\n }\n return \n}\n\nexport const MemoizedShikiCode = memo(ShikiHighLighter)\nconst ShikiCode: FC<\n ShikiProps & {\n codeTheme: string\n }\n> = ({ code, language, codeTheme, className, transparent, showCopy = true }) => {\n const rendered = useMemo(() => {\n try {\n return shiki.codeToHtml(code, {\n lang: language!,\n themes: {\n dark: codeTheme,\n light: codeTheme,\n },\n transformers: shikiTransformers,\n })\n } catch {\n return null\n }\n }, [code, language, codeTheme])\n\n if (!rendered) {\n return (\n 
\n        {code}\n
\n )\n }\n\n return (\n \n {/* Inner subtle glow */}\n \n\n {/* Compact Header */}\n \n {language === \"plaintext\" ? (\n
\n ) : (\n
\n {getLanguageIcon(language)}\n {language}\n
\n )}\n\n \n
\n\n {/* Code content */}\n
\n \n
\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/shiki/hooks.ts", "content": "import { useIsDark } from \"@follow/hooks\"\n\nimport { useUISettingSelector } from \"~/atoms/settings/ui\"\n\nexport const useShikiDefaultTheme = (overrideTheme?: string) => {\n const isDark = useIsDark()\n const codeThemeLight = useUISettingSelector((s) => overrideTheme || s.codeHighlightThemeLight)\n const codeThemeDark = useUISettingSelector((s) => overrideTheme || s.codeHighlightThemeDark)\n\n return isDark ? codeThemeDark : codeThemeLight\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/shiki/index.ts", "content": "export * from \"./Shiki\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/shiki/shared.ts", "content": "import {\n transformerMetaHighlight,\n transformerNotationDiff,\n transformerNotationHighlight,\n} from \"@shikijs/transformers\"\nimport type { ShikiTransformer } from \"shiki\"\nimport { createHighlighterCoreSync, createJavaScriptRegexEngine } from \"shiki\"\n\nexport const shikiTransformers: ShikiTransformer[] = [\n transformerMetaHighlight(),\n transformerNotationDiff({ matchAlgorithm: \"v3\" }),\n transformerNotationHighlight({ matchAlgorithm: \"v3\" }),\n]\n\nconst js = createJavaScriptRegexEngine()\nexport const shiki = createHighlighterCoreSync({\n themes: [],\n langs: [],\n engine: js,\n})\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/code-highlighter/shiki/shiki.module.css", "content": ".shiki-wrapper {\n @apply overflow-hidden;\n\n pre {\n @apply bg-transparent;\n }\n\n &.transparent {\n :global {\n .shiki,\n code {\n @apply !bg-transparent;\n }\n }\n }\n\n :global {\n .shiki {\n @apply !m-0 !bg-transparent !px-0;\n\n font-family:\n \"OperatorMonoSSmLig Nerd Font\",\n \"Cascadia Code PL\",\n \"FantasqueSansMono Nerd Font\",\n \"Operator Mono\",\n JetBrainsMono,\n \"Fira Code Retina\",\n \"Fira Code\",\n \"Consolas\",\n Monaco,\n \"Hannotate SC\",\n monospace,\n -apple-system,\n system-ui,\n sans-serif;\n }\n\n pre {\n @apply !m-0 overflow-auto px-4 py-3;\n\n font-size: 0.875em;\n line-height: 1.6;\n\n /* Custom scrollbar */\n &::-webkit-scrollbar {\n @apply h-1.5 w-1.5;\n }\n\n &::-webkit-scrollbar-track {\n @apply bg-transparent;\n }\n\n &::-webkit-scrollbar-thumb {\n @apply rounded-full bg-fill-tertiary transition-colors;\n\n &:hover {\n @apply bg-fill-secondary;\n }\n }\n }\n\n pre code {\n @apply flex flex-col;\n }\n\n .line {\n @apply block px-4 transition-colors duration-100;\n\n & > span:last-child {\n @apply mr-4;\n }\n\n /* Expand the row without content */\n &::after {\n content: \" \";\n }\n\n /* Subtle hover effect on lines */\n &:hover {\n @apply bg-fill/10;\n }\n }\n\n .highlighted,\n .diff {\n @apply relative break-all;\n\n &::before {\n @apply absolute left-0 top-0 h-full w-0.5;\n content: \"\";\n }\n }\n\n .diff.add {\n @apply bg-green/10;\n\n &::before {\n @apply bg-green;\n }\n\n &::after {\n content: \" +\";\n @apply absolute left-1.5 text-xs font-semibold text-green;\n }\n }\n\n .diff.remove {\n @apply bg-red/10;\n\n &::before {\n @apply bg-red;\n }\n\n &::after {\n content: \" -\";\n @apply absolute left-1.5 text-xs font-semibold text-red;\n }\n }\n\n .highlighted {\n @apply bg-accent/10;\n\n &::before {\n @apply bg-accent;\n }\n }\n }\n\n pre {\n @apply rounded-none;\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/crop/AvatarUploadModal.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport { DropZone } from \"@follow/components/ui/drop-zone/index.js\"\nimport { useCallback, useMemo, useRef, useState } from \"react\"\nimport { useTranslation } from \"react-i18next\"\nimport { toast } from \"sonner\"\n\ninterface AvatarUploadModalProps {\n onConfirm: (blob: Blob) => Promise\n onCancel: () => void\n maxSizeKB?: number\n}\n\nexport const AvatarUploadModal = ({\n onConfirm,\n onCancel,\n maxSizeKB = 300,\n}: AvatarUploadModalProps) => {\n const { t } = useTranslation(\"settings\")\n const [selectedImage, setSelectedImage] = useState(null)\n const [isProcessing, setIsProcessing] = useState(false)\n const canvasRef = useRef(null)\n const imageRef = useRef(null)\n const containerRef = useRef(null)\n\n // Crop settings\n const [cropData, setCropData] = useState({\n x: 0,\n y: 0,\n width: 400,\n height: 400,\n })\n const [isDragging, setIsDragging] = useState(false)\n const [resizeHandle, setResizeHandle] = useState(null)\n const [dragStart, setDragStart] = useState({\n x: 0,\n y: 0,\n cropX: 0,\n cropY: 0,\n cropWidth: 0,\n cropHeight: 0,\n })\n\n // Helper function: ensure the crop data is within the image boundaries and maintain the 1:1 ratio\n const constrainCropData = useCallback(\n (newCropData: typeof cropData, imageWidth: number, imageHeight: number) => {\n const { x, y, width, height } = newCropData\n\n // Ensure it's a square, use the larger value to avoid shrinking\n const size = Math.max(width, height)\n\n // Ensure the minimum size\n const minSize = 50\n let finalSize = Math.max(size, minSize)\n\n // Ensure it's not out of bounds, if it is, shrink it to the appropriate size\n const maxSize = Math.min(imageWidth, imageHeight)\n finalSize = Math.min(finalSize, maxSize)\n\n // Adjust the position to ensure it's within the boundaries\n const maxX = imageWidth - finalSize\n const maxY = imageHeight - finalSize\n\n return {\n x: Math.max(0, Math.min(x, maxX)),\n y: Math.max(0, Math.min(y, maxY)),\n width: finalSize,\n height: finalSize,\n }\n },\n [],\n )\n\n const handleFileSelect = useCallback(\n (files: FileList) => {\n const file = files[0]\n if (!file) return\n\n if (!file.type.startsWith(\"image/\")) {\n toast.error(t(\"profile.avatar.invalidFileType\"))\n return\n }\n\n if (file.size > maxSizeKB * 1024) {\n toast.error(t(\"profile.avatar.fileTooLarge\", { size: `${maxSizeKB}KB` }))\n return\n }\n\n const reader = new FileReader()\n reader.onload = (e) => {\n const result = e.target?.result as string\n setSelectedImage(result)\n }\n reader.readAsDataURL(file)\n },\n [maxSizeKB, t],\n )\n\n const handleImageLoad = useCallback(() => {\n if (imageRef.current) {\n const img = imageRef.current\n // Use the smaller side's 80% as the initial size\n const maxSize = Math.min(img.naturalWidth, img.naturalHeight)\n const size = maxSize * 0.8\n\n const initialCropData = {\n x: (img.naturalWidth - size) / 2,\n y: (img.naturalHeight - size) / 2,\n width: size,\n height: size,\n }\n // Use the helper function to ensure the data is valid\n const constrainedData = constrainCropData(\n initialCropData,\n img.naturalWidth,\n img.naturalHeight,\n )\n setCropData(constrainedData)\n }\n }, [constrainCropData])\n\n const handleCropMouseDown = useCallback(\n (e: React.MouseEvent) => {\n e.preventDefault()\n setIsDragging(true)\n setDragStart({\n x: e.clientX,\n y: e.clientY,\n cropX: cropData.x,\n cropY: cropData.y,\n cropWidth: cropData.width,\n cropHeight: cropData.height,\n })\n },\n [cropData],\n )\n\n const handleResizeMouseDown = useCallback(\n (e: React.MouseEvent, handle: string) => {\n e.preventDefault()\n e.stopPropagation()\n setResizeHandle(handle)\n setDragStart({\n x: e.clientX,\n y: e.clientY,\n cropX: cropData.x,\n cropY: cropData.y,\n cropWidth: cropData.width,\n cropHeight: cropData.height,\n })\n },\n [cropData],\n )\n\n const handleCropMouseMove = useCallback(\n (e: React.MouseEvent) => {\n if (!isDragging && !resizeHandle) return\n e.preventDefault()\n\n if (!imageRef.current || !containerRef.current) return\n\n const img = imageRef.current\n const container = containerRef.current\n const containerRect = container.getBoundingClientRect()\n\n // Calculate the actual display size and position of the image in the container\n const containerWidth = containerRect.width\n const containerHeight = containerRect.height\n const imageAspectRatio = img.naturalWidth / img.naturalHeight\n const containerAspectRatio = containerWidth / containerHeight\n\n let displayWidth = 0,\n displayHeight = 0\n\n if (imageAspectRatio > containerAspectRatio) {\n // The image is wider, use the container width\n displayWidth = containerWidth\n displayHeight = containerWidth / imageAspectRatio\n } else {\n // The image is taller, use the container height\n displayHeight = containerHeight\n displayWidth = containerHeight * imageAspectRatio\n }\n\n const scaleX = img.naturalWidth / displayWidth\n const scaleY = img.naturalHeight / displayHeight\n\n const deltaX = e.clientX - dragStart.x\n const deltaY = e.clientY - dragStart.y\n\n if (resizeHandle) {\n const { cropX, cropY, cropWidth, cropHeight } = dragStart\n let newX = cropX\n let newY = cropY\n let newWidth = cropWidth\n let newHeight = cropHeight\n\n if (resizeHandle.includes(\"r\")) newWidth += deltaX * scaleX\n if (resizeHandle.includes(\"l\")) {\n newWidth -= deltaX * scaleX\n newX += deltaX * scaleX\n }\n if (resizeHandle.includes(\"b\")) newHeight += deltaY * scaleY\n if (resizeHandle.includes(\"t\")) {\n newHeight -= deltaY * scaleY\n newY += deltaY * scaleY\n }\n\n // Keep the aspect ratio, use the larger change value\n const size = Math.max(newWidth, newHeight)\n\n // Update the coordinates based on the position of the resize handle\n if (resizeHandle.includes(\"t\")) newY = cropY + cropHeight - size\n if (resizeHandle.includes(\"l\")) newX = cropX + cropWidth - size\n\n const newCropData = {\n x: newX,\n y: newY,\n width: size,\n height: size,\n }\n\n // Use the helper function to ensure the data is valid\n const constrainedData = constrainCropData(newCropData, img.naturalWidth, img.naturalHeight)\n setCropData(constrainedData)\n } else if (isDragging) {\n const newX = dragStart.cropX + deltaX * scaleX\n const newY = dragStart.cropY + deltaY * scaleY\n\n setCropData((prev) => {\n const newCropData = {\n ...prev,\n x: newX,\n y: newY,\n }\n return constrainCropData(newCropData, img.naturalWidth, img.naturalHeight)\n })\n }\n },\n [isDragging, resizeHandle, dragStart, constrainCropData],\n )\n\n const handleCropMouseUp = useCallback(() => {\n setIsDragging(false)\n setResizeHandle(null)\n }, [])\n\n const cropImage = useCallback((): Promise => {\n return new Promise((resolve, reject) => {\n if (!imageRef.current || !canvasRef.current) {\n reject(new Error(\"Image or canvas not available\"))\n return\n }\n\n const canvas = canvasRef.current\n const ctx = canvas.getContext(\"2d\")\n if (!ctx) {\n reject(new Error(\"Canvas context not available\"))\n return\n }\n\n const img = imageRef.current\n canvas.width = 400\n canvas.height = 400\n\n ctx.drawImage(img, cropData.x, cropData.y, cropData.width, cropData.height, 0, 0, 400, 400)\n\n canvas.toBlob(\n (blob) => {\n if (blob) {\n resolve(blob)\n } else {\n reject(new Error(\"Failed to create blob\"))\n }\n },\n \"image/jpeg\",\n 0.9,\n )\n })\n }, [cropData])\n\n // Preset functions\n const handleFullImageCrop = useCallback(() => {\n if (!imageRef.current) return\n\n const img = imageRef.current\n const size = Math.min(img.naturalWidth, img.naturalHeight)\n\n const newCropData = {\n x: (img.naturalWidth - size) / 2,\n y: (img.naturalHeight - size) / 2,\n width: size,\n height: size,\n }\n\n const constrainedData = constrainCropData(newCropData, img.naturalWidth, img.naturalHeight)\n setCropData(constrainedData)\n }, [constrainCropData])\n\n const handleCenterCrop = useCallback(() => {\n if (!imageRef.current) return\n\n const img = imageRef.current\n const maxSize = Math.min(img.naturalWidth, img.naturalHeight)\n const size = maxSize * 0.8\n\n const newCropData = {\n x: (img.naturalWidth - size) / 2,\n y: (img.naturalHeight - size) / 2,\n width: size,\n height: size,\n }\n\n const constrainedData = constrainCropData(newCropData, img.naturalWidth, img.naturalHeight)\n setCropData(constrainedData)\n }, [constrainCropData])\n\n const handleConfirm = useCallback(async () => {\n if (!selectedImage) return\n\n try {\n setIsProcessing(true)\n const blob = await cropImage()\n await onConfirm(blob)\n } catch (error) {\n console.error(\"Error processing image:\", error)\n toast.error(t(\"profile.avatar.processingError\"))\n } finally {\n setIsProcessing(false)\n }\n }, [selectedImage, cropImage, onConfirm, t])\n\n const cropStyle = useMemo(() => {\n if (!imageRef.current || !containerRef.current) return {}\n\n const img = imageRef.current\n const container = containerRef.current\n const containerRect = container.getBoundingClientRect()\n\n // Calculate the actual display size and position of the image in the container\n const containerWidth = containerRect.width\n const containerHeight = containerRect.height\n const imageAspectRatio = img.naturalWidth / img.naturalHeight\n const containerAspectRatio = containerWidth / containerHeight\n\n let displayWidth = 0,\n displayHeight = 0,\n offsetX = 0,\n offsetY = 0\n\n if (imageAspectRatio > containerAspectRatio) {\n // The image is wider, use the container width\n displayWidth = containerWidth\n displayHeight = containerWidth / imageAspectRatio\n offsetX = 0\n offsetY = (containerHeight - displayHeight) / 2\n } else {\n // The image is taller, use the container height\n displayHeight = containerHeight\n displayWidth = containerHeight * imageAspectRatio\n offsetX = (containerWidth - displayWidth) / 2\n offsetY = 0\n }\n\n // Calculate the scale ratio\n const scaleX = displayWidth / img.naturalWidth\n const scaleY = displayHeight / img.naturalHeight\n\n return {\n left: `${offsetX + cropData.x * scaleX}px`,\n top: `${offsetY + cropData.y * scaleY}px`,\n width: `${cropData.width * scaleX}px`,\n height: `${cropData.height * scaleY}px`,\n }\n }, [cropData])\n\n return (\n
\n {!selectedImage ? (\n
\n \n
\n \n
\n

{t(\"profile.avatar.dropZoneText\")}

\n

{t(\"profile.avatar.dropZoneSubtext\")}

\n
\n
\n \n
\n ) : (\n
\n \n \n\n {/* Crop overlay */}\n \n \n
\n {/* Grid lines */}\n
\n
\n
\n
\n\n {/* Resize handles */}\n handleResizeMouseDown(e, \"tl\")}\n />\n handleResizeMouseDown(e, \"tr\")}\n />\n handleResizeMouseDown(e, \"bl\")}\n />\n handleResizeMouseDown(e, \"br\")}\n />\n
\n
\n
\n\n
\n {t(\"profile.avatar.cropInstructions\")}\n
\n
\n )}\n\n \n\n
\n {selectedImage ? (\n
\n \n \n
\n ) : (\n
\n )}\n
\n \n \n
\n
\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/datetime/index.tsx", "content": "import { getUpdateInterval } from \"@follow/components/ui/datetime/utils.js\"\nimport {\n Tooltip,\n TooltipContent,\n TooltipPortal,\n TooltipTrigger,\n} from \"@follow/components/ui/tooltip/index.js\"\nimport { stopPropagation } from \"@follow/utils/dom\"\nimport dayjs from \"dayjs\"\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\"\nimport { useTranslation } from \"react-i18next\"\n\nimport { useGeneralSettingSelector } from \"~/atoms/settings/general\"\nimport { useUISettingKey } from \"~/atoms/settings/ui\"\n\nexport { RelativeTime } from \"@follow/components/ui/datetime/index.js\"\nexport const RelativeDay = ({ date }: { date: Date }) => {\n const { t } = useTranslation(\"common\")\n const language = useGeneralSettingSelector((s) => s.language)\n\n const dateFormatValue = useUISettingKey(\"dateFormat\")\n const formatTemplateString = \"lll\"\n const dateFormat = dateFormatValue === \"default\" ? formatTemplateString : dateFormatValue\n\n const formatDateString = useCallback(\n (date: Date) => {\n const now = new Date()\n\n // Remove the time part for comparison\n const nowDate = new Date(now.getFullYear(), now.getMonth(), now.getDate())\n const inputDate = new Date(date.getFullYear(), date.getMonth(), date.getDate())\n\n const diffTime = nowDate.getTime() - inputDate.getTime()\n const diffDays = diffTime / (1000 * 3600 * 24)\n\n if (diffDays === 0) {\n return t(\"time.today\")\n } else if (diffDays === 1) {\n return t(\"time.yesterday\")\n } else {\n return dayjs(date).format(\"ll\")\n }\n },\n [t],\n )\n\n const timerRef = useRef(null)\n const [dateString, setDateString] = useState(() => formatDateString(date))\n\n useEffect(() => {\n const updateInterval = getUpdateInterval(date, 3)\n\n if (updateInterval !== null) {\n timerRef.current = setTimeout(() => {\n setDateString(formatDateString(date))\n }, updateInterval)\n }\n setDateString(formatDateString(date))\n\n return () => {\n timerRef.current = clearTimeout(timerRef.current)\n }\n }, [date, formatDateString, language])\n\n const formated = useMemo(() => dayjs(date).format(dateFormat), [dateFormat, date])\n\n if (formated === dateString) {\n return <>{dateString}\n }\n return (\n \n {dateString}\n \n {formated}\n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/dropdown-menu/dropdown-menu.tsx", "content": "import { useSetGlobalFocusableScope } from \"@follow/components/common/Focusable/hooks.js\"\nimport { Divider } from \"@follow/components/ui/divider/Divider.js\"\nimport { Kbd } from \"@follow/components/ui/kbd/Kbd.js\"\nimport { RootPortal } from \"@follow/components/ui/portal/index.js\"\nimport { useTypeScriptHappyCallback } from \"@follow/hooks\"\nimport { cn } from \"@follow/utils/utils\"\nimport * as DropdownMenuPrimitive from \"@radix-ui/react-dropdown-menu\"\nimport * as React from \"react\"\n\nimport { HotkeyScope } from \"~/constants\"\n\nconst styles = {\n content: {\n backgroundImage:\n \"linear-gradient(to bottom right, rgba(var(--color-background) / 0.98), rgba(var(--color-background) / 0.95))\",\n boxShadow:\n \"0 6px 20px rgba(0, 0, 0, 0.08), 0 4px 12px rgba(0, 0, 0, 0.05), 0 2px 6px rgba(0, 0, 0, 0.04), 0 4px 16px hsl(var(--fo-a) / 0.06), 0 2px 8px hsl(var(--fo-a) / 0.04), 0 1px 3px rgba(0, 0, 0, 0.03)\",\n } as React.CSSProperties,\n innerGlow: {\n background:\n \"linear-gradient(to bottom right, hsl(var(--fo-a) / 0.01), transparent, hsl(var(--fo-a) / 0.01))\",\n } as React.CSSProperties,\n}\n\nconst DropdownMenu: typeof DropdownMenuPrimitive.Root = (props) => {\n const setGlobalFocusableScope = useSetGlobalFocusableScope()\n return (\n {\n if (open) {\n setGlobalFocusableScope(HotkeyScope.DropdownMenu, \"append\")\n } else {\n setGlobalFocusableScope(HotkeyScope.DropdownMenu, \"remove\")\n }\n\n props.onOpenChange?.(open)\n },\n [props.onOpenChange],\n )}\n />\n )\n}\n\nconst DropdownMenuTrigger = DropdownMenuPrimitive.Trigger\nconst DropdownMenuGroup = DropdownMenuPrimitive.Group\nconst DropdownMenuPortal = DropdownMenuPrimitive.Portal\nconst DropdownMenuSub = DropdownMenuPrimitive.Sub\nconst DropdownMenuRadioGroup = DropdownMenuPrimitive.RadioGroup\n\nconst DropdownMenuSubTrigger = ({\n ref,\n className,\n inset,\n children,\n ...props\n}: React.ComponentPropsWithoutRef & {\n inset?: boolean\n} & {\n ref?: React.Ref | null>\n}) => (\n \n {children}\n \n \n)\nDropdownMenuSubTrigger.displayName = DropdownMenuPrimitive.SubTrigger.displayName\n\nconst DropdownMenuSubContent = ({\n ref,\n className,\n ...props\n}: React.ComponentPropsWithoutRef & {\n ref?: React.Ref | null>\n}) => (\n \n \n {/* Inner glow layer */}\n \n {/* Content wrapper */}\n
{props.children}
\n \n \n)\nDropdownMenuSubContent.displayName = DropdownMenuPrimitive.SubContent.displayName\n\nconst DropdownMenuContent = ({\n ref,\n className,\n sideOffset = 4,\n ...props\n}: React.ComponentPropsWithoutRef & {\n ref?: React.Ref | null>\n}) => {\n return (\n \n \n {/* Inner glow layer */}\n \n {/* Content wrapper */}\n
{props.children}
\n \n \n )\n}\nDropdownMenuContent.displayName = DropdownMenuPrimitive.Content.displayName\n\nconst DropdownMenuItem = ({\n ref,\n className,\n inset,\n icon,\n active,\n\n shortcut,\n checked,\n ...props\n}: React.ComponentPropsWithoutRef & {\n inset?: boolean\n icon?: React.ReactNode | ((props?: { isActive?: boolean }) => React.ReactNode)\n active?: boolean\n\n shortcut?: string\n checked?: boolean\n} & { ref?: React.Ref | null> }) => (\n \n {!!icon && (\n \n {typeof icon === \"function\" ? icon({ isActive: active }) : icon}\n \n )}\n {props.children}\n\n {/* Justify Fill */}\n {!!icon && }\n {!!shortcut && (\n <>\n \n \n {shortcut}\n \n \n )}\n {checked && !shortcut && (\n <>\n \n \n \n \n \n )}\n \n)\nDropdownMenuItem.displayName = DropdownMenuPrimitive.Item.displayName\n\nconst DropdownMenuCheckboxItem = ({\n ref,\n className,\n children,\n checked,\n ...props\n}: React.ComponentPropsWithoutRef & {\n ref?: React.Ref | null>\n}) => (\n \n \n \n \n \n \n {children}\n \n)\nDropdownMenuCheckboxItem.displayName = DropdownMenuPrimitive.CheckboxItem.displayName\n\nconst DropdownMenuLabel = ({\n ref,\n className,\n inset,\n ...props\n}: React.ComponentPropsWithoutRef & {\n inset?: boolean\n} & { ref?: React.Ref | null> }) => (\n \n)\nDropdownMenuLabel.displayName = DropdownMenuPrimitive.Label.displayName\n\nconst DropdownMenuSeparator = ({\n ref,\n ...props\n}: React.ComponentPropsWithoutRef & {\n ref?: React.Ref | null>\n}) => (\n \n \n \n)\nDropdownMenuSeparator.displayName = DropdownMenuPrimitive.Separator.displayName\n\nconst DropdownMenuShortcut = ({ className, ...props }: React.HTMLAttributes) => (\n \n)\nDropdownMenuShortcut.displayName = \"DropdownMenuShortcut\"\n\nexport {\n DropdownMenu,\n DropdownMenuCheckboxItem,\n DropdownMenuContent,\n DropdownMenuGroup,\n DropdownMenuItem,\n DropdownMenuLabel,\n DropdownMenuPortal,\n DropdownMenuRadioGroup,\n DropdownMenuSeparator,\n DropdownMenuShortcut,\n DropdownMenuSub,\n DropdownMenuSubContent,\n DropdownMenuSubTrigger,\n DropdownMenuTrigger,\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/fab/FABContainer.tsx", "content": "import { RootPortal } from \"@follow/components/ui/portal/index.jsx\"\nimport { useTypeScriptHappyCallback } from \"@follow/hooks\"\nimport { clsx, cn } from \"@follow/utils/utils\"\nimport { atom, useAtomValue } from \"jotai\"\nimport type { HTMLMotionProps } from \"motion/react\"\nimport { AnimatePresence } from \"motion/react\"\nimport type * as React from \"react\"\nimport type { FC, JSX, PropsWithChildren, ReactNode } from \"react\"\nimport { useId } from \"react\"\n\nimport { m } from \"~/components/common/Motion\"\nimport { jotaiStore } from \"~/lib/jotai\"\n\nconst fabContainerElementAtom = atom(null as HTMLDivElement | null)\n\nexport interface FABConfig {\n id: string\n icon: JSX.Element\n onClick: () => void\n}\n\nexport const FABBase: FC<\n PropsWithChildren<\n {\n id: string\n show?: boolean\n children: JSX.Element\n ref?: React.Ref\n } & HTMLMotionProps<\"button\">\n >\n> = (props) => {\n const { children, show = true, ref, ...extra } = props\n const { className, ...rest } = extra\n\n return (\n \n {show && (\n \n
\n {children}\n \n )}\n \n )\n}\n\nexport const FABPortable: FC<\n PropsWithChildren<{\n children: React.JSX.Element\n onClick: () => void\n show?: boolean\n ref?: React.Ref\n }>\n> = (props) => {\n const { onClick, children, show = true, ref } = props\n const id = useId()\n const portalElement = useAtomValue(fabContainerElementAtom)\n\n if (!portalElement) return null\n\n return (\n \n \n {children}\n \n \n )\n}\n\nexport const FABContainer = (props: { children?: ReactNode }) => {\n return (\n jotaiStore.set(fabContainerElementAtom, ref), [])}\n data-testid=\"fab-container\"\n data-hide-print\n className={clsx(\n \"fixed bottom-[calc(2rem+env(safe-area-inset-bottom))] left-[calc(100vw-3rem-1rem)] z-[9] flex flex-col\",\n \"transition-transform duration-300 ease-in-out\",\n )}\n >\n {props.children}\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/fab/index.ts", "content": "export * from \"./FABContainer\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/hover-preview/EntryPreviewCard.tsx", "content": "import {\n HoverCard,\n HoverCardContent,\n HoverCardTrigger,\n} from \"@follow/components/ui/hover-card/index.js\"\nimport { useEntry, usePrefetchEntryDetail } from \"@follow/store/entry/hooks\"\nimport { useFeedById } from \"@follow/store/feed/hooks\"\nimport { feedIconSelector } from \"@follow/store/feed/selectors\"\nimport { cn } from \"@follow/utils\"\nimport { m } from \"motion/react\"\nimport * as React from \"react\"\n\nimport { RelativeTime } from \"~/components/ui/datetime\"\nimport { FeedIcon } from \"~/modules/feed/feed-icon\"\n\ninterface EntryPreviewCardProps {\n entryId: string\n children: React.ReactNode\n className?: string\n onNavigate?: (entryId: string) => void\n}\n\nexport const EntryPreviewCard: React.FC = ({\n entryId,\n children,\n className,\n onNavigate,\n}) => {\n // Prefetch entry details on hover\n usePrefetchEntryDetail(entryId)\n\n const entry = useEntry(entryId, (state) => {\n if (!state) return null\n return {\n title: state.title,\n description: state.description,\n author: state.author,\n publishedAt: state.publishedAt,\n feedId: state.feedId,\n url: state.url,\n }\n })\n\n const feed = useFeedById(entry?.feedId, feedIconSelector)\n\n if (!entry || !feed) {\n return <>{children}\n }\n\n return (\n \n {children}\n \n \n {/* Header */}\n
\n \n \n
\n
{feed.title}
\n {feed.url}\n
\n \n
\n\n {/* Content */}\n
\n
\n {\n e.preventDefault()\n onNavigate?.(entryId)\n }}\n className=\"contents\"\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n >\n

{entry.title}

\n\n {entry.description && (\n

{entry.description}

\n )}\n \n\n
\n
\n {entry.author && by {entry.author}}\n
\n
\n \n
\n
\n
\n
\n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/hover-preview/FeedPreviewCard.tsx", "content": "import {\n HoverCard,\n HoverCardContent,\n HoverCardTrigger,\n} from \"@follow/components/ui/hover-card/index.js\"\nimport { useFeedById } from \"@follow/store/feed/hooks\"\nimport { feedIconSelector } from \"@follow/store/feed/selectors\"\nimport { cn } from \"@follow/utils\"\nimport { m } from \"motion/react\"\nimport * as React from \"react\"\n\nimport { FeedIcon } from \"~/modules/feed/feed-icon\"\n\ninterface FeedPreviewCardProps {\n feedId: string\n children: React.ReactNode\n className?: string\n\n onNavigate?: (feedId: string) => void\n}\n\nexport const FeedPreviewCard: React.FC = ({\n feedId,\n children,\n className,\n onNavigate,\n}) => {\n const feed = useFeedById(feedId, feedIconSelector)\n\n if (!feed) {\n return <>{children}\n }\n\n return (\n \n {children}\n \n \n {/* Header */}\n {\n e.preventDefault()\n onNavigate?.(feedId)\n }}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n >\n
\n \n
\n
\n

{feed.title}

\n
\n
\n
\n \n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/hover-preview/index.ts", "content": "export { EntryPreviewCard } from \"./EntryPreviewCard\"\nexport { FeedPreviewCard } from \"./FeedPreviewCard\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/keyboard-recorder/KeyRecorder.tsx", "content": "import { useReplaceGlobalFocusableScope } from \"@follow/components/common/Focusable/hooks.js\"\nimport { KbdCombined } from \"@follow/components/ui/kbd/Kbd.js\"\nimport { Tooltip, TooltipContent, TooltipTrigger } from \"@follow/components/ui/tooltip/index.js\"\nimport { sortShortcutKeys } from \"@follow/utils/utils\"\nimport type { FC, RefObject, SVGProps } from \"react\"\nimport { useEffect, useRef, useState } from \"react\"\nimport { useTranslation } from \"react-i18next\"\nimport { useOnClickOutside } from \"usehooks-ts\"\n\nimport { HotkeyScope } from \"~/constants\"\n\nexport interface KeyRecorderProps {\n onChange: (keys: string[] | null) => void\n onBlur: () => void\n}\n\nexport const KeyRecorder: FC = ({ onChange, onBlur }) => {\n const { t } = useTranslation(\"shortcuts\")\n const { currentKeys } = useShortcutRecorder()\n const setGlobalScope = useReplaceGlobalFocusableScope()\n\n const ref = useRef(null)\n useEffect(() => {\n const { rollback } = setGlobalScope(HotkeyScope.Recording)\n if (ref.current) {\n ref.current.focus()\n }\n return () => {\n rollback()\n }\n }, [setGlobalScope])\n useOnClickOutside(ref as RefObject, () => {\n if (currentKeys.length > 0) {\n onChange(currentKeys)\n }\n onBlur()\n })\n return (\n \n {currentKeys.length > 0 ? (\n
\n \n {currentKeys.join(\"+\")}\n \n
\n ) : (\n {t(\"settings.shortcuts.press_to_record\")}\n )}\n \n \n {\n e.stopPropagation()\n if (currentKeys.length === 0) {\n onChange(null)\n } else {\n onBlur()\n }\n }}\n >\n {currentKeys.length > 0 ? (\n \n ) : (\n \n )}\n \n \n \n {currentKeys.length > 0 ? t(\"settings.shortcuts.undo\") : t(\"settings.shortcuts.reset\")}\n \n \n
\n )\n}\n\nfunction FamiconsArrowUndoCircle(props: SVGProps) {\n return (\n \n {/* Icon from Famicons by Family - https://github.com/familyjs/famicons/blob/main/LICENSE */}\n \n \n )\n}\n\nconst MODIFIER_KEYS_MAP = {\n Control: \"Control\",\n Alt: \"Alt\",\n Shift: \"Shift\",\n Meta: \"Meta\",\n} as const\n\nconst MODIFIER_KEYS_SET = new Set(Object.values(MODIFIER_KEYS_MAP))\n\nconst F_KEY_REGEX = /^F(?:[1-9]|1[0-2])$/\n\nconst useShortcutRecorder = () => {\n const [currentKeys, setCurrentKeys] = useState([])\n\n useEffect(() => {\n const handleKeyDown = (event: KeyboardEvent) => {\n event.preventDefault()\n event.stopPropagation()\n event.stopImmediatePropagation()\n\n const { altKey, ctrlKey, metaKey, shiftKey, key: eventKey } = event\n\n let mainKeyPressed = eventKey\n\n if (mainKeyPressed.length === 1 && mainKeyPressed >= \"a\" && mainKeyPressed <= \"z\") {\n mainKeyPressed = mainKeyPressed.toUpperCase()\n } else if (mainKeyPressed === \" \") {\n mainKeyPressed = \"Space\"\n }\n\n const pressedKeysSet = new Set()\n\n if (shiftKey) pressedKeysSet.add(MODIFIER_KEYS_MAP.Shift)\n if (metaKey) pressedKeysSet.add(MODIFIER_KEYS_MAP.Meta)\n if (ctrlKey) pressedKeysSet.add(MODIFIER_KEYS_MAP.Control)\n if (altKey) pressedKeysSet.add(MODIFIER_KEYS_MAP.Alt)\n\n // If mainKeyPressed (from event.key) is not a modifier key, add it as the main key.\n // If mainKeyPressed is a modifier key (e.g., user only pressed Shift key, event.key is \"Shift\"),\n // it has already been handled and added to pressedKeysSet by the above if (shiftKey) logic,\n // so we don't need to add it again here.\n if (!MODIFIER_KEYS_SET.has(mainKeyPressed)) {\n pressedKeysSet.add(mainKeyPressed)\n }\n\n const currentCombination = Array.from(pressedKeysSet)\n\n // --- Start validation rules ---\n const nonModifierKeysInCombo = currentCombination.filter((key) => !MODIFIER_KEYS_SET.has(key))\n\n // Rule 2: Pure modifier key combinations are not allowed (e.g., just Shift, or Ctrl+Alt)\n if (nonModifierKeysInCombo.length === 0) {\n // When only modifier keys are pressed, currentCombination will still contain these modifiers.\n // For example, pressing only Shift, currentCombination is [\"Shift\"]\n // Here we don't update the state, indicating this is an invalid recording.\n // You can provide temporary UI feedback here, e.g.: \"Recording: Shift\"\n console.info(\n \"Recording (invalid - modifiers only):\",\n sortShortcutKeys(currentCombination).join(\" + \"),\n )\n return\n }\n\n // Typically shortcuts have only one \"main\" function key (e.g., Ctrl+A, Shift+F1)\n // If multiple non-modifier keys are detected (e.g., theoretically user pressing A and B simultaneously),\n // this is usually not a standard shortcut recording scenario\n // This check is mainly for code robustness, as `keydown` events typically focus on one main key at a time.\n if (nonModifierKeysInCombo.length > 1) {\n console.warn(\n \"Recording (invalid - multiple main keys, this shouldn't normally happen):\",\n sortShortcutKeys(currentCombination).join(\" + \"),\n )\n\n return\n }\n\n const primaryKey = nonModifierKeysInCombo[0]\n\n // Rule 3: Fn keys (F1-F12) can be single keys or modifier+Fn key combinations\n if (F_KEY_REGEX.test(primaryKey ?? \"\")) {\n setCurrentKeys(sortShortcutKeys(currentCombination))\n return\n }\n\n // Rule 1: Single \"ASCII\" main keys are allowed (here referring to all non-modifier, non-F keys)\n // Examples: A, 1, Space, Enter, ArrowUp, etc. They can be used alone or with modifiers.\n // For these keys, as long as they're not pure modifier combinations, they're considered valid.\n setCurrentKeys(sortShortcutKeys(currentCombination))\n }\n\n window.addEventListener(\"keydown\", handleKeyDown)\n return () => {\n window.removeEventListener(\"keydown\", handleKeyDown)\n }\n }, [setCurrentKeys])\n return { currentKeys }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/keyboard-recorder/index.ts", "content": "export * from \"./KeyRecorder\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/HTML.tsx", "content": "import { MemoedDangerousHTMLStyle } from \"@follow/components/common/MemoedDangerousHTMLStyle.js\"\nimport katexStyle from \"katex/dist/katex.min.css?raw\"\nimport {\n createElement,\n Fragment,\n memo,\n useEffect,\n useImperativeHandle,\n useMemo,\n useState,\n} from \"react\"\nimport type { JSX } from \"react/jsx-runtime\"\n\nimport { ENTRY_CONTENT_RENDER_CONTAINER_ID } from \"~/constants/dom\"\nimport { parseHtml } from \"~/lib/parse-html\"\nimport { useWrappedElementSize } from \"~/providers/wrapped-element-provider\"\n\nimport { MediaContainerWidthProvider } from \"../media/MediaContainerWidthProvider\"\nimport type { MediaInfoRecord } from \"../media/MediaInfoRecord\"\nimport { MediaInfoRecordProvider } from \"../media/MediaInfoRecordProvider\"\nimport { MarkdownRenderContainerRefContext } from \"./context\"\n\nexport type HTMLProps = {\n children: string | null | undefined\n as: A\n\n accessory?: React.ReactNode\n noMedia?: boolean\n mediaInfo?: Nullable\n} & JSX.IntrinsicElements[A] &\n Partial<{\n renderInlineStyle: boolean\n }>\nconst HTMLImpl = (props: HTMLProps) => {\n const {\n children,\n renderInlineStyle,\n as = \"div\",\n accessory,\n noMedia,\n mediaInfo,\n ref,\n ...rest\n } = props\n const [remarkOptions, setRemarkOptions] = useState({\n renderInlineStyle,\n noMedia,\n })\n const [shouldForceReMountKey, setShouldForceReMountKey] = useState(0)\n\n useEffect(() => {\n setRemarkOptions((options) => {\n if (JSON.stringify(options) === JSON.stringify({ renderInlineStyle, noMedia })) {\n return options\n }\n\n setShouldForceReMountKey((key) => key + 1)\n return { ...options, renderInlineStyle, noMedia }\n })\n }, [renderInlineStyle, noMedia])\n\n const [refElement, setRefElement] = useState(null)\n useImperativeHandle(ref as any, () => refElement)\n\n const markdownElement = useMemo(\n () =>\n children &&\n parseHtml(children, {\n ...remarkOptions,\n }).toContent(),\n [children, remarkOptions],\n )\n\n const { w: containerWidth } = useWrappedElementSize()\n\n if (!markdownElement) return null\n return (\n \n \n \n {katexStyle}\n {createElement(\n as,\n {\n ...rest,\n id: ENTRY_CONTENT_RENDER_CONTAINER_ID,\n ref: setRefElement,\n },\n markdownElement,\n )}\n \n \n {!!accessory && {accessory}}\n \n )\n}\n\nexport const HTML = memo(HTMLImpl)\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/Markdown.tsx", "content": "import { cn } from \"@follow/utils/utils\"\nimport { useMemo, useState } from \"react\"\n\nimport type { RemarkOptions } from \"~/lib/parse-markdown\"\nimport { parseMarkdown } from \"~/lib/parse-markdown\"\n\nimport { MarkdownRenderContainerRefContext } from \"./context\"\n\nexport const Markdown: Component<\n {\n children: string\n } & Partial\n> = ({ children, components, className, applyMiddleware }) => {\n const stableRemarkOptions = useState({ components, applyMiddleware })[0]\n\n const markdownElement = useMemo(\n () => parseMarkdown(children, { ...stableRemarkOptions }).content,\n [children, stableRemarkOptions],\n )\n const [refElement, setRefElement] = useState(null)\n\n return (\n \n \n {markdownElement}\n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/components/Toc.tsx", "content": "import { useViewport } from \"@follow/components/hooks/useViewport.js\"\nimport { EllipsisHorizontalTextWithTooltip } from \"@follow/components/ui/typography/EllipsisWithTooltip.js\"\nimport { nextFrame } from \"@follow/utils/dom\"\nimport { EventBus } from \"@follow/utils/event-bus\"\nimport { cn } from \"@follow/utils/utils\"\nimport * as HoverCard from \"@radix-ui/react-hover-card\"\nimport { AnimatePresence, m } from \"motion/react\"\nimport { memo, use, useCallback, useEffect, useImperativeHandle, useRef, useState } from \"react\"\n\nimport { COMMAND_ID } from \"~/modules/command/commands/id\"\nimport {\n useWrappedElementPosition,\n useWrappedElementSize,\n} from \"~/providers/wrapped-element-provider\"\n\nimport { MarkdownRenderContainerRefContext } from \"../context\"\nimport { useScrollTracking, useTocItems } from \"./hooks\"\nimport type { TocItemProps } from \"./TocItem\"\nimport { TocItem } from \"./TocItem\"\n\nexport interface ITocItem {\n depth: number\n title: string\n anchorId: string\n index: number\n $heading: HTMLHeadingElement\n}\n\nexport interface TocProps {\n onItemClick?: (index: number, $el: HTMLElement | null, anchorId: string) => void\n}\n\nconst WiderTocStyle = {\n width: 200,\n} satisfies React.CSSProperties\nexport interface TocRef {\n refreshItems: () => void\n}\nexport const Toc = ({\n ref,\n className,\n onItemClick,\n}: ComponentType & { ref?: React.Ref }) => {\n const markdownElement = use(MarkdownRenderContainerRefContext)\n const { toc, rootDepth, refreshItems } = useTocItems(markdownElement)\n const { currentScrollRange, handleScrollTo } = useScrollTracking(toc, {\n onItemClick,\n })\n\n useImperativeHandle(\n ref,\n useCallback(() => {\n return {\n refreshItems,\n }\n }, [refreshItems]),\n )\n\n const renderContentElementPosition = useWrappedElementPosition()\n const renderContentElementSize = useWrappedElementSize()\n const entryContentInWideMode = false\n const shouldShowTitle = useViewport((v) => {\n if (!entryContentInWideMode) return false\n const { w } = v\n const xAxis = renderContentElementPosition.x + renderContentElementSize.w\n\n return w - xAxis > WiderTocStyle.width + 50\n })\n\n if (toc.length === 0) return null\n\n return shouldShowTitle ? (\n \n ) : (\n \n )\n}\n\nconst TocContainer: React.FC = ({\n className,\n toc,\n rootDepth,\n currentScrollRange,\n handleScrollTo,\n}) => {\n return (\n \n {toc.map((heading, index) => (\n \n ))}\n
\n )\n}\n\nconst TocHoverCard: React.FC = ({\n className,\n toc,\n rootDepth,\n currentScrollRange,\n handleScrollTo,\n}) => {\n const [hoverShow, setHoverShow] = useState(false)\n\n return (\n
\n \n \n \n {toc.map((heading, index) => (\n \n ))}\n
\n \n \n
\n \n {hoverShow && (\n \n \n {toc.map((heading, index) => (\n \n {\n handleScrollTo(index, heading.$heading, heading.anchorId)\n nextFrame(() => {\n EventBus.dispatch(COMMAND_ID.layout.focusToEntryRender, {\n highlightBoundary: false,\n })\n })\n }}\n >\n \n {heading.title}\n \n\n \n H{heading.depth}\n \n \n \n ))}\n \n \n )}\n \n
\n \n \n
\n )\n}\n\nconst MemoedItem = memo((props) => {\n const {\n // active,\n range,\n ...rest\n } = props\n const active = range > 0\n\n const itemRef = useRef(null)\n\n useEffect(() => {\n if (!active) return\n\n const $item = itemRef.current\n if (!$item) return\n const $container = $item.parentElement\n if (!$container) return\n\n const containerHeight = $container.clientHeight\n const itemHeight = $item.clientHeight\n const itemOffsetTop = $item.offsetTop\n const { scrollTop } = $container\n\n const itemTop = itemOffsetTop - scrollTop\n const itemBottom = itemTop + itemHeight\n if (itemTop < 0 || itemBottom > containerHeight) {\n $container.scrollTop = itemOffsetTop - containerHeight / 2 + itemHeight / 2\n }\n }, [active])\n\n return \n})\nMemoedItem.displayName = \"MemoedItem\"\n\n// Types\ninterface TocContainerProps {\n className?: string\n toc: ITocItem[]\n rootDepth: number\n currentScrollRange: [number, number]\n handleScrollTo: (i: number, $el: HTMLElement | null, anchorId: string) => void\n}\n\ninterface TocHoverCardProps extends TocContainerProps {}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/components/TocItem.tsx", "content": "import { EllipsisHorizontalTextWithTooltip } from \"@follow/components/ui/typography/index.js\"\nimport { clsx, cn } from \"@follow/utils/utils\"\nimport type { FC, MouseEvent } from \"react\"\nimport { memo, useCallback, useRef } from \"react\"\n\nexport interface ITocItem {\n depth: number\n title: string\n anchorId: string\n index: number\n\n $heading: HTMLHeadingElement\n}\n\nexport interface TocItemProps {\n heading: ITocItem\n // active: boolean\n rootDepth: number\n onClick?: (i: number, $el: HTMLElement | null, anchorId: string) => void\n\n isScrollOut: boolean\n range: number\n variant?: \"line\" | \"title-line\"\n}\n\nexport const TocItem: FC = memo((props) => {\n const { onClick, heading, isScrollOut, range, variant = \"line\", rootDepth } = props\n const { $heading, anchorId, depth, index, title } = heading\n\n const $ref = useRef(null)\n\n const isTitleLine = variant === \"title-line\"\n return (\n {\n e.preventDefault()\n\n onClick?.(index, $heading, anchorId)\n },\n [anchorId, onClick, index, $heading],\n )}\n title={title}\n >\n {isTitleLine && (\n \n {title}\n \n )}\n \n \n \n \n )\n})\n\nconst widthMap = {\n 1: 72 - 6,\n 2: 60 - 6,\n 3: 48 - 6,\n 4: 36 - 6,\n 5: 24 - 6,\n 6: 12 - 6,\n}\n\nTocItem.displayName = \"TocItem\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/components/hooks.tsx", "content": "import { getViewport } from \"@follow/components/hooks/useViewport.js\"\nimport { useScrollViewElement } from \"@follow/components/ui/scroll-area/hooks.js\"\nimport { getElementTop } from \"@follow/utils/dom\"\nimport { springScrollToElement } from \"@follow/utils/scroller\"\nimport { throttle } from \"es-toolkit/compat\"\nimport { useStore } from \"jotai\"\nimport { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport type { ITocItem, TocProps } from \"./Toc\"\n\n// Hooks\nexport const useTocItems = (markdownElement: HTMLElement | null) => {\n const queryToCItems = useCallback(\n (): HTMLHeadingElement[] =>\n Array.from(markdownElement?.querySelectorAll(\"h1, h2, h3, h4, h5, h6\") || []),\n [markdownElement],\n )\n const [$headings, setHeadings] = useState(queryToCItems)\n\n useEffect(() => {\n setHeadings(queryToCItems())\n }, [markdownElement, queryToCItems])\n\n const toc: ITocItem[] = useMemo(\n () =>\n Array.from($headings).map((el, idx) => {\n const depth = +el.tagName.slice(1)\n const elClone = el.cloneNode(true) as HTMLElement\n const title = elClone.textContent || \"\"\n const index = idx\n\n return {\n depth,\n index: Number.isNaN(index) ? -1 : index,\n title,\n anchorId: el.dataset.rid || \"\",\n $heading: el,\n }\n }),\n [$headings],\n )\n\n const rootDepth = useMemo(\n () =>\n toc?.length\n ? (toc.reduce(\n (d: number, cur) => Math.min(d, cur.depth),\n toc[0]?.depth || 0,\n ) as any as number)\n : 0,\n [toc],\n )\n\n return {\n toc,\n rootDepth,\n refreshItems: useCallback(() => {\n setHeadings(queryToCItems())\n }, [queryToCItems]),\n }\n}\n\ntype DebouncedFuncLeading any> = T & {\n cancel: () => void\n flush: () => void\n}\n\nexport const useScrollTracking = (\n toc: ITocItem[],\n options: Pick & {\n useWindowScroll?: boolean\n },\n) => {\n const _scrollContainerElement = useScrollViewElement()\n const scrollContainerElement = options.useWindowScroll ? document : _scrollContainerElement\n const [currentScrollRange, setCurrentScrollRange] = useState([-1, 0] as [number, number])\n\n const headingTopsRef = useRef([])\n const [headingTopsVersion, setHeadingTopsVersion] = useState(0)\n const throttleCallerRef = useRef void>>(undefined)\n const store = useStore()\n\n useLayoutEffect(() => {\n if (!scrollContainerElement || toc.length === 0) {\n headingTopsRef.current = []\n setHeadingTopsVersion((v) => v + 1)\n return\n }\n\n const scrollContainerTop =\n scrollContainerElement === document ? 0 : getElementTop(scrollContainerElement as HTMLElement)\n\n const tops = toc.map(({ $heading }) => {\n const elementTop = getElementTop($heading)\n const top = elementTop - scrollContainerTop\n return top\n })\n\n headingTopsRef.current = tops\n setHeadingTopsVersion((v) => v + 1)\n }, [toc, scrollContainerElement])\n\n useEffect(() => {\n if (!scrollContainerElement || toc.length === 0) return\n\n const handler = throttle(() => {\n const storeViewport = getViewport(store)\n const winHeight = storeViewport.h\n const headingTops = headingTopsRef.current\n\n if (headingTops.length === 0) return\n\n const scrollTop =\n scrollContainerElement === document\n ? document.documentElement.scrollTop\n : (scrollContainerElement as HTMLElement).scrollTop\n\n const activationLine = scrollTop + winHeight / 3\n\n let activeIndex = -1\n for (let i = headingTops.length - 1; i >= 0; i--) {\n if (activationLine >= headingTops[i]!) {\n activeIndex = i\n break\n }\n }\n\n if (activeIndex === -1) {\n setCurrentScrollRange([-1, 0])\n } else if (activeIndex === headingTops.length - 1) {\n const lastHeadingTop = headingTops[activeIndex]!\n const contentEnd =\n scrollContainerElement === document\n ? document.documentElement.scrollHeight\n : (scrollContainerElement as HTMLElement).scrollHeight\n\n const total = contentEnd - lastHeadingTop\n const current = activationLine - lastHeadingTop\n const progress = Math.min(1, Math.max(0, total > 0 ? current / total : 0))\n setCurrentScrollRange([activeIndex, progress])\n } else {\n const currentHeadingTop = headingTops[activeIndex]!\n const nextHeadingTop = headingTops[activeIndex + 1]!\n const total = nextHeadingTop - currentHeadingTop\n const current = activationLine - currentHeadingTop\n const progress = Math.min(1, Math.max(0, total > 0 ? current / total : 0))\n setCurrentScrollRange([activeIndex, progress])\n }\n }, 100)\n\n throttleCallerRef.current = handler\n\n handler()\n\n scrollContainerElement.addEventListener(\"scroll\", handler, { passive: true })\n\n return () => {\n scrollContainerElement.removeEventListener(\"scroll\", handler)\n handler.cancel()\n }\n }, [scrollContainerElement, store, toc, headingTopsVersion])\n\n const handleScrollTo = useEventCallback(\n (i: number, $el: HTMLElement | null, _anchorId: string) => {\n options.onItemClick?.(i, $el, _anchorId)\n if ($el && scrollContainerElement) {\n springScrollToElement(\n $el,\n -100,\n scrollContainerElement === document ? undefined : (scrollContainerElement as HTMLElement),\n ).then(() => {\n throttleCallerRef.current?.cancel()\n setTimeout(() => {\n throttleCallerRef.current?.()\n }, 50)\n })\n }\n },\n )\n\n return { currentScrollRange, handleScrollTo }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/context.tsx", "content": "import { createContext as reactCreateContext } from \"react\"\nimport { createContext } from \"use-context-selector\"\n\nimport type { MarkdownImage, MarkdownRenderActions } from \"./types\"\n\nexport const MarkdownRenderContainerRefContext = reactCreateContext(null)\n\nexport const MarkdownImageRecordContext = createContext>({})\n\nexport const MarkdownRenderActionContext = reactCreateContext({\n transformUrl: (url) => url ?? \"\",\n isAudio: () => false,\n ensureAndRenderTimeStamp: () => false,\n})\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/BlockErrorBoundary.tsx", "content": "import { tracker } from \"@follow/tracker\"\nimport { useEffect } from \"react\"\n\nexport const BlockError = (props: { error: any; message: string }) => {\n useEffect(() => {\n console.error(props.error)\n void tracker.manager.captureException(props.error, {\n source: \"desktop_markdown_block_error\",\n message: props.message,\n })\n }, [props.error, props.message])\n return (\n
\n {props.message}\n\n 
{props.error?.message}
\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/BlockImage.tsx", "content": "import { cn } from \"@follow/utils/utils\"\nimport { use } from \"react\"\nimport { useContextSelector } from \"use-context-selector\"\n\nimport { useWrappedElementSize } from \"~/providers/wrapped-element-provider\"\n\nimport { Media } from \"../../media/Media\"\nimport { MarkdownImageRecordContext, MarkdownRenderActionContext } from \"../context\"\n\nexport const MarkdownBlockImage = (\n props: React.ImgHTMLAttributes & {\n proxy?: {\n width: number\n height: number\n }\n },\n) => {\n const size = useWrappedElementSize()\n\n const { transformUrl } = use(MarkdownRenderActionContext)\n const src = transformUrl(props.src)\n\n const media = useContextSelector(MarkdownImageRecordContext, (record) =>\n props.src ? record[props.src] : null,\n )\n\n return (\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/Heading.tsx", "content": "import { useScrollViewElement } from \"@follow/components/ui/scroll-area/hooks.js\"\nimport { springScrollToElement } from \"@follow/utils/scroller\"\nimport { cn } from \"@follow/utils/utils\"\nimport { use, useId, useRef } from \"react\"\n\nimport { MarkdownRenderContainerRefContext } from \"../context\"\n\nexport const createHeadingRenderer =\n (level: number) =>\n (\n props: React.DetailedHTMLProps, HTMLHeadingElement>,\n ) => {\n const rid = useId()\n\n const As = `h${level}` as any\n const { node, ...rest } = props as any\n\n const scroller = useScrollViewElement()\n const renderContainer = use(MarkdownRenderContainerRefContext)\n const ref = useRef(null)\n\n return (\n \n {rest.children}\n {\n if (!renderContainer) return\n\n springScrollToElement(\n renderContainer.querySelector(`[data-rid=\"${rid}\"]`)!,\n -100,\n scroller!,\n )\n }}\n >\n \n \n \n \n \n \n )\n }\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/InlineImage.tsx", "content": "import { cn } from \"@follow/utils/utils\"\nimport { use } from \"react\"\nimport { useContextSelector } from \"use-context-selector\"\n\nimport { Media } from \"../../media/Media\"\nimport { MarkdownImageRecordContext, MarkdownRenderActionContext } from \"../context\"\n\nexport const MarkdownInlineImage = (\n props: React.ImgHTMLAttributes & {\n proxy?: {\n width: number\n height: number\n }\n },\n) => {\n const { transformUrl } = use(MarkdownRenderActionContext)\n const populatedUrl = transformUrl(props.src)\n const media = useContextSelector(MarkdownImageRecordContext, (record) =>\n props.src ? record[props.src] : null,\n )\n\n return (\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/MarkdownLink.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport type { LinkProps } from \"@follow/components/ui/link/LinkWithTooltip.js\"\nimport {\n Tooltip,\n TooltipContent,\n TooltipPortal,\n TooltipTrigger,\n} from \"@follow/components/ui/tooltip/index.jsx\"\nimport { useCorrectZIndex } from \"@follow/components/ui/z-index/ctx.js\"\nimport { env } from \"@follow/shared/env.desktop\"\nimport { feedSyncServices } from \"@follow/store/feed/store\"\nimport { cn, parseSafeUrl, stopPropagation } from \"@follow/utils\"\nimport type { MouseEvent } from \"react\"\nimport { use, useCallback } from \"react\"\nimport { useTranslation } from \"react-i18next\"\nimport { toast } from \"sonner\"\n\nimport { navigateEntry } from \"~/hooks/biz/useNavigateEntry\"\nimport { copyToClipboard } from \"~/lib/clipboard\"\n\nimport { MarkdownRenderActionContext } from \"../context\"\n\nexport const MarkdownLink: Component = (props) => {\n const { transformUrl, isAudio, ensureAndRenderTimeStamp } = use(MarkdownRenderActionContext)\n const { t } = useTranslation()\n\n const populatedFullHref = transformUrl(props.href)\n const shareFeedInfo = parseShareFeedInfo(populatedFullHref)\n\n const handleCopyLink = useCallback(async () => {\n try {\n if (!populatedFullHref) {\n throw new Error(\"No URL to copy\")\n }\n await copyToClipboard(populatedFullHref)\n toast.success(t(\"share.link_copied\"))\n } catch {\n toast.error(t(\"share.copy_failed\"))\n }\n }, [populatedFullHref, t])\n\n const handleClickLink = useCallback(\n async (event: MouseEvent) => {\n stopPropagation(event)\n\n if (!shareFeedInfo) {\n return\n }\n event.preventDefault()\n\n const view = await resolveShareFeedView(shareFeedInfo)\n navigateEntry({\n feedId: shareFeedInfo.id,\n entryId: null,\n view,\n })\n },\n [shareFeedInfo],\n )\n\n const parseTimeStamp = isAudio(populatedFullHref)\n const zIndex = useCorrectZIndex(0)\n if (parseTimeStamp) {\n const childrenText = props.children\n\n if (typeof childrenText === \"string\") {\n const renderer = ensureAndRenderTimeStamp(childrenText)\n if (renderer) return renderer\n }\n }\n\n return (\n \n \n \n {props.children}\n\n {typeof props.children === \"string\" && (\n \n )}\n \n \n {!!populatedFullHref && (\n \n \n \n {populatedFullHref}\n \n\n \n \n \n \n \n )}\n \n )\n}\n\nconst parseShareFeedInfo = (href?: string) => {\n if (!href) return null\n\n const baseUrl = parseSafeUrl(env.VITE_WEB_URL)\n if (!baseUrl) return null\n\n let parsedUrl: URL\n try {\n parsedUrl = new URL(href, baseUrl)\n } catch {\n return null\n }\n\n if (parsedUrl.host !== baseUrl.host) return null\n\n const pathParts = parsedUrl.pathname.split(\"/\").filter(Boolean)\n if (pathParts.length !== 3 || pathParts[0] !== \"share\" || pathParts[1] !== \"feeds\") {\n return null\n }\n\n const viewParam = parsedUrl.searchParams.get(\"view\")\n const view = viewParam ? Number.parseInt(viewParam, 10) : undefined\n\n return {\n id: pathParts[2]!,\n view: Number.isNaN(view) ? undefined : view,\n }\n}\n\nconst resolveShareFeedView = async (info: { id: string; view?: number }) => {\n if (typeof info.view === \"number\") {\n return info.view\n }\n\n const data = await feedSyncServices.fetchFeedById({ id: info.id }).catch(() => {})\n const analyticsView = data?.analytics?.view\n if (typeof analyticsView === \"number\") {\n return analyticsView\n }\n\n return 0\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/MarkdownP.tsx", "content": "import * as React from \"react\"\n\nimport { MarkdownRenderActionContext } from \"../context\"\nimport { IsInParagraphContext } from \"./ctx\"\n\nexport const MarkdownP: Component<\n React.DetailedHTMLProps, HTMLParagraphElement>\n> = ({ children, ...props }) => {\n const { isAudio, ensureAndRenderTimeStamp } = React.use(MarkdownRenderActionContext)\n const parseTimeline = isAudio()\n if (parseTimeline && typeof children === \"string\") {\n const renderer = ensureAndRenderTimeStamp(children)\n if (renderer) return

{renderer}

\n }\n\n if (parseTimeline && Array.isArray(children)) {\n return (\n

\n {children.map((child, index) => {\n if (typeof child === \"string\") {\n const renderer = ensureAndRenderTimeStamp(child)\n if (renderer) return {renderer}\n }\n return {child}\n })}\n

\n )\n }\n\n return (\n

\n {children}\n

\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/ctx.tsx", "content": "import { createContext, use } from \"react\"\n\n/**\n * @internal\n */\nexport const IsInParagraphContext = createContext(false)\n\nexport const useIsInParagraphContext = () => {\n return use(IsInParagraphContext)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/renderers/index.ts", "content": "export * from \"./BlockImage\"\nexport * from \"./MarkdownLink\"\nexport * from \"./MarkdownP\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/markdown/types.ts", "content": "export type MarkdownImage = {\n url: string\n width?: number | undefined\n height?: number | undefined\n preview_image_url?: string | undefined\n blurhash?: string | undefined\n}\n\nexport interface MarkdownRenderActions {\n transformUrl: (url?: string) => string | undefined\n isAudio: (url?: string) => boolean\n ensureAndRenderTimeStamp: (children: string) => React.ReactNode\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/Media.tsx", "content": "import { nextFrame } from \"@follow/utils/dom\"\nimport { cn } from \"@follow/utils/utils\"\nimport { useForceUpdate } from \"motion/react\"\nimport type { FC, ImgHTMLAttributes, VideoHTMLAttributes } from \"react\"\nimport * as React from \"react\"\nimport { memo, use, useEffect, useMemo, useRef, useState } from \"react\"\nimport { Blurhash, BlurhashCanvas } from \"react-blurhash\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport { useGetImageProxyUrl } from \"~/lib/img-proxy\"\nimport { saveImageDimensionsToDb } from \"~/store/image/db\"\n\nimport { ErrorBoundary } from \"../../common/ErrorBoundary\"\nimport { useMediaContainerWidth, usePreviewMedia } from \"./hooks\"\nimport { MediaInfoRecordContext } from \"./MediaInfoRecordContext\"\nimport type { VideoPlayerRef } from \"./VideoPlayer\"\nimport { VideoPlayer } from \"./VideoPlayer\"\n\ntype BaseProps = {\n mediaContainerClassName?: string\n showFallback?: boolean\n thumbnail?: boolean\n blurhash?: string\n inline?: boolean\n fitContent?: boolean\n fitContainer?: boolean\n videoClassName?: string\n}\n\nconst isImageLoadedSet = new Set()\nexport type MediaProps = BaseProps &\n (\n | (ImgHTMLAttributes & {\n proxy?: {\n width: number\n height: number\n }\n preferOrigin?: boolean\n popper?: boolean\n type: \"photo\"\n previewImageUrl?: string\n cacheDimensions?: boolean\n })\n | (VideoHTMLAttributes & {\n proxy?: {\n width: number\n height: number\n }\n preferOrigin?: boolean\n popper?: boolean\n type: \"video\"\n previewImageUrl?: string\n })\n )\n\nconst MediaImpl: FC = ({\n className,\n proxy,\n preferOrigin,\n popper = false,\n mediaContainerClassName,\n thumbnail,\n ...props\n}) => {\n const {\n src,\n style,\n type,\n previewImageUrl,\n showFallback,\n blurhash,\n height,\n width,\n inline,\n fitContent,\n fitContainer,\n videoClassName,\n ...rest\n } = props\n const getImageProxyUrl = useGetImageProxyUrl()\n\n const ctxMediaInfo = use(MediaInfoRecordContext)\n const ctxHeight = ctxMediaInfo[src!]?.height\n const ctxWidth = ctxMediaInfo[src!]?.width\n\n const finalHeight = height || ctxHeight\n const finalWidth = width || ctxWidth\n\n // Define the list of available image sources, sorted by priority\n const imageSources = useMemo(() => {\n if (!src) return []\n\n const sources: Array<{ url: string; type: \"proxy\" | \"origin\" }> = []\n\n // Determine priority based on preferences\n if (proxy && !preferOrigin) {\n // Use proxy first\n sources.push(\n {\n url: getImageProxyUrl({\n url: src,\n width: proxy.width || 0,\n height: proxy.height || 0,\n }),\n type: \"proxy\",\n },\n { url: src, type: \"origin\" },\n )\n } else {\n // Use original URL first\n sources.push({ url: src, type: \"origin\" })\n if (proxy) {\n sources.push({\n url: getImageProxyUrl({\n url: src,\n width: proxy.width || 0,\n height: proxy.height || 0,\n }),\n type: \"proxy\",\n })\n }\n }\n\n return sources\n }, [src, proxy, preferOrigin, getImageProxyUrl])\n\n const [currentSourceIndex, setCurrentSourceIndex] = useState(0)\n const [isError, setIsError] = useState(false)\n const [mediaLoadState, setMediaLoadState] = useState<\"loading\" | \"loaded\">(\"loading\")\n\n const currentSource = imageSources[currentSourceIndex]\n const imgSrc = currentSource?.url || src\n\n const previewImageSrc = useMemo(() => {\n if (!previewImageUrl) return\n\n // Use the same proxy strategy for preview images\n if (proxy && currentSource?.type === \"proxy\") {\n return getImageProxyUrl({\n url: previewImageUrl,\n width: proxy.width || 0,\n height: proxy.height || 0,\n })\n }\n return previewImageUrl\n }, [previewImageUrl, proxy, currentSource?.type, getImageProxyUrl])\n\n // When image source list changes, reset to the first source\n const prevImageSources = useRef(imageSources)\n useEffect(() => {\n if (prevImageSources.current !== imageSources && imageSources.length > 0) {\n prevImageSources.current = imageSources\n setCurrentSourceIndex(0)\n setIsError(false)\n }\n }, [imageSources])\n\n // When image source changes, reset loading state\n const prevImgSrc = useRef(imgSrc)\n useEffect(() => {\n if (prevImgSrc.current !== imgSrc) {\n prevImgSrc.current = imgSrc\n setMediaLoadState(imgSrc && isImageLoadedSet.has(imgSrc) ? \"loaded\" : \"loading\")\n }\n }, [imgSrc])\n\n const errorHandle: React.ReactEventHandler = useEventCallback((e) => {\n const nextIndex = currentSourceIndex + 1\n\n if (import.meta.env.DEV) {\n console.info(\n `[Media Error] Failed to load image source ${currentSourceIndex + 1}/${imageSources.length}`,\n {\n failedSrc: imgSrc,\n originalSrc: src,\n error: e,\n willRetry: nextIndex < imageSources.length,\n nextSource: imageSources[nextIndex]?.url,\n },\n )\n }\n\n if (nextIndex < imageSources.length) {\n // Try next available image source\n setCurrentSourceIndex(nextIndex)\n setMediaLoadState(\"loading\")\n } else {\n // All sources failed, mark as error state\n setIsError(true)\n\n if (import.meta.env.DEV) {\n console.error(`[Media Error] All image sources failed for: ${src}`, {\n allSources: imageSources,\n originalSrc: src,\n })\n }\n }\n })\n\n const previewMedia = usePreviewMedia()\n const handleClick = useEventCallback((e: React.MouseEvent) => {\n e.preventDefault()\n if (popper && src) {\n const width = Number.parseInt(props.width as string)\n const height = Number.parseInt(props.height as string)\n previewMedia(\n [\n {\n url: src,\n type,\n fallbackUrl: imgSrc,\n blurhash: props.blurhash,\n width: width || undefined,\n height: height || undefined,\n },\n ],\n 0,\n )\n }\n props.onClick?.(e as any)\n })\n const handleOnLoad: React.ReactEventHandler = useEventCallback((e) => {\n setMediaLoadState(\"loaded\")\n rest.onLoad?.(e as any)\n\n if (import.meta.env.DEV) {\n console.info(`[Media Success] Image loaded successfully`, {\n src: imgSrc,\n originalSrc: src,\n sourceType: currentSource?.type,\n sourceIndex: currentSourceIndex + 1,\n totalSources: imageSources.length,\n dimensions: {\n width: e.currentTarget.naturalWidth,\n height: e.currentTarget.naturalHeight,\n ratio: e.currentTarget.naturalWidth / e.currentTarget.naturalHeight,\n },\n loadTime: performance.now(),\n })\n }\n\n if (imgSrc) {\n isImageLoadedSet.add(imgSrc)\n }\n if (\"cacheDimensions\" in props && props.cacheDimensions && src) {\n saveImageDimensionsToDb(src, {\n src,\n width: e.currentTarget.naturalWidth,\n height: e.currentTarget.naturalHeight,\n ratio: e.currentTarget.naturalWidth / e.currentTarget.naturalHeight,\n blurhash: props.blurhash,\n })\n }\n })\n\n const containerWidth = useMediaContainerWidth()\n\n const InnerContent = useMemo(() => {\n switch (type) {\n case \"photo\": {\n // @ts-expect-error\n const { cacheDimensions, ...props } = rest\n return (\n )}\n onError={errorHandle}\n className={cn(\n \"size-full object-contain\",\n inline && \"inline size-auto align-sub\",\n popper && \"cursor-zoom-in\",\n \"duration-200\",\n mediaLoadState === \"loaded\" ? \"opacity-100\" : \"opacity-0\",\n \"!my-0\",\n mediaContainerClassName,\n )}\n src={imgSrc}\n onLoad={handleOnLoad}\n onClick={handleClick}\n />\n )\n }\n case \"video\": {\n return (\n \n \n \n )\n }\n default: {\n return null\n }\n }\n }, [\n type,\n rest,\n finalHeight,\n finalWidth,\n errorHandle,\n inline,\n popper,\n mediaLoadState,\n mediaContainerClassName,\n imgSrc,\n handleOnLoad,\n handleClick,\n src,\n previewImageSrc,\n thumbnail,\n videoClassName,\n ])\n\n if (!type || !src) return null\n\n if (isError) {\n if (showFallback) {\n return (\n \n )\n } else {\n return (\n \n \n {props.blurhash && (\n \n \n \n \n \n )}\n \n
\n )\n }\n }\n\n return (\n \n {!!props.width && !!props.height && !!containerWidth ? (\n \n \n {blurhash ? (\n \n ) : (\n
\n )}\n
\n
\n {InnerContent}\n
\n \n ) : (\n InnerContent\n )}\n \n )\n}\n\nexport const Media: FC = memo((props) => )\n\nconst FallbackMedia: FC = ({ type, mediaContainerClassName, className, ...props }) => (\n
\n \n
\n \n

Media loaded failed

\n
\n Go to{\" \"}\n \n original media url\n \n \n
\n
\n
\n
\n)\n\nconst AspectRatio = ({\n width,\n height,\n containerWidth,\n children,\n style,\n fitContent,\n fitContainer,\n ...props\n}: {\n width: number\n height: number\n containerWidth?: number\n children: React.ReactNode\n style?: React.CSSProperties\n /**\n * If `fit` is true, the content width may be increased to fit the container width\n */\n fitContent?: boolean\n fitContainer?: boolean\n [key: string]: any\n}) => {\n const scaleFactor =\n containerWidth && width\n ? fitContent\n ? containerWidth / width\n : Math.min(1, containerWidth / width)\n : 1\n\n const scaledWidth = width ? width * scaleFactor : undefined\n const scaledHeight = height ? height * scaleFactor : undefined\n\n return (\n \n {children}\n
\n )\n}\n\nconst VideoPreview: FC<{\n src: string\n previewImageUrl?: string\n thumbnail?: boolean\n videoClassName?: string\n}> = ({ src, previewImageUrl, thumbnail = false, videoClassName }) => {\n const [isInitVideoPlayer, setIsInitVideoPlayer] = useState(!previewImageUrl)\n\n const [videoRef, setVideoRef] = useState(null)\n const isPaused = videoRef ? videoRef?.getState().paused : true\n const [forceUpdate] = useForceUpdate()\n return (\n {\n videoRef?.controls.play()?.then(forceUpdate)\n }}\n onMouseLeave={() => {\n videoRef?.controls.pause()\n nextFrame(forceUpdate)\n }}\n >\n {!isInitVideoPlayer ? (\n {\n setIsInitVideoPlayer(true)\n }}\n />\n ) : (\n \n )}\n\n \n \n
\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/MediaContainerWidthContext.tsx", "content": "import { createContext } from \"react\"\n\nexport const MediaContainerWidthContext = createContext(0)\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/MediaContainerWidthProvider.tsx", "content": "import { MediaContainerWidthContext } from \"./MediaContainerWidthContext\"\n\nexport const MediaContainerWidthProvider = ({\n children,\n width,\n}: {\n children: React.ReactNode\n width: number\n}) => {\n return {children}\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/MediaInfoRecord.tsx", "content": "export type MediaInfoRecord = Record\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/MediaInfoRecordContext.tsx", "content": "import { createContext } from \"react\"\n\nimport type { MediaInfoRecord } from \"./MediaInfoRecord\"\n\nexport const MediaInfoRecordContext = createContext({})\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/MediaInfoRecordProvider.tsx", "content": "import type { MediaInfoRecord } from \"./MediaInfoRecord\"\nimport { MediaInfoRecordContext } from \"./MediaInfoRecordContext\"\n\nconst noop = {} as const\nexport const MediaInfoRecordProvider = ({\n children,\n mediaInfo,\n}: {\n children: React.ReactNode\n mediaInfo?: Nullable\n}) => {\n return {children}\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/PreviewMediaContent.tsx", "content": "import { Spring } from \"@follow/components/constants/spring.js\"\nimport { MotionButtonBase } from \"@follow/components/ui/button/index.js\"\nimport { IN_ELECTRON } from \"@follow/shared/constants\"\nimport { stopPropagation } from \"@follow/utils/dom\"\nimport { cn } from \"@follow/utils/utils\"\nimport type { EntryMedia } from \"@follow-app/client-sdk\"\nimport useEmblaCarousel from \"embla-carousel-react\"\nimport { WheelGesturesPlugin } from \"embla-carousel-wheel-gestures\"\nimport { useAnimationControls } from \"motion/react\"\nimport type { FC } from \"react\"\nimport * as React from \"react\"\nimport { Fragment, use, useCallback, useEffect, useMemo, useRef, useState } from \"react\"\nimport { useTranslation } from \"react-i18next\"\nimport type { ReactZoomPanPinchRef, ReactZoomPanPinchState } from \"react-zoom-pan-pinch\"\nimport { TransformComponent, TransformWrapper } from \"react-zoom-pan-pinch\"\n\nimport { m } from \"~/components/common/Motion\"\nimport { GlassButton } from \"~/components/ui/button/GlassButton\"\nimport { COPY_MAP } from \"~/constants\"\nimport { ipcServices } from \"~/lib/client\"\nimport { useReplaceImgUrlIfNeed } from \"~/lib/img-proxy\"\n\nimport { useCurrentModal } from \"../modal/stacked/hooks\"\nimport type { VideoPlayerRef } from \"./VideoPlayer\"\nimport { VideoPlayer } from \"./VideoPlayer\"\n\n// Calculate the dynamic scale value and offset\nconst calculateDragTransforms = (x: number, y: number) => {\n // Minimum scale to 0.7, maximum keep 1.0\n const maxDistance = 300\n const dragDistance = Math.hypot(x, y)\n const progress = Math.min(dragDistance / maxDistance, 1)\n const scale = 1 - progress * 0.3 // From 1.0 to 0.7\n\n // Calculate the opacity, minimum to 0.5\n const opacity = 1 - progress * 0.5\n\n return { scale, opacity, x, y }\n}\n\n// Framer Motion variants\nconst modalVariants = {\n initial: { scale: 0.94, opacity: 0 },\n visible: { scale: 1, opacity: 1, x: 0, y: 0 },\n exit: { scale: 0.94, opacity: 0 },\n closing: (dragOffset: { x: number; y: number }) => ({\n scale: 0.3,\n x: dragOffset.x,\n y: dragOffset.y,\n opacity: 0,\n }),\n}\n\nconst PreviewWrapperDragContext = React.createContext<{\n isDragging: boolean\n lastDragEndAt: number\n}>({ isDragging: false, lastDragEndAt: 0 })\n\nconst Wrapper: FC<{\n src: string\n children:\n | [React.ReactNode, React.ReactNode | undefined]\n | React.ReactNode\n | ((\n onZoomChange: (isZoomed: boolean) => void,\n ) => [React.ReactNode, React.ReactNode | undefined] | React.ReactNode)\n className?: string\n onZoomChange?: (isZoomed: boolean) => void\n canDragClose?: boolean\n}> = ({ children, src, onZoomChange, canDragClose = true }) => {\n const containerRef = useRef(null)\n const { dismiss } = useCurrentModal()\n const controls = useAnimationControls()\n\n // Drag close state\n const [isImageZoomed, setIsImageZoomed] = useState(false)\n const [isDragging, setIsDragging] = useState(false)\n const [lastDragEndAt, setLastDragEndAt] = useState(0)\n const [dragOffset, setDragOffset] = useState({ x: 0, y: 0 })\n\n // Combined zoom change callback\n const handleZoomChange = useCallback(\n (isZoomed: boolean) => {\n setIsImageZoomed(isZoomed)\n onZoomChange?.(isZoomed)\n },\n [onZoomChange],\n )\n\n const renderedChildren = typeof children === \"function\" ? children(handleZoomChange) : children\n const isArray = Array.isArray(renderedChildren)\n const hasSideContent = isArray && !!renderedChildren[1]\n\n const enableDragClose = !isImageZoomed && canDragClose\n\n const handleDrag = useCallback(\n (_: any, info: any) => {\n if (!isDragging) return\n const { offset } = info\n setDragOffset(offset)\n\n // Real-time update the transform when dragging\n const dragTransforms = calculateDragTransforms(offset.x, offset.y)\n controls.set({\n scale: dragTransforms.scale,\n x: offset.x * 0.3,\n y: offset.y * 0.3,\n opacity: dragTransforms.opacity,\n })\n },\n [isDragging, controls],\n )\n\n const handleDragEnd = useCallback(\n async (_: any, info: any) => {\n const { offset, velocity } = info\n // Calculate the drag distance and velocity\n const dragDistance = Math.hypot(offset.x, offset.y)\n const velocityDistance = Math.hypot(velocity.x, velocity.y)\n\n // If the drag distance is greater than 100px or the overall drag distance is greater than 150px or the velocity is greater than 300, close the modal\n const shouldClose =\n offset.y > 100 || dragDistance > 150 || velocity.y > 300 || velocityDistance > 500\n\n if (shouldClose) {\n // Execute the closing animation\n await controls.start(\"closing\", {\n type: \"spring\",\n stiffness: 400,\n damping: 40,\n duration: 0.3,\n })\n dismiss()\n } else {\n // Reset to normal state\n setIsDragging(false)\n setLastDragEndAt(performance.now())\n setDragOffset({ x: 0, y: 0 })\n controls.start(\"visible\", {\n ...Spring.presets.snappy,\n })\n }\n },\n [controls, dismiss],\n )\n\n const handleDragStart = useCallback(() => {\n setIsDragging(true)\n }, [])\n\n // Initialize the animation\n useEffect(() => {\n controls.start(\"visible\", {\n ...Spring.presets.snappy,\n })\n }, [controls])\n\n const dragCtxValue = useMemo(() => ({ isDragging, lastDragEndAt }), [isDragging, lastDragEndAt])\n return (\n \n
\n \n \n \n {isArray ? renderedChildren[0] : renderedChildren}\n
\n {hasSideContent ? (\n \n {isArray ? renderedChildren[1] : null}\n \n ) : undefined}\n \n \n \n )\n}\n\nconst headerActionsVariants = {\n initial: { opacity: 0, translateY: \"-20px\" },\n animate: { opacity: 1, translateY: \"0px\" },\n exit: { opacity: 0, translateY: \"-20px\" },\n}\nconst GLASS_BUTTON_CLASS = tw`group-hover/left:opacity-100 opacity-0`\nconst HeaderActions: FC<{\n src: string\n}> = ({ src }) => {\n const { t } = useTranslation([\"shortcuts\", \"common\"])\n\n const { dismiss } = useCurrentModal()\n return (\n \n window.open(src)}\n >\n \n \n {IN_ELECTRON && (\n {\n ipcServices?.app.download(src)\n }}\n >\n \n \n )}\n\n \n \n \n \n )\n}\n\nexport interface PreviewMediaProps extends EntryMedia {\n fallbackUrl?: string\n}\nexport const PreviewMediaContent: FC<{\n media: PreviewMediaProps[]\n initialIndex?: number\n children?: React.ReactNode\n onZoomChange?: (isZoomed: boolean) => void\n}> = ({ media, initialIndex = 0, children, onZoomChange }) => {\n const videoRefs = useRef<(VideoPlayerRef | null)[]>([])\n const [emblaRef, emblaApi] = useEmblaCarousel({ loop: true, startIndex: initialIndex }, [\n WheelGesturesPlugin(),\n ])\n const [currentMedia, setCurrentMedia] = useState(media[initialIndex])\n\n // This only to delay show\n const [currentSlideIndex, setCurrentSlideIndex] = useState(initialIndex)\n\n useEffect(() => {\n if (emblaApi) {\n emblaApi.on(\"select\", () => {\n const realIndex = emblaApi.selectedScrollSnap()\n setCurrentMedia(media[realIndex])\n setCurrentSlideIndex(realIndex)\n })\n }\n }, [emblaApi, media])\n\n const { ref } = useCurrentModal()\n\n // Keyboard\n useEffect(() => {\n if (!emblaApi) return\n const $container = ref.current\n if (!$container) return\n const handleKeyDown = (e: KeyboardEvent) => {\n if (e.key === \"ArrowLeft\") emblaApi?.scrollPrev()\n if (e.key === \"ArrowRight\") emblaApi?.scrollNext()\n }\n $container.addEventListener(\"keydown\", handleKeyDown)\n return () => $container.removeEventListener(\"keydown\", handleKeyDown)\n }, [emblaApi, ref])\n\n const setVideoRef = useCallback((el: VideoPlayerRef | null, index: number) => {\n videoRefs.current[index] = el\n }, [])\n\n // Pause all videos when slide change\n // And play the current video if it's a video\n useEffect(() => {\n videoRefs.current.forEach((video) => {\n video?.controls.pause()\n })\n const currentVideo = videoRefs.current[currentSlideIndex]\n if (currentVideo) {\n currentVideo.controls.play()\n }\n }, [currentSlideIndex])\n\n if (media.length === 0) return null\n if (media.length === 1) {\n const src = media[0]!.url!\n const { type } = media[0]!\n const isVideo = type === \"video\"\n return (\n \n {(handleZoomChange) => [\n \n {isVideo ? (\n \n ) : (\n \n )}\n ,\n children,\n ]}\n \n )\n }\n return (\n \n {(handleZoomChange) => [\n
\n
\n {media.map((med, i) => (\n
\n {med.type === \"video\" ? (\n setVideoRef(el, i)}\n src={med.url}\n muted\n controls\n className=\"size-full object-contain\"\n onClick={(e) => e.stopPropagation()}\n />\n ) : (\n \n )}\n
\n ))}\n
\n\n {currentSlideIndex > 0 && (\n {\n emblaApi?.scrollPrev()\n }}\n >\n \n \n )}\n\n {currentSlideIndex < media.length - 1 && (\n {\n emblaApi?.scrollNext()\n }}\n >\n \n \n )}\n
,\n children,\n ]}\n \n )\n}\n\nconst FallbackableImage: FC<\n Omit, \"src\"> & {\n src: string\n containerClassName?: string\n fallbackUrl?: string\n blurhash?: string\n onZoomChange?: (isZoomed: boolean) => void\n }\n> = ({ src, fallbackUrl, containerClassName, onZoomChange, loading }) => {\n const replaceImgUrlIfNeed = useReplaceImgUrlIfNeed()\n const [currentSrc, setCurrentSrc] = useState(() => replaceImgUrlIfNeed(src))\n const [isAllError, setIsAllError] = useState(false)\n\n const [isLoading, setIsLoading] = useState(true)\n\n const [currentState, setCurrentState] = useState<\"proxy\" | \"origin\" | \"fallback\">(() =>\n currentSrc === src ? \"origin\" : \"proxy\",\n )\n\n const handleError = useCallback(() => {\n switch (currentState) {\n case \"proxy\": {\n if (currentSrc !== src) {\n setCurrentSrc(src)\n setCurrentState(\"origin\")\n } else {\n if (fallbackUrl) {\n setCurrentSrc(fallbackUrl)\n setCurrentState(\"fallback\")\n }\n }\n\n break\n }\n case \"origin\": {\n if (fallbackUrl) {\n setCurrentSrc(fallbackUrl)\n setCurrentState(\"fallback\")\n } else {\n setIsAllError(true)\n }\n break\n }\n case \"fallback\": {\n setIsAllError(true)\n }\n }\n }, [currentSrc, currentState, fallbackUrl, src])\n\n return (\n
\n {!isAllError && currentSrc && (\n setIsLoading(false)}\n onError={handleError}\n onZoomChange={onZoomChange}\n />\n )}\n {isAllError && (\n \n \n\n Failed to load image\n
\n {\n setCurrentSrc(replaceImgUrlIfNeed(src))\n setIsAllError(false)\n }}\n >\n Retry\n \n or\n \n Visit Original\n \n
\n
\n )}\n\n {currentState === \"fallback\" && (\n
\n \n This image is preview in low quality, because the original image is not available.\n \n
\n \n You can{\" \"}\n \n visit the original image\n {\" \"}\n if you want to see the full quality.\n \n
\n )}\n \n )\n}\n\nconst DOMImageViewer: FC<{\n height?: number\n width?: number\n onZoomChange?: (isZoomed: boolean) => any\n minZoom: number\n maxZoom: number\n src: string\n alt: string\n highResLoaded: boolean\n loading?: \"lazy\" | \"eager\"\n onLoad?: () => void\n onError?: () => void\n}> = ({\n height,\n width,\n onZoomChange,\n minZoom,\n maxZoom,\n src,\n alt,\n highResLoaded,\n loading = \"eager\",\n onLoad,\n onError,\n}) => {\n const { isDragging: isModalDragging, lastDragEndAt } = use(PreviewWrapperDragContext)\n const onTransformed = useCallback(\n (ref: ReactZoomPanPinchRef, state: Omit) => {\n const isZoomed = state.scale !== 1\n onZoomChange?.(isZoomed)\n },\n [onZoomChange],\n )\n const transformRef = useRef(null)\n\n useEffect(() => {\n if (transformRef.current) {\n transformRef.current.resetTransform()\n }\n }, [src])\n\n const { dismiss } = useCurrentModal()\n\n return (\n
\n \n {\n if (\n (e as React.MouseEvent).detail >= 2 ||\n isModalDragging ||\n performance.now() - lastDragEndAt < 150\n ) {\n stopPropagation(e)\n return\n }\n const target = e.target as HTMLElement\n // If click is not on the image container, treat it as overlay click and dismiss\n if (!target.closest(\"[data-image-container]\")) {\n dismiss()\n return\n }\n stopPropagation(e)\n },\n }}\n wrapperClass=\"!w-full !h-full !absolute !inset-0 cursor-default\"\n contentClass=\"!w-full !h-full flex items-center justify-center\"\n >\n \n \n
\n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/SwipeMedia.tsx", "content": "import type { MediaModel } from \"@follow/database/schemas/types\"\nimport { stopPropagation } from \"@follow/utils/dom\"\nimport { cn } from \"@follow/utils/utils\"\nimport useEmblaCarousel from \"embla-carousel-react\"\nimport { WheelGesturesPlugin } from \"embla-carousel-wheel-gestures\"\nimport { uniqBy } from \"es-toolkit/compat\"\nimport { useCallback, useRef } from \"react\"\n\nimport { Media } from \"~/components/ui/media/Media\"\n\nconst defaultProxySize = {\n width: 600,\n height: 0,\n}\n\nexport function SwipeMedia({\n media,\n className,\n imgClassName,\n onPreview,\n proxySize = defaultProxySize,\n fitContainer,\n}: {\n media?: MediaModel[] | null\n className?: string\n imgClassName?: string\n onPreview?: (media: MediaModel[], index?: number) => void\n proxySize?: {\n width: number\n height: number\n } | null\n fitContainer?: boolean\n}) {\n const uniqMedia = media ? uniqBy(media, \"url\") : []\n\n const hoverRef = useRef(null)\n\n const [emblaRef, emblaApi] = useEmblaCarousel({ loop: true }, [WheelGesturesPlugin()])\n\n const scrollPrev = useCallback(\n (e) => {\n e.preventDefault()\n e.stopPropagation()\n if (emblaApi) emblaApi.scrollPrev()\n },\n [emblaApi],\n )\n\n const scrollNext = useCallback(\n (e) => {\n e.preventDefault()\n e.stopPropagation()\n if (emblaApi) emblaApi.scrollNext()\n },\n [emblaApi],\n )\n\n if (!media) return null\n\n return (\n \n {uniqMedia?.length ? (\n
\n
\n {uniqMedia?.slice(0, 5).map((med, i) => (\n
\n {\n if (onPreview) {\n e.stopPropagation()\n onPreview(uniqMedia, i)\n }\n }}\n showFallback={true}\n fitContent\n fitContainer={fitContainer}\n />\n
\n ))}\n
\n {emblaApi?.canScrollPrev() && (\n \n \n \n )}\n {emblaApi?.canScrollNext() && (\n \n \n \n )}\n
\n ) : (\n
\n
\n
\n
\n
\n )}\n
\n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/VideoPlayer.tsx", "content": "import { Spring } from \"@follow/components/constants/spring.js\"\nimport { ActionButton, MotionButtonBase } from \"@follow/components/ui/button/index.js\"\nimport type { HTMLMediaState } from \"@follow/hooks\"\nimport { useRefValue, useVideo } from \"@follow/hooks\"\nimport { nextFrame, stopPropagation } from \"@follow/utils/dom\"\nimport { clsx, cn } from \"@follow/utils/utils\"\nimport * as Slider from \"@radix-ui/react-slider\"\nimport { m, useDragControls, useSpring } from \"motion/react\"\nimport type { PropsWithChildren, RefObject } from \"react\"\nimport {\n memo,\n startTransition,\n useEffect,\n useImperativeHandle,\n useMemo,\n useRef,\n useState,\n} from \"react\"\nimport { useHotkeys } from \"react-hotkeys-hook\"\nimport { useTranslation } from \"react-i18next\"\nimport { createContext, useContext, useContextSelector } from \"use-context-selector\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport { AudioPlayer } from \"~/atoms/player\"\nimport { Focusable } from \"~/components/common/Focusable\"\nimport { IconScaleTransition } from \"~/components/ux/transition/icon\"\nimport { HotkeyScope } from \"~/constants\"\n\nimport { VolumeSlider } from \"./VolumeSlider\"\n\ntype VideoPlayerProps = {\n src: string\n\n variant?: \"preview\" | \"player\" | \"thumbnail\"\n} & React.VideoHTMLAttributes &\n PropsWithChildren\nexport type VideoPlayerRef = {\n getElement: () => HTMLVideoElement | null\n\n getState: () => HTMLMediaState\n controls: {\n play: () => Promise | undefined\n pause: () => void\n seek: (time: number) => void\n volume: (volume: number) => void\n mute: () => void\n unmute: () => void\n }\n\n wrapperRef: RefObject\n}\n\ninterface VideoPlayerContextValue {\n state: HTMLMediaState\n controls: VideoPlayerRef[\"controls\"]\n wrapperRef: RefObject\n src: string\n variant: \"preview\" | \"player\" | \"thumbnail\"\n}\nconst VideoPlayerContext = createContext(null!)\nexport const VideoPlayer = ({\n ref,\n src,\n className,\n variant = \"player\",\n ...rest\n}: VideoPlayerProps & {\n ref?: React.Ref | ((ref: VideoPlayerRef) => void)\n}) => {\n const isPlayer = variant === \"player\"\n const [clickToStatus, setClickToStatus] = useState(null as \"play\" | \"pause\" | null)\n\n const scaleValue = useSpring(1, Spring.presets.smooth)\n const opacityValue = useSpring(0, Spring.presets.smooth)\n const handleClick = useEventCallback((e?: any) => {\n if (!isPlayer) return\n e?.stopPropagation()\n\n if (state.playing) {\n controls.pause()\n setClickToStatus(\"pause\")\n } else {\n controls.play()\n setClickToStatus(\"play\")\n }\n\n opacityValue.jump(1)\n scaleValue.jump(1)\n\n nextFrame(() => {\n scaleValue.set(1.3)\n opacityValue.set(0)\n })\n })\n\n const [element, state, controls, videoRef] = useVideo({\n src,\n className,\n playsInline: true,\n ...rest,\n controls: false,\n onClick(e) {\n rest.onClick?.(e)\n handleClick(e)\n },\n muted: isPlayer ? false : true,\n onDoubleClick(e) {\n rest.onDoubleClick?.(e)\n if (!isPlayer) return\n e.preventDefault()\n e.stopPropagation()\n if (!document.fullscreenElement) {\n wrapperRef.current?.requestFullscreen()\n } else {\n document.exitFullscreen()\n }\n },\n })\n\n useHotkeys(\"space\", (e) => {\n e.preventDefault()\n handleClick()\n })\n\n const stateRef = useRefValue(state)\n const memoedControls = useState(controls)[0]\n const wrapperRef = useRef(null)\n useImperativeHandle(\n ref,\n () => ({\n getElement: () => videoRef.current,\n getState: () => stateRef.current,\n controls: memoedControls,\n wrapperRef,\n }),\n\n [stateRef, videoRef, memoedControls],\n )\n\n return (\n \n {element}\n
\n \n \n \n
\n {state.hasAudio && !state.muted && state.playing && }\n {/* eslint-disable-next-line @eslint-react/no-context-provider */}\n ({ state, controls, wrapperRef, src, variant }),\n [state, controls, src, variant],\n )}\n >\n {variant === \"preview\" && state.hasAudio && }\n {isPlayer && }\n \n \n )\n}\nconst BizControlOutsideMedia = () => {\n const currentAudioPlayerIsPlayRef = useMemo(() => AudioPlayer.get().status === \"playing\", [])\n useEffect(() => {\n if (currentAudioPlayerIsPlayRef) {\n AudioPlayer.pause()\n }\n\n return () => {\n if (currentAudioPlayerIsPlayRef) {\n AudioPlayer.play()\n }\n }\n }, [currentAudioPlayerIsPlayRef])\n\n return null\n}\n\nconst FloatMutedButton = () => {\n // eslint-disable-next-line @eslint-react/no-use-context\n const ctx = useContext(VideoPlayerContext)\n const isMuted = ctx.state.muted\n return (\n {\n e.stopPropagation()\n if (isMuted) {\n ctx.controls.unmute()\n } else {\n ctx.controls.mute()\n }\n }}\n >\n \n \n )\n}\n\nconst ControlBar = memo(() => {\n const { t } = useTranslation()\n const controls = useContextSelector(VideoPlayerContext, (v) => v.controls)\n const isPaused = useContextSelector(VideoPlayerContext, (v) => v.state.paused)\n const dragControls = useDragControls()\n\n return (\n \n {/* Drag Area */}\n \n\n {\n if (isPaused) {\n controls.play()\n } else {\n controls.pause()\n }\n }}\n >\n \n \n \n \n\n {/* Progress bar */}\n \n\n {/* Right Action */}\n \n \n \n \n \n \n )\n})\n\nconst FullScreenControl = () => {\n const { t } = useTranslation()\n const ref = useContextSelector(VideoPlayerContext, (v) => v.wrapperRef)\n const [isFullScreen, setIsFullScreen] = useState(!!document.fullscreenElement)\n\n useEffect(() => {\n const onFullScreenChange = () => {\n setIsFullScreen(!!document.fullscreenElement)\n }\n document.addEventListener(\"fullscreenchange\", onFullScreenChange)\n return () => {\n document.removeEventListener(\"fullscreenchange\", onFullScreenChange)\n }\n }, [])\n\n return (\n {\n if (!ref.current) return\n\n if (isFullScreen) {\n document.exitFullscreen()\n } else {\n ref.current.requestFullscreen()\n }\n }}\n >\n {isFullScreen ? (\n \n ) : (\n \n )}\n \n )\n}\n\nconst DownloadVideo = () => {\n const { t } = useTranslation()\n const src = useContextSelector(VideoPlayerContext, (v) => v.src)\n const [isDownloading, setIsDownloading] = useState(false)\n const download = useEventCallback(() => {\n setIsDownloading(true)\n fetch(src)\n .then((res) => res.blob())\n .then((blob) => {\n const url = URL.createObjectURL(blob)\n const a = document.createElement(\"a\")\n a.href = url\n a.download = src.split(\"/\").pop()!\n a.click()\n URL.revokeObjectURL(url)\n setIsDownloading(false)\n })\n })\n\n return (\n \n {isDownloading ? (\n \n ) : (\n \n )}\n \n )\n}\nconst VolumeControl = () => {\n const { t } = useTranslation()\n const hasAudio = useContextSelector(VideoPlayerContext, (v) => v.state.hasAudio)\n\n const controls = useContextSelector(VideoPlayerContext, (v) => v.controls)\n const volume = useContextSelector(VideoPlayerContext, (v) => v.state.volume)\n const muted = useContextSelector(VideoPlayerContext, (v) => v.state.muted)\n if (!hasAudio) return null\n return (\n }\n enableHoverableContent\n onClick={() => {\n if (muted) {\n controls.unmute()\n } else {\n controls.mute()\n }\n }}\n >\n {muted ? (\n \n ) : (\n \n )}\n \n )\n}\n\nconst PlayProgressBar = () => {\n // eslint-disable-next-line @eslint-react/no-use-context\n const { state, controls } = useContext(VideoPlayerContext)\n const [currentDragging, setCurrentDragging] = useState(false)\n const [dragTime, setDragTime] = useState(0)\n\n useHotkeys(\"left\", (e) => {\n e.preventDefault()\n controls.seek(state.time - 5)\n })\n\n useHotkeys(\"right\", (e) => {\n e.preventDefault()\n controls.seek(state.time + 5)\n })\n return (\n {\n if (state.playing) {\n controls.pause()\n }\n setDragTime(state.time)\n setCurrentDragging(true)\n }}\n onValueChange={(value) => {\n setDragTime(value[0]!)\n startTransition(() => {\n controls.seek(value[0]!)\n })\n }}\n onValueCommit={() => {\n controls.play()\n setCurrentDragging(false)\n controls.seek(dragTime)\n }}\n >\n \n \n \n\n {/* indicator */}\n \n \n )\n}\n\nconst ActionIcon = ({\n className,\n onClick,\n children,\n shortcut,\n label,\n enableHoverableContent,\n}: {\n className?: string\n onClick?: () => void\n label: React.ReactNode\n children?: React.ReactNode\n shortcut?: string\n enableHoverableContent?: boolean\n}) => {\n return (\n \n {children || }\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/VolumeSlider.tsx", "content": "import * as Slider from \"@radix-ui/react-slider\"\nimport type { FC } from \"react\"\n\nexport const VolumeSlider: FC<{\n volume: number\n onVolumeChange: (volume: number) => void\n}> = ({ onVolumeChange, volume }) => (\n {\n onVolumeChange?.(values[0]!)\n }}\n >\n \n \n \n\n {/* indicator */}\n \n \n)\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/media/hooks.tsx", "content": "import { isMobile } from \"@follow/components/hooks/useMobile.js\"\nimport { use, useCallback } from \"react\"\n\nimport { PlainModal } from \"../modal/stacked/custom-modal\"\nimport { useModalStack } from \"../modal/stacked/hooks\"\nimport { MediaContainerWidthContext } from \"./MediaContainerWidthContext\"\nimport type { PreviewMediaProps } from \"./PreviewMediaContent\"\nimport { PreviewMediaContent } from \"./PreviewMediaContent\"\n\nexport const usePreviewMedia = (children?: React.ReactNode) => {\n const { present } = useModalStack()\n return useCallback(\n (media?: PreviewMediaProps[], initialIndex = 0) => {\n if (!media || media.length === 0) {\n return\n }\n if (isMobile()) {\n window.open(media[initialIndex]!.url)\n return\n }\n present({\n content: () => (\n \n {children}\n \n ),\n autoFocus: false,\n title: \"Media Preview\",\n overlay: false,\n overlayOptions: {\n blur: false,\n className: \"bg-transparent\",\n },\n CustomModalComponent: PlainModal,\n clickOutsideToDismiss: false,\n })\n },\n [children, present],\n )\n}\n\nexport const useMediaContainerWidth = () => {\n return use(MediaContainerWidthContext)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/components/close.tsx", "content": "import { cn } from \"@follow/utils\"\nimport { useTranslation } from \"react-i18next\"\n\nimport { GlassButton } from \"~/components/ui/button/GlassButton\"\n\nexport const FixedModalCloseButton: Component<{\n onClick: () => void\n className?: string\n}> = ({ onClick, className }) => {\n const { t } = useTranslation(\"common\")\n return (\n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/helper/useAsyncModal.tsx", "content": "/* eslint-disable react-refresh/only-export-components */\nimport { useOnce, useTypeScriptHappyCallback } from \"@follow/hooks\"\nimport type { FC } from \"react\"\nimport { createContext, createElement, use } from \"react\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport type { ModalActionsInternal } from \"~/components/ui/modal\"\nimport type { UseAsyncFetcher } from \"~/components/ui/modal/stacked/AsyncModalContent\"\nimport { AsyncModalContent } from \"~/components/ui/modal/stacked/AsyncModalContent\"\nimport { NoopChildren } from \"~/components/ui/modal/stacked/custom-modal\"\nimport { useModalStack } from \"~/components/ui/modal/stacked/hooks\"\n\nexport type AsyncModalOptions = {\n id: string\n title: ((data: T) => string) | string\n icon?: (data: T) => React.ReactNode\n useDataFetcher: () => UseAsyncFetcher\n content: FC\n\n // Modal options\n overlay?: boolean\n clickOutsideToDismiss?: boolean\n}\nconst AsyncModalContext = createContext>(null!)\nexport const useAsyncModal = () => {\n const { present } = useModalStack()\n\n return useEventCallback((options: AsyncModalOptions) => {\n present({\n id: options.id,\n content: () => (\n \n \n \n ),\n title: \"Loading...\",\n CustomModalComponent: NoopChildren,\n overlay: options.overlay,\n })\n })\n}\n\nconst LazyContent = () => {\n const ctx = use(AsyncModalContext)\n\n const queryResult = ctx.useDataFetcher()\n\n return (\n (\n \n ),\n [],\n )}\n />\n )\n}\n\nconst Presentable: FC<{\n data: any\n}> = ({ data }) => {\n const { present, dismissTop } = useModalStack()\n const ctx = use(AsyncModalContext)\n\n useOnce(() => {\n dismissTop()\n present({\n id: `presentable-${ctx.id}`,\n content: (props) => createElement(ctx.content, { data, ...props }),\n title: typeof ctx.title === \"function\" ? ctx.title(data) : ctx.title,\n icon: ctx.icon?.(data),\n clickOutsideToDismiss: ctx.clickOutsideToDismiss,\n })\n })\n return null\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/helper/useModalStackCalculationAndEffect.tsx", "content": "import { useAtomValue } from \"jotai\"\nimport { useEffect } from \"react\"\n\nimport { modalStackAtom } from \"../stacked/atom\"\n\nexport const useModalStackCalculationAndEffect = () => {\n const stack = useAtomValue(modalStackAtom)\n const topModalIndex = stack.findLastIndex((item) => item.modal)\n const overlayIndex = stack.findLastIndex((item) => item.overlay || item.modal)\n const overlayOptions = stack[overlayIndex]?.overlayOptions\n\n const hasModalStack = stack.length > 0\n const topModalIsNotSetAsAModal = topModalIndex !== stack.length - 1\n\n useEffect(() => {\n // NOTE: document.body is being used by radix's dismissable,\n // and using that will cause radix to get the value of `none` as the store value,\n // and then revert to `none` instead of `auto` after a modal dismiss.\n document.documentElement.style.pointerEvents =\n hasModalStack && !topModalIsNotSetAsAModal ? \"none\" : \"auto\"\n document.documentElement.dataset.hasModal = hasModalStack.toString()\n }, [hasModalStack, topModalIsNotSetAsAModal])\n\n return {\n overlayOptions,\n topModalIndex,\n hasModalStack,\n topModalIsNotSetAsAModal,\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/index.ts", "content": "export * from \"./stacked\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/inspire/InPeekModal.tsx", "content": "import { createContext, use } from \"react\"\n\nexport const InPeekModal = createContext(false)\nInPeekModal.displayName = \"InPeekModal\"\nexport const useInPeekModal = () => use(InPeekModal)\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/inspire/PeekModal.tsx", "content": "import { getStableRouterNavigate } from \"@follow/components/atoms/route.js\"\nimport { RootPortalContext } from \"@follow/components/ui/portal/provider.js\"\nimport type { PropsWithChildren, ReactNode } from \"react\"\nimport { useState } from \"react\"\nimport { useTranslation } from \"react-i18next\"\n\nimport { m } from \"~/components/common/Motion\"\nimport { GlassButton } from \"~/components/ui/button/GlassButton\"\n\nimport { FixedModalCloseButton } from \"../components/close\"\nimport { useCurrentModal, useModalStack } from \"../stacked/hooks\"\nimport { InPeekModal } from \"./InPeekModal\"\n\ninterface PeekModalProps {\n to?: string\n rightActions?: {\n onClick: () => void\n label: string\n icon: ReactNode\n }[]\n}\n\nexport const PeekModal = (props: PropsWithChildren) => {\n const { dismissAll } = useModalStack()\n\n const { to, children } = props\n const { t } = useTranslation(\"common\")\n const { dismiss } = useCurrentModal()\n const [rootRef, setRootRef] = useState(null)\n\n return (\n \n \n \n {children}\n \n \n {props.rightActions?.map((action) => (\n \n {action.icon}\n \n ))}\n {!!to && (\n {\n dismissAll()\n\n getStableRouterNavigate()?.(to)\n }}\n description={t(\"words.expand\")}\n size=\"md\"\n variant=\"flat\"\n >\n \n \n )}\n \n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/AsyncModalContent.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport { LoadingCircle } from \"@follow/components/ui/loading/index.jsx\"\nimport { Tooltip, TooltipContent, TooltipTrigger } from \"@follow/components/ui/tooltip/index.jsx\"\nimport { stopPropagation } from \"@follow/utils/dom\"\nimport { m } from \"motion/react\"\nimport * as React from \"react\"\nimport { useTranslation } from \"react-i18next\"\n\nimport { useCurrentModal } from \"~/components/ui/modal/stacked/hooks\"\nimport { createErrorToaster } from \"~/lib/error-parser\"\n\nexport interface UseAsyncFetcher {\n data: Nullable\n error: Nullable\n isLoading: boolean\n refetch: () => void\n}\ninterface AsyncModalContentProps {\n queryResult: UseAsyncFetcher\n renderContent: (data: T) => React.ReactNode\n loadingComponent?: React.ReactNode\n}\n\nfunction useCountdown(durationInSeconds: number): boolean {\n const [isFinished, setIsFinished] = React.useState(false)\n\n React.useEffect(() => {\n const timer = setTimeout(() => {\n setIsFinished(true)\n }, durationInSeconds * 1000)\n\n return () => clearTimeout(timer)\n }, [durationInSeconds])\n\n return isFinished\n}\n\nexport function AsyncModalContent({\n queryResult,\n renderContent,\n loadingComponent,\n}: AsyncModalContentProps) {\n const { data, isLoading, error, refetch } = queryResult\n const { dismiss } = useCurrentModal()\n\n const shouldShowCloseButton = useCountdown(2)\n React.useEffect(() => {\n if (error) {\n createErrorToaster()(error)\n }\n }, [error])\n const { t } = useTranslation(\"common\")\n\n if (isLoading || !data) {\n return (\n loadingComponent || (\n
\n \n \n {!!error && (\n \n \n refetch()}\n variant=\"outline\"\n buttonClassName=\"p-2 rounded-full\"\n layout\n >\n \n \n \n {t(\"retry\")}\n \n )}\n {(shouldShowCloseButton || !!error) && (\n \n \n \n \n \n \n {t(\"words.close\")}\n \n )}\n \n
\n )\n )\n }\n\n if (error) {\n return null // Error is already handled by the toaster\n }\n\n return renderContent(data)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/atom.ts", "content": "import { atom } from \"jotai\"\n\nimport type { ModalProps } from \"./types\"\n\nexport const modalStackAtom = atom([] as (ModalProps & { id: string })[])\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/bus.ts", "content": "import { createEventBus } from \"@follow/utils/event-bus\"\n\nexport const ModalEventBus = createEventBus<{\n DISMISS: ModalDisposeEvent\n RE_PRESENT: ModalRePresentEvent\n}>()\n\nexport type ModalDisposeEvent = {\n id: string\n}\n\nexport type ModalRePresentEvent = {\n id: string\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/components.tsx", "content": "import { MotionButtonBase } from \"@follow/components/ui/button/index.js\"\nimport { useTranslation } from \"react-i18next\"\n\nimport { useCurrentModal } from \"./hooks\"\n\nexport const ModalClose = () => {\n const { dismiss } = useCurrentModal()\n const { t } = useTranslation(\"common\")\n\n return (\n \n \n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/constants.ts", "content": "import { Spring } from \"@follow/components/constants/spring.js\"\nimport type { MotionProps, TargetAndTransition } from \"motion/react\"\n\nconst enterStyle: TargetAndTransition = {\n opacity: 1,\n // Draw the modal towards the viewer from depth\n transformPerspective: 1200,\n z: 0,\n}\nconst initialStyle: TargetAndTransition = {\n opacity: 0,\n transformPerspective: 1200,\n z: -48,\n}\n\nexport const modalMontionConfig = {\n initial: initialStyle,\n animate: enterStyle,\n exit: {\n ...initialStyle,\n transition: Spring.presets.smooth,\n },\n transition: Spring.presets.snappy,\n} satisfies MotionProps\n\n// Radix context menu z-index 999\nexport const MODAL_STACK_Z_INDEX = 1001\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/context.tsx", "content": "import type { FC, RefObject } from \"react\"\nimport { createContext as reactCreateContext } from \"react\"\nimport { createContext as createContextSelector } from \"use-context-selector\"\n\nimport type { ModalProps } from \"./types\"\n\nexport type CurrentModalContentProps = ModalActionsInternal & {\n ref: RefObject\n modalElementRef: RefObject\n}\n\nconst warnNoProvider = () => {\n if (import.meta.env.DEV) {\n console.error(\n \"No ModalProvider found, please make sure to wrap your component with ModalProvider\",\n )\n }\n}\nconst defaultCtxValue: CurrentModalContentProps = {\n dismiss: warnNoProvider,\n setClickOutSideToDismiss: warnNoProvider,\n ref: { current: null },\n modalElementRef: { current: null },\n getIndex: () => 0,\n}\n\nexport const CurrentModalContext = reactCreateContext(defaultCtxValue)\nexport const CurrentModalStateContext = createContextSelector<{\n isTop: boolean\n isInModal: boolean\n}>({\n isTop: true,\n isInModal: false,\n})\n\nexport type ModalContentComponent = FC\nexport type ModalActionsInternal = {\n dismiss: () => void\n setClickOutSideToDismiss: (value: boolean) => void\n getIndex: () => number\n}\n\ntype Disposer = () => void\ntype PresentModalContextInternalFn = (props: ModalProps & { id?: string }) => Disposer\nexport const PresentModalContextInternal = reactCreateContext(() => {\n warnNoProvider()\n return () => {}\n})\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/custom-modal.tsx", "content": "import { Spring } from \"@follow/components/constants/spring.js\"\nimport { nextFrame, stopPropagation } from \"@follow/utils/dom\"\nimport { cn } from \"@follow/utils/utils\"\nimport { m, useAnimationControls } from \"motion/react\"\nimport type { FC, PropsWithChildren } from \"react\"\nimport { useEffect, useState } from \"react\"\nimport type { JSX } from \"react/jsx-runtime\"\n\nimport { ModalClose } from \"./components\"\nimport { useCurrentModal } from \"./hooks\"\n\nexport const PlainModal = ({ children }: PropsWithChildren) => children\n\nexport const PlainWithAnimationModal = ({ children }: PropsWithChildren) => {\n return (\n \n {children}\n \n )\n}\n\nexport { PlainModal as NoopChildren }\n\ntype ModalTemplateType = {\n (props: PropsWithChildren<{ className?: string }>): JSX.Element\n class: (className: string) => (props: PropsWithChildren<{ className?: string }>) => JSX.Element\n}\n\nexport const SlideUpModal: ModalTemplateType = (props) => {\n const winHeight = useState(() => window.innerHeight)[0]\n const { dismiss } = useCurrentModal()\n return (\n
\n {\n if (definition === \"exit\") {\n dismiss()\n }\n }}\n className={cn(\n \"relative flex flex-col items-center overflow-hidden rounded-xl border bg-theme-background p-8 pb-0\",\n \"aspect-[7/9] w-[600px] max-w-full shadow lg:max-h-[calc(100vh-10rem)]\",\n \"motion-preset-slide-up motion-duration-200 motion-ease-spring-smooth\",\n props.className,\n )}\n >\n {props.children}\n\n \n \n
\n )\n}\n\nSlideUpModal.class = (className: string) => {\n return (props: ComponentType) => (\n \n )\n}\n\nconst modalVariant = {\n enter: {\n x: 0,\n opacity: 1,\n },\n initial: {\n x: 700,\n opacity: 0.9,\n },\n exit: {\n x: 750,\n opacity: 0,\n },\n}\n\nexport const DrawerModalLayout: FC = ({ children }) => {\n const { dismiss } = useCurrentModal()\n const controller = useAnimationControls()\n useEffect(() => {\n nextFrame(() => controller.start(\"enter\"))\n }, [controller])\n\n return (\n
\n {\n if (definition === \"exit\") {\n dismiss()\n }\n }}\n exit=\"exit\"\n layout=\"size\"\n className={cn(\n \"flex flex-col items-center overflow-hidden rounded-xl border bg-theme-background p-8 pb-0\",\n \"shadow-drawer-to-left w-[60ch] max-w-full\",\n \"fixed bottom-4 right-2 safe-inset-top-4\",\n )}\n >\n {children}\n \n
\n )\n}\n\nexport const ScaleModal: ModalTemplateType = (props) => {\n const { dismiss } = useCurrentModal()\n\n return (\n
\n \n {props.children}\n \n
\n )\n}\n\nScaleModal.class = (className: string) => {\n return (props: ComponentType) => (\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/declarative-modal.tsx", "content": "import { cn } from \"@follow/utils/utils\"\nimport { AnimatePresence } from \"motion/react\"\nimport type { FC, ReactNode } from \"react\"\nimport { useCallback, useEffect, useId, useMemo, useState } from \"react\"\n\nimport { jotaiStore } from \"~/lib/jotai\"\n\nimport { modalStackAtom } from \"./atom\"\nimport { ModalInternal } from \"./modal\"\nimport type { ModalProps } from \"./types\"\n\nexport interface DeclarativeModalProps extends Omit {\n open?: boolean\n defaultOpen?: boolean\n onOpenChange?: (open: boolean) => void\n children?: ReactNode\n\n id?: string\n}\n\nconst Noop = () => null\nconst DeclarativeModalImpl: FC = ({\n open,\n defaultOpen,\n onOpenChange,\n children,\n ...rest\n}) => {\n const index = useMemo(() => jotaiStore.get(modalStackAtom).length, [])\n const [internalOpen, setInternalOpen] = useState(defaultOpen ?? false)\n const id = useId()\n const item = useMemo(\n () => ({\n ...rest,\n content: Noop,\n id,\n open: internalOpen,\n }),\n [id, internalOpen, rest],\n )\n const handleOpenChange = useCallback(\n (open: boolean) => {\n setInternalOpen(open)\n onOpenChange?.(open)\n },\n [onOpenChange, setInternalOpen],\n )\n useEffect(() => {\n if (open !== undefined && open !== internalOpen) {\n setInternalOpen(open)\n }\n }, [open, internalOpen, setInternalOpen])\n return (\n \n {internalOpen && (\n \n {children}\n \n )}\n \n )\n}\n\nconst FooterAction: Component = ({ children, className }) => (\n
{children}
\n)\n\nexport const DeclarativeModal = Object.assign(DeclarativeModalImpl, {\n FooterAction,\n})\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/helper.tsx", "content": "import type { Enable } from \"re-resizable\"\nimport type { Context, PropsWithChildren } from \"react\"\nimport { memo, use } from \"react\"\n\nexport const InjectContext = (Context: Context) => {\n const ctxValue = use(Context)\n return memo(({ children }: PropsWithChildren) => {children})\n}\n\nexport function resizableOnly(...positions: (keyof Enable)[]) {\n const enable: Enable = {\n top: false,\n right: false,\n bottom: false,\n left: false,\n topRight: false,\n bottomRight: false,\n bottomLeft: false,\n topLeft: false,\n }\n\n for (const position of positions) {\n enable[position] = true\n }\n return enable\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/hooks.tsx", "content": "import { Button } from \"@follow/components/ui/button/index.js\"\nimport { atom, useAtomValue } from \"jotai\"\nimport type { DragControls } from \"motion/react\"\nimport type { ResizeCallback, ResizeStartCallback } from \"re-resizable\"\nimport { use, useDeferredValue, useState } from \"react\"\nimport { flushSync } from \"react-dom\"\nimport { useTranslation } from \"react-i18next\"\nimport { useContextSelector } from \"use-context-selector\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport { jotaiStore } from \"~/lib/jotai\"\n\nimport { modalStackAtom } from \"./atom\"\nimport { ModalEventBus } from \"./bus\"\nimport {\n CurrentModalContext,\n CurrentModalStateContext,\n PresentModalContextInternal,\n} from \"./context\"\nimport type { DialogInstance, ModalProps } from \"./types\"\n\nexport const modalIdToPropsMap = {} as Record\nexport const useModalStack = () => {\n const present = use(PresentModalContextInternal)\n\n return {\n present,\n ...actions,\n }\n}\nconst actions = {\n getTopModalStack() {\n return jotaiStore.get(modalStackAtom).at(-1)\n },\n getModalStackById(id: string) {\n return jotaiStore.get(modalStackAtom).find((item) => item.id === id)\n },\n dismiss(id: string) {\n ModalEventBus.dispatch(\"DISMISS\", {\n id,\n })\n },\n dismissTop() {\n const topModal = actions.getTopModalStack()\n\n if (!topModal) return\n actions.dismiss(topModal.id)\n },\n dismissAll() {\n const modalStack = jotaiStore.get(modalStackAtom)\n modalStack.forEach((item) => actions.dismiss(item.id))\n },\n}\n\nexport const useCurrentModal = () => use(CurrentModalContext)\n\nexport const useIsInModal = () => useContextSelector(CurrentModalStateContext, (v) => v.isInModal)\n\nexport const useResizeableModal = (\n modalElementRef: React.RefObject,\n {\n enableResizeable,\n dragControls,\n }: {\n enableResizeable: boolean\n dragControls?: DragControls\n },\n) => {\n const [resizeableStyle, setResizeableStyle] = useState({} as React.CSSProperties)\n const [isResizeable, setIsResizeable] = useState(false)\n const [preferDragDir, setPreferDragDir] = useState<\"x\" | \"y\" | null>(null)\n\n const relocateModal = useEventCallback(() => {\n if (!enableResizeable) return\n if (isResizeable) return\n const $modalElement = modalElementRef.current\n if (!$modalElement) return\n\n const rect = $modalElement.getBoundingClientRect()\n const { x, y } = rect\n\n flushSync(() => {\n setIsResizeable(true)\n setResizeableStyle({\n position: \"fixed\",\n top: `${y}px`,\n left: `${x}px`,\n })\n })\n })\n const handleResizeStart = useEventCallback(((e, dir) => {\n if (!enableResizeable) return\n relocateModal()\n\n const hasTop = /top/i.test(dir)\n const hasLeft = /left/i.test(dir)\n if (hasTop || hasLeft) {\n dragControls?.start(e as any)\n if (hasTop && hasLeft) {\n setPreferDragDir(null)\n } else if (hasTop) {\n setPreferDragDir(\"y\")\n } else if (hasLeft) {\n setPreferDragDir(\"x\")\n }\n }\n }) satisfies ResizeStartCallback)\n const handleResizeStop = useEventCallback((() => {\n setPreferDragDir(null)\n }) satisfies ResizeCallback)\n\n return {\n resizeableStyle,\n isResizeable,\n relocateModal,\n handleResizeStart,\n handleResizeStop,\n preferDragDir,\n }\n}\n\nexport const useIsTopModal = () => useContextSelector(CurrentModalStateContext, (v) => v.isTop)\n\nexport const useDialog = (): DialogInstance => {\n const { present } = useModalStack()\n const { t } = useTranslation()\n return {\n /**\n * Show a confirmation dialog with different visual variants\n * @param options.variant - Visual style variant:\n * - \"ask\" (default): Standard confirmation dialog\n * - \"warning\": Warning dialog with yellow icon and yellow confirm button\n * - \"danger\": Danger dialog with red icon and red confirm button\n */\n ask: useEventCallback((options) => {\n const variant = options.variant || \"ask\"\n\n // Variant-specific configuration\n const variantConfig = {\n ask: {\n icon: null,\n confirmVariant: \"primary\" as const,\n confirmClassName: \"\",\n },\n warning: {\n icon: ,\n confirmVariant: \"primary\" as const,\n confirmClassName: \"bg-yellow-500\",\n },\n danger: {\n icon: ,\n confirmVariant: \"primary\" as const,\n confirmClassName: \"bg-red-500\",\n },\n }\n\n const config = variantConfig[variant]\n\n return new Promise((resolve) => {\n present({\n title: (\n
\n {config.icon}\n {options.title}\n
\n ),\n content: ({ dismiss }) => (\n
\n
{options.message}
\n\n
\n {\n options.onCancel?.()\n resolve(false)\n dismiss()\n }}\n >\n {options.cancelText ?? t(\"words.cancel\", { ns: \"common\" })}\n \n {\n options.onConfirm?.()\n resolve(true)\n dismiss()\n }}\n >\n {options.confirmText ?? t(\"words.confirm\", { ns: \"common\" })}\n \n
\n
\n ),\n canClose: true,\n clickOutsideToDismiss: false,\n })\n })\n }),\n }\n}\n\nconst modalStackLengthAtom = atom((get) => get(modalStackAtom).length)\nexport const useHasModal = () => {\n // The keydown event of modal exit is triggered in the same loop,\n // leading to unexpected simultaneous responses to other hotkeys,\n // so deferredValue is added to delay the update\n return useDeferredValue(useAtomValue(modalStackLengthAtom) > 0)\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/index.ts", "content": "export * from \"./context\"\nexport * from \"./helper\"\n// NOTE: This one can easily cause a circular dependency\n// export * from \"./hooks\"\nexport * from \"./modal\"\nexport * from \"./provider\"\nexport * from \"./types\"\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/internal/use-animate.ts", "content": "import { Spring } from \"@follow/components/constants/spring.js\"\nimport { nextFrame } from \"@follow/utils/dom\"\nimport { useAnimationControls } from \"motion/react\"\nimport { useCallback, useEffect, useLayoutEffect, useState } from \"react\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport { ModalEventBus } from \"../bus\"\nimport { modalMontionConfig } from \"../constants\"\n\nexport interface ModalAnimateControls {\n animateController: ReturnType\n playNoticeAnimation: () => void\n playExitAnimation: () => Promise\n isClosing: boolean\n readyToClose: () => void\n}\n\n/**\n * @internal\n * Hook for managing modal animations including enter, notice, and exit animations\n */\nexport const useModalAnimate = (isTop: boolean, modalId: string): ModalAnimateControls => {\n const animateController = useAnimationControls()\n const [isClosing, setIsClosing] = useState(false)\n // Initial enter animation\n useEffect(() => {\n ModalEventBus.subscribe(\"RE_PRESENT\", (data) => {\n if (data.id !== modalId) {\n return\n }\n setIsClosing(false)\n animateController.start(modalMontionConfig.animate)\n })\n nextFrame(() => {\n animateController.start(modalMontionConfig.animate)\n })\n }, [animateController, modalId, setIsClosing])\n\n // Notice animation for when modal can't be dismissed\n const playNoticeAnimation = useCallback(() => {\n animateController\n .start({\n z: 6,\n transition: Spring.snappy(0.06),\n })\n .then(() => {\n animateController.start({\n z: 0,\n })\n })\n }, [animateController])\n\n // Stack position animation\n useLayoutEffect(() => {\n if (isTop) return\n animateController.start({\n z: -64,\n rotateX: 2.5,\n y: 8,\n })\n return () => {\n try {\n animateController.stop()\n animateController.start({\n z: 0,\n rotateX: 0,\n y: 0,\n })\n } catch {\n /* empty */\n }\n }\n }, [isTop, animateController])\n\n // Exit animation\n const playExitAnimation = useEventCallback(async () => {\n await animateController.start(modalMontionConfig.exit)\n })\n\n return {\n animateController,\n playNoticeAnimation,\n playExitAnimation,\n isClosing,\n readyToClose: useEventCallback(() => {\n if (isClosing) return // Prevent multiple calls\n\n setIsClosing(true)\n }),\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/internal/use-drag.ts", "content": "import { useDragControls } from \"motion/react\"\nimport type { PointerEventHandler, RefObject } from \"react\"\nimport { useCallback } from \"react\"\n\nimport { useResizeableModal } from \"../hooks\"\n\n/**\n * @internal\n */\nexport const useModalResizeAndDrag = (\n modalElementRef: RefObject,\n {\n resizeable,\n draggable,\n }: {\n resizeable: boolean\n draggable: boolean\n },\n) => {\n const dragController = useDragControls()\n const {\n handleResizeStop,\n handleResizeStart,\n relocateModal,\n preferDragDir,\n isResizeable,\n resizeableStyle,\n } = useResizeableModal(modalElementRef, {\n enableResizeable: resizeable,\n dragControls: dragController,\n })\n\n const handleDrag: PointerEventHandler = useCallback(\n (e) => {\n if (draggable) {\n dragController.start(e)\n }\n },\n [dragController, draggable],\n )\n\n return {\n handleDrag,\n handleResizeStart,\n handleResizeStop,\n relocateModal,\n preferDragDir,\n isResizeable,\n resizeableStyle,\n\n dragController,\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/internal/use-select.ts", "content": "import { nextFrame } from \"@follow/utils/dom\"\nimport { useCallback, useRef } from \"react\"\n\n/**\n * @internal\n *\n * Handle select text in modal\n */\nexport const useModalSelect = () => {\n const isSelectingRef = useRef(false)\n const handleSelectStart = useCallback(() => {\n isSelectingRef.current = true\n }, [])\n const handleDetectSelectEnd = useCallback(() => {\n nextFrame(() => {\n if (isSelectingRef.current) {\n isSelectingRef.current = false\n }\n })\n }, [])\n\n return {\n isSelectingRef,\n handleSelectStart,\n handleDetectSelectEnd,\n }\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/internal/use-subscriber.ts", "content": "import { useEffect } from \"react\"\n\nimport { ModalEventBus } from \"../bus\"\nimport type { ModalActionsInternal } from \"../context\"\n\n/** @internal */\nexport const useModalSubscriber = (id: string, ctx: ModalActionsInternal) => {\n useEffect(() => {\n return ModalEventBus.subscribe(\"DISMISS\", (data) => {\n if (data.id === id) {\n ctx.dismiss()\n }\n })\n }, [ctx, id])\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/modal-stack.tsx", "content": "import { useAtomValue } from \"jotai\"\nimport { AnimatePresence } from \"motion/react\"\n\nimport { useModalStackCalculationAndEffect } from \"../helper/useModalStackCalculationAndEffect\"\nimport { modalStackAtom } from \"./atom\"\nimport { useModalStack } from \"./hooks\"\nimport { ModalInternal } from \"./modal\"\n\nexport const ModalStack = () => {\n const { present } = useModalStack()\n window.presentModal = present\n\n const stack = useAtomValue(modalStackAtom)\n\n const { topModalIndex, overlayOptions } = useModalStackCalculationAndEffect()\n\n return (\n \n {stack.map((item, index) => (\n \n ))}\n \n )\n}\n" }, { "path": "apps/desktop/layer/renderer/src/components/ui/modal/stacked/modal.tsx", "content": "import { RootPortalContext } from \"@follow/components/ui/portal/provider.js\"\nimport { EllipsisHorizontalTextWithTooltip } from \"@follow/components/ui/typography/index.js\"\nimport { ZIndexProvider } from \"@follow/components/ui/z-index/index.js\"\nimport { useRefValue } from \"@follow/hooks\"\nimport { ELECTRON_BUILD } from \"@follow/shared/constants\"\nimport { preventDefault, stopPropagation } from \"@follow/utils/dom\"\nimport { cn, getOS } from \"@follow/utils/utils\"\nimport * as Dialog from \"@radix-ui/react-dialog\"\nimport { produce } from \"immer\"\nimport { useAtomValue, useSetAtom } from \"jotai\"\nimport { selectAtom } from \"jotai/utils\"\nimport type { BoundingBox } from \"motion/react\"\nimport { Resizable } from \"re-resizable\"\nimport type { FC, PropsWithChildren, SyntheticEvent } from \"react\"\nimport {\n createElement,\n Fragment,\n memo,\n useCallback,\n useEffect,\n useImperativeHandle,\n useMemo,\n useRef,\n useState,\n} from \"react\"\nimport { useEventCallback } from \"usehooks-ts\"\n\nimport { useUISettingKey } from \"~/atoms/settings/ui\"\nimport { AppErrorBoundary } from \"~/components/common/AppErrorBoundary\"\nimport { Focusable } from \"~/components/common/Focusable\"\nimport { SafeFragment } from \"~/components/common/Fragment\"\nimport { m } from \"~/components/common/Motion\"\nimport { ErrorComponentType } from \"~/components/errors/enum\"\nimport { ElECTRON_CUSTOM_TITLEBAR_HEIGHT, HotkeyScope } from \"~/constants\"\n\nimport { modalStackAtom } from \"./atom\"\nimport { MODAL_STACK_Z_INDEX, modalMontionConfig } from \"./constants\"\nimport type { CurrentModalContentProps, ModalActionsInternal } from \"./context\"\nimport { CurrentModalContext, CurrentModalStateContext } from \"./context\"\nimport { useModalAnimate } from \"./internal/use-animate\"\nimport { useModalResizeAndDrag } from \"./internal/use-drag\"\nimport { useModalSelect } from \"./internal/use-select\"\nimport { useModalSubscriber } from \"./internal/use-subscriber\"\nimport { ModalOverlay } from \"./overlay\"\nimport type { ModalOverlayOptions, ModalProps } from \"./types\"\n\nconst DragBar = ELECTRON_BUILD ? (\n \n) : null\nexport const ModalInternal = memo(function Modal({\n ref,\n item,\n overlayOptions,\n onClose: onPropsClose,\n children,\n isTop,\n index,\n isBottom,\n}: {\n item: ModalProps & { id: string }\n index: number\n\n isTop?: boolean\n isBottom?: boolean\n overlayOptions?: ModalOverlayOptions\n onClose?: (open: boolean) => void\n} & PropsWithChildren & { ref?: React.Ref }) {\n const {\n CustomModalComponent,\n content,\n title,\n clickOutsideToDismiss,\n\n modalClassName,\n modalContainerClassName,\n modalContentClassName,\n\n wrapper: Wrapper = Fragment,\n max,\n icon,\n canClose = true,\n\n draggable = false,\n resizeable = false,\n resizeDefaultSize,\n modal = true,\n autoFocus = true,\n } = item\n\n const setStack = useSetAtom(modalStackAtom)\n\n // Animation controls\n const { animateController, playNoticeAnimation, playExitAnimation, isClosing, readyToClose } =\n useModalAnimate(!!isTop, item.id)\n\n // Simple dismiss logic\n const close = useEventCallback(async (forceClose = false) => {\n if (!canClose && !forceClose) return\n readyToClose()\n try {\n if (CustomModalComponent) {\n // Custom modals handle their own animation\n setStack((p) => p.filter((modal) => modal.id !== item.id))\n } else {\n // Play exit animation then remove from stack\\\n await playExitAnimation()\n setStack((p) => p.filter((modal) => modal.id !== item.id))\n }\n } catch (error) {\n // If animation fails, still remove from stack\n console.warn(\"Modal animation failed:\", error)\n setStack((p) => p.filter((modal) => modal.id !== item.id))\n }\n\n item.onClose?.()\n onPropsClose?.(false)\n })\n\n const onClose = useCallback(\n (open: boolean): void => {\n if (!open) {\n close()\n }\n },\n [close],\n )\n\n const modalSettingOverlay = useUISettingKey(\"modalOverlay\")\n\n const dismiss = useCallback(\n (e: SyntheticEvent) => {\n e.stopPropagation()\n close(true)\n },\n [close],\n )\n\n const modalElementRef = useRef(null)\n const {\n handleDrag,\n handleResizeStart,\n handleResizeStop,\n relocateModal,\n preferDragDir,\n isResizeable,\n resizeableStyle,\n\n dragController,\n } = useModalResizeAndDrag(modalElementRef, {\n resizeable,\n draggable,\n })\n\n const getIndex = useEventCallback(() => index)\n const [modalContentRef, setModalContentRef] = useState(null)\n const ModalProps: ModalActionsInternal = useMemo(\n () => ({\n dismiss: close,\n getIndex,\n setClickOutSideToDismiss: (v) => {\n setStack((state) =>\n produce(state, (draft) => {\n const model = draft.find((modal) => modal.id === item.id)\n if (!model) return\n if (model.clickOutsideToDismiss === v) return\n model.clickOutsideToDismiss = v\n }),\n )\n },\n }),\n [close, getIndex, item.id, setStack],\n )\n useModalSubscriber(item.id, ModalProps)\n\n const ModalContextProps = useMemo(\n () => ({\n ...ModalProps,\n ref: { current: modalContentRef },\n modalElementRef,\n }),\n [ModalProps, modalContentRef],\n )\n\n const [edgeElementRef, setEdgeElementRef] = useState(null)\n\n const finalChildren = useMemo(\n () => (\n \n \n {children ?? createElement(content, ModalProps)}\n \n \n ),\n [ModalProps, children, content, edgeElementRef],\n )\n\n useEffect(() => {\n if (isClosing) {\n // Radix dialog will block pointer events\n document.body.style.pointerEvents = \"auto\"\n }\n }, [isClosing])\n\n const modalStyle = resizeableStyle\n const { handleSelectStart, handleDetectSelectEnd, isSelectingRef } = useModalSelect()\n const handleClickOutsideToDismiss = useCallback(\n (e: SyntheticEvent) => {\n if (isSelectingRef.current) return\n\n if (modal && clickOutsideToDismiss && canClose) {\n dismiss(e)\n } else if (modal) {\n playNoticeAnimation()\n }\n },\n [canClose, clickOutsideToDismiss, dismiss, modal, playNoticeAnimation, isSelectingRef],\n )\n\n const openAutoFocus = useCallback(\n (event: Event) => {\n if (!autoFocus) {\n event.preventDefault()\n }\n },\n [autoFocus],\n )\n\n const measureDragConstraints = useRef((constraints: BoundingBox) => {\n if (getOS() === \"Windows\") {\n return {\n ...constraints,\n top: constraints.top + ElECTRON_CUSTOM_TITLEBAR_HEIGHT,\n }\n }\n return constraints\n }).current\n\n useImperativeHandle(ref, () => modalElementRef.current!)\n const currentModalZIndex = MODAL_STACK_Z_INDEX + index * 2\n\n const Overlay = (\n