react-native-fast-image 9.0.3 → 9.2.0

package/dist/index.cjs.web.js.flow

@@ -73,6 +73,8 @@ export type CachePathResult =
     | {| ok: true, path: string |}
     | {| ok: false, error: string |}
 
+export type ClearCacheResult = {| ok: true |} | {| ok: false, error: string |}
+
 export type Transition = $ReadOnly<{|
     duration?: ?number,
     betweenImages?: ?boolean,
@@ -147,8 +149,8 @@ declare export default class FastImage extends React$Component<FastImageProps> {
     static priority: Priority;
     static cacheControl: CacheControl;
     static preload: PreloadFn;
-    static clearMemoryCache: () => Promise<void>;
-    static clearDiskCache: () => Promise<void>;
+    static clearMemoryCache: () => Promise<ClearCacheResult>;
+    static clearDiskCache: () => Promise<ClearCacheResult>;
     static getCachePath: (source: FastImageSource) => Promise<CachePathResult>;
     static configureCache: (limits?: CacheLimits) => Promise<CacheState>;
     static writeToCache: (

package/dist/index.d.ts

@@ -208,6 +208,16 @@ export type CachePathResult = {
     ok: false;
     error: string;
 };
+/**
+ * `clearMemoryCache`'s and `clearDiskCache`'s result: `ok` once the cache is
+ * cleared, or not `ok` with the error.
+ */
+export type ClearCacheResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
 /**
  * `onProgress`'s event: `nativeEvent` has the bytes `loaded` and the `total`,
  * and `progress`, `loaded / total` from 0 to 1.
@@ -454,7 +464,9 @@ export interface FastImageProps extends AccessibilityProps, ViewProps {
     onLoad?(event: OnLoadEvent): void;
     /**
      * Called on an image fetching error, with a message describing it (e.g.
-     * the HTTP status code).
+     * the HTTP status code). On iOS and Android, a download that gets nothing
+     * from the server for 15 seconds fails too (on Android, unless the app's
+     * OkHttp client has timeouts of its own).
      *
      * @example
      * ```jsx
@@ -529,8 +541,18 @@ export interface FastImageStaticProperties {
     priority: typeof priority;
     cacheControl: typeof cacheControl;
     preload: (sources: Source[]) => Promise<PreloadResult[]>;
-    clearMemoryCache: () => Promise<void>;
-    clearDiskCache: () => Promise<void>;
+    /**
+     * Removes every image from the memory cache. Resolves once it's done, or
+     * not `ok` with the error if it couldn't (Android: Glide failed to
+     * start). Never rejects.
+     */
+    clearMemoryCache: () => Promise<ClearCacheResult>;
+    /**
+     * Removes every image from the disk cache, and the HTTP cache of
+     * `cache: 'web'` images. Resolves once it's done, or not `ok` with the
+     * error if it couldn't (Android: Glide failed to start). Never rejects.
+     */
+    clearDiskCache: () => Promise<ClearCacheResult>;
     /**
      * The path of the source's downloaded file in the disk cache, downloading
      * it first if it isn't there (without decoding it). With
@@ -550,10 +572,14 @@ export interface FastImageStaticProperties {
     /**
      * Changes the cache's limits at runtime (only those given; 0 for no
      * limit, null to go back to the app's native config) and saves them, then
-     * resolves with the limits in effect and the disk cache's size. Without
-     * limits, only resolves. iOS applies changes at once. Android only has
-     * `maxDiskSize`, applied when Glide starts: at once if no image has
-     * loaded yet, otherwise from the next launch.
+     * resolves with the limits in effect and the disk cache's size; without
+     * limits, it only resolves with them. iOS applies changes at once.
+     * Android only has `maxDiskSize`, applied when Glide starts: at once if
+     * it hasn't started yet in this launch, otherwise from the next launch.
+     * FastImage starts it when its first view is created (before the view has
+     * a source), and for `preload`, `getCachePath`, `writeToCache`,
+     * `clearDiskCache` and `configureCache` itself, even without limits (e.g.
+     * to read the disk cache's size).
      */
     configureCache: (limits?: CacheLimits) => Promise<CacheState>;
 }

package/dist/index.js

@@ -218,8 +218,8 @@ FastImage.preload = (sources) => Promise.resolve(NativeModules.FastImageView.pre
 		uri
 	};
 }));
