Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[user model] Remove getPermissionStatus & add permission property #1035

Merged
merged 9 commits into from
May 11, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
import { OSModel } from "../../../src/core/modelRepo/OSModel";
import { ModelName, SupportedModel } from "../../../src/core/models/SupportedModels";
import { getDummyPushSubscriptionOSModel } from "../../support/helpers/core";
import { TestEnvironment } from "../../support/environment/TestEnvironment";
import { getDummyPushSubscriptionOSModel } from "./core";
import { TestEnvironment } from "../environment/TestEnvironment";

export async function initializeWithPermission(permission: NotificationPermission) {
const mockNotification = {
Expand Down
62 changes: 62 additions & 0 deletions __test__/unit/notifications/permission.test.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
import ModelCache from "../../../src/core/caching/ModelCache";
import PermissionManager from "../../../src/shared/managers/PermissionManager";
import { SubscriptionManager } from "../../../src/shared/managers/SubscriptionManager";
import { PermissionUtils } from "../../../src/shared/utils/PermissionUtils";
import { NotificationPermission } from "../../../src/shared/models/NotificationPermission";
import { TestEnvironment } from "../../support/environment/TestEnvironment";

describe('Notifications namespace permission properties', () => {
beforeEach(async () => {
jest.useFakeTimers();
test.stub(ModelCache.prototype, 'load', Promise.resolve({}));
test.stub(SubscriptionManager, 'isSafari', false)
TestEnvironment.initialize();
});

afterEach(() => {
jest.resetAllMocks();
});


test('When permission changes to granted, we update the permission properties on the Notifications namespace', async () => {
test.stub(PermissionManager.prototype, 'getPermissionStatus', Promise.resolve(NotificationPermission.Granted));
const permissionChangeEventFiredPromise = new Promise(resolve => {
OneSignal.emitter.on(OneSignal.EVENTS.NATIVE_PROMPT_PERMISSIONCHANGED, resolve);
});

// mimick native permission change
PermissionUtils.triggerNotificationPermissionChanged();

await permissionChangeEventFiredPromise
expect(OneSignal.Notifications.permission).toBe(true);
expect(OneSignal.Notifications.permissionNative).toBe(NotificationPermission.Granted);
});

test('When permission changes to default, we update the permission properties on the Notifications namespace', async () => {
test.stub(PermissionManager.prototype, 'getPermissionStatus', Promise.resolve(NotificationPermission.Default));
const permissionChangeEventFiredPromise = new Promise(resolve => {
OneSignal.emitter.on(OneSignal.EVENTS.NATIVE_PROMPT_PERMISSIONCHANGED, resolve);
});

// mimick native permission change
PermissionUtils.triggerNotificationPermissionChanged();

await permissionChangeEventFiredPromise
expect(OneSignal.Notifications.permission).toBe(false);
expect(OneSignal.Notifications.permissionNative).toBe(NotificationPermission.Default);
});

test('When permission changes to denied, we update the permission properties on the Notifications namespace', async () => {
test.stub(PermissionManager.prototype, 'getPermissionStatus', Promise.resolve(NotificationPermission.Denied));
const permissionChangeEventFiredPromise = new Promise(resolve => {
OneSignal.emitter.on(OneSignal.EVENTS.NATIVE_PROMPT_PERMISSIONCHANGED, resolve);
});

// mimick native permission change
PermissionUtils.triggerNotificationPermissionChanged();

await permissionChangeEventFiredPromise
expect(OneSignal.Notifications.permission).toBe(false);
expect(OneSignal.Notifications.permissionNative).toBe(NotificationPermission.Denied);
});
});
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ import PermissionManager from "../../../src/shared/managers/PermissionManager";
import EventHelper from "../../../src/shared/helpers/EventHelper";
import { SubscriptionManager } from "../../../src/shared/managers/SubscriptionManager";
import { DUMMY_PUSH_TOKEN } from "../../support/constants";
import { initializeWithPermission } from "./helpers";
import { initializeWithPermission } from "../../support/helpers/pushSubscription";

describe('Notification Types are set correctly on subscription change', () => {
beforeEach(async () => {
Expand Down
18 changes: 5 additions & 13 deletions api.json
Original file line number Diff line number Diff line change
Expand Up @@ -94,18 +94,6 @@
"args": [],
"returnType": "boolean"
},
{
"name": "getPermissionStatus",
"isAsync": true,
"args": [
{
"name": "onComplete",
"type": "Action<NotificationPermission>",
"optional": false
}
],
"returnType": "Promise<NotificationPermission>"
},
{
"name": "requestPermission",
"isAsync": true,
Expand Down Expand Up @@ -152,7 +140,11 @@
"properties": [
{
"name": "permissionNative",
"type": "'granted' | 'denied' | 'default'"
"type": "NotificationPermission"
},
{
"name": "permission",
"type": "boolean"
}
]
},
Expand Down
41 changes: 13 additions & 28 deletions src/onesignal/NotificationsNamespace.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,34 @@ import { ValidatorUtils } from "../page/utils/ValidatorUtils";
import { InvalidArgumentError, InvalidArgumentReason } from "../shared/errors/InvalidArgumentError";
import Database from "../shared/services/Database";
import { awaitOneSignalInitAndSupported, logMethodCall } from "../shared/utils/utils";
import OneSignalError from "../../src/shared/errors/OneSignalError";
import OneSignal from "./OneSignal";
import { EventListenerBase } from "../page/userModel/EventListenerBase";
import NotificationEventName from "../page/models/NotificationEventName";
import { NotificationClickResult, NotificationForegroundWillDisplayEvent } from "../page/models/NotificationEvent";
import NotificationEventTypeMap from "src/page/models/NotificationEventTypeMap";
import { NotificationPermission } from "../shared/models/NotificationPermission";
import NotificationEventTypeMap from "../page/models/NotificationEventTypeMap";

export default class NotificationsNamespace extends EventListenerBase {
private _permission: boolean;

constructor(private _permissionNative?: NotificationPermission) {
super();

OneSignal.emitter.on(OneSignal.EVENTS.NATIVE_PROMPT_PERMISSIONCHANGED, (permission: NotificationPermission) => {
this._permissionNative = permission;
this._permission = _permissionNative === NotificationPermission.Granted;

OneSignal.emitter.on(OneSignal.EVENTS.NATIVE_PROMPT_PERMISSIONCHANGED, (permissionNative: NotificationPermission) => {
this._permissionNative = permissionNative;
this._permission = permissionNative === NotificationPermission.Granted;
});
}

get permissionNative(): NotificationPermission | undefined {
return this._permissionNative;
}

get permission(): boolean | undefined {
return this._permission;
}

/**
* Pass in the full URL of the default page you want to open when a notification is clicked.
* @PublicApi
Expand Down Expand Up @@ -111,29 +119,6 @@ export default class NotificationsNamespace extends EventListenerBase {
}
*/

/**
* Returns a promise that resolves to the browser's current notification permission as
* 'default', 'granted', or 'denied'.
* @param callback A callback function that will be called when the browser's current notification permission
* has been obtained, with one of 'default', 'granted', or 'denied'.
* @PublicApi
*/
async getPermissionStatus(onComplete?: Action<NotificationPermission>): Promise<NotificationPermission> {
if (!OneSignal.context) {
throw new OneSignalError(`OneSignal.context is undefined. Make sure to call OneSignal.init() before calling getPermissionStatus().`);
}

const permission = await OneSignal.context.permissionManager.getNotificationPermission(
OneSignal.config!.safariWebId
);

if (onComplete) {
onComplete(permission);
}

return permission;
}

/**
* Shows a native browser prompt.
* @PublicApi
Expand Down
2 changes: 1 addition & 1 deletion src/onesignal/OneSignal.ts
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ export default class OneSignal {
await core.initPromise;
OneSignal.coreDirector = new CoreModuleDirector(core);
const subscription = await Database.getSubscription();
const permission = await OneSignal.Notifications.getPermissionStatus();
const permission = await OneSignal.context.permissionManager.getPermissionStatus();
OneSignal.User = new UserNamespace(true, subscription, permission);
this.Notifications = new NotificationsNamespace(permission);
}
Expand Down
2 changes: 1 addition & 1 deletion src/onesignal/PushSubscriptionNamespace.ts
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ export default class PushSubscriptionNamespace extends EventListenerBase {
await awaitOneSignalInitAndSupported();
this._optedIn = true;

const permissionStatus = await OneSignal.Notifications.getPermissionStatus();
const permissionStatus = await OneSignal.context.permissionManager.getPermissionStatus();

if (permissionStatus !== 'granted') {
// TO DO: use user-config options prompting method
Expand Down
4 changes: 2 additions & 2 deletions src/page/bell/Bell.ts
Original file line number Diff line number Diff line change
Expand Up @@ -294,7 +294,7 @@ export default class Bell {
}
}

OneSignal.Notifications.getPermissionStatus((permission: NotificationPermission) => {
OneSignal.context.permissionManager.getPermissionStatus((permission: NotificationPermission) => {
let bellState: BellState;
if (isSubscribed.current.optedIn) {
bellState = Bell.STATES.SUBSCRIBED;
Expand Down Expand Up @@ -572,7 +572,7 @@ export default class Bell {
updateState() {
Promise.all([
OneSignal.context.subscriptionManager.isPushNotificationsEnabled(),
OneSignal.Notifications.getPermissionStatus()
OneSignal.context.permissionManager.getPermissionStatus()
])
.then(([isEnabled, permission]) => {
this.setState(isEnabled ? Bell.STATES.SUBSCRIBED : Bell.STATES.UNSUBSCRIBED);
Expand Down
2 changes: 1 addition & 1 deletion src/page/managers/slidedownManager/SlidedownManager.ts
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ export class SlidedownManager {
/* P R I V A T E */

private async checkIfSlidedownShouldBeShown(options: AutoPromptOptions): Promise<boolean> {
const permissionDenied = await OneSignal.Notifications.getPermissionStatus() === NotificationPermission.Denied;
const permissionDenied = await OneSignal.context.permissionManager.getPermissionStatus() === NotificationPermission.Denied;
let wasDismissed: boolean;

const subscriptionInfo: PushSubscriptionState = await OneSignal.context.subscriptionManager.getSubscriptionState();
Expand Down
2 changes: 1 addition & 1 deletion src/page/modules/frames/SubscriptionModalHost.ts
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ export default class SubscriptionModalHost implements Disposable {
*/
async load(): Promise<void> {
const isPushEnabled = await OneSignal.context.subscriptionManager.isPushNotificationsEnabled();
const notificationPermission = await OneSignal.Notifications.getPermissionStatus();
const notificationPermission = await OneSignal.context.permissionManager.getPermissionStatus();
this.url = SdkEnvironment.getOneSignalApiUrl();
this.url.pathname = 'webPushModal';
this.url.search = `${MainHelper.getPromptOptionsQueryString()}&id=${this.appId}&httpsPrompt=true&pushEnabled=${isPushEnabled}&permissionBlocked=${(notificationPermission as any) === 'denied'}&promptType=modal`;
Expand Down
2 changes: 1 addition & 1 deletion src/shared/helpers/InitHelper.ts
Original file line number Diff line number Diff line change
Expand Up @@ -210,7 +210,7 @@ export default class InitHelper {

public static async storeInitialValues() {
const isPushEnabled = await OneSignal.context.subscriptionManager.isPushNotificationsEnabled();
const notificationPermission = await OneSignal.Notifications.getPermissionStatus();
const notificationPermission = await OneSignal.context.permissionManager.getPermissionStatus();
const isOptedOut = await OneSignal.context.subscriptionManager.isOptedOut();
LimitStore.put('subscription.optedOut', isOptedOut);
await Database.put('Options', { key: 'isPushEnabled', value: isPushEnabled });
Expand Down
2 changes: 1 addition & 1 deletion src/shared/helpers/MainHelper.ts
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ export default class MainHelper {

static async checkAndTriggerNotificationPermissionChanged() {
const previousPermission = await Database.get('Options', 'notificationPermission');
const currentPermission = await OneSignal.Notifications.getPermissionStatus();
const currentPermission = await OneSignal.context.permissionManager.getPermissionStatus();
if (previousPermission !== currentPermission) {
await PermissionUtils.triggerNotificationPermissionChanged();
await Database.put('Options', {
Expand Down
19 changes: 19 additions & 0 deletions src/shared/managers/PermissionManager.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ import { InvalidArgumentError, InvalidArgumentReason } from '../errors/InvalidAr
import { NotificationPermission } from '../models/NotificationPermission';
import SdkEnvironment from './SdkEnvironment';
import LocalStorage from '../utils/LocalStorage';
import OneSignalError from '../errors/OneSignalError';

/**
* A permission manager to consolidate the different quirks of obtaining and evaluating permissions
Expand All @@ -15,6 +16,24 @@ export default class PermissionManager {
return 'storedNotificationPermission';
}

/**
* Returns a promise that resolves to the browser's current notification permission as
* 'default', 'granted', or 'denied'.
* @param callback A callback function that will be called when the browser's current notification permission
* has been obtained, with one of 'default', 'granted', or 'denied'.
*/
async getPermissionStatus(): Promise<NotificationPermission> {
if (!OneSignal.context) {
throw new OneSignalError(`OneSignal.context is undefined. Make sure to call OneSignal.init() before calling getPermissionStatus().`);
}

const permission = await OneSignal.context.permissionManager.getNotificationPermission(
OneSignal.config!.safariWebId
);

return permission;
}

/**
* Returns an interpreted version of the browser's notification permission.
*
Expand Down
4 changes: 2 additions & 2 deletions src/shared/managers/SubscriptionManager.ts
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ export class SubscriptionManager {
*/
async isOptedIn(): Promise<boolean> {
const subscriptionState = await this.getSubscriptionState();
const permission = await OneSignal.Notifications.getPermissionStatus();
const permission = await OneSignal.context.permissionManager.getPermissionStatus();
return permission === 'granted' && !subscriptionState.optedOut;
}

Expand Down Expand Up @@ -140,7 +140,7 @@ export class SubscriptionManager {
Subscribing is only possible on the top-level frame, so there's no permission ambiguity
here.
*/
if ((await OneSignal.Notifications.getPermissionStatus()) === NotificationPermission.Denied)
if ((await OneSignal.context.permissionManager.getPermissionStatus()) === NotificationPermission.Denied)
throw new PushPermissionNotGrantedError(PushPermissionNotGrantedErrorReason.Blocked);

if (SubscriptionManager.isSafari()) {
Expand Down
2 changes: 1 addition & 1 deletion src/shared/utils/PermissionUtils.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import OneSignalEvent from '../services/OneSignalEvent';

export class PermissionUtils {
public static async triggerNotificationPermissionChanged(updateIfIdentical = false) {
const newPermission: NotificationPermission = await OneSignal.Notifications.getPermissionStatus();
const newPermission: NotificationPermission = await OneSignal.context.permissionManager.getPermissionStatus();
const previousPermission: NotificationPermission = await Database.get('Options', 'notificationPermission');

const shouldBeUpdated = newPermission !== previousPermission || updateIfIdentical;
Expand Down