react-native-nitro-player 1.7.0-alpha.4 → 1.7.0-alpha.5

package/nitrogen/generated/android/c++/JFunc_void_std__string.hpp

@@ -0,0 +1,76 @@
+///
+/// JFunc_void_std__string.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include <functional>
+
+#include <string>
+#include <functional>
+#include <NitroModules/JNICallable.hpp>
+
+namespace margelo::nitro::nitroplayer {
+
+  using namespace facebook;
+
+  /**
+   * Represents the Java/Kotlin callback `(action: String) -> Unit`.
+   * This can be passed around between C++ and Java/Kotlin.
+   */
+  struct JFunc_void_std__string: public jni::JavaClass<JFunc_void_std__string> {
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/nitroplayer/Func_void_std__string;";
+
+  public:
+    /**
+     * Invokes the function this `JFunc_void_std__string` instance holds through JNI.
+     */
+    void invoke(const std::string& action) const {
+      static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* action */)>("invoke");
+      method(self(), jni::make_jstring(action));
+    }
+  };
+
+  /**
+   * An implementation of Func_void_std__string that is backed by a C++ implementation (using `std::function<...>`)
+   */
+  class JFunc_void_std__string_cxx final: public jni::HybridClass<JFunc_void_std__string_cxx, JFunc_void_std__string> {
+  public:
+    static jni::local_ref<JFunc_void_std__string::javaobject> fromCpp(const std::function<void(const std::string& /* action */)>& func) {
+      return JFunc_void_std__string_cxx::newObjectCxxArgs(func);
+    }
+
+  public:
+    /**
+     * Invokes the C++ `std::function<...>` this `JFunc_void_std__string_cxx` instance holds.
+     */
+    void invoke_cxx(jni::alias_ref<jni::JString> action) {
+      _func(action->toStdString());
+    }
+
+  public:
+    [[nodiscard]]
+    inline const std::function<void(const std::string& /* action */)>& getFunction() const {
+      return _func;
+    }
+
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/nitroplayer/Func_void_std__string_cxx;";
+    static void registerNatives() {
+      registerHybrid({makeNativeMethod("invoke_cxx", JFunc_void_std__string_cxx::invoke_cxx)});
+    }
+
+  private:
+    explicit JFunc_void_std__string_cxx(const std::function<void(const std::string& /* action */)>& func): _func(func) { }
+
+  private:
+    friend HybridBase;
+    std::function<void(const std::string& /* action */)> _func;
+  };
+
+} // namespace margelo::nitro::nitroplayer

package/nitrogen/generated/android/c++/JFunc_void_std__string_std__string.hpp

@@ -0,0 +1,76 @@
+///
+/// JFunc_void_std__string_std__string.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include <functional>
+
+#include <string>
+#include <functional>
+#include <NitroModules/JNICallable.hpp>
+
+namespace margelo::nitro::nitroplayer {
+
+  using namespace facebook;
+
+  /**
+   * Represents the Java/Kotlin callback `(requestId: String, parentId: String) -> Unit`.
+   * This can be passed around between C++ and Java/Kotlin.
+   */
+  struct JFunc_void_std__string_std__string: public jni::JavaClass<JFunc_void_std__string_std__string> {
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/nitroplayer/Func_void_std__string_std__string;";
+
+  public:
+    /**
+     * Invokes the function this `JFunc_void_std__string_std__string` instance holds through JNI.
+     */
+    void invoke(const std::string& requestId, const std::string& parentId) const {
+      static const auto method = javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* requestId */, jni::alias_ref<jni::JString> /* parentId */)>("invoke");
+      method(self(), jni::make_jstring(requestId), jni::make_jstring(parentId));
+    }
+  };
+
+  /**
+   * An implementation of Func_void_std__string_std__string that is backed by a C++ implementation (using `std::function<...>`)
+   */
+  class JFunc_void_std__string_std__string_cxx final: public jni::HybridClass<JFunc_void_std__string_std__string_cxx, JFunc_void_std__string_std__string> {
+  public:
+    static jni::local_ref<JFunc_void_std__string_std__string::javaobject> fromCpp(const std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)>& func) {
+      return JFunc_void_std__string_std__string_cxx::newObjectCxxArgs(func);
+    }
+
+  public:
+    /**
+     * Invokes the C++ `std::function<...>` this `JFunc_void_std__string_std__string_cxx` instance holds.
+     */
+    void invoke_cxx(jni::alias_ref<jni::JString> requestId, jni::alias_ref<jni::JString> parentId) {
+      _func(requestId->toStdString(), parentId->toStdString());
+    }
+
+  public:
+    [[nodiscard]]
+    inline const std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)>& getFunction() const {
+      return _func;
+    }
+
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/nitroplayer/Func_void_std__string_std__string_cxx;";
+    static void registerNatives() {
+      registerHybrid({makeNativeMethod("invoke_cxx", JFunc_void_std__string_std__string_cxx::invoke_cxx)});
+    }
+
+  private:
+    explicit JFunc_void_std__string_std__string_cxx(const std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)>& func): _func(func) { }
+
+  private:
+    friend HybridBase;
+    std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)> _func;
+  };
+
+} // namespace margelo::nitro::nitroplayer

