From 0787f6988460cb4efce2ef5e118ab34bfbec82e9 Mon Sep 17 00:00:00 2001
From: Ibby <ibby93@gmail.com>
Date: Tue, 6 Dec 2016 09:03:39 -0500
Subject: [PATCH] docs(card-io): document interfaces

---
 src/plugins/card-io.ts | 190 ++++++++++++++++++++++++++++-------------
 1 file changed, 133 insertions(+), 57 deletions(-)

diff --git a/src/plugins/card-io.ts b/src/plugins/card-io.ts
index 6347b657c..e0a8c824c 100644
--- a/src/plugins/card-io.ts
+++ b/src/plugins/card-io.ts
@@ -1,5 +1,134 @@
 import { Cordova, Plugin } from './plugin';
 
+
+export interface CardIOOptions {
+
+  /**
+   * Set to true to require expiry date
+   */
+  requireExpiry?: boolean;
+
+  /**
+   * 	The user will be prompted for the card CVV
+   */
+  requireCVV?: boolean;
+
+  /**
+   * The user will be prompted for the card billing postal code.
+   */
+  requirePostalCode?: boolean;
+
+  /**
+   * 	Removes the keyboard button from the scan screen.
+   */
+  supressManual?: boolean;
+
+  /**
+   * The postal code will only collect numeric input. Set this if you know the expected country's postal code has only numeric postal codes.
+   */
+  restrictPostalCodeToNumericOnly?: boolean;
+
+  /**
+   * The theme for the card.io Activity's will be set to the theme of the application.
+   */
+  keepApplicationTheme?: boolean;
+
+  /**
+   * The user will be prompted for the cardholder name
+   */
+  requireCardholderName?: boolean;
+
+  /**
+   * Used to display instructions to the user while they are scanning their card.
+   */
+  scanInstructions?: string;
+
+  /**
+   * 	If set, the card will not be scanned with the camera.
+   */
+  noCamera?: boolean;
+
+  /**
+   * If scanExpiry is true, an attempt to extract the expiry from the card image will be made.
+   */
+  scanExpiry?: boolean;
+
+  /**
+   * The preferred language for all strings appearing in the user interface. If not set, or if set to null, defaults to the device's current language setting.
+   */
+  languageOrLocale?: string;
+
+  /**
+   * Changes the color of the guide overlay on the camera. The color is provided in hexadecimal format (e.g. `#FFFFFF`)
+   */
+  guideColor?: string;
+
+  /**
+   * The user will not be prompted to confirm their card number after processing.
+   */
+  supressConfirmation?: boolean;
+
+  /**
+   * The card.io logo will not be shown overlaid on the camera.
+   */
+  hideCardIOLogo?: boolean;
+
+  /**
+   * The card.io logo will be shown instead of the PayPal logo.
+   */
+  useCardIOLogo?: boolean;
+
+  /**
+   * Once a card image has been captured but before it has been processed, this value will determine whether to continue processing as usual.
+   */
+  supressScan?: boolean;
+
+}
+
+export interface CardIOResponse {
+
+  /**
+   * Card type
+   */
+  cardType: string;
+
+  /**
+   * Masked card number, showing only last 4 digits
+   */
+  redactedCardNumber: string;
+
+  /**
+   * Full card number
+   */
+  cardNumber: string;
+
+  /**
+   * Expiry month
+   */
+  expiryMonth: number;
+
+  /**
+   * Expiry year
+   */
+  expiryYear: number;
+
+  /**
+   * CVV
+   */
+  cvv: string;
+
+  /**
+   * Postal code
+   */
+  postalCode: string;
+
+  /**
+   * Cardholder name
+   */
+  cardholderName: string;
+
+}
+
 /**
  * @name CardIO
  * @description
@@ -22,10 +151,13 @@ import { Cordova, Plugin } from './plugin';
  *     }
  *   );
  * ```
+ * @interfaces
+ * CardIOOptions
+ * CardIOResponse
  */
 @Plugin({
   pluginName: 'CardIO',
-  plugin: 'https://github.com/card-io/card.io-Cordova-Plugin',
+  plugin: 'card.io.cordova.mobilesdk',
   pluginRef: 'CardIO',
   repo: 'https://github.com/card-io/card.io-Cordova-Plugin',
   platforms: ['iOS', 'Android']
@@ -57,59 +189,3 @@ export class CardIO {
   static version(): Promise<string> { return; }
 
 }
-
-export interface CardIOOptions {
-
-  requireExpiry?: boolean;
-
-  requireCVV?: boolean;
-
-  requirePostalCode?: boolean;
-
-  supressManual?: boolean;
-
-  restrictPostalCodeToNumericOnly?: boolean;
-
-  keepApplicationTheme?: boolean;
-
-  requireCardholderName?: boolean;
-
-  scanInstructions?: string;
-
-  noCamera?: boolean;
-
-  scanExpiry?: boolean;
-
-  languageOrLocale?: string;
-
-  guideColor?: string;
-
-  supressConfirmation?: boolean;
-
-  hideCardIOLogo?: boolean;
-
-  useCardIOLogo?: boolean;
-
-  supressScan?: boolean;
-
-}
-
-export interface CardIOResponse {
-
-  cardType: string;
-
-  redactedCardNumber: string;
-
-  cardNumber: string;
-
-  expiryMonth: number;
-
-  expiryYear: number;
-
-  cvv: string;
-
-  postalCode: string;
-
-  cardholderName: string;
-
-}