MiruroAPI/CHANGELOG.md

Changelog

v2.1.3

Pipe Resilience — Retry logic, caching, optimized streaming

Pipe Request Improvements

• Added pipeRequest() helper with retry logic and exponential backoff (3 attempts: 1s, 2s, 4s delays)
• Retries on 444 (Cloudflare rate limit) and connection reset errors
• Skips retry on non-retryable 4xx errors (except 444)
• Increased pipe request timeout from 15s to 20s

Caching

• fetchRawEpisodes now caches episode data for 5 minutes (was uncached)
• getSources now caches streaming sources for 10 minutes (was uncached)
• Subsequent calls for the same episode are instant (no pipe requests)

Streaming Pipeline

• Confirmed kiwi provider CDN (owocdn.top) serves real video content with CORS *
• Confirmed bonk provider CDN (vibeplayer.site) returns streams + subtitles
• bee/ally CDNs serve decoy PNGs to server IPs (confirmed)
• Stream URLs returned as raw CDN URLs (browser loads directly)
• Subtitles proxied through /api/proxy for CORS bypass

Bug Fixes

• Fixed getWatchSources slug matching — handles both raw pipe IDs and slugged IDs
• injectSourceSlugs mutates cached data; getWatchSources now detects and handles both formats
• Uses rawPipeId for decoded ID recovery

Working Endpoints

• /api/watch/{provider}/{anilistId}/{category}/{slug} — kiwi ✅ bonk ✅
• /api/stream?provider=...&anilistId=...&slug=... — bestStream + subtitles
• /api/episodes/{id} — episode list from all providers
• /api/sources — may fail on first attempt due to Cloudflare rate limiting (retries help)

v2.1.2

Streaming Architecture — pru proxy + raw CDN URLs

Streaming Pipeline Discovery

• Decoded pru.ultracloud.cc URL format: base64url(XOR(url, key))~base64url(XOR(referer, key))/pl.m3u8
• Key: a54d389c18527d9fd3e7f0643e27edbe (16-byte XOR)
• pru rewrites ALL M3U8 URLs (master, variant, segments) to proxy through itself
• CDN at mt.nekostream.site serves decoy PNG images to all server-side requests

Proxy Changes

• /api/proxy now handles both pru-encoded URLs (decodes + re-encodes) and direct CDN URLs (for subtitles)
• Stream URLs returned as raw CDN URLs (browser loads directly — CDN has CORS *)
• Subtitle URLs proxied through /api/proxy (third-party CDNs may lack CORS)
• Added Origin: https://www.miruro.tv header to pipe requests

Known Limitations

• Pipe sources endpoint returns 444 from Cloudflare for datacenter IPs
• Client-side pipe blocked by CORS (only allows miruro.tv origin)
• CDN segments serve PNG decoys to server IPs
• Video playback requires further investigation — likely needs miruro.tv domain or alternative streaming source

v2.1.1

Bug Fix — Pipe response XOR decoding

Fix

• decodePipeResponse now XOR-decodes with obfuscation key before gzip decompression — pipe was returning XOR+gzip, not plain gzip
• Updated pipe version from 0.1.0 to 0.2.0 to match miruro.tv
• getWatchSources now properly returns streams (was always failing before this fix)

v2.1.0

Major Feature Update — Provider capabilities, enriched metadata, skip times

New Endpoints

• GET /api/providers — Provider capabilities and configuration (12 providers with full metadata)

Anime Info Enrichment

• Added alternateName — multiple language titles from synonyms
• Added aggregateRating — rating with count, mean score
• Added sameAs — external links (AniList, MAL, official sites)
• Added externalLinks — structured external links with site/type
• Added productionCompany — non-animation studios
• Added animationStudio — animation studios
• Added trailer — anime trailer info
• Added nextAiringEpisode — next episode air time
• Added tags — simplified tag names array

Streaming Improvements

• Added extractSkipTimes — extract OP/ED skip timestamps from sources
• Added skipTimes field to /stream and /watch responses
• Episode thumbnails already included in pipe response

Provider Capabilities (from miruro.tv SSR_CONFIG)

• kiwi: sub, download
• pewe: sub
• bonk: sub, ssub, download, skip_times
• bee: ssub
• ally: sub, download, thumbnails
• moo: sub, download
• hop: ssub, thumbnails
• nun: sub (embed of ally)
• bun: ssub (embed of bee)
• twin: sub, ssub (embed of bonk)
• cog: sub (embed of moo)
• telli: sub (embed of kiwi, hidden)

---

v2.0.1

Streaming Improvements — Better subtitle extraction, quality fallback

Streaming Enhancements

• Improved extractSubtitles — now handles multiple provider formats (bonk: file/label/kind/language, others: url/name/lang)
• Updated getBestStream — falls back to first active HLS stream when quality metadata is missing
• Updated getDownloadUrl — now returns subtitles and bestStream in response
• Added subtitle fields: url, label, language, kind, format, encoding, isDefault

Provider Improvements

• Bonk provider confirmed to return subtitles (English, VTT format, captions kind)
• Better handling of providers without quality metadata (bonk, ally, bee return undefined quality)

Verified

• Subtitle extraction working: bonk provider returns 1 English subtitle per episode
• Download URL working: bonk provider returns direct download link
• Batch sources: subtitles included in batch responses

---

v2.0.0

Major Release — 35 endpoints, streaming improvements, new features

