@viafoura/sdk-react-native 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# @viafoura/sdk-react-native
+
+Basic install and usage.
+
+# Install
+
+```
+npm install @viafoura/sdk-react-native
+```
+
+iOS:
+
+```
+npx pod-install
+```
+
+# Usage
+
+Initialize the SDK once at app startup (e.g., in `App.tsx` or a bootstrap module):
+
+```ts
+import Viafoura from '@viafoura/sdk-react-native';
+
+await Viafoura.initialize('SITE_UUID', 'your.domain.com', true);
+```
+
+Then render the views you need:
+
+```tsx
+import { PreviewCommentsView } from '@viafoura/sdk-react-native';
+
+<PreviewCommentsView
+  containerId="YOUR_CONTAINER_ID"
+  articleUrl="https://example.com/article"
+  articleTitle="Title"
+  articleThumbnailUrl="https://example.com/thumb.jpg"
+/>
+```
+
+`ProfileView` and `NewCommentView` are Android-only. On iOS they render as empty views.

package/android/build.gradle

@@ -0,0 +1,48 @@
+apply plugin: 'com.android.library'
+
+group = 'expo.modules.viafourasdk'
+version = '0.1.0'
+
+def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
+apply from: expoModulesCorePlugin
+applyKotlinExpoModulesCorePlugin()
+useCoreDependencies()
+useExpoPublishing()
+
+// If you want to use the managed Android SDK versions from expo-modules-core, set this to true.
+// The Android SDK versions will be bumped from time to time in SDK releases and may introduce breaking changes in your module code.
+// Most of the time, you may like to manage the Android SDK versions yourself.
+def useManagedAndroidSdkVersions = false
+if (useManagedAndroidSdkVersions) {
+  useDefaultAndroidSdkVersions()
+} else {
+  buildscript {
+    // Simple helper that allows the root project to override versions declared by this library.
+    ext.safeExtGet = { prop, fallback ->
+      rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    }
+  }
+  project.android {
+    compileSdkVersion safeExtGet("compileSdkVersion", 36)
+    defaultConfig {
+      minSdkVersion safeExtGet("minSdkVersion", 24)
+      targetSdkVersion safeExtGet("targetSdkVersion", 36)
+    }
+  }
+}
+
+android {
+  namespace "expo.modules.viafourasdk"
+  defaultConfig {
+    versionCode 1
+    versionName "0.1.0"
+  }
+  lintOptions {
+    abortOnError false
+  }
+}
+
+dependencies {
+  // Viafoura Android SDK (published artifact)
+  implementation 'com.viafoura:android:2.0.52'
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest>
+</manifest>

package/android/src/main/java/expo/modules/viafourasdk/NewCommentModule.kt

@@ -0,0 +1,27 @@
+package expo.modules.viafourasdk
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class NewCommentModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("NewComment")
+
+    View(NewCommentView::class) {
+      // Props
+      Prop("newCommentActionType") { view: NewCommentView, v: String -> view.newCommentActionType = v }
+      Prop("content") { view: NewCommentView, v: String? -> view.content = v }
+      Prop("containerId") { view: NewCommentView, v: String -> view.containerId = v }
+      Prop("syndicationKey") { view: NewCommentView, v: String? -> view.syndicationKey = v }
+      Prop("articleTitle") { view: NewCommentView, v: String -> view.articleTitle = v }
+      Prop("articleSubtitle") { view: NewCommentView, v: String? -> view.articleSubtitle = v }
+      Prop("articleUrl") { view: NewCommentView, v: String -> view.articleUrl = v }
+      Prop("articleThumbnailUrl") { view: NewCommentView, v: String -> view.articleThumbnailUrl = v }
+      Prop("darkMode") { view: NewCommentView, v: Boolean? -> view.darkMode = v ?: false }
+
+      // Events
+      Events("onAuthNeeded", "onCloseNewComment", "onHeightChanged")
+    }
+  }
+}
+

package/android/src/main/java/expo/modules/viafourasdk/NewCommentView.kt

