Files

T

FreeTLab aa0b242374 feat(iap): add freemium unlock via one-time in-app purchase

Adds a permanent, non-consumable premium unlock (EstadoEntitlement +
PuertoCompras/ServicioComprasPlayBilling) that removes ads and unlocks
alarm vacations, alarms past a 5-alarm free cap, recording start, and
full Android Auto browsing. The phone equalizer stays free for everyone.

- Entitlement is prefs-backed (compra_premium_v1), fail-open, and
  resolvable headlessly via esPremiumPersistido() for the Android Auto
  audio handler, which registers before runApp.
- Android Auto reduced mode keeps the real root folder labels for free
  users; browsing into any of them (and playFromMediaId/playFromSearch/
  skipToNext/skipToPrevious) is blocked at the getChildren/servicio_audio
  choke points, with a locked "Función Premium" item as the backstop.
  Current-station play/pause/stop stays untouched. A free -> premium
  transition actively invalidates the head unit's cached browse tree.
- Ads (top banner + capped interstitial before adding a station or an
  alarm) are gated behind entitlement via ServicioAnuncios, using
  official Google test ad unit IDs pending AdMob provisioning.
- Alarm cap UX shows an explanatory message with a secondary unlock
  action rather than a bare paywall jump; existing data is grandfathered.
- 4 new localization keys translated across all 13 supported locales.

Co-located tests use strict TDD (RED test before implementation) for
every new pure-logic unit; full existing suite passes unchanged.

2026-08-10 20:37:07 +02:00

6.3 KiB

Raw Blame History

Delta for Android Auto Media

MODIFIED Requirements

Requirement: Browsable Media Tree

For a user holding premium entitlement, getChildren MUST return a browsable tree rooted at AudioService.browsableRootId, organized into non-playable folders (Favoritos, Todas las emisoras, Mis emisoras, Ecualizador, and the local-music root) containing playable items. Playable station items SHOULD carry an audio-quality subtitle when known. The Favoritos folder additionally MAY contain non-playable favorite-group sub-folders (see "Favorite Group Sub-Folders"); Todas las emisoras and Mis emisoras remain flat. The Ecualizador folder is flat, non-playable, and contains only the 6 fixed EQ preset items (see "EQ Preset Browsable Folder"). The local-music root folder is non-playable and may itself be nested (see "Local Music Browsable Tree"). For a free-tier (non-premium) user, this full tree is NOT exposed; see "Free-Tier Reduced Root Browse" for the entitlement-aware equivalent. (Previously: root contained exactly 3 folders — Favoritos, Todas las emisoras, Mis emisoras — with no EQ or local-music folder; Favoritos was a flat folder of playable station items only, with no sub-folder nesting; there was no entitlement distinction.)

Scenario: Car requests the root (premium)

GIVEN the user holds premium entitlement and the car head unit connects and requests the root (AudioService.browsableRootId)
WHEN getChildren is called with the root id
THEN it returns five folder MediaItems (Favoritos, Todas las emisoras, Mis emisoras, Ecualizador, and the local-music root), each with playable: false

Scenario: Car requests a folder with no stations (premium)

GIVEN the user holds premium entitlement and has zero favorite stations
WHEN getChildren is called with the Favoritos folder id
THEN it returns an empty list, not an error

Scenario: Browse requested before app state is loaded (premium)

GIVEN the user holds premium entitlement and the audio handler starts cold and station/favorites Provider state has not finished loading
WHEN getChildren is called (root or any folder)
THEN it returns a valid, possibly empty, list without throwing and without blocking or crashing the service

Scenario: Station has known codec and bitrate

GIVEN a station's Emisora.codec and Emisora.bitrate are both known (non-null)
WHEN it is mapped to a playable MediaItem
THEN displaySubtitle SHALL contain a human-readable quality hint combining bitrate and codec (e.g. "128 kbps · MP3")

Scenario: Station has unknown codec or bitrate

GIVEN a station's Emisora.codec or Emisora.bitrate (or both) is null/unknown
WHEN it is mapped to a playable MediaItem
THEN displaySubtitle SHALL omit the quality hint gracefully (no subtitle, or a subtitle with no quality fragment)
AND the subtitle MUST NOT render literal placeholder text such as "null kbps" or "null · null"

Scenario: Ungrouped station appears exactly as before (regression guard)

GIVEN a station's Emisora.grupoFavoritosId equals GrupoFavoritos.sinAsignarId ('sin_asignar', the default when no group is assigned), and the browsing user holds premium entitlement
WHEN the Favoritos, Todas las emisoras, or Mis emisoras folders are browsed
THEN that station appears as a playable emisora:<uuid> item in exactly the same folder(s), position (subject to existing sort rules), title, art, and subtitle as it did before favorite-group folders were introduced
AND its presence and shape are unaffected by the existence, emptiness, or content of any favorite group

ADDED Requirements

Requirement: Free-Tier Reduced Root Browse

For a free-tier (non-premium) user, getChildren at the root MUST NOT return the full folder tree. Instead it MUST return a non-blank list whose items each represent one of the normally-browsable folders (Favoritos, Todas las emisoras, Mis emisoras, Ecualizador, local-music root) rendered as a non-playable, explicitly locked item labeled as a premium feature (e.g. title "Función Premium"). A blank or empty root/folder response for a free-tier user is forbidden.

Scenario: Free-tier user requests the root

GIVEN a free-tier (non-premium) user's car head unit requests the root
WHEN getChildren is called with the root id
THEN it returns non-playable locked items labeled as premium features, one per normally-browsable folder, and never an empty list

Scenario: Free-tier user selects a locked item

GIVEN a free-tier user is shown a locked "Función Premium" item
WHEN they select it
THEN no real folder content or station list is returned, and no crash or unhandled exception occurs

Requirement: Free-Tier Browse Never Leaks Real Content (Authoritative Backstop)

Even if getChildren receives a stale or deep-linked folder id that would resolve to real station or local-music content, for a free-tier (non-premium) user it MUST NOT return that real content. This check MUST be enforced at the getChildren/navegacion_auto.dart choke point itself, independent of which UI path reached it.

Scenario: Stale folder id bypass attempt

GIVEN a free-tier user's car client holds a cached emisora:<uuid> or folder id from before downgrade or from another device
WHEN getChildren/playFromMediaId is called with that id
THEN the authoritative entitlement check at the choke point blocks real content or playback from being returned, regardless of the id's validity

Requirement: Current-Station Playback Unaffected By Free Tier

Regardless of entitlement, transport controls (play/pause/stop) for whatever station is already loaded or playing MUST keep working for a free-tier user in the car. Only browsing/switching to a different station and local music are restricted by the free tier.

Scenario: Free-tier user controls the current station

GIVEN a free-tier user already has a station loaded or playing when connecting to the car
WHEN they use play/pause/stop from the car head unit
THEN the command is honored exactly as for a premium user

Scenario: Free-tier user cannot switch stations via browse

GIVEN a free-tier user is currently playing a station
WHEN they attempt to browse to a different station via the root tree
THEN they see only the locked "Función Premium" items, not a station list, and cannot switch stations that way

6.3 KiB Raw Blame History