appsonair-react-native-apppush 0.0.1-alpha

package/lib/typescript/commonjs/src/NativeAppsonairApppush.d.ts

@@ -0,0 +1,134 @@
+import { type TurboModule } from 'react-native';
+import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+/**
+ * Codegen spec for the AppsOnAir Push TurboModule.
+ *
+ * This file is consumed by React Native Codegen and compiles to
+ * `NativeAppsonairApppushSpec` — a Java abstract class and an ObjC protocol that
+ * the native modules implement under the New Architecture. On the Old
+ * Architecture the same JS object is served by the legacy bridge module, which
+ * exposes an identical method set (see android/src/oldarch and the
+ * `RCT_NEW_ARCH_ENABLED` guard in ios/AppsonairReactNativeApppush.mm).
+ *
+ * Constraints this file must respect — codegen rejects or silently mistypes
+ * anything else, so do not "improve" the signatures below:
+ *
+ *   - Parameters and returns are primitives, nullable primitives, `Array<T>`,
+ *     or `UnsafeObject`. Named object types are avoided deliberately -- see the
+ *     note above `Spec`.
+ *   - No string-literal unions. `logLevel`, `importance` and `environment` are
+ *     plain `string` here and are narrowed to their union types in `index.tsx`,
+ *     which is the type-safe surface consumers actually import.
+ *   - No `Record<K, V>` — use `UnsafeObject`.
+ *   - Methods are `Promise`-returning or `void`; there are no sync methods, so
+ *     the module never blocks the JS thread.
+ */
+/**
+ * Object parameters are `UnsafeObject`, not named object types, and that is
+ * load-bearing rather than lazy.
+ *
+ * Codegen compiles a named object type into a generated C++ struct, so the
+ * ObjC signature becomes `JS::NativeAppsonairApppush::NativePushConfig &` under the
+ * New Architecture while the Old Architecture bridge still passes
+ * `NSDictionary *`. The two would no longer share a selector, and
+ * ios/AppsonairReactNativeApppush.mm could not implement both from one method body.
+ * `UnsafeObject` maps to `NSDictionary *` on both, and to `ReadableMap` on both
+ * on Android.
+ *
+ * The shapes these accept are typed for consumers in src/types.ts -- `PushConfig`,
+ * `NotificationChannelConfig` and `BackgroundSyncOptions` -- which is the surface
+ * anyone actually imports. Nothing here is untyped at the call site.
+ */
+export interface Spec extends TurboModule {
+    /**
+     * Parity A1/A2: the native signatures share zero parameters — iOS takes
+     * `(debug:swizzle:)`, Android takes `(context, debug)`. Each
+     * bridge supplies what its platform needs; `Context` is never exposed to JS.
+     */
+    initialize(config: UnsafeObject): Promise<void>;
+    getDeviceId(): Promise<string>;
+    getSubscriptionId(): Promise<string | null>;
+    setSubscriptionId(id: string): Promise<void>;
+    getExternalId(): Promise<string | null>;
+    login(externalId: string): Promise<void>;
+    logout(): Promise<void>;
+    /** APNs hex token on iOS, FCM token on Android. `null` before registration. */
+    getToken(): Promise<string | null>;
+    /** Parity D4: Android/FCM only. Resolves immediately as a no-op on iOS. */
+    refreshToken(): Promise<void>;
+    /** Parity B2: Android only. Resolves `null` on iOS. */
+    getInstallationId(): Promise<string | null>;
+    /** Parity C8: iOS only. Resolves `null` on Android. */
+    getApnsEnvironment(): Promise<string | null>;
+    requestPermission(fallbackToSettings: boolean): Promise<boolean>;
+    getPermission(): Promise<boolean>;
+    getPermissionStatus(): Promise<string>;
+    canRequestPermission(): Promise<boolean>;
+    /** Parity E5: iOS only. Resolves as a no-op on Android. */
+    registerForProvisionalAuthorization(): Promise<void>;
+    clearAllNotifications(): Promise<void>;
+    removeNotification(notificationId: string): Promise<void>;
+    removeNotifications(notificationIds: Array<string>): Promise<void>;
+    /** Parity F3: Android only. Resolves as a no-op on iOS. */
+    removeNotificationGroup(groupKey: string): Promise<void>;
+    /** Parity F4: Android only. Resolves as a no-op on iOS. */
+    createNotificationChannel(config: UnsafeObject): Promise<void>;
+    /** Parity F4: Android only. Resolves as a no-op on iOS. */
+    deleteNotificationChannel(channelId: string): Promise<void>;
+    getBadgeCount(): Promise<number>;
+    setBadgeCount(count: number): Promise<void>;
+    incrementBadgeCount(delta: number): Promise<number>;
+    clearBadgeCount(): Promise<void>;
+    /** Parity G4: iOS only. Resolves as a no-op on Android. */
+    setAutoClearBadgeOnForeground(enabled: boolean): Promise<void>;
+    /** iOS only. Resolves as a no-op on Android, where FCM always registers. */
+    setAutoRegisterForRemoteNotifications(enabled: boolean): Promise<void>;
+    addTag(key: string, value: string): Promise<void>;
+    addTags(tags: UnsafeObject): Promise<void>;
+    removeTag(key: string): Promise<void>;
+    removeTags(keys: Array<string>): Promise<void>;
+    getTags(): Promise<UnsafeObject>;
+    addAlias(label: string, id: string): Promise<void>;
+    addAliases(aliases: UnsafeObject): Promise<void>;
+    removeAlias(label: string): Promise<void>;
+    removeAliases(labels: Array<string>): Promise<void>;
+    addEmail(address: string): Promise<void>;
+    removeEmail(address: string): Promise<void>;
+    setLanguage(languageCode: string): Promise<void>;
+    getLanguage(): Promise<string>;
+    /** Resolves `{ id, token, optedIn }` from local state on both platforms. */
+    getPushSubscription(): Promise<UnsafeObject>;
+    optIn(): Promise<void>;
+    optOut(): Promise<void>;
+    /**
+     * The subscription's enabled state as the backend sees it. Android reads it
+     * back from /subscriptions; iOS computes the same flag it would send.
+     */
+    getOptedIn(): Promise<boolean>;
+    setConsentRequired(required: boolean): Promise<void>;
+    getConsentRequired(): Promise<boolean>;
+    setConsentGiven(given: boolean): Promise<void>;
+    getConsentGiven(): Promise<boolean>;
+    setTestDevice(enabled: boolean): Promise<void>;
+    isTestDevice(): Promise<boolean>;
+    scheduleBackgroundSync(options: UnsafeObject): Promise<void>;
+    cancelBackgroundSync(): Promise<void>;
+    setLogLevel(level: string): Promise<void>;
+    /**
+     * Answers a pending `onNotificationWillDisplay` event. The native side holds
+     * the notification until this lands or the timeout elapses, which is what
+     * makes `preventDefault()` work across an async bridge.
+     *
+     * Not called directly — `onNotificationWillDisplay` wires it up.
+     */
+    completeNotificationWillDisplay(notificationId: string, display: boolean): Promise<void>;
+    /**
+     * Required by `NativeEventEmitter` on both architectures. Under the New
+     * Architecture these also satisfy the TurboModule event-emitter contract.
+     */
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeAppsonairApppush.d.ts.map

package/lib/typescript/commonjs/src/NativeAppsonairApppush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeAppsonairApppush.d.ts","sourceRoot":"","sources":["../../../../src/NativeAppsonairApppush.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/src/index.d.ts

@@ -0,0 +1,392 @@
+import type { InstallationIdEvent, LogLevel, NotificationOpenedEvent, NotificationReceivedEvent, NotificationWillDisplayEvent, PermissionChangedEvent, PermissionStatus, PushConfig, PushErrorEvent, PushSubscriptionChangedEvent, PushSubscriptionState, RequestPermissionOptions, SilentNotificationEvent, Subscription, TokenUpdatedEvent, UserStateChangedEvent } from './types';
+export * from './types';
+/**
+ * Starts the SDK. Await this once, before any other call.
+ *
+ * On Android the wrapper supplies the `Context` itself; on iOS it resolves the
+ * App Group and enables AppDelegate swizzling. Neither detail is exposed here.
+ */
+export declare function initialize(config?: PushConfig): Promise<void>;
+/** Whether {@link initialize} has completed in this JS context. */
+export declare function isInitialized(): boolean;
+/** The AppsOnAir-assigned device id. */
+export declare function getDeviceId(): Promise<string>;
+/** The backend-assigned subscription id. `null` until the device registers. */
+export declare function getSubscriptionId(): Promise<string | null>;
+/** The external id linked via {@link login}. `null` while anonymous. */
+export declare function getExternalId(): Promise<string | null>;
+/** Associates this device with your own user id. */
+export declare function login(externalId: string): Promise<void>;
+/** Unlinks the external id, returning the device to an anonymous subscription. */
+export declare function logout(): Promise<void>;
+/** Alias of {@link login}, for teams that prefer the noun. */
+export declare const setUserId: typeof login;
+/** APNs hex token on iOS, FCM token on Android. `null` before registration. */
+export declare function getToken(): Promise<string | null>;
+/** Alias of {@link getToken}. */
+export declare const getDeviceToken: typeof getToken;
+/**
+ * Prompts for notification permission and resolves the resulting grant state.
+ *
+ * Parity E1: Android needs a live Activity. The bridge resolves the current one
+ * and rejects if none is attached rather than crashing.
+ */
+export declare function requestPermission(options?: RequestPermissionOptions): Promise<boolean>;
+/**
+ * Whether notifications are currently permitted.
+ *
+ * Parity E3/E4/E6: iOS reads a cache and Android reads live, so the iOS bridge
+ * refreshes first. The two native shapes (`async` vs sync, `permission` vs
+ * `isPermissionGranted`) are collapsed into this one promise.
+ */
+export declare function getPermission(): Promise<boolean>;
+/**
+ * The granular permission state.
+ *
+ * Parity C7: iOS reports all five values. **Android reports only `authorized`
+ * or `denied`** — it never returns `notDetermined`, so do not gate a
+ * cross-platform pre-prompt on that value.
+ */
+export declare function getPermissionStatus(): Promise<PermissionStatus>;
+/**
+ * Whether a permission prompt can still be shown.
+ *
+ * Parity E2 — **known divergence, not yet fixed in the native SDKs.** iOS
+ * returns `true` only before the user has ever been asked. Android returns
+ * `true` whenever permission is not granted, *including after a permanent
+ * denial*. Treat a `true` on Android as "not granted", not as "never asked".
+ */
+export declare function canRequestPermission(): Promise<boolean>;
+/** Quiet iOS 12+ provisional authorization. **iOS only** — a no-op on Android. */
+export declare function registerForProvisionalAuthorization(): Promise<void>;
+export declare const notifications: {
+    /** Dismisses every notification this app has posted. */
+    clearAll(): Promise<void>;
+    /**
+     * Dismisses one notification by its payload `notification_id`.
+     *
+     * Parity F2: on Android the id is hashed to find the posted notification, so
+     * two ids that hash alike could collide. iOS matches the request identifier
+     * exactly.
+     */
+    remove(notificationId: string): Promise<void>;
+    /** Dismisses several notifications. Android loops; iOS removes them in one call. */
+    removeMany(notificationIds: string[]): Promise<void>;
+    /** Dismisses a notification group. **Android only** — a no-op on iOS. */
+    removeGroup(groupKey: string): Promise<void>;
+};
+export declare const badge: {
+    /**
+     * The SDK's badge count.
+     *
+     * Parity G1/G3: iOS reads the OS badge. Android has no OS read API, so this
+     * returns the SDK's own persisted value, which can drift from what the
+     * launcher actually shows.
+     */
+    get(): Promise<number>;
+    /**
+     * Sets the badge count.
+     *
+     * Parity G3: reliable on iOS. On Android this is a best-effort launcher
+     * broadcast that silently does nothing outside Samsung / MIUI / ASUS — which
+     * is why nothing here reports success.
+     */
+    set(count: number): Promise<void>;
+    /** Adds `delta` to the badge and resolves the new value, clamped at 0. */
+    increment(delta?: number): Promise<number>;
+    /** Clears the badge. */
+    clear(): Promise<void>;
+    /** Clears the badge whenever the app foregrounds. **iOS only.** */
+    setAutoClearOnForeground(enabled: boolean): Promise<void>;
+};
+export declare const user: {
+    /** The AppsOnAir device id. */
+    getAppsOnAirId(): Promise<string>;
+    getExternalId: typeof getExternalId;
+    addTag(key: string, value: string): Promise<void>;
+    addTags(tags: Record<string, string>): Promise<void>;
+    removeTag(key: string): Promise<void>;
+    removeTags(keys: string[]): Promise<void>;
+    /**
+     * The user's tags.
+     *
+     * **Android round-trips to the backend** once the device has a
+     * `subscriptionId`, replacing its local cache with the result; before
+     * registration it resolves the local cache without a network call. **iOS reads
+     * its local cache only.** So a tag set on another device shows up on Android
+     * and not on iOS, and the Android call can reject on a network failure where
+     * iOS cannot.
+     */
+    getTags(): Promise<Record<string, string>>;
+    addAlias(label: string, id: string): Promise<void>;
+    addAliases(aliases: Record<string, string>): Promise<void>;
+    removeAlias(label: string): Promise<void>;
+    removeAliases(labels: string[]): Promise<void>;
+    /**
+     * Adds an email identifier.
+     *
+     * Parity A5 — **known Android bug.** Android persists emails but never reads
+     * them back on restart, so an email added here silently vanishes when the app
+     * relaunches. The wrapper cannot work around it; it needs an SDK fix.
+     */
+    addEmail(address: string): Promise<void>;
+    removeEmail(address: string): Promise<void>;
+    setLanguage(languageCode: string): Promise<void>;
+    /**
+     * The device language.
+     *
+     * Parity 1.5 — Android reads this live; iOS snapshots it once at init and
+     * never refreshes, so a mid-session language change is stale on iOS.
+     */
+    getLanguage(): Promise<string>;
+    /** The current push subscription: `{ id, token, optedIn }`. */
+    getPushSubscription(): Promise<PushSubscriptionState>;
+    /** Opts this device back in to push delivery. */
+    optIn(): Promise<void>;
+    /** Opts this device out of push delivery without unregistering the token. */
+    optOut(): Promise<void>;
+    /**
+     * The subscription's enabled state as the backend sees it.
+     *
+     * Distinct from `getPushSubscription().optedIn`, which is the purely local
+     * `!optedOut` flag on both platforms. The two derive it differently and
+     * converge only in steady state:
+     *
+     * - **Android** reads it back from `/subscriptions`, so it reflects what the
+     *   server actually stored. Before the device registers it falls back to the
+     *   local value without a network call.
+     * - **iOS** computes the same flag it would send: an APNs token exists, the
+     *   user has not opted out, *and* the OS currently grants permission. So
+     *   revoking permission in Settings flips this to `false` on iOS while
+     *   Android keeps reporting the server's stored value.
+     */
+    getOptedIn(): Promise<boolean>;
+};
+export declare const consent: {
+    setRequired(required: boolean): Promise<void>;
+    getRequired(): Promise<boolean>;
+    setGiven(given: boolean): Promise<void>;
+    getGiven(): Promise<boolean>;
+};
+export declare const debug: {
+    /** Sets SDK log verbosity. Safe to call before {@link initialize}. */
+    setLogLevel(level: LogLevel): Promise<void>;
+};
+/** Fires when a notification arrives while the app is in the foreground. */
+export declare function onNotificationReceived(callback: (event: NotificationReceivedEvent) => void): Subscription;
+/** Fires when the user taps a notification or one of its action buttons. */
+export declare function onNotificationOpened(callback: (event: NotificationOpenedEvent) => void): Subscription;
+/**
+ * Fires in the foreground *before* the notification is displayed, giving you a
+ * chance to suppress it.
+ *
+ * `preventDefault()` must be called synchronously inside the handler — the
+ * native side is holding the notification until this returns, and releases it
+ * anyway after a short timeout so a throwing handler cannot wedge delivery.
+ *
+ * All registered handlers run; the notification is suppressed if *any* of them
+ * calls `preventDefault()`.
+ *
+ * **`preventDefault()` is honoured on Android only.** iOS decides presentation
+ * synchronously and cannot wait for a JS answer — see
+ * {@link NotificationWillDisplayEvent.preventDefault}. The event itself fires on
+ * both platforms.
+ */
+export declare function onNotificationWillDisplay(callback: (event: NotificationWillDisplayEvent) => void): Subscription;
+/** Fires when the OS notification permission changes. */
+export declare function onPermissionChanged(callback: (event: PermissionChangedEvent) => void): Subscription;
+/** Fires when the push subscription's token or opt-in state changes. */
+export declare function onSubscriptionChanged(callback: (event: PushSubscriptionChangedEvent) => void): Subscription;
+/** Fires on {@link login} / {@link logout}. */
+export declare function onUserStateChanged(callback: (event: UserStateChangedEvent) => void): Subscription;
+/**
+ * Fires when the device registration token is issued or refreshed.
+ *
+ * This is the push-side counterpart to {@link getToken}: the getter answers
+ * "what is the token now", this answers "the token just changed" — which is when
+ * your backend needs to hear about it. A token can rotate at any point in a
+ * session, so a one-shot `getToken()` at startup will eventually go stale.
+ *
+ * `environment` is the APNs endpoint the backend must send to. It is
+ * `'sandbox'` or `'production'` on iOS and always `null` on Android, where FCM
+ * routes for you.
+ *
+ * Events raised before the first subscriber exists are dropped rather than
+ * queued on both platforms, so read {@link getToken} once after subscribing if
+ * you need the current value too.
+ */
+export declare function onTokenUpdated(callback: (event: TokenUpdatedEvent) => void): Subscription;
+/**
+ * Fires on an SDK-level failure — token registration, a denied permission, a
+ * missing Firebase config.
+ *
+ * These are conditions the SDK hits on its own schedule, outside any call you
+ * made, so they surface here rather than as a rejected promise. A promise
+ * rejection from a method you called carries the same `code` values.
+ *
+ * Without a subscriber these failures are silent, which is why this is worth
+ * wiring even if it only ever logs.
+ */
+export declare function onError(callback: (event: PushErrorEvent) => void): Subscription;
+/**
+ * Fires for a data-only push that is delivered without being displayed.
+ *
+ * Supported on both platforms, but they are triggered differently and your
+ * backend has to send for both: iOS uses the APNs `content-available` flag,
+ * while Android keys off a `silent: "true"` data entry, since FCM has no
+ * transport-level equivalent. See {@link SilentNotificationEvent}.
+ *
+ * iOS invokes the OS completion handler as soon as this event is emitted, so
+ * the handler cannot extend the app's background execution window: treat it as
+ * a notification that the payload arrived, not as a place to await work.
+ */
+export declare function onSilentNotification(callback: (event: SilentNotificationEvent) => void): Subscription;
+/**
+ * Fires when the Firebase Installation ID becomes available.
+ *
+ * **Android only** — the event name is registered on iOS so the two bridges
+ * stay diffable, but nothing ever emits it there.
+ */
+export declare function onInstallationIdUpdated(callback: (event: InstallationIdEvent) => void): Subscription;
+declare const AppPushService: {
+    initialize: typeof initialize;
+    isInitialized: typeof isInitialized;
+    getDeviceId: typeof getDeviceId;
+    getSubscriptionId: typeof getSubscriptionId;
+    getExternalId: typeof getExternalId;
+    login: typeof login;
+    logout: typeof logout;
+    setUserId: typeof login;
+    getToken: typeof getToken;
+    getDeviceToken: typeof getToken;
+    requestPermission: typeof requestPermission;
+    getPermission: typeof getPermission;
+    getPermissionStatus: typeof getPermissionStatus;
+    canRequestPermission: typeof canRequestPermission;
+    registerForProvisionalAuthorization: typeof registerForProvisionalAuthorization;
+    notifications: {
+        /** Dismisses every notification this app has posted. */
+        clearAll(): Promise<void>;
+        /**
+         * Dismisses one notification by its payload `notification_id`.
+         *
+         * Parity F2: on Android the id is hashed to find the posted notification, so
+         * two ids that hash alike could collide. iOS matches the request identifier
+         * exactly.
+         */
+        remove(notificationId: string): Promise<void>;
+        /** Dismisses several notifications. Android loops; iOS removes them in one call. */
+        removeMany(notificationIds: string[]): Promise<void>;
+        /** Dismisses a notification group. **Android only** — a no-op on iOS. */
+        removeGroup(groupKey: string): Promise<void>;
+    };
+    badge: {
+        /**
+         * The SDK's badge count.
+         *
+         * Parity G1/G3: iOS reads the OS badge. Android has no OS read API, so this
+         * returns the SDK's own persisted value, which can drift from what the
+         * launcher actually shows.
+         */
+        get(): Promise<number>;
+        /**
+         * Sets the badge count.
+         *
+         * Parity G3: reliable on iOS. On Android this is a best-effort launcher
+         * broadcast that silently does nothing outside Samsung / MIUI / ASUS — which
+         * is why nothing here reports success.
+         */
+        set(count: number): Promise<void>;
+        /** Adds `delta` to the badge and resolves the new value, clamped at 0. */
+        increment(delta?: number): Promise<number>;
+        /** Clears the badge. */
+        clear(): Promise<void>;
+        /** Clears the badge whenever the app foregrounds. **iOS only.** */
+        setAutoClearOnForeground(enabled: boolean): Promise<void>;
+    };
+    user: {
+        /** The AppsOnAir device id. */
+        getAppsOnAirId(): Promise<string>;
+        getExternalId: typeof getExternalId;
+        addTag(key: string, value: string): Promise<void>;
+        addTags(tags: Record<string, string>): Promise<void>;
+        removeTag(key: string): Promise<void>;
+        removeTags(keys: string[]): Promise<void>;
+        /**
+         * The user's tags.
+         *
+         * **Android round-trips to the backend** once the device has a
+         * `subscriptionId`, replacing its local cache with the result; before
+         * registration it resolves the local cache without a network call. **iOS reads
+         * its local cache only.** So a tag set on another device shows up on Android
+         * and not on iOS, and the Android call can reject on a network failure where
+         * iOS cannot.
+         */
+        getTags(): Promise<Record<string, string>>;
+        addAlias(label: string, id: string): Promise<void>;
+        addAliases(aliases: Record<string, string>): Promise<void>;
+        removeAlias(label: string): Promise<void>;
+        removeAliases(labels: string[]): Promise<void>;
+        /**
+         * Adds an email identifier.
+         *
+         * Parity A5 — **known Android bug.** Android persists emails but never reads
+         * them back on restart, so an email added here silently vanishes when the app
+         * relaunches. The wrapper cannot work around it; it needs an SDK fix.
+         */
+        addEmail(address: string): Promise<void>;
+        removeEmail(address: string): Promise<void>;
+        setLanguage(languageCode: string): Promise<void>;
+        /**
+         * The device language.
+         *
+         * Parity 1.5 — Android reads this live; iOS snapshots it once at init and
+         * never refreshes, so a mid-session language change is stale on iOS.
+         */
+        getLanguage(): Promise<string>;
+        /** The current push subscription: `{ id, token, optedIn }`. */
+        getPushSubscription(): Promise<PushSubscriptionState>;
+        /** Opts this device back in to push delivery. */
+        optIn(): Promise<void>;
+        /** Opts this device out of push delivery without unregistering the token. */
+        optOut(): Promise<void>;
+        /**
+         * The subscription's enabled state as the backend sees it.
+         *
+         * Distinct from `getPushSubscription().optedIn`, which is the purely local
+         * `!optedOut` flag on both platforms. The two derive it differently and
+         * converge only in steady state:
+         *
+         * - **Android** reads it back from `/subscriptions`, so it reflects what the
+         *   server actually stored. Before the device registers it falls back to the
+         *   local value without a network call.
+         * - **iOS** computes the same flag it would send: an APNs token exists, the
+         *   user has not opted out, *and* the OS currently grants permission. So
+         *   revoking permission in Settings flips this to `false` on iOS while
+         *   Android keeps reporting the server's stored value.
+         */
+        getOptedIn(): Promise<boolean>;
+    };
+    consent: {
+        setRequired(required: boolean): Promise<void>;
+        getRequired(): Promise<boolean>;
+        setGiven(given: boolean): Promise<void>;
+        getGiven(): Promise<boolean>;
+    };
+    debug: {
+        /** Sets SDK log verbosity. Safe to call before {@link initialize}. */
+        setLogLevel(level: LogLevel): Promise<void>;
+    };
+    onNotificationReceived: typeof onNotificationReceived;
+    onNotificationOpened: typeof onNotificationOpened;
+    onNotificationWillDisplay: typeof onNotificationWillDisplay;
+    onPermissionChanged: typeof onPermissionChanged;
+    onSubscriptionChanged: typeof onSubscriptionChanged;
+    onUserStateChanged: typeof onUserStateChanged;
+    onTokenUpdated: typeof onTokenUpdated;
+    onError: typeof onError;
+    onSilentNotification: typeof onSilentNotification;
+    onInstallationIdUpdated: typeof onInstallationIdUpdated;
+};
+export default AppPushService;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"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"}