// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0

import { PlatformNotSupportedError } from '@aws-amplify/core/internals/utils';

import { SetBadgeCount } from '../types';

/**
 * Sets the current badge count (the number on the top right corner of your app's icon). Setting the badge count
 * to 0 (zero) will remove the badge from your app's icon. This function is safe to call (but will be ignored) even
 * when your React Native app is running on platforms where badges are not supported.
 *
 * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
 *
 * @throws platform: {@link PlatformNotSupportedError} - Thrown if called against an unsupported platform. Currently,
 * only React Native is supported by this API.
 * @example
 * ```ts
 * setBadgeCount(42);
 * ```
 */
export const setBadgeCount: SetBadgeCount = () => {
	throw new PlatformNotSupportedError();
};