[FEATURE]: Typesense + Langchain AI search app

README.md

@@ -8,16 +8,24 @@ This is a monorepo containing multiple standalone projects. Each project lives i
 
 ```plaintext
 code-samples/
-├── typesense-angular-search-bar/         # Angular + Typesense search implementation
-├── typesense-astro-search/              # Astro + Typesense search implementation
-├── typesense-gin-full-text-search/      # Go (Gin) + Typesense backend implementation
-├── typesense-next-search-bar/           # Next.js + Typesense search implementation
-├── typesense-nuxt-search-bar/           # Nuxt.js + Typesense search implementation
-├── typesense-qwik-js-search/            # Qwik + Typesense search implementation
-├── typesense-react-native-search-bar/   # React Native + Typesense search implementation
-├── typesense-solid-js-search/           # SolidJS + Typesense search implementation
-├── typesense-vanilla-js-search/         # Vanilla JS + Typesense search implementation
-└── README.md                            # You are here
+├── typesense-angular-search-bar/               # Angular + Typesense search implementation
+├── typesense-astro-search/                     # Astro + Typesense search implementation
+├── typesense-gin-full-text-search/             # Go (Gin) + Typesense backend implementation
+├── typesense-kotlin/                           # Kotlin (Android) + Typesense search implementation
+├── typesense-langchain-ai-search/              # Python + LangChain + Typesense AI search implementation
+├── typesense-next-search-bar/                  # Next.js + Typesense search implementation
+├── typesense-nuxt-search-bar/                  # Nuxt.js + Typesense search implementation
+├── typesense-qwik-js-search/                   # Qwik + Typesense search implementation
+├── typesense-react-native-search-bar/          # React Native + Typesense search implementation
+├── typesense-solid-js-search/                  # SolidJS + Typesense search implementation
+├── typesense-springboot-full-text-search/      # Spring Boot + Typesense backend implementation
+├── typesense-node-prisma-full-text-search/     # Node.js (Express) + Typesense + Prisma backend implementation
+├── typesense-node-sequelize-full-text-search/  # Node.js (Express) + Typesense + Sequelize backend implementation
+├── typesense-node-drizzle-full-text-search/    # Node.js (Express) + Typesense + Drizzle backend implementation
+├── typesense-sveltekit-search-app/             # SvelteKit + Typesense search implementation
+├── typesense-swift-search/                     # Swift (iOS) + Typesense search implementation
+├── typesense-vanilla-js-search/                # Vanilla JS + Typesense search implementation
+└── README.md                                   # You are here
 ```
 
 ## Projects
@@ -27,11 +35,19 @@ code-samples/
 | [typesense-angular-search-bar](./typesense-angular-search-bar)               | Angular       | A modern search bar with instant search capabilities            |
 | [typesense-astro-search](./typesense-astro-search)                           | Astro         | A modern search bar with instant search capabilities            |
 | [typesense-gin-full-text-search](./typesense-gin-full-text-search)           | Go (Gin)      | Backend API with full-text search using Typesense               |
+| [typesense-kotlin](./typesense-kotlin)                                       | Kotlin (Android) | A native Android search bar with instant search capabilities    |
+| [typesense-langchain-ai-search](./typesense-langchain-ai-search)             | LangChain (Python) | Conversational AI-powered movie search and recommendation app   |
 | [typesense-next-search-bar](./typesense-next-search-bar)                     | Next.js       | A modern search bar with instant search capabilities            |
 | [typesense-nuxt-search-bar](./typesense-nuxt-search-bar)                     | Nuxt.js       | A modern search bar with instant search capabilities            |
 | [typesense-qwik-js-search](./typesense-qwik-js-search)                       | Qwik          | Resumable search bar with real-time search and modern UI        |
 | [typesense-react-native-search-bar](./typesense-react-native-search-bar)     | React Native  | A mobile search bar with instant search capabilities            |
 | [typesense-solid-js-search](./typesense-solid-js-search)                     | SolidJS       | A modern search bar with instant search capabilities            |
