@maplibre/maplibre-react-native 11.0.0-beta.19 → 11.0.0-beta.20

package/lib/typescript/commonjs/modules/transform-request/TransformRequestManager.d.ts

@@ -0,0 +1,201 @@
+export interface TransformOptions {
+    /**
+     * The id is used to identify a transform. Can be used to remove or update it.
+     * When omitted it will be auto-generated.
+     */
+    id?: string;
+    /**
+     * Optional regex to be used as the condition, if the transform should be
+     * applied. When omitted the transform will always be applied.
+     *
+     * Global flags are (like `/i`) are not supported. Supports only inline flags, e.g. `(?i)` for case-insensitive matching.
+     */
+    match?: RegExp | string;
+}
+/**
+ * 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.
+ */
+export interface UrlTransformOptions extends TransformOptions {
+    /**
+     * Regex to find the portion of the URL to replace.
+     * Supports capture groups that can be back-referenced in `replace` as `$1`, `$2`, …
+     *
+     * Global flags are (like `/i`) are not supported. Supports only inline flags, e.g. `(?i)` for case-insensitive matching.
+     */
+    find: RegExp | string;
+    /**
+     * Replacement string. Reference capture groups from `find` with `$1`, `$2`, …
+     */
+    replace: string;
+}
+/**
+ * A URL query parameter to append to matching map resource requests.
+ */
+export interface UrlSearchParamOptions extends TransformOptions {
+    /** The query parameter name (e.g., `"apiKey"`). */
+    name: string;
+    /** The query parameter value (e.g., your API key). */
+    value: string;
+}
+/**
+ * A HTTP header to send with matching map resource requests.
+ */
+export interface HeaderOptions extends TransformOptions {
+    /** The header name (e.g., `"Authorization"`). */
+    name: string;
+    /** The header value (e.g., `"Bearer token123"`). */
+    value: string;
+}
+/**
+ * TransformRequestManager provides methods for managing HTTP requests made by MapLibre.
+ *
+ * Transformations are possible in three ways:
+ *
+ * 1. Transforming the URL with search and replace
+ * 2. Adding URL search params
+ * 3. Adding HTTP headers
+ *
+ * Transforms are applied in this order. The `match` conditions are applied to
+ * possibly already transformed URLs.
+ *
+ * @remarks
+ * To gain insight into which transforms are applied set the log level to
+ * `"debug"` via {@link LogManager}:
+ *
+ * ```ts
+ * LogManager.setLogLevel("debug");
+ * ```
+ */
+declare 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`.
+     *
+     * @example
+     * // Upgrade all requests to HTTPS
+     * TransformRequestManager.addUrlTransform({
+     *   id: "force-https",
+     *   find: "^http://",
+     *   replace: "https://",
+     * });
+     *
+     * @example
+     * // Redirect a specific domain through a proxy
+     * 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
+     * TransformRequestManager.addUrlTransform({
+     *   id: "api-key",
+     *   match: "api\\.example\\.com",
+     *   find: "(https://api\\.example\\.com/)(.*)",
+     *   replace: "$1mySecretKey/$2",
+     * });
+     *
+     * @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.
+     */
+    addUrlTransform(options: UrlTransformOptions): string;
+    /**
+     * 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: string): void;
+    /**
+     * Removes all registered URL transforms
+     */
+    clearUrlTransforms(): void;
+    /**
+     * 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.
+     *
+     * @example
+     * // Add apiKey to for a specific domain
+     * TransformRequestManager.addUrlSearchParam({
+     *   match: /tiles\.example\.com/,
+     *   name: "apiKey",
+     *   value: "your-api-key",
+     * });
+     *
+     * // Add apiKey to all requests (no match = applies to all)
+     * TransformRequestManager.addUrlSearchParam({ name: "apiKey", value: "your-api-key" });
+     *
+     * @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.
+     */
+    addUrlSearchParam(options: UrlSearchParamOptions): string;
+    /**
+     * Removes a previously added URL query parameter by its `id`.
+     *
+     * @param id The identifier passed to/returned from {@link addUrlSearchParam}.
+     */
+    removeUrlSearchParam(id: string): void;
+    /**
+     * 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.
+     *
+     * @example
+     * // Add header to all requests
+     * TransformRequestManager.addHeader({ name: "Authorization", value: "Bearer token123" });
+     *
+     * // Add header only to requests matching a pattern
+     * TransformRequestManager.addHeader({
+     *   name: "X-API-Key",
+     *   value: "key123",
+     *   match: /https:\/\/api\.example\.com\/tiles\//,
+     * });
+     *
+     * @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.
+     */
+    addHeader(options: HeaderOptions): string;
+    /**
+     * Removes all registered URL search params.
+     */
+    clearUrlSearchParams(): void;
+    /**
+     * Removes a previously added HTTP header by its `id`.
+     *
+     * @param id The identifier passed to/returned from {@link addHeader}.
+     */
+    removeHeader(id: string): void;
+    /**
+     * Removes all registered HTTP headers.
+     */
+    clearHeaders(): void;
+    /**
+     * Removes all registered URL transforms, URL search params and HTTP headers.
+     */
+    clear(): void;
+    private lastId;
+    private getId;
+    private static toRegexString;
+}
+declare const transformRequestManager: TransformRequestManager;
+export { transformRequestManager as TransformRequestManager };
+//# sourceMappingURL=TransformRequestManager.d.ts.map

package/lib/typescript/commonjs/modules/transform-request/TransformRequestManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformRequestManager.d.ts","sourceRoot":"","sources":["../../../../../src/modules/transform-request/TransformRequestManager.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IAEb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAM,uBAAuB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAarD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM;IAazD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAItC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAazC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,MAAM,CAAC,aAAa;CAgB7B;AAED,QAAA,MAAM,uBAAuB,yBAAgC,CAAC;AAE9D,OAAO,EAAE,uBAAuB,IAAI,uBAAuB,EAAE,CAAC"}

package/lib/typescript/module/index.d.ts

@@ -20,6 +20,7 @@ export { NetworkManager } from "./modules/network/NetworkManager";
 export { OfflineManager, type OfflinePackCreateOptions, type OfflinePackDownloadState, type OfflinePackError, type OfflinePackProgressListener, type OfflinePackErrorListener, } from "./modules/offline/OfflineManager";
 export { OfflinePack, type OfflinePackStatus, } from "./modules/offline/OfflinePack";
 export { StaticMapImageManager, type StaticMapOptions, type StaticMapCenterOptions, type StaticMapBoundsOptions, type StaticMapCreateOptions, } from "./modules/static-map/StaticMapManager";
+export { TransformRequestManager, type TransformOptions, type UrlTransformOptions, type UrlSearchParamOptions, type HeaderOptions, } from "./modules/transform-request/TransformRequestManager";
 export type { Anchor } from "./types/Anchor";
 export type { LngLat } from "./types/LngLat";
 export type { LngLatBounds } from "./types/LngLatBounds";

package/lib/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/modules/network/NativeNetworkModule.d.ts

@@ -1,7 +1,5 @@
 import type { TurboModule } from "react-native";
 export interface Spec extends TurboModule {
-    addRequestHeader(name: string, value: string, match: string | null): void;
-    removeRequestHeader(name: string): void;
     setConnected(connected: boolean): void;
 }
 declare const _default: Spec;

package/lib/typescript/module/modules/network/NativeNetworkModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeNetworkModule.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network/NativeNetworkModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAE1E,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;;AAED,wBAA2E"}
+{"version":3,"file":"NativeNetworkModule.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network/NativeNetworkModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;;AAED,wBAA2E"}

package/lib/typescript/module/modules/network/NetworkManager.d.ts

@@ -1,39 +1,7 @@
 /**
- * NetworkManager provides methods for managing HTTP requests made by MapLibre.
- * This includes adding custom headers to tile requests and controlling network connectivity.
+ * NetworkManager provides methods for managing and controlling network connectivity.
  */
 declare class NetworkManager {
-    /**
-     * Adds a custom HTTP header that will be sent with all map tile requests.
-     * This is useful for adding authentication tokens or other custom headers
-     * required by your tile server.
-     *
-     * @example
-     * // Add header to all requests
-     * NetworkManager.addRequestHeader("Authorization", "Bearer token123");
-     *
-     * // Add header only to requests matching a regex pattern (string)
-     * NetworkManager.addRequestHeader("X-API-Key", "key123", "https:\\/\\/api\\.example\\.com\\/tiles\\/");
-     *
-     * // Add header only to requests matching a regex pattern (RegExp)
-     * NetworkManager.addRequestHeader("X-API-Key", "key123", /https:\/\/api\.example\.com\/tiles\//);
-     *
-     * @param name The name of the header (e.g., "Authorization")
-     * @param value The value of the header (e.g., "Bearer token123")
-     * @param match Optional regex pattern to match against network URLs. If provided, the header will only be added to requests whose URLs match this pattern. Can be a RegExp object or a regex string.
-     */
-    static addRequestHeader(name: string, value: string, match?: string | RegExp): void;
-    /**
-     * Removes a previously added custom HTTP header.
-     *
-     * @example
-     * ```ts
-     * NetworkManager.removeRequestHeader("Authorization");
-     * ```
-     *
-     * @param headerName The name of the header to remove
-     */
-    static removeRequestHeader(headerName: string): void;
     /**
      * Android only: Sets the connectivity state of the map. When set to false, the map will
      * not make any network requests and will only use cached tiles. This is

package/lib/typescript/module/modules/network/NetworkManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkManager.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network/NetworkManager.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,cAAM,cAAc;IAClB;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,gBAAgB,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GACtB,IAAI;IAQP;;;;;;;;;OASG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpD;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;CAG9C;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"NetworkManager.d.ts","sourceRoot":"","sources":["../../../../../src/modules/network/NetworkManager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,cAAM,cAAc;IAClB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;CAG9C;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/lib/typescript/module/modules/transform-request/NativeTransformRequestModule.d.ts

@@ -0,0 +1,15 @@
+import type { TurboModule } from "react-native";
+export interface Spec extends TurboModule {
+    addUrlTransform(id: string, match: string | null, find: string, replace: string): void;
+    removeUrlTransform(id: string): void;
+    clearUrlTransforms(): void;
+    addUrlSearchParam(id: string, match: string | null, name: string, value: string): void;
+    removeUrlSearchParam(id: string): void;
+    clearUrlSearchParams(): void;
+    addHeader(id: string, match: string | null, name: string, value: string): void;
+    removeHeader(id: string): void;
+    clearHeaders(): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeTransformRequestModule.d.ts.map

package/lib/typescript/module/modules/transform-request/NativeTransformRequestModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeTransformRequestModule.d.ts","sourceRoot":"","sources":["../../../../../src/modules/transform-request/NativeTransformRequestModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,eAAe,CACb,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAAC;IAER,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,kBAAkB,IAAI,IAAI,CAAC;IAE3B,iBAAiB,CACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC,oBAAoB,IAAI,IAAI,CAAC;IAE7B,SAAS,CACP,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,IAAI,CAAC;IAER,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,YAAY,IAAI,IAAI,CAAC;CACtB;;AAED,wBAEE"}

package/lib/typescript/module/modules/transform-request/TransformRequestManager.d.ts

@@ -0,0 +1,201 @@
+export interface TransformOptions {
+    /**
+     * The id is used to identify a transform. Can be used to remove or update it.
+     * When omitted it will be auto-generated.
+     */
+    id?: string;
+    /**
+     * Optional regex to be used as the condition, if the transform should be
+     * applied. When omitted the transform will always be applied.
+     *
+     * Global flags are (like `/i`) are not supported. Supports only inline flags, e.g. `(?i)` for case-insensitive matching.
+     */
+    match?: RegExp | string;
+}
+/**
+ * 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.
+ */
+export interface UrlTransformOptions extends TransformOptions {
+    /**
+     * Regex to find the portion of the URL to replace.
+     * Supports capture groups that can be back-referenced in `replace` as `$1`, `$2`, …
+     *
+     * Global flags are (like `/i`) are not supported. Supports only inline flags, e.g. `(?i)` for case-insensitive matching.
+     */
+    find: RegExp | string;
+    /**
+     * Replacement string. Reference capture groups from `find` with `$1`, `$2`, …
+     */
+    replace: string;
+}
+/**
+ * A URL query parameter to append to matching map resource requests.
+ */
+export interface UrlSearchParamOptions extends TransformOptions {
+    /** The query parameter name (e.g., `"apiKey"`). */
+    name: string;
+    /** The query parameter value (e.g., your API key). */
+    value: string;
+}
+/**
+ * A HTTP header to send with matching map resource requests.
+ */
+export interface HeaderOptions extends TransformOptions {
+    /** The header name (e.g., `"Authorization"`). */
+    name: string;
+    /** The header value (e.g., `"Bearer token123"`). */
+    value: string;
+}
+/**
+ * TransformRequestManager provides methods for managing HTTP requests made by MapLibre.
+ *
+ * Transformations are possible in three ways:
+ *
+ * 1. Transforming the URL with search and replace
+ * 2. Adding URL search params
+ * 3. Adding HTTP headers
+ *
+ * Transforms are applied in this order. The `match` conditions are applied to
+ * possibly already transformed URLs.
+ *
+ * @remarks
+ * To gain insight into which transforms are applied set the log level to
+ * `"debug"` via {@link LogManager}:
+ *
+ * ```ts
+ * LogManager.setLogLevel("debug");
+ * ```
+ */
+declare 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`.
+     *
+     * @example
+     * // Upgrade all requests to HTTPS
+     * TransformRequestManager.addUrlTransform({
+     *   id: "force-https",
+     *   find: "^http://",
+     *   replace: "https://",
+     * });
+     *
+     * @example
+     * // Redirect a specific domain through a proxy
+     * 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
+     * TransformRequestManager.addUrlTransform({
+     *   id: "api-key",
+     *   match: "api\\.example\\.com",
+     *   find: "(https://api\\.example\\.com/)(.*)",
+     *   replace: "$1mySecretKey/$2",
+     * });
+     *
+     * @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.
+     */
+    addUrlTransform(options: UrlTransformOptions): string;
+    /**
+     * 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: string): void;
+    /**
+     * Removes all registered URL transforms
+     */
+    clearUrlTransforms(): void;
+    /**
+     * 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.
+     *
+     * @example
+     * // Add apiKey to for a specific domain
+     * TransformRequestManager.addUrlSearchParam({
+     *   match: /tiles\.example\.com/,
+     *   name: "apiKey",
+     *   value: "your-api-key",
+     * });
+     *
+     * // Add apiKey to all requests (no match = applies to all)
+     * TransformRequestManager.addUrlSearchParam({ name: "apiKey", value: "your-api-key" });
+     *
+     * @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.
+     */
+    addUrlSearchParam(options: UrlSearchParamOptions): string;
+    /**
+     * Removes a previously added URL query parameter by its `id`.
+     *
+     * @param id The identifier passed to/returned from {@link addUrlSearchParam}.
+     */
+    removeUrlSearchParam(id: string): void;
+    /**
+     * 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.
+     *
+     * @example
+     * // Add header to all requests
+     * TransformRequestManager.addHeader({ name: "Authorization", value: "Bearer token123" });
+     *
+     * // Add header only to requests matching a pattern
+     * TransformRequestManager.addHeader({
+     *   name: "X-API-Key",
+     *   value: "key123",
+     *   match: /https:\/\/api\.example\.com\/tiles\//,
+     * });
+     *
+     * @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.
+     */
+    addHeader(options: HeaderOptions): string;
+    /**
+     * Removes all registered URL search params.
+     */
+    clearUrlSearchParams(): void;
+    /**
+     * Removes a previously added HTTP header by its `id`.
+     *
+     * @param id The identifier passed to/returned from {@link addHeader}.
+     */
+    removeHeader(id: string): void;
+    /**
+     * Removes all registered HTTP headers.
+     */
+    clearHeaders(): void;
+    /**
+     * Removes all registered URL transforms, URL search params and HTTP headers.
+     */
+    clear(): void;
+    private lastId;
+    private getId;
+    private static toRegexString;
+}
+declare const transformRequestManager: TransformRequestManager;
+export { transformRequestManager as TransformRequestManager };
+//# sourceMappingURL=TransformRequestManager.d.ts.map