Technical Foundation

• Added gzip compression middleware (30-70% response size reduction)
• Added request logging with method, path, status, duration, IP
• Added Cache-Control headers for API responses (varies by endpoint type)
• Improved CORS with preflight caching (24h max-age)
• Health endpoint now includes memory stats (heap, RSS), cache size, node version

New AniList Helpers (11 new functions)

• getAllGenres — complete genre list from AniList
• getAllTags — complete tag list with metadata
• getTopAnime — top-rated anime of all time (SCORE_DESC)
• getTrendingDaily — trending anime (last 7 days)
• getTrendingWeekly — trending anime (last 30 days)
• getSeasonalAnime — anime by year + season (e.g., 2025/Spring)
• getAnimeByStudio — anime produced by a specific studio
• getCharacterInfo — character detail with anime list
• getStaffInfo — staff detail with anime list
• searchCharacters — search characters by name
• searchStaff — search staff by name

New Streaming & Download Features

• extractSubtitles — extract subtitle URLs from sources
• getBestStream — automatic quality fallback (1080p → 720p → 360p)
• getDownloadUrl — dedicated download URL endpoint
• getBatchSources — fetch multiple episode sources in parallel

New API Endpoints (17 new)

• GET /api/trending/daily — daily trending anime
• GET /api/trending/weekly — weekly trending anime
• GET /api/top — top anime by score
• GET /api/random — random anime of the day
• GET /api/multi-search — combined query + filters
• GET /api/season/:year/:season — seasonal anime
• GET /api/studio/:name — anime by studio
• GET /api/genres — all genres list
• GET /api/tags — all tags list
• GET /api/genre/:name — anime by genre
• GET /api/year/:year — anime by year
• GET /api/status/:status — anime by status
• GET /api/format/:format — anime by format
• GET /api/character/:id — character detail
• GET /api/staff/:id — staff detail
• GET /api/characters — search characters
• GET /api/staff — search staff
• GET /api/episodes/:id/batch — batch episode sources
• GET /api/stream — streaming with quality fallback
• GET /api/download — download URL
• GET /api/compare/:id1/:id2 — compare two anime
• GET /api/stats/genre — genre statistics
• GET /api/calendar — monthly airing calendar
• GET /api/timeline/:id — anime release timeline

Streaming Improvements

• Subtitle URL extraction from pipe responses
• Quality fallback: tries 1080p → 720p → 480p → 360p automatically
• Batch episode fetching (up to 5 parallel requests)
• Dedicated download endpoint with provider metadata
• Cache headers: episodes/sources (2min), info (5min), genres/tags (24h)

Version synced to 2.0.0 across all files

v1.4.0

• Added creator attribution middleware — injects author info into every response
• Fixed Vercel deployment: replaced legacy builds/routes config with modern functions config
• Added api/index.js serverless entry point
• Security headers: removed deprecated X-XSS-Protection, added Strict-Transport-Security (HSTS)
• Rate limiter: uses x-forwarded-for header for correct IP detection on Vercel
• Rate limiter: added periodic IP entry pruning when >200 IPs tracked
• Cache: added periodic expired entry cleanup when cache reaches 80% capacity
• Version synced to 1.4.0

v1.3.0

• Full landing page upgrade to match AniKotoAPI style
• Added canvas particle effects with cyan-colored floating particles
• Added scroll-reveal animations (IntersectionObserver)
• Added animated stat counters that count up on scroll
• Added infinite scrolling marquee with 8 feature badges
• Added live interactive API console with 5 preset endpoint buttons
• Added sidebar endpoint explorer with 16 endpoints and multi-language code tabs
• Added 4 interactive playground cards (Search, Info, Episodes, Trending)
• Added custom scrollbar styling
• Added JetBrains Mono font for code blocks
• Added 4-column grid footer
• Added fixed header with scroll-aware blur/glass effect
• Added ambient orb gradient animations
• Added CTA section with gradient overlay
• Color scheme updated to match MiruroAPI brand (cyan #38bdf8 + indigo #818cf8)
• All branding updated: AniKotoAPI references → MiruroAPI
• OG/Twitter meta tags updated for mirurotvapi.vercel.app
• JSON-LD structured data updated
• Real Miruro SVG favicons used in header and footer

v1.2.0

• Fixed critical response format bug: all endpoints now return {success: true, results: data}
• Root cause: createApiRoutes() had (app, jsonResponse, jsonError) but was called with (jsonResponse, jsonError), shifting all params
• Every jsonResponse() call was actually calling jsonError(), returning {success: false, message: data}
• Health endpoint worked because it used res.json() directly, bypassing the wrapper
• All 18 endpoints verified working

v1.1.0

• Added Swagger UI interactive docs at /docs
• Added OpenAPI 3.0 spec at /openapi.json
• Added mappings field in episodes response
• Added Docker support (Dockerfile + .dockerignore)
• Improved landing page with premium design
• Added "Try it" buttons on all endpoints
• Health endpoint now includes version, providers list, and endpoint count
• Version bump to 1.1.0

v1.0.0

• Initial release
• AniList GraphQL integration for anime metadata
• Miruro pipe integration for streaming sources
• 16 API endpoints: search, suggestions, trending, popular, upcoming, recent, spotlight, schedule, filter, info, characters, relations, recommendations, episodes, sources, watch
• In-memory caching with TTL
• CORS support
• Health endpoint
• Deployed on Vercel