Merge 619b72e into 18c5312

Author: sam-gc

packages-exp/auth-exp/src/core/persistence/browser.test.ts

@@ -0,0 +1,122 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import * as sinon from 'sinon';
+import { PersistenceType } from '.';
+import { expect } from 'chai';
+import { browserLocalPersistence, browserSessionPersistence } from './browser';
+import { User } from '../../model/user';
+import { testUser } from '../../../test/mock_auth';
+
+describe('core/persistence/browser', () => {
+  beforeEach(() => {
+    localStorage.clear();
+    sessionStorage.clear();
+  });
+
+  afterEach(() => sinon.restore());
+
+  describe('browserLocalPersistence', () => {
+    const persistence = browserLocalPersistence;
+
+    it('should work with persistence type', async () => {
+      const key = 'my-super-special-persistence-type';
+      const value = PersistenceType.LOCAL;
+      expect(await persistence.get(key)).to.be.null;
+      await persistence.set(key, value);
+      expect(await persistence.get(key)).to.be.eq(value);
+      expect(await persistence.get('other-key')).to.be.null;
+      await persistence.remove(key);
+      expect(await persistence.get(key)).to.be.null;
+    });
+
+    it('should call instantiator function if provided', async () => {
+      const key = 'my-super-special-user';
+      const value = testUser('some-uid');
+
+      expect(await persistence.get(key)).to.be.null;
+      await persistence.set(key, value);
+      const out = await persistence.get<User>(key, blob =>
+        testUser(`test-${blob.uid}`)
+      );
+      expect(out?.uid).to.eql('test-some-uid');
+      await persistence.remove(key);
+      expect(await persistence.get(key)).to.be.null;
+    });
+
+    describe('#isAvailable', () => {
+      it('should emit false if localStorage setItem throws', async () => {
+        sinon.stub(localStorage, 'setItem').throws(new Error('nope'));
+        expect(await persistence.isAvailable()).to.be.false;
+      });
+
+      it('should emit false if localStorage removeItem throws', async () => {
+        sinon.stub(localStorage, 'removeItem').throws(new Error('nope'));
+        expect(await persistence.isAvailable()).to.be.false;
+      });
+
+      it('should emit true if everything works properly', async () => {
+        expect(await persistence.isAvailable()).to.be.true;
+      });
+    });
+  });
+
+  describe('browserSessionPersistence', () => {
+    const persistence = browserSessionPersistence;
+
+    it('should work with persistence type', async () => {
+      const key = 'my-super-special-persistence-type';
+      const value = PersistenceType.SESSION;
+      expect(await persistence.get(key)).to.be.null;
+      await persistence.set(key, value);
+      expect(await persistence.get(key)).to.be.eq(value);
+      expect(await persistence.get('other-key')).to.be.null;
+      await persistence.remove(key);
+      expect(await persistence.get(key)).to.be.null;
+    });
+
+    it('should call instantiator function if provided', async () => {
+      const key = 'my-super-special-user';
+      const value = testUser('some-uid');
+
+      expect(await persistence.get(key)).to.be.null;
+      await persistence.set(key, value);
+      const out = await persistence.get<User>(key, blob =>
+        testUser(`test-${blob.uid}`)
+      );
+      expect(out?.uid).to.eql('test-some-uid');
+      await persistence.remove(key);
+      expect(await persistence.get(key)).to.be.null;
+    });
+
+    describe('#isAvailable', () => {
+      it('should emit false if sessionStorage setItem throws', async () => {
+        sinon.stub(sessionStorage, 'setItem').throws(new Error('nope'));
+        expect(await persistence.isAvailable()).to.be.false;
+      });
+
+      it('should emit false if sessionStorage removeItem throws', async () => {
+        sinon.stub(sessionStorage, 'removeItem').throws(new Error('nope'));
+        expect(await persistence.isAvailable()).to.be.false;
+      });
+
+      it('should emit true if everything works properly', async () => {
+        expect(await persistence.isAvailable()).to.be.true;
+      });
+    });
+  });
+});

