react-native-revnix 1.5.0 → 1.6.0

package/src/ui/RevnixPaywall.tsx

@@ -34,11 +34,12 @@ import type {
   PaywallConfig,
   PaywallInteraction,
   PaywallPurchaseOutcome,
+  PlacementResolution,
   RegisterPurchaseResult,
 } from "../types.js";
 import { PREVIEW_PLACEMENT_KEY } from "../implicit.js";
 import { getStoreAdapter } from "../store.js";
-import type { RevnixClient } from "../client.js";
+import { paywallImageUrls, type RevnixClient } from "../client.js";
 import type { PaywallBlockDoc } from "../blocks/types.js";
 import type { FontFamilyMap } from "../blocks/style.js";
 import { withAlpha } from "../blocks/color.js";
@@ -255,6 +256,19 @@ export interface RevnixPaywallProps {
   locale?: string;
 }
 
+/** Warms React Native's image cache with every image `resolution`'s paywall
+ *  loads, so it paints without waiting on the network. Pair it with
+ *  `client.preload` / `resolvePlacement`. Never throws. */
+export async function prefetchPaywallImages(
+  resolution: PlacementResolution | null
+): Promise<void> {
+  await Promise.all(
+    paywallImageUrls(resolution?.paywall).map((url) =>
+      Image.prefetch(url).catch(() => false)
+    )
+  );
+}
+
 export function RevnixPaywall(props: RevnixPaywallProps) {
   // One view per mount: remounting (a re-shown paywall) is a genuine new
   // display; re-renders are not.

package/src/ui/index.ts

@@ -2,6 +2,7 @@ export {
   RevnixPaywall,
   DEFAULT_PAYWALL_THEME,
   LIGHT_PAYWALL_THEME,
+  prefetchPaywallImages,
   type RevnixPaywallPackage,
   type RevnixPaywallProps,
   type RevnixPaywallTheme,

package/src/version.ts

@@ -1,4 +1,4 @@
 // L3: the single source of the SDK version inside src/. Must match
 // package.json "version" — version.test.ts fails the build when they drift
 // (they had: client.ts said 0.7.0 while the package shipped 0.9.0).
-export const SDK_VERSION = "1.5.0";
+export const SDK_VERSION = "1.6.0";