react-native-insider 7.1.0 → 8.0.0

package/src/InsiderAppCardsError.js

@@ -0,0 +1,69 @@
+/**
+ * Error codes for App Cards operations.
+ *
+ * These codes are aligned with the native SDK error codes on both Android and iOS:
+ * - Android: AppCardsException.AppCardsExceptionCode
+ * - iOS: InsiderAppCardsErrorCode
+ *
+ * @readonly
+ * @enum {string}
+ */
+const InsiderAppCardsErrorCode = Object.freeze({
+  UNKNOWN: 'unknown',
+  SDK_NOT_INITIALIZED: 'sdkNotInitialized',
+  INVALID_PARAMETER: 'invalidParameter',
+  NETWORK_ERROR: 'networkError',
+  SERVER_ERROR: 'serverError',
+  PARSE_ERROR: 'parseError',
+});
+
+/**
+ * Represents a typed error from an App Cards operation.
+ *
+ * Extends the standard Error class with a structured error code
+ * that maps to the native SDK error codes on both Android and iOS.
+ */
+class InsiderAppCardsError extends Error {
+  #code;
+
+  /**
+   * @param {string} code - One of InsiderAppCardsErrorCode values.
+   * @param {string} message - A human-readable error description.
+   */
+  constructor(code, message) {
+    super(message);
+    this.name = 'InsiderAppCardsError';
+    this.#code = code;
+  }
+
+  /**
+   * The error code identifying the type of error.
+   * @returns {string} One of InsiderAppCardsErrorCode values.
+   */
+  get code() {
+    return this.#code;
+  }
+
+  /**
+   * Creates an InsiderAppCardsError from a native bridge error response.
+   *
+   * The native bridge sends either:
+   * - A structured object: { code: string, message: string }
+   * - A plain string (legacy/fallback)
+   *
+   * @param {Object|string} error - The error from the native bridge.
+   * @returns {InsiderAppCardsError}
+   */
+  static from(error) {
+    if (error && typeof error === 'object' && error.code && error.message) {
+      return new InsiderAppCardsError(error.code, error.message);
+    }
+
+    return new InsiderAppCardsError(
+      InsiderAppCardsErrorCode.UNKNOWN,
+      typeof error === 'string' ? error : 'An unexpected error occurred.'
+    );
+  }
+}
+
+export { InsiderAppCardsError, InsiderAppCardsErrorCode };

package/src/Util.js

@@ -34,6 +34,16 @@ export function showParameterWarningLog(functionName, parameters = []) {
   );
 }
 
+export function resolveWithCallback(promise, completion) {
+  if (typeof completion === 'function') {
+    promise
+      .then((v) => completion(null, v))
+      .catch((e) => completion(e, null));
+    return;
+  }
+  return promise;
+}
+
 export function isPlainObject(value) {
   if (value === null || typeof value !== 'object') {
     return false;