ti2 1.0.10 → 1.0.11

package/README.md

@@ -37,10 +37,10 @@ Some environment variables are required for ti2 to start
 
 ### Starting your server
 
-You can start your own instance by adding a requirement on your own nodejs project as follows:
+You can start your own instance by instlling ti2 and any aplugin syou may want to use on your own nodejs project root folter:
 
 ```bash
-$ npm i ti2
+$ npm i ti2 ti2-travelgate ti2-ventrata ti2-tourconnect
 ```
 
 To start the server with default values use the following: 
@@ -67,12 +67,31 @@ Plugin ENV variable name convention: ti2_pluginName_environmenVariableName, for
 ti2_tourconnect_apiUrl=http://backend:8080
 ```
 
-### Available Plugins
-
-| Repo | Features | Maintainer |
-| ---- | -------- | ---------- |
-| [ti2-ventrata](https://github.com/TourConnect/ti2-ventrata)     | Bookings: Search, Cancellation | TourConnect |
-| [ti2-travelgate](https://github.com/TourConnect/ti2-travelgate) | Bookings: Search, Cancellation | TourConnect |
+### Plugin Library
+
+| Methods | [Ventrata](https://github.com/TourConnect/ti2-ventrata) | [TravelGateX](https://github.com/TourConnect/ti2-travelgate) | [Didgigo](https://github.com/TourConnect/ti2-didgigo) | [TourConnect](https://github.com/TourConnect/ti2-tourconnect)
+| ---- | -------- | ---------- | ---- | ---- |
+|**Base**|
+|validateToken|||✓|✓|
+|copyMedia||||✓|
+|**Content**|
+|getProfile|||✓|✓|
+|updateProfile||||✓|
+|getLocations|||✓|✓|
+|getLocation|||✓|✓|
+|createLocation|||✓|✓|
+|updateLocation|||✓|✓|
+|getProducts|||✓|✓|
+|getProduct|||✓|✓|
+|createProduct|||✓|✓|
+|updateProduct|||✓|✓|
+|**Bookings**|
+|searchProducts|✓|✓|
+|searchBooking|✓|✓|
+|searchAvailability|✓|✓|
+|quoteAvailability|✓|✓|
+|createBooking|✓|✓|
+|cancelBooking|✓|✓|
 
 ## API logging
 
@@ -111,7 +130,7 @@ Feel free to check the [Issues Page](https://github.com/TourConnect/ti2/issues).
 
 ## License
 
-Distributed under the GPL-3 License. See LICENSE.txt for more information.
+Distributed under the GPL-3 License. See LICENSE file for more information.
 
 TL;DR Here's what the license entails:
 

package/api.yml

@@ -141,6 +141,7 @@ components:
             type: string
     bookingSearchQuery:
       type: object
+      additionalProperties: true
       properties:
         bookingId:
           type: string
@@ -172,6 +173,7 @@ components:
           default: "DD/MM/YYYY"
     bookingDetail:
       type: object
+      additionalProperties: true
       properties:
         id:
           type: string
@@ -181,7 +183,15 @@ components:
           type: string
           required: true
           description: The booking status
-
+    bookingSearchQueryResults:
+      type: object
+      additionalProperties: true
+      properties:
+        bookings:
+          type: object
+          required: true
+          items:
+            $ref: '#/components/schemas/bookingDetail'
     bookingDetailsForCancel:
       allOf:     # Combines the BasicErrorModel and the inline model
         - $ref: '#/components/schemas/bookingDetail'
@@ -191,6 +201,89 @@ components:
           type: integer
           required: true
           description: The unix time the cancellation was sent
+    cancellationReturn:
+      type: object
+      properties:
+        cancellation:
+          type: object
+          allOf:     # Combines the BasicErrorModel and the inline model
+            - $ref: '#/components/schemas/bookingDetail'
+    bookingsProductQuery:
+      type: object
+      additionalProperties: true
+      description: Additional properties may be included
+      properties:
+        productName:
+          type: string
+          required: false
+          description: Product Name wildcard match
+          example: '*bus*'
+    bookingsProductSearchReturn:
+      type: object
+      additionalProperties: true
+      description: Additional properties may be included
+      properties:
+        products:
+          type: array
+          required: false
+          description: Product Search Results
+          items: 
+            type: object
+        accommodation:
+          type: array
+          required: false,
+          decription: Accommodation search results
+          items:
+            type: object
+    pricingItem:
+      type: object
+      additionalProperties: true
+      properties:
+        original:
+          type: integer
+        retail:
+          type: integer
+        net:
+          type: integer
+        currency:
+          type: string
+          example: "USD"
+        currencyPrecision:
+          type: integer
+        includedTaxes:
+          type: array
+          items:
+            type: object
+            additionalProperties: true
+            properties:
+              name:
+                type: string
+              retail:
+                type: integer
+              net:
+                type: integer
+    availabilityItem:
+      type: object
+      additionalProperties: true
+      properties:
+        id:
+          type: string
+          required: true
+          description: An availability Id that can be used for quoting
+        pricing:
+          $ref: '#/components/schemas/pricingItem'
+          required: false
+        cancelPolicy:
+          type: string
+          required: false
+    bookingRequest:
+      type: object
+      additionalProperties: true
+      required: true
+      properties:
+        id:
+          type: string
+          description: a quote Id to make a reservation for
 paths:
   /ping:
     get:
@@ -516,10 +609,12 @@ paths:
             schema:
               $ref: '#/components/schemas/bookingSearchQuery'
       responses:
-        description: search results
-        content:
-          application/json:
-            schema: '#/components/schemas/AnyValue'
+        '200':
+          description: search results
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/bookingSearchQueryResults'
   /bookings/{appKey}/{userId}/{hint}/search:
     post:
       security:
@@ -557,10 +652,12 @@ paths:
             schema:
               $ref: '#/components/schemas/bookingSearchQuery'
       responses:
-        description: search results
-        content:
-          application/json:
-            schema: '#/components/schemas/AnyValue'
+        '200':
+          description: search results
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/bookingSearchQueryResults'
   /bookings/{appKey}/{userId}/cancel:
     post:
       security:
@@ -591,10 +688,12 @@ paths:
             schema:
               $ref: '#/components/schemas/bookingDetailsForCancel'
       responses:
-        description: search results
-        content:
-          application/json:
-            schema: '#/components/schemas/AnyValue'
+        '200':
+          description: Cancellation confirmation details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/cancellationReturn'
   /bookings/{appKey}/{userId}/{hint}/cancel:
     post:
       security:
@@ -632,7 +731,373 @@ paths:
             schema:
               $ref: '#/components/schemas/bookingDetailsForCancel'
       responses:
-        description: search results
+        '200':
+          description: Cancellation confirmation details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/cancellationReturn'
+  /products/{appKey}/{userId}/search:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Product Search
+      operationId: bookingsProductSearch
+      parameters:
+        - name: appKey
+          in: path
+          description: app to search the booking products, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: Search query
+        required:  true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/bookingsProductQuery'
+      responses:
+        '200':
+          description: search results
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/bookingsProductSearchReturn'
+  /products/{appKey}/{userId}/{hint}/search:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Product Search using for an specific hint
+      operationId: bookingsProductSearch
+      parameters:
+        - name: appKey
+          in: path
+          description: app to search the booking products, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+        - name: hint
+          in: path
+          description: a specific token hint to be used
+          required: true
+          example: 'travelgate-australia'
+          schema:
+            type: string
+      requestBody:
+        description: Search query
+        required:  true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/bookingsProductQuery'
+      responses:
+        '200':
+          description: search results
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/bookingsProductSearchReturn'
+  /bookings/{appKey}/{userId}/availability:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Availability Search
+      operationId: bookingsAvailabilitySearch
+      parameters:
+        - name: appKey
+          in: path
+          description: app to search availability for, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: both app details
+        required:  true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AnyValue'
+      responses:
+        '200':
+          description: search results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  availability:
+                    type: array
+                    required: true
+                    items:
+                      $ref: '#/components/schemas/availabilityItem'
+  /bookings/{appKey}/{userId}/{hint}/availability:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Availability Search for an specific hint
+      operationId: bookingsAvailabilitySearch
+      parameters:
+        - name: appKey
+          in: path
+          description: app to search availability for, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+        - name: hint
+          in: path
+          description: a specific token hint to be used
+          required: true
+          example: 'travelgate-australia'
+          schema:
+            type: string
+      requestBody:
+        description: both app details
+        required:  true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AnyValue'
+      responses:
+        '200':
+          description: search results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  availability:
+                    type: array
+                    required: true
+                    items:
+                      $ref: '#/components/schemas/availabilityItem'
+  /bookings/{appKey}/{userId}/quote:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Quote an Availability
+      operationId: searchQuote
+      parameters:
+        - name: appKey
+          in: path
+          description: app to quote availability for, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: Availability spec to be quoted
+        required:  true
         content:
           application/json:
-            schema: '#/components/schemas/AnyValue'
+            schema:
+              type: object
+              additionalProperties: true
+              properties:
+                id:
+                  type: string
+                  required: true
+                  description: An availability Id to quote
+      responses:
+        '200':
+          description: Quote Details
+          content:
+            application/json:
+              schema:
+                type: object
+                required: true
+                properties:
+                  quote:
+                    type: array
+                    required: true
+                    items:
+                      type: object
+                      additionalProperties: true
+                      properties:
+                        id:
+                          type: string
+                          description: a quote Id that can be use to book
+  /bookings/{appKey}/{userId}/{hint}/quote:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Quote an Availability for an specific hint
+      operationId: searchQuote
+      parameters:
+        - name: appKey
+          in: path
+          description: app to quote the availability for, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+        - name: hint
+          in: path
+          description: a specific token hint to be used
+          required: true
+          example: 'travelgate-australia'
+          schema:
+            type: string
+      requestBody:
+        description: Availability spec to be quoted
+        required:  true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: true
+              properties:
+                id:
+                  type: string
+                  required: true
+                  description: An availability Id to quote
+      responses:
+        '200':
+          description: Quote Details
+          content:
+            application/json:
+              schema:
+                type: object
+                required: true
+                properties:
+                  quote:
+                    type: array
+                    required: true
+                    items:
+                      type: object
+                      additionalProperties: true
+                      properties:
+                        id:
+                          type: string
+                          description: a quote Id that can be use to book
+  /bookings/{appKey}/{userId}/booking:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Create a Booking
+      operationId: createBooking
+      parameters:
+        - name: appKey
+          in: path
+          description: app to create the booking for, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: Booking creation payload
+        required:  true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/bookingRequest'
+      responses:
+        '200':
+          description: Booking Details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AnyValue'
+  /bookings/{appKey}/{userId}/{hint}/booking:
+    post:
+      security:
+        - bearerAuth: ['admin', 'user']
+      tags:
+        - bookings
+      summary: Create a Booking for an specific hint
+      operationId: createBooking
+      parameters:
+        - name: appKey
+          in: path
+          description: app to create the booking for, defaults to first token
+          required: true
+          example: 'travelgate-hotelx'
+          schema:
+            type: string
+        - name: userId
+          in: path
+          description: the user/company that the appKey belongs to
+          required: true
+          schema:
+            type: string
+        - name: hint
+          in: path
+          description: a specific token hint to be used
+          required: true
+          example: 'travelgate-australia'
+          schema:
+            type: string
+      requestBody:
+        description: Booking creation payload
+        required:  true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/bookingRequest'
+      responses:
+        '200':
+          description: Booking Details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AnyValue'

package/controllers/__tests__/bookings.js

@@ -11,7 +11,7 @@ describe('user: booking search', () => {
     packageName: 'ti2-travelgate',
     adminEmail: 'engineering+travelgate@tourconnect.com',
   };
-  let appKey = newApp.name;
+  const appKey = newApp.name;
   const userId = '551394be5ac58e5c76000019';
   const token = {
     endpoint: 'https://api.travelgatex.com',
@@ -77,7 +77,7 @@ describe('user: booking search', () => {
       expect(value).toBeTruthy();
     }
   });
-  it('should be able to search a travel gate for a booking', async () => {
+  it('should be able to search a for a booking', async () => {
     const payload = {
       bookingId: '', supplierId: '', name: '',
     };
@@ -94,4 +94,76 @@ describe('user: booking search', () => {
     // expect(Array.isArray(retVal.bookings)).toBeTruthy();
     // expect(retVal.bookings.length > 0).toBeTruthy();
   });
+
+  it('should be able to search a for a booking product', async () => {
+    const payload = {};
+    const { products } = await doApiPost({
+      url: `/products/${appKey}/${userId}/search`,
+      token: userToken,
+      payload,
+    });
+    expect(plugins[0].searchProducts).toHaveBeenCalled();
+    expect(Array.isArray(products)).toBeTruthy();
+    expect(plugins[0].searchProducts.mock.calls[0][0].payload).toEqual(payload);
+    expect(plugins[0].searchProducts.mock.calls[0][0].token).toEqual(token);
+
+    // expect(Array.isArray(retVal.bookings)).toBeTruthy();
+    // expect(retVal.bookings.length > 0).toBeTruthy();
+  });
+  it('should be able to search for availabiility', async () => {
+    const payload = {
+      travelDateStart: '12/30/2025',
+      travelDateEnd: '01/15/2026',
+      dateFormat: 'MM/DD/YYYY',
+      occupancies: [{ paxes: [{ age: 30 }, { age: 40 }] }],
+      currency: 'EUR',
+      market: 'ES',
+      language: 'es',
+      nationality: 'ES',
+    };
+    const { availability } = await doApiPost({
+      url: `/bookings/${appKey}/${userId}/availability`,
+      token: userToken,
+      payload,
+    });
+    expect(plugins[0].searchAvailability).toHaveBeenCalled();
+    expect(Array.isArray(availability)).toBeTruthy();
+    expect(plugins[0].searchAvailability.mock.calls[0][0].payload).toEqual(payload);
+    expect(plugins[0].searchAvailability.mock.calls[0][0].token).toEqual(token);
+  });
+  it('should be able to obtain a quote', async () => {
+    const payload = {
+      id: chance.guid(), // availability result id
+      travelDateStart: '12/30/2025',
+      travelDateEnd: '01/15/2026',
+      dateFormat: 'MM/DD/YYYY',
+      occupancies: [{ paxes: [{ age: 30 }, { age: 40 }] }],
+      currency: 'EUR',
+      market: 'ES',
+      language: 'es',
+      nationality: 'ES',
+    };
+    const { quote } = await doApiPost({
+      url: `/bookings/${appKey}/${userId}/quote`,
+      token: userToken,
+      payload,
+    });
+    expect(plugins[0].searchQuote).toHaveBeenCalled();
+    expect(Array.isArray(quote)).toBeTruthy();
+    expect(plugins[0].searchQuote.mock.calls[0][0].payload).toEqual(payload);
+    expect(plugins[0].searchQuote.mock.calls[0][0].token).toEqual(token);
+  });
+  it('should be able create a booking', async () => {
+    const payload = {
+      id: chance.guid(),
+    };
+    await doApiPost({
+      url: `/bookings/${appKey}/${userId}/booking`,
+      token: userToken,
+      payload,
+    });
+    expect(plugins[0].createBooking).toHaveBeenCalled();
+    expect(plugins[0].createBooking.mock.calls[0][0].payload).toEqual(payload);
+    expect(plugins[0].createBooking.mock.calls[0][0].token).toEqual(token);
+  });
 });

package/controllers/bookings.js

@@ -25,7 +25,6 @@ const bookingsSearch = plugins => async (req, res, next) => {
     });
     return res.json(results);
   } catch (err) {
-    console.log({ err });
     return next(err);
   }
 };
@@ -57,7 +56,121 @@ const bookingsCancel = plugins => async (req, res, next) => {
   }
 };
 
+const bookingsProductSearch = plugins => async (req, res, next) => {
+  const {
+    params: { appKey, userId, hint },
+    body: payload,
+  } = req;
+  try {
+    const app = plugins.find(({ name }) => name === appKey);
+    // const app = load(appKey);
+    const userAppKeys = (await UserAppKey.findOne({
+      where: {
+        userId,
+        integrationId: appKey,
+        ...(hint ? { hint } : {}),
+      },
+    }));
+    assert(userAppKeys, 'could not find the app key');
+    const token = userAppKeys.appKey;
+    const results = await app.searchProducts({
+      token,
+      payload,
+    });
+    return res.json(results);
+  } catch (err) {
+    return next(err);
+  }
+};
+
+const bookingsAvailabilitySearch = plugins => async (req, res, next) => {
+  const {
+    params: { appKey, userId, hint },
+    body: payload,
+  } = req;
+  try {
+    const app = plugins.find(({ name }) => name === appKey);
+    // const app = load(appKey);
+    const userAppKeys = (await UserAppKey.findOne({
+      where: {
+        userId,
+        integrationId: appKey,
+        ...(hint ? { hint } : {}),
+      },
+    }));
+    assert(userAppKeys, 'could not find the app key');
+    const token = userAppKeys.appKey;
+    const results = await app.searchAvailability({
+      token,
+      payload,
+    });
+    return res.json(results);
+  } catch (err) {
+    return next(err);
+  }
+};
+
+const searchQuote = plugins => async (req, res, next) => {
+  const {
+    params: { appKey, userId, hint },
+    body: payload,
+  } = req;
+  try {
+    const app = plugins.find(({ name }) => name === appKey);
+    // const app = load(appKey);
+    const userAppKeys = (await UserAppKey.findOne({
+      where: {
+        userId,
+        integrationId: appKey,
+        ...(hint ? { hint } : {}),
+      },
+    }));
+    assert(userAppKeys, 'could not find the app key');
+    const token = userAppKeys.appKey;
+    assert(payload.id, 'the availability id is required');
+    const results = await app.searchQuote({
+      token,
+      payload,
+    });
+    return res.json(results);
+  } catch (err) {
+    return next(err);
+  }
+};
+
+const createBooking = plugins => async (req, res, next) => {
+  const {
+    params: { appKey, userId, hint },
+    body: payload,
+  } = req;
+  try {
+    const app = plugins.find(({ name }) => name === appKey);
+    // const app = load(appKey);
+    const userAppKeys = (await UserAppKey.findOne({
+      where: {
+        userId,
+        integrationId: appKey,
+        ...(hint ? { hint } : {}),
+      },
+    }));
+    assert(userAppKeys, 'could not find the app key');
+    const token = userAppKeys.appKey;
+    assert(payload.id, 'the quote id is required');
+    const results = await app.createBooking({
+      token,
+      payload,
+    });
+    return res.json(results);
+  } catch (err) {
+    return next(err);
+  }
+};
+
 module.exports = plugins => ({
   bookingsSearch: bookingsSearch(plugins),
   bookingsCancel: bookingsCancel(plugins),
+  bookingsProductSearch: bookingsProductSearch(plugins),
+  bookingsAvailabilitySearch: bookingsAvailabilitySearch(plugins),
+  searchQuote: searchQuote(plugins),
+  createBooking: createBooking(plugins),
 });

package/jsdoc.conf.json

@@ -0,0 +1,25 @@
+{
+    "tags": {
+        "allowUnknownTags": true,
+        "dictionaries": ["jsdoc","closure"]
+    },
+    "source": {
+        "include": ["test"],
+        "includePattern": ".+\\.js(doc|x)?$",
+        "excludePattern": "(^|\\/|\\\\)_"
+    },
+    "plugins": [
+        "plugins/markdown"
+    ],
+    "templates": {
+        "cleverLinks": true,
+        "monospaceLinks": true
+    },
+    "opts": {
+        "destination": "docs",
+        "recurse": true,
+        "sort": false,
+        "readme": "README.md",
+        "template": "node_modules/minami"
+    }
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "ti2",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "Tourist Industry Exchange (TI2)",
   "main": "index.js",
   "scripts": {
     "test": "jest",
-    "sequelize": "sequelize-cli"
+    "sequelize": "sequelize-cli",
+    "doc": "jsdoc -c jsdoc.conf.json"
   },
   "repository": {
     "type": "git",
@@ -39,6 +40,8 @@
     "eslint-config-airbnb-base": "^15.0.0",
     "eslint-plugin-import": "^2.25.4",
     "jest": "^27.4.7",
+    "jsdoc": "^3.6.10",
+    "minami": "git+https://github.com/MyNameReallySux/minami.git#sort-data",
     "supertest": "^6.2.2"
   }
 }

package/test/plugin.js

@@ -1,17 +1,415 @@
-/* global jest */
+/* global jest, expect */
+const chance = require('chance').Chance();
 
 class Plugin {
+  /**
+   * **General** Methods:
+   * * [validateToken](#validateToken).
+   *
+   * **Content Methods**:
+   * * [getProfile](#getProfile)
+   * * [updateProfile](#updateProfile)
+   * * [createLocation](#createLocation)
+   * * [updateLocation](#updateLocation)
+   * * [getProducts](#getProducts)
+   * * [createProduct](#createProduct)
+   * * [updateProduct](#updateProduct)
+   *
+   * **Booking Methods**:
+   * * [searchBooking](#searchBooking)
+   * * [searchProducts](#searchProducts)
+   * * [searchAvailability](#searchAvailability)
+   * * [quoteAvailability](#quoteAvailability)
+   * * [createBooking](#createBooking)
+   * ---
+   *
+   * @param {Object} args - New / Overwriting attributes for the Plugin.
+   */
   constructor(params = {}) {
     Object.entries(params).forEach(([attr, value]) => {
       this[attr] = value;
     });
+    // mock implementations
+    this.validateToken = jest.fn(() => true);
+    this.getProfile = jest.fn(() => {});
+    this.updateProfile = jest.fn(() => {});
+    this.getProduct = jest.fn(() => ({ products: [] }));
+    this.getProducts = jest.fn(() => true);
+    this.createLocation = jest.fn(() => ({ locationId: chance.guid() }));
+    this.updateLocation = jest.fn(() => true);
+    this.searchBooking = jest.fn(() => ({ bookings: [] }));
+    this.searchProducts = jest.fn(() => ({ bookings: [], products: [] }));
+    this.searchAvailability = jest.fn(({
+      token,
+      payload: {
+        travelDateStart,
+        travelDateEnd,
+        dateFormat,
+        occupancies,
+      },
+    }) => {
+      expect(token).toBeTruthy();
+      expect(travelDateStart).toBeTruthy();
+      expect(travelDateEnd).toBeTruthy();
+      expect(dateFormat).toBeTruthy();
+      expect(Array.isArray(occupancies)).toBeTruthy();
+      return { availability: [{ id: chance.guid() }] };
+    });
+
+    this.searchQuote = jest.fn(() => ({ quote: [{ id: chance.guid() }] }));
+    this.createBooking = jest.fn(() => {});
+  }
+
+  /**
+   *  Check the vailidity of an integration token. *part of **General** Methods*
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @returns {Boolean} - The token vailidity True/False
+   */
+  validateToken() {
+    return Boolean(this);
+  }
+  /**
+   * GPS Location Object
+   * @typedef {Object} GPSLocation
+   * @property {String} lat - GPS latitude
+   * @property {String} lng - GPS Longitude
+   */
+
+  /**
+   * Address Object
+   * @typedef {Object} Address
+   * @property {string} addressOne - Street Address first line of text
+   * @property {string} addressTwo - Street Address second line of text
+   * @property {string} city - City
+   * @property {string} state - State
+   * @property {string} zipCode - Zip/Postal Code
+   * @property {GPSLocation} loc -Location
+   */
+
+  /**
+   * Profile Object
+   * @typedef {Object} Profile
+   * @property {string} companyName
+   * @property {Address} address
+   */
+
+  /**
+   * Returns the profile details of the account.
+   * @category Methods
+   * @subcategory Content
+   * Returns the profile details of the account.
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @returns {Profile} - The profile details.
+   */
+  getProfile() {
+    return {};
+  }
+
+  /**
+   * Updates profile information
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Profile} args.payload - Updated profile information
+   * @returns {boolean} - True/False success status.
+   */
+  updateProfile() {
+    return {};
   }
 
-  validateToken = jest.fn();
+  /**
+   * Location Object
+   * @typedef {Object} Location
+   * @property {string} telephone
+   * @property {Address} address
+   */
+
+  /**
+   * Create a Location
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Location} args.payload - The new location details.
+   * @returns {Object} retVal - An object containing return values.
+   * @returns {string} retVal.locationId - The new location unique identifier.
+   */
+  createLocation() {
+    return { locationId: chance.guid() };
+  }
+
+  /**
+   * Update a Location
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {string} args.locationId - The unique identifier of the location to update.
+   * @param {Location} args.payload - The new location details.
+   * @returns {boolean} - True/False success status.
+   */
+  updateLocation() {
+    return true;
+  }
+  /**
+   * Media Object
+   * @typedef {Object} Media - Media Details
+   * @property {string} mediaType - MimeType of media
+   * @property {string} url - URL of media
+   */
 
-  getProduct = jest.fn();
+  /**
+   * Media Collection
+   * @typedef {Object} MediaCollection - Media Collection, grouped by type
+   * @property {Array.Media} image
+   * @property {Array.Media} video
+  */
+
+  /**
+   * Room Object
+   * @typedef {Object} RoomInfo - Room details object
+   * @property {number} count - Number of rooms
+   * @property {string} bedType - Bedding type
+   * @property {string} other - Exta Information
+   */
+
+  /**
+   * Value and UUnit spec
+   * @typedef {Object} ValueUnit - ValueDetails fields
+   * @property {string} unit - A unit specification
+   * @property {number} value - The number of units
+   */
+
+  /**
+   * Get the product details related to a location
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.locationId - A location unique identifier for the matching product.
+   * @param {Object} args.productId - The product unique identifier.
+   * @returns {Object} retVal - A return object.
+   * @returns {Product} retVal.product - Details of the matching product.
+   */
+  /**
+   * ProductInfo type
+   * @typedef ProductInfo
+   * @property {string} include
+   * @property {string} exclude
+   * @property {string} whatToBring
+   */
+  /**
+   * bedsAndSofas type
+   * @typedef BedsAndSofas
+   * @property {boolean} isApartment
+   * @property {numeric} count
+   * @property {string} other
+   */
+  /**
+   * Product Object
+   * @typedef {Object} Product - Product information Object
+   * @property {string} productId - A unique identifier for a product
+   * @property {string} productName
+   * @property {('accommodation'|'non-accommodation')} productType
+   * @property {string} productCode
+   * @property {string} description
+   * @property {string} notes
+   * @property {string} coverImageUrl
+   * @property {boolean} interconnectingRooms
+   * @property {string} amenities
+   * @property {ValueUnit} roomCountInfo
+   * @property {MediaCollection} media
+   * @property {ValueUnit} roomSizeInfo
+   * @property {ValueUnit} tourDuration
+   * @property {number} totalMaxPassengers
+   * @property {number} totalMinPassengers
+   * @property {ValueUnit} totalDuration
+   * @property {boolean} tourDurationDoesNotApply
+   * @property {ProductInfo} productInfo
+   * @property {BedsAndSofas} bedsAndSofas
+   */
+  getProduct() {
+    return {};
+  }
+
+  /**
+   * Get the list of products for a given location
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.locationId - A location unique identifier to get the list of products.
+   * @returns {Object} retVal - An object containing return values.
+   * @returns {Array.Product} retVal.products - An array of matching products.
+   */
+  getProducts() {
+    return { products: [] };
+  }
+
+  /**
+   * Create a Product
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {string} args.locationId - The unique identifier of the location that will contain the product.
+   * @param {Product} args.payload - The new product details.
+   * @returns {Object} retVal - An object containing return values.
+   * @returns {string} retVal.locationId - The new location unique identifier.
+   */
+  createProduct() {
+    return { locationId: chance.guid(), productId: chance.guid() };
+  }
+
+  /**
+   * Update a Product
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {string} args.locationId - The unique identifier of the location that contains the product.
+   * @param {string} args.productId - The unique identifier of the product to update.
+   * @param {Product} args.payload - The new location details.
+   * @returns {boolean} - True/False success status.
+   */
+  updateProduct() {
+    return true;
+  }
 
   searchHotelBooking = jest.fn(() => ({ bookings: [] }));
+
+  /**
+   * Booking Object
+   * @typedef {Object} Booking
+   * @property {string} id Booking unique identifier.
+   * @property {Cancelled|Active|Pending} status The currrent booking status.
+   * @property {Holder} holder Booking holder information.
+   * @property {string} telephone Contact telephone.
+   * @property {string} supplierId Supplier of the Booking
+   * @property {string} hotelId A HotelId if the booking is for an accommodation.
+   * @property {string} hotelName A Hotel Name if the booking is for an accommodation.
+   * @property {BookingRoom[]} rooms Booking Room details.
+   * @property {string} start CheckIn.
+   * @property {string} end CheckOut.
+   * @property {string} bookingDate Date when the booking was created.
+   * @property {numeric} price Total price for the booking.
+   * @property {CancelPolicy} cancelPolicy Cancellation policies for the booking.
+   */
+  /**
+   * Booking Room
+   * @typedef {Object} BookingRoom
+   * @property {string} roomId
+   * @property {string} description
+   * @property {numeric} price
+   */
+
+  /**
+   * Cancel Policy
+   * @typedef {Object} CancelPolicy
+   * @property {boolean} refundable
+   * @property {string} cancelPenalties
+   */
+
+  /**
+   * Search for bookings with a criteria.
+   * @async
+   * @param {Object} args - Booking search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.payload - Search criteria object.
+   * @param {string} args.payload.bookingId - a Booking Id.
+   * @param {string} args.payload.dateFormat - Date format sent, using [momentjs formatting](https://momentjs.com/docs/#/parsing/string-format/).
+   * @param {string} args.payload.purchaseDateStart - Date of purchase start.
+   * @param {string} args.payload.purchaseDateEnd - Date of purchase end.
+   * @param {string} args.payload.travelDateStart - Date of travel start.
+   * @param {string} args.payload.travelDateEnd - Date of travel end.
+   * @param {Holder} args.payload.holder - Search for a particular holder.
+   * @returns {object} retVal - the return object.
+   * @returns {Booking[]} retVal.bookings - Array of Bookings matchin the criteria.
+   */
+  searchBooking() {
+  }
+
+  /**
+   * Search for bookable products
+   * @async
+   * @param {Object} args - Product search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.payload - Search criteria object.
+   * @returns {object} retVal - the return object.
+   * @returns {Hotel[]} retVal.hotels - Array of bookable hotels.
+   * @returns {Product[]} retVal.products - Array of bookable activities.
+   * @todo Define search criteria and Hotel/Product spec.
+   */
+  searchProducts() {
+  }
+
+  /**
+   * Occupancy Object
+   * @typedef {Object} Occupancy
+   * @property {Pax[]} paxes
+   */
+  /**
+   * A Pax item with an age spec.
+   * @typedef {Object} Pax
+   * @property {number} age Age in years of the pax when the startDate starts on local timezone.
+   */
+  /**
+   * An availability return spec.
+   * @typedef {Object} Availability
+   * @property {string} id An identifier that can be used to retrieve a quote.
+   */
+  /**
+   * A booking holder spec.
+   * @typedef {Object} Holder
+   * @property {string} name The booking's holder first name (s).
+   * @property {string} surname Surname / Last Name(s) for the booking holder.
+   * @property {string} email The booking's holder email.
+   */
+  /**
+   * Search for availability of products winthin dates of travel.
+   * @async
+   * @param {Object} args - Availability search arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.payload - Search spect object.
+   * @param {string} args.payload.dateFormat - Date format sent, using [momentjs formatting](https://momentjs.com/docs/#/parsing/string-format/).
+   * @param {string} args.payload.travelDateStart - Date of travel start.
+   * @param {string} args.payload.travelDateEnd - Date of travel end.
+   * @param {Occupancy[]} args.payload.occupancies - Occupancy detail.
+   * @returns {object} retVal - the return object
+   * @returns {Availability[]} retVal.availability - Array of availability objects
+   */
+  searchAvailability() {
+    // return (args);
+  }
+
+  /**
+   * A quote return spec
+   * @typedef {Object} Quote
+   * @property {string} id An identifier that can be used to create a booking.
+   */
+  /**
+   * Quote an availability.
+   * @async
+   * @param {Object} args - Availability quote arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.payload - Search spect object.
+   * @param {string} args.payload.id - An availability Id.
+   * @returns {object} retVal - the return object.
+   * @returns {Quote} retVal.quote - A Quote Object instance.
+   */
+  searchQuote() {
+    // return (args);
+  }
+
+  /**
+   * Create a Booking
+   * @async
+   * @param {Object} args - Booking arguments.
+   * @param {Object} args.token - A token definition, it's content varies between integrations.
+   * @param {Object} args.payload - Search spect object.
+   * @param {string} args.payload.id - A quote id.
+   * @param {Holder} args.payload.holder - Contact information of the booking holder.
+   * @returns {object} retVal - the return object.
+   * @returns {Booking} retVal.booking - A Booking object.
+   */
+  createBooking() {}
 }
 
 module.exports = Plugin;