react-native-cloud-storage 1.5.1 → 2.0.0

package/lib/commonjs/index.js

@@ -26,7 +26,6 @@ Object.defineProperty(exports, "CloudStorageErrorCode", {
     return _native.CloudStorageErrorCode;
   }
 });
-exports.default = void 0;
 var _RNCloudStorage = _interopRequireDefault(require("./RNCloudStorage"));
 var _native = require("./types/native");
 var _main = require("./types/main");
@@ -66,10 +65,5 @@ Object.keys(_useIsCloudAvailable).forEach(function (key) {
   });
 });
 var _CloudStorageError = _interopRequireDefault(require("./utils/CloudStorageError"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * @deprecated Use the named export `CloudStorage` instead.
- */
-var _default = _RNCloudStorage.default;
-exports.default = _default;
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_RNCloudStorage","_interopRequireDefault","require","_native","_main","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_useCloudFile","_useIsCloudAvailable","_CloudStorageError","obj","__esModule","default","_default","RNCloudStorage"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,eAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AAAAG,MAAA,CAAAC,IAAA,CAAAF,KAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAJ,KAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAZ,KAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,aAAA,GAAAf,OAAA;AAAAG,MAAA,CAAAC,IAAA,CAAAW,aAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAS,aAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,aAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AACA,IAAAU,oBAAA,GAAAhB,OAAA;AAAAG,MAAA,CAAAC,IAAA,CAAAY,oBAAA,EAAAX,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAU,oBAAA,CAAAV,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,oBAAA,CAAAV,GAAA;IAAA;EAAA;AAAA;AACA,IAAAW,kBAAA,GAAAlB,sBAAA,CAAAC,OAAA;AAA0D,SAAAD,uBAAAmB,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,KAAAE,OAAA,EAAAF,GAAA;AAI1D;AACA;AACA;AAFA,IAAAG,QAAA,GAGeC,uBAAc;AAAAX,OAAA,CAAAS,OAAA,GAAAC,QAAA"}
+{"version":3,"names":["_RNCloudStorage","_interopRequireDefault","require","_native","_main","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_useCloudFile","_useIsCloudAvailable","_CloudStorageError","e","__esModule","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,eAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAD,OAAA;AACA,IAAAE,KAAA,GAAAF,OAAA;AAAAG,MAAA,CAAAC,IAAA,CAAAF,KAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAJ,KAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAZ,KAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,aAAA,GAAAf,OAAA;AAAAG,MAAA,CAAAC,IAAA,CAAAW,aAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAS,aAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,aAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AACA,IAAAU,oBAAA,GAAAhB,OAAA;AAAAG,MAAA,CAAAC,IAAA,CAAAY,oBAAA,EAAAX,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAU,oBAAA,CAAAV,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,oBAAA,CAAAV,GAAA;IAAA;EAAA;AAAA;AACA,IAAAW,kBAAA,GAAAlB,sBAAA,CAAAC,OAAA;AAA0D,SAAAD,uBAAAmB,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/types/main.js

@@ -3,11 +3,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.CloudStorageScope = void 0;
-let CloudStorageScope = /*#__PURE__*/function (CloudStorageScope) {
+exports.CloudStorageScope = exports.CloudStorageProvider = void 0;
+/* Custom utility type to make properties required, but still allow null if defined */
+let CloudStorageScope = exports.CloudStorageScope = /*#__PURE__*/function (CloudStorageScope) {
   CloudStorageScope["Documents"] = "documents";
   CloudStorageScope["AppData"] = "app_data";
   return CloudStorageScope;
 }({});
-exports.CloudStorageScope = CloudStorageScope;
+let CloudStorageProvider = exports.CloudStorageProvider = /*#__PURE__*/function (CloudStorageProvider) {
+  CloudStorageProvider["ICloud"] = "icloud";
+  CloudStorageProvider["GoogleDrive"] = "googledrive";
+  return CloudStorageProvider;
+}({});
 //# sourceMappingURL=main.js.map

package/lib/commonjs/types/main.js.map

@@ -1 +1 @@
-{"version":3,"names":["CloudStorageScope","exports"],"sourceRoot":"../../../src","sources":["types/main.ts"],"mappings":";;;;;;IAAYA,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA;AAAAC,OAAA,CAAAD,iBAAA,GAAAA,iBAAA"}
+{"version":3,"names":["CloudStorageScope","exports","CloudStorageProvider"],"sourceRoot":"../../../src","sources":["types/main.ts"],"mappings":";;;;;;AAAA;AAAA,IAKYA,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA;AAAA,IAejBE,oBAAoB,GAAAD,OAAA,CAAAC,oBAAA,0BAApBA,oBAAoB;EAApBA,oBAAoB;EAApBA,oBAAoB;EAAA,OAApBA,oBAAoB;AAAA","ignoreList":[]}

package/lib/commonjs/types/native.js

@@ -4,7 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.CloudStorageErrorCode = void 0;
-let CloudStorageErrorCode = /*#__PURE__*/function (CloudStorageErrorCode) {
+let CloudStorageErrorCode = exports.CloudStorageErrorCode = /*#__PURE__*/function (CloudStorageErrorCode) {
+  CloudStorageErrorCode["INVALID_SCOPE"] = "ERR_INVALID_SCOPE";
   CloudStorageErrorCode["FILE_NOT_FOUND"] = "ERR_FILE_NOT_FOUND";
   CloudStorageErrorCode["PATH_IS_FILE"] = "ERR_PATH_IS_FILE";
   CloudStorageErrorCode["PATH_IS_DIRECTORY"] = "ERR_PATH_IS_DIRECTORY";
@@ -19,8 +20,7 @@ let CloudStorageErrorCode = /*#__PURE__*/function (CloudStorageErrorCode) {
   CloudStorageErrorCode["STAT_ERROR"] = "ERR_STAT_ERROR";
   CloudStorageErrorCode["UNKNOWN"] = "ERR_UNKNOWN";
   CloudStorageErrorCode["FILE_NOT_DOWNLOADABLE"] = "ERR_FILE_NOT_DOWNLOADABLE";
-  CloudStorageErrorCode["GOOGLE_DRIVE_ACCESS_TOKEN_MISSING"] = "ERR_GOOGLE_DRIVE_ACCESS_TOKEN_MISSING";
+  CloudStorageErrorCode["ACCESS_TOKEN_MISSING"] = "ERR_ACCESS_TOKEN_MISSING";
   return CloudStorageErrorCode;
 }({});
-exports.CloudStorageErrorCode = CloudStorageErrorCode;
 //# sourceMappingURL=native.js.map

package/lib/commonjs/types/native.js.map

@@ -1 +1 @@
-{"version":3,"names":["CloudStorageErrorCode","exports"],"sourceRoot":"../../../src","sources":["types/native.ts"],"mappings":";;;;;;IAUYA,qBAAqB,0BAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAAA,OAArBA,qBAAqB;AAAA;AAAAC,OAAA,CAAAD,qBAAA,GAAAA,qBAAA"}
+{"version":3,"names":["CloudStorageErrorCode","exports"],"sourceRoot":"../../../src","sources":["types/native.ts"],"mappings":";;;;;;IAUYA,qBAAqB,GAAAC,OAAA,CAAAD,qBAAA,0BAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAArBA,qBAAqB;EAAA,OAArBA,qBAAqB;AAAA","ignoreList":[]}

package/lib/commonjs/utils/CloudStorageError.js

@@ -11,6 +11,5 @@ class CloudStorageError extends Error {
     this.details = details;
   }
 }
-var _default = CloudStorageError;
-exports.default = _default;
+var _default = exports.default = CloudStorageError;
 //# sourceMappingURL=CloudStorageError.js.map

package/lib/commonjs/utils/CloudStorageError.js.map

@@ -1 +1 @@
-{"version":3,"names":["CloudStorageError","Error","constructor","message","code","details","_default","exports","default"],"sourceRoot":"../../../src","sources":["utils/CloudStorageError.ts"],"mappings":";;;;;;AAEA,MAAMA,iBAAiB,SAASC,KAAK,CAAC;EAIpCC,WAAWA,CAACC,OAAe,EAAEC,IAA2B,EAAEC,OAAa,EAAE;IACvE,KAAK,CAACF,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,OAAO,GAAGA,OAAO;EACxB;AACF;AAAC,IAAAC,QAAA,GAEcN,iBAAiB;AAAAO,OAAA,CAAAC,OAAA,GAAAF,QAAA"}
+{"version":3,"names":["CloudStorageError","Error","constructor","message","code","details","_default","exports","default"],"sourceRoot":"../../../src","sources":["utils/CloudStorageError.ts"],"mappings":";;;;;;AAEA,MAAMA,iBAAiB,SAASC,KAAK,CAAC;EAIpCC,WAAWA,CAACC,OAAe,EAAEC,IAA2B,EAAEC,OAAa,EAAE;IACvE,KAAK,CAACF,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAGA,IAAI;IAChB,IAAI,CAACC,OAAO,GAAGA,OAAO;EACxB;AACF;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcR,iBAAiB","ignoreList":[]}

package/lib/commonjs/utils/helpers.js

@@ -3,21 +3,14 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.verifyLeadingSlash = void 0;
-/**
- * Checks if the path starts with a leading slash and adds one if it doesn't to maintain backwards compatibility.
- * Will log a warning to the console if it had to add a leading slash. Will throw an error in the future.
- *
- * @param path The path to check.
- * @returns The path with a leading slash, if it didn't have one already.
- * @private
- */
-const verifyLeadingSlash = path => {
-  if (!path.startsWith('/')) {
-    console.warn(`[react-native-cloud-storage] Path "${path}" did not start with a leading slash. This is deprecated and will be an error in the future.`);
-    return `/${path}`;
+exports.isProviderSupported = void 0;
+var _main = require("../types/main");
+var _reactNative = require("react-native");
+const isProviderSupported = provider => {
+  if (_reactNative.Platform.OS !== 'ios' && provider === _main.CloudStorageProvider.ICloud) {
+    return false;
   }
-  return path;
+  return true;
 };
-exports.verifyLeadingSlash = verifyLeadingSlash;
+exports.isProviderSupported = isProviderSupported;
 //# sourceMappingURL=helpers.js.map

package/lib/commonjs/utils/helpers.js.map

@@ -1 +1 @@
-{"version":3,"names":["verifyLeadingSlash","path","startsWith","console","warn","exports"],"sourceRoot":"../../../src","sources":["utils/helpers.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,kBAAkB,GAAIC,IAAY,IAAK;EAClD,IAAI,CAACA,IAAI,CAACC,UAAU,CAAC,GAAG,CAAC,EAAE;IACzBC,OAAO,CAACC,IAAI,CACT,sCAAqCH,IAAK,8FAA6F,CACzI;IACD,OAAQ,IAAGA,IAAK,EAAC;EACnB;EACA,OAAOA,IAAI;AACb,CAAC;AAACI,OAAA,CAAAL,kBAAA,GAAAA,kBAAA"}
+{"version":3,"names":["_main","require","_reactNative","isProviderSupported","provider","Platform","OS","CloudStorageProvider","ICloud","exports"],"sourceRoot":"../../../src","sources":["utils/helpers.ts"],"mappings":";;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAEO,MAAME,mBAAmB,GAAIC,QAA8B,IAAc;EAC9E,IAAIC,qBAAQ,CAACC,EAAE,KAAK,KAAK,IAAIF,QAAQ,KAAKG,0BAAoB,CAACC,MAAM,EAAE;IACrE,OAAO,KAAK;EACd;EAEA,OAAO,IAAI;AACb,CAAC;AAACC,OAAA,CAAAN,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/lib/module/RNCloudStorage.js

@@ -1,125 +1,285 @@
-import { Platform } from 'react-native';
-import createRNCloudStorage from './createRNCloudStorage';
+"use strict";
+
+import { CloudStorageProvider, CloudStorageScope } from './types/main';
+import { isProviderSupported } from './utils/helpers';
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
+import CloudStorageError from './utils/CloudStorageError';
+import { CloudStorageErrorCode } from './types/native';
 import GoogleDrive from './google-drive';
-import { CloudStorageScope } from './types/main';
-import { verifyLeadingSlash } from './utils/helpers';
-const nativeInstance = createRNCloudStorage();
-let defaultScope = CloudStorageScope.AppData;
-const RNCloudStorage = {
-  getDefaultScope: () => defaultScope,
-  setDefaultScope: scope => defaultScope = scope,
-  getGoogleDriveAccessToken: () => GoogleDrive.accessToken,
-  setGoogleDriveAccessToken: accessToken => GoogleDrive.accessToken = accessToken,
-  setThrowOnFilesWithSameName: enable => GoogleDrive.throwOnFilesWithSameName = enable,
-  setTimeout: timeout => GoogleDrive.timeout = timeout,
-  /* eslint-disable @typescript-eslint/no-unused-vars */
-  subscribeToFilesWithSameName: Platform.OS === 'ios' ?
-  // @ts-expect-error - subscriber is undefined; just a mock
-  subscriber => ({
-    remove: () => {}
-  }) : nativeInstance.subscribeToFilesWithSameName.bind(nativeInstance),
-  /* eslint-enable @typescript-eslint/no-unused-vars */
+const LINKING_ERROR = `The package 'react-native-cloud-storage' doesn't seem to be linked. Make sure: \n\n` + Platform.select({
+  ios: "- You have run 'pod install'\n",
+  default: ''
+}) + '- You rebuilt the app after installing the package\n' + '- You are not using Expo Go\n';
+
+// proxy NativeModules.CloudStorage to catch any errors thrown by the native module and wrap them in a CloudStorageError
+const nativeIosInstance = NativeModules.CloudStorage ? new Proxy(NativeModules.CloudStorage, {
+  get(target, prop) {
+    const originalFunction = target[prop];
+    if (typeof originalFunction === 'function') {
+      return async (...args) => {
+        try {
+          // @ts-expect-error - we can't know the types of the functions and their arguments
+          return await originalFunction(...args);
+        } catch (error) {
+          if (error?.code && Object.values(CloudStorageErrorCode).includes(error.code)) {
+            throw new CloudStorageError(error?.message || '', error.code);
+          } else {
+            throw new CloudStorageError('Unknown error', CloudStorageErrorCode.UNKNOWN, error);
+          }
+        }
+      };
+    }
+    return originalFunction;
+  }
+}) : null;
+const defaultProviderOptions = {
+  [CloudStorageProvider.ICloud]: {
+    scope: CloudStorageScope.AppData
+  },
+  [CloudStorageProvider.GoogleDrive]: {
+    scope: CloudStorageScope.AppData,
+    accessToken: null,
+    strictFilenames: false,
+    timeout: 3000
+  }
+};
+export default class RNCloudStorage {
+  cloudAvailabilityListeners = [];
+
+  //#region Constructor and configuration
+  /**
+   * Creates a new RNCloudStorage instance for the given provider.
+   * @param provider The provider to create the instance for. Defaults to the default provider for the current platform.
+   */
+  constructor(provider, options) {
+    if (provider && !isProviderSupported(provider)) {
+      throw new Error(`Provider ${provider} is not supported on the current platform.`);
+    }
+    this.provider = {
+      provider: provider ?? RNCloudStorage.getDefaultProvider(),
+      options: defaultProviderOptions[provider ?? RNCloudStorage.getDefaultProvider()]
+    };
+    this.setProvider(provider ?? RNCloudStorage.getDefaultProvider());
+    if (options) {
+      this.setProviderOptions(options);
+    }
+  }
+  get nativeInstance() {
+    switch (this.provider.provider) {
+      case CloudStorageProvider.ICloud:
+        return nativeIosInstance ?? new Proxy({}, {
+          get() {
+            throw new Error(LINKING_ERROR);
+          }
+        });
+      default:
+        return new GoogleDrive(this.provider.options);
+    }
+  }
+
+  /**
+   * Gets the default CloudStorageProvider for the current platform.
+   * @returns The default CloudStorageProvider.
+   */
+  static getDefaultProvider() {
+    switch (Platform.OS) {
+      case 'ios':
+        return CloudStorageProvider.ICloud;
+      default:
+        return CloudStorageProvider.GoogleDrive;
+    }
+  }
+
+  /**
+   * Gets the list of supported CloudStorageProviders on the current platform.
+   * @returns An array of supported CloudStorageProviders.
+   */
+  static getSupportedProviders() {
+    return Object.values(CloudStorageProvider).filter(isProviderSupported);
+  }
+
+  /**
+   * Gets the current CloudStorageProvider.
+   * @returns The current CloudStorageProvider.
+   */
+  getProvider() {
+    return this.provider.provider;
+  }
+
+  /**
+   * Sets the current CloudStorageProvider.
+   * @param provider The provider to set.
+   */
+  setProvider(provider) {
+    if (!isProviderSupported(provider)) {
+      throw new Error(`Provider ${provider} is not supported on the current platform.`);
+    }
+    this.provider = {
+      provider,
+      options: defaultProviderOptions[provider]
+    };
+
+    // Emit an event to notify useIsCloudAvailable() hook consumers of the new cloud availability status
+    this.nativeInstance.isCloudAvailable().then(available => {
+      this.cloudAvailabilityListeners.forEach(listener => {
+        listener(available);
+      });
+    });
+    if (provider === CloudStorageProvider.ICloud) {
+      // Listen to native cloud availability change events
+      const eventEmitter = new NativeEventEmitter(NativeModules.CloudStorageEventEmitter);
+      eventEmitter.addListener('RNCloudStorage.cloud.availability-changed', event => {
+        this.cloudAvailabilityListeners.forEach(listener => {
+          listener(event.available);
+        });
+      });
+    }
+  }
+
+  /**
+   * Gets the current options for the current provider.
+   * @returns The current options for the current provider.
+   */
+  getProviderOptions() {
+    return this.provider.options;
+  }
+
+  /**
+   * Sets the options for the current provider.
+   * @param options The options to set for the provider.
+   */
+  setProviderOptions(options) {
+    const newOptions = Object.fromEntries(Object.entries(options).filter(([_, v]) => v !== undefined));
+    this.provider.options = {
+      ...this.provider.options,
+      ...newOptions
+    };
+    if (this.provider.provider === CloudStorageProvider.GoogleDrive && 'accessToken' in newOptions) {
+      // Emit an event to notify useIsCloudAvailable() hook consumers of the new cloud availability status
+      this.cloudAvailabilityListeners.forEach(listener => {
+        listener(!!newOptions.accessToken?.length);
+      });
+    }
+  }
+  subscribeToCloudAvailability(listener) {
+    this.cloudAvailabilityListeners.push(listener);
+  }
+  unsubscribeFromCloudAvailability(listener) {
+    this.cloudAvailabilityListeners = this.cloudAvailabilityListeners.filter(l => l !== listener);
+  }
+  //#endregion
 
+  //#region File system operations
   /**
    * Tests whether or not the cloud storage is available. Always returns true for Google Drive. iCloud may be
    * unavailable right after app launch or if the user is not logged in.
    * @returns A promise that resolves to true if the cloud storage is available, false otherwise.
    */
-  isCloudAvailable: async () => {
-    return nativeInstance.isCloudAvailable();
-  },
+  isCloudAvailable() {
+    return this.nativeInstance.isCloudAvailable();
+  }
+
   /**
    * Appends the data to the file at the given path, creating the file if it doesn't exist.
    * @param path The file to append to.
    * @param data The data to append.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the current provider.
    * @returns A promise that resolves when the data has been appended.
    */
-  appendFile: (path, data, scope) => {
-    return nativeInstance.appendToFile(verifyLeadingSlash(path), data, scope ?? defaultScope);
-  },
+  appendFile(path, data, scope) {
+    return this.nativeInstance.appendToFile(path, data, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Tests whether or not the file at the given path exists.
    * @param path The path to test.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves to true if the path exists, false otherwise.
    */
-  exists: (path, scope) => {
-    return nativeInstance.fileExists(verifyLeadingSlash(path), scope ?? defaultScope);
-  },
+  exists(path, scope) {
+    return this.nativeInstance.fileExists(path, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Writes to the file at the given path, creating it if it doesn't exist or overwriting it if it does.
    * @param path The file to write to.
    * @param data The data to write.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves when the file has been written.
    */
-  writeFile: (path, data, scope) => {
-    return nativeInstance.createFile(verifyLeadingSlash(path), data, scope ?? defaultScope, true);
-  },
+  writeFile(path, data, scope) {
+    return this.nativeInstance.createFile(path, data, scope ?? this.provider.options.scope, true);
+  }
+
   /**
    * Creates a new directory at the given path.
    * @param path The directory to create.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves when the directory has been created.
    */
-  mkdir: (path, scope) => {
-    return nativeInstance.createDirectory(verifyLeadingSlash(path), scope ?? defaultScope);
-  },
+  mkdir(path, scope) {
+    return this.nativeInstance.createDirectory(path, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Lists the contents of the directory at the given path.
    * @param path The directory to list.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves to an array of file names, excluding '.' and '..'.
    */
-  readdir: (path, scope) => {
-    return nativeInstance.listFiles(verifyLeadingSlash(path), scope ?? defaultScope);
-  },
+  readdir(path, scope) {
+    return this.nativeInstance.listFiles(path, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Reads the contents of the file at the given path.
    * @param path The file to read.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves to the contents of the file.
    */
-  readFile: (path, scope) => {
-    return nativeInstance.readFile(verifyLeadingSlash(path), scope ?? defaultScope);
-  },
+  readFile(path, scope) {
+    return this.nativeInstance.readFile(path, scope ?? this.provider.options.scope);
+  }
+
   /**
-   * Downloads the file at the given path from iCloud. Does not have any effect on Google Drive.
+   * Downloads the file at the given path. Does not have any effect on Google Drive.
    * @param path The file to trigger the download for.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves once the download has been triggered.
    */
-  downloadFile: (path, scope) => {
-    return nativeInstance.downloadFile(verifyLeadingSlash(path), scope ?? defaultScope);
-  },
+  downloadFile(path, scope) {
+    return this.nativeInstance.downloadFile(path, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Deletes the file at the given path.
    * @param path The file to delete.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves when the file has been deleted.
    */
-  unlink: (path, scope) => {
-    return nativeInstance.deleteFile(verifyLeadingSlash(path), scope ?? defaultScope);
-  },
+  unlink(path, scope) {
+    return this.nativeInstance.deleteFile(path, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Deletes the directory at the given path.
    * @param path The directory to delete.
    * @param options Options for the delete operation. Defaults to { recursive: false }.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves when the directory has been deleted.
    */
-  rmdir: (path, options, scope) => {
-    return nativeInstance.deleteDirectory(verifyLeadingSlash(path), (options === null || options === void 0 ? void 0 : options.recursive) ?? false, scope ?? defaultScope);
-  },
+  rmdir(path, options, scope) {
+    return this.nativeInstance.deleteDirectory(path, options?.recursive ?? false, scope ?? this.provider.options.scope);
+  }
+
   /**
    * Gets the size, creation time, and modification time of the file at the given path.
    * @param path The file to stat.
-   * @param scope The directory scope the path is in. Defaults to the set default scope.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
    * @returns A promise that resolves to the CloudStorageFileStat object.
    */
-  stat: async (path, scope) => {
-    const native = await nativeInstance.statFile(verifyLeadingSlash(path), scope ?? defaultScope);
+  async stat(path, scope) {
+    const native = await this.nativeInstance.statFile(path, scope ?? this.provider.options.scope);
     return {
       ...native,
       birthtime: new Date(native.birthtimeMs),
@@ -128,6 +288,143 @@ const RNCloudStorage = {
       isFile: () => native.isFile
     };
   }
-};
-export default RNCloudStorage;
+  //#endregion
+
+  //#region Static methods for default static instance
+  static getDefaultInstance() {
+    if (!RNCloudStorage.defaultInstance) {
+      RNCloudStorage.defaultInstance = new RNCloudStorage();
+    }
+    return RNCloudStorage.defaultInstance;
+  }
+
+  /**
+   * Gets the current options for the provider of the default static instance.
+   * @returns The current options for the provider of the default static instance.
+   */
+  static getProviderOptions() {
+    return RNCloudStorage.getDefaultInstance().getProviderOptions();
+  }
+
+  /**
+   * Sets the options for the provider of the default static instance.
+   * @param options The options to set for the provider of the default static instance.
+   */
+  static setProviderOptions(options) {
+    RNCloudStorage.getDefaultInstance().setProviderOptions(options);
+  }
+
+  /**
+   * Tests whether or not the file at the given path exists in the provider of the default static instance.
+   * @param path The path to test.
+   * @param scope The directory scope the path is in. Defaults to set default scope set for the current provider.
+   * @returns A promise that resolves to true if the path exists, false otherwise.
+   */
+  static exists(path, scope) {
+    return RNCloudStorage.getDefaultInstance().exists(path, scope);
+  }
+
+  /**
+   * Tests whether or not the cloud storage is available for the provider of the default static instance. Always returns true for Google Drive. iCloud may be
+   * unavailable right after app launch or if the user is not logged in.
+   * @returns A promise that resolves to true if the cloud storage is available, false otherwise.
+   */
+  static isCloudAvailable() {
+    return RNCloudStorage.getDefaultInstance().isCloudAvailable();
+  }
+
+  /**
+   * Appends the data to the file at the given path in the provider of the default static instance, creating the file if it doesn't exist.
+   * @param path The file to append to.
+   * @param data The data to append.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves when the data has been appended.
+   */
+  static appendFile(path, data, scope) {
+    return RNCloudStorage.getDefaultInstance().appendFile(path, data, scope);
+  }
+
+  /**
+   * Writes to the file at the given path in the provider of the default static instance, creating it if it doesn't exist or overwriting it if it does.
+   * @param path The file to write to.
+   * @param data The data to write.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves when the file has been written.
+   */
+  static writeFile(path, data, scope) {
+    return RNCloudStorage.getDefaultInstance().writeFile(path, data, scope);
+  }
+
+  /**
+   * Creates a new directory at the given path in the provider of the default static instance.
+   * @param path The directory to create.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves when the directory has been created.
+   */
+  static mkdir(path, scope) {
+    return RNCloudStorage.getDefaultInstance().mkdir(path, scope);
+  }
+
+  /**
+   * Lists the contents of the directory at the given path in the provider of the default static instance.
+   * @param path The directory to list.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves to an array of file names, excluding '.' and '..'.
+   */
+  static readdir(path, scope) {
+    return RNCloudStorage.getDefaultInstance().readdir(path, scope);
+  }
+
+  /**
+   * Reads the contents of the file at the given path in the provider of the default static instance.
+   * @param path The file to read.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves to the contents of the file.
+   */
+  static readFile(path, scope) {
+    return RNCloudStorage.getDefaultInstance().readFile(path, scope);
+  }
+
+  /**
+   * Downloads the file at the given path in the provider of the default static instance. Does not have any effect on Google Drive.
+   * @param path The file to trigger the download for.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves once the download has been triggered.
+   */
+  static downloadFile(path, scope) {
+    return RNCloudStorage.getDefaultInstance().downloadFile(path, scope);
+  }
+
+  /**
+   * Deletes the file at the given path in the provider of the default static instance.
+   * @param path The file to delete.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves when the file has been deleted.
+   */
+  static unlink(path, scope) {
+    return RNCloudStorage.getDefaultInstance().unlink(path, scope);
+  }
+
+  /**
+   * Deletes the directory at the given path in the provider of the default static instance.
+   * @param path The directory to delete.
+   * @param options Options for the delete operation. Defaults to { recursive: false }.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves when the directory has been deleted.
+   */
+  static rmdir(path, options, scope) {
+    return RNCloudStorage.getDefaultInstance().rmdir(path, options, scope);
+  }
+
+  /**
+   * Gets the size, creation time, and modification time of the file at the given path in the provider of the default static instance.
+   * @param path The file to stat.
+   * @param scope The directory scope the path is in. Defaults to the default scope set for the default static instance.
+   * @returns A promise that resolves to the CloudStorageFileStat object.
+   */
+  static stat(path, scope) {
+    return RNCloudStorage.getDefaultInstance().stat(path, scope);
+  }
+  //#endregion
+}
 //# sourceMappingURL=RNCloudStorage.js.map