@loaders.gl/wms 3.3.0-alpha.12 → 3.3.0-alpha.14

package/dist/lib/data-sources/arcgis-image-service.d.ts

@@ -0,0 +1,79 @@
+import { LoaderOptions } from '@loaders.gl/loader-utils';
+import { /* ImageLoader, */ ImageType } from '@loaders.gl/images';
+import type { ImageSourceMetadata, GetImageParameters } from './image-source';
+import { ImageSource } from './image-source';
+type FetchLike = (url: string, options?: RequestInit) => Promise<Response>;
+export type ArcGISImageServiceProps = {
+    url: string;
+    loadOptions?: LoaderOptions;
+    fetch?: typeof fetch | FetchLike;
+};
+export declare class ArcGISImageService extends ImageSource {
+    static type: 'arcgis-image-server';
+    static testURL: (url: string) => boolean;
+    url: string;
+    loadOptions: LoaderOptions;
+    fetch: typeof fetch | FetchLike;
+    constructor(props: ArcGISImageServiceProps);
+    getMetadata(): Promise<ImageSourceMetadata>;
+    getImage(parameters: GetImageParameters): Promise<ImageType>;
+    info(): Promise<unknown>;
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImage(options: {
+        boundingBox: [number, number, number, number];
+        boundingBoxSR?: string;
+        width: number;
+        height: number;
+        imageSR?: string;
+        time?: never;
+        format?: 'jpgpng';
+        pixelType?: 'U8';
+        noData?: never;
+        noDataInterpretation?: 'esriNoDataMatchAny';
+        interpolation?: '+RSP_NearestNeighbor';
+        compression?: never;
+        compressionQuality?: never;
+        bandIds?: never;
+        mosaicRule?: never;
+        renderingRule?: never;
+        f?: 'image';
+    }): Promise<ImageType>;
+    infoURL(options: {
+        parameters?: Record<string, unknown>;
+    }): string;
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImageURL(options: {
+        boundingBox: [number, number, number, number];
+        boundingBoxSR?: string;
+        width: number;
+        height: number;
+        imageSR?: string;
+        time?: never;
+        format?: 'jpgpng';
+        pixelType?: 'U8';
+        noData?: never;
+        noDataInterpretation?: 'esriNoDataMatchAny';
+        interpolation?: '+RSP_NearestNeighbor';
+        compression?: never;
+        compressionQuality?: never;
+        bandIds?: never;
+        mosaicRule?: never;
+        renderingRule?: never;
+        f?: 'image';
+    }): string;
+    /**
+     * @note protected, since perhaps getWMSUrl may need to be overridden to handle certain backends?
+     * @note if override is common, maybe add a callback prop?
+     * */
+    protected getUrl(options: Record<string, unknown>, extra?: Record<string, unknown>): string;
+    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
+    protected checkResponse(response: Response): Promise<void>;
+}
+export {};
+//# sourceMappingURL=arcgis-image-service.d.ts.map

package/dist/lib/data-sources/arcgis-image-service.d.ts.map

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

package/dist/lib/data-sources/arcgis-image-service.js

@@ -0,0 +1,85 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcGISImageService = void 0;
+const image_source_1 = require("./image-source");
+class ArcGISImageService extends image_source_1.ImageSource {
+    constructor(props) {
+        super();
+        this.url = props.url;
+        this.loadOptions = props.loadOptions || {};
+        this.fetch = props.fetch || fetch;
+    }
+    // ImageSource (normalized endpoints)
+    async getMetadata() {
+        return (await this.info());
+        // TODO - normalize metadata
+    }
+    async getImage(parameters) {
+        throw new Error('not implemented');
+        // TODO - Map generic parameters to ArcGIS specific parameters
+        // return await this.exportImage(parameters);
+    }
+    // ImageServer endpoints
+    async info() {
+        // We just need a JSON parsing...
+        // return this.getUrl({path: '', ...options});
+        throw new Error('not implemented');
+    }
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImage(options) {
+        // See WMSService.getMap()
+        throw new Error('not implemented');
+    }
+    // URL creators
+    infoURL(options) {
+        return this.url;
+        // return this.getUrl({path: '', ...options});
+    }
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImageURL(options) {
+        // const {boundingBox} = options;
+        // const bbox = `bbox=${boundingBox[0]},${boundingBox[1]},${boundingBox[2]},${boundingBox[3]}`;
+        // const size = `size=${width},${height}`;
+        // return this.getUrl({path: 'exportImage'});
+        return this.url;
+    }
+    // INTERNAL METHODS
+    /**
+     * @note protected, since perhaps getWMSUrl may need to be overridden to handle certain backends?
+     * @note if override is common, maybe add a callback prop?
+     * */
+    getUrl(options, extra) {
+        let url = `${this.url}`;
+        let first = true;
+        for (const [key, value] of Object.entries(options)) {
+            url += first ? '?' : '&';
+            first = false;
+            if (Array.isArray(value)) {
+                url += `${key.toUpperCase()}=${value.join(',')}`;
+            }
+            else {
+                url += `${key.toUpperCase()}=${value ? String(value) : ''}`;
+            }
+        }
+        return url;
+    }
+    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
+    async checkResponse(response) {
+        if (!response.ok) {
+            // } || response.headers['content-type'] === WMSErrorLoader.mimeTypes[0]) {
+            // const arrayBuffer = await response.arrayBuffer();
+            // const error = await WMSErrorLoader.parse(arrayBuffer, this.loadOptions);
+            throw new Error('error');
+        }
+    }
+}
+exports.ArcGISImageService = ArcGISImageService;
+ArcGISImageService.type = 'arcgis-image-server';
+ArcGISImageService.testURL = (url) => url.toLowerCase().includes('ImageServer');

package/dist/lib/data-sources/create-image-source.d.ts

@@ -0,0 +1,16 @@
+import { ImageSource } from './image-source';
+import { ImageServiceProps } from './image-services/image-service';
+export type ImageServiceType = 'wms' | 'arcgis-image-server' | 'template';
+type Props = ImageServiceProps & {
+    type?: ImageServiceType | 'auto';
+};
+/**
+ * Creates an image source
+ * If type is not supplied, will try to automatically detec the the
+ * @param url URL to the image source
+ * @param type type of source. if not known, set to 'auto'
+ * @returns an ImageSource instance
+ */
+export declare function createImageSource(props: Props): ImageSource;
+export {};
+//# sourceMappingURL=create-image-source.d.ts.map

package/dist/lib/data-sources/create-image-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image-source.d.ts","sourceRoot":"","sources":["../../../src/lib/data-sources/create-image-source.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAe,iBAAiB,EAAC,MAAM,gCAAgC,CAAC;AAI/E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,qBAAqB,GAAG,UAAU,CAAC;AAI1E,KAAK,KAAK,GAAG,iBAAiB,GAAG;IAC/B,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAY3D"}

package/dist/lib/data-sources/create-image-source.js

@@ -0,0 +1,39 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createImageSource = void 0;
+const image_service_1 = require("./image-services/image-service");
+const wms_service_1 = require("./image-services/wms-service");
+const arcgis_image_service_1 = require("./image-services/arcgis-image-service");
+const SERVICES = [wms_service_1.WMSService, arcgis_image_service_1.ArcGISImageService, image_service_1.ImageService];
+/**
+ * Creates an image source
+ * If type is not supplied, will try to automatically detec the the
+ * @param url URL to the image source
+ * @param type type of source. if not known, set to 'auto'
+ * @returns an ImageSource instance
+ */
+function createImageSource(props) {
+    const { type = 'auto' } = props;
+    const serviceType = type === 'auto' ? guessServiceType(props.url) : type;
+    switch (serviceType) {
+        case 'template':
+            return new image_service_1.ImageService(props);
+        case 'wms':
+            return new wms_service_1.WMSService(props);
+        default:
+            // currently only wms service supported
+            throw new Error('Not a valid image source type');
+    }
+}
+exports.createImageSource = createImageSource;
+/** Guess service type from URL */
+function guessServiceType(url) {
+    for (const Service of SERVICES) {
+        if (Service.testURL && Service.testURL(url)) {
+            return Service.type;
+        }
+    }
+    // If all else fails, guess that this is MS service
+    return 'wms';
+}

package/dist/lib/data-sources/image-services/arcgis-image-service.d.ts

@@ -0,0 +1,71 @@
+import { ImageType } from '@loaders.gl/images';
+import type { ImageSourceMetadata, GetImageParameters } from '../image-source';
+import { ImageSource } from '../image-source';
+import { ImageServiceProps } from './image-service';
+export declare class ArcGISImageService extends ImageSource {
+    static type: 'arcgis-image-server';
+    static testURL: (url: string) => boolean;
+    props: Required<ImageServiceProps>;
+    fetch: (url: string, options?: RequestInit) => Promise<Response>;
+    constructor(props: ImageServiceProps);
+    getMetadata(): Promise<ImageSourceMetadata>;
+    getImage(parameters: GetImageParameters): Promise<ImageType>;
+    info(): Promise<unknown>;
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImage(options: {
+        boundingBox: [number, number, number, number];
+        boundingBoxSR?: string;
+        width: number;
+        height: number;
+        imageSR?: string;
+        time?: never;
+        format?: 'jpgpng';
+        pixelType?: 'U8';
+        noData?: never;
+        noDataInterpretation?: 'esriNoDataMatchAny';
+        interpolation?: '+RSP_NearestNeighbor';
+        compression?: never;
+        compressionQuality?: never;
+        bandIds?: never;
+        mosaicRule?: never;
+        renderingRule?: never;
+        f?: 'image';
+    }): Promise<ImageType>;
+    infoURL(options: {
+        parameters?: Record<string, unknown>;
+    }): string;
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImageURL(options: {
+        boundingBox: [number, number, number, number];
+        boundingBoxSR?: string;
+        width: number;
+        height: number;
+        imageSR?: string;
+        time?: never;
+        format?: 'jpgpng';
+        pixelType?: 'U8';
+        noData?: never;
+        noDataInterpretation?: 'esriNoDataMatchAny';
+        interpolation?: '+RSP_NearestNeighbor';
+        compression?: never;
+        compressionQuality?: never;
+        bandIds?: never;
+        mosaicRule?: never;
+        renderingRule?: never;
+        f?: 'image';
+    }): string;
+    /**
+     * @note protected, since perhaps getWMSUrl may need to be overridden to handle certain backends?
+     * @note if override is common, maybe add a callback prop?
+     * */
+    protected getUrl(options: Record<string, unknown>, extra?: Record<string, unknown>): string;
+    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
+    protected checkResponse(response: Response): Promise<void>;
+}
+//# sourceMappingURL=arcgis-image-service.d.ts.map

package/dist/lib/data-sources/image-services/arcgis-image-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-image-service.d.ts","sourceRoot":"","sources":["../../../../src/lib/data-sources/image-services/arcgis-image-service.ts"],"names":[],"mappings":"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"}

package/dist/lib/data-sources/image-services/arcgis-image-service.js

@@ -0,0 +1,85 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcGISImageService = void 0;
+const image_source_1 = require("../image-source");
+const image_service_1 = require("./image-service");
+class ArcGISImageService extends image_source_1.ImageSource {
+    constructor(props) {
+        super();
+        this.props = (0, image_service_1.mergeImageServiceProps)(props);
+        this.fetch = (0, image_service_1.getFetchFunction)(this.props);
+    }
+    // ImageSource (normalized endpoints)
+    async getMetadata() {
+        return (await this.info());
+        // TODO - normalize metadata
+    }
+    async getImage(parameters) {
+        throw new Error('not implemented');
+        // TODO - Map generic parameters to ArcGIS specific parameters
+        // return await this.exportImage(parameters);
+    }
+    // ImageServer endpoints
+    async info() {
+        // We just need a JSON parsing...
+        // return this.getUrl({path: '', ...options});
+        throw new Error('not implemented');
+    }
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImage(options) {
+        // See WMSService.getMap()
+        throw new Error('not implemented');
+    }
+    // URL creators
+    infoURL(options) {
+        return this.props.url;
+        // return this.getUrl({path: '', ...options});
+    }
+    /**
+     * Form a URL to an ESRI ImageServer
+     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+     */
+    exportImageURL(options) {
+        // const {boundingBox} = options;
+        // const bbox = `bbox=${boundingBox[0]},${boundingBox[1]},${boundingBox[2]},${boundingBox[3]}`;
+        // const size = `size=${width},${height}`;
+        // return this.getUrl({path: 'exportImage'});
+        return this.props.url;
+    }
+    // INTERNAL METHODS
+    /**
+     * @note protected, since perhaps getWMSUrl may need to be overridden to handle certain backends?
+     * @note if override is common, maybe add a callback prop?
+     * */
+    getUrl(options, extra) {
+        let url = `${this.props.url}`;
+        let first = true;
+        for (const [key, value] of Object.entries(options)) {
+            url += first ? '?' : '&';
+            first = false;
+            if (Array.isArray(value)) {
+                url += `${key.toUpperCase()}=${value.join(',')}`;
+            }
+            else {
+                url += `${key.toUpperCase()}=${value ? String(value) : ''}`;
+            }
+        }
+        return url;
+    }
+    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
+    async checkResponse(response) {
+        if (!response.ok) {
+            // } || response.headers['content-type'] === WMSErrorLoader.mimeTypes[0]) {
+            // const arrayBuffer = await response.arrayBuffer();
+            // const error = await WMSErrorLoader.parse(arrayBuffer, this.loadOptions);
+            throw new Error('error');
+        }
+    }
+}
+exports.ArcGISImageService = ArcGISImageService;
+ArcGISImageService.type = 'arcgis-image-server';
+ArcGISImageService.testURL = (url) => url.toLowerCase().includes('ImageServer');

package/dist/lib/data-sources/image-services/image-service.d.ts

@@ -0,0 +1,39 @@
+import { LoaderOptions } from '@loaders.gl/loader-utils';
+import type { ImageType } from '@loaders.gl/images';
+import type { ImageSourceMetadata, GetImageParameters } from '../image-source';
+import { ImageSource } from '../image-source';
+/** Template URL string should contain `${width}` etc which will be substituted. */
+export type ImageServiceProps = {
+    /** Base URL to the service */
+    url: string;
+    /** Any load options to the loaders.gl Loaders used by the WMSService methods */
+    loadOptions?: LoaderOptions;
+};
+/**
+ * Quickly connect to "ad hoc" image sources without subclassing ImageSource.
+ * ImageSource allows template url strings to be used to ad hoc connect to arbitrary image data sources
+ * Accepts a template url string and builds requests URLs
+ */
+export declare class ImageService extends ImageSource {
+    static type: 'template';
+    static testURL: (url: string) => boolean;
+    props: Required<ImageServiceProps>;
+    fetch: (url: string, options?: RequestInit) => Promise<Response>;
+    constructor(props: ImageServiceProps);
+    getMetadata(): Promise<ImageSourceMetadata>;
+    getImage(parameters: GetImageParameters): Promise<ImageType>;
+    /** Break up bounding box in east, north, south, west */
+    protected getGranularParameters(parameters: GetImageParameters): Record<string, unknown>;
+    /** Supports both ${} and {} notations */
+    protected getURLFromTemplate(parameters: Record<string, unknown>): string;
+}
+/**
+ * Gets the current fetch function from options
+ * @todo - move to loader-utils module
+ * @todo - use in core module counterpart
+ * @param options
+ * @param context
+ */
+export declare function getFetchFunction(options?: LoaderOptions): (url: string, fetchOptions?: RequestInit) => Promise<Response>;
+export declare function mergeImageServiceProps(props: ImageServiceProps): Required<ImageServiceProps>;
+//# sourceMappingURL=image-service.d.ts.map

package/dist/lib/data-sources/image-services/image-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-service.d.ts","sourceRoot":"","sources":["../../../../src/lib/data-sources/image-services/image-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAGlD,OAAO,KAAK,EAAC,mBAAmB,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAE5C,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,MAAM,CAAC,IAAI,EAAE,UAAU,CAAc;IACrC,MAAM,CAAC,OAAO,QAAS,MAAM,KAAG,OAAO,CAAoC;IAE3E,KAAK,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAErD,KAAK,EAAE,iBAAiB;IAQ9B,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI3C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAUlE,wDAAwD;IACxD,SAAS,CAAC,qBAAqB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKxF,yCAAyC;IACzC,SAAS,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAU1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,aAAa,SAKvC,MAAM,iBAAiB,WAAW,uBAWlD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAS5F"}

package/dist/lib/data-sources/image-services/image-service.js

@@ -0,0 +1,82 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeImageServiceProps = exports.getFetchFunction = exports.ImageService = void 0;
+const images_1 = require("@loaders.gl/images");
+const image_source_1 = require("../image-source");
+/**
+ * Quickly connect to "ad hoc" image sources without subclassing ImageSource.
+ * ImageSource allows template url strings to be used to ad hoc connect to arbitrary image data sources
+ * Accepts a template url string and builds requests URLs
+ */
+class ImageService extends image_source_1.ImageSource {
+    constructor(props) {
+        super();
+        this.props = mergeImageServiceProps(props);
+        this.fetch = getFetchFunction(props);
+    }
+    // IMAGE SOURCE API
+    async getMetadata() {
+        throw new Error('ImageSource.getMetadata not implemented');
+    }
+    async getImage(parameters) {
+        const granularParameters = this.getGranularParameters(parameters);
+        const url = this.getURLFromTemplate(granularParameters);
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        return await images_1.ImageLoader.parse(arrayBuffer);
+    }
+    // HELPERS
+    /** Break up bounding box in east, north, south, west */
+    getGranularParameters(parameters) {
+        const [east, north, west, south] = parameters.bbox;
+        return { ...parameters, east, north, south, west };
+    }
+    /** Supports both ${} and {} notations */
+    getURLFromTemplate(parameters) {
+        let url = this.props.url;
+        for (const [key, value] of Object.entries(parameters)) {
+            // TODO - parameter could be repeated
+            // const regex = new RegExp(`\${${key}}`, 'g');
+            url = url.replace(`\${${key}}`, String(value));
+            url = url.replace(`{${key}}`, String(value));
+        }
+        return url;
+    }
+}
+exports.ImageService = ImageService;
+ImageService.type = 'template';
+ImageService.testURL = (url) => url.toLowerCase().includes('{');
+/**
+ * Gets the current fetch function from options
+ * @todo - move to loader-utils module
+ * @todo - use in core module counterpart
+ * @param options
+ * @param context
+ */
+function getFetchFunction(options) {
+    const fetchFunction = options?.fetch;
+    // options.fetch can be a function
+    if (fetchFunction && typeof fetchFunction === 'function') {
+        return (url, fetchOptions) => fetchFunction(url, fetchOptions);
+    }
+    // options.fetch can be an options object, use global fetch with those options
+    const fetchOptions = options?.fetch;
+    if (fetchOptions && typeof fetchOptions !== 'function') {
+        return (url) => fetch(url, fetchOptions);
+    }
+    // else return the global fetch function
+    return (url) => fetch(url);
+}
+exports.getFetchFunction = getFetchFunction;
+function mergeImageServiceProps(props) {
+    return {
+        // Default fetch
+        ...props,
+        loadOptions: {
+            ...props.loadOptions,
+            fetch: getFetchFunction(props.loadOptions)
+        }
+    };
+}
+exports.mergeImageServiceProps = mergeImageServiceProps;