@loaders.gl/core 3.4.0-alpha.4 → 3.4.0-alpha.5

package/dist/lib/api/select-loader.js

@@ -7,6 +7,7 @@ const log_1 = require("../utils/log");
 const resource_utils_1 = require("../utils/resource-utils");
 const register_loaders_1 = require("./register-loaders");
 const is_type_1 = require("../../javascript-utils/is-type");
+const url_utils_1 = require("../utils/url-utils");
 const EXT_PATTERN = /\.([^.]+)$/;
 // TODO - Need a variant that peeks at streams for parseInBatches
 // TODO - Detect multiple matching loaders? Use heuristics to grade matches?
@@ -85,8 +86,9 @@ exports.selectLoaderSync = selectLoaderSync;
 /** Implements loaders selection logic */
 // eslint-disable-next-line complexity
 function selectLoaderInternal(data, loaders, options, context) {
-    const { url, type } = (0, resource_utils_1.getResourceUrlAndType)(data);
-    const testUrl = url || context?.url;
+    const url = (0, resource_utils_1.getResourceUrl)(data);
+    const type = (0, resource_utils_1.getResourceMIMEType)(data);
+    const testUrl = (0, url_utils_1.stripQueryString)(url) || context?.url;
     let loader = null;
     let reason = '';
     // if options.mimeType is supplied, it takes precedence
@@ -124,7 +126,8 @@ function validHTTPResponse(data) {
 }
 /** Generate a helpful message to help explain why loader selection failed. */
 function getNoValidLoaderMessage(data) {
-    const { url, type } = (0, resource_utils_1.getResourceUrlAndType)(data);
+    const url = (0, resource_utils_1.getResourceUrl)(data);
+    const type = (0, resource_utils_1.getResourceMIMEType)(data);
     let message = 'No valid loader found (';
     message += url ? `${loader_utils_1.path.filename(url)}, ` : 'no url provided, ';
     message += `MIME type: ${type ? `"${type}"` : 'not provided'}, `;

package/dist/lib/loader-utils/loader-context.d.ts

@@ -8,6 +8,6 @@ import type { Loader, LoaderOptions, LoaderContext } from '@loaders.gl/loader-ut
  * @param options
  * @param previousContext
  */
-export declare function getLoaderContext(context: Omit<LoaderContext, 'fetch'> & Partial<Pick<LoaderContext, 'fetch'>>, options?: LoaderOptions, previousContext?: LoaderContext | null): LoaderContext;
+export declare function getLoaderContext(context: Omit<LoaderContext, 'fetch'> & Partial<Pick<LoaderContext, 'fetch'>>, options: LoaderOptions, parentContext: LoaderContext | null): LoaderContext;
 export declare function getLoadersFromContext(loaders: Loader[] | Loader | undefined, context?: LoaderContext): any;
 //# sourceMappingURL=loader-context.d.ts.map

package/dist/lib/loader-utils/loader-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader-context.d.ts","sourceRoot":"","sources":["../../../src/lib/loader-utils/loader-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAGnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,EAC7E,OAAO,CAAC,EAAE,aAAa,EACvB,eAAe,GAAE,aAAa,GAAG,IAAW,GAC3C,aAAa,CAkBf;AAGD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,EACtC,OAAO,CAAC,EAAE,aAAa,OAkBxB"}
+{"version":3,"file":"loader-context.d.ts","sourceRoot":"","sources":["../../../src/lib/loader-utils/loader-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAKnF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,EAC7E,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,aAAa,GAAG,IAAI,GAClC,aAAa,CA2Bf;AAGD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,EACtC,OAAO,CAAC,EAAE,aAAa,OAkBxB"}

package/dist/lib/loader-utils/loader-context.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLoadersFromContext = exports.getLoaderContext = void 0;
 const get_fetch_function_1 = require("./get-fetch-function");
+const url_utils_1 = require("../utils/url-utils");
+const loader_utils_1 = require("@loaders.gl/loader-utils");
 /**
  * "sub" loaders invoked by other loaders get a "context" injected on `this`
  * The context will inject core methods like `parse` and contain information
@@ -11,21 +13,29 @@ const get_fetch_function_1 = require("./get-fetch-function");
  * @param options
  * @param previousContext
  */
-function getLoaderContext(context, options, previousContext = null) {
+function getLoaderContext(context, options, parentContext) {
     // For recursive calls, we already have a context
     // TODO - add any additional loaders to context?
-    if (previousContext) {
-        return previousContext;
+    if (parentContext) {
+        return parentContext;
     }
-    const resolvedContext = {
+    const newContext = {
         fetch: (0, get_fetch_function_1.getFetchFunction)(options, context),
         ...context
     };
+    // Parse URLs so that subloaders can easily generate correct strings
+    if (newContext.url) {
+        const baseUrl = (0, url_utils_1.stripQueryString)(newContext.url);
+        newContext.baseUrl = baseUrl;
+        newContext.queryString = (0, url_utils_1.extractQueryString)(newContext.url);
+        newContext.filename = loader_utils_1.path.filename(baseUrl);
+        newContext.baseUrl = loader_utils_1.path.dirname(baseUrl);
+    }
     // Recursive loading does not use single loader
-    if (!Array.isArray(resolvedContext.loaders)) {
-        resolvedContext.loaders = null;
+    if (!Array.isArray(newContext.loaders)) {
+        newContext.loaders = null;
     }
-    return resolvedContext;
+    return newContext;
 }
 exports.getLoaderContext = getLoaderContext;
 // eslint-disable-next-line complexity

package/dist/lib/utils/resource-utils.d.ts

@@ -1,15 +1,24 @@
 /**
- * Returns an object with `url` and (MIME) `type` fields
- * If it cannot determine url or type, the corresponding value will be an empty string
+ * A loadable resource. Includes:
+ * `Response`, `Blob` (`File` is a subclass), string URLs and data URLs
+ */
+export type Resource = Response | Blob | string;
+/**
+ * Returns the URL associated with this resource.
+ * The returned value may include a query string and need further processing.
+ * If it cannot determine url, the corresponding value will be an empty string
  *
- * @param resource Any type, but only Responses, string URLs and data URLs are processed
+ * @todo string parameters are assumed to be URLs
+ */
+export declare function getResourceUrl(resource: unknown): string;
+/**
+ * Returns the URL associated with this resource.
+ * The returned value may include a query string and need further processing.
+ * If it cannot determine url, the corresponding value will be an empty string
  *
  * @todo string parameters are assumed to be URLs
  */
-export declare function getResourceUrlAndType(resource: any): {
-    url: string;
-    type: string;
-};
+export declare function getResourceMIMEType(resource: unknown): string;
 /**
   * Returns (approximate) content length for a resource if it can be determined.
   * Returns -1 if content length cannot be determined.
@@ -17,5 +26,5 @@ export declare function getResourceUrlAndType(resource: any): {
 
   * @note string parameters are NOT assumed to be URLs
   */
-export declare function getResourceContentLength(resource: any): number;
+export declare function getResourceContentLength(resource: unknown): number;
 //# sourceMappingURL=resource-utils.d.ts.map

package/dist/lib/utils/resource-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/resource-utils.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,GAAG,GAAG;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAmChF;AAED;;;;;;IAMI;AACJ,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAkB9D"}
+{"version":3,"file":"resource-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/resource-utils.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAqBxD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAqB7D;AAED;;;;;;IAMI;AACJ,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAoBlE"}

package/dist/lib/utils/resource-utils.js

@@ -1,51 +1,64 @@
 "use strict";
+// loaders.gl, MIT license
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getResourceContentLength = exports.getResourceUrlAndType = void 0;
+exports.getResourceContentLength = exports.getResourceMIMEType = exports.getResourceUrl = void 0;
 const is_type_1 = require("../../javascript-utils/is-type");
 const mime_type_utils_1 = require("./mime-type-utils");
-const QUERY_STRING_PATTERN = /\?.*/;
+const url_utils_1 = require("./url-utils");
 /**
- * Returns an object with `url` and (MIME) `type` fields
- * If it cannot determine url or type, the corresponding value will be an empty string
+ * Returns the URL associated with this resource.
+ * The returned value may include a query string and need further processing.
+ * If it cannot determine url, the corresponding value will be an empty string
  *
- * @param resource Any type, but only Responses, string URLs and data URLs are processed
+ * @todo string parameters are assumed to be URLs
+ */
+function getResourceUrl(resource) {
+    // If resource is a `Response`, it contains the information directly as a field
+    if ((0, is_type_1.isResponse)(resource)) {
+        const response = resource;
+        return response.url;
+    }
+    // If the resource is a Blob or a File (subclass of Blob)
+    if ((0, is_type_1.isBlob)(resource)) {
+        const blob = resource;
+        // File objects have a "name" property. Blob objects don't have any
+        // url (name) information
+        return blob.name || '';
+    }
+    if (typeof resource === 'string') {
+        return resource;
+    }
+    // Unknown
+    return '';
+}
+exports.getResourceUrl = getResourceUrl;
+/**
+ * Returns the URL associated with this resource.
+ * The returned value may include a query string and need further processing.
+ * If it cannot determine url, the corresponding value will be an empty string
  *
  * @todo string parameters are assumed to be URLs
  */
-function getResourceUrlAndType(resource) {
+function getResourceMIMEType(resource) {
     // If resource is a response, it contains the information directly
     if ((0, is_type_1.isResponse)(resource)) {
-        const url = stripQueryString(resource.url || '');
-        const contentTypeHeader = resource.headers.get('content-type') || '';
-        return {
-            url,
-            type: (0, mime_type_utils_1.parseMIMEType)(contentTypeHeader) || (0, mime_type_utils_1.parseMIMETypeFromURL)(url)
-        };
+        const response = resource;
+        const contentTypeHeader = response.headers.get('content-type') || '';
+        const noQueryUrl = (0, url_utils_1.stripQueryString)(response.url);
+        return (0, mime_type_utils_1.parseMIMEType)(contentTypeHeader) || (0, mime_type_utils_1.parseMIMETypeFromURL)(noQueryUrl);
     }
     // If the resource is a Blob or a File (subclass of Blob)
     if ((0, is_type_1.isBlob)(resource)) {
-        return {
-            // File objects have a "name" property. Blob objects don't have any
-            // url (name) information
-            url: stripQueryString(resource.name || ''),
-            type: resource.type || ''
-        };
+        const blob = resource;
+        return blob.type || '';
     }
     if (typeof resource === 'string') {
-        return {
-            // TODO this could mess up data URL but it doesn't matter as it is just used for inference
-            url: stripQueryString(resource),
-            // If a data url
-            type: (0, mime_type_utils_1.parseMIMETypeFromURL)(resource)
-        };
+        return (0, mime_type_utils_1.parseMIMETypeFromURL)(resource);
     }
     // Unknown
-    return {
-        url: '',
-        type: ''
-    };
+    return '';
 }
-exports.getResourceUrlAndType = getResourceUrlAndType;
+exports.getResourceMIMEType = getResourceMIMEType;
 /**
   * Returns (approximate) content length for a resource if it can be determined.
   * Returns -1 if content length cannot be determined.
@@ -55,10 +68,12 @@ exports.getResourceUrlAndType = getResourceUrlAndType;
   */
 function getResourceContentLength(resource) {
     if ((0, is_type_1.isResponse)(resource)) {
-        return resource.headers['content-length'] || -1;
+        const response = resource;
+        return response.headers['content-length'] || -1;
     }
     if ((0, is_type_1.isBlob)(resource)) {
-        return resource.size;
+        const blob = resource;
+        return blob.size;
     }
     if (typeof resource === 'string') {
         // TODO - handle data URL?
@@ -73,6 +88,3 @@ function getResourceContentLength(resource) {
     return -1;
 }
 exports.getResourceContentLength = getResourceContentLength;
-function stripQueryString(url) {
-    return url.replace(QUERY_STRING_PATTERN, '');
-}

package/dist/lib/utils/response-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/response-utils.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsCnE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAM1D"}
+{"version":3,"file":"response-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/response-utils.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuCnE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAM1D"}

package/dist/lib/utils/response-utils.js

@@ -21,7 +21,8 @@ async function makeResponse(resource) {
     }
     // `new Response(File)` does not preserve content-type and URL
     // so we add them here
-    const { url, type } = (0, resource_utils_1.getResourceUrlAndType)(resource);
+    const url = (0, resource_utils_1.getResourceUrl)(resource);
+    const type = (0, resource_utils_1.getResourceMIMEType)(resource);
     if (type) {
         headers['content-type'] = type;
     }

package/dist/lib/utils/url-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function extractQueryString(url: any): string;
+export declare function stripQueryString(url: any): string;
+//# sourceMappingURL=url-utils.d.ts.map

package/dist/lib/utils/url-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/url-utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,GAAG,KAAA,GAAG,MAAM,CAG9C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,KAAA,GAAG,MAAM,CAE5C"}

package/dist/lib/utils/url-utils.js

@@ -0,0 +1,14 @@
+"use strict";
+// loaders.gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripQueryString = exports.extractQueryString = void 0;
+const QUERY_STRING_PATTERN = /\?.*/;
+function extractQueryString(url) {
+    const matches = url.match(QUERY_STRING_PATTERN);
+    return matches && matches[0];
+}
+exports.extractQueryString = extractQueryString;
+function stripQueryString(url) {
+    return url.replace(QUERY_STRING_PATTERN, '');
+}
+exports.stripQueryString = stripQueryString;

package/dist/null-worker.js

@@ -184,7 +184,7 @@
   }
 
   // src/null-loader.ts
-  var VERSION = true ? "3.4.0-alpha.4" : "latest";
+  var VERSION = true ? "3.4.0-alpha.5" : "latest";
   function parseSync(arrayBuffer, options, context) {
     if (!options.null.echoParameters)
       return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/core",
-  "version": "3.4.0-alpha.4",
+  "version": "3.4.0-alpha.5",
   "description": "The core API for working with loaders.gl loaders and writers",
   "license": "MIT",
   "publishConfig": {
@@ -42,9 +42,9 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.3.1",
-    "@loaders.gl/loader-utils": "3.4.0-alpha.4",
-    "@loaders.gl/worker-utils": "3.4.0-alpha.4",
+    "@loaders.gl/loader-utils": "3.4.0-alpha.5",
+    "@loaders.gl/worker-utils": "3.4.0-alpha.5",
     "@probe.gl/log": "^4.0.1"
   },
-  "gitHead": "f039a523df8b908a91f26c5ba8c4cfc1924b6140"
+  "gitHead": "686929f85b3420c15df051eab769942b260dd242"
 }

package/src/lib/api/parse-in-batches.ts

@@ -11,7 +11,7 @@ import {isLoaderObject} from '../loader-utils/normalize-loader';
 import {normalizeOptions} from '../loader-utils/option-utils';
 import {getLoaderContext} from '../loader-utils/loader-context';
 import {getAsyncIterableFromData} from '../loader-utils/get-data';
-import {getResourceUrlAndType} from '../utils/resource-utils';
+import {getResourceUrl} from '../utils/resource-utils';
 import {selectLoader} from './select-loader';
 
 // Ensure `parse` is available in context if loader falls back to `parse`
@@ -32,6 +32,8 @@ export async function parseInBatches(
 ): Promise<AsyncIterable<any>> {
   assert(!context || typeof context === 'object'); // parseInBatches no longer accepts final url
 
+  const loaderArray = Array.isArray(loaders) ? loaders : undefined;
+
   // Signature: parseInBatches(data, options, url) - Uses registered loaders
   if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {
     context = undefined; // context not supported in short signature
@@ -43,11 +45,11 @@ export async function parseInBatches(
   options = options || {};
 
   // Extract a url for auto detection
-  const {url} = getResourceUrlAndType(data);
+  const url = getResourceUrl(data);
 
   // Chooses a loader and normalizes it
   // Note - only uses URL and contentType for streams and iterator inputs
-  const loader = await selectLoader(data as ArrayBuffer, loaders as Loader[], options);
+  const loader = await selectLoader(data as ArrayBuffer, loaders as Loader | Loader[], options);
   // Note: if options.nothrow was set, it is possible that no loader was found, if so just return null
   if (!loader) {
     // @ts-ignore
@@ -55,14 +57,11 @@ export async function parseInBatches(
   }
 
   // Normalize options
-  // @ts-ignore
-  options = normalizeOptions(options, loader, loaders, url);
-  // @ts-ignore
+  options = normalizeOptions(options, loader, loaderArray, url);
   context = getLoaderContext(
-    // @ts-ignore
-    {url, parseInBatches, parse, loaders: loaders as Loader[]},
+    {url, parseInBatches, parse, loaders: loaderArray},
     options,
-    context
+    context || null
   );
 
   return await parseWithLoaderInBatches(loader as LoaderWithParser, data, options, context);

package/src/lib/api/parse-sync.ts

@@ -11,7 +11,7 @@ import {isLoaderObject} from '../loader-utils/normalize-loader';
 import {normalizeOptions} from '../loader-utils/option-utils';
 import {getArrayBufferOrStringFromDataSync} from '../loader-utils/get-data';
 import {getLoaderContext, getLoadersFromContext} from '../loader-utils/loader-context';
-import {getResourceUrlAndType} from '../utils/resource-utils';
+import {getResourceUrl} from '../utils/resource-utils';
 
 /**
  * Parses `data` synchronously using a specified loader
@@ -52,12 +52,16 @@ export function parseSync(
   options = normalizeOptions(options, loader, candidateLoaders);
 
   // Extract a url for auto detection
-  const {url} = getResourceUrlAndType(data);
+  const url = getResourceUrl(data);
 
   const parse = () => {
-    throw new Error('parseSync called parse');
+    throw new Error('parseSync called parse (which is async');
   };
-  context = getLoaderContext({url, parseSync, parse, loaders: loaders as Loader[]}, options);
+  context = getLoaderContext(
+    {url, parseSync, parse, loaders: loaders as Loader[]},
+    options,
+    context || null
+  );
 
   return parseWithLoaderSync(loader as LoaderWithParser, data, options, context);
 }

package/src/lib/api/parse.ts

@@ -6,7 +6,7 @@ import {isResponse} from '../../javascript-utils/is-type';
 import {normalizeOptions} from '../loader-utils/option-utils';
 import {getArrayBufferOrStringFromData} from '../loader-utils/get-data';
 import {getLoaderContext, getLoadersFromContext} from '../loader-utils/loader-context';
-import {getResourceUrlAndType} from '../utils/resource-utils';
+import {getResourceUrl} from '../utils/resource-utils';
 import {selectLoader} from './select-loader';
 
 /**
@@ -36,7 +36,7 @@ export async function parse(
   options = options || {};
 
   // Extract a url for auto detection
-  const {url} = getResourceUrlAndType(data);
+  const url = getResourceUrl(data);
 
   // Chooses a loader (and normalizes it)
   // Also use any loaders in the context, new loaders take priority
@@ -53,7 +53,7 @@ export async function parse(
   options = normalizeOptions(options, loader, candidateLoaders, url);
 
   // Get a context (if already present, will be unchanged)
-  context = getLoaderContext({url, parse, loaders: candidateLoaders}, options, context);
+  context = getLoaderContext({url, parse, loaders: candidateLoaders}, options, context || null);
 
   return await parseWithLoader(loader, data, options, context);
 }

package/src/lib/api/select-loader.ts

@@ -2,9 +2,10 @@ import type {LoaderContext, LoaderOptions, Loader} from '@loaders.gl/loader-util
 import {compareArrayBuffers, path} from '@loaders.gl/loader-utils';
 import {normalizeLoader} from '../loader-utils/normalize-loader';
 import {log} from '../utils/log';
-import {getResourceUrlAndType} from '../utils/resource-utils';
+import {getResourceUrl, getResourceMIMEType} from '../utils/resource-utils';
 import {getRegisteredLoaders} from './register-loaders';
 import {isBlob} from '../../javascript-utils/is-type';
+import {stripQueryString} from '../utils/url-utils';
 
 const EXT_PATTERN = /\.([^.]+)$/;
 
@@ -111,9 +112,10 @@ function selectLoaderInternal(
   options?: LoaderOptions,
   context?: LoaderContext
 ) {
-  const {url, type} = getResourceUrlAndType(data);
+  const url = getResourceUrl(data);
+  const type = getResourceMIMEType(data);
 
-  const testUrl = url || context?.url;
+  const testUrl = stripQueryString(url) || context?.url;
 
   let loader: Loader | null = null;
   let reason: string = '';
@@ -161,7 +163,8 @@ function validHTTPResponse(data: any): boolean {
 
 /** Generate a helpful message to help explain why loader selection failed. */
 function getNoValidLoaderMessage(data): string {
-  const {url, type} = getResourceUrlAndType(data);
+  const url = getResourceUrl(data);
+  const type = getResourceMIMEType(data);
 
   let message = 'No valid loader found (';
   message += url ? `${path.filename(url)}, ` : 'no url provided, ';

package/src/lib/loader-utils/loader-context.ts

@@ -1,5 +1,7 @@
 import type {Loader, LoaderOptions, LoaderContext} from '@loaders.gl/loader-utils';
 import {getFetchFunction} from './get-fetch-function';
+import {extractQueryString, stripQueryString} from '../utils/url-utils';
+import {path} from '@loaders.gl/loader-utils';
 
 /**
  * "sub" loaders invoked by other loaders get a "context" injected on `this`
@@ -12,26 +14,35 @@ import {getFetchFunction} from './get-fetch-function';
  */
 export function getLoaderContext(
   context: Omit<LoaderContext, 'fetch'> & Partial<Pick<LoaderContext, 'fetch'>>,
-  options?: LoaderOptions,
-  previousContext: LoaderContext | null = null
+  options: LoaderOptions,
+  parentContext: LoaderContext | null
 ): LoaderContext {
   // For recursive calls, we already have a context
   // TODO - add any additional loaders to context?
-  if (previousContext) {
-    return previousContext;
+  if (parentContext) {
+    return parentContext;
   }
 
-  const resolvedContext: LoaderContext = {
+  const newContext: LoaderContext = {
     fetch: getFetchFunction(options, context),
     ...context
   };
 
+  // Parse URLs so that subloaders can easily generate correct strings
+  if (newContext.url) {
+    const baseUrl = stripQueryString(newContext.url);
+    newContext.baseUrl = baseUrl;
+    newContext.queryString = extractQueryString(newContext.url);
+    newContext.filename = path.filename(baseUrl);
+    newContext.baseUrl = path.dirname(baseUrl);
+  }
+
   // Recursive loading does not use single loader
-  if (!Array.isArray(resolvedContext.loaders)) {
-    resolvedContext.loaders = null;
+  if (!Array.isArray(newContext.loaders)) {
+    newContext.loaders = null;
   }
 
-  return resolvedContext;
+  return newContext;
 }
 
 // eslint-disable-next-line complexity

package/src/lib/utils/resource-utils.ts

@@ -1,51 +1,73 @@
+// loaders.gl, MIT license
+
 import {isResponse, isBlob} from '../../javascript-utils/is-type';
 import {parseMIMEType, parseMIMETypeFromURL} from './mime-type-utils';
+import {stripQueryString} from './url-utils';
 
-const QUERY_STRING_PATTERN = /\?.*/;
+/**
+ * A loadable resource. Includes:
+ * `Response`, `Blob` (`File` is a subclass), string URLs and data URLs
+ */
+export type Resource = Response | Blob | string;
 
 /**
- * Returns an object with `url` and (MIME) `type` fields
- * If it cannot determine url or type, the corresponding value will be an empty string
+ * Returns the URL associated with this resource.
+ * The returned value may include a query string and need further processing.
+ * If it cannot determine url, the corresponding value will be an empty string
  *
- * @param resource Any type, but only Responses, string URLs and data URLs are processed
+ * @todo string parameters are assumed to be URLs
+ */
+export function getResourceUrl(resource: unknown): string {
+  // If resource is a `Response`, it contains the information directly as a field
+  if (isResponse(resource)) {
+    const response = resource as Response;
+    return response.url;
+  }
+
+  // If the resource is a Blob or a File (subclass of Blob)
+  if (isBlob(resource)) {
+    const blob = resource as Blob;
+    // File objects have a "name" property. Blob objects don't have any
+    // url (name) information
+    return blob.name || '';
+  }
+
+  if (typeof resource === 'string') {
+    return resource;
+  }
+
+  // Unknown
+  return '';
+}
+
+/**
+ * Returns the URL associated with this resource.
+ * The returned value may include a query string and need further processing.
+ * If it cannot determine url, the corresponding value will be an empty string
  *
  * @todo string parameters are assumed to be URLs
  */
-export function getResourceUrlAndType(resource: any): {url: string; type: string} {
+export function getResourceMIMEType(resource: unknown): string {
   // If resource is a response, it contains the information directly
   if (isResponse(resource)) {
-    const url = stripQueryString(resource.url || '');
-    const contentTypeHeader = resource.headers.get('content-type') || '';
-    return {
-      url,
-      type: parseMIMEType(contentTypeHeader) || parseMIMETypeFromURL(url)
-    };
+    const response = resource as Response;
+    const contentTypeHeader = response.headers.get('content-type') || '';
+    const noQueryUrl = stripQueryString(response.url);
+    return parseMIMEType(contentTypeHeader) || parseMIMETypeFromURL(noQueryUrl);
   }
 
   // If the resource is a Blob or a File (subclass of Blob)
   if (isBlob(resource)) {
-    return {
-      // File objects have a "name" property. Blob objects don't have any
-      // url (name) information
-      url: stripQueryString(resource.name || ''),
-      type: resource.type || ''
-    };
+    const blob = resource as Blob;
+    return blob.type || '';
   }
 
   if (typeof resource === 'string') {
-    return {
-      // TODO this could mess up data URL but it doesn't matter as it is just used for inference
-      url: stripQueryString(resource),
-      // If a data url
-      type: parseMIMETypeFromURL(resource)
-    };
+    return parseMIMETypeFromURL(resource);
   }
 
   // Unknown
-  return {
-    url: '',
-    type: ''
-  };
+  return '';
 }
 
 /**
@@ -55,12 +77,14 @@ export function getResourceUrlAndType(resource: any): {url: string; type: string
 
   * @note string parameters are NOT assumed to be URLs
   */
-export function getResourceContentLength(resource: any): number {
+export function getResourceContentLength(resource: unknown): number {
   if (isResponse(resource)) {
-    return resource.headers['content-length'] || -1;
+    const response = resource as Response;
+    return response.headers['content-length'] || -1;
   }
   if (isBlob(resource)) {
-    return resource.size;
+    const blob = resource as Blob;
+    return blob.size;
   }
   if (typeof resource === 'string') {
     // TODO - handle data URL?
@@ -74,7 +98,3 @@ export function getResourceContentLength(resource: any): number {
   }
   return -1;
 }
-
-function stripQueryString(url) {
-  return url.replace(QUERY_STRING_PATTERN, '');
-}