feat(orgs): add OrganizationsAdapter definition

src/OrganizationsAdapter.js

@@ -0,0 +1,31 @@
+import {throwError} from 'rxjs';
+
+import WebexAdapter from './WebexAdapter';
+
+/**
+ * A set of people in Webex.
+ *
+ * @typedef {object} Organization
+ * @property {string} ID    The organization identifier
+ * @property {string} name  The display name of the organization
+ */
+
+/**
+ * This is a base class that defines the interface that maps organization data.
+ * Developers that want to extend `OrganizationsAdapter` must implement all of its methods,
+ * adhering to the exact parameters and structure of the returned objects.
+ *
+ * @interface
+ */
+export default class OrganizationsAdapter extends WebexAdapter {
+  /**
+   * Returns an observable that emits organization data of the given ID.
+   *
+   * @param {string} ID ID of organization to get
+   * @returns {external:Observable.<Organization>} Observable stream that emits organization data
+   * @memberof OrganizationsAdapter
+   */
+  getOrg(ID) {
+    return throwError(new Error('getOrg(ID) must be defined in OrganizationsAdapter'));
+  }
+}

src/OrganizationsAdapter.test.js

@@ -0,0 +1,31 @@
+import {isObservable} from 'rxjs';
+
+import OrganizationsAdapter from './OrganizationsAdapter';
+
+describe('Organizations Adapter Interface', () => {
+  let orgsAdapter;
+
+  beforeEach(() => {
+    orgsAdapter = new OrganizationsAdapter();
+  });
+
+  afterEach(() => {
+    orgsAdapter = null;
+  });
+
+  describe('getOrg()', () => {
+    test('returns an observable', () => {
+      expect(isObservable(orgsAdapter.getOrg())).toBeTruthy();
+    });
+
+    test('errors because it needs to be defined', (done) => {
+      orgsAdapter.getOrg('msgID').subscribe(
+        () => { },
+        (error) => {
+          expect(error.message).toBe('getOrg(ID) must be defined in OrganizationsAdapter');
+          done();
+        },
+      );
+    });
+  });
+});

src/index.js

@@ -2,5 +2,6 @@ export {default as WebexAdapter} from './WebexAdapter';
 export {default as ActivitiesAdapter} from './ActivitiesAdapter';
 export {default as MeetingsAdapter, MeetingControlState} from './MeetingsAdapter';
 export {default as MembershipsAdapter, DestinationType} from './MembershipsAdapter';
+export {default as OrganizationsAdapter} from './OrganizationsAdapter';
 export {default as PeopleAdapter, PersonStatus} from './PeopleAdapter';
 export {default as RoomsAdapter, RoomType} from './RoomsAdapter';