Merge pull request #2 from SurjitSahoo/enhancements

feat: Introduce book detail screen, global player, smart rewind settings, and enhance content caching and player UI.

Author: SurjitSahoo

.agent/rules/project-context.md

@@ -0,0 +1,42 @@
+---
+trigger: always_on
+---
+
+# Project Context and Guidelines
+
+## About Project
+
+This is an offline-first Android client app for the [audiobookshelf](https://github.com/advplyr/audiobookshelf) server.
+
+## Feature Requirements (Offline first behavior)
+
+- As the app is an offline-first app, assume that the server is not always reachable.
+- Playback progress should be saved in the local database first **immediately**.
+- The app should watch the network changes, such as connecting to a new wifi network, or Ethernet LAN, or disconnecting from a network and connecting to a new network, disconnecting from wifi and connecting to celular network, etc., and try to ping or reach out to the audiobook server to check whether the server is reachable.
+- If the server is reachable, the app should sync the local progress to the server and pull the latest progress updates from the server to the local database; it should merge the updates from both.
+- If the server is reachable, and some chapters of any audiobook are downloaded, i.e., available offline, then the offline track should be given priority for playback.
+- If the offline track is deleted/cleared while the book is being played, the player should attempt to fallback to the online URL if the server is reachable, otherwise pause playback and persist the last playback state (track ID, playback position/timestamp, current chapter/index, and playback status) plus a flag indicating offline content was removed; ensure the rule notes that these persisted fields are used to resume or report playback state and are written atomically to the player state store.
+- The app must be fully functional for downloaded content when offline.
+
+## Ensure Stability
+
+- Ensure null-safety when converting data (e.g., check for division by zero in percentage calculations).
+- Changes must be verified by building the app and ensuring logic holds (e.g., uninstall/reinstall for clean state tests).
+
+## Overall Functionality
+
+- When the app loads, it should load the offline available book content immediately, then in the background reach out to the server (if the server is reachable) and fetch the full list of the books, continue listening section books and update the UI seemlessly.
+- The app should cache all the book's metadata in local database to optimise the app load time, Only the chapters / audio tracks should not be cached automatically / by default. Chapters should be downloaded and cached on demand by the user, using the download chapters/book functionality.
+- When the app loads, if the server is not reachable, it shouldn't show long loading screen, trying to fetch the books from the server, it should load the book's list from the local database, however it should only show the books whos' chapters are downloaded and available offline can be played.
+- When the server becomes reachable, it should update the books list, as now all the books can be played from local cache or online from the server.
+- When the network is switched, the app should trigger checking whether the server is still reachable or not, if not reachable, it should update the UI to only show offline available ready to play books.
+
+## General Guidelines and Standards
+
+- **Colors**: Must be referenced from `Color.kt` / `Theme.kt`. Do not use raw hex values (e.g., `0xFF...`) in Composables.
+- **Dimensions**: Must use `Spacing.kt` (e.g., `Spacing.md`, `Spacing.lg`) for padding, margins, and layout dimensions.
+- **Design System**: Adhere effectively to the spacing system and color palette defined in the project.
+- **ABSOLUTELY NO** hardcoded user-facing strings in UI code. All strings must be extracted to `strings.xml` and accessed via `stringResource`.
+- Use `associateBy` or proper indexing for collection lookups (O(1)) instead of nested loops (O(N^2)) when synchronizing data.
+- Avoid expensive operations on the main thread.
+- No code duplication, keep the code clean and easy to maintain.

.github/workflows/auto-version-bump.yml

@@ -0,0 +1,54 @@
+name: Auto Version Bump
+
+on:
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - 'gradle.properties'
+      - '.github/workflows/**'
+
+jobs:
+  bump-version:
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get Current Version
+        id: get_version
+        run: |
+          VERSION=$(grep 'appVersionName=' gradle.properties | cut -d'=' -f2)
+          echo "current_version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Determine Bump Type
+        id: bump_type
+        uses: anothrNick/github-tag-action@1.67.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          WITH_V: false
+          DRY_RUN: true
+          DEFAULT_BUMP: patch
+
+      - name: Bump Version in Files
+        id: bump
+        run: |
+          BUMP_TYPE="${{ steps.bump_type.outputs.part }}"
+          if [ -z "$BUMP_TYPE" ]; then BUMP_TYPE="patch"; fi
+          NEW_VERSION=$(python3 scripts/bump_version.py ${{ steps.get_version.outputs.current_version }} $BUMP_TYPE)
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+
+      - name: Commit and Push Changes
+        run: |
+          NEW_TAG="v${{ steps.bump.outputs.new_version }}"
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add gradle.properties
+          git commit -m "chore: bump version to ${{ steps.bump.outputs.new_version }} [skip ci]"
+          git tag $NEW_TAG
+          git push origin main
+          git push origin $NEW_TAG

.github/workflows/build_app.yml

@@ -1,20 +1,19 @@
-name: Build Lissen App
+name: Build Kahani App
 
 env:
   # The name of the main module repository
   main_project_module: app
 
 on:
   push:
-    branches: [ "main" ]
+    branches: ['main']
   pull_request:
-    branches: [ "main" ]
+    branches: ['main']
 
   workflow_dispatch:
 
 jobs:
   build:
-
     runs-on: ubuntu-latest
 
     steps:
@@ -37,6 +36,9 @@ jobs:
       - name: Change wrapper permissions
         run: chmod +x ./gradlew
 
+      - name: Create Schemas Directory
+        run: mkdir -p app/schemas
+
       # Run Build Project
       - name: Build gradle project
-        run: ./gradlew build -Proom.schemaLocation=$GITHUB_WORKSPACE/app/schemas
+        run: ./gradlew build

.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Build and Release Kahani
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  release:
+    name: Build Signed APK
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: '21'
+          cache: 'gradle'
+
+      - name: Create Schemas Directory
+        run: mkdir -p app/schemas
+
+      - name: Decode Keystore
+        run: |
+          echo "${{ secrets.RELEASE_KEYSTORE_BASE64 }}" | base64 --decode > app/kahani-release.jks
+
+      - name: Build Release APK
+        run: ./gradlew assembleRelease
+        env:
+          RELEASE_STORE_FILE: kahani-release.jks
+          RELEASE_STORE_PASSWORD: ${{ secrets.RELEASE_PASSWORD }}
+          RELEASE_KEY_ALIAS: ${{ secrets.RELEASE_KEY_ALIAS }}
+          RELEASE_KEY_PASSWORD: ${{ secrets.RELEASE_KEY_PASSWORD }}
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: app/build/outputs/apk/release/app-release.apk
+          tag_name: ${{ github.ref_name }}
+          name: Release ${{ github.ref_name }}
+          body: |
+            Automated Release for Kahani.
+            Commit: ${{ github.sha }}
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -34,4 +34,4 @@ google-services.json
 *.hprof
 
 # Schemas
-app/schemas
+.DS_Store

.vscode/tasks.json

@@ -0,0 +1,21 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "type": "gradle",
+      "id": "${workspaceFolder}app:installDebugapp",
+      "script": "app:installDebug",
+      "description": "Installs the Debug build.",
+      "group": "install",
+      "project": "app",
+      "buildFile": "${workspaceFolder}/app/build.gradle.kts",
+      "rootProject": "Lissen",
+      "projectFolder": "${workspaceFolder}",
+      "workspaceFolder": "${workspaceFolder}",
+      "args": "",
+      "javaDebug": false,
+      "problemMatcher": ["$gradle"],
+      "label": "gradle: app:installDebug"
+    }
+  ]
+}

