feat(airship): add Live Activities/Live Updates and other 19.1.0 additions

Sync the wrapper with @ua/cordova-airship 19.1.0: Live Activity manager
(iOS), Live Update manager (Android), contact email/SMS registration,
JSON attribute editing, push enableUserNotifications, iOS badge reset,
and new Feature enum values.

src/@awesome-cordova-plugins/plugins/airship/index.ts

@@ -35,7 +35,7 @@ declare const window: Window & { Airship: any };
   pluginName: 'Airship',
   plugin: '@ua/cordova-airship',
   pluginRef: 'Airship',
-  repo: 'https://www.npmjs.com/package/@ua/cordova-airship',
+  repo: 'https://github.com/urbanairship/urbanairship-cordova',
   install: 'ionic cordova plugin add @ua/cordova-airship',
   platforms: ['Android', 'iOS'],
 })
@@ -52,6 +52,14 @@ export class Airship extends AwesomeCordovaNativePlugin {
   public preferenceCenter: AirshipPreferenceCenter;
   public privacyManager: AirshipPrivacyManager;
   public push: AirshipPush;
+  /**
+   * Live Activity manager. iOS only.
+   */
+  public liveActivityManager: AirshipLiveActivityManager;
+  /**
+   * Live Update manager. Android only.
+   */
+  public liveUpdateManager: AirshipLiveUpdateManager;
 
   /**
    * Call after platform ready
@@ -257,6 +265,252 @@ export interface DisplayPreferenceCenterEvent {
   preferenceCenterId: string;
 }
 
+/**
+ * Event fired when Live Activities are updated. iOS only.
+ */
+export interface LiveActivitiesUpdatedEvent {
+  /**
+   * The Live Activities.
+   */
+  activities: LiveActivity[];
+}
+
+/**
+ * Live Activity info. iOS only.
+ */
+export interface LiveActivity {
+  /**
+   * The activity ID.
+   */
+  id: string;
+  /**
+   * The attribute types.
+   */
+  attributeTypes: string;
+  /**
+   * The content.
+   */
+  content: LiveActivityContent;
+  /**
+   * The attributes.
+   */
+  attributes: JsonObject;
+}
+
+/**
+ * Live Activity content. iOS only.
+ */
+export interface LiveActivityContent {
+  /**
+   * The content state.
+   */
+  state: JsonObject;
+  /**
+   * Optional ISO 8601 date string that defines when the Live Activity will be stale.
+   */
+  staleDate?: string;
+  /**
+   * The relevance score.
+   */
+  relevanceScore: number;
+}
+
+/**
+ * Base Live Activity request. iOS only.
+ */
+export interface LiveActivityRequest {
+  /**
+   * Attributes type. This should match the Activity type of your Live Activity.
+   */
+  attributesType: string;
+}
+
+/**
+ * Live Activity list request. iOS only.
+ */
+export type LiveActivityListRequest = LiveActivityRequest;
+
+/**
+ * Live Activity start request. iOS only.
+ */
+export interface LiveActivityStartRequest extends LiveActivityRequest {
+  /**
+   * Dynamic content.
+   */
+  content: LiveActivityContent;
+  /**
+   * Fixed attributes.
+   */
+  attributes: JsonObject;
+}
+
+/**
+ * Live Activity update request. iOS only.
+ */
+export interface LiveActivityUpdateRequest extends LiveActivityRequest {
+  /**
+   * The Live Activity ID to update.
+   */
+  activityId: string;
+  /**
+   * Dynamic content.
+   */
+  content: LiveActivityContent;
+}
+
+/**
+ * Live Activity end request. iOS only.
+ */
+export interface LiveActivityEndRequest extends LiveActivityRequest {
+  /**
+   * The Live Activity ID to end.
+   */
+  activityId: string;
+  /**
+   * Dynamic content.
+   */
+  content?: LiveActivityContent;
+  /**
+   * Dismissal policy. Defaults to `LiveActivityDismissalPolicyDefault`.
+   */
+  dismissalPolicy?: LiveActivityDismissalPolicy;
+}
+
+export type LiveActivityDismissalPolicy =
+  LiveActivityDismissalPolicyImmediate | LiveActivityDismissalPolicyDefault | LiveActivityDismissalPolicyAfterDate;
+
+/**
+ * Dismissal policy to immediately dismiss the Live Activity on end.
+ */
+export interface LiveActivityDismissalPolicyImmediate {
+  type: 'immediate';
+}
+
+/**
+ * Dismissal policy to dismiss the Live Activity after the expiration.
+ */
+export interface LiveActivityDismissalPolicyDefault {
+  type: 'default';
+}
+
+/**
+ * Dismissal policy to dismiss the Live Activity after a given date.
+ */
+export interface LiveActivityDismissalPolicyAfterDate {
+  type: 'after';
+  /**
+   * ISO 8601 date string.
+   */
+  date: string;
+}
+
+/**
+ * Live Update info. Android only.
+ */
+export interface LiveUpdate {
+  /**
+   * The Live Update name.
+   */
+  name: string;
+  /**
+   * The Live Update type.
+   */
+  type: string;
+  /**
+   * Dynamic content.
+   */
+  content: JsonObject;
+  /**
+   * ISO 8601 date string of the last content update.
+   */
+  lastContentUpdateTimestamp: string;
+  /**
+   * ISO 8601 date string of the last state update.
+   */
+  lastStateChangeTimestamp: string;
+  /**
+   * Optional ISO 8601 date string that defines when to end this Live Update.
+   */
+  dismissTimestamp?: string;
+}
+
+/**
+ * Live Update list request. Android only.
+ */
+export interface LiveUpdateListRequest {
+  type: string;
+}
+
+/**
+ * Live Update start request. Android only.
+ */
+export interface LiveUpdateStartRequest {
+  /**
+   * The Live Update name.
+   */
+  name: string;
+  /**
+   * The Live Update type.
+   */
+  type: string;
+  /**
+   * Dynamic content.
+   */
+  content: JsonObject;
+  /**
+   * Optional ISO 8601 date string, used to filter out of order updates.
+   */
+  timestamp?: string;
+  /**
+   * Optional ISO 8601 date string that defines when to end this Live Update.
+   */
+  dismissTimestamp?: string;
+}
+
+/**
+ * Live Update update request. Android only.
+ */
+export interface LiveUpdateUpdateRequest {
+  /**
+   * The Live Update name.
+   */
+  name: string;
+  /**
+   * Dynamic content.
+   */
+  content: JsonObject;
+  /**
+   * Optional ISO 8601 date string, used to filter out of order updates.
+   */
+  timestamp?: string;
+  /**
+   * Optional ISO 8601 date string that defines when to end this Live Update.
+   */
+  dismissTimestamp?: string;
+}
+
+/**
+ * Live Update end request. Android only.
+ */
+export interface LiveUpdateEndRequest {
+  /**
+   * The Live Update name.
+   */
+  name: string;
+  /**
+   * Dynamic content.
+   */
+  content?: JsonObject;
+  /**
+   * Optional ISO 8601 date string, used to filter out of order updates.
+   */
+  timestamp?: string;
+  /**
+   * Optional ISO 8601 date string that defines when to end this Live Update.
+   */
+  dismissTimestamp?: string;
+}
+
 /**
  * iOS options
  */
@@ -448,6 +702,18 @@ export interface ConfigEnvironment {
    * Optional log level.
    */
   logLevel?: LogLevel;
+
+  /**
+   * Optional iOS config.
+   */
+  ios?: {
+    /**
+     * Log privacy level. By default it logs at `private`, not logging anything lower than info to the console
+     * and redacting logs with string interpolation. `public` will log all configured log levels to the console
+     * without redacting any of the log lines.
+     */
+    logPrivacyLevel?: 'private' | 'public';
+  };
 }
 
 /**
@@ -619,12 +885,14 @@ export namespace Android {
  * Enum of authorized Features.
  */
 export enum Feature {
+  All = 'all',
   InAppAutomation = 'in_app_automation',
   MessageCenter = 'message_center',
   Push = 'push',
   Analytics = 'analytics',
   TagsAndAttributes = 'tags_and_attributes',
   Contacts = 'contacts',
+  FeatureFlags = 'feature_flags',
 }
 
 /**
@@ -996,6 +1264,17 @@ export interface AttributeEditor {
    */
   setAttribute(name: string, value: string | number | boolean | Date): AttributeEditor;
 
+  /**
+   * Adds a JSON attribute.
+   *
+   * @param name The attribute name.
+   * @param instanceId The instance ID.
+   * @param json The json value. Must not contain `exp` as top level key.
+   * @param expiration Optional expiration.
+   * @return The attribute editor instance.
+   */
+  setJsonAttribute(name: string, instanceId: string, json: Record<string, any>, expiration?: Date): AttributeEditor;
+
   /**
    * Removes an attribute.
    * @param name The name of the attribute to remove.
@@ -1003,6 +1282,14 @@ export interface AttributeEditor {
    */
   removeAttribute(name: string): AttributeEditor;
 
+  /**
+   * Removes a JSON attribute.
+   * @param name The name of the attribute to remove.
+   * @param instanceId The instance ID.
+   * @return The attribute editor instance.
+   */
+  removeJsonAttribute(name: string, instanceId: string): AttributeEditor;
+
   /**
    * Applies the attribute operations.
    * @param success Success callback.
@@ -1044,6 +1331,15 @@ class AirshipPush {
     return;
   }
 
+  /**
+   * Enables user notifications and prompts the user for permission, if needed.
+   * @returns Whether user notifications are enabled after the request.
+   */
+  @CordovaInstance()
+  enableUserNotifications(): Promise<boolean> {
+    return;
+  }
+
   /**
    * Gets the notification status.
    */
@@ -1186,6 +1482,13 @@ export interface AirshipPushIOS {
    */
   getBadgeNumber(success: (badge: number) => void, error?: (err: string) => void): void;
 
+  /**
+   * Resets the badge number to zero.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  resetBadge(success?: () => void, error?: (err: string) => void): void;
+
   /**
    * Gets the list of authorized notification settings.
    * @param success Success callback.
@@ -1550,6 +1853,41 @@ export interface AirshipFeatureFlagManager {
   trackInteraction(flag: FeatureFlag, success?: () => void, error?: (err: string) => void): void;
 }
 
+/**
+ * Options for email channel registration.
+ */
+export interface EmailRegistrationOptions {
+  /**
+   * Transactional opt-in date as milliseconds since epoch.
+   */
+  transactionalOptedIn?: number;
+
+  /**
+   * Commercial opt-in date as milliseconds since epoch.
+   */
+  commercialOptedIn?: number;
+
+  /**
+   * Custom properties for the email channel.
+   */
+  properties?: Record<string, string>;
+
+  /**
+   * Request double opt-in for commercial messages when `commercialOptedIn` is not set.
+   */
+  doubleOptIn?: boolean;
+}
+
+/**
+ * Options for SMS channel registration.
+ */
+export interface SmsRegistrationOptions {
+  /**
+   * The sender ID.
+   */
+  senderId: string;
+}
+
 /**
  * Airship contact.
  */
@@ -1620,6 +1958,26 @@ class AirshipContact {
   reset(): Promise<void> {
     return;
   }
+
+  /**
+   * Registers an email channel for the contact.
+   * @param email The email address.
+   * @param options Registration options.
+   */
+  @CordovaInstance()
+  registerEmail(email: string, options: EmailRegistrationOptions): Promise<void> {
+    return;
+  }
+
+  /**
+   * Registers an SMS channel for the contact.
+   * @param msisdn The MSISDN, including country code.
+   * @param options Registration options.
+   */
+  @CordovaInstance()
+  registerSMS(msisdn: string, options: SmsRegistrationOptions): Promise<void> {
+    return;
+  }
 }
 
 /**
@@ -1765,3 +2123,114 @@ export interface AirshipActions {
     error?: (err: string) => void
   ): void;
 }
+
+/**
+ * Live Activity manager. iOS only.
+ */
+export interface AirshipLiveActivityManager {
+  /**
+   * Lists any Live Activities for the request.
+   * @param request The request options.
+   * @param success Success callback with the list.
+   * @param error Error callback.
+   */
+  list(
+    request: LiveActivityListRequest,
+    success: (activities: LiveActivity[]) => void,
+    error?: (err: string) => void
+  ): void;
+
+  /**
+   * Lists all Live Activities.
+   * @param success Success callback with the list.
+   * @param error Error callback.
+   */
+  listAll(success: (activities: LiveActivity[]) => void, error?: (err: string) => void): void;
+
+  /**
+   * Starts a Live Activity.
+   * @param request The request options.
+   * @param success Success callback with the started activity.
+   * @param error Error callback.
+   */
+  start(
+    request: LiveActivityStartRequest,
+    success: (activity: LiveActivity) => void,
+    error?: (err: string) => void
+  ): void;
+
+  /**
+   * Updates a Live Activity.
+   * @param request The request options.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  update(request: LiveActivityUpdateRequest, success?: () => void, error?: (err: string) => void): void;
+
+  /**
+   * Ends a Live Activity.
+   * @param request The request options.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  end(request: LiveActivityEndRequest, success?: () => void, error?: (err: string) => void): void;
+
+  /**
+   * Live Activities updated listener.
+   *
+   * @param callback The callback.
+   * @return A cancellable that can be used to cancel the listener.
+   */
+  onLiveActivitiesUpdated(callback: (event: LiveActivitiesUpdatedEvent) => void): Cancellable;
+}
+
+/**
+ * Live Update manager. Android only.
+ */
+export interface AirshipLiveUpdateManager {
+  /**
+   * Lists any Live Updates for the request.
+   * @param request The request options.
+   * @param success Success callback with the list.
+   * @param error Error callback.
+   */
+  list(request: LiveUpdateListRequest, success: (updates: LiveUpdate[]) => void, error?: (err: string) => void): void;
+
+  /**
+   * Lists all Live Updates.
+   * @param success Success callback with the list.
+   * @param error Error callback.
+   */
+  listAll(success: (updates: LiveUpdate[]) => void, error?: (err: string) => void): void;
+
+  /**
+   * Starts a Live Update.
+   * @param request The request options.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  start(request: LiveUpdateStartRequest, success?: () => void, error?: (err: string) => void): void;
+
+  /**
+   * Updates a Live Update.
+   * @param request The request options.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  update(request: LiveUpdateUpdateRequest, success?: () => void, error?: (err: string) => void): void;
+
+  /**
+   * Ends a Live Update.
+   * @param request The request options.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  end(request: LiveUpdateEndRequest, success?: () => void, error?: (err: string) => void): void;
+
+  /**
+   * Clears all Live Updates.
+   * @param success Success callback.
+   * @param error Error callback.
+   */
+  clearAll(success?: () => void, error?: (err: string) => void): void;
+}

src/@awesome-cordova-plugins/plugins/in-app-browser/index.ts

@@ -44,11 +44,12 @@ export interface InAppBrowserOptions {
   /** (Android Only) Set to a valid hex color string, for example #00ff00 or #CC00ff00 (#aarrggbb), and it will change the footer color from default. Only has effect if user has footer set to yes */
   footercolor?: string;
   /**
-   * (Android Only) Sets whether the InappBrowser WebView is displayed fullscreen or not. In fullscreen mode, the status bar is hidden. Default value is yes.
+   * (Windows only) Set to yes to create the browser control without a border around it.
+   * Please note that if location=no is also specified, there will be no control presented to user to close IAB window.
    */
   fullscreen?: 'yes' | 'no';
   /**
-   * (Android Only) Set to yes to use the hardware back button to navigate backwards through the InAppBrowser's history.
+   * (Android & Windows Only) Set to yes to use the hardware back button to navigate backwards through the InAppBrowser's history.
    * If there is no previous page, the InAppBrowser will close. The default value is yes, so you must set it to no if you want the back button to simply close the InAppBrowser.
    */
   hardwareback?: 'yes' | 'no';
@@ -68,11 +69,7 @@ export interface InAppBrowserOptions {
   hidespinner?: 'yes' | 'no';
   /** (Android) Set to yes to hide the url bar on the location toolbar, only has effect if user has location set to yes. The default value is no. */
   hideurlbar?: 'yes' | 'no';
-  /**
-   * (iOS Only) Set to yes or no to open the keyboard when form elements receive focus via JavaScript's focus() call (defaults to yes).
-   *
-   * @deprecated UIWebView-only option, removed upstream in cordova-plugin-inappbrowser 4.0.0. iOS always uses WKWebView now.
-   */
+  /** (iOS Only) Set to yes or no to open the keyboard when form elements receive focus via JavaScript's focus() call (defaults to yes). */
   keyboardDisplayRequiresUserAction?: 'yes' | 'no';
   /**
    * (Android) Set to yes to swap positions of the navigation buttons and the close button. Specifically, navigation buttons go to the left and close button to the right.
@@ -94,11 +91,7 @@ export interface InAppBrowserOptions {
   presentationstyle?: 'pagesheet' | 'formsheet' | 'fullscreen';
   /** (Android Only) Set to yes to make InAppBrowser WebView to pause/resume with the app to stop background audio (this may be required to avoid Google Play issues) */
   shouldPauseOnSuspend?: 'yes' | 'no';
-  /**
-   * (iOS Only) Set to yes or no to wait until all new view content is received before being rendered (defaults to no).
-   *
-   * @deprecated UIWebView-only option, removed upstream in cordova-plugin-inappbrowser 4.0.0. iOS always uses WKWebView now.
-   */
+  /** (iOS Only) Set to yes or no to wait until all new view content is received before being rendered (defaults to no). */
   suppressesIncrementalRendering?: 'yes' | 'no';
   /** (iOS Only) Set to yes or no to turn the toolbar on or off for the InAppBrowser (defaults to yes) */
   toolbar?: 'yes' | 'no';
@@ -115,19 +108,10 @@ export interface InAppBrowserOptions {
   transitionstyle?: 'fliphorizontal' | 'crossdissolve' | 'coververtical';
   /** (Android Only) Sets whether the WebView should enable support for the "viewport" HTML meta tag or should use a wide viewport. When the value of the setting is no, the layout width is always set to the width of the WebView control in device-independent (CSS) pixels. When the value is yes and the page contains the viewport meta tag, the value of the width specified in the tag is used. If the page does not contain the tag or does not provide a width, then a wide viewport will be used. (defaults to yes). */
   useWideViewPort?: 'yes' | 'no';
-  /**
-   * (iOS Only) Set to yes to use WKWebView engine for the InappBrowser. Omit or set to no (default) to use UIWebView.
-   *
-   * @deprecated UIWebView was removed upstream in cordova-plugin-inappbrowser 4.0.0. iOS always uses WKWebView now, making this option a no-op.
-   */
+  /** (iOS Only) Set to yes to use WKWebView engine for the InappBrowser. Omit or set to no (default) to use UIWebView. */
   usewkwebview?: 'yes' | 'no';
-  /** (Android Only) Enables the pinch-to-zoom gesture. Set to no to disable it. Default value is yes. */
+  /** (Android Only) Set to yes to show Android browser's zoom controls, set to no to hide them. Default value is yes. */
   zoom?: 'yes' | 'no';
-  /**
-   * (Android Only) Set to yes to show Android browser's zoom controls, set to no to hide them. Default value is yes.
-   * The zoom controls are deprecated since Android API Level 26 (Android 8); Google recommends disabling them.
-   */
-  zoomcontrols?: 'yes' | 'no';
   /**
    * @hidden
    */
@@ -142,9 +126,7 @@ export type InAppBrowserEventType =
   | 'beforeload'
   | 'message'
   | 'customscheme'
-  /** (Android Only) Fires when the InAppBrowser loads a URL that leads to downloading of a file. */
-  | 'download'
-  | string;
+  | string
 
 export interface InAppBrowserEvent extends Event {
   /** the event name */
@@ -263,6 +245,7 @@ export class InAppBrowserObject {
       return () => this._objectInstance.removeEventListener(event, observer.next.bind(observer));
     });
   }
+
 }
 
 /**
@@ -302,7 +285,7 @@ export class InAppBrowserObject {
   plugin: 'cordova-plugin-inappbrowser',
   pluginRef: 'cordova.InAppBrowser',
   repo: 'https://github.com/apache/cordova-plugin-inappbrowser',
-  platforms: ['Android', 'Browser', 'iOS'],
+  platforms: ['AmazonFire OS', 'Android', 'Browser', 'iOS', 'macOS', 'Windows'],
 })
 @Injectable()
 export class InAppBrowser extends AwesomeCordovaNativePlugin {