Refactor `js/storage/dmDb.js` to use a singleton connection pattern for IndexedDB.
Previously, the database was opened and closed for every single operation,
leading to significant overhead.
Changes:
- Introduced `dbInstance` and `dbPromise` to cache the database connection.
- Refactored `openDmDb` to reuse the existing connection or pending promise.
- Added `onversionchange` handler to safely close the connection if an upgrade is requested.
- Removed all manual `db.close()` calls from exported functions.
- Added a benchmark script in `tests/benchmark-dm-db.mjs` to verify the improvement.
Co-authored-by: PR0M3TH3AN <[email protected]>
Added comprehensive unit tests for js/utils/storagePointer.js, covering
normalization, parsing, derivation from URLs, and extraction from
Nostr tags. These tests improve coverage and ensure reliability of
core storage pointer handling logic.
Co-authored-by: PR0M3TH3AN <[email protected]>
Identified and removed several unused named imports from `./config.js`,
`./constants.js`, and `./lists.js` in `js/app.js`.
Unused from config.js: isDevMode, ADMIN_SUPER_NPUB, ADMIN_DM_IMAGE_URL,
MAX_WALLET_DEFAULT_ZAP, ALLOW_NSFW_CONTENT.
Unused from constants.js: URL_FIRST_ENABLED, getTrustedSpamHideThreshold,
DEFAULT_AUTOPLAY_BLOCK_THRESHOLD, DEFAULT_BLUR_THRESHOLD,
DEFAULT_TRUSTED_MUTE_HIDE_THRESHOLD, DEFAULT_TRUSTED_SPAM_HIDE_THRESHOLD.
Unused from lists.js: ADMIN_INITIAL_EVENT_BLACKLIST.
These symbols were imported but not utilized within the file, or were
erroneously referenced via `this.` when the intended value was the
imported constant (which remained unused).
Verified with existing unit tests and manual inspection.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Updated `connectRemoteSigner` signature to include `validator` in the destructured parameters.
- Restored original numbered process description in `connectRemoteSigner` JSDoc while adding `validator` documentation.
- Cleaned up `js/services/authProviders/nip46.js` by removing outdated TODO comments.
- Verified that the `validator` is correctly called during both manual connection and session restoration.
- Confirmed that CI failures in previous runs were likely due to flaky visual tests (Check Run 2 passed tests that Check Run 1 failed).
Co-authored-by: PR0M3TH3AN <[email protected]>
- Optimized `collectChannelVideos` in `js/channelProfile.js` to use `nostrService.ensureVideosByAuthorIndex()`.
- Optimized `updateProfileInDOM` in `js/app.js` to use the author index when decorating videos.
- Improved indexing consistency by using `nostrService.cacheVideos()` when updating `videosMap`.
- Refined fallback logic to return empty results directly when the index is authoritative.
- Established a performance baseline showing ~3000x speedup for video lookups.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Updated `NostrClient.connectRemoteSigner` signature to `connectRemoteSigner(options = {})`, fixing a `ReferenceError` where the code was attempting to access `options.validator` while `options` was not defined (due to direct destructuring in the signature).
- Added JSDoc documentation for the `validator` parameter in both `connectRemoteSigner` and `useStoredRemoteSigner`.
- Cleaned up outdated TODO comments in `js/services/authProviders/nip46.js`.
- Verified that the `validator` is correctly extracted from `options` and called during session restoration.
- Confirmed that unit tests in `tests/services/auth-providers.test.mjs` pass.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Updated `NostrClient.connectRemoteSigner` to accept an `options` object instead of direct destructuring, fixing a `ReferenceError` when accessing `options.validator`.
- Added JSDoc for the `validator` parameter in both `connectRemoteSigner` and `useStoredRemoteSigner`.
- Removed outdated comments in `js/services/authProviders/nip46.js` that claimed `useStoredRemoteSigner` didn't support validators.
- Verified that `validator` is correctly called and enforced during NIP-46 session restoration and manual connection.
Co-authored-by: PR0M3TH3AN <[email protected]>
Replaces legacy scroll listener with `IntersectionObserver` to eliminate layout thrashing.
- Updates `js/docsView.js` with `rootMargin: "-96px 0px -50% 0px"` and correct scroll-up logic.
- Synchronizes `dist/js/docsView.js` to match the source logic exactly.
- Updates benchmarks to use the same logic for verification.
- Updates lint scripts to exclude benchmarks.
Co-authored-by: PR0M3TH3AN <[email protected]>
Replaces the O(N) getBoundingClientRect polling loop in the docs scroll spy with an IntersectionObserver. This eliminates potential layout thrashing and reduces main thread CPU usage during scrolling.
- Replaces `window.addEventListener("scroll")` with `IntersectionObserver`.
- Maintains active section state using `passedHeadings` set.
- Updates `setupScrollSpy` and `clearScrollSpy` to manage the observer.
- Preserves existing behavior where the active section is the last one that has passed the top offset (96px). Note: Activation now occurs when the header *fully* exits the top offset area, which is a minor behavior change (delayed by header height) but improves performance and stability.
Co-authored-by: PR0M3TH3AN <[email protected]>
Updates `scripts/check-hex.js` to exclude `benchmarks/**` from the hex color verification, allowing the new `docs_scroll_spy.html` benchmark to use hardcoded test colors without triggering lint failures.
Co-authored-by: PR0M3TH3AN <[email protected]>
Replaces the scroll event listener and `getBoundingClientRect` polling with `IntersectionObserver` to eliminate layout thrashing and improve scrolling performance.
- Removes `window.onscroll` handler in `docsView.js`.
- Implements `IntersectionObserver` with `rootMargin` to track active headings.
- Retains initial one-time scan for correct state on load.
- Adds benchmark `benchmarks/docs_scroll_spy.html` and `benchmarks/docs_scroll_spy_bench.js`.
Benchmark results:
- Legacy: ~0.065ms/call (200 calls) -> Total ~13ms CPU (sync layout thrashing)
- Optimized: ~0.028ms/call (32 calls) -> Total ~0.9ms CPU
- 14x improvement in CPU time for scroll handler logic.
Co-authored-by: PR0M3TH3AN <[email protected]>
Refactor ProfileCache memoryCache from a flat Map to a nested Map (Pubkey -> Section -> Data).
This allows clearing a user's cache in O(1) time instead of O(N) by deleting the user's entry directly, avoiding a full scan of all cache keys.
Benchmark showed improvement from ~58ms to ~0.0014ms for clearing a user in a cache with 20,000 users (100,000 entries).
Co-authored-by: PR0M3TH3AN <[email protected]>
- Introduce incremental similarity updates in `createExploreDiversitySorter`.
- Cache max similarity for each candidate to avoid redundant calculations.
- Reduces sort time for 1000 items from ~33s to ~170ms.
Co-authored-by: PR0M3TH3AN <[email protected]>
Add a detailed guide for AI assistants working with the bitvid codebase.
The document covers:
- Project overview and technology stack
- Codebase structure and essential files
- Development workflow and setup instructions
- CI/CD pipeline overview with job timeouts
- Code conventions (logging, styling, Nostr events, magnets)
- Architecture patterns (bitvidApp vs controllers)
- Feature flags and runtime configuration
- Nostr integration details and NIP usage
- Testing guidelines and common troubleshooting
- Quick reference for imports and content schema
This complements AGENTS.md (mission/architecture) and CONTRIBUTING.md
(setup/PR process) by providing AI-specific context and patterns.
https://claude.ai/code/session_014BfcJJAuzSHDwdoyYKoHZG
- Removed force flag (!) from `/* /index.html 200` in `_redirects` to allow static assets to be served.
- Restored `scripts/build-dist.mjs` to properly clean `dist/`, build CSS, and copy assets.
- Updated `package.json` to use the new build script and serve `dist`.
- Updated `netlify.toml` to publish the `dist` directory.
- Updated `dist/` artifacts to match current source.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Restore `scripts/build-dist.mjs` to clean `dist/`, build CSS, and copy assets.
- Update `package.json` to use the new build script and serve `dist`.
- Update `netlify.toml` to publish the `dist` directory.
- Update `dist/` artifacts to match current source.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Fix `ReferenceError: plainCall is not defined` in `tests/nostr-login-permissions.test.mjs` which caused CI failures.
- Add `_redirects` file for Netlify SPA routing to fix deployment redirect rule errors.
- Parallelize `deleteAllVersions` in `js/nostr/client.js` to significantly improve batch deletion performance by decoupling network publishing from serial signing.
The batch deletion optimization reduces execution time by ~40% for large batches (500+ events) by running network requests concurrently while maintaining serial signing for NIP-07 compatibility.
Co-authored-by: PR0M3TH3AN <[email protected]>
Handle the `TypeError: Cannot set property navigator of #<Object> which has only a getter` by attempting to set `globalThis.navigator` directly and falling back to `Object.defineProperty` if it's read-only. This ensures compatibility with environments where `navigator` is non-writable (like newer Node.js versions or certain test runners).
Co-authored-by: PR0M3TH3AN <[email protected]>
Use `tailwindcss` directly in the `build:css` script instead of `npx tailwindcss`. This ensures the local binary (installed in `node_modules/.bin`) is used, avoiding potential `npx` path resolution failures or network requests in restricted CI environments (like Netlify).
Co-authored-by: PR0M3TH3AN <[email protected]>
1. Move build-critical dependencies (`tailwindcss`, `postcss`, `autoprefixer`, etc.) to `dependencies` in `package.json` to prevent build failures in production environments (like Netlify) that prune `devDependencies`.
2. Ensure `_redirects` exists in the root directory (copied from `dist/_redirects`) so Netlify processes redirect rules correctly when publishing from root.
Co-authored-by: PR0M3TH3AN <[email protected]>
Optimize `executePendingRetry` in `js/channelProfile.js` to run zap attempts in parallel using `Promise.allSettled`, improving performance when retrying multiple shares.
Refactor `splitAndZap` in `js/payments/zapSplit.js` to accept `overrideFee` as an argument, eliminating reliance on a global variable and ensuring thread safety during parallel execution.
Update `js/ui/zapController.js` to use the new `splitAndZap` API.
Fix: Resolve ReferenceError in `tests/nostr-login-permissions.test.mjs` by correctly destructuring `plainCall` from `env.enableCalls`.
Co-authored-by: PR0M3TH3AN <[email protected]>
Adds a `_redirects` file to the root directory with the rule `/* /index.html 200!` to support Single Page Application (SPA) routing on Netlify.
This resolves the "Redirect rules" CI failure and ensures that client-side routes (e.g., `/video/:id`) do not return 404s when accessed directly.
Co-authored-by: PR0M3TH3AN <[email protected]>
- Fix `ReferenceError: plainCall is not defined` in `tests/nostr-login-permissions.test.mjs` which caused CI failures.
- Parallelize `deleteAllVersions` in `js/nostr/client.js` to significantly improve batch deletion performance by decoupling network publishing from serial signing.
The batch deletion optimization reduces execution time by ~40% for large batches (500+ events) by running network requests concurrently while maintaining serial signing for NIP-07 compatibility.
Co-authored-by: PR0M3TH3AN <[email protected]>
Fix `ReferenceError: plainCall is not defined` in `tests/nostr-login-permissions.test.mjs` by properly destructuring the `plainCall` variable from the `env.enableCalls` array in the failing test case.
This fixes a regression that was blocking CI execution.
Co-authored-by: PR0M3TH3AN <[email protected]>
Refactor `createResolvePostedAtStage` to execute timestamp resolution tasks concurrently using `Promise.allSettled` instead of a serial loop. This significantly reduces execution time when multiple items require resolution (e.g., waiting for network or async processing).
Benchmarks showed a reduction from ~1000ms to ~23ms for 50 items with a simulated 20ms delay each.
Co-authored-by: PR0M3TH3AN <[email protected]>
Correctly destructure the `plainCall` variable in `tests/nostr-login-permissions.test.mjs` to prevent a ReferenceError during test execution. This ensures the test properly validates that the plain enable() fallback is not invoked when structured payloads fail.
Co-authored-by: PR0M3TH3AN <[email protected]>
Optimizes the batch deletion process by decoupling the network publishing step from the serial signing loop. This allows publishing to happen concurrently with the signing of subsequent batches, significantly reducing the total time for large deletions.
- Wraps `publishEventToRelays` in a non-blocking promise within the deletion loop.
- Collects all publish promises and awaits them using `Promise.all` at the end of the loop.
- Preserves serial signing order to ensure compatibility with NIP-07 extensions.
- Maintains existing logging and state update logic.
Measured improvement: ~40% reduction in execution time for 500 events (5 chunks) in simulated benchmark.
Co-authored-by: PR0M3TH3AN <[email protected]>
Optimize `executePendingRetry` in `js/channelProfile.js` to run zap attempts in parallel using `Promise.allSettled`, improving performance when retrying multiple shares.
Refactor `splitAndZap` in `js/payments/zapSplit.js` to accept `overrideFee` as an argument, eliminating reliance on a global variable and ensuring thread safety during parallel execution.
Update `js/ui/zapController.js` to use the new `splitAndZap` API.
Co-authored-by: PR0M3TH3AN <[email protected]>