@@ -0,0 +1,153 @@
+package expo.modules.viafourasdk
+
+import android.content.Context
+import android.widget.FrameLayout
+import androidx.core.view.ViewCompat
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.FragmentActivity
+import expo.modules.kotlin.AppContext
+import expo.modules.kotlin.viewevent.EventDispatcher
+import expo.modules.kotlin.views.ExpoView
+
+// Viafoura SDK imports
+import com.viafourasdk.src.fragments.base.VFFragment
+import com.viafourasdk.src.fragments.newcomment.VFNewCommentFragment
+import com.viafourasdk.src.fragments.newcomment.VFNewCommentFragmentBuilder
+import com.viafourasdk.src.model.local.VFNewCommentAction
+import com.viafourasdk.src.interfaces.VFActionsInterface
+import com.viafourasdk.src.interfaces.VFCustomUIInterface
+import com.viafourasdk.src.interfaces.VFLayoutInterface
+import com.viafourasdk.src.model.local.VFActionData
+import com.viafourasdk.src.model.local.VFActionType
+import com.viafourasdk.src.model.local.VFArticleMetadata
+import com.viafourasdk.src.model.local.VFColors
+import com.viafourasdk.src.model.local.VFDefaultColors
+import com.viafourasdk.src.model.local.VFSettings
+import com.viafourasdk.src.model.local.VFTheme
+import java.net.URL
+import java.util.UUID
+
+class NewCommentView(context: Context, private val appContext: AppContext) :
+  ExpoView(context, appContext), VFCustomUIInterface, VFActionsInterface, VFLayoutInterface {
+
+  // Props
+  var newCommentActionType: String = "create" // create | edit | reply
+  var content: String? = null
+  var containerId: String? = null
+  var syndicationKey: String? = null
+  var articleTitle: String? = null
+  var articleSubtitle: String? = null
+  var articleUrl: String? = null
+  var articleThumbnailUrl: String? = null
+  var darkMode: Boolean = false
+
+  // Events
+  private val onAuthNeeded by EventDispatcher()
+  private val onCloseNewComment by EventDispatcher()
+  private val onHeightChanged by EventDispatcher()
+
+  // Internals
+  private val container = FrameLayout(context).also {
+    it.layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
+    it.id = ViewCompat.generateViewId()
+    addView(it)
+  }
+  private var fragment: VFNewCommentFragment? = null
+
+  override fun onAttachedToWindow() {
+    super.onAttachedToWindow()
+    ensureFragment()
+  }
+
+  override fun onDetachedFromWindow() {
+    super.onDetachedFromWindow()
+    destroyFragment()
+  }
+
+  private fun currentActivity(): FragmentActivity? =
+    appContext.currentActivity as? FragmentActivity
+
+  private fun ensureFragment() {
+    if (fragment != null) return
+    val activity = currentActivity() ?: return
+
+    try {
+      val metadata = VFArticleMetadata(
+        URL(requireNotNull(articleUrl)),
+        requireNotNull(articleTitle),
+        articleSubtitle ?: "",
+        URL(requireNotNull(articleThumbnailUrl))
+      )
+      val colors = VFColors(
+        VFDefaultColors.getInstance().colorPrimaryDefault(null),
+        VFDefaultColors.getInstance().colorPrimaryLightDefault(null)
+      )
+      val settings = VFSettings(colors)
+
+      val type = when (newCommentActionType) {
+        "edit" -> VFNewCommentAction.VFNewCommentActionType.edit
+        "reply" -> VFNewCommentAction.VFNewCommentActionType.reply
+        else -> VFNewCommentAction.VFNewCommentActionType.create
+      }
+      val action = VFNewCommentAction(type)
+      content?.let { c ->
+        if (c.isNotEmpty()) action.content = UUID.fromString(c)
+      }
+
+      val builder = VFNewCommentFragmentBuilder(action, requireNotNull(containerId), metadata, settings)
+      syndicationKey?.let { builder.syndicationKey(it) }
+      val frag = builder.build()
+      frag.setActionCallback(this)
+      frag.setCustomUICallback(this)
+      frag.setTheme(if (darkMode) VFTheme.dark else VFTheme.light)
+
+      activity.supportFragmentManager
+        .beginTransaction()
+        .replace(container.id, frag, container.id.toString())
+        .commit()
+
+      fragment = frag
+    } catch (_: Exception) {
+      // Swallow; invalid input
+    }
+  }
+
+  private fun destroyFragment() {
+    val activity = currentActivity() ?: return
+    val tag = container.id.toString()
+    val frag: Fragment? = activity.supportFragmentManager.findFragmentByTag(tag)
+    if (frag != null) {
+      activity.supportFragmentManager
+        .beginTransaction()
+        .remove(frag)
+        .commit()
+    }
+    fragment = null
+  }
+
+  // VFActionsInterface
+  override fun onNewAction(actionType: VFActionType, action: VFActionData) {
+    when (actionType) {
+      VFActionType.closeNewCommentPressed -> {
+        onCloseNewComment(emptyMap<String, Any>())
+      }
+      VFActionType.authPressed -> {
+        onAuthNeeded(mapOf("requireLogin" to true))
+      }
+      else -> {}
+    }
+  }
+
+  // VFCustomUIInterface
+  override fun customizeView(
+    theme: com.viafourasdk.src.model.local.VFTheme?,
+    customViewType: com.viafourasdk.src.model.local.VFCustomViewType?,
+    view: android.view.View?
+  ) { /* no-op */ }
+
+  // VFLayoutInterface
+  override fun containerHeightUpdated(fragment: VFFragment, containerId: String, height: Int) {
+    onHeightChanged(mapOf("newHeight" to height, "containerId" to containerId))
+  }
+}
+

