@maplibre/maplibre-react-native 11.0.0-beta.3 → 11.0.0-beta.31

package/lib/commonjs/modules/offline/OfflineManager.js

@@ -12,9 +12,10 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  */
 
 /**
- * OfflineManager implements a singleton (shared object) that manages offline packs.
- * All of this class's instance methods are asynchronous, reflecting the fact that offline resources are stored in a database.
- * The shared object maintains a canonical collection of offline packs.
+ * OfflineManager implements a singleton (shared object) that manages offline
+ * packs. All of this class's instance methods are asynchronous, reflecting the
+ * fact that offline resources are stored in a database. The shared object
+ * maintains a canonical collection of offline packs.
  */
 class OfflineManager {
   constructor() {
@@ -29,26 +30,36 @@ class OfflineManager {
   }
 
   /**
-   * Creates and registers an offline pack that downloads the resources needed to use the given region offline.
+   * Creates and registers an offline pack that downloads the resources needed to
+   * use the given region offline.
    *
-   * @example
-   *
-   * const progressListener = (offlineRegion, status) => console.log(offlineRegion, status);
-   * const errorListener = (offlineRegion, error) => console.log(offlineRegion, error);
-   *
-   * const offlinePack = await OfflineManager.createPack({
-   *   mapStyle: 'https://demotiles.maplibre.org/tiles/tiles.json',
-   *   minZoom: 14,
-   *   maxZoom: 20,
-   *   bounds: [west, south, east, north],
-   *   metadata: { customValue: 'myValue' }
-   * }, progressListener, errorListener)
+   * @param options - Create options for offline pack that specifies zoom levels, style url, and
+   *   the region to download.
+   * @param progressListener - Callback that listens for status events while downloading the offline
+   *   resource.
+   * @param errorListener - Callback that listens for status events while downloading the offline
+   *   resource.
+   * @returns The created offline pack with its generated ID.
    *
-   * @param options Create options for offline pack that specifies zoom levels, style url, and the region to download.
-   * @param  progressListener Callback that listens for status events while downloading the offline resource.
-   * @param  errorListener Callback that listens for status events while downloading the offline resource.
+   * @example
+   * ```ts
+   * const progressListener = (offlineRegion, status) =>
+   *   console.log(offlineRegion, status);
+   * const errorListener = (offlineRegion, error) =>
+   *   console.log(offlineRegion, error);
    *
-   * @return The created offline pack with its generated ID.
+   * const offlinePack = await OfflineManager.createPack(
+   *   {
+   *     mapStyle: "https://demotiles.maplibre.org/tiles/tiles.json",
+   *     minZoom: 14,
+   *     maxZoom: 20,
+   *     bounds: [west, south, east, north],
+   *     metadata: { customValue: "myValue" },
+   *   },
+   *   progressListener,
+   *   errorListener,
+   * );
+   * ```
    */
   async createPack(options, progressListener, errorListener) {
     await this.initialize();
@@ -67,14 +78,20 @@ class OfflineManager {
   }
 
   /**
-   * Invalidates the specified offline pack. This method checks that the tiles in the specified offline pack match those from the server. Local tiles that do not match the latest version on the server are updated.
+   * Invalidates the specified offline pack. This method checks that the tiles in
+   * the specified offline pack match those from the server. Local tiles that do
+   * not match the latest version on the server are updated.
    *
-   * This is more efficient than deleting the offline pack and downloading it again. If the data stored locally matches that on the server, new data will not be downloaded.
+   * This is more efficient than deleting the offline pack and downloading it
+   * again. If the data stored locally matches that on the server, new data will
+   * not be downloaded.
    *
-   * @example
-   * await OfflineManager.invalidatePack(pack.id)
+   * @param id - ID of the OfflinePack.
    *
-   * @param id ID of the OfflinePack.
+   * @example
+   * ```ts
+   * await OfflineManager.invalidatePack(pack.id);
+   * ```
    */
   async invalidatePack(id) {
     await this.initialize();
@@ -83,12 +100,15 @@ class OfflineManager {
   }
 
   /**
-   * Unregisters the given OfflinePack and allows resources that are no longer required by any remaining packs to be potentially freed.
+   * Unregisters the given OfflinePack and allows resources that are no longer
+   * required by any remaining packs to be potentially freed.
    *
-   * @example
-   * await OfflineManager.deletePack(pack.id)
+   * @param id - ID of the OfflinePack.
    *
-   * @param id  ID of the OfflinePack.
+   * @example
+   * ```ts
+   * await OfflineManager.deletePack(pack.id);
+   * ```
    */
   async deletePack(id) {
     await this.initialize();
@@ -98,13 +118,18 @@ class OfflineManager {
   }
 
   /**
-   * Forces a revalidation of the tiles in the ambient cache and downloads a fresh version of the tiles from the tile server.
-   * This is the recommend method for clearing the cache.
-   * This is the most efficient method because tiles in the ambient cache are re-downloaded to remove outdated data from a device.
-   * It does not erase resources from the ambient cache or delete the database, which can be computationally expensive operations that may carry unintended side effects.
+   * Forces a revalidation of the tiles in the ambient cache and downloads a fresh
+   * version of the tiles from the tile server. This is the recommend method for
+   * clearing the cache. This is the most efficient method because tiles in the
+   * ambient cache are re-downloaded to remove outdated data from a device. It
+   * does not erase resources from the ambient cache or delete the database, which
+   * can be computationally expensive operations that may carry unintended side
+   * effects.
    *
    * @example
+   * ```ts
    * await OfflineManager.invalidateAmbientCache();
+   * ```
    */
   async invalidateAmbientCache() {
     await this.initialize();
@@ -112,11 +137,13 @@ class OfflineManager {
   }
 
   /**
-   * Erases resources from the ambient cache.
-   * This method clears the cache and decreases the amount of space that map resources take up on the device.
+   * Erases resources from the ambient cache. This method clears the cache and
+   * decreases the amount of space that map resources take up on the device.
    *
    * @example
+   * ```ts
    * await OfflineManager.clearAmbientCache();
+   * ```
    */
   async clearAmbientCache() {
     await this.initialize();
@@ -124,13 +151,14 @@ class OfflineManager {
   }
 
   /**
-   * Sets the maximum size of the ambient cache in bytes. Disables the ambient cache if set to 0.
-   * This method may be computationally expensive because it will erase resources from the ambient cache if its size is decreased.
+   * Sets the maximum size of the ambient cache in bytes. Disables the ambient
+   * cache if set to 0. This method may be computationally expensive because it
+   * will erase resources from the ambient cache if its size is decreased.
+   *
+   * @param size - Size of ambient cache.
    *
    * @example
    * await OfflineManager.setMaximumAmbientCacheSize(5000000);
-   *
-   * @param    size  Size of ambient cache.
    */
   async setMaximumAmbientCacheSize(size) {
     await this.initialize();
@@ -138,10 +166,13 @@ class OfflineManager {
   }
 
   /**
-   * Deletes the existing database, which includes both the ambient cache and offline packs, then reinitializes it.
+   * Deletes the existing database, which includes both the ambient cache and
+   * offline packs, then reinitializes it.
    *
    * @example
+   * ```ts
    * await OfflineManager.resetDatabase();
+   * ```
    */
   async resetDatabase() {
     await this.initialize();
@@ -163,7 +194,9 @@ class OfflineManager {
    * Retrieves an offline pack that is stored in the database by ID.
    *
    * @example
+   * ```ts
    * const offlinePack = await OfflineManager.getPack(offlinePack.id);
+   * ```
    */
   async getPack(id) {
     await this.initialize();
@@ -177,10 +210,12 @@ class OfflineManager {
   /**
    * Sideloads offline db
    *
+   * @param path - Path to offline tile db on file system.
+   *
    * @example
+   * ```ts
    * await OfflineManager.mergeOfflineRegions(path);
-   *
-   * @param path Path to offline tile db on file system.
+   * ```
    */
   async mergeOfflineRegions(path) {
     await this.initialize();
@@ -188,26 +223,31 @@ class OfflineManager {
   }
 
   /**
-   * Sets the maximum number of tiles that may be downloaded and stored on the current device.
-   * Consult the Terms of Service for your map tile host before changing this value.
+   * Sets the maximum number of tiles that may be downloaded and stored on the
+   * current device. Consult the Terms of Service for your map tile host before
+   * changing this value.
+   *
+   * @param limit - Map tile limit count.
    *
    * @example
+   * ```ts
    * OfflineManager.setTileCountLimit(1000);
-   *
-   * @param limit Map tile limit count.
+   * ```
    */
   setTileCountLimit(limit) {
     _NativeOfflineModule.default.setTileCountLimit(limit);
   }
 
   /**
-   * Sets the period at which download status events will be sent over the React Native bridge.
-   * The default is 500ms.
+   * Sets the period at which download status events will be sent over the React
+   * Native bridge. The default is 500ms.
+   *
+   * @param throttleValue - Event throttle value in ms.
    *
    * @example
+   * ```ts
    * OfflineManager.setProgressEventThrottle(500);
-   *
-   * @param throttleValue Event throttle value in ms.
+   * ```
    */
   setProgressEventThrottle(throttleValue) {
     _NativeOfflineModule.default.setProgressEventThrottle(throttleValue);
@@ -217,14 +257,19 @@ class OfflineManager {
    * Subscribe to download status/error events for the requested offline pack.
    * Note that createPack calls this internally if listeners are provided.
    *
-   * @example
-   * const progressListener = (offlinePack, status) => console.log(offlinePack, status)
-   * const errorListener = (offlinePack, error) => console.log(offlinePack, error)
-   * OfflineManager.addListener(pack.id, progressListener, errorListener)
+   * @param id - ID of the offline pack.
+   * @param progressListener - Callback that listens for status events while downloading the offline
+   *   resource.
+   * @param errorListener - Callback that listens for status events while downloading the offline
+   *   resource.
    *
-   * @param  id           ID of the offline pack.
-   * @param  progressListener Callback that listens for status events while downloading the offline resource.
-   * @param  errorListener      Callback that listens for status events while downloading the offline resource.
+   * @example
+   * ```ts
+   * const progressListener = (offlinePack, status) =>
+   *   console.log(offlinePack, status);
+   * const errorListener = (offlinePack, error) => console.log(offlinePack, error);
+   * OfflineManager.addListener(pack.id, progressListener, errorListener);
+   * ```
    */
   async addListener(id, progressListener, errorListener) {
     const totalProgressListeners = Object.keys(this.progressListeners).length;
@@ -243,17 +288,19 @@ class OfflineManager {
   }
 
   /**
-   * Unsubscribes any listeners associated with the offline pack.
-   * Should be called when the component unmounts.
+   * Unsubscribes any listeners associated with the offline pack. Should be called
+   * when the component unmounts.
+   *
+   * @param packId - ID of the offline pack.
    *
    * @example
+   * ```ts
    * useEffect(() => {
    *   return () => {
    *     OfflineManager.removeListener(pack.id);
-   *   }
+   *   };
    * }, []);
-   *
-   * @param packId ID of the offline pack.
+   * ```
    */
   removeListener(packId) {
     delete this.progressListeners[packId];

package/lib/commonjs/modules/offline/OfflineManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["_NativeOfflineModule","_interopRequireDefault","require","_OfflinePack","e","__esModule","default","OfflineManager","constructor","initialized","offlinePacks","progressListeners","errorListeners","handleProgress","bind","onError","subscriptionProgress","subscriptionError","createPack","options","progressListener","errorListener","initialize","offlinePackOptions","mapStyle","bounds","minZoom","maxZoom","metadata","JSON","stringify","nativeOfflinePack","NativeOfflineModule","offlinePack","OfflinePack","id","addListener","invalidatePack","getPack","deletePack","invalidateAmbientCache","clearAmbientCache","setMaximumAmbientCacheSize","size","resetDatabase","getPacks","Object","values","Error","mergeOfflineRegions","path","setTileCountLimit","limit","setProgressEventThrottle","throttleValue","totalProgressListeners","keys","length","onProgress","totalErrorListeners","setPackObserver","removeListener","packId","remove","nativeOfflinePacks","event","state","offlineManager","exports"],"sourceRoot":"../../../../src","sources":["modules/offline/OfflineManager.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_NativeOfflineModule","_interopRequireDefault","require","_OfflinePack","e","__esModule","default","OfflineManager","constructor","initialized","offlinePacks","progressListeners","errorListeners","handleProgress","bind","onError","subscriptionProgress","subscriptionError","createPack","options","progressListener","errorListener","initialize","offlinePackOptions","mapStyle","bounds","minZoom","maxZoom","metadata","JSON","stringify","nativeOfflinePack","NativeOfflineModule","offlinePack","OfflinePack","id","addListener","invalidatePack","getPack","deletePack","invalidateAmbientCache","clearAmbientCache","setMaximumAmbientCacheSize","size","resetDatabase","getPacks","Object","values","Error","mergeOfflineRegions","path","setTileCountLimit","limit","setProgressEventThrottle","throttleValue","totalProgressListeners","keys","length","onProgress","totalErrorListeners","setPackObserver","removeListener","packId","remove","nativeOfflinePacks","event","state","offlineManager","exports"],"sourceRoot":"../../../../src","sources":["modules/offline/OfflineManager.ts"],"mappings":";;;;;;AAEA,IAAAA,oBAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAAoE,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAepE;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,cAAc,CAAC;EAcnBC,WAAWA,CAAA,EAAG;IACZ,IAAI,CAACC,WAAW,GAAG,KAAK;IAExB,IAAI,CAACC,YAAY,GAAG,CAAC,CAAC;IAEtB,IAAI,CAACC,iBAAiB,GAAG,CAAC,CAAC;IAC3B,IAAI,CAACC,cAAc,GAAG,CAAC,CAAC;IAExB,IAAI,CAACC,cAAc,GAAG,IAAI,CAACA,cAAc,CAACC,IAAI,CAAC,IAAI,CAAC;IACpD,IAAI,CAACC,OAAO,GAAG,IAAI,CAACA,OAAO,CAACD,IAAI,CAAC,IAAI,CAAC;IAEtC,IAAI,CAACE,oBAAoB,GAAG,IAAI;IAChC,IAAI,CAACC,iBAAiB,GAAG,IAAI;EAC/B;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,UAAUA,CACdC,OAAiC,EACjCC,gBAA6C,EAC7CC,aAAuC,EACjB;IACtB,MAAM,IAAI,CAACC,UAAU,CAAC,CAAC;IAEvB,MAAMC,kBAAkB,GAAG;MACzBC,QAAQ,EAAEL,OAAO,CAACK,QAAQ;MAC1BC,MAAM,EAAEN,OAAO,CAACM,MAAM;MACtBC,OAAO,EAAEP,OAAO,CAACO,OAAO,IAAI,EAAE;MAC9BC,OAAO,EAAER,OAAO,CAACQ,OAAO,IAAI,EAAE;MAC9BC,QAAQ,EAAEC,IAAI,CAACC,SAAS,CAACX,OAAO,CAACS,QAAQ,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,MAAMG,iBAAiB,GACrB,MAAMC,4BAAmB,CAACd,UAAU,CAACK,kBAAkB,CAAC;IAC1D,MAAMU,WAAW,GAAG,IAAIC,wBAAW,CAACH,iBAAiB,CAAC;IAEtD,IAAI,CAACrB,YAAY,CAACuB,WAAW,CAACE,EAAE,CAAC,GAAGF,WAAW;IAC/C,MAAM,IAAI,CAACG,WAAW,CAACH,WAAW,CAACE,EAAE,EAAEf,gBAAgB,EAAEC,aAAa,CAAC;IAEvE,OAAOY,WAAW;EACpB;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMI,cAAcA,CAACF,EAAU,EAAiB;IAC9C,MAAM,IAAI,CAACb,UAAU,CAAC,CAAC;IAEvB,MAAMW,WAAW,GAAG,MAAM,IAAI,CAACK,OAAO,CAACH,EAAE,CAAC;IAC1C,MAAMH,4BAAmB,CAACK,cAAc,CAACJ,WAAW,CAACE,EAAE,CAAC;EAC1D;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMI,UAAUA,CAACJ,EAAU,EAAiB;IAC1C,MAAM,IAAI,CAACb,UAAU,CAAC,CAAC;IAEvB,MAAMW,WAAW,GAAG,MAAM,IAAI,CAACK,OAAO,CAACH,EAAE,CAAC;IAC1C,MAAMH,4BAAmB,CAACO,UAAU,CAACN,WAAW,CAACE,EAAE,CAAC;IACpD,OAAO,IAAI,CAACzB,YAAY,CAACuB,WAAW,CAACE,EAAE,CAAC;EAC1C;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMK,sBAAsBA,CAAA,EAAkB;IAC5C,MAAM,IAAI,CAAClB,UAAU,CAAC,CAAC;IACvB,MAAMU,4BAAmB,CAACQ,sBAAsB,CAAC,CAAC;EACpD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,iBAAiBA,CAAA,EAAkB;IACvC,MAAM,IAAI,CAACnB,UAAU,CAAC,CAAC;IACvB,MAAMU,4BAAmB,CAACS,iBAAiB,CAAC,CAAC;EAC/C;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,0BAA0BA,CAACC,IAAY,EAAiB;IAC5D,MAAM,IAAI,CAACrB,UAAU,CAAC,CAAC;IACvB,MAAMU,4BAAmB,CAACU,0BAA0B,CAACC,IAAI,CAAC;EAC5D;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,aAAaA,CAAA,EAAkB;IACnC,MAAM,IAAI,CAACtB,UAAU,CAAC,CAAC;IACvB,MAAMU,4BAAmB,CAACY,aAAa,CAAC,CAAC;EAC3C;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,MAAMC,QAAQA,CAAA,EAA2B;IACvC,MAAM,IAAI,CAACvB,UAAU,CAAC,CAAC;IAEvB,OAAOwB,MAAM,CAACC,MAAM,CAAC,IAAI,CAACrC,YAAY,CAAC;EACzC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAM4B,OAAOA,CAACH,EAAU,EAAwB;IAC9C,MAAM,IAAI,CAACb,UAAU,CAAC,CAAC;IACvB,MAAMW,WAAW,GAAG,IAAI,CAACvB,YAAY,CAACyB,EAAE,CAAC;IAEzC,IAAI,CAACF,WAAW,EAAE;MAChB,MAAM,IAAIe,KAAK,CAAC,eAAeb,EAAE,YAAY,CAAC;IAChD;IAEA,OAAOF,WAAW;EACpB;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMgB,mBAAmBA,CAACC,IAAY,EAAiB;IACrD,MAAM,IAAI,CAAC5B,UAAU,CAAC,CAAC;IACvB,OAAOU,4BAAmB,CAACiB,mBAAmB,CAACC,IAAI,CAAC;EACtD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACC,KAAa,EAAQ;IACrCpB,4BAAmB,CAACmB,iBAAiB,CAACC,KAAK,CAAC;EAC9C;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,wBAAwBA,CAACC,aAAqB,EAAQ;IACpDtB,4BAAmB,CAACqB,wBAAwB,CAACC,aAAa,CAAC;EAC7D;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMlB,WAAWA,CACfD,EAAU,EACVf,gBAA6C,EAC7CC,aAAuC,EACxB;IACf,MAAMkC,sBAAsB,GAAGT,MAAM,CAACU,IAAI,CAAC,IAAI,CAAC7C,iBAAiB,CAAC,CAAC8C,MAAM;IACzE,IAAIF,sBAAsB,KAAK,CAAC,EAAE;MAChC,IAAI,CAACvC,oBAAoB,GAAGgB,4BAAmB,CAAC0B,UAAU,CACxD,IAAI,CAAC7C,cACP,CAAC;IACH;IACA,IAAI,CAACF,iBAAiB,CAACwB,EAAE,CAAC,GAAGf,gBAAgB;IAE7C,MAAMuC,mBAAmB,GAAGb,MAAM,CAACU,IAAI,CAAC,IAAI,CAAC5C,cAAc,CAAC,CAAC6C,MAAM;IACnE,IAAIE,mBAAmB,KAAK,CAAC,EAAE;MAC7B,IAAI,CAAC1C,iBAAiB,GAAGe,4BAAmB,CAACjB,OAAO,CAAC,IAAI,CAACA,OAAO,CAAC;IACpE;IACA,IAAI,CAACH,cAAc,CAACuB,EAAE,CAAC,GAAGd,aAAa;IAEvC,IAAI,IAAI,CAACX,YAAY,CAACyB,EAAE,CAAC,EAAE;MACzB,MAAMH,4BAAmB,CAAC4B,eAAe,CAACzB,EAAE,CAAC;IAC/C;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE0B,cAAcA,CAACC,MAAc,EAAQ;IACnC,OAAO,IAAI,CAACnD,iBAAiB,CAACmD,MAAM,CAAC;IACrC,OAAO,IAAI,CAAClD,cAAc,CAACkD,MAAM,CAAC;IAElC,IACEhB,MAAM,CAACU,IAAI,CAAC,IAAI,CAAC7C,iBAAiB,CAAC,CAAC8C,MAAM,KAAK,CAAC,IAChD,IAAI,CAACzC,oBAAoB,EACzB;MACA,IAAI,CAACA,oBAAoB,CAAC+C,MAAM,CAAC,CAAC;IACpC;IAEA,IACEjB,MAAM,CAACU,IAAI,CAAC,IAAI,CAAC5C,cAAc,CAAC,CAAC6C,MAAM,KAAK,CAAC,IAC7C,IAAI,CAACxC,iBAAiB,EACtB;MACA,IAAI,CAACA,iBAAiB,CAAC8C,MAAM,CAAC,CAAC;IACjC;EACF;EAEA,MAAczC,UAAUA,CAAA,EAAqB;IAC3C,IAAI,IAAI,CAACb,WAAW,EAAE;MACpB,OAAO,IAAI;IACb;IAEA,MAAMuD,kBAAkB,GAAG,MAAMhC,4BAAmB,CAACa,QAAQ,CAAC,CAAC;IAE/D,KAAK,MAAMd,iBAAiB,IAAIiC,kBAAkB,EAAE;MAClD,MAAM/B,WAAW,GAAG,IAAIC,wBAAW,CAACH,iBAAiB,CAAC;MAEtD,IAAI,CAACrB,YAAY,CAACuB,WAAW,CAACE,EAAE,CAAC,GAAGF,WAAW;IACjD;IAEA,IAAI,CAACxB,WAAW,GAAG,IAAI;IACvB,OAAO,IAAI;EACb;EAEQI,cAAcA,CAACoD,KAAwB,EAAE;IAC/C,MAAM;MAAE9B,EAAE;MAAE+B;IAAM,CAAC,GAAGD,KAAK;IAC3B,MAAMhC,WAAW,GAAG,IAAI,CAACvB,YAAY,CAACyB,EAAE,CAAC;IAEzC,IAAIF,WAAW,EAAE;MACf,IAAI,CAACtB,iBAAiB,CAACsB,WAAW,CAACE,EAAE,CAAC,GAAGF,WAAW,EAAEgC,KAAK,CAAC;IAC9D;IAEA,IAAIC,KAAK,KAAK,UAAU,EAAE;MACxB,IAAI,CAACL,cAAc,CAAC1B,EAAE,CAAC;IACzB;EACF;EAEQpB,OAAOA,CAACkD,KAAuB,EAAE;IACvC,MAAM;MAAE9B;IAAG,CAAC,GAAG8B,KAAK;IAEpB,MAAMhC,WAAW,GAAG,IAAI,CAACvB,YAAY,CAACyB,EAAE,CAAC;IACzC,IAAIF,WAAW,EAAE;MACf,IAAI,CAACrB,cAAc,CAACqB,WAAW,CAACE,EAAE,CAAC,GAAGF,WAAW,EAAEgC,KAAK,CAAC;IAC3D;EACF;AACF;AAEA,MAAME,cAAc,GAAAC,OAAA,CAAA7D,cAAA,GAAG,IAAIA,cAAc,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/modules/static-map/StaticMapManager.js

@@ -13,10 +13,12 @@ class StaticMapManager {
   /**
    * Creates a static image of a map. Images are always in PNG format.
    *
-   * @example
-   * // Create static map with center, returning the URI to the temporary PNG file
+   * @param options -
+   *
+   * @example Create static map with center, returning the URI to the temporary PNG file
+   * ```ts
    * const uri = await StaticMapManager.createImage({
-   *   center: [-74.126410, 40.797968 ],
+   *   center: [-74.12641, 40.797968],
    *   zoom: 12,
    *   bearing: 20,
    *   pitch: 30,
@@ -25,15 +27,21 @@ class StaticMapManager {
    *   height: 64,
    *   output: "file",
    * });
+   * ```
    *
-   * // Create a static map with bounds, returning a base64 encoded PNG
+   * @example Create a static map with bounds, returning a base64 encoded PNG
+   * ```ts
    * const uri = await StaticMapManager.createImage({
-   *   bounds: [[-74.126410, 40.797968], [-74.143727, 40.772177]],
+   *   bounds: [
+   *     [-74.12641, 40.797968],
+   *     [-74.143727, 40.772177],
+   *   ],
    *   mapStyle: "https://demotiles.maplibre.org/style.json",
    *   width: 128,
    *   height: 64,
    *   output: "base64",
    * });
+   * ```
    */
   async createImage({
     mapStyle,

package/lib/commonjs/modules/static-map/StaticMapManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["_NativeStaticMapModule","_interopRequireDefault","require","e","__esModule","default","StaticMapManager","createImage","mapStyle","options","NativeStaticMapModule","JSON","stringify","staticMapImageManager","exports","StaticMapImageManager"],"sourceRoot":"../../../../src","sources":["modules/static-map/StaticMapManager.ts"],"mappings":";;;;;;AAAA,IAAAA,sBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA4D,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AA4E5D;AACA;AACA;AACA,MAAMG,gBAAgB,CAAC;EACrB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,WAAWA,CAAC;IAChBC,QAAQ;IACR,GAAGC;EACmB,CAAC,EAAmB;IAC1C,OAAOC,8BAAqB,CAACH,WAAW,CAAC;MACvCC,QAAQ,EACN,OAAOA,QAAQ,KAAK,QAAQ,GAAGA,QAAQ,GAAGG,IAAI,CAACC,SAAS,CAACJ,QAAQ,CAAC;MACpE,GAAGC;IACL,CAAC,CAAC;EACJ;AACF;AAEA,MAAMI,qBAAqB,GAAAC,OAAA,CAAAC,qBAAA,GAAG,IAAIT,gBAAgB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["_NativeStaticMapModule","_interopRequireDefault","require","e","__esModule","default","StaticMapManager","createImage","mapStyle","options","NativeStaticMapModule","JSON","stringify","staticMapImageManager","exports","StaticMapImageManager"],"sourceRoot":"../../../../src","sources":["modules/static-map/StaticMapManager.ts"],"mappings":";;;;;;AAAA,IAAAA,sBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA4D,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AA4E5D;AACA;AACA;AACA,MAAMG,gBAAgB,CAAC;EACrB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,WAAWA,CAAC;IAChBC,QAAQ;IACR,GAAGC;EACmB,CAAC,EAAmB;IAC1C,OAAOC,8BAAqB,CAACH,WAAW,CAAC;MACvCC,QAAQ,EACN,OAAOA,QAAQ,KAAK,QAAQ,GAAGA,QAAQ,GAAGG,IAAI,CAACC,SAAS,CAACJ,QAAQ,CAAC;MACpE,GAAGC;IACL,CAAC,CAAC;EACJ;AACF;AAEA,MAAMI,qBAAqB,GAAAC,OAAA,CAAAC,qBAAA,GAAG,IAAIT,gBAAgB,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/modules/transform-request/NativeTransformRequestModule.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactNative = require("react-native");
+var _default = exports.default = _reactNative.TurboModuleRegistry.getEnforcing("MLRNTransformRequestModule");
+//# sourceMappingURL=NativeTransformRequestModule.js.map

package/lib/commonjs/modules/transform-request/NativeTransformRequestModule.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../../../src","sources":["modules/transform-request/NativeTransformRequestModule.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAqCpCC,gCAAmB,CAACC,YAAY,CAC7C,4BACF,CAAC","ignoreList":[]}

package/lib/commonjs/modules/transform-request/TransformRequestManager.js

@@ -0,0 +1,233 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TransformRequestManager = void 0;
+var _NativeTransformRequestModule = _interopRequireDefault(require("./NativeTransformRequestModule.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * A serializable transform for rewriting MapLibre request URLs.
+ *
+ * Transforms are applied as a pipeline in the order they were added: transform
+ * N+1 sees the URL *after* transform N has possibly changed it.
+ */
+
+/**
+ * A URL query parameter to append to matching map resource requests.
+ */
+
+/**
+ * A HTTP header to send with matching map resource requests.
+ */
+
+/**
+ * TransformRequestManager provides methods for managing HTTP requests made by
+ * MapLibre.
+ *
+ * Transformations are possible in three ways:
+ *
+ * - Transforming the URL with search and replace
+ * - Adding URL search params
+ * - Adding HTTP headers
+ *
+ * Transforms are applied in this order. The `match` conditions are applied to
+ * possibly already transformed URLs.
+ *
+ * To gain insight into which transforms are applied set the log level to
+ * `"debug"` via {@link LogManager}:
+ *
+ * ```ts
+ * LogManager.setLogLevel("debug");
+ * ```
+ */
+class TransformRequestManager {
+  /**
+   * Adds or updates a URL transform identified by `id`.
+   *
+   * Transforms execute in insertion order. Therefore `match` and `find` regexes
+   * are matched against possibly already modified URL by previous transforms.
+   *
+   * Re-adding an existing `id` updates the transform **in-place**, preserving its
+   * position in the pipeline. This makes it safe to refresh tokens or swap
+   * domains without disrupting the order of other transforms.
+   *
+   * URL transforms are applied before `addUrlSearchParam` and `addHeader`.
+   *
+   * @param options - The transform. Set {@link TransformOptions.id} to a stable string to enable
+   *   in-place updates; if omitted an id is auto-generated and returned.
+   * @returns The id of the transform (the value of `transform.id` when provided, otherwise the auto-generated one). Pass it to {@link removeUrlTransform} to remove it later.
+   *
+   * @example Upgrade all requests to HTTPS
+   * ```ts
+   * TransformRequestManager.addUrlTransform({
+   *   id: "force-https",
+   *   find: "^http://",
+   *   replace: "https://",
+   * });
+   * ```
+   *
+   * @example Redirect a specific domain through a proxy
+   * ```ts
+   * TransformRequestManager.addUrlTransform({
+   *   id: "proxy",
+   *   match: "tiles\\.example\\.com",
+   *   find: "tiles\\.example\\.com",
+   *   replace: "proxy.example.com",
+   * });
+   * ```
+   *
+   * @example Inject an API key into the path using a capture group
+   * ```ts
+   * TransformRequestManager.addUrlTransform({
+   *   id: "api-key",
+   *   match: "api\\.example\\.com",
+   *   find: "(https://api\\.example\\.com/)(.*)",
+   *   replace: "$1mySecretKey/$2",
+   * });
+   * ```
+   */
+  addUrlTransform(options) {
+    const id = options.id ?? this.getId();
+    _NativeTransformRequestModule.default.addUrlTransform(id, TransformRequestManager.toRegexString(options.match), TransformRequestManager.toRegexString(options.find) ?? "", options.replace);
+    return id;
+  }
+
+  /**
+   * Removes the URL transform with the given `id` . No-op if the id is not
+   * registered.
+   *
+   * @param id - The identifier passed to/returned from {@link addUrlTransform}.
+   */
+  removeUrlTransform(id) {
+    _NativeTransformRequestModule.default.removeUrlTransform(id);
+  }
+
+  /**
+   * Removes all registered URL transforms
+   */
+  clearUrlTransforms() {
+    _NativeTransformRequestModule.default.clearUrlTransforms();
+  }
+
+  /**
+   * Adds or updates a URL query parameter identified by `id` that will be
+   * appended to all matching map resource requests. Re-adding an existing `id`
+   *  updates the param in-place.
+   *
+   * @param options - The options. Set {@link TransformOptions.id} to a stable string to enable
+   *   in-place updates; if omitted an id is auto-generated and returned.
+   * @returns The id of the options. Pass it to {@link removeUrlSearchParam} to remove it later.
+   *
+   * @example Add apiKey to for a specific domain
+   * ```ts
+   * TransformRequestManager.addUrlSearchParam({
+   *   match: /tiles\.example\.com/,
+   *   name: "apiKey",
+   *   value: "your-api-key",
+   * });
+   * ```
+   *
+   * @example Add apiKey to all requests (no match = applies to all)
+   * ```ts
+   * TransformRequestManager.addUrlSearchParam({
+   *   name: "apiKey",
+   *   value: "your-api-key",
+   * });
+   * ```
+   */
+  addUrlSearchParam(options) {
+    const id = options.id ?? this.getId();
+    _NativeTransformRequestModule.default.addUrlSearchParam(id, TransformRequestManager.toRegexString(options.match), options.name, options.value);
+    return id;
+  }
+
+  /**
+   * Removes a previously added URL query parameter by its `id`.
+   *
+   * @param id - The identifier passed to/returned from {@link addUrlSearchParam}.
+   */
+  removeUrlSearchParam(id) {
+    _NativeTransformRequestModule.default.removeUrlSearchParam(id);
+  }
+
+  /**
+   * Adds or updates an HTTP header identified by `id` that will be sent with all
+   * matching map resource requests. Re-adding an existing `id` updates the header
+   * in-place.
+   *
+   * @param options - The options. Set {@link TransformOptions.id} to a stable string to enable
+   *   in-place updates; if omitted an id is auto-generated and returned.
+   * @returns The id of the options. Pass it to {@link removeHeader} to remove it later.
+   *
+   * @example Add header to all requests
+   * ```
+   * TransformRequestManager.addHeader({ name: "Authorization", value: "Bearer token123" });
+   * ```
+   *
+   * @example Add header only to requests matching a pattern
+   * ```ts
+   * TransformRequestManager.addHeader({
+   *   name: "X-API-Key",
+   *   value: "key123",
+   *   match: /https:\/\/api\.example\.com\/tiles\//,
+   * });
+   * ```
+   */
+  addHeader(options) {
+    const id = options.id ?? this.getId();
+    _NativeTransformRequestModule.default.addHeader(id, TransformRequestManager.toRegexString(options.match), options.name, options.value);
+    return id;
+  }
+
+  /**
+   * Removes all registered URL search params.
+   */
+  clearUrlSearchParams() {
+    _NativeTransformRequestModule.default.clearUrlSearchParams();
+  }
+
+  /**
+   * Removes a previously added HTTP header by its `id`.
+   *
+   * @param id - The identifier passed to/returned from {@link addHeader}.
+   */
+  removeHeader(id) {
+    _NativeTransformRequestModule.default.removeHeader(id);
+  }
+
+  /**
+   * Removes all registered HTTP headers.
+   */
+  clearHeaders() {
+    _NativeTransformRequestModule.default.clearHeaders();
+  }
+
+  /**
+   * Removes all registered URL transforms, URL search params and HTTP headers.
+   */
+  clear() {
+    this.clearUrlTransforms();
+    this.clearUrlSearchParams();
+    this.clearHeaders();
+  }
+  lastId = -1;
+  getId() {
+    this.lastId++;
+    return "transform-request-" + this.lastId;
+  }
+  static toRegexString(value) {
+    let result = undefined;
+    if (value instanceof RegExp) {
+      if (value.flags) {
+        throw new Error("Regex flags are not supported");
+      }
+      result = value.source;
+    } else {
+      result = value;
+    }
+    return result || null;
+  }
+}
+const transformRequestManager = exports.TransformRequestManager = new TransformRequestManager();
+//# sourceMappingURL=TransformRequestManager.js.map

package/lib/commonjs/modules/transform-request/TransformRequestManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_NativeTransformRequestModule","_interopRequireDefault","require","e","__esModule","default","TransformRequestManager","addUrlTransform","options","id","getId","NativeTransformRequestModule","toRegexString","match","find","replace","removeUrlTransform","clearUrlTransforms","addUrlSearchParam","name","value","removeUrlSearchParam","addHeader","clearUrlSearchParams","removeHeader","clearHeaders","clear","lastId","result","undefined","RegExp","flags","Error","source","transformRequestManager","exports"],"sourceRoot":"../../../../src","sources":["modules/transform-request/TransformRequestManager.ts"],"mappings":";;;;;;AAAA,IAAAA,6BAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA0E,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAmB1E;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;;AASA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,uBAAuB,CAAC;EAC5B;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,eAAeA,CAACC,OAA4B,EAAU;IACpD,MAAMC,EAAE,GAAGD,OAAO,CAACC,EAAE,IAAI,IAAI,CAACC,KAAK,CAAC,CAAC;IAErCC,qCAA4B,CAACJ,eAAe,CAC1CE,EAAE,EACFH,uBAAuB,CAACM,aAAa,CAACJ,OAAO,CAACK,KAAK,CAAC,EACpDP,uBAAuB,CAACM,aAAa,CAACJ,OAAO,CAACM,IAAI,CAAC,IAAI,EAAE,EACzDN,OAAO,CAACO,OACV,CAAC;IAED,OAAON,EAAE;EACX;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEO,kBAAkBA,CAACP,EAAU,EAAQ;IACnCE,qCAA4B,CAACK,kBAAkB,CAACP,EAAE,CAAC;EACrD;;EAEA;AACF;AACA;EACEQ,kBAAkBA,CAAA,EAAS;IACzBN,qCAA4B,CAACM,kBAAkB,CAAC,CAAC;EACnD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACV,OAA8B,EAAU;IACxD,MAAMC,EAAE,GAAGD,OAAO,CAACC,EAAE,IAAI,IAAI,CAACC,KAAK,CAAC,CAAC;IAErCC,qCAA4B,CAACO,iBAAiB,CAC5CT,EAAE,EACFH,uBAAuB,CAACM,aAAa,CAACJ,OAAO,CAACK,KAAK,CAAC,EACpDL,OAAO,CAACW,IAAI,EACZX,OAAO,CAACY,KACV,CAAC;IAED,OAAOX,EAAE;EACX;;EAEA;AACF;AACA;AACA;AACA;EACEY,oBAAoBA,CAACZ,EAAU,EAAQ;IACrCE,qCAA4B,CAACU,oBAAoB,CAACZ,EAAE,CAAC;EACvD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEa,SAASA,CAACd,OAAsB,EAAU;IACxC,MAAMC,EAAE,GAAGD,OAAO,CAACC,EAAE,IAAI,IAAI,CAACC,KAAK,CAAC,CAAC;IAErCC,qCAA4B,CAACW,SAAS,CACpCb,EAAE,EACFH,uBAAuB,CAACM,aAAa,CAACJ,OAAO,CAACK,KAAK,CAAC,EACpDL,OAAO,CAACW,IAAI,EACZX,OAAO,CAACY,KACV,CAAC;IAED,OAAOX,EAAE;EACX;;EAEA;AACF;AACA;EACEc,oBAAoBA,CAAA,EAAS;IAC3BZ,qCAA4B,CAACY,oBAAoB,CAAC,CAAC;EACrD;;EAEA;AACF;AACA;AACA;AACA;EACEC,YAAYA,CAACf,EAAU,EAAQ;IAC7BE,qCAA4B,CAACa,YAAY,CAACf,EAAE,CAAC;EAC/C;;EAEA;AACF;AACA;EACEgB,YAAYA,CAAA,EAAS;IACnBd,qCAA4B,CAACc,YAAY,CAAC,CAAC;EAC7C;;EAEA;AACF;AACA;EACEC,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACT,kBAAkB,CAAC,CAAC;IACzB,IAAI,CAACM,oBAAoB,CAAC,CAAC;IAC3B,IAAI,CAACE,YAAY,CAAC,CAAC;EACrB;EAEQE,MAAM,GAAW,CAAC,CAAC;EAEnBjB,KAAKA,CAAA,EAAG;IACd,IAAI,CAACiB,MAAM,EAAE;IAEb,OAAO,oBAAoB,GAAG,IAAI,CAACA,MAAM;EAC3C;EAEA,OAAef,aAAaA,CAC1BQ,KAAkC,EACnB;IACf,IAAIQ,MAA0B,GAAGC,SAAS;IAC1C,IAAIT,KAAK,YAAYU,MAAM,EAAE;MAC3B,IAAIV,KAAK,CAACW,KAAK,EAAE;QACf,MAAM,IAAIC,KAAK,CAAC,+BAA+B,CAAC;MAClD;MAEAJ,MAAM,GAAGR,KAAK,CAACa,MAAM;IACvB,CAAC,MAAM;MACLL,MAAM,GAAGR,KAAK;IAChB;IAEA,OAAOQ,MAAM,IAAI,IAAI;EACvB;AACF;AAEA,MAAMM,uBAAuB,GAAAC,OAAA,CAAA7B,uBAAA,GAAG,IAAIA,uBAAuB,CAAC,CAAC","ignoreList":[]}