-FastImage.clearMemoryCache = () => NativeModules.FastImageView.clearMemoryCache();
-FastImage.clearDiskCache = () => NativeModules.FastImageView.clearDiskCache();
+FastImage.clearMemoryCache = () => Promise.resolve(NativeModules.FastImageView.clearMemoryCache());
+FastImage.clearDiskCache = () => Promise.resolve(NativeModules.FastImageView.clearDiskCache());
 FastImage.configureCache = (limits = {}) => Promise.resolve(NativeModules.FastImageView.configureCache(limits));
 FastImage.writeToCache = (source, file) => Array.isArray(source) ? Promise.resolve({
 	ok: false,

package/dist/index.js.flow

@@ -73,6 +73,8 @@ export type CachePathResult =
     | {| ok: true, path: string |}
     | {| ok: false, error: string |}
 
+export type ClearCacheResult = {| ok: true |} | {| ok: false, error: string |}
+
 export type Transition = $ReadOnly<{|
     duration?: ?number,
     betweenImages?: ?boolean,
@@ -147,8 +149,8 @@ declare export default class FastImage extends React$Component<FastImageProps> {
     static priority: Priority;
     static cacheControl: CacheControl;
     static preload: PreloadFn;
-    static clearMemoryCache: () => Promise<void>;
-    static clearDiskCache: () => Promise<void>;
+    static clearMemoryCache: () => Promise<ClearCacheResult>;
+    static clearDiskCache: () => Promise<ClearCacheResult>;
     static getCachePath: (source: FastImageSource) => Promise<CachePathResult>;
     static configureCache: (limits?: CacheLimits) => Promise<CacheState>;
     static writeToCache: (

package/dist/index.web.js

@@ -212,8 +212,8 @@ FastImage.preload = (sources) => Promise.all(sources.map((source) => {
 		uri
 	}));
 }));
-FastImage.clearMemoryCache = () => Promise.resolve();
-FastImage.clearDiskCache = () => Promise.resolve();
+FastImage.clearMemoryCache = () => Promise.resolve(notSupported);
+FastImage.clearDiskCache = () => Promise.resolve(notSupported);
 FastImage.configureCache = () => Promise.resolve({});
 FastImage.writeToCache = () => Promise.resolve(notSupported);
 FastImage.getCachePath = () => Promise.resolve(notSupported);

package/dist/index.web.js.flow

@@ -73,6 +73,8 @@ export type CachePathResult =
     | {| ok: true, path: string |}
     | {| ok: false, error: string |}
 
+export type ClearCacheResult = {| ok: true |} | {| ok: false, error: string |}
+
 export type Transition = $ReadOnly<{|
     duration?: ?number,
     betweenImages?: ?boolean,
@@ -147,8 +149,8 @@ declare export default class FastImage extends React$Component<FastImageProps> {
     static priority: Priority;
     static cacheControl: CacheControl;
     static preload: PreloadFn;
-    static clearMemoryCache: () => Promise<void>;
-    static clearDiskCache: () => Promise<void>;
+    static clearMemoryCache: () => Promise<ClearCacheResult>;
+    static clearDiskCache: () => Promise<ClearCacheResult>;
     static getCachePath: (source: FastImageSource) => Promise<CachePathResult>;
     static configureCache: (limits?: CacheLimits) => Promise<CacheState>;
     static writeToCache: (

package/ios/FastImage/FFFastImageViewManager.m

@@ -467,7 +467,7 @@ RCT_EXPORT_METHOD(configureCache:(NSDictionary *)limits
 RCT_EXPORT_METHOD(clearMemoryCache:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 {
     [SDImageCache.sharedImageCache clearMemory];
-    resolve(NULL);
+    resolve(@{@"ok": @YES});
 }
 
 RCT_EXPORT_METHOD(clearDiskCache:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
@@ -475,7 +475,7 @@ RCT_EXPORT_METHOD(clearDiskCache:(RCTPromiseResolveBlock)resolve reject:(RCTProm
     // And the HTTP cache of `cache: 'web'` images.
     [FFFastImageSource.webURLCache removeAllCachedResponses];
     [SDImageCache.sharedImageCache clearDiskOnCompletion:^(){
-        resolve(NULL);
+        resolve(@{@"ok": @YES});
     }];
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-fast-image",
-    "version": "9.0.3",
+    "version": "9.2.0",
     "description": "FastImage, performant React Native image component.",
     "keywords": [
         "cache",