Changes

Add downloader to lib-cache: work in progress. Move opds model into its own module so it can be used by lib cache.

Work in progress: add structure for pinning and downloading a publication.

Rename fields on DownloadJob and DownloadJobItem.

Download publication work in progress - add pinned publication entity

Port/adaptation of download implementation from Ustad Mobile to enable pinning web publications to be available offline.

Initial integration test for downloader.

Initial integration test for downloader: passes to download/pin an entire publication.

Work in progress adding pin publication job

respect-e2e test scenarios

modified test scripts

corrected links

clean up

Renamed REALM to SCHOOL

fix

feat: Implement Settings and School Directory screens

This commit introduces the initial framework for the Settings and School Directory features.

Key changes:

**Navigation & ViewModels:**
- Added new navigation routes: `SettingScreen`, `SchoolDirectoryList`, and `SchoolDirectoryEdit` in `AppRoutes.kt`.
- Created corresponding ViewModels: `SettingViewModel`, `SchoolDirectoryListViewModel`, and `SchoolDirectoryEditViewModel`.
    - `SettingViewModel`:
        - Sets the app bar title to "Settings".
        - Hides the bottom navigation.
        - Provides `onClickSchoolDirectory` to navigate to `SchoolDirectoryList`.
    - `SchoolDirectoryListViewModel`:
        - Sets the app bar title to "School Directory".
        - Hides the bottom navigation.
        - Configures a FAB (Floating Action Button) to add a new directory, navigating to `SchoolDirectoryEdit`.
    - `SchoolDirectoryEditViewModel`:
        - Sets the app bar title to "Add Directory" (or "Edit Directory" - to be implemented).
        - Hides the bottom navigation.
- Registered these new ViewModels in `AppKoinModule.kt`.
- Integrated these new routes and ViewModels into `AppNavHost.kt`.

**UI Screens (Composable):**
- Created `SettingScreen.kt`:
    - Displays a list of settings options (currently only "School Directory").
    - Uses a `LazyColumn` and `SettingListItem` composable.
    - `SettingListItem` displays an icon and title for each option and handles clicks.
- Created `SchoolDirectoryListScreen.kt`:
    - Provides a basic `LazyColumn` structure for displaying school directory items (implementation pending).
- Created `SchoolDirectoryEditScreen.kt`:
    - Provides a placeholder structure for adding/editing school directory entries (implementation pending).

**Account List Integration:**
- Added a "Settings" option to `AccountListScreen.kt`.
    - This option uses `Icons.Default.Settings` and navigates to `SettingScreen` when clicked.
- Added `onClickSettings()` function to `AccountListViewModel.kt` to handle this navigation.

**String Resources:**
- Added new string resources in `strings.xml`:
    - `settings`: "Settings"
    - `school_directory`: "School Directory"
    - `add_directory`: "Add Directory"
    - `edit_directory`: "Edit Directory"

feat: Implement Settings and School Directory screens

This commit introduces the initial framework for the Settings and School Directory features.

Key changes:

**Navigation & ViewModels:**
- Added new navigation routes: `SettingScreen`, `SchoolDirectoryList`, and `SchoolDirectoryEdit` in `AppRoutes.kt`.
- Created corresponding ViewModels: `SettingViewModel`, `SchoolDirectoryListViewModel`, and `SchoolDirectoryEditViewModel`.
    - `SettingViewModel`:
        - Sets the app bar title to "Settings".
        - Hides the bottom navigation.
        - Provides `onClickSchoolDirectory` to navigate to `SchoolDirectoryList`.
    - `SchoolDirectoryListViewModel`:
        - Sets the app bar title to "School Directory".
        - Hides the bottom navigation.
        - Configures a FAB (Floating Action Button) to add a new directory, navigating to `SchoolDirectoryEdit`.
    - `SchoolDirectoryEditViewModel`:
        - Sets the app bar title to "Add Directory" (or "Edit Directory" - to be implemented).
        - Hides the bottom navigation.
- Registered these new ViewModels in `AppKoinModule.kt`.
- Integrated these new routes and ViewModels into `AppNavHost.kt`.

**UI Screens (Composable):**
- Created `SettingScreen.kt`:
    - Displays a list of settings options (currently only "School Directory").
    - Uses a `LazyColumn` and `SettingListItem` composable.
    - `SettingListItem` displays an icon and title for each option and handles clicks.