package/nitrogen/generated/android/c++/JHybridAndroidAutoMediaLibrarySpec.cpp

@@ -13,6 +13,11 @@
 #include <NitroModules/JPromise.hpp>
 #include <NitroModules/JUnit.hpp>
 #include <string>
+#include <functional>
+#include "JFunc_void_std__string_std__string.hpp"
+#include <NitroModules/JNICallable.hpp>
+#include "JFunc_void_std__string.hpp"
+#include "JFunc_void.hpp"
 
 namespace margelo::nitro::nitroplayer {
 
@@ -77,5 +82,29 @@ namespace margelo::nitro::nitroplayer {
       return __promise;
     }();
   }
+  void JHybridAndroidAutoMediaLibrarySpec::onLoadChildren(const std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)>& callback) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_std__string_std__string::javaobject> /* callback */)>("onLoadChildren_cxx");
+    method(_javaPart, JFunc_void_std__string_std__string_cxx::fromCpp(callback));
+  }
+  void JHybridAndroidAutoMediaLibrarySpec::onSearch(const std::function<void(const std::string& /* requestId */, const std::string& /* query */)>& callback) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_std__string_std__string::javaobject> /* callback */)>("onSearch_cxx");
+    method(_javaPart, JFunc_void_std__string_std__string_cxx::fromCpp(callback));
+  }
+  void JHybridAndroidAutoMediaLibrarySpec::resolveRequest(const std::string& requestId, const std::string& itemsJson) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* requestId */, jni::alias_ref<jni::JString> /* itemsJson */)>("resolveRequest");
+    method(_javaPart, jni::make_jstring(requestId), jni::make_jstring(itemsJson));
+  }
+  void JHybridAndroidAutoMediaLibrarySpec::setSessionButtons(const std::string& buttonsJson) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* buttonsJson */)>("setSessionButtons");
+    method(_javaPart, jni::make_jstring(buttonsJson));
+  }
+  void JHybridAndroidAutoMediaLibrarySpec::onSessionButtonPress(const std::function<void(const std::string& /* action */)>& callback) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_std__string::javaobject> /* callback */)>("onSessionButtonPress_cxx");
+    method(_javaPart, JFunc_void_std__string_cxx::fromCpp(callback));
+  }
+  void JHybridAndroidAutoMediaLibrarySpec::onPlaybackResumption(const std::function<void()>& callback) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void::javaobject> /* callback */)>("onPlaybackResumption_cxx");
+    method(_javaPart, JFunc_void_cxx::fromCpp(callback));
+  }
 
 } // namespace margelo::nitro::nitroplayer

package/nitrogen/generated/android/c++/JHybridAndroidAutoMediaLibrarySpec.hpp

@@ -56,6 +56,12 @@ namespace margelo::nitro::nitroplayer {
     // Methods
     std::shared_ptr<Promise<void>> setMediaLibrary(const std::string& libraryJson) override;
     std::shared_ptr<Promise<void>> clearMediaLibrary() override;
+    void onLoadChildren(const std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)>& callback) override;
+    void onSearch(const std::function<void(const std::string& /* requestId */, const std::string& /* query */)>& callback) override;
+    void resolveRequest(const std::string& requestId, const std::string& itemsJson) override;
+    void setSessionButtons(const std::string& buttonsJson) override;
+    void onSessionButtonPress(const std::function<void(const std::string& /* action */)>& callback) override;
+    void onPlaybackResumption(const std::function<void()>& callback) override;
 
   private:
     jni::global_ref<JHybridAndroidAutoMediaLibrarySpec::JavaPart> _javaPart;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroplayer/Func_void.kt