+| [typesense-springboot-full-text-search](./typesense-springboot-full-text-search) | Spring Boot | Backend API with full-text search using Typesense               |
+| [typesense-node-prisma-full-text-search](./typesense-node-prisma-full-text-search)     | Node.js (Express) + Typesense + Prisma | Backend API with full-text search using Typesense               |
+| [typesense-node-sequelize-full-text-search](./typesense-node-sequelize-full-text-search) | Node.js (Express) + Typesense + Sequelize | Backend API with full-text search using Typesense               |
+| [typesense-node-drizzle-search-app](./typesense-node-drizzle-search-app)     | Node.js (Express) + Typesense + Drizzle | Backend API with full-text search using Typesense               |
+| [typesense-sveltekit-search-app](./typesense-sveltekit-search-app)           | SvelteKit     | A modern search bar with instant search capabilities            |
+| [typesense-swift-search](./typesense-swift-search)                           | Swift (iOS)   | A native iOS search app with instant search capabilities        |
 | [typesense-vanilla-js-search](./typesense-vanilla-js-search)                 | Vanilla JS    | A modern search bar with instant search capabilities            |
 
 ## Getting Started

typesense-kotlin-search/.gitignore

@@ -0,0 +1,15 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties

typesense-kotlin-search/app/.gitignore

@@ -0,0 +1 @@
+/build

typesense-kotlin-search/app/build.gradle.kts

@@ -0,0 +1,54 @@
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.android)
+}
+
+android {
+    namespace = "org.typesense.samplekotlin"
+    compileSdk = 34
+
+    defaultConfig {
+        applicationId = "org.typesense.samplekotlin"
+        minSdk = 26
+        targetSdk = 34
+        versionCode = 1
+        versionName = "1.0"
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_11
+        targetCompatibility = JavaVersion.VERSION_11
+    }
+    kotlinOptions {
+        jvmTarget = "11"
+    }
+    buildFeatures {
+        viewBinding = true
+    }
+}
+
+dependencies {
+    implementation(libs.androidx.core.ktx)
+    implementation(libs.androidx.appcompat)
+    implementation(libs.material)
+    implementation(libs.typesense)
+    implementation(libs.androidx.lifecycle.viewmodel.ktx)
+    implementation(libs.androidx.lifecycle.runtime.ktx)
+    implementation(libs.kotlinx.coroutines.android)
+    implementation(libs.coil)
+
+    testImplementation(libs.junit)
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.espresso.core)
+}

typesense-kotlin-search/app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

typesense-kotlin-search/app/src/androidTest/java/org/typesense/samplekotlin/ExampleInstrumentedTest.kt

@@ -0,0 +1,24 @@
+package org.typesense.samplekotlin
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+    @Test
+    fun useAppContext() {
+        // Context of the app under test.
+        val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+        assertEquals("org.typesense.samplekotlin", appContext.packageName)
+    }
+}

typesense-kotlin-search/app/src/main/AndroidManifest.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.TypesenseWithKotlin"
+        android:usesCleartextTraffic="true">
+
+        <activity
+            android:name=".presentation.MainActivity"
+            android:exported="true"
+            android:windowSoftInputMode="adjustResize">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

typesense-kotlin-search/app/src/main/java/org/typesense/samplekotlin/data/repository/TypesenseBookRepository.kt

@@ -0,0 +1,32 @@
+package org.typesense.samplekotlin.data.repository
+
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import org.typesense.api.Client
+import org.typesense.model.SearchParameters
+import org.typesense.samplekotlin.domain.model.Book
+import org.typesense.samplekotlin.domain.repository.BookRepository
+
+class TypesenseBookRepository(private val client: Client) : BookRepository {
+
+    override suspend fun searchBooks(query: String): List<Book> = withContext(Dispatchers.IO) {
+        val searchParameters = SearchParameters()
+            .q(query)
+            .queryBy("title,authors")
+            .sortBy("average_rating:desc")
+
+        val searchResult = client.collections("books").documents().search(searchParameters)
+
+        searchResult.hits?.map { hit ->
+            val document = hit.document
+            Book(
+                id = document["id"]?.toString() ?: "",
+                title = document["title"]?.toString() ?: "",
+                authors = (document["authors"] as? List<*>)?.map { it.toString() } ?: emptyList(),
+                publicationYear = (document["publication_year"] as? Double)?.toInt(),
+                imageUrl = document["image_url"]?.toString(),
+                averageRating = document["average_rating"] as? Double
+            )
+        } ?: emptyList()
+    }
+}

typesense-kotlin-search/app/src/main/java/org/typesense/samplekotlin/domain/model/Book.kt

@@ -0,0 +1,10 @@
+package org.typesense.samplekotlin.domain.model
+
+data class Book(
+    val id: String,
+    val title: String,
+    val authors: List<String>,
+    val publicationYear: Int?,
+    val imageUrl: String?,
+    val averageRating: Double?
+)