package/android/src/main/java/expo/modules/viafourasdk/PreviewCommentsModule.kt

@@ -0,0 +1,26 @@
+package expo.modules.viafourasdk
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class PreviewCommentsModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("PreviewComments")
+
+    View(PreviewCommentsView::class) {
+      // Props
+      Prop("containerId") { view: PreviewCommentsView, v: String -> view.containerId = v }
+      Prop("authorId") { view: PreviewCommentsView, v: String? -> view.authorId = v }
+      Prop("articleUrl") { view: PreviewCommentsView, v: String -> view.articleUrl = v }
+      Prop("articleTitle") { view: PreviewCommentsView, v: String -> view.articleTitle = v }
+      Prop("articleSubtitle") { view: PreviewCommentsView, v: String? -> view.articleSubtitle = v }
+      Prop("articleThumbnailUrl") { view: PreviewCommentsView, v: String -> view.articleThumbnailUrl = v }
+      Prop("syndicationKey") { view: PreviewCommentsView, v: String? -> view.syndicationKey = v }
+      Prop("darkMode") { view: PreviewCommentsView, v: Boolean? -> view.darkMode = v ?: false }
+
+      // Events
+      Events("onHeightChanged", "onAuthNeeded", "onOpenProfile", "onNewComment", "onArticlePressed")
+    }
+  }
+}
+

package/android/src/main/java/expo/modules/viafourasdk/PreviewCommentsView.kt

