SDK parity: Auth, Firestore, Analytics, Remote Config (#1)

## Summary
- **Auth:** emulator support, reauthenticate, auth state listener, ID
tokens, profile/password update, reload user, unlink provider (9
methods, 5 signals)
- **Firestore:** emulator support, collection listeners, WriteBatch
(create/set/update/delete/commit), transactions, FieldValue helpers —
serverTimestamp, arrayUnion, arrayRemove, increment, deleteField (14
methods, 3 signals)
- **Analytics:** default event params, app instance ID (async w/
signal), consent management, session timeout (4 methods, 1 signal)
- **Remote Config:** separate fetch/activate, configurable fetch
interval & timeout, typed getters (getAll, getJson), value source, fetch
status/time, real-time update listener (11 methods, 2 signals)
- **Docs:** updated authentication.md and firestore.md, added
analytics.md and remote_config.md
- **Demo scenes:** added 33 new buttons across all 4 modules to test
every new method; reordered Remote Config and Analytics demos to match
iOS plugin layout for consistency

Brings the Android plugin to feature parity with the iOS plugin across
all four modules.

## Test plan
- [x] `./gradlew assemble` compiles without errors
- [x] Auth: test emulator, reauthenticate, auth state listener, ID
token, profile update, password update, reload, unlink
- [x] Firestore: test emulator, collection listener, query documents,
batch write + commit, transaction, server timestamp, increment
- [x] Analytics: test default event params, get instance ID, consent
grant/deny, session timeout
- [x] Remote Config: test separate fetch/activate, dev interval, fetch
timeout, getAll, getJson, value source, fetch status, real-time listener
- [x] Verify demo button ordering matches iOS plugin demo layout

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: DiplomaticRobot

.gitignore

@@ -33,4 +33,4 @@ google-services.json
 *.hprof
 
 # Claude Code
-.claude/
+.claude/settings.local.json

CLAUDE.md

@@ -0,0 +1,64 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+GodotFirebaseAndroid is an Android plugin for Godot Engine (4.2+) that bridges GDScript and the native Android Firebase SDK. It follows a dual-layer architecture: Kotlin classes handle Firebase SDK interaction and async operations on the Android side, while thin GDScript wrappers in `firebase/export_scripts_template/` provide the developer-facing API via signals.
+
+**Communication flow:** GDScript → Module .gd wrapper → Kotlin plugin singleton → Firebase SDK → Firebase Backend. All long-running operations use Godot signals (not blocking calls).
+
+## Build Commands
+
+```bash
+./gradlew assemble    # Build debug+release AARs, copy to demo/addons/
+./gradlew build       # Build AARs without copying
+./gradlew clean       # Clean build outputs and demo addons
+```
+
+The build produces `firebase-debug.aar` and `firebase-release.aar`, copies them to `demo/addons/GodotFirebaseAndroid/bin/`, and copies `export_scripts_template/` into the demo addon directory.
+
+There are no tests or linters configured.
+
+## Architecture
+
+### Kotlin layer (`firebase/src/main/java/org/godotengine/plugin/firebase/`)
+
+- **FirebasePlugin.kt** — Main Godot plugin class. Registers all signals and delegates calls to module classes. All module classes are instantiated here and receive the plugin reference.
+- **Authentication.kt** — Anonymous, email/password, Google Sign-In, email verification, password reset, account linking.
+- **Firestore.kt** — CRUD operations, collection queries, real-time listeners.
+- **RealtimeDatabase.kt** — Path-based CRUD, real-time listeners.
+- **CloudStorage.kt** — Upload/download, metadata, file listing.
+- **Analytics.kt** — Event logging, user properties/ID.
+- **RemoteConfig.kt** — Fetch, activate, typed getters.
+
+Each Kotlin module emits signals back to Godot via `emitSignal()` for async results.
+
+### GDScript layer (`firebase/export_scripts_template/`)
+
+- **Firebase.gd** — Autoloaded singleton that initializes module wrappers.
+- **modules/*.gd** — One wrapper per Firebase module. Each connects to the Kotlin plugin singleton's signals and exposes snake_case methods.
+- **export_plugin.gd** — Godot export plugin that handles adding dependencies and `google-services.json` during Android export.
+- **plugin.cfg** — Godot plugin descriptor.
+
+### Demo project (`demo/`)
+
+Contains a Godot project with one scene per module for manual testing. The demo's `addons/` directory is auto-populated by the build.
+
+## Key Details
+
+- **Godot version:** 4.6+ (uses Godot Android plugin v2 API)
+- **Android:** minSdk 24, targetSdk 34
+- **Kotlin DSL** for all Gradle files
+- **No `google-services.json` in repo** — must be supplied per-project in `demo/android/build/`
+- **Fork:** origin is SomniGameStudios, upstream is syntaxerror247/GodotFirebaseAndroid
+- **PRs:** Always open pull requests against the fork repo (`SomniGameStudios/godot-firebase-android`), never against upstream
+
+## Adding a New Firebase Module
+
+1. Create Kotlin class in `firebase/src/main/java/.../firebase/` implementing the Firebase SDK calls with `emitSignal()` callbacks
+2. Register signals and expose methods in `FirebasePlugin.kt`
+3. Create GDScript wrapper in `firebase/export_scripts_template/modules/`
+4. Initialize the module in `Firebase.gd`
+5. Add Firebase dependency in `firebase/build.gradle.kts`
+6. Add demo scene in `demo/scenes/`

README.md

@@ -5,10 +5,12 @@ It supports Godot 4.2+
 
 ## Features
 
-- [x] Firebase Authentication (Anonymous, Email/Password, Google Sign-In)
-- [x] Cloud Firestore
+- [x] Firebase Authentication (Anonymous, Email/Password, Google Sign-In, reauthentication, profile management, auth state listener)
+- [x] Cloud Firestore (CRUD, queries, real-time listeners, WriteBatch, transactions, FieldValue helpers)
 - [x] Realtime Database
 - [x] Cloud Storage
+- [x] Firebase Analytics (event logging, user properties, consent management, session timeout)
+- [x] Remote Config (fetch/activate, typed getters, real-time updates, value source tracking)
 - [ ] Cloud Messaging (coming soon)
 
 ---

demo/scenes/analytics.gd

@@ -3,15 +3,15 @@ extends Control
 @onready var output: RichTextLabel = %OutputPanel
 var _collection_enabled := true
 
-
 func _notification(what: int) -> void:
 	if what == NOTIFICATION_WM_GO_BACK_REQUEST:
 		get_tree().change_scene_to_packed(load("res://main.tscn"))
 
-
 func _ready() -> void:
+	Firebase.analytics.app_instance_id_result.connect(_on_instance_id)
 	_log("platform", "Android")
 
+# --- Events ---
 
 func _on_log_event_pressed() -> void:
 	_log("action", "Logging custom event 'test_event'...")
@@ -22,7 +22,6 @@ func _on_log_event_pressed() -> void:
 	})
 	_log("done", "Event logged (check Firebase Console)")
 
-
 func _on_log_purchase_pressed() -> void:
 	_log("action", "Logging purchase event...")
 	Firebase.analytics.log_event("purchase", {
@@ -32,31 +31,64 @@ func _on_log_purchase_pressed() -> void:
 	})
 	_log("done", "Purchase event logged")
 
+# --- User ---
 
 func _on_set_user_id_pressed() -> void:
 	_log("action", "Setting user ID to 'test_user_123'...")
 	Firebase.analytics.set_user_id("test_user_123")
 	_log("done", "User ID set")
 
-
 func _on_set_user_property_pressed() -> void:
 	_log("action", "Setting user property 'favorite_food' = 'pizza'...")
 	Firebase.analytics.set_user_property("favorite_food", "pizza")
 	_log("done", "User property set")
 
+func _on_set_default_params_pressed() -> void:
+	_log("action", "Setting default event parameters...")
+	Firebase.analytics.set_default_event_parameters({
+		"app_version": "1.0.0",
+		"platform": "android"
+	})
+	_log("done", "Default parameters set")
+
+# --- Diagnostics ---
+
+func _on_get_instance_id_pressed() -> void:
+	_log("action", "Requesting app instance ID...")
+	Firebase.analytics.get_app_instance_id()
+
+func _on_instance_id(id: String) -> void:
+	_log("instance_id", id if not id.is_empty() else "(empty)")
 
 func _on_reset_analytics_pressed() -> void:
 	_log("action", "Resetting analytics data...")
 	Firebase.analytics.reset_analytics_data()
 	_log("done", "Analytics data reset")
 
-
 func _on_toggle_collection_pressed() -> void:
 	_collection_enabled = not _collection_enabled
 	_log("action", "Setting analytics collection to %s..." % str(_collection_enabled))
 	Firebase.analytics.set_analytics_collection_enabled(_collection_enabled)
 	_log("done", "Collection %s" % ("enabled" if _collection_enabled else "disabled"))
 
+# --- Consent & Session (Android-only) ---
+
+func _on_set_consent_granted_pressed() -> void:
+	_log("action", "Granting all consent...")
+	Firebase.analytics.set_consent(true, true, true, true)
+	_log("done", "All consent granted")
+
+func _on_set_consent_denied_pressed() -> void:
+	_log("action", "Denying all consent...")
+	Firebase.analytics.set_consent(false, false, false, false)
+	_log("done", "All consent denied")
+
+func _on_set_session_timeout_pressed() -> void:
+	_log("action", "Setting session timeout to 300s...")
+	Firebase.analytics.set_session_timeout(300)
+	_log("done", "Session timeout set to 300s")
+
+# --- Logging ---
 
 func _log(context: String, message: String) -> void:
 	var t = Time.get_time_string_from_system()
@@ -68,6 +100,5 @@ func _log(context: String, message: String) -> void:
 		return
 	output.scroll_to_line(output.get_line_count())
 
-
 func _on_clear_output_pressed() -> void:
 	output.text = ""

demo/scenes/analytics.tscn

@@ -29,7 +29,7 @@ corner_radius_top_right = 20
 corner_radius_bottom_right = 20
 corner_radius_bottom_left = 20
 
-[node name="Analytics" type="Control" unique_id=2105854314]
+[node name="Analytics" type="Control"]
 layout_mode = 3
 anchors_preset = 15
 anchor_right = 1.0
@@ -38,7 +38,7 @@ grow_horizontal = 2
 grow_vertical = 2
 script = ExtResource("1_analytics")
 
-[node name="ColorRect" type="ColorRect" parent="." unique_id=1309976234]
+[node name="ColorRect" type="ColorRect" parent="."]
 layout_mode = 1
 anchors_preset = 15
 anchor_right = 1.0
@@ -47,7 +47,7 @@ grow_horizontal = 2
 grow_vertical = 2
 color = Color(0.133333, 0.133333, 0.133333, 1)
 
-[node name="MarginContainer" type="MarginContainer" parent="." unique_id=1264128402]
+[node name="MarginContainer" type="MarginContainer" parent="."]
 layout_mode = 1
 anchors_preset = 15
 anchor_right = 1.0
@@ -59,22 +59,22 @@ theme_override_constants/margin_top = 20
 theme_override_constants/margin_right = 40
 theme_override_constants/margin_bottom = 20
 
-[node name="VBoxContainer" type="VBoxContainer" parent="MarginContainer" unique_id=1150462527]
+[node name="VBoxContainer" type="VBoxContainer" parent="MarginContainer"]
 layout_mode = 2
 theme_override_constants/separation = 10
 
-[node name="ScrollContainer" type="ScrollContainer" parent="MarginContainer/VBoxContainer" unique_id=1508340636]
+[node name="ScrollContainer" type="ScrollContainer" parent="MarginContainer/VBoxContainer"]
 layout_mode = 2
 size_flags_vertical = 3
 horizontal_scroll_mode = 0
 script = ExtResource("2_scroll")
 
-[node name="ButtonContainer" type="VBoxContainer" parent="MarginContainer/VBoxContainer/ScrollContainer" unique_id=1513966250]
+[node name="ButtonContainer" type="VBoxContainer" parent="MarginContainer/VBoxContainer/ScrollContainer"]
 layout_mode = 2
 size_flags_horizontal = 3
 theme_override_constants/separation = 20
 
-[node name="log_event" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer" unique_id=385026694]
+[node name="log_event" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
 custom_minimum_size = Vector2(120, 60)
 layout_mode = 2
 theme_override_font_sizes/font_size = 32
@@ -84,7 +84,7 @@ theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
 theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
 text = "Log Custom Event"
 
-[node name="log_purchase" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer" unique_id=1360381640]
+[node name="log_purchase" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
 custom_minimum_size = Vector2(120, 60)
 layout_mode = 2
 theme_override_font_sizes/font_size = 32
@@ -94,7 +94,7 @@ theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
 theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
 text = "Log Purchase Event"
 
-[node name="set_user_id" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer" unique_id=1510039719]
+[node name="set_user_id" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
 custom_minimum_size = Vector2(120, 60)
 layout_mode = 2
 theme_override_font_sizes/font_size = 32
@@ -104,7 +104,7 @@ theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
 theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
 text = "Set User ID"
 
-[node name="set_user_property" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer" unique_id=196146543]
+[node name="set_user_property" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
 custom_minimum_size = Vector2(120, 60)
 layout_mode = 2
 theme_override_font_sizes/font_size = 32
@@ -114,7 +114,27 @@ theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
 theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
 text = "Set User Property"
 
-[node name="reset_analytics" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer" unique_id=1190070255]
+[node name="set_default_params" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
+custom_minimum_size = Vector2(120, 60)
+layout_mode = 2
+theme_override_font_sizes/font_size = 32
+theme_override_styles/normal = SubResource("StyleBoxFlat_normal")
+theme_override_styles/pressed = SubResource("StyleBoxFlat_pressed")
+theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
+theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
+text = "Set Default Params"
+
+[node name="get_instance_id" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
+custom_minimum_size = Vector2(120, 60)
+layout_mode = 2
+theme_override_font_sizes/font_size = 32
+theme_override_styles/normal = SubResource("StyleBoxFlat_normal")
+theme_override_styles/pressed = SubResource("StyleBoxFlat_pressed")
+theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
+theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
+text = "Get Instance ID"
+
+[node name="reset_analytics" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
 custom_minimum_size = Vector2(120, 60)
 layout_mode = 2
 theme_override_font_sizes/font_size = 32
@@ -124,7 +144,7 @@ theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
 theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
 text = "Reset Analytics"
 
-[node name="toggle_collection" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer" unique_id=2116133267]
+[node name="toggle_collection" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
 custom_minimum_size = Vector2(120, 60)
 layout_mode = 2
 theme_override_font_sizes/font_size = 32
@@ -134,14 +154,44 @@ theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
 theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
 text = "Toggle Collection"
 
-[node name="OutputPanel" type="RichTextLabel" parent="MarginContainer/VBoxContainer" unique_id=1459866916]
+[node name="set_consent_granted" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
+custom_minimum_size = Vector2(120, 60)
+layout_mode = 2
+theme_override_font_sizes/font_size = 32
+theme_override_styles/normal = SubResource("StyleBoxFlat_normal")
+theme_override_styles/pressed = SubResource("StyleBoxFlat_pressed")
+theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
+theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
+text = "Grant All Consent"
+
+[node name="set_consent_denied" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
+custom_minimum_size = Vector2(120, 60)
+layout_mode = 2
+theme_override_font_sizes/font_size = 32
+theme_override_styles/normal = SubResource("StyleBoxFlat_normal")
+theme_override_styles/pressed = SubResource("StyleBoxFlat_pressed")
+theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
+theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
+text = "Deny All Consent"
+
+[node name="set_session_timeout" type="Button" parent="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer"]
+custom_minimum_size = Vector2(120, 60)
+layout_mode = 2
+theme_override_font_sizes/font_size = 32
+theme_override_styles/normal = SubResource("StyleBoxFlat_normal")
+theme_override_styles/pressed = SubResource("StyleBoxFlat_pressed")
+theme_override_styles/hover = SubResource("StyleBoxFlat_normal")
+theme_override_styles/focus = SubResource("StyleBoxFlat_focus")
+text = "Set Session Timeout (300s)"
+
+[node name="OutputPanel" type="RichTextLabel" parent="MarginContainer/VBoxContainer"]
 unique_name_in_owner = true
 custom_minimum_size = Vector2(0, 200)
 layout_mode = 2
 theme_override_font_sizes/normal_font_size = 24
 scroll_following = true
 
-[node name="clear_output" type="Button" parent="MarginContainer/VBoxContainer" unique_id=797506553]
+[node name="clear_output" type="Button" parent="MarginContainer/VBoxContainer"]
 custom_minimum_size = Vector2(0, 50)
 layout_mode = 2
 theme_override_font_sizes/font_size = 24
@@ -155,6 +205,11 @@ text = "Clear Output"
 [connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/log_purchase" to="." method="_on_log_purchase_pressed"]
 [connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/set_user_id" to="." method="_on_set_user_id_pressed"]
 [connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/set_user_property" to="." method="_on_set_user_property_pressed"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/set_default_params" to="." method="_on_set_default_params_pressed"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/get_instance_id" to="." method="_on_get_instance_id_pressed"]
 [connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/reset_analytics" to="." method="_on_reset_analytics_pressed"]
 [connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/toggle_collection" to="." method="_on_toggle_collection_pressed"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/set_consent_granted" to="." method="_on_set_consent_granted_pressed"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/set_consent_denied" to="." method="_on_set_consent_denied_pressed"]
+[connection signal="pressed" from="MarginContainer/VBoxContainer/ScrollContainer/ButtonContainer/set_session_timeout" to="." method="_on_set_session_timeout_pressed"]
 [connection signal="pressed" from="MarginContainer/VBoxContainer/clear_output" to="." method="_on_clear_output_pressed"]