Function connectCapacitor

packages/capacitor-plugin/src/connect.ts:22–89

(
	options: ConnectCapacitorOptions = {},
)

 *   in the background.
 */
export function connectCapacitor(
	options: ConnectCapacitorOptions = {},
): () => Promise<void> {
	const {
		pauseOnBackground = true,
		pauseAudio = true,
		forwardBackButton = true,
		// Return the promise from `App.exitApp()` so a rejection flows
		// through the same async-handling path used for user-provided
		// `onUnhandledBack` handlers.
		onUnhandledBack = () => App.exitApp(),
	} = options;

	const handles: CapacitorListenerHandle[] = [];

	if (pauseOnBackground) {
		handles.push(
			App.addListener("appStateChange", ({ isActive }) => {
				if (isActive) {
					state.resume(pauseAudio);
				} else {
					state.pause(pauseAudio);
				}
			}) as unknown as CapacitorListenerHandle,
		);
	}

	if (forwardBackButton) {
		handles.push(
			App.addListener("backButton", () => {
				if (!emitBackEvent()) {
					// `onUnhandledBack` is allowed to be async; wrap so a
					// thrown / rejected promise surfaces as a console
					// warning instead of an unhandled rejection.
					try {
						const ret = onUnhandledBack();
						if (ret && typeof ret.then === "function") {
							ret.catch((err: unknown) => {
								console.warn(
									"[@melonjs/capacitor-plugin] onUnhandledBack rejected:",
									err,
								);
							});
						}
					} catch (err) {
						console.warn(
							"[@melonjs/capacitor-plugin] onUnhandledBack threw:",
							err,
						);
					}
				}
			}) as unknown as CapacitorListenerHandle,
		);
	}

	return async () => {
		const results = await Promise.allSettled(handles.map((h) => h.remove()));
		handles.length = 0;