package/lib/typescript/module/modules/transform-request/TransformRequestManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformRequestManager.d.ts","sourceRoot":"","sources":["../../../../../src/modules/transform-request/TransformRequestManager.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;;;;OAKG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IAEb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAM,uBAAuB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM;IAarD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM;IAazD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAItC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAazC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,MAAM,CAAC,aAAa;CAgB7B;AAED,QAAA,MAAM,uBAAuB,yBAAgC,CAAC;AAE9D,OAAO,EAAE,uBAAuB,IAAI,uBAAuB,EAAE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maplibre/maplibre-react-native",
   "description": "React Native library for creating maps with MapLibre Native for Android & iOS",
-  "version": "11.0.0-beta.19",
+  "version": "11.0.0-beta.20",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -132,17 +132,6 @@
         "MLRNRasterSource": "MLRNRasterSourceComponentView",
         "MLRNGeoJSONSource": "MLRNGeoJSONSourceComponentView",
         "MLRNVectorSource": "MLRNVectorSourceComponentView"
-      },
-      "modulesProvider": {
-        "MLRNCameraModule": "MLRNCameraModule",
-        "MLRNGeoJSONSourceModule": "MLRNGeoJSONSourceModule",
-        "MLRNImagesModule": "MLRNImagesModule",
-        "MLRNLocationModule": "MLRNLocationModule",
-        "MLRNLogModule": "MLRNLogModule",
-        "MLRNMapViewModule": "MLRNMapViewModule",
-        "MLRNOfflineModule": "MLRNOfflineModule",
-        "MLRNStaticMapModule": "MLRNStaticMapModule",
-        "MLRNVectorSourceModule": "MLRNVectorSourceModule"
       }
     }
   },