app/build.gradle.kts

@@ -50,11 +50,11 @@ android {
   defaultConfig {
     val commitHash = gitCommitHash()
 
-    applicationId = "org.grakovne.lissen"
+    applicationId = "org.surjit.kahani"
     minSdk = 28
     targetSdk = 36
-    versionCode = 10800
-    versionName = "1.8.0-$commitHash"
+    versionCode = project.property("appVersionCode").toString().toInt()
+    versionName = project.property("appVersionName").toString()
 
     buildConfigField("String", "GIT_HASH", "\"$commitHash\"")
 
@@ -66,27 +66,36 @@ android {
     buildConfigField("String", "ACRA_REPORT_LOGIN", "\"$acraReportLogin\"")
     buildConfigField("String", "ACRA_REPORT_PASSWORD", "\"$acraReportPassword\"")
 
-    if (project.hasProperty("RELEASE_STORE_FILE")) {
-      signingConfigs {
-        create("release") {
-          storeFile = file(project.property("RELEASE_STORE_FILE")!!)
-          storePassword = project.property("RELEASE_STORE_PASSWORD") as String?
-          keyAlias = project.property("RELEASE_KEY_ALIAS") as String?
-          keyPassword = project.property("RELEASE_KEY_PASSWORD") as String?
-          enableV1Signing = true
-          enableV2Signing = true
+    signingConfigs {
+      create("release") {
+        val envKeyStore = System.getenv("RELEASE_STORE_FILE")
+        val propKeyStore = localProperties.getProperty("RELEASE_STORE_FILE")
+
+        storeFile = when {
+          envKeyStore != null -> file(envKeyStore)
+          propKeyStore != null -> file(propKeyStore)
+          else -> null
         }
+
+        storePassword = System.getenv("RELEASE_STORE_PASSWORD") ?: localProperties.getProperty("RELEASE_STORE_PASSWORD")
+        keyAlias = System.getenv("RELEASE_KEY_ALIAS") ?: localProperties.getProperty("RELEASE_KEY_ALIAS")
+        keyPassword = System.getenv("RELEASE_KEY_PASSWORD") ?: localProperties.getProperty("RELEASE_KEY_PASSWORD")
+
+        enableV1Signing = true
+        enableV2Signing = true
       }
     }
   }
 
-  
   buildTypes {
     release {
-      if (project.hasProperty("RELEASE_STORE_FILE")) {
-        signingConfig = signingConfigs.getByName("release")
+      val releaseSigningConfig = signingConfigs.getByName("release")
+
+      if (releaseSigningConfig.storeFile?.exists() == true) {
+        signingConfig = releaseSigningConfig
       }
-      isMinifyEnabled = false
+
+      isMinifyEnabled = true
       isShrinkResources = false
       proguardFiles(
         getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro"