@itwin/core-frontend 5.15.1 → 5.16.0-dev.10

package/lib/cjs/tile/map/MapLayerImageryFormats.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapLayerImageryFormats.js","sourceRoot":"","sources":["../../../../src/tile/map/MapLayerImageryFormats.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module MapLayers\r\n */\r\nimport { ImageMapLayerSettings, MapSubLayerProps } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"../../IModelConnection\";\r\nimport {\r\n  ArcGISMapLayerImageryProvider,\r\n  ArcGisUtilities,\r\n  BingMapsImageryLayerProvider,\r\n  ImageryMapLayerTreeReference,\r\n  MapBoxLayerImageryProvider,\r\n  MapLayerFormat,\r\n  MapLayerImageryProvider,\r\n  MapLayerSource,\r\n  MapLayerSourceStatus,\r\n  MapLayerSourceValidation,\r\n  MapLayerTileTreeReference,\r\n  MapLayerUntrustedOriginError,\r\n  TileUrlImageryProvider,\r\n  ValidateSourceArgs,\r\n  WmsCapabilities,\r\n  WmsMapLayerImageryProvider,\r\n  WmtsCapabilities,\r\n  WmtsCapability,\r\n  WmtsMapLayerImageryProvider,\r\n} from \"../internal\";\r\n\r\n/** Base class imagery map layer formats.\r\n *  Subclasses should override formatId and [[MapLayerFormat.createImageryProvider]].\r\n * @see [[MapLayerFormat]]\r\n * @beta\r\n */\r\nexport class ImageryMapLayerFormat extends MapLayerFormat {\r\n  /** @internal */\r\n  public static override createMapLayerTree(layerSettings: ImageMapLayerSettings, layerIndex: number, iModel: IModelConnection): MapLayerTileTreeReference | undefined {\r\n    return new ImageryMapLayerTreeReference({ layerSettings, layerIndex, iModel });\r\n  }\r\n}\r\n\r\nclass WmsMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"WMS\";\r\n\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new WmsMapLayerImageryProvider(settings);\r\n  }\r\n  public static override async validateSource(url: string, userName?: string, password?: string, ignoreCache?: boolean): Promise<MapLayerSourceValidation> {\r\n    const source =  MapLayerSource.fromJSON({name: \"\", formatId: WmsMapLayerFormat.formatId, url});\r\n    if (source === undefined)\r\n      return { status: MapLayerSourceStatus.InvalidFormat };\r\n    source.userName = userName;\r\n    source.password = password;\r\n    return WmsMapLayerFormat.validate({source, ignoreCache});\r\n  }\r\n\r\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\r\n    const {source, ignoreCache} = args;\r\n    const { url, userName, password } = source;\r\n\r\n    try {\r\n      let subLayers: MapSubLayerProps[] | undefined;\r\n      const maxVisibleSubLayers = 50;\r\n      const capabilities = await WmsCapabilities.create(url, (userName && password ? {user: userName, password} : undefined), ignoreCache, source.collectQueryParams());\r\n      if (capabilities !== undefined) {\r\n        subLayers = capabilities.getSubLayers(false);\r\n        const rootsSubLayer = subLayers?.find((sublayer) => sublayer.parent === undefined);\r\n        const hasTooManyLayers = subLayers && subLayers.length > maxVisibleSubLayers;\r\n\r\n        if (!Array.isArray(subLayers))\r\n          return { status: MapLayerSourceStatus.Valid, subLayers };\r\n\r\n        for (const subLayer of subLayers) {\r\n          // In general for WMS, we prefer to have the children of root node visible, but not the root itself.\r\n          // Thats simply to give more flexibility in the UI.\r\n          // Two exceptions to this rule: If there are too many layers or the root node is not named.\r\n          if (subLayer.id && subLayer.id === rootsSubLayer?.id\r\n            && (!(subLayer.name && subLayer.name.length > 0) || hasTooManyLayers)) {\r\n            subLayer.visible = true;\r\n            break;  // if root node is visible, don't bother turning ON any other layers\r\n          }\r\n\r\n          // Make children of the root node visible.\r\n          if (subLayer.parent && subLayer.parent === rootsSubLayer?.id && !hasTooManyLayers) {\r\n            const isUnnamedGroup = (layer: MapSubLayerProps) => {\r\n              return layer.children && layer.children.length > 0 && (!layer.name || layer.name.length === 0);\r\n            };\r\n\r\n            const makeChildrenVisible = (layers: MapSubLayerProps[] | undefined, layer: MapSubLayerProps) => {\r\n              layer?.children?.forEach((childId) => {\r\n                const childSubLayer = subLayers?.find((child) => child?.id === childId);\r\n                if (childSubLayer) {\r\n                  childSubLayer.visible = true;\r\n                  if (isUnnamedGroup(childSubLayer))\r\n                    makeChildrenVisible(layers, childSubLayer);\r\n                }\r\n              });\r\n            };\r\n\r\n            subLayer.visible = true;\r\n\r\n            // If we got a unnamed group, make children visible recursively until we have a leaf or named group\r\n            if (isUnnamedGroup(subLayer))\r\n              makeChildrenVisible(subLayers, subLayer);\r\n          }\r\n        }\r\n      }\r\n\r\n      return { status: MapLayerSourceStatus.Valid, subLayers };\r\n    } catch (err: any) {\r\n      if (err instanceof MapLayerUntrustedOriginError) {\r\n        let blockedOrigin: string | undefined;\r\n        try { blockedOrigin = new URL(err.url).origin; } catch { /* non-hierarchical URL */ }\r\n        return { status: MapLayerSourceStatus.UntrustedOrigin, blockedOrigin };\r\n      }\r\n      let status = MapLayerSourceStatus.InvalidUrl;\r\n      if (err?.status === 401) {\r\n        status = ((userName && password) ? MapLayerSourceStatus.InvalidCredentials : MapLayerSourceStatus.RequireAuth);\r\n      }\r\n      return { status};\r\n    }\r\n  }\r\n\r\n}\r\n\r\nclass WmtsMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"WMTS\";\r\n\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new WmtsMapLayerImageryProvider(settings);\r\n  }\r\n\r\n  public static override async validateSource(url: string, userName?: string, password?: string, ignoreCache?: boolean): Promise<MapLayerSourceValidation> {\r\n    const source =  MapLayerSource.fromJSON({name: \"\", formatId: WmtsMapLayerFormat.formatId, url});\r\n    if (source === undefined)\r\n      return { status: MapLayerSourceStatus.InvalidFormat };\r\n    source.userName = userName;\r\n    source.password = password;\r\n    return WmtsMapLayerFormat.validate({source, ignoreCache});\r\n  }\r\n\r\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\r\n    const {source, ignoreCache} = args;\r\n    const { url, userName, password } = source;\r\n    try {\r\n      const subLayers: MapSubLayerProps[] = [];\r\n      const capabilities = await WmtsCapabilities.create(url, (userName && password ? {user: userName, password} : undefined), ignoreCache, source.collectQueryParams());\r\n      if (!capabilities)\r\n        return { status: MapLayerSourceStatus.InvalidUrl };\r\n\r\n      // Only returns layer that can be published in the Google maps or WGS84 aligned tile trees.\r\n      let supportedTms: WmtsCapability.TileMatrixSet[]  = [];\r\n      const googleMapsTms = capabilities?.contents?.getGoogleMapsCompatibleTileMatrixSet();\r\n      if (googleMapsTms) {\r\n        supportedTms = googleMapsTms;\r\n      }\r\n      const wsg84Tms = capabilities?.contents?.getEpsg4326CompatibleTileMatrixSet();\r\n      if (wsg84Tms) {\r\n        supportedTms = supportedTms.concat(wsg84Tms);\r\n      }\r\n\r\n      if (supportedTms.length === 0) {\r\n        // This WMTS server doesn't support either GoogleMaps or WSG84\r\n        return { status: MapLayerSourceStatus.InvalidCoordinateSystem };\r\n      }\r\n\r\n      let subLayerId = 0;\r\n      capabilities?.contents?.layers.forEach((layer) => {\r\n        const hasSupportedTms = supportedTms?.some((tms) => {\r\n          return layer.tileMatrixSetLinks.some((tmls) => tmls.tileMatrixSet === tms.identifier);\r\n        });\r\n        if (hasSupportedTms) {\r\n          subLayers.push({\r\n            name: layer.identifier,\r\n            title: layer.title ?? layer.identifier,\r\n            visible: (subLayers.length === 0),   // Make the first layer visible.\r\n            parent: undefined,\r\n            children: undefined,\r\n            id: subLayerId++,\r\n          });\r\n        }\r\n      });\r\n\r\n      // Return error if we could find a single compatible layer.\r\n      if (subLayers.length === 0)\r\n        return { status: MapLayerSourceStatus.InvalidTileTree };\r\n\r\n      return { status: MapLayerSourceStatus.Valid, subLayers };\r\n    } catch (err: any) {\r\n      if (err instanceof MapLayerUntrustedOriginError) {\r\n        let blockedOrigin: string | undefined;\r\n        try { blockedOrigin = new URL(err.url).origin; } catch { /* non-hierarchical URL */ }\r\n        return { status: MapLayerSourceStatus.UntrustedOrigin, blockedOrigin };\r\n      }\r\n      let status = MapLayerSourceStatus.InvalidUrl;\r\n      if (err?.status === 401) {\r\n        status = ((userName && password) ? MapLayerSourceStatus.InvalidCredentials : MapLayerSourceStatus.RequireAuth);\r\n      }\r\n      return { status};\r\n    }\r\n  }\r\n\r\n}\r\n\r\nclass ArcGISMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"ArcGIS\";\r\n  public static override async validateSource(url: string, userName?: string, password?: string, ignoreCache?: boolean): Promise<MapLayerSourceValidation> {\r\n    const source =  MapLayerSource.fromJSON({name: \"\", formatId: WmtsMapLayerFormat.formatId, url});\r\n    if (source === undefined)\r\n      return { status: MapLayerSourceStatus.InvalidFormat };\r\n    source.userName = userName;\r\n    source.password = password;\r\n    return WmtsMapLayerFormat.validate({source, ignoreCache});\r\n  }\r\n\r\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\r\n    const urlValidation = ArcGisUtilities.validateUrl(args.source.url, \"MapServer\");\r\n    if (urlValidation !== MapLayerSourceStatus.Valid)\r\n      return {status: urlValidation};\r\n\r\n    // Some Map service supporting only tiles don't include the 'Map' capabilities, thus we can't make it mandatory.\r\n    return ArcGisUtilities.validateSource({...args, capabilitiesFilter: []});\r\n  }\r\n\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new ArcGISMapLayerImageryProvider(settings);\r\n  }\r\n}\r\n\r\n/** @deprecated in 5.11.0 - will not be removed until after 2027-07-03. Bing Maps imagery is deprecated. For basemap imagery providers, see `@itwin/map-layers-formats`. */\r\nclass BingMapsMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"BingMaps\";\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    return new BingMapsImageryLayerProvider(settings);\r\n  }\r\n}\r\n\r\nclass MapBoxImageryMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"MapboxImagery\";\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new MapBoxLayerImageryProvider(settings);\r\n  }\r\n}\r\nclass TileUrlMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"TileURL\";\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined { return new TileUrlImageryProvider(settings); }\r\n}\r\n\r\n/** @internal */\r\n// eslint-disable-next-line @typescript-eslint/no-deprecated -- BingMapsMapLayerFormat is deprecated but must remain registered for legacy persisted styles.\r\nexport const internalMapLayerImageryFormats = [WmsMapLayerFormat, WmtsMapLayerFormat, ArcGISMapLayerFormat, BingMapsMapLayerFormat, MapBoxImageryMapLayerFormat, TileUrlMapLayerFormat];\r\n"]}
+{"version":3,"file":"MapLayerImageryFormats.js","sourceRoot":"","sources":["../../../../src/tile/map/MapLayerImageryFormats.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module MapLayers\r\n */\r\nimport { ImageMapLayerSettings, MapSubLayerProps } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"../../IModelConnection\";\r\nimport {\r\n  ArcGISMapLayerImageryProvider,\r\n  ArcGisUtilities,\r\n  BingMapsImageryLayerProvider,\r\n  ImageryMapLayerTreeReference,\r\n  MapBoxLayerImageryProvider,\r\n  MapLayerAuthenticationFailedError,\r\n  MapLayerFormat,\r\n  MapLayerImageryProvider,\r\n  MapLayerSource,\r\n  MapLayerSourceStatus,\r\n  MapLayerSourceValidation,\r\n  MapLayerTileTreeReference,\r\n  MapLayerUntrustedOriginError,\r\n  TileUrlImageryProvider,\r\n  ValidateSourceArgs,\r\n  WmsCapabilities,\r\n  WmsMapLayerImageryProvider,\r\n  WmtsCapabilities,\r\n  WmtsCapability,\r\n  WmtsMapLayerImageryProvider,\r\n} from \"../internal\";\r\n\r\n/** Base class imagery map layer formats.\r\n *  Subclasses should override formatId and [[MapLayerFormat.createImageryProvider]].\r\n * @see [[MapLayerFormat]]\r\n * @beta\r\n */\r\nexport class ImageryMapLayerFormat extends MapLayerFormat {\r\n  /** @internal */\r\n  public static override createMapLayerTree(layerSettings: ImageMapLayerSettings, layerIndex: number, iModel: IModelConnection): MapLayerTileTreeReference | undefined {\r\n    return new ImageryMapLayerTreeReference({ layerSettings, layerIndex, iModel });\r\n  }\r\n}\r\n\r\nclass WmsMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"WMS\";\r\n\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new WmsMapLayerImageryProvider(settings);\r\n  }\r\n  public static override async validateSource(url: string, userName?: string, password?: string, ignoreCache?: boolean): Promise<MapLayerSourceValidation> {\r\n    const source =  MapLayerSource.fromJSON({name: \"\", formatId: WmsMapLayerFormat.formatId, url});\r\n    if (source === undefined)\r\n      return { status: MapLayerSourceStatus.InvalidFormat };\r\n    source.userName = userName;\r\n    source.password = password;\r\n    return WmsMapLayerFormat.validate({source, ignoreCache});\r\n  }\r\n\r\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\r\n    const {source, ignoreCache} = args;\r\n    const { url, userName, password } = source;\r\n\r\n    try {\r\n      let subLayers: MapSubLayerProps[] | undefined;\r\n      const maxVisibleSubLayers = 50;\r\n      const capabilities = await WmsCapabilities.create(url, {\r\n        credentials: (userName && password ? {user: userName, password} : undefined),\r\n        ignoreCache,\r\n        queryParams: source.collectQueryParams(),\r\n        formatId: source.formatId,\r\n      });\r\n      if (capabilities !== undefined) {\r\n        subLayers = capabilities.getSubLayers(false);\r\n        const rootsSubLayer = subLayers?.find((sublayer) => sublayer.parent === undefined);\r\n        const hasTooManyLayers = subLayers && subLayers.length > maxVisibleSubLayers;\r\n\r\n        if (!Array.isArray(subLayers))\r\n          return { status: MapLayerSourceStatus.Valid, subLayers };\r\n\r\n        for (const subLayer of subLayers) {\r\n          // In general for WMS, we prefer to have the children of root node visible, but not the root itself.\r\n          // Thats simply to give more flexibility in the UI.\r\n          // Two exceptions to this rule: If there are too many layers or the root node is not named.\r\n          if (subLayer.id && subLayer.id === rootsSubLayer?.id\r\n            && (!(subLayer.name && subLayer.name.length > 0) || hasTooManyLayers)) {\r\n            subLayer.visible = true;\r\n            break;  // if root node is visible, don't bother turning ON any other layers\r\n          }\r\n\r\n          // Make children of the root node visible.\r\n          if (subLayer.parent && subLayer.parent === rootsSubLayer?.id && !hasTooManyLayers) {\r\n            const isUnnamedGroup = (layer: MapSubLayerProps) => {\r\n              return layer.children && layer.children.length > 0 && (!layer.name || layer.name.length === 0);\r\n            };\r\n\r\n            const makeChildrenVisible = (layers: MapSubLayerProps[] | undefined, layer: MapSubLayerProps) => {\r\n              layer?.children?.forEach((childId) => {\r\n                const childSubLayer = subLayers?.find((child) => child?.id === childId);\r\n                if (childSubLayer) {\r\n                  childSubLayer.visible = true;\r\n                  if (isUnnamedGroup(childSubLayer))\r\n                    makeChildrenVisible(layers, childSubLayer);\r\n                }\r\n              });\r\n            };\r\n\r\n            subLayer.visible = true;\r\n\r\n            // If we got a unnamed group, make children visible recursively until we have a leaf or named group\r\n            if (isUnnamedGroup(subLayer))\r\n              makeChildrenVisible(subLayers, subLayer);\r\n          }\r\n        }\r\n      }\r\n\r\n      return { status: MapLayerSourceStatus.Valid, subLayers };\r\n    } catch (err: any) {\r\n      if (err instanceof MapLayerUntrustedOriginError) {\r\n        let blockedOrigin: string | undefined;\r\n        try { blockedOrigin = new URL(err.url).origin; } catch { /* non-hierarchical URL */ }\r\n        return { status: MapLayerSourceStatus.UntrustedOrigin, blockedOrigin };\r\n      }\r\n      let status = MapLayerSourceStatus.InvalidUrl;\r\n      if (err instanceof MapLayerAuthenticationFailedError) {\r\n        status = MapLayerSourceStatus.RequireAuth;\r\n      } else if (err?.status === 401) {\r\n        status = ((userName && password) ? MapLayerSourceStatus.InvalidCredentials : MapLayerSourceStatus.RequireAuth);\r\n      }\r\n      return { status};\r\n    }\r\n  }\r\n\r\n}\r\n\r\nclass WmtsMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"WMTS\";\r\n\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new WmtsMapLayerImageryProvider(settings);\r\n  }\r\n\r\n  public static override async validateSource(url: string, userName?: string, password?: string, ignoreCache?: boolean): Promise<MapLayerSourceValidation> {\r\n    const source =  MapLayerSource.fromJSON({name: \"\", formatId: WmtsMapLayerFormat.formatId, url});\r\n    if (source === undefined)\r\n      return { status: MapLayerSourceStatus.InvalidFormat };\r\n    source.userName = userName;\r\n    source.password = password;\r\n    return WmtsMapLayerFormat.validate({source, ignoreCache});\r\n  }\r\n\r\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\r\n    const {source, ignoreCache} = args;\r\n    const { url, userName, password } = source;\r\n    try {\r\n      const subLayers: MapSubLayerProps[] = [];\r\n      const capabilities = await WmtsCapabilities.create(url, {\r\n        credentials: (userName && password ? {user: userName, password} : undefined),\r\n        ignoreCache,\r\n        queryParams: source.collectQueryParams(),\r\n        formatId: source.formatId,\r\n      });\r\n      if (!capabilities)\r\n        return { status: MapLayerSourceStatus.InvalidUrl };\r\n\r\n      // Only returns layer that can be published in the Google maps or WGS84 aligned tile trees.\r\n      let supportedTms: WmtsCapability.TileMatrixSet[]  = [];\r\n      const googleMapsTms = capabilities?.contents?.getGoogleMapsCompatibleTileMatrixSet();\r\n      if (googleMapsTms) {\r\n        supportedTms = googleMapsTms;\r\n      }\r\n      const wsg84Tms = capabilities?.contents?.getEpsg4326CompatibleTileMatrixSet();\r\n      if (wsg84Tms) {\r\n        supportedTms = supportedTms.concat(wsg84Tms);\r\n      }\r\n\r\n      if (supportedTms.length === 0) {\r\n        // This WMTS server doesn't support either GoogleMaps or WSG84\r\n        return { status: MapLayerSourceStatus.InvalidCoordinateSystem };\r\n      }\r\n\r\n      let subLayerId = 0;\r\n      capabilities?.contents?.layers.forEach((layer) => {\r\n        const hasSupportedTms = supportedTms?.some((tms) => {\r\n          return layer.tileMatrixSetLinks.some((tmls) => tmls.tileMatrixSet === tms.identifier);\r\n        });\r\n        if (hasSupportedTms) {\r\n          subLayers.push({\r\n            name: layer.identifier,\r\n            title: layer.title ?? layer.identifier,\r\n            visible: (subLayers.length === 0),   // Make the first layer visible.\r\n            parent: undefined,\r\n            children: undefined,\r\n            id: subLayerId++,\r\n          });\r\n        }\r\n      });\r\n\r\n      // Return error if we could find a single compatible layer.\r\n      if (subLayers.length === 0)\r\n        return { status: MapLayerSourceStatus.InvalidTileTree };\r\n\r\n      return { status: MapLayerSourceStatus.Valid, subLayers };\r\n    } catch (err: any) {\r\n      if (err instanceof MapLayerUntrustedOriginError) {\r\n        let blockedOrigin: string | undefined;\r\n        try { blockedOrigin = new URL(err.url).origin; } catch { /* non-hierarchical URL */ }\r\n        return { status: MapLayerSourceStatus.UntrustedOrigin, blockedOrigin };\r\n      }\r\n      let status = MapLayerSourceStatus.InvalidUrl;\r\n      if (err instanceof MapLayerAuthenticationFailedError) {\r\n        status = MapLayerSourceStatus.RequireAuth;\r\n      } else if (err?.status === 401) {\r\n        status = ((userName && password) ? MapLayerSourceStatus.InvalidCredentials : MapLayerSourceStatus.RequireAuth);\r\n      }\r\n      return { status};\r\n    }\r\n  }\r\n\r\n}\r\n\r\nclass ArcGISMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"ArcGIS\";\r\n  public static override async validateSource(url: string, userName?: string, password?: string, ignoreCache?: boolean): Promise<MapLayerSourceValidation> {\r\n    const source =  MapLayerSource.fromJSON({name: \"\", formatId: WmtsMapLayerFormat.formatId, url});\r\n    if (source === undefined)\r\n      return { status: MapLayerSourceStatus.InvalidFormat };\r\n    source.userName = userName;\r\n    source.password = password;\r\n    return WmtsMapLayerFormat.validate({source, ignoreCache});\r\n  }\r\n\r\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\r\n    const urlValidation = ArcGisUtilities.validateUrl(args.source.url, \"MapServer\");\r\n    if (urlValidation !== MapLayerSourceStatus.Valid)\r\n      return {status: urlValidation};\r\n\r\n    // Some Map service supporting only tiles don't include the 'Map' capabilities, thus we can't make it mandatory.\r\n    return ArcGisUtilities.validateSource({...args, capabilitiesFilter: []});\r\n  }\r\n\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new ArcGISMapLayerImageryProvider(settings);\r\n  }\r\n}\r\n\r\n/** @deprecated in 5.11.0 - will not be removed until after 2027-07-03. Bing Maps imagery is deprecated. For basemap imagery providers, see `@itwin/map-layers-formats`. */\r\nclass BingMapsMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"BingMaps\";\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    return new BingMapsImageryLayerProvider(settings);\r\n  }\r\n}\r\n\r\nclass MapBoxImageryMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"MapboxImagery\";\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\r\n    return new MapBoxLayerImageryProvider(settings);\r\n  }\r\n}\r\nclass TileUrlMapLayerFormat extends ImageryMapLayerFormat {\r\n  public static override formatId = \"TileURL\";\r\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined { return new TileUrlImageryProvider(settings); }\r\n}\r\n\r\n/** @internal */\r\n// eslint-disable-next-line @typescript-eslint/no-deprecated -- BingMapsMapLayerFormat is deprecated but must remain registered for legacy persisted styles.\r\nexport const internalMapLayerImageryFormats = [WmsMapLayerFormat, WmtsMapLayerFormat, ArcGISMapLayerFormat, BingMapsMapLayerFormat, MapBoxImageryMapLayerFormat, TileUrlMapLayerFormat];\r\n"]}

package/lib/cjs/tile/map/MapLayerImageryProvider.d.ts

@@ -4,7 +4,7 @@
 import { BeEvent } from "@itwin/core-bentley";
 import { Cartographic, ImageMapLayerSettings, ImageSource } from "@itwin/core-common";
 import { ScreenViewport } from "../../Viewport";
-import { ImageryMapTile, ImageryMapTileTree, MapCartoRectangle, MapFeatureInfoOptions, MapLayerFeatureInfo, MapTilingScheme, QuadId } from "../internal";
+import { ImageryMapTile, ImageryMapTileTree, MapCartoRectangle, MapFeatureInfoOptions, MapLayerAccessClient, MapLayerFeatureInfo, MapTilingScheme, QuadId } from "../internal";
 import { HitDetail } from "../../HitDetail";
 import { DecorateContext } from "../../ViewContext";
 /** Escapes HTML metacharacters so the text renders literally when assigned to `innerHTML`.
@@ -207,8 +207,22 @@ export declare abstract class MapLayerImageryProvider {
      *  @internal
      */
     protected onStatusUpdated(_newStatus: MapLayerImageryProviderStatus): void;
+    /** Transitions to [[MapLayerImageryProviderStatus.RequireAuth]] after a [[MapLayerFetchHandler]] reported an
+     * unrecoverable authentication failure. The user is notified once per transition, and only if tiles had
+     * loaded before: an initialization failure was already reported through source validation.
+     * @internal
+     */
+    protected reportAuthenticationFailure(): void;
     /** @internal */
     protected setRequestAuthorization(headers: Headers): void;
+    /** The access client registered for this layer's format, if any.
+     * @internal
+     */
+    protected get accessClient(): MapLayerAccessClient | undefined;
+    /** True while at least one [[MapLayerFetchHandler]] is registered via [[MapLayerFormatRegistry.addMapLayerFetchHandler]].
+     * @internal
+     */
+    protected get hasFetchHandler(): boolean;
     /** Returns true if the given URL has the same origin as this layer's settings URL.
      * Used to avoid leaking credentials to third-party hosts.
      * @internal
@@ -244,34 +258,32 @@ export declare abstract class MapLayerImageryProvider {
      * @internal
      */
     protected logUntrustedOriginUse(url: string): void;
-    /** The redirect policy to apply to a request that carries browser credentials (see [[includeUserCredentials]]).
-     *
-     * When [[MapLayerFormatRegistry.restrictCredentialsToTrustedOrigins]] is enabled, redirects are refused
-     * outright (`"error"`). `fetch` cannot be asked to follow only same-origin redirects, and by the time a
-     * followed redirect can be inspected the credentials have already been delivered to the destination — so
-     * refusing is the only way to honour the guarantee that credentials reach none but the origins listed in
-     * [[MapLayerFormatRegistry.trustedCredentialsOrigins]]. Legitimate same-origin redirects fail as a result;
-     * that is the cost of the opt-in restriction.
-     *
-     * When the restriction is disabled (the default), redirects are followed as before and
-     * [[checkCredentialedRedirect]] reports the destination after the fact.
-     * @internal
-     */
-    protected get credentialedRedirect(): RequestRedirect | undefined;
     /** Detects that a request carrying browser credentials (see [[includeUserCredentials]]) was transparently
      * redirected to a different origin, and reports or logs that origin.
      *
      * This is a **best-effort, after-the-fact** signal used only while
      * [[MapLayerFormatRegistry.restrictCredentialsToTrustedOrigins]] is disabled, where credentialed requests
-     * still follow redirects (see [[credentialedRedirect]]). It cannot prevent the exposure — the credentials
+     * still follow redirects (see [[credentialedFetchRedirect]]). It cannot prevent the exposure — the credentials
      * have already been sent — and it does not fire at all when the destination denies CORS, because `fetch`
      * then rejects instead of returning a `Response`. The destination origin is never latched as SSO-succeeded,
      * so credentials do not keep flowing to it.
      * @internal
      */
     protected checkCredentialedRedirect(requestedUrl: string, response: Response): void;
+    /** The default send for [[makeRequest]]: legacy redirect policy, NTLM/SSO handling and origin-trust
+     * checks for one request. The SSO retry never applies to sends a fetch handler modified.
+     */
+    private sendDefaultRequest;
     /** @internal */
     makeRequest(url: string, timeoutMs?: number, authorization?: string): Promise<Response>;
+    /** Responses of [[makeRequest]] managed by a fetch handler (see [[MapLayerFetchResult.managedByHandler]]). */
+    private readonly _handlerManagedResponses;
+    /** Returns true if a fetch handler returned this [[makeRequest]] response as its own, in which case the
+     * provider applies none of its default response handling (status-code or protocol-error classification):
+     * the handler reports authentication failures by throwing [[MapLayerAuthenticationFailedError]] instead.
+     * @internal
+     */
+    protected isManagedByHandler(response: Response): boolean;
     /** Returns a map layer tile at the specified settings. */
     loadTile(row: number, column: number, zoomLevel: number): Promise<ImageSource | undefined>;
     /** @internal */

package/lib/cjs/tile/map/MapLayerImageryProvider.d.ts.map

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

package/lib/cjs/tile/map/MapLayerImageryProvider.js

@@ -21,6 +21,7 @@ const utils_1 = require("../../request/utils");
 const tileImageSize = 256, untiledImageSize = 256;
 const earthRadius = 6378137;
 const doDebugToolTips = false;
+const loggerCategory = "MapLayerImageryProvider";
 /** Escapes HTML metacharacters so the text renders literally when assigned to `innerHTML`.
  * Use for any server- or user-supplied string that ends up in the map tooltip, which is rendered
  * as HTML by [[MapLayerTileTreeReference.getToolTip]].
@@ -307,12 +308,37 @@ class MapLayerImageryProvider {
      *  @internal
      */
     onStatusUpdated(_newStatus) { }
+    /** Transitions to [[MapLayerImageryProviderStatus.RequireAuth]] after a [[MapLayerFetchHandler]] reported an
+     * unrecoverable authentication failure. The user is notified once per transition, and only if tiles had
+     * loaded before: an initialization failure was already reported through source validation.
+     * @internal
+     */
+    reportAuthenticationFailure() {
+        const alreadyReported = this._status === MapLayerImageryProviderStatus.RequireAuth;
+        this.setStatus(MapLayerImageryProviderStatus.RequireAuth);
+        if (alreadyReported || !this._hasSuccessfullyFetchedTile)
+            return;
+        const msg = IModelApp_1.IModelApp.localization.getLocalizedString("iModelJs:MapLayers.Messages.LoadTileTokenError", { layerName: this._settings.name });
+        IModelApp_1.IModelApp.notifications.outputMessage(new NotificationManager_1.NotifyMessageDetails(NotificationManager_1.OutputMessagePriority.Warning, msg));
+    }
     /** @internal */
     setRequestAuthorization(headers) {
         if (this._settings.userName && this._settings.password) {
             (0, utils_1.setBasicAuthorization)(headers, this._settings.userName, this._settings.password);
         }
     }
+    /** The access client registered for this layer's format, if any.
+     * @internal
+     */
+    get accessClient() {
+        return IModelApp_1.IModelApp.mapLayerFormatRegistry?.getAccessClient(this._settings.formatId);
+    }
+    /** True while at least one [[MapLayerFetchHandler]] is registered via [[MapLayerFormatRegistry.addMapLayerFetchHandler]].
+     * @internal
+     */
+    get hasFetchHandler() {
+        return (IModelApp_1.IModelApp.mapLayerFormatRegistry?.mapLayerFetchHandlers.length ?? 0) > 0;
+    }
     /** Returns true if the given URL has the same origin as this layer's settings URL.
      * Used to avoid leaking credentials to third-party hosts.
      * @internal
@@ -382,28 +408,12 @@ class MapLayerImageryProvider {
     logUntrustedOriginUse(url) {
         IModelApp_1.IModelApp.mapLayerFormatRegistry.logUntrustedOriginUse(url);
     }
-    /** The redirect policy to apply to a request that carries browser credentials (see [[includeUserCredentials]]).
-     *
-     * When [[MapLayerFormatRegistry.restrictCredentialsToTrustedOrigins]] is enabled, redirects are refused
-     * outright (`"error"`). `fetch` cannot be asked to follow only same-origin redirects, and by the time a
-     * followed redirect can be inspected the credentials have already been delivered to the destination — so
-     * refusing is the only way to honour the guarantee that credentials reach none but the origins listed in
-     * [[MapLayerFormatRegistry.trustedCredentialsOrigins]]. Legitimate same-origin redirects fail as a result;
-     * that is the cost of the opt-in restriction.
-     *
-     * When the restriction is disabled (the default), redirects are followed as before and
-     * [[checkCredentialedRedirect]] reports the destination after the fact.
-     * @internal
-     */
-    get credentialedRedirect() {
-        return IModelApp_1.IModelApp.mapLayerFormatRegistry.restrictCredentialsToTrustedOrigins ? "error" : undefined;
-    }
     /** Detects that a request carrying browser credentials (see [[includeUserCredentials]]) was transparently
      * redirected to a different origin, and reports or logs that origin.
      *
      * This is a **best-effort, after-the-fact** signal used only while
      * [[MapLayerFormatRegistry.restrictCredentialsToTrustedOrigins]] is disabled, where credentialed requests
-     * still follow redirects (see [[credentialedRedirect]]). It cannot prevent the exposure — the credentials
+     * still follow redirects (see [[credentialedFetchRedirect]]). It cannot prevent the exposure — the credentials
      * have already been sent — and it does not fire at all when the destination denies CORS, because `fetch`
      * then rejects instead of returning a `Response`. The destination origin is never latched as SSO-succeeded,
      * so credentials do not keep flowing to it.
@@ -418,46 +428,32 @@ class MapLayerImageryProvider {
         else
             this.logUntrustedOriginUse(response.url); // no-op when the restriction is enabled
     }
-    /** @internal */
-    async makeRequest(url, timeoutMs, authorization) {
-        let response;
-        let headers;
-        let hasCreds = false;
-        // Whether this request had basic-auth credentials of its own to offer. Requests carrying a caller-supplied
-        // `authorization` are excluded: those bypass the origin policy entirely.
-        const hasSettingsCreds = !authorization && !!this._settings.userName && !!this._settings.password;
-        if (authorization) {
-            headers = new Headers();
-            headers.set("Authorization", authorization);
-        }
-        else if (hasSettingsCreds) {
-            if (this.isCredentialsSharingAllowed(url)) {
-                hasCreds = true;
-                headers = new Headers();
-                this.setRequestAuthorization(headers);
-                if (!this.matchesSettingsUrlOrigin(url))
-                    this.logUntrustedOriginUse(url);
-            }
-        }
-        const includeCredentials = this.includeUserCredentials(url);
+    /** The default send for [[makeRequest]]: legacy redirect policy, NTLM/SSO handling and origin-trust
+     * checks for one request. The SSO retry never applies to sends a fetch handler modified.
+     */
+    async sendDefaultRequest(request, credentialed, hasCreds, hasSettingsCreds, timeoutMs) {
+        const requestUrl = request.url;
+        const includeCredentials = this.includeUserCredentials(requestUrl);
         const opts = {
             method: "GET",
-            headers,
+            headers: request.headers,
             credentials: includeCredentials ? "include" : undefined,
-            redirect: includeCredentials ? this.credentialedRedirect : undefined,
+            // Sends the handler modified may carry injected secrets: same redirect policy as credentialed ones.
+            redirect: (includeCredentials || credentialed) ? (0, internal_1.credentialedFetchRedirect)() : undefined,
         };
         if (timeoutMs !== undefined)
             (0, utils_1.setRequestTimeout)(opts, timeoutMs);
-        response = await fetch(url, opts);
-        if (includeCredentials)
-            this.checkCredentialedRedirect(url, response);
+        let rsp = await fetch(requestUrl, opts);
+        if (includeCredentials || credentialed)
+            this.checkCredentialedRedirect(requestUrl, rsp);
         // fetch follows redirects transparently, so all trust decisions below target the final
         // (post-redirect) URL reported by the response, not the URL we asked for.
-        const challengedUrl = response.url || url;
-        if (response.status === 401
-            && (0, utils_1.headersIncludeAuthMethod)(response.headers, ["ntlm", "negotiate"])
+        const challengedUrl = rsp.url || requestUrl;
+        if (rsp.status === 401
+            && (0, utils_1.headersIncludeAuthMethod)(rsp.headers, ["ntlm", "negotiate"])
             && !includeCredentials
-            && !hasCreds) {
+            && !hasCreds
+            && !credentialed) {
             if (this.isSsoAllowed(challengedUrl)) {
                 // Removed the previous headers and make sure "include" credentials is set
                 opts.headers = undefined;
@@ -467,8 +463,8 @@ class MapLayerImageryProvider {
                 opts.redirect = IModelApp_1.IModelApp.mapLayerFormatRegistry.restrictCredentialsToTrustedOrigins ? "error" : undefined;
                 this.logUntrustedOriginUse(challengedUrl);
                 // We got a http 401 challenge, lets try again with SSO enabled (i.e. Windows Authentication)
-                response = await fetch(challengedUrl, opts);
-                if (response.status === 200) {
+                rsp = await fetch(challengedUrl, opts);
+                if (rsp.status === 200) {
                     this.recordSsoSucceeded(challengedUrl); // avoid going through 401 challenges over and over for this origin
                 }
             }
@@ -476,16 +472,69 @@ class MapLayerImageryProvider {
                 this.reportBlockedOrigin(challengedUrl);
             }
         }
-        else if ((response.status === 401 || response.status === 403) && hasSettingsCreds && !this.isCredentialsSharingAllowed(challengedUrl)) {
+        else if ((rsp.status === 401 || rsp.status === 403) && hasSettingsCreds && !credentialed && !this.isCredentialsSharingAllowed(challengedUrl)) {
             // Some servers answer an unauthenticated request with 403 (Forbidden) rather than a 401 challenge;
             // since this request could not present its credentials to the challenging origin, either status most
-            // likely results from that. The permission is recomputed for the challenged URL rather than reusing the
+            // likely results from that (never on a send the handler modified: the handler classifies those).
+            // The permission is recomputed for the challenged URL rather than reusing the
             // decision made for the requested one: `fetch` strips the Authorization header when it follows a
             // cross-origin redirect, so a trusted request can still arrive unauthenticated at an untrusted origin,
             // and conversely a request that started out untrusted may end up at an origin that is trusted.
             this.reportBlockedOrigin(challengedUrl);
         }
-        return response;
+        return rsp;
+    }
+    /** @internal */
+    async makeRequest(url, timeoutMs, authorization) {
+        let headers;
+        let hasCreds = false;
+        // Whether this request had basic-auth credentials of its own to offer. Requests carrying a caller-supplied
+        // `authorization` are excluded: those bypass the origin policy entirely.
+        const hasSettingsCreds = !authorization && !!this._settings.userName && !!this._settings.password;
+        if (authorization) {
+            headers = new Headers();
+            headers.set("Authorization", authorization);
+        }
+        else if (hasSettingsCreds) {
+            if (this.isCredentialsSharingAllowed(url)) {
+                hasCreds = true;
+                headers = new Headers();
+                this.setRequestAuthorization(headers);
+                if (!this.matchesSettingsUrlOrigin(url))
+                    this.logUntrustedOriginUse(url);
+            }
+        }
+        // Route the request through the registered fetch handler (if any), which has full control: it may
+        // send a copy with other query parameters and headers, retry, or short-circuit. Handler failures propagate: the
+        // request must never silently degrade to an unauthenticated one.
+        try {
+            const { response, managedByHandler } = await (0, internal_1.fetchMapLayerRequest)({
+                url,
+                formatId: this._settings.formatId,
+                layerUrl: this._settings.url,
+                layerProperties: this._settings.properties,
+                headers,
+                send: async (request, credentialed) => this.sendDefaultRequest(request, credentialed, hasCreds, hasSettingsCreds, timeoutMs),
+            });
+            if (managedByHandler)
+                this._handlerManagedResponses.add(response);
+            return response;
+        }
+        catch (error) {
+            if (error instanceof internal_1.MapLayerAuthenticationFailedError)
+                this.reportAuthenticationFailure();
+            throw error;
+        }
+    }
+    /** Responses of [[makeRequest]] managed by a fetch handler (see [[MapLayerFetchResult.managedByHandler]]). */
+    _handlerManagedResponses = new WeakSet();
+    /** Returns true if a fetch handler returned this [[makeRequest]] response as its own, in which case the
+     * provider applies none of its default response handling (status-code or protocol-error classification):
+     * the handler reports authentication failures by throwing [[MapLayerAuthenticationFailedError]] instead.
+     * @internal
+     */
+    isManagedByHandler(response) {
+        return this._handlerManagedResponses.has(response);
     }
     /** Returns a map layer tile at the specified settings. */
     async loadTile(row, column, zoomLevel) {
@@ -520,16 +569,39 @@ class MapLayerImageryProvider {
             headers = new Headers();
             this.setRequestAuthorization(headers);
         }
+        let response;
         try {
-            const includeCredentials = this.includeUserCredentials(url);
-            const response = await fetch(url, {
-                method: "GET",
+            ({ response } = await (0, internal_1.fetchMapLayerRequest)({
+                url,
+                formatId: this._settings.formatId,
+                layerUrl: this._settings.url,
+                layerProperties: this._settings.properties,
                 headers,
-                credentials: includeCredentials ? "include" : undefined,
-                redirect: includeCredentials ? this.credentialedRedirect : undefined,
-            });
-            if (includeCredentials)
-                this.checkCredentialedRedirect(url, response);
+                send: async (request, credentialed) => {
+                    const requestUrl = request.url;
+                    const includeCredentials = this.includeUserCredentials(requestUrl);
+                    const rsp = await fetch(requestUrl, {
+                        method: "GET",
+                        headers: request.headers,
+                        credentials: includeCredentials ? "include" : undefined,
+                        redirect: (includeCredentials || credentialed) ? (0, internal_1.credentialedFetchRedirect)() : undefined,
+                    });
+                    if (includeCredentials || credentialed)
+                        this.checkCredentialedRedirect(requestUrl, rsp);
+                    return rsp;
+                },
+            }));
+        }
+        catch (error) {
+            // Never degrade to an unauthenticated request or reject (getToolTip callers do not catch); skip the tooltip.
+            // The status transition the handler asked for still applies.
+            if (error instanceof internal_1.MapLayerAuthenticationFailedError)
+                this.reportAuthenticationFailure();
+            if (this.hasFetchHandler)
+                core_bentley_1.Logger.logWarning(loggerCategory, `Map-layer fetch handler failed for tooltip request: ${core_bentley_1.BentleyError.getErrorMessage(error)}`);
+            return;
+        }
+        try {
             let text = await response.text();
             if (text) {
                 // Tooltip content (e.g. WMS GetFeatureInfo responses) is rendered as HTML downstream and may
@@ -651,11 +723,7 @@ class MapLayerImageryProvider {
      * @internal
      */
     appendCustomParams(url) {
-        if (!this._settings.savedQueryParams && !this._settings.unsavedQueryParams)
-            return url;
-        let tmpUrl = (0, internal_1.appendQueryParams)(url, this._settings.savedQueryParams);
-        tmpUrl = (0, internal_1.appendQueryParams)(tmpUrl, this._settings.unsavedQueryParams);
-        return tmpUrl;
+        return (0, internal_1.appendQueryParams)(url, this._settings.collectQueryParams());
     }
 }
 exports.MapLayerImageryProvider = MapLayerImageryProvider;