- Created `SchoolDirectoryListScreen.kt`:
    - Provides a basic `LazyColumn` structure for displaying school directory items (implementation pending).
- Created `SchoolDirectoryEditScreen.kt`:
    - Provides a placeholder structure for adding/editing school directory entries (implementation pending).

**Account List Integration:**
- Added a "Settings" option to `AccountListScreen.kt`.
    - This option uses `Icons.Default.Settings` and navigates to `SettingScreen` when clicked.
- Added `onClickSettings()` function to `AccountListViewModel.kt` to handle this navigation.

**String Resources:**
- Added new string resources in `strings.xml`:
    - `settings`: "Settings"
    - `school_directory`: "School Directory"
    - `add_directory`: "Add Directory"
    - `edit_directory`: "Edit Directory"

Feat: Implement delete directory functionality

This commit introduces the ability to delete school directories.

Key changes:
- Added `deleteDirectory` function to `SchoolDirectoryDataSource` interface and its implementations (`SchoolDirectoryDataSourceDb`, `SchoolDirectoryDataSourceHttp`, `SchoolDirectoryDataSourceRepository`).
- In `SchoolDirectoryDataSourceDb`, `deleteDirectory` calls `deleteByUrl` on `SchoolDirectoryEntityDao`.
- Added `deleteByUrl` query to `SchoolDirectoryEntityDao` to delete a directory by its URL.
- `SchoolDirectoryListViewModel` now:
    - Injects `RespectAppDataSource`.
    - Loads school directories on initialization.
    - Provides an `onDeleteDirectory` function which calls `deleteDirectory` on the data source and reloads the list.
    - Updates `SchoolDirectoryListUIState` to hold a list of `RespectSchoolDirectory` objects instead of `String`.
- `SchoolDirectoryListScreen` now:
    - Displays a list of `SchoolDirectoryListItem` composables.
    - Passes the `onDeleteDirectory` function from the ViewModel to each item.
- Introduced `SchoolDirectoryListItem` composable:
    - Displays the directory's base URL.
    - Includes a delete icon button that triggers the `onDeleteClick` callback.
- Added a new string resource `delete_directory`.

Feat: Initial setup for SchoolDirectoryEdit screen

This commit introduces the basic structure for the school directory editing feature.

Key changes:
- Added `SchoolDirectoryEditViewModel` with an initial `SchoolDirectoryEditUIState`.
    - `SchoolDirectoryEditUIState` now includes `schoolDirectoryUrlError` and `schoolDirectory` (a `DataLoadState` for `SchoolDirectoryEntry`).
    - Added a `fieldsEnabled` computed property to `SchoolDirectoryEditUIState` based on the `schoolDirectory` loading state.
    - `SchoolDirectoryEditViewModel` now implements `KoinScopeComponent` and injects `RespectAppDataSource`.
    - The ViewModel initializes the app UI state to set the top app bar title to "Add Directory" and hide the bottom navigation.
    - Added an `onClearError` function to clear `schoolDirectoryUrlError` in the UI state.
- Created `SchoolDirectoryEditScreen.kt` with an initial layout.
    - The screen displays an `OutlinedTextField` for entering a link.
    - The text field's label is "Enter link" and has supporting text "Required".
    - The text field's enabled state is controlled by `uiState.fieldsEnabled`.
    - The text field's error state is controlled by `uiState.schoolDirectoryUrlError`.
    - Added `onClearError` callback to the screen.

Refactor: Move deleteDirectory functionality to SchoolDirectoryEntryDataSource

This commit refactors the `deleteDirectory` functionality from `SchoolDirectoryDataSource` to `SchoolDirectoryEntryDataSource`.

Key changes:
- Removed `deleteDirectory` from `SchoolDirectoryDataSource` interface and its implementations (`SchoolDirectoryDataSourceHttp`, `SchoolDirectoryDataSourceRepository`, `SchoolDirectoryDataSourceDb`).
- Removed `deleteByUrl` from `SchoolDirectoryEntityDao`.
- Added `deleteDirectory` to `SchoolDirectoryEntryDataSource` interface and its implementations (`SchoolDirectoryEntryDataSourceHttp`, `SchoolDirectoryEntryDataSourceRepository`, `SchoolDirectoryEntryDataSourceDb`).
- Added `deleteByUrl` to `SchoolDirectoryEntryEntityDao`.
- Added `listAsPagingSource` (with a TODO) to `SchoolDirectoryEntryDataSource` and its implementations.
- `SchoolDirectoryListViewModel` now uses `SchoolDirectoryEntryDataSource` to load and delete directories.
- `SchoolDirectoryListUIState` now holds a list of `SchoolDirectoryEntry` instead of `RespectSchoolDirectory`.
- `SchoolDirectoryListScreen` and `SchoolDirectoryListItem` updated to use `SchoolDirectoryEntry`.

Refactor: Move deleteDirectory functionality to SchoolDirectoryEntryDataSource

This commit refactors the `deleteDirectory` functionality from `SchoolDirectoryDataSource` to `SchoolDirectoryEntryDataSource`.

Key changes:
- Removed `deleteDirectory` from `SchoolDirectoryDataSource` interface and its implementations (`SchoolDirectoryDataSourceHttp`, `SchoolDirectoryDataSourceRepository`, `SchoolDirectoryDataSourceDb`).
- Removed `deleteByUrl` from `SchoolDirectoryEntityDao`.
- Added `deleteDirectory` to `SchoolDirectoryEntryDataSource` interface and its implementations (`SchoolDirectoryEntryDataSourceHttp`, `SchoolDirectoryEntryDataSourceRepository`, `SchoolDirectoryEntryDataSourceDb`).
- Added `deleteByUrl` to `SchoolDirectoryEntryEntityDao`.
- Added `listAsPagingSource` (with a TODO) to `SchoolDirectoryEntryDataSource` and its implementations.
- `SchoolDirectoryListViewModel` now uses `SchoolDirectoryEntryDataSource` to load and delete directories.
- `SchoolDirectoryListUIState` now holds a list of `SchoolDirectoryEntry` instead of `RespectSchoolDirectory`.
- `SchoolDirectoryListScreen` and `SchoolDirectoryListItem` updated to use `SchoolDirectoryEntry`.

Refactor: Improve School Directory Edit screen UI and ViewModel

This commit refactors the School Directory Edit screen and its ViewModel for an improved user experience.

Key changes:
- In `SchoolDirectoryEditViewModel`:
    - Renamed `schoolDirectoryUrlError` in `SchoolDirectoryEditUIState` to `errorMessage` and changed its type to `UiText?`.
    - Added `linkUrl` to `SchoolDirectoryEditUIState` to hold the input link.
    - Added `onLinkChanged` function to update `linkUrl` and clear any existing error message.
    - Added `onClickNext` function to handle the "Next" button click, which currently parses the entered link.
    - Removed `onClearError` function as error handling is now managed within `onLinkChanged`.
- In `SchoolDirectoryEditScreen.kt`:
    - Updated the `SchoolDirectoryEditScreen` composable to take `onLinkChanged` and `onClickNext` as parameters.
    - Added a `Text` composable to display an introductory message (`app_link_provided_message`).
    - The `OutlinedTextField` now uses `uiState.linkUrl` for its value and calls `onLinkChanged` on value change.
    - The `OutlinedTextField` now displays a placeholder (`example_url_placeholder`) and uses `link_label` for its label.
    - Error messages are now displayed using `uiState.errorMessage` and `uiTextStringResource`.
    - Added a "Next" `Button` that calls `onClickNext` when clicked.
    - General layout adjustments with `Spacer` and `padding`.
- Removed an unused newline in `EnterLinkViewModel.kt`.
- Minor formatting change in `SchoolDirectoryEntryDataSourceHttp.kt`.

Refactor: Remove app link message from SchoolDirectoryEditScreen

This commit removes the `Text` composable that displayed the "app_link_provided_message" string resource from the `SchoolDirectoryEditScreen`.

Key changes:
- Deleted the `Text` composable responsible for showing the app link message.

Refactor: Remove unused import in SchoolDirectoryEditScreen

This commit removes an unused import for `app_link_provided_message` from `SchoolDirectoryEditScreen.kt`.

Refactor: Implement School Directory Entry Insertion and Improve UI

This commit introduces functionality to insert school directory entries and enhances the user interface for managing accounts and editing school directories.

Key changes:
- Added `insertDirectoryEntry` function to `SchoolDirectoryEntryDataSource`, `SchoolDirectoryEntryDataSourceDb`, `SchoolDirectoryEntryDataSourceHttp`, and `SchoolDirectoryEntryDataSourceRepository` to support adding new directory entries.
- In `SchoolDirectoryEntryDataSourceDb`:
    - `insertDirectoryEntry` now uses a database transaction to insert a new school directory entry.
    - `deleteByUrl` in `SchoolDirectoryEntryEntityDao` and its usage in `SchoolDirectoryEntryDataSourceDb` now correctly accepts a `Url` object instead of a `String`.
- In `SchoolDirectoryEditViewModel`:
    - `onClickNext` now constructs a `SchoolDirectoryEntry` from the provided link.
    - It inserts the new entry using `respectAppDataSource.schoolDirectoryEntryDataSource.insertDirectoryEntry`.
    - Navigates to `SchoolDirectoryList` upon successful insertion.
    - Implemented error handling for invalid URLs, updating the UI with an error message.
- In `SchoolDirectoryListViewModel`:
    - Removed the call to `loadSchoolDirectories()` after deleting a directory, as the list is likely observed and will update automatically.
- In `AccountListViewModel`:
    - Added a `loading` state to `AccountListUiState` to indicate when account data is being fetched.
    - The `loading` state is set to `true` before starting to collect `selectedAccountAndPersonFlow` and set to `false` once the data is received.

feat: Add email field to Person entity and related screens

This commit introduces an email field to the `Person` entity and integrates it across various parts of the application.

Key changes:
- Added `email` (nullable String) property to the `Person` data model in `respect-datalayer`.
- Updated `PersonEntity` in `respect-datalayer-db` to include `pEmail` (nullable String).
- Modified `PersonAdapter` in `respect-datalayer-db` to map the `email` field during entity creation.
- Added `email` (nullable String) property to `PersonListDetails` composite model in `respect-datalayer`.
- Updated the `asListDetails()` extension function in `respect-datalayer` to include the new `email` field.
- Added a new string resource `email` ("Email") in `respect-lib-shared`.
- Integrated an `OutlinedTextField` for `email` in `PersonEditScreen` within `respect-app-compose`, allowing users to view and edit the person's email.

Feat: Add phone number field to Person entity and edit screen

This commit introduces a phone number field to the `Person` entity and integrates it into the person editing and detail screens. It also adds utility classes for phone number formatting and validation.

Key changes:
- Added `phoneNumber` field to `Person` data class and `PersonEntity` database entity.
- Updated `PersonListDetails` to include `phoneNumber`.
- Added `phone_number` string resource.
- Introduced `UstadPhoneNumberTextField` composable for phone number input with country code selection and formatting.
- Integrated `UstadPhoneNumberTextField` into `PersonEditScreen`.
- Displayed phone number in `PersonDetailScreen`.
- Added `nationalPhoneNumSet` to `PersonEditUiState` and `onNationalPhoneNumSetChanged` to `PersonEditViewModel` to track if a national number has been entered.
- Created utility classes for phone number handling:
    - `PhoneNumberTransformation`: Visual transformation for formatting phone numbers as they are typed.
    - `CountryCodeTransformation`: Visual transformation to prefix country codes with "+".
    - `GuessCountryCode`: Composable function to guess the initial phone country code (platform-specific implementation needed).
    - `PhoneUtils`: Utility functions for phone number character validation (platform-specific implementation needed).
    - Interfaces for phone number utilities (`IPhoneNumber`, `IPhoneNumberUtil`, `IAsYouTypeFormatter`, `PhoneNumValidatorUseCase`, `OnClickPhoneNumUseCase`).
- Updated database schema for `PersonEntity` to include `pPhoneNumber`.

Feat: Implement Android phone number utilities

This commit introduces utility functions for handling phone numbers on Android.

Key changes:
- Added `PhoneUtils.android.kt` with constants for phone number characters (`PAUSE`, `WAIT`, `WILD`).
- Implemented `isNonSeparator` function to check if a character is a non-separable phone number character.
- Implemented `isReallyDialable` function to check if a character is a dialable phone number character.

Refactor: Integrate phone number formatting and validation

This commit introduces phone number formatting and validation capabilities using `libphonenumber`.

Key changes:
- Added `libphonenumber` dependency.
- Implemented `guessInitialPhoneCountryCode` for Android and desktop to determine the initial country code based on device settings (network/SIM for Android, default locale for desktop).
- Created Android-specific implementations for phone number utilities:
    - `IPhoneNumberUtilAndroid`: Wraps `com.google.i18n.phonenumbers.PhoneNumberUtil`.
    - `PhoneNumberAndroid`: Wraps `com.google.i18n.phonenumbers.Phonenumber.PhoneNumber`.
    - `IAsYouTypeFormatterAdapterAndroid`: Adapts `com.google.i18n.phonenumbers.AsYouTypeFormatter`.
    - `OnClickPhoneNumberUseCaseAndroid`: Handles clicks on phone numbers by initiating a dial intent.
    - `PhoneNumValidatorAndroid`: Validates phone numbers using `IPhoneNumberUtil`.
- Registered `PhoneNumberUtil` and `IPhoneNumberUtilAndroid` in the Android Koin module.
- Updated `PersonDetailScreen` to conditionally display phone number and email fields only if they are present.

Refactor: Rename UstadPhoneNumberTextField to RespectPhoneNumberTextField

This commit renames the composable function `UstadPhoneNumberTextField` to `RespectPhoneNumberTextField`.

Key changes:
- Renamed `UstadPhoneNumberTextField.kt` to `RespectPhoneNumberTextField.kt`.
- Updated the function name from `UstadPhoneNumberTextField` to `RespectPhoneNumberTextField`.
- Removed an unused `isPreview` variable that was checking `LocalInspectionMode.current`.
- Updated call sites in `PersonEditScreen.kt` to use the new composable name.

Refactor: Organize utility files and remove unused code

This commit reorganizes utility files by moving phone number related utilities to a dedicated `phonenum` subpackage and renames the `ext` package to `extt`. Additionally, it removes the unused `ModifierExt.kt` file and cleans up unused imports in `RespectPersonAvatar.kt` and `RespectPhoneNumberTextField.kt`.

Key changes:
- Moved `GuessCountryCode.kt`, `PhoneUtils.kt`, `PhoneNumberVisualTransformation.kt`, and `CountryCodeTransformation.kt` from `world.respect.app.util.ext.phonenum` to `world.respect.app.util.phonenum`.
- Renamed package `world.respect.app.util.ext` to `world.respect.app.util.extt`.
  - Updated package declaration in `IntExt.kt`.
  - Updated import path for `rgbaColor` in `RespectPersonAvatar.kt`.
- Deleted `respect-app-compose/src/commonMain/kotlin/world/respect/app/util/ext/ModifierExt.kt` as it was empty.
- Removed unused imports in `RespectPersonAvatar.kt`:
    - `androidx.compose.foundation.layout.size`
    - `androidx.compose.ui.unit.dp`
- Removed unused import in `RespectPhoneNumberTextField.kt`:
    - `androidx.compose.ui.platform.LocalInspectionMode`

Refactor: Remove trailing newlines and whitespace

This commit removes unnecessary trailing newlines and whitespace from various files.

Key changes:
- Removed trailing newlines from `PersonListDetails.kt` and `strings.xml`.
- Trimmed whitespace and newlines in `PersonEditScreen.kt`.
- Adjusted newlines in `PersonAdapters.kt`.
- Removed extra newlines in `GuessCountryCode.desktop.kt`, `AppKoinModule.kt`, `IntExt.kt`, `GuessCountryCode.android.kt`, `RespectPhoneNumberTextField.kt`, `PhoneUtils.android.kt`, `IPhoneNumber.kt`, `PhoneNumberAndroid.kt`, `PhoneNumValidatorAndroid.kt`, and `IAsYouTypeFormatterAdapterAndroid.kt`.
- Added a `testTag` to the phone number field in `PersonEditScreen.kt`.

Refactor: Simplify School Directory Data Model and Operations

This commit refactors the school directory data handling by replacing `SchoolDirectoryEntry` with `RespectSchoolDirectory` across various layers of the application. This change simplifies the data model and streamlines related operations.

Key changes:
- Replaced `SchoolDirectoryEntry` with `RespectSchoolDirectory` in:
    - `SchoolDirectoryListViewModel` for UI state and delete operations.
    - `SchoolDirectoryEditViewModel` for UI state and adding new directories.
    - `SchoolDirectoryDataSource` interface for `deleteDirectory` and `insertDirectoryEntry` methods.
    - `SchoolDirectoryDataSourceRepository` for local data operations.
    - `SchoolDirectoryDataSourceDb` for database interactions, including moving `deleteDirectory` and `insertDirectoryEntry` from `SchoolDirectoryEntryDataSourceDb`.
    - `SchoolDirectoryListScreen` composable and its item composable.
- Introduced `SchoolDirectoryAdapter.kt` with `toEntities` and `toModel` extension functions for converting between `RespectSchoolDirectory` and `SchoolDirectoryEntity`.
- Updated `SchoolDirectoryEntityDao`:
    - Added `deleteByUrl(url: Url)` to delete a directory by its URL.
    - Added `upsert(entity: SchoolDirectoryEntity)` to insert or replace a directory entity.
- Removed `deleteDirectory` and `insertDirectoryEntry` methods from `SchoolDirectoryEntryDataSource` and its implementations (`SchoolDirectoryEntryDataSourceDb`, `SchoolDirectoryEntryDataSourceHttp`, `SchoolDirectoryEntryDataSourceRepository`).
- Removed `deleteByUrl` from `SchoolDirectoryEntryEntityDao` as it's now handled by `SchoolDirectoryEntityDao`.
- Adjusted `SchoolDirectoryDataSourceHttp` to reflect changes in the `SchoolDirectoryDataSource` interface, though implementations for delete/insert are marked as `TODO`.

Refactor: Rename `insertDirectoryEntry` to `insertDirectory` and implement HTTP POST

This commit refactors the `SchoolDirectoryDataSource` interface and its implementations to rename the `insertDirectoryEntry` function to `insertDirectory`. It also implements the `insertDirectory` function in `SchoolDirectoryDataSourceHttp` to perform an HTTP POST request.

Key changes:
- Renamed `insertDirectoryEntry` to `insertDirectory` in:
    - `SchoolDirectoryDataSource.kt`
    - `SchoolDirectoryDataSourceDb.kt`
    - `SchoolDirectoryDataSourceRepository.kt`
    - `SchoolDirectoryEditViewModel.kt` (updated the call site)
- Implemented `insertDirectory` in `SchoolDirectoryDataSourceHttp.kt`:
    - It now makes an HTTP POST request to the endpoint `api/directory/add` on the directory's base URL.
    - Sets the `Content-Type` to `application/json`.
    - Sends the `RespectSchoolDirectory` object as the request body.

Remove extraneous new line

This commit removes an unnecessary new line from the `insertDirectory` function in `SchoolDirectoryDataSourceDb.kt`.

Refactor: Update SchoolDirectoryDataSource and related components

This commit introduces several changes to the SchoolDirectoryDataSource and its related classes to improve functionality and data handling.

Key changes:
- **SchoolDirectoryDataSourceDb**:
    - Modified `deleteByUrl` to accept `String` instead of `Url` for the URL parameter.
- **Database Schema (RespectAppDatabase/1.json)**:
    - Updated the `identityHash`.
    - Added `cLastModified` and `cStored` fields (INTEGER, NOT NULL) to the `SchoolDirectoryEntity` table.
- **SchoolDirectoryEntityDao**:
    - Changed the `deleteByUrl` function parameter from `Url` to `String`.
    - Added a new query function `getLastModifiedByUrl` to retrieve the `cLastModified` timestamp for a given URL.
- **SchoolDirectoryListViewModel**:
    - When navigating to `SchoolDirectoryEdit` after clicking add, it now pops up to `SchoolDirectoryList`.
    - After deleting a directory, `loadSchoolDirectories()` is called to refresh the list.
- **SchoolDirectoryEditViewModel**:
    - When saving a new school directory, the `invitePrefix` is now initialized as an empty string.
    - Navigation after saving now pops up to `SchoolDirectoryList` inclusively.
- **SchoolDirectoryDataSourceHttp**:
    - `allDirectories()` now delegates to the local data source.
    - `deleteDirectory()` now delegates to the local data source.
- **File Rename**:
    - Renamed `SchoolEntryAdapter.kt` to `SchoolDirectoryAdapter.kt`.

Refactor: Enhance School Directory Management and Server-Side Logic

This commit introduces significant changes to how school directories are managed, both on the client and server sides. It refines the data model, updates database interactions, and adds new server endpoints for directory operations.

Key changes:
- **Database Schema (RespectAppDatabase/1.json)**:
    - Updated the `identityHash`.
    - Removed `cLastModified` and `cStored` fields from the `SchoolDirectoryEntity` table as they are no longer used.
- **SchoolDirectoryEntityDao**:
    - Removed the `getLastModifiedByUrl` function, as the `cLastModified` field has been removed from the entity.
- **Server-Side Logic**:
    - Introduced `AddDirectoryUseCase` to handle the creation of new school directories on the server. This use case generates a random invite prefix for the new directory.
    - Added `AddDirectoryUseCase` to the `ServerKoinModule`.
    - Created a new POST endpoint `api/directory/adddirectory` in `RespectSchoolDirectoryRoute.kt`. This endpoint accepts a `url` query parameter and uses `AddDirectoryUseCase` to create the directory.
- **SchoolDirectoryDataSourceHttp**:
    - `allDirectories()`:
        - Now fetches all directories from the remote server endpoint `api/directory/school` using the base URL of the first locally stored directory. It throws an `IllegalStateException` if no local directory is found to determine the base URL.
    - `insertDirectory(directory: RespectSchoolDirectory)`:
        - Now makes a POST request to the new `api/directory/adddirectory` endpoint.
        - Instead of sending the `RespectSchoolDirectory` object in the request body, it now sends the directory's `baseUrl` as a `url` query parameter.
- **SchoolDirectoryDataSourceRepository**:
    - `insertDirectory(directory: RespectSchoolDirectory)`:
        - Now calls `remote.insertDirectory(directory)` before inserting locally, ensuring the directory is first added via the remote data source.

Refactor: Update School Directory data source HTTP implementation

This commit updates `SchoolDirectoryDataSourceHttp` to correctly implement `deleteDirectory` and `insertDirectory` using HTTP DELETE and POST requests respectively. It also modifies `SchoolDirectoryDataSourceRepository` to only call the local data source for `insertDirectory`.

Key changes:
- **SchoolDirectoryDataSourceHttp**:
    - `deleteDirectory`: Now sends an HTTP DELETE request to the `api/directory/deletedirectory` endpoint. The `RespectSchoolDirectory` object is sent in the request body with `Content-Type: application/json`.
    - `insertDirectory`:
        - Sends an HTTP POST request to the `api/directory/add` endpoint.
        - The `RespectSchoolDirectory` object is now sent in the request body instead of as a URL parameter.
        - `Content-Type` is set to `application/json`.
    - `allDirectories()`: No longer throws an exception if no base URL is found locally, as this was likely a leftover from previous logic.
- **SchoolDirectoryDataSourceRepository**:
    - `insertDirectory`: Removed the call to `remote.insertDirectory(directory)`. Directory insertion is now only handled by the local data source within the repository layer.

Refactor: Remove unused PagingSource from SchoolDirectoryEntryDataSource

This commit removes the `listAsPagingSource` function and its implementations from `SchoolDirectoryEntryDataSource` and related classes, as it is no longer used.

Key changes:
- Removed `listAsPagingSource` from the `SchoolDirectoryEntryDataSource` interface.
- Removed the `TODO` implementation of `listAsPagingSource` from:
    - `SchoolDirectoryEntryDataSourceHttp.kt`
    - `SchoolDirectoryEntryDataSourceRepository.kt`
    - `SchoolDirectoryEntryDataSourceDb.kt`
- Removed extraneous new lines in:
    - `SchoolDataSource.kt`
    - `SchoolDirectoryDataSource.kt`
    - `SchoolDirectoryEditScreen.kt`
    - `SchoolDataSourceDb.kt`
- Corrected inconsistent spacing in `ServerKoinModule.kt`.

change

change

Refactor: Remove invite code logic from data sources

This commit removes the concept of fetching directory information via an invite code directly from the `SchoolDirectoryDataSource` and its database implementation.

Key changes:
- **SchoolDirectoryDataSource**:
    - Removed the `getInviteInfo` function from the interface, as this logic is no longer handled at this layer.
- **SchoolDirectoryDataSourceDb**:
    - Removed the implementation of `getDirectoryByInviteCode`, which previously queried the local database for a directory matching an invite code.

