@revenuecat/purchases-typescript-internal 19.2.0 → 19.3.0

package/dist/errorNormalizer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Fills in the fields {@link PurchasesError} declares but the platform bridges
+ * leave nested.
+ *
+ * Hybrid SDKs should call this on every error rejected by the native module,
+ * then rethrow the returned value.
+ *
+ * The error is mutated in place and returned. Copying it into a new object
+ * would discard its prototype and stack, which would break `instanceof Error`
+ * for consumers and `instanceof CapacitorException` on Capacitor.
+ *
+ * Values the bridge did not send fall back to the same defaults the native
+ * layer already applies, so the result always satisfies {@link PurchasesError}.
+ *
+ * Anything that is not an object, or that carries no error code, is returned
+ * untouched.
+ *
+ * @public
+ */
+export declare function normalizePurchasesError(error: unknown): unknown;

package/dist/errorNormalizer.js

@@ -0,0 +1,108 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePurchasesError = normalizePurchasesError;
+var error_codes_1 = require("./generated/error-codes");
+/**
+ * React Native nests `ErrorContainer.info` under `userInfo`, Capacitor under `data`,
+ * and `purchases-js-hybrid-mappings` under `info`.
+ */
+var PAYLOAD_KEYS = ["userInfo", "data", "info"];
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function readPayload(error) {
+    for (var _i = 0, PAYLOAD_KEYS_1 = PAYLOAD_KEYS; _i < PAYLOAD_KEYS_1.length; _i++) {
+        var key = PAYLOAD_KEYS_1[_i];
+        var candidate = error[key];
+        if (isRecord(candidate)) {
+            return candidate;
+        }
+    }
+    return {};
+}
+function firstString() {
+    var values = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        values[_i] = arguments[_i];
+    }
+    for (var _a = 0, values_1 = values; _a < values_1.length; _a++) {
+        var value = values_1[_a];
+        if (typeof value === "string") {
+            return value;
+        }
+    }
+    return "";
+}
+/**
+ * Every code the SDK emits is a PURCHASES_ERROR_CODE value, which is always numeric.
+ * Plugin level rejections use names such as "UNIMPLEMENTED" or "PAYWALL_ERROR" and are
+ * not ours to touch.
+ *
+ * Deliberately looser than PURCHASES_ERROR_CODE membership: that enum omits codes the
+ * native SDKs emit (36 to 41), and Android and iOS disagree on 28 and 36, so matching
+ * against it would reject genuine errors.
+ */
+function readCode(error, payload) {
+    var _a;
+    var candidate = (_a = error.code) !== null && _a !== void 0 ? _a : payload.code;
+    var code = String(candidate);
+    return /^\d+$/.test(code) ? code : undefined;
+}
+/**
+ * Fills in the fields {@link PurchasesError} declares but the platform bridges
+ * leave nested.
+ *
+ * Hybrid SDKs should call this on every error rejected by the native module,
+ * then rethrow the returned value.
+ *
+ * The error is mutated in place and returned. Copying it into a new object
+ * would discard its prototype and stack, which would break `instanceof Error`
+ * for consumers and `instanceof CapacitorException` on Capacitor.
+ *
+ * Values the bridge did not send fall back to the same defaults the native
+ * layer already applies, so the result always satisfies {@link PurchasesError}.
+ *
+ * Anything that is not an object, or that carries no error code, is returned
+ * untouched.
+ *
+ * @public
+ */
+function normalizePurchasesError(error) {
+    if (!isRecord(error)) {
+        return error;
+    }
+    var payload = readPayload(error);
+    var code = readCode(error, payload);
+    if (code === undefined) {
+        return error;
+    }
+    error.code = code;
+    var userInfo = __assign({}, payload);
+    if (typeof userInfo.readableErrorCode !== "string") {
+        userInfo.readableErrorCode = firstString(payload.readableErrorCode, error.readableErrorCode);
+    }
+    error.userInfo = userInfo;
+    if (typeof error.message !== "string" || error.message === "") {
+        error.message = firstString(payload.message);
+    }
+    if (typeof error.readableErrorCode !== "string") {
+        error.readableErrorCode = userInfo.readableErrorCode;
+    }
+    if (typeof error.underlyingErrorMessage !== "string") {
+        error.underlyingErrorMessage = firstString(payload.underlyingErrorMessage);
+    }
+    // The bridges only send a userCancelled flag on purchase flows, derived from this code.
+    error.userCancelled = code === error_codes_1.PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR;
+    return error;
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './errors';
+export * from './errorNormalizer';
 export * from './customerInfo';
 export * from './offerings';
 export * from './enums';

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./errors"), exports);
+__exportStar(require("./errorNormalizer"), exports);
 __exportStar(require("./customerInfo"), exports);
 __exportStar(require("./offerings"), exports);
 __exportStar(require("./enums"), exports);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@revenuecat/purchases-typescript-internal",
   "title": "Purchases typescript internal shared code",
-  "version": "19.2.0",
+  "version": "19.3.0",
   "description": "Typescript code to be used by RevenueCat's hybrid SDKs. Not meant for external usage.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,8 @@
   ],
   "scripts": {
     "apitests": "tsc --p apitesters/",
-    "lint": "eslint",
+    "lint": "eslint src",
+    "test": "jest",
     "build": "tsc",
     "build-watch": "tsc --watch",
     "extract-api": "api-extractor run --local --verbose"
@@ -32,9 +33,12 @@
   "packageManager": "yarn@1.22.22",
   "devDependencies": {
     "@microsoft/api-extractor": "^7.43.1",
+    "@types/jest": "^29.5.14",
     "@typescript-eslint/eslint-plugin": "^5.61.0",
     "@typescript-eslint/parser": "^5.61.0",
     "eslint": "^8.44.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
     "typescript": "^5.1.6"
   }
 }