@@ -0,0 +1,157 @@
+package expo.modules.viafourasdk
+
+import android.content.Context
+import android.view.ViewGroup
+import android.widget.FrameLayout
+import androidx.core.view.ViewCompat
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.FragmentActivity
+import expo.modules.kotlin.AppContext
+import expo.modules.kotlin.viewevent.EventDispatcher
+import expo.modules.kotlin.views.ExpoView
+
+// Viafoura SDK imports
+import com.viafourasdk.src.fragments.base.VFFragment
+import com.viafourasdk.src.fragments.previewcomments.VFPreviewCommentsFragment
+import com.viafourasdk.src.fragments.previewcomments.VFPreviewCommentsFragmentBuilder
+import com.viafourasdk.src.interfaces.VFActionsInterface
+import com.viafourasdk.src.interfaces.VFCustomUIInterface
+import com.viafourasdk.src.interfaces.VFLayoutInterface
+import com.viafourasdk.src.model.local.VFActionData
+import com.viafourasdk.src.model.local.VFActionType
+import com.viafourasdk.src.model.local.VFArticleMetadata
+import com.viafourasdk.src.model.local.VFColors
+import com.viafourasdk.src.model.local.VFDefaultColors
+import com.viafourasdk.src.model.local.VFSettings
+import com.viafourasdk.src.model.local.VFTheme
+import java.net.URL
+
+class PreviewCommentsView(context: Context, private val appContext: AppContext) :
+  ExpoView(context, appContext), VFCustomUIInterface, VFActionsInterface, VFLayoutInterface {
+
+  // Props
+  var containerId: String? = null
+  var authorId: String? = null
+  var articleUrl: String? = null
+  var articleTitle: String? = null
+  var articleSubtitle: String? = null
+  var articleThumbnailUrl: String? = null
+  var syndicationKey: String? = null
+  var darkMode: Boolean = false
+
+  // Events
+  private val onHeightChanged by EventDispatcher()
+  private val onAuthNeeded by EventDispatcher()
+  private val onOpenProfile by EventDispatcher()
+  private val onNewComment by EventDispatcher()
+  private val onArticlePressed by EventDispatcher()
+
+  // Internals
+  private val container = FrameLayout(context).also {
+    it.layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
+    it.id = ViewCompat.generateViewId()
+    addView(it)
+  }
+
+  private var fragment: VFPreviewCommentsFragment? = null
+
+  override fun onAttachedToWindow() {
+    super.onAttachedToWindow()
+    ensureFragment()
+  }
+
+  override fun onDetachedFromWindow() {
+    super.onDetachedFromWindow()
+    destroyFragment()
+  }
+
+  private fun currentActivity(): FragmentActivity? =
+    appContext.currentActivity as? FragmentActivity
+
+  private fun ensureFragment() {
+    if (fragment != null) return
+    val activity = currentActivity() ?: return
+
+    try {
+      val meta = VFArticleMetadata(
+        URL(requireNotNull(articleUrl)),
+        requireNotNull(articleTitle),
+        articleSubtitle ?: "",
+        URL(requireNotNull(articleThumbnailUrl))
+      )
+      val colors = VFColors(
+        VFDefaultColors.getInstance().colorPrimaryDefault(null),
+        VFDefaultColors.getInstance().colorPrimaryLightDefault(null)
+      )
+      val settings = VFSettings(colors)
+
+      val builder = VFPreviewCommentsFragmentBuilder(requireNotNull(containerId), meta, settings)
+      syndicationKey?.let { builder.syndicationKey(it) }
+      val frag = builder.build()
+      frag.setActionCallback(this)
+      frag.setLayoutCallback(this)
+      frag.setCustomUICallback(this)
+      frag.setTheme(if (darkMode) VFTheme.dark else VFTheme.light)
+      authorId?.let { if (it.isNotEmpty()) frag.setAuthorIds(listOf(it)) }
+
+      activity.supportFragmentManager
+        .beginTransaction()
+        .replace(container.id, frag, container.id.toString())
+        .commit()
+
+      fragment = frag
+    } catch (_: Exception) {
+      // Swallow; invalid input
+    }
+  }
+
+  private fun destroyFragment() {
+    val activity = currentActivity() ?: return
+    val tag = container.id.toString()
+    val frag = activity.supportFragmentManager.findFragmentByTag(tag)
+    if (frag != null) {
+      activity.supportFragmentManager
+        .beginTransaction()
+        .remove(frag)
+        .commit()
+    }
+    fragment = null
+  }
+
+  // VFCustomUIInterface
+  override fun customizeView(
+    theme: com.viafourasdk.src.model.local.VFTheme?,
+    customViewType: com.viafourasdk.src.model.local.VFCustomViewType?,
+    view: android.view.View?
+  ) { /* no-op */ }
+
+  // VFActionsInterface
+  override fun onNewAction(actionType: VFActionType, action: VFActionData) {
+    when (actionType) {
+      VFActionType.writeNewCommentPressed -> {
+        val content = action.newCommentAction?.content?.toString()
+        val type = action.newCommentAction?.type?.toString()
+        onNewComment(mapOf("content" to content, "actionType" to type).filterValues { it != null })
+      }
+      VFActionType.openProfilePressed -> {
+        val pres = action.openProfileAction?.presentationType?.toString()
+        val user = action.openProfileAction?.userUUID?.toString()
+        onOpenProfile(mapOf("presentationType" to pres, "userUUID" to user).filterValues { it != null })
+      }
+      VFActionType.trendingArticlePressed -> {
+        val url = action.trendingPressedAction?.articleMetadata?.url?.toString() ?: return
+        val containerId = action.trendingPressedAction?.containerId ?: ""
+        onArticlePressed(mapOf("articleUrl" to url, "containerId" to containerId))
+      }
+      VFActionType.authPressed -> {
+        onAuthNeeded(mapOf("requireLogin" to true))
+      }
+      else -> {}
+    }
+  }
+
+  // VFLayoutInterface
+  override fun containerHeightUpdated(fragment: VFFragment, containerId: String, height: Int) {
+    onHeightChanged(mapOf("newHeight" to height, "containerId" to containerId))
+  }
+}

package/android/src/main/java/expo/modules/viafourasdk/ProfileModule.kt

@@ -0,0 +1,21 @@
+package expo.modules.viafourasdk
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+class ProfileModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("Profile")
+
+    View(ProfileView::class) {
+      // Props
+      Prop("userUUID") { view: ProfileView, v: String -> view.userUUID = v }
+      Prop("presentationType") { view: ProfileView, v: String? -> view.presentationType = v }
+      Prop("darkMode") { view: ProfileView, v: Boolean? -> view.darkMode = v ?: false }
+
+      // Events
+      Events("onAuthNeeded", "onCloseProfile")
+    }
+  }
+}
+

package/android/src/main/java/expo/modules/viafourasdk/ProfileView.kt