Refactor: Remove invite code logic from data sources

This commit removes the concept of fetching directory information via an invite code directly from the `SchoolDirectoryDataSource` and its database implementation.

Key changes:
- **SchoolDirectoryDataSource**:
    - Removed the `getInviteInfo` function from the interface, as this logic is no longer handled at this layer.
- **SchoolDirectoryDataSourceDb**:
    - Removed the implementation of `getDirectoryByInviteCode`, which previously queried the local database for a directory matching an invite code.

Initial implementation of functionality to set a username and password for an existing account.

feat: Add email and phone number to Person entity

This commit updates the `PersonEntity` to include optional fields for `pEmail` and `pPhoneNumber`.

Key changes:
- Updated `gradle/libs.versions.toml` to bump the Android Gradle Plugin (agp) version from `8.12.2` to `8.12.3`.
- Modified the `PersonEntity` in the database schema to add `pEmail` and `pPhoneNumber` columns.
- Disabled the selection of future dates in the `RespectLocalDateField` date picker.
- Added explicit parameter names to the `joinDateAndTime` lambda in `rememberFormattedDateTime`.

feat: Add email and phone number to Person entity

This commit updates the `PersonEntity` to include optional fields for `pEmail` and `pPhoneNumber`.

Key changes:
- Updated `gradle/libs.versions.toml` to bump the Android Gradle Plugin (agp) version from `8.12.2` to `8.12.3`.
- Modified the `PersonEntity` in the database schema to add `pEmail` and `pPhoneNumber` columns.
- Disabled the selection of future dates in the `RespectLocalDateField` date picker.
- Added explicit parameter names to the `joinDateAndTime` lambda in `rememberFormattedDateTime`.

Update set password logic to use school data source. Remove SetPasswordUseCase.

feat: Validate date of birth on save

This commit introduces validation to prevent the date of birth from being in the future. The validation is now handled in the `PersonEditViewModel` when the save button is clicked, rather than restricting the date selection in the UI.

Key changes:
- Removed the future date restriction from the `RespectLocalDateField` date picker, allowing users to select any date.
- Added a new string resource `date_of_birth_in_future` for the error message.
- Updated `PersonEditViewModel` to validate the date of birth upon saving. If the selected date is in the future, an error message is displayed and the save is aborted.
- Modified `PersonEditScreen` to display the date of birth validation error message below the input field.

Initial implementation of password change functionality.

Initial implementation of password change functionality.

Implement change password functionality.

Tidy for merge:

1) Revert unnecessary changes that changed formatting / white space on existing classes.
2) Add button to get started other options screen.

Fix for Person db datalayer:
1) PersonRelatedPersonEntity was not set to use autogenerate primary key
2) PersonEntityWithRoles had incorrectly set entityColumn.

Tidy:
a) move phone number domain packages to respect-lib-shared (should not have been in respect-app-compose)
b) Use libphonenumber-android on Android (as per Ustad Mobile)
c) Fix package names (various classes were in com.ustadmobile instead of world.respect package).
d) Fix person adapter toModel function: without this change phonenumber and email would always be lost when converting from db entity to model.

Fix package name

Add click phone number support.

Update OtherOptionsViewModel.kt to check school URL is a valid RESPECT school URL.

Use ACRA custom data to track selected account and most recent screen

Update Android Gradle Plugin version.

Update gender dropdown and mandatory field indicators.

Remove unspecified from gender dropdown
Make mandatory field indicators consistent across screens (Issue #82)

Update Room and ACRA versions.

Remove redundant class name string.

Fixes to update dev-download branch from main: compilation/full build succeeds.

Increase Gradle max memory setting org.gradle.jvmargs .

Initial connection of run download use case to lesson detail view model.

Update ClassDetail to display add/edit options by role.

Update person screen to support setting/showing roles.

Avoid date of birth from showing 1900 default.

Bump version

Change database names to avoid migration crash on internal testing track.

Implement publication pin for offline content download.

Connect with Learning Unit Detail screen to show status for each lesson.

Update lib-cache to serve any available response (even if stale) when device is known to be offline.

Update pin publication prepare to include adding respect parameters on acquisition links to ensure first page opens as expected when offline.

Fix showing download progress.

Show indeterminate progress when pin publication preparation (size gathering) is underway.