packages-exp/auth-exp/src/core/persistence/browser.ts

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {
+  Persistence,
+  PersistenceType,
+  PersistenceValue,
+  Instantiator
+} from '.';
+
+const STORAGE_AVAILABLE_KEY_ = '__sak';
+
+class BrowserPersistence implements Persistence {
+  type: PersistenceType = PersistenceType.LOCAL;
+
+  constructor(private readonly storage: Storage) {}
+
+  async isAvailable(): Promise<boolean> {
+    try {
+      if (!this.storage) {
+        return false;
+      }
+      this.storage.setItem(STORAGE_AVAILABLE_KEY_, '1');
+      this.storage.removeItem(STORAGE_AVAILABLE_KEY_);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  async set(key: string, value: PersistenceValue): Promise<void> {
+    this.storage.setItem(key, JSON.stringify(value));
+  }
+
+  async get<T extends PersistenceValue>(
+    key: string,
+    instantiator?: Instantiator<T>
+  ): Promise<T | null> {
+    const json = this.storage.getItem(key);
+    const obj = json ? JSON.parse(json) : null;
+    return instantiator && obj ? instantiator(obj) : obj;
+  }
+
+  async remove(key: string): Promise<void> {
+    this.storage.removeItem(key);
+  }
+}
+
+export const browserLocalPersistence: Persistence = new BrowserPersistence(
+  localStorage
+);
+export const browserSessionPersistence: Persistence = new BrowserPersistence(
+  sessionStorage
+);

packages-exp/auth-exp/src/core/persistence/in_memory.test.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { inMemoryPersistence as persistence } from './in_memory';
+import { PersistenceType } from '.';
+import { expect } from 'chai';
+import { User } from '../../model/user';
+import { testUser } from '../../../test/mock_auth';
+
+describe('core/persistence/in_memory', () => {
+  it('should work with persistence type', async () => {
+    const key = 'my-super-special-persistence-type';
+    const value = PersistenceType.LOCAL;
+    expect(await persistence.get(key)).to.be.null;
+    await persistence.set(key, value);
+    expect(await persistence.get(key)).to.be.eq(value);
+    expect(await persistence.get('other-key')).to.be.null;
+    await persistence.remove(key);
+    expect(await persistence.get(key)).to.be.null;
+  });
+
+  it('should work with user', async () => {
+    const key = 'my-super-special-user';
+    const value = testUser('uid');
+
+    expect(await persistence.get(key)).to.be.null;
+    await persistence.set(key, value);
+    expect(await persistence.get<User>(key)).to.eql(value);
+    expect(await persistence.get('other-key')).to.be.null;
+    await persistence.remove(key);
+    expect(await persistence.get(key)).to.be.null;
+  });
+
+  it('isAvailable returns true', async () => {
+    expect(await persistence.isAvailable()).to.be.true;
+  });
+});

packages-exp/auth-exp/src/core/persistence/in_memory.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Persistence, PersistenceType, PersistenceValue } from '../persistence';
+
+class InMemoryPersistence implements Persistence {
+  type: PersistenceType = PersistenceType.NONE;
+  storage: {
+    [key: string]: PersistenceValue;
+  } = {};
+
+  async isAvailable(): Promise<boolean> {
+    return true;
+  }
+
+  async set(key: string, value: PersistenceValue): Promise<void> {
+    this.storage[key] = value;
+  }
+
+  async get<T extends PersistenceValue>(key: string): Promise<T | null> {
+    const value = this.storage[key];
+    return value === undefined ? null : (value as T);
+  }
+
+  async remove(key: string): Promise<void> {
+    delete this.storage[key];
+  }
+}
+
+export const inMemoryPersistence: Persistence = new InMemoryPersistence();

packages-exp/auth-exp/src/core/persistence/index.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { User } from '../../model/user';
+
+export enum PersistenceType {
+  SESSION = 'SESSION',
+  LOCAL = 'LOCAL',
+  NONE = 'NONE'
+}
+
+export interface Instantiator<T> {
+  (blob: { [key: string]: unknown }): T;
+}
+
+export type PersistenceValue = PersistenceType | User;
+
+export interface Persistence {
+  type: PersistenceType;
+  isAvailable(): Promise<boolean>;
+  set(key: string, value: PersistenceValue): Promise<void>;
+  get<T extends PersistenceValue>(
+    key: string,
+    instantiator?: Instantiator<T>
+  ): Promise<T | null>;
+  remove(key: string): Promise<void>;
+}