@@ -0,0 +1,134 @@
+package expo.modules.viafourasdk
+
+import android.content.Context
+import android.widget.FrameLayout
+import androidx.core.view.ViewCompat
+import androidx.fragment.app.Fragment
+import androidx.fragment.app.FragmentActivity
+import expo.modules.kotlin.AppContext
+import expo.modules.kotlin.viewevent.EventDispatcher
+import expo.modules.kotlin.views.ExpoView
+
+// Viafoura SDK imports
+import com.viafourasdk.src.fragments.profile.VFProfileFragment
+import com.viafourasdk.src.fragments.profile.VFProfileFragmentBuilder
+import com.viafourasdk.src.interfaces.VFActionsInterface
+import com.viafourasdk.src.interfaces.VFCustomUIInterface
+import com.viafourasdk.src.interfaces.VFLayoutInterface
+import com.viafourasdk.src.model.local.VFActionData
+import com.viafourasdk.src.model.local.VFActionType
+import com.viafourasdk.src.model.local.VFDefaultColors
+import com.viafourasdk.src.model.local.VFColors
+import com.viafourasdk.src.model.local.VFSettings
+import com.viafourasdk.src.model.local.VFProfilePresentationType
+import com.viafourasdk.src.model.local.VFTheme
+import java.util.UUID
+
+class ProfileView(context: Context, private val appContext: AppContext) :
+  ExpoView(context, appContext), VFCustomUIInterface, VFActionsInterface, VFLayoutInterface {
+
+  // Props
+  var userUUID: String? = null
+  var presentationType: String? = null // "profile" | "feed"
+  var darkMode: Boolean = false
+
+  // Events
+  private val onAuthNeeded by EventDispatcher()
+  private val onCloseProfile by EventDispatcher()
+
+  // Internals
+  private val container = FrameLayout(context).also {
+    it.layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
+    it.id = ViewCompat.generateViewId()
+    addView(it)
+  }
+  private var fragment: VFProfileFragment? = null
+
+  override fun onAttachedToWindow() {
+    super.onAttachedToWindow()
+    ensureFragment()
+  }
+
+  override fun onDetachedFromWindow() {
+    super.onDetachedFromWindow()
+    destroyFragment()
+  }
+
+  private fun currentActivity(): FragmentActivity? =
+    appContext.currentActivity as? FragmentActivity
+
+  private fun ensureFragment() {
+    if (fragment != null) return
+    val activity = currentActivity() ?: return
+
+    try {
+      val colors = VFColors(
+        VFDefaultColors.getInstance().colorPrimaryDefault(null),
+        VFDefaultColors.getInstance().colorPrimaryLightDefault(null)
+      )
+      val settings = VFSettings(colors)
+
+      val pres = when (presentationType) {
+        "feed" -> VFProfilePresentationType.feed
+        "profile" -> VFProfilePresentationType.profile
+        else -> null
+      }
+
+      val uuid = UUID.fromString(requireNotNull(userUUID))
+      val frag = VFProfileFragmentBuilder(uuid, pres, settings).build()
+      frag.setActionCallback(this)
+      frag.setCustomUICallback(this)
+      frag.setTheme(if (darkMode) VFTheme.dark else VFTheme.light)
+
+      activity.supportFragmentManager
+        .beginTransaction()
+        .replace(container.id, frag, container.id.toString())
+        .commit()
+
+      fragment = frag
+    } catch (_: Exception) {
+      // Swallow; invalid input
+    }
+  }
+
+  private fun destroyFragment() {
+    val activity = currentActivity() ?: return
+    val tag = container.id.toString()
+    val frag: Fragment? = activity.supportFragmentManager.findFragmentByTag(tag)
+    if (frag != null) {
+      activity.supportFragmentManager
+        .beginTransaction()
+        .remove(frag)
+        .commit()
+    }
+    fragment = null
+  }
+
+  // VFActionsInterface
+  override fun onNewAction(actionType: VFActionType, action: VFActionData) {
+    when (actionType) {
+      VFActionType.closeProfilePressed -> {
+        onCloseProfile(emptyMap<String, Any>())
+      }
+      VFActionType.authPressed -> {
+        onAuthNeeded(mapOf("requireLogin" to true))
+      }
+      else -> {}
+    }
+  }
+
+  // VFCustomUIInterface
+  override fun customizeView(
+    theme: com.viafourasdk.src.model.local.VFTheme?,
+    customViewType: com.viafourasdk.src.model.local.VFCustomViewType?,
+    view: android.view.View?
+  ) { /* no-op */ }
+
+  // VFLayoutInterface
+  override fun containerHeightUpdated(
+    fragment: com.viafourasdk.src.fragments.base.VFFragment,
+    containerId: String,
+    height: Int
+  ) { /* no-op for profile */ }
+}
+