typesense-kotlin-search/app/src/main/java/org/typesense/samplekotlin/domain/repository/BookRepository.kt

@@ -0,0 +1,7 @@
+package org.typesense.samplekotlin.domain.repository
+
+import org.typesense.samplekotlin.domain.model.Book
+
+interface BookRepository {
+    suspend fun searchBooks(query: String): List<Book>
+}

typesense-kotlin-search/app/src/main/java/org/typesense/samplekotlin/domain/usecase/SearchBooksUseCase.kt

@@ -0,0 +1,18 @@
+package org.typesense.samplekotlin.domain.usecase
+
+import org.typesense.samplekotlin.domain.model.Book
+import org.typesense.samplekotlin.domain.repository.BookRepository
+
+class SearchBooksUseCase(private val repository: BookRepository) {
+    suspend operator fun invoke(query: String): Result<List<Book>> {
+        return try {
+            if (query.isBlank()) {
+                Result.success(emptyList())
+            } else {
+                Result.success(repository.searchBooks(query))
+            }
+        } catch (e: Exception) {
+            Result.failure(e)
+        }
+    }
+}

typesense-kotlin-search/app/src/main/java/org/typesense/samplekotlin/presentation/BookAdapter.kt

@@ -0,0 +1,42 @@
+package org.typesense.samplekotlin.presentation
+
+import android.view.LayoutInflater
+import android.view.ViewGroup
+import androidx.recyclerview.widget.DiffUtil
+import androidx.recyclerview.widget.ListAdapter
+import androidx.recyclerview.widget.RecyclerView
+import coil.load
+import org.typesense.samplekotlin.databinding.ItemBookBinding
+import org.typesense.samplekotlin.domain.model.Book
+
+class BookAdapter : ListAdapter<Book, BookAdapter.BookViewHolder>(BookDiffCallback()) {
+
+    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BookViewHolder {
+        val binding = ItemBookBinding.inflate(LayoutInflater.from(parent.context), parent, false)
+        return BookViewHolder(binding)
+    }
+
+    override fun onBindViewHolder(holder: BookViewHolder, position: Int) {
+        holder.bind(getItem(position))
+    }
+
+    class BookViewHolder(private val binding: ItemBookBinding) : RecyclerView.ViewHolder(binding.root) {
+        fun bind(book: Book) {
+            binding.titleTextView.text = book.title
+            binding.authorsTextView.text = book.authors.joinToString(", ")
+            binding.yearTextView.text = book.publicationYear?.toString() ?: ""
+            binding.ratingBar.rating = book.averageRating?.toFloat() ?: 0f
+
+            binding.bookCoverImageView.load(book.imageUrl) {
+                crossfade(true)
+                placeholder(android.R.color.darker_gray)
+                error(android.R.color.darker_gray)
+            }
+        }
+    }
+
+    class BookDiffCallback : DiffUtil.ItemCallback<Book>() {
+        override fun areItemsTheSame(oldItem: Book, newItem: Book): Boolean = oldItem.id == newItem.id
+        override fun areContentsTheSame(oldItem: Book, newItem: Book): Boolean = oldItem == newItem
+    }
+}

typesense-kotlin-search/app/src/main/java/org/typesense/samplekotlin/presentation/BookViewModel.kt

@@ -0,0 +1,40 @@
+package org.typesense.samplekotlin.presentation
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.viewModelScope
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.launch
+import org.typesense.samplekotlin.domain.model.Book
+import org.typesense.samplekotlin.domain.usecase.SearchBooksUseCase
+
+class BookViewModel(private val searchBooksUseCase: SearchBooksUseCase) : ViewModel() {
+
+    private val _uiState = MutableStateFlow<BookUiState>(BookUiState.Idle)
+    val uiState: StateFlow<BookUiState> = _uiState
+
+    fun search(query: String) {
+        if (query.isBlank()) {
+            _uiState.value = BookUiState.Idle
+            return
+        }
+
+        _uiState.value = BookUiState.Loading
+        viewModelScope.launch {
+            searchBooksUseCase(query)
+                .onSuccess { books ->
+                    _uiState.value = BookUiState.Success(books)
+                }
+                .onFailure { error ->
+                    _uiState.value = BookUiState.Error(error.message ?: "Unknown error")
+                }
+        }
+    }
+}
+
+sealed class BookUiState {
+    object Idle : BookUiState()
+    object Loading : BookUiState()
+    data class Success(val books: List<Book>) : BookUiState()
+    data class Error(val message: String) : BookUiState()
+}