@@ -0,0 +1,80 @@
+///
+/// Func_void.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.nitroplayer
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import dalvik.annotation.optimization.FastNative
+
+
+/**
+ * Represents the JavaScript callback `() => void`.
+ * This can be either implemented in C++ (in which case it might be a callback coming from JS),
+ * or in Kotlin/Java (in which case it is a native callback).
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType")
+fun interface Func_void: () -> Unit {
+  /**
+   * Call the given JS callback.
+   * @throws Throwable if the JS function itself throws an error, or if the JS function/runtime has already been deleted.
+   */
+  @DoNotStrip
+  @Keep
+  override fun invoke(): Unit
+}
+
+/**
+ * Represents the JavaScript callback `() => void`.
+ * This is implemented in C++, via a `std::function<...>`.
+ * The callback might be coming from JS.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "FunctionName",
+  "ConvertSecondaryConstructorToPrimary", "ClassName", "LocalVariableName",
+)
+class Func_void_cxx: Func_void {
+  @DoNotStrip
+  @Keep
+  private val mHybridData: HybridData
+
+  @DoNotStrip
+  @Keep
+  private constructor(hybridData: HybridData) {
+    mHybridData = hybridData
+  }
+
+  @DoNotStrip
+  @Keep
+  override fun invoke(): Unit
+    = invoke_cxx()
+
+  @FastNative
+  private external fun invoke_cxx(): Unit
+}
+
+/**
+ * Represents the JavaScript callback `() => void`.
+ * This is implemented in Java/Kotlin, via a `() -> Unit`.
+ * The callback is always coming from native.
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType", "unused")
+class Func_void_java(private val function: () -> Unit): Func_void {
+  @DoNotStrip
+  @Keep
+  override fun invoke(): Unit {
+    return this.function()
+  }
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroplayer/Func_void_std__string.kt

@@ -0,0 +1,80 @@
+///
+/// Func_void_std__string.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.nitroplayer
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import dalvik.annotation.optimization.FastNative
+
+
+/**
+ * Represents the JavaScript callback `(action: string) => void`.
+ * This can be either implemented in C++ (in which case it might be a callback coming from JS),
+ * or in Kotlin/Java (in which case it is a native callback).
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType")
+fun interface Func_void_std__string: (String) -> Unit {
+  /**
+   * Call the given JS callback.
+   * @throws Throwable if the JS function itself throws an error, or if the JS function/runtime has already been deleted.
+   */
+  @DoNotStrip
+  @Keep
+  override fun invoke(action: String): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(action: string) => void`.
+ * This is implemented in C++, via a `std::function<...>`.
+ * The callback might be coming from JS.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "FunctionName",
+  "ConvertSecondaryConstructorToPrimary", "ClassName", "LocalVariableName",
+)
+class Func_void_std__string_cxx: Func_void_std__string {
+  @DoNotStrip
+  @Keep
+  private val mHybridData: HybridData
+
+  @DoNotStrip
+  @Keep
+  private constructor(hybridData: HybridData) {
+    mHybridData = hybridData
+  }
+
+  @DoNotStrip
+  @Keep
+  override fun invoke(action: String): Unit
+    = invoke_cxx(action)
+
+  @FastNative
+  private external fun invoke_cxx(action: String): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(action: string) => void`.
+ * This is implemented in Java/Kotlin, via a `(String) -> Unit`.
+ * The callback is always coming from native.
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType", "unused")
+class Func_void_std__string_java(private val function: (String) -> Unit): Func_void_std__string {
+  @DoNotStrip
+  @Keep
+  override fun invoke(action: String): Unit {
+    return this.function(action)
+  }
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroplayer/Func_void_std__string_std__string.kt

@@ -0,0 +1,80 @@
+///
+/// Func_void_std__string_std__string.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.nitroplayer
+
+import androidx.annotation.Keep
+import com.facebook.jni.HybridData
+import com.facebook.proguard.annotations.DoNotStrip
+import dalvik.annotation.optimization.FastNative
+
+
+/**
+ * Represents the JavaScript callback `(requestId: string, parentId: string) => void`.
+ * This can be either implemented in C++ (in which case it might be a callback coming from JS),
+ * or in Kotlin/Java (in which case it is a native callback).
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType")
+fun interface Func_void_std__string_std__string: (String, String) -> Unit {
+  /**
+   * Call the given JS callback.
+   * @throws Throwable if the JS function itself throws an error, or if the JS function/runtime has already been deleted.
+   */
+  @DoNotStrip
+  @Keep
+  override fun invoke(requestId: String, parentId: String): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(requestId: string, parentId: string) => void`.
+ * This is implemented in C++, via a `std::function<...>`.
+ * The callback might be coming from JS.
+ */
+@DoNotStrip
+@Keep
+@Suppress(
+  "KotlinJniMissingFunction", "unused",
+  "RedundantSuppression", "RedundantUnitReturnType", "FunctionName",
+  "ConvertSecondaryConstructorToPrimary", "ClassName", "LocalVariableName",
+)
+class Func_void_std__string_std__string_cxx: Func_void_std__string_std__string {
+  @DoNotStrip
+  @Keep
+  private val mHybridData: HybridData
+
+  @DoNotStrip
+  @Keep
+  private constructor(hybridData: HybridData) {
+    mHybridData = hybridData
+  }
+
+  @DoNotStrip
+  @Keep
+  override fun invoke(requestId: String, parentId: String): Unit
+    = invoke_cxx(requestId,parentId)
+
+  @FastNative
+  private external fun invoke_cxx(requestId: String, parentId: String): Unit
+}
+
+/**
+ * Represents the JavaScript callback `(requestId: string, parentId: string) => void`.
+ * This is implemented in Java/Kotlin, via a `(String, String) -> Unit`.
+ * The callback is always coming from native.
+ */
+@DoNotStrip
+@Keep
+@Suppress("ClassName", "RedundantUnitReturnType", "unused")
+class Func_void_std__string_std__string_java(private val function: (String, String) -> Unit): Func_void_std__string_std__string {
+  @DoNotStrip
+  @Keep
+  override fun invoke(requestId: String, parentId: String): Unit {
+    return this.function(requestId, parentId)
+  }
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroplayer/HybridAndroidAutoMediaLibrarySpec.kt

@@ -36,6 +36,50 @@ abstract class HybridAndroidAutoMediaLibrarySpec: HybridObject() {
   @DoNotStrip
   @Keep
   abstract fun clearMediaLibrary(): Promise<Unit>
+  
+  abstract fun onLoadChildren(callback: (requestId: String, parentId: String) -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun onLoadChildren_cxx(callback: Func_void_std__string_std__string): Unit {
+    val __result = onLoadChildren(callback)
+    return __result
+  }
+  
+  abstract fun onSearch(callback: (requestId: String, query: String) -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun onSearch_cxx(callback: Func_void_std__string_std__string): Unit {
+    val __result = onSearch(callback)
+    return __result
+  }
+  
+  @DoNotStrip
+  @Keep
+  abstract fun resolveRequest(requestId: String, itemsJson: String): Unit
+  
+  @DoNotStrip
+  @Keep
+  abstract fun setSessionButtons(buttonsJson: String): Unit
+  
+  abstract fun onSessionButtonPress(callback: (action: String) -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun onSessionButtonPress_cxx(callback: Func_void_std__string): Unit {
+    val __result = onSessionButtonPress(callback)
+    return __result
+  }
+  
+  abstract fun onPlaybackResumption(callback: () -> Unit): Unit
+  
+  @DoNotStrip
+  @Keep
+  private fun onPlaybackResumption_cxx(callback: Func_void): Unit {
+    val __result = onPlaybackResumption(callback)
+    return __result
+  }
 
   // Default implementation of `HybridObject.toString()`
   override fun toString(): String {

package/nitrogen/generated/shared/c++/HybridAndroidAutoMediaLibrarySpec.cpp

@@ -16,6 +16,12 @@ namespace margelo::nitro::nitroplayer {
     registerHybrids(this, [](Prototype& prototype) {
       prototype.registerHybridMethod("setMediaLibrary", &HybridAndroidAutoMediaLibrarySpec::setMediaLibrary);
       prototype.registerHybridMethod("clearMediaLibrary", &HybridAndroidAutoMediaLibrarySpec::clearMediaLibrary);
+      prototype.registerHybridMethod("onLoadChildren", &HybridAndroidAutoMediaLibrarySpec::onLoadChildren);
+      prototype.registerHybridMethod("onSearch", &HybridAndroidAutoMediaLibrarySpec::onSearch);
+      prototype.registerHybridMethod("resolveRequest", &HybridAndroidAutoMediaLibrarySpec::resolveRequest);
+      prototype.registerHybridMethod("setSessionButtons", &HybridAndroidAutoMediaLibrarySpec::setSessionButtons);
+      prototype.registerHybridMethod("onSessionButtonPress", &HybridAndroidAutoMediaLibrarySpec::onSessionButtonPress);
+      prototype.registerHybridMethod("onPlaybackResumption", &HybridAndroidAutoMediaLibrarySpec::onPlaybackResumption);
     });
   }
 

package/nitrogen/generated/shared/c++/HybridAndroidAutoMediaLibrarySpec.hpp

@@ -17,6 +17,7 @@
 
 #include <NitroModules/Promise.hpp>
 #include <string>
+#include <functional>
 
 namespace margelo::nitro::nitroplayer {
 
@@ -51,6 +52,12 @@ namespace margelo::nitro::nitroplayer {
       // Methods
       virtual std::shared_ptr<Promise<void>> setMediaLibrary(const std::string& libraryJson) = 0;
       virtual std::shared_ptr<Promise<void>> clearMediaLibrary() = 0;
+      virtual void onLoadChildren(const std::function<void(const std::string& /* requestId */, const std::string& /* parentId */)>& callback) = 0;
+      virtual void onSearch(const std::function<void(const std::string& /* requestId */, const std::string& /* query */)>& callback) = 0;
+      virtual void resolveRequest(const std::string& requestId, const std::string& itemsJson) = 0;
+      virtual void setSessionButtons(const std::string& buttonsJson) = 0;
+      virtual void onSessionButtonPress(const std::function<void(const std::string& /* action */)>& callback) = 0;
+      virtual void onPlaybackResumption(const std::function<void()>& callback) = 0;
 
     protected:
       // Hybrid Setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-player",
-  "version": "1.7.0-alpha.4",
+  "version": "1.7.0-alpha.5",
   "description": "A powerful audio player library for React Native with playlist management, playback controls, and support for Android Auto and CarPlay",
   "main": "lib/index",
   "module": "lib/index",

package/src/index.ts

@@ -1,7 +1,7 @@
 // TODO: Export all HybridObjects here for the user
 
 import { NitroModules } from 'react-native-nitro-modules'
-import { Platform } from 'react-native'
+import { AppRegistry, Platform } from 'react-native'
 import type {
   PlayerQueue as PlayerQueueType,
   TrackPlayer as TrackPlayerType,
@@ -13,6 +13,14 @@ import type { Cast as CastType } from './specs/Cast.nitro'
 import type { DownloadManager as DownloadManagerType } from './specs/DownloadManager.nitro'
 import type { Equalizer as EqualizerType } from './specs/Equalizer.nitro'
 
+// Native runs this while it needs JS without a resumed activity (car, screen off): it keeps JS timers ticking
+if (Platform.OS === 'android') {
+  AppRegistry.registerHeadlessTask(
+    'NitroPlayerKeepAlive',
+    () => () => new Promise<void>(() => {})
+  )
+}
+
 export const PlayerQueue =
   NitroModules.createHybridObject<PlayerQueueType>('PlayerQueue')
 export const TrackPlayer =

package/src/specs/AndroidAutoMediaLibrary.nitro.ts

@@ -20,4 +20,22 @@ export interface AndroidAutoMediaLibrary extends HybridObject<{
    * Falls back to showing all playlists
    */
   clearMediaLibrary(): Promise<void>
+
+  /** Android Auto opened a folder published with `children: []`; answer with {@link resolveRequest}. */
+  onLoadChildren(callback: (requestId: string, parentId: string) => void): void
+
+  /** A car search, or a voice request the loaded playlists cannot match; answer with {@link resolveRequest}. */
+  onSearch(callback: (requestId: string, query: string) => void): void
+
+  /** Answers {@link onLoadChildren} / {@link onSearch} with a JSON array of MediaItem. */
+  resolveRequest(requestId: string, itemsJson: string): void
+
+  /** Replaces the session buttons with a JSON array of SessionButton. */
+  setSessionButtons(buttonsJson: string): void
+
+  /** Called with the button's `action` when a session button is pressed. */
+  onSessionButtonPress(callback: (action: string) => void): void
+
+  /** A controller asked to play with nothing loaded (car auto-play, play on connect); load the last queue now. */
+  onPlaybackResumption(callback: () => void): void
 }

package/src/types/AndroidAutoMediaLibrary.ts

@@ -38,6 +38,9 @@ export interface MediaItem {
 
   /** Layout type for folder items (overrides library default) */
   layoutType?: LayoutType
+
+  /** Group header; contiguous items sharing one are listed under it */
+  groupTitle?: string
 }
 
 /**
@@ -56,3 +59,24 @@ export interface MediaLibrary {
   /** Optional app icon URL */
   appIconUrl?: string
 }
+
+export type SessionButtonIcon =
+  | 'heart'
+  | 'heart_filled'
+  | 'star'
+  | 'star_filled'
+  | 'thumb_up'
+  | 'thumb_up_filled'
+  | 'plus'
+  | 'check'
+
+/** App-defined button beside the transport controls in Android Auto and the notification */
+export interface SessionButton {
+  /** Passed to the press callback */
+  action: string
+
+  /** Accessibility label */
+  title: string
+
+  icon: SessionButtonIcon
+}