@appzung/react-native-code-push 10.0.0 → 10.1.0

package/lib/typescript/module/src/enums/SyncStatus.enum.d.ts

@@ -3,26 +3,26 @@
  */
 export declare enum SyncStatus {
     /**
-     * The app is up-to-date with the CodePush server.
+     * The app is fully up-to-date with the configured release channel.
      */
     UP_TO_DATE = 0,
     /**
      * An available update has been installed and will be run either immediately after the
-     * syncStatusChangedCallback function returns or the next time the app resumes/restarts,
-     * depending on the InstallMode specified in SyncOptions
+     * `syncStatusChangedCallback` function returns or the next time the app resumes/restarts,
+     * depending on the `InstallMode` specified in `SyncOptions`
      */
     UPDATE_INSTALLED = 1,
     /**
      * The app had an optional update which the end user chose to ignore.
-     * (This is only applicable when the updateDialog is used)
+     * (This is only applicable when the `updateDialog` is used)
      */
     UPDATE_IGNORED = 2,
     /**
-     * The sync operation encountered an unknown error.
+     * The `sync` operation encountered an unknown error.
      */
     UNKNOWN_ERROR = 3,
     /**
-     * There is an ongoing sync operation running which prevents the current call from being executed.
+     * There is an ongoing `sync` operation running which prevents the current call from being executed.
      */
     SYNC_IN_PROGRESS = 4,
     /**
@@ -31,7 +31,7 @@ export declare enum SyncStatus {
     CHECKING_FOR_UPDATE = 5,
     /**
      * An update is available, and a confirmation dialog was shown
-     * to the end user. (This is only applicable when the updateDialog is used)
+     * to the end user. (This is only applicable when the `updateDialog` is used)
      */
     AWAITING_USER_ACTION = 6,
     /**

package/lib/typescript/module/src/enums/UpdateState.enum.d.ts

@@ -3,18 +3,19 @@
  */
 export declare enum UpdateState {
     /**
-     * Indicates that an update represents the
-     * version of the app that is currently running.
+     * Indicates that an update represents the version of the app that is currently running.
+     *
+     * This can be useful for identifying attributes about the app, for scenarios such as displaying the release description in a "what's new?" dialog or reporting the latest version to an analytics and/or crash reporting service.
      */
     RUNNING,
     /**
-     * Indicates than an update has been installed, but the
-     * app hasn't been restarted yet in order to apply it.
+     * Indicates than an update has been installed, but the app hasn't been restarted yet in order to apply it.
+     *
+     * This can be useful for determining whether there is a pending update, which you may want to force a programmatic restart (via `restartApp`) in order to apply.
      */
     PENDING,
     /**
-     * Indicates than an update represents the latest available
-     * release, and can be either currently running or pending.
+     * Indicates than an update represents the latest available release, and can be either currently running or pending.
      */
     LATEST
 }

package/lib/typescript/module/src/enums/UpdateState.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpdateState.enum.d.ts","sourceRoot":"","sources":["../../../../../src/enums/UpdateState.enum.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,WAAW;IACrB;;;OAGG;IACH,OAAiF;IAEjF;;;OAGG;IACH,OAAiF;IAEjF;;;OAGG;IACH,MAA+E;CAChF"}
+{"version":3,"file":"UpdateState.enum.d.ts","sourceRoot":"","sources":["../../../../../src/enums/UpdateState.enum.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,WAAW;IACrB;;;;OAIG;IACH,OAAiF;IAEjF;;;;OAIG;IACH,OAAiF;IAEjF;;OAEG;IACH,MAA+E;CAChF"}

package/lib/typescript/module/src/getClientUniqueId.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Gets the client's unique ID set by the module. You may also see `resetClientUniqueId`.
+ */
+export declare const getClientUniqueId: () => Promise<string>;
+//# sourceMappingURL=getClientUniqueId.d.ts.map

package/lib/typescript/module/src/getClientUniqueId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getClientUniqueId.d.ts","sourceRoot":"","sources":["../../../../src/getClientUniqueId.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,iBAAiB,uBAG7B,CAAC"}

package/lib/typescript/module/src/index.d.ts

@@ -8,6 +8,8 @@ export * from './getUpdateMetadata';
 export * from './notifyAppReady';
 export * from './restartApp';
 export * from './sync';
+export * from './getClientUniqueId';
+export * from './resetClientUniqueId';
 export * from './types';
 export * from './enums/SyncStatus.enum';
 export * from './enums/InstallMode.enum';

package/lib/typescript/module/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AAEvB,cAAc,SAAS,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,SAAS,CAAC;AAExB,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC"}

package/lib/typescript/module/src/internals/RNAppZungCodePushModuleSpec.d.ts

@@ -16,6 +16,7 @@ export interface Spec extends TurboModule {
         codePushUpdateStateRunning: number;
     };
     getConfiguration(): Promise<Configuration>;
+    resetClientUniqueId(): Promise<string>;
     getUpdateMetadata(updateState: UpdateState): Promise<OmitFunctions<LocalPackage>>;
     installUpdate(localPackage: OmitFunctions<LocalPackage>, installMode: InstallMode, minimumBackgroundDuration: number): Promise<void>;
     downloadUpdate(remotePackage: OmitFunctions<RemotePackage>, notifyProgress: boolean): Promise<OmitFunctions<LocalPackage>>;

package/lib/typescript/module/src/internals/RNAppZungCodePushModuleSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RNAppZungCodePushModuleSpec.d.ts","sourceRoot":"","sources":["../../../../../src/internals/RNAppZungCodePushModuleSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC,YAAY,IAAI;QACd,4BAA4B,EAAE,MAAM,CAAC;QACrC,gCAAgC,EAAE,MAAM,CAAC;QACzC,+BAA+B,EAAE,MAAM,CAAC;QACxC,gCAAgC,EAAE,MAAM,CAAC;QAEzC,yBAAyB,EAAE,MAAM,CAAC;QAClC,0BAA0B,EAAE,MAAM,CAAC;QACnC,0BAA0B,EAAE,MAAM,CAAC;KACpC,CAAC;IAEF,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3C,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAClF,aAAa,CACX,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,EACzC,WAAW,EAAE,WAAW,EACxB,yBAAyB,EAAE,MAAM,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CACZ,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,EAC3C,cAAc,EAAE,OAAO,GACtB,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAExC,UAAU,CAAC,qBAAqB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,YAAY,IAAI,IAAI,CAAC;IAErB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IACvD,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAE3D,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAErD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD"}
+{"version":3,"file":"RNAppZungCodePushModuleSpec.d.ts","sourceRoot":"","sources":["../../../../../src/internals/RNAppZungCodePushModuleSpec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC,YAAY,IAAI;QACd,4BAA4B,EAAE,MAAM,CAAC;QACrC,gCAAgC,EAAE,MAAM,CAAC;QACzC,+BAA+B,EAAE,MAAM,CAAC;QACxC,gCAAgC,EAAE,MAAM,CAAC;QAEzC,yBAAyB,EAAE,MAAM,CAAC;QAClC,0BAA0B,EAAE,MAAM,CAAC;QACnC,0BAA0B,EAAE,MAAM,CAAC;KACpC,CAAC;IAEF,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAClF,aAAa,CACX,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,EACzC,WAAW,EAAE,WAAW,EACxB,yBAAyB,EAAE,MAAM,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CACZ,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,EAC3C,cAAc,EAAE,OAAO,GACtB,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAExC,UAAU,CAAC,qBAAqB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,YAAY,IAAI,IAAI,CAAC;IAErB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5C,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IACvD,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAE3D,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAErD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD"}

package/lib/typescript/module/src/internals/getConfiguration.d.ts

@@ -1,3 +1,4 @@
 import type { Configuration } from './types';
 export declare function getConfiguration(): Promise<Configuration>;
+export declare function reloadCachedConfiguration(): Promise<void>;
 //# sourceMappingURL=getConfiguration.d.ts.map

package/lib/typescript/module/src/internals/getConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getConfiguration.d.ts","sourceRoot":"","sources":["../../../../../src/internals/getConfiguration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,wBAAsB,gBAAgB,2BAMrC"}
+{"version":3,"file":"getConfiguration.d.ts","sourceRoot":"","sources":["../../../../../src/internals/getConfiguration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,wBAAsB,gBAAgB,2BAMrC;AAED,wBAAsB,yBAAyB,kBAE9C"}

package/lib/typescript/module/src/internals/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "10.0.0";
+export declare const version = "10.1.0";
 //# sourceMappingURL=version.d.ts.map

package/lib/typescript/module/src/notifyAppReady.d.ts

@@ -1,6 +1,8 @@
 import type { StatusReport } from './types';
 /**
  * Notifies the CodePush runtime that an installed update is considered successful.
+ *
+ * If you are manually checking for and installing updates (i.e. not using the `sync` method to handle it all for you), then this method **MUST** be called; otherwise CodePush will treat the update as failed and rollback to the previous version when the app next restarts.
  */
 export declare const notifyAppReady: () => Promise<void | StatusReport>;
 //# sourceMappingURL=notifyAppReady.d.ts.map

package/lib/typescript/module/src/notifyAppReady.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifyAppReady.d.ts","sourceRoot":"","sources":["../../../../src/notifyAppReady.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,cAAc,oCAYvB,CAAC"}
+{"version":3,"file":"notifyAppReady.d.ts","sourceRoot":"","sources":["../../../../src/notifyAppReady.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,cAAc,oCAYvB,CAAC"}

package/lib/typescript/module/src/resetClientUniqueId.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resets the client's unique ID. You may use this in some GDPR compliance scenarios. Note that this will create a new MAU if a new request is sent later.
+ */
+export declare const resetClientUniqueId: () => Promise<string>;
+//# sourceMappingURL=resetClientUniqueId.d.ts.map

package/lib/typescript/module/src/resetClientUniqueId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resetClientUniqueId.d.ts","sourceRoot":"","sources":["../../../../src/resetClientUniqueId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,mBAAmB,uBAI/B,CAAC"}

package/lib/typescript/module/src/restartApp.d.ts

@@ -1,6 +1,8 @@
 /**
  * Immediately restarts the app.
  *
+ * If there is an update pending, it will be immediately displayed to the end user. Otherwise, calling this method simply has the same behavior as the end user killing and restarting the process.
+ *
  * @param onlyIfUpdateIsPending Indicates whether you want the restart to no-op if there isn't currently a pending update.
  */
 export declare function restartApp(onlyIfUpdateIsPending?: boolean): Promise<void>;

package/lib/typescript/module/src/restartApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"restartApp.d.ts","sourceRoot":"","sources":["../../../../src/restartApp.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,qBAAqB,UAAQ,iBAE7D"}
+{"version":3,"file":"restartApp.d.ts","sourceRoot":"","sources":["../../../../src/restartApp.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,qBAAqB,UAAQ,iBAE7D"}

package/lib/typescript/module/src/sync.d.ts

@@ -8,10 +8,12 @@ export declare const DEFAULT_UPDATE_DIALOG: UpdateDialog;
 /**
  * Allows checking for an update, downloading it and installing it, all with a single call.
  *
+ * Unless you need custom UI and/or behavior, we recommend most developers to use this method when integrating CodePush into their apps, if they are not using the `withCodePush` HOC.
+ *
  * @param options Options used to configure the end-user update experience (e.g. show a prompt?, install the update immediately?).
  * @param syncStatusChangedCallback An optional callback that allows tracking the status of the sync operation, as opposed to simply checking the resolved state via the returned Promise.
  * @param downloadProgressCallback An optional callback that allows tracking the progress of an update while it is being downloaded.
  * @param handleBinaryVersionMismatchCallback An optional callback for handling target binary version mismatch
  */
-export declare const sync: (options?: SyncOptions, syncStatusChangeCallback?: SyncStatusChangedCallback, downloadProgressCallback?: DownloadProgressCallback, handleBinaryVersionMismatchCallback?: HandleBinaryVersionMismatchCallback) => Promise<SyncStatus>;
+export declare const sync: (options?: SyncOptions, syncStatusChangedCallback?: SyncStatusChangedCallback, downloadProgressCallback?: DownloadProgressCallback, handleBinaryVersionMismatchCallback?: HandleBinaryVersionMismatchCallback) => Promise<SyncStatus>;
 //# sourceMappingURL=sync.d.ts.map

package/lib/typescript/module/src/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/sync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD,OAAO,KAAK,EACV,wBAAwB,EACxB,mCAAmC,EACnC,WAAW,EACX,yBAAyB,EACzB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,YASnC,CAAC;AAgLF;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,aAUH,WAAW,6BACM,yBAAyB,6BACzB,wBAAwB,wCACb,mCAAmC,KACxE,OAAO,CAAC,UAAU,CA4CnB,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/sync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD,OAAO,KAAK,EACV,wBAAwB,EACxB,mCAAmC,EACnC,WAAW,EACX,yBAAyB,EACzB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,YASnC,CAAC;AAgLF;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,aAUH,WAAW,8BACO,yBAAyB,6BAC1B,wBAAwB,wCACb,mCAAmC,KACxE,OAAO,CAAC,UAAU,CA4CnB,CAAC"}

package/lib/typescript/module/src/types.d.ts

@@ -5,42 +5,68 @@ import type { SyncStatus } from './enums/SyncStatus.enum';
 export interface UpdateDialog {
     /**
      * Indicates whether you would like to append the description of an available release to the
-     * notification message which is displayed to the end user. Defaults to false.
+     * notification message which is displayed to the end user.
+     *
+     * Defaults to false.
      */
     appendReleaseDescription?: boolean;
     /**
      * Indicates the string you would like to prefix the release description with, if any, when
-     * displaying the update notification to the end user. Defaults to " Description: "
+     * displaying the update notification to the end user.
+     *
+     * Defaults to " Description: "
      */
     descriptionPrefix?: string;
     /**
-     * The text to use for the button the end user must press in order to install a mandatory update. Defaults to "Continue".
+     * The text to use for the button the end user must press in order to install a mandatory update.
+     *
+     * Defaults to "Continue".
      */
     mandatoryContinueButtonLabel?: string;
     /**
      * The text used as the body of an update notification, when the update is specified as mandatory.
+     *
      * Defaults to "An update is available that must be installed.".
      */
     mandatoryUpdateMessage?: string;
     /**
-     * The text to use for the button the end user can press in order to ignore an optional update that is available. Defaults to "Ignore".
+     * The text to use for the button the end user can press in order to ignore an optional update that is available.
+     *
+     * Defaults to "Ignore".
      */
     optionalIgnoreButtonLabel?: string;
     /**
-     * The text to use for the button the end user can press in order to install an optional update. Defaults to "Install".
+     * The text to use for the button the end user can press in order to install an optional update.
+     *
+     * Defaults to "Install".
      */
     optionalInstallButtonLabel?: string;
     /**
-     * The text used as the body of an update notification, when the update is optional. Defaults to "An update is available. Would you like to install it?".
+     * The text used as the body of an update notification, when the update is optional.
+     *
+     * Defaults to "An update is available. Would you like to install it?".
      */
     optionalUpdateMessage?: string;
     /**
-     * The text used as the header of an update notification that is displayed to the end user. Defaults to "Update available".
+     * The text used as the header of an update notification that is displayed to the end user.
+     *
+     * Defaults to "Update available".
      */
     title?: string;
 }
+/**
+ * Called periodically when an available update is being downloaded from the CodePush server.
+ */
 export type DownloadProgressCallback = (progress: DownloadProgress) => void;
+/**
+ * Called when the sync process moves from one stage to another in the overall update process.
+ *
+ * The method is called with a status code which represents the current state, and can be any of the `SyncStatus` values.
+ */
 export type SyncStatusChangedCallback = (status: SyncStatus) => void;
+/**
+ * Called when there are any binary update available.
+ */
 export type HandleBinaryVersionMismatchCallback = (update: NativeUpdateNotification) => void;
 export interface DownloadProgress {
     /**
@@ -52,6 +78,9 @@ export interface DownloadProgress {
      */
     receivedBytes: number;
 }
+/**
+ * Represents a downloaded update that is either already running, or has been installed and is pending an app restart.
+ */
 export interface LocalPackage extends Package {
     /**
      * Installs the update by saving it to the location on disk where the runtime expects to find the latest version of the app.
@@ -65,7 +94,7 @@ export interface LocalPackage extends Package {
 export interface Package {
     /**
      * The app binary version that this update is dependent on. This is the value that was
-     * specified via the appStoreVersion parameter when calling the CLI's release command.
+     * specified via the --target-binary-version parameter when calling the CLI's release command.
      */
     appVersion: string;
     /**
@@ -78,10 +107,14 @@ export interface Package {
     description: string;
     /**
      * Indicates whether this update has been previously installed but was rolled back.
+     *
+     * The `sync` method will automatically ignore updates which have previously failed, so you only need to worry about this property if using `checkForUpdate`.
      */
     failedInstall: boolean;
     /**
      * Indicates whether this is the first time the update has been run after being installed.
+     *
+     * This is useful for determining whether you would like to show a "What's New?" UI to the end user after installing an update.
      */
     isFirstRun: boolean;
     /**
@@ -106,6 +139,9 @@ export interface Package {
      */
     packageSize: number;
 }
+/**
+ * Represents an available update on the CodePush server that hasn't been downloaded yet.
+ */
 export interface RemotePackage extends Package {
     /**
      * Downloads the available update from the CodePush service.
@@ -115,24 +151,28 @@ export interface RemotePackage extends Package {
     download(downloadProgressCallback?: DownloadProgressCallback): Promise<LocalPackage>;
     /**
      * The URL at which the package is available for download.
+     *
+     * This property is only needed for advanced usage, since the `download` method will automatically handle the acquisition of updates for you.
      */
     downloadUrl: string;
 }
 export interface SyncOptions {
     /**
-     * Specifies the release channel you want to query for an update against. By default, this value is derived from the Info.plist
-     * file (iOS) and strings resources (Android), but this option allows you to override it from the script-side if you need to
-     * dynamically use a different release channel for a specific call to sync.
+     * Specifies the release channel you want to query for an update against.
+     *
+     * By default, this value is derived from the Info.plist file (iOS) and strings resources (Android), but this option allows you to override it from the JS-side if you need to dynamically use a different release channel for a specific call to sync.
      */
     releaseChannelPublicId?: string;
     /**
-     * Specifies when you would like to install optional updates (i.e. those that aren't marked as mandatory).
-     * Defaults to codePush.InstallMode.ON_NEXT_RESTART.
+     * Specifies when you would like to install regular updates (i.e. those that aren't marked as mandatory).
+     *
+     * Defaults to InstallMode.ON_NEXT_RESTART.
      */
     installMode?: InstallMode;
     /**
      * Specifies when you would like to install updates which are marked as mandatory.
-     * Defaults to codePush.InstallMode.IMMEDIATE.
+     *
+     * Defaults to InstallMode.IMMEDIATE.
      */
     mandatoryInstallMode?: InstallMode;
     /**
@@ -143,31 +183,33 @@ export interface SyncOptions {
      */
     minimumBackgroundDuration?: number;
     /**
-     * An "options" object used to determine whether a confirmation dialog should be displayed to the end user when an update is available,
-     * and if so, what strings to use. Defaults to null, which has the effect of disabling the dialog completely. Setting this to any truthy
-     * value will enable the dialog with the default strings, and passing an object to this parameter allows enabling the dialog as well as
-     * overriding one or more of the default strings.
+     * Used to determine whether a confirmation dialog should be displayed to the end user when an update is available, and if so, what strings to use.
+     *
+     * Defaults to null, which has the effect of disabling the dialog completely.
+     * Setting this to true will enable the dialog with the default strings, and passing an object to this parameter allows enabling the dialog as well as overriding one or more of the default strings.
      */
     updateDialog?: UpdateDialog | true;
     /**
-     * The rollback retry mechanism allows the application to attempt to reinstall an update that was previously rolled back (with the restrictions
-     * specified in the options). It is an "options" object used to determine whether a rollback retry should occur, and if so, what settings to use
-     * for the rollback retry. This defaults to null, which has the effect of disabling the retry mechanism. Setting this to true will enable
-     * the retry mechanism with the default settings, and passing an object to this parameter allows enabling the rollback retry as well as overriding
-     * one or more of the default values.
+     * The rollback retry mechanism allows the application to attempt to reinstall an update that was previously rolled back (with the restrictions specified in the options).
+     *
+     * This defaults to null, which has the effect of disabling the retry mechanism.
+     * Setting this to true will enable the retry mechanism with the default settings, and passing an object to this parameter allows enabling the rollback retry as well as overriding one or more of the default values.
      */
     rollbackRetryOptions?: RollbackRetryOptions | true;
     ignoreFailedUpdates?: boolean;
 }
 export interface RollbackRetryOptions {
     /**
-     * Specifies the minimum time in hours that the app will wait after the latest rollback
-     * before attempting to reinstall same rolled-back package. Defaults to `24`.
+     * Specifies the minimum time in hours that the app will wait after the latest rollback before attempting to reinstall same rolled-back package.
+     *
+     * Defaults to `24`.
      */
     delayInHours?: number;
     /**
      * Specifies the maximum number of retry attempts that the app can make before it stops trying.
-     * Cannot be less than `1`. Defaults to `1`.
+     * Cannot be less than `1`.
+     *
+     * Defaults to `1`.
      */
     maxRetryAttempts?: number;
 }

package/lib/typescript/module/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appzung/react-native-code-push",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "description": "React Native plugin for the CodePush service",
   "author": "Louis Lagrange <lagrange.louis@gmail.com> (https://github.com/Minishlink)",
   "license": "MIT",
@@ -44,7 +44,7 @@
     "test:types": "tsc --noEmit",
     "test:format": "prettier --check \"{src,docs}/**/*.{ts,js,md}\" README.md react-native.config.js",
     "tslint": "tslint -c tslint.json test/**/*.ts",
-    "prepare": "genversion src/internals/version.ts --esm -s && bob build"
+    "prepare": "genversion src/internals/version.ts --esm -s && typedoc && bob build"
   },
   "repository": {
     "type": "git",
@@ -77,6 +77,8 @@
     "shx": "^0.3.4",
     "slash": "^3.0.0",
     "tslint": "^6.1.3",
+    "typedoc": "^0.27.7",
+    "typedoc-plugin-markdown": "^4.4.2",
     "typescript": "^5.7.3"
   },
   "react-native-builder-bob": {

package/src/CodePush.tsx

@@ -14,25 +14,32 @@ import type {
 export interface CodePushOptions extends SyncOptions {
   /**
    * Specifies when you would like to synchronize updates with the CodePush server.
-   * Defaults to codePush.CheckFrequency.ON_APP_START.
+   *
+   * Defaults to CheckFrequency.ON_APP_START.
    */
   checkFrequency?: CheckFrequency;
 }
 
 /**
- * Decorates a React Component configuring it to sync for updates with the CodePush server.
+ * Wraps a React component inside a "higher order" React component that knows how to synchronize your app's JavaScript bundle and image assets when it is mounted.
+ *
+ * Internally, the higher-order component calls `sync` inside its `componentDidMount` lifecycle handle, which in turns performs an update check, downloads the update if it exists and installs the update for you.
  *
  * @param component the React Component that will be decorated
  */
 // @ts-ignore
-export function withCodePush(component: any): React.FunctionComponent;
+export function withCodePush<P extends object>(component: React.ComponentType<P>): React.ComponentType;
 
 /**
- * Decorates a React Component configuring it to sync for updates with the CodePush server.
+ * Wraps a React component inside a "higher order" React component that knows how to synchronize your app's JavaScript bundle and image assets when it is mounted.
+ *
+ * Internally, the higher-order component calls `sync` inside its `componentDidMount` lifecycle handle, which in turns performs an update check, downloads the update if it exists and installs the update for you.
  *
  * @param options Options used to configure the end-user sync and update experience (e.g. when to check for updates?, show a prompt?, install the update immediately?).
  */
-export function withCodePush(options: CodePushOptions): (component: any) => React.FunctionComponent;
+export function withCodePush<P extends object>(
+  options: CodePushOptions,
+): (component: React.ComponentType<P>) => React.ComponentType;
 
 export function withCodePush<P extends object>(optionsOrComponent: CodePushOptions | React.ComponentType<P>) {
   const options: CodePushOptions = typeof optionsOrComponent === 'function' ? {} : optionsOrComponent;

package/src/allowRestart.ts

@@ -2,5 +2,7 @@ import { NativeRNAppZungCodePushModule } from './internals/NativeRNAppZungCodePu
 
 /**
  * Allow CodePush to restart the app.
+ *
+ * This is an advanced API and is only necessary if your app explicitly disallowed restarts via the `disallowRestart` method.
  */
 export const allowRestart: () => void = NativeRNAppZungCodePushModule.allow;

package/src/clearUpdates.ts

@@ -2,8 +2,9 @@ import { NativeRNAppZungCodePushModule } from './internals/NativeRNAppZungCodePu
 
 /**
  * Clears all downloaded CodePush updates.
+ *
  * This is useful when switching to a different release channel which may have an older release than the current package.
- * Note: we don’t recommend to use this method in scenarios other than that (CodePush will call
+ * Note: we don’t recommend using this method in scenarios other than that (CodePush will call
  * this method automatically when needed in other cases) as it could lead to unpredictable behavior.
  */
 export const clearUpdates: () => void = NativeRNAppZungCodePushModule.clearUpdates;

package/src/disallowRestart.ts

@@ -2,5 +2,7 @@ import { NativeRNAppZungCodePushModule } from './internals/NativeRNAppZungCodePu
 
 /**
  * Forbid CodePush to restart the app.
+ *
+ * This is an advanced API, and is useful when a component within your app (for example an onboarding process) needs to ensure that no end-user interruptions can occur during its lifetime.
  */
 export const disallowRestart: () => void = NativeRNAppZungCodePushModule.disallow;

package/src/enums/CheckFrequency.enum.ts

@@ -8,12 +8,12 @@ export enum CheckFrequency {
   ON_APP_START,
 
   /**
-   * When the app re-enters the foreground.
+   * When the app re-enters the foreground after being "backgrounded" (user pressed the home button, app launches a separate payment process, etc.)
    */
   ON_APP_RESUME,
 
   /**
-   * Don't automatically check for updates, but only do it when codePush.sync() is manually called inside app code.
+   * Don't automatically check for updates, but only do it when `sync()` is manually called in app code.
    */
   MANUAL,
 }

package/src/enums/InstallMode.enum.ts

@@ -6,18 +6,22 @@ import { NativeRNAppZungCodePushModule } from '../internals/NativeRNAppZungCodeP
 export enum InstallMode {
   /**
    * Indicates that you want to install the update and restart the app immediately.
+   *
+   * This value is appropriate for debugging scenarios as well as when displaying an update prompt to the user, since they would expect to see the changes immediately after accepting the installation. Additionally, this mode can be used to enforce mandatory updates, since it removes the potentially undesired latency between the update installation and the next time the end user restarts or resumes the app.
    */
   IMMEDIATE = NativeRNAppZungCodePushModule.getConstants().codePushInstallModeImmediate,
 
   /**
    * Indicates that you want to install the update, but not forcibly restart the app.
+   *
+   * When the app is "naturally" restarted (due the OS or end user killing it), the update will be seamlessly picked up. This value is appropriate when performing silent updates, since it would likely be disruptive to the end user if the app suddenly restarted out of nowhere, since they wouldn't have realized an update was even downloaded. This is the default mode used for both the `sync` and `LocalPackage.install` methods.
    */
   ON_NEXT_RESTART = NativeRNAppZungCodePushModule.getConstants().codePushInstallModeOnNextRestart,
 
   /**
-   * Indicates that you want to install the update, but don't want to restart the app until the next time
-   * the end user resumes it from the background. This way, you don't disrupt their current session,
-   * but you can get the update in front of them sooner than having to wait for the next natural restart.
+   * Indicates that you want to install the update, but don't want to restart the app until the next time the end user resumes it from the background.
+   *
+   * This way, you don't disrupt their current session,but you can get the update in front of them sooner than having to wait for the next natural restart.
    * This value is appropriate for silent installs that can be applied on resume in a non-invasive way.
    */
   ON_NEXT_RESUME = NativeRNAppZungCodePushModule.getConstants().codePushInstallModeOnNextResume,

package/src/enums/SyncStatus.enum.ts

@@ -3,30 +3,30 @@
  */
 export enum SyncStatus {
   /**
-   * The app is up-to-date with the CodePush server.
+   * The app is fully up-to-date with the configured release channel.
    */
   UP_TO_DATE,
 
   /**
    * An available update has been installed and will be run either immediately after the
-   * syncStatusChangedCallback function returns or the next time the app resumes/restarts,
-   * depending on the InstallMode specified in SyncOptions
+   * `syncStatusChangedCallback` function returns or the next time the app resumes/restarts,
+   * depending on the `InstallMode` specified in `SyncOptions`
    */
   UPDATE_INSTALLED,
 
   /**
    * The app had an optional update which the end user chose to ignore.
-   * (This is only applicable when the updateDialog is used)
+   * (This is only applicable when the `updateDialog` is used)
    */
   UPDATE_IGNORED,
 
   /**
-   * The sync operation encountered an unknown error.
+   * The `sync` operation encountered an unknown error.
    */
   UNKNOWN_ERROR,
 
   /**
-   * There is an ongoing sync operation running which prevents the current call from being executed.
+   * There is an ongoing `sync` operation running which prevents the current call from being executed.
    */
   SYNC_IN_PROGRESS,
 
@@ -37,7 +37,7 @@ export enum SyncStatus {
 
   /**
    * An update is available, and a confirmation dialog was shown
-   * to the end user. (This is only applicable when the updateDialog is used)
+   * to the end user. (This is only applicable when the `updateDialog` is used)
    */
   AWAITING_USER_ACTION,