package/src/index.ts

@@ -158,6 +158,14 @@ export {
   type StaticMapCreateOptions,
 } from "./modules/static-map/StaticMapManager";
 
+export {
+  TransformRequestManager,
+  type TransformOptions,
+  type UrlTransformOptions,
+  type UrlSearchParamOptions,
+  type HeaderOptions,
+} from "./modules/transform-request/TransformRequestManager";
+
 export type { Anchor } from "./types/Anchor";
 export type { LngLat } from "./types/LngLat";
 export type { LngLatBounds } from "./types/LngLatBounds";

package/src/modules/network/NativeNetworkModule.ts

@@ -2,10 +2,6 @@ import type { TurboModule } from "react-native";
 import { TurboModuleRegistry } from "react-native";
 
 export interface Spec extends TurboModule {
-  addRequestHeader(name: string, value: string, match: string | null): void;
-
-  removeRequestHeader(name: string): void;
-
   setConnected(connected: boolean): void;
 }
 

package/src/modules/network/NetworkManager.ts

@@ -1,55 +1,9 @@
 import NativeNetworkModule from "./NativeNetworkModule";
 
 /**
- * NetworkManager provides methods for managing HTTP requests made by MapLibre.
- * This includes adding custom headers to tile requests and controlling network connectivity.
+ * NetworkManager provides methods for managing and controlling network connectivity.
  */
 class NetworkManager {
-  /**
-   * Adds a custom HTTP header that will be sent with all map tile requests.
-   * This is useful for adding authentication tokens or other custom headers
-   * required by your tile server.
-   *
-   * @example
-   * // Add header to all requests
-   * NetworkManager.addRequestHeader("Authorization", "Bearer token123");
-   *
-   * // Add header only to requests matching a regex pattern (string)
-   * NetworkManager.addRequestHeader("X-API-Key", "key123", "https:\\/\\/api\\.example\\.com\\/tiles\\/");
-   *
-   * // Add header only to requests matching a regex pattern (RegExp)
-   * NetworkManager.addRequestHeader("X-API-Key", "key123", /https:\/\/api\.example\.com\/tiles\//);
-   *
-   * @param name The name of the header (e.g., "Authorization")
-   * @param value The value of the header (e.g., "Bearer token123")
-   * @param match Optional regex pattern to match against network URLs. If provided, the header will only be added to requests whose URLs match this pattern. Can be a RegExp object or a regex string.
-   */
-  static addRequestHeader(
-    name: string,
-    value: string,
-    match?: string | RegExp,
-  ): void {
-    NativeNetworkModule.addRequestHeader(
-      name,
-      value,
-      (match instanceof RegExp ? match.source : match) || null,
-    );
-  }
-
-  /**
-   * Removes a previously added custom HTTP header.
-   *
-   * @example
-   * ```ts
-   * NetworkManager.removeRequestHeader("Authorization");
-   * ```
-   *
-   * @param headerName The name of the header to remove
-   */
-  static removeRequestHeader(headerName: string): void {
-    NativeNetworkModule.removeRequestHeader(headerName);
-  }
-
   /**
    * Android only: Sets the connectivity state of the map. When set to false, the map will
    * not make any network requests and will only use cached tiles. This is