@loaders.gl/worker-utils 4.0.0-alpha.9 → 4.0.0-beta.2

package/dist/lib/async-queue/async-queue.js

@@ -1,87 +0,0 @@
-"use strict";
-// From https://github.com/rauschma/async-iter-demo/tree/master/src under MIT license
-// http://2ality.com/2016/10/asynchronous-iteration.html
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Async Queue
- * - AsyncIterable: An async iterator can be
- * - Values can be pushed onto the queue
- * @example
- *   const asyncQueue = new AsyncQueue();
- *   setTimeout(() => asyncQueue.enqueue('tick'), 1000);
- *   setTimeout(() => asyncQueue.enqueue(new Error('done')), 10000);
- *   for await (const value of asyncQueue) {
- *     console.log(value); // tick
- *   }
- */
-class AsyncQueue {
-    constructor() {
-        this._values = []; // enqueues > dequeues
-        this._settlers = []; // dequeues > enqueues
-        this._closed = false;
-    }
-    /** Return an async iterator for this queue */
-    [Symbol.asyncIterator]() {
-        return this;
-    }
-    /** Push a new value - the async iterator will yield a promise resolved to this value */
-    push(value) {
-        return this.enqueue(value);
-    }
-    /**
-     * Push a new value - the async iterator will yield a promise resolved to this value
-     * Add an error - the async iterator will yield a promise rejected with this value
-     */
-    enqueue(value) {
-        if (this._closed) {
-            throw new Error('Closed');
-        }
-        if (this._settlers.length > 0) {
-            if (this._values.length > 0) {
-                throw new Error('Illegal internal state');
-            }
-            const settler = this._settlers.shift();
-            if (value instanceof Error) {
-                settler.reject(value);
-            }
-            else {
-                settler.resolve({ value });
-            }
-        }
-        else {
-            this._values.push(value);
-        }
-    }
-    /** Indicate that we not waiting for more values - The async iterator will be done */
-    close() {
-        while (this._settlers.length > 0) {
-            const settler = this._settlers.shift();
-            settler.resolve({ done: true });
-        }
-        this._closed = true;
-    }
-    // ITERATOR IMPLEMENTATION
-    /** @returns a Promise for an IteratorResult */
-    next() {
-        // If values in queue, yield the first value
-        if (this._values.length > 0) {
-            const value = this._values.shift();
-            if (value instanceof Error) {
-                return Promise.reject(value);
-            }
-            return Promise.resolve({ done: false, value });
-        }
-        // If queue is closed, the iterator is done
-        if (this._closed) {
-            if (this._settlers.length > 0) {
-                throw new Error('Illegal internal state');
-            }
-            return Promise.resolve({ done: true, value: undefined });
-        }
-        // Yield a promise that waits for new values to be enqueued
-        return new Promise((resolve, reject) => {
-            this._settlers.push({ resolve, reject });
-        });
-    }
-}
-exports.default = AsyncQueue;

package/dist/lib/env-utils/assert.js

@@ -1,13 +0,0 @@
-"use strict";
-// Replacement for the external assert method to reduce bundle size
-// Note: We don't use the second "message" argument in calling code,
-// so no need to support it here
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assert = void 0;
-/** Throws an `Error` with the optional `message` if `condition` is falsy */
-function assert(condition, message) {
-    if (!condition) {
-        throw new Error(message || 'loaders.gl assertion failed.');
-    }
-}
-exports.assert = assert;

package/dist/lib/env-utils/globals.js

@@ -1,32 +0,0 @@
-"use strict";
-// Purpose: include this in your module to avoids adding dependencies on
-// micro modules like 'global' and 'is-browser';
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.nodeVersion = exports.isMobile = exports.isWorker = exports.isBrowser = exports.document = exports.global = exports.window = exports.self = void 0;
-/* eslint-disable no-restricted-globals */
-const globals = {
-    self: typeof self !== 'undefined' && self,
-    window: typeof window !== 'undefined' && window,
-    global: typeof global !== 'undefined' && global,
-    document: typeof document !== 'undefined' && document
-};
-const self_ = globals.self || globals.window || globals.global || {};
-exports.self = self_;
-const window_ = globals.window || globals.self || globals.global || {};
-exports.window = window_;
-const global_ = globals.global || globals.self || globals.window || {};
-exports.global = global_;
-const document_ = globals.document || {};
-exports.document = document_;
-/** true if running in the browser, false if running in Node.js */
-exports.isBrowser = 
-// @ts-ignore process.browser
-typeof process !== 'object' || String(process) !== '[object process]' || process.browser;
-/** true if running on a worker thread */
-exports.isWorker = typeof importScripts === 'function';
-/** true if running on a mobile device */
-exports.isMobile = typeof window !== 'undefined' && typeof window.orientation !== 'undefined';
-// Extract node major version
-const matches = typeof process !== 'undefined' && process.version && /v([0-9]*)/.exec(process.version);
-/** Version of Node.js if running under Node, otherwise 0 */
-exports.nodeVersion = (matches && parseFloat(matches[1])) || 0;

package/dist/lib/env-utils/version.js

@@ -1,12 +0,0 @@
-"use strict";
-// Version constant cannot be imported, it needs to correspond to the build version of **this** module.
-// __VERSION__ is injected by babel-plugin-version-inline
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = void 0;
-// Change to `latest` on production branches
-const DEFAULT_VERSION = 'beta';
-exports.VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : DEFAULT_VERSION;
-if (typeof __VERSION__ === 'undefined') {
-    // eslint-disable-next-line
-    console.error('loaders.gl: The __VERSION__ variable is not injected using babel plugin. Latest unstable workers would be fetched from the CDN.');
-}

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

@@ -1,170 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLibraryUrl = exports.loadLibrary = void 0;
-/* global importScripts */
-const globals_1 = require("../env-utils/globals");
-const node = __importStar(require("../node/require-utils.node"));
-const assert_1 = require("../env-utils/assert");
-const version_1 = require("../env-utils/version");
-/**
- * TODO - unpkg.com doesn't seem to have a `latest` specifier for alpha releases...
- * 'beta' on beta branch, 'latest' on prod branch
- */
-const LATEST = 'beta';
-const VERSION = typeof version_1.VERSION !== 'undefined' ? version_1.VERSION : LATEST;
-const loadLibraryPromises = {}; // promises
-/**
- * Dynamically loads a library ("module")
- *
- * - wasm library: Array buffer is returned
- * - js library: Parse JS is returned
- *
- * Method depends on environment
- * - browser - script element is created and installed on document
- * - worker - eval is called on global context
- * - node - file is required
- *
- * @param libraryUrl
- * @param moduleName
- * @param options
- */
-async function loadLibrary(libraryUrl, moduleName = null, options = {}) {
-    if (moduleName) {
-        libraryUrl = getLibraryUrl(libraryUrl, moduleName, options);
-    }
-    // Ensure libraries are only loaded once
-    loadLibraryPromises[libraryUrl] =
-        // eslint-disable-next-line @typescript-eslint/no-misused-promises
-        loadLibraryPromises[libraryUrl] || loadLibraryFromFile(libraryUrl);
-    return await loadLibraryPromises[libraryUrl];
-}
-exports.loadLibrary = loadLibrary;
-// TODO - sort out how to resolve paths for main/worker and dev/prod
-function getLibraryUrl(library, moduleName, options) {
-    // Check if already a URL
-    if (library.startsWith('http')) {
-        return library;
-    }
-    // Allow application to import and supply libraries through `options.modules`
-    const modules = options.modules || {};
-    if (modules[library]) {
-        return modules[library];
-    }
-    // Load from local files, not from CDN scripts in Node.js
-    // TODO - needs to locate the modules directory when installed!
-    if (!globals_1.isBrowser) {
-        return `modules/${moduleName}/dist/libs/${library}`;
-    }
-    // In browser, load from external scripts
-    if (options.CDN) {
-        (0, assert_1.assert)(options.CDN.startsWith('http'));
-        return `${options.CDN}/${moduleName}@${VERSION}/dist/libs/${library}`;
-    }
-    // TODO - loading inside workers requires paths relative to worker script location...
-    if (globals_1.isWorker) {
-        return `../src/libs/${library}`;
-    }
-    return `modules/${moduleName}/src/libs/${library}`;
-}
-exports.getLibraryUrl = getLibraryUrl;
-async function loadLibraryFromFile(libraryUrl) {
-    if (libraryUrl.endsWith('wasm')) {
-        const response = await fetch(libraryUrl);
-        return await response.arrayBuffer();
-    }
-    if (!globals_1.isBrowser) {
-        try {
-            return node && node.requireFromFile && (await node.requireFromFile(libraryUrl));
-        }
-        catch {
-            return null;
-        }
-    }
-    if (globals_1.isWorker) {
-        return importScripts(libraryUrl);
-    }
-    // TODO - fix - should be more secure than string parsing since observes CORS
-    // if (isBrowser) {
-    //   return await loadScriptFromFile(libraryUrl);
-    // }
-    const response = await fetch(libraryUrl);
-    const scriptSource = await response.text();
-    return loadLibraryFromString(scriptSource, libraryUrl);
-}
-/*
-async function loadScriptFromFile(libraryUrl) {
-  const script = document.createElement('script');
-  script.src = libraryUrl;
-  return await new Promise((resolve, reject) => {
-    script.onload = data => {
-      resolve(data);
-    };
-    script.onerror = reject;
-  });
-}
-*/
-// TODO - Needs security audit...
-//  - Raw eval call
-//  - Potentially bypasses CORS
-// Upside is that this separates fetching and parsing
-// we could create a`LibraryLoader` or`ModuleLoader`
-function loadLibraryFromString(scriptSource, id) {
-    if (!globals_1.isBrowser) {
-        return node.requireFromString && node.requireFromString(scriptSource, id);
-    }
-    if (globals_1.isWorker) {
-        // Use lvalue trick to make eval run in global scope
-        eval.call(globals_1.global, scriptSource); // eslint-disable-line no-eval
-        // https://stackoverflow.com/questions/9107240/1-evalthis-vs-evalthis-in-javascript
-        // http://perfectionkills.com/global-eval-what-are-the-options/
-        return null;
-    }
-    const script = document.createElement('script');
-    script.id = id;
-    // most browsers like a separate text node but some throw an error. The second method covers those.
-    try {
-        script.appendChild(document.createTextNode(scriptSource));
-    }
-    catch (e) {
-        script.text = scriptSource;
-    }
-    document.body.appendChild(script);
-    return null;
-}
-// TODO - technique for module injection into worker, from THREE.DracoLoader...
-/*
-function combineWorkerWithLibrary(worker, jsContent) {
-  var fn = wWorker.toString();
-  var body = [
-    '// injected',
-    jsContent,
-    '',
-    '// worker',
-    fn.substring(fn.indexOf('{') + 1, fn.lastIndexOf('}'))
-  ].join('\n');
-  this.workerSourceURL = URL.createObjectURL(new Blob([body]));
-}
-*/

package/dist/lib/node/require-utils.node.js

@@ -1,60 +0,0 @@
-"use strict";
-// Fork of https://github.com/floatdrop/require-from-string/blob/master/index.js
-// Copyright (c) Vsevolod Strukchinsky <floatdrop@gmail.com> (github.com/floatdrop)
-// MIT license
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.requireFromString = exports.requireFromFile = void 0;
-// this file is not visible to webpack (it is excluded in the package.json "browser" field).
-const module_1 = __importDefault(require("module"));
-const path_1 = __importDefault(require("path"));
-// Node.js Dynamically require from file
-// Relative names are resolved relative to cwd
-// This indirect function is provided because webpack will try to bundle `module.require`.
-// this file is not visible to webpack (it is excluded in the package.json "browser" field).
-async function requireFromFile(filename) {
-    if (filename.startsWith('http')) {
-        const response = await fetch(filename);
-        const code = await response.text();
-        return requireFromString(code);
-    }
-    if (!filename.startsWith('/')) {
-        filename = `${process.cwd()}/${filename}`;
-    }
-    return require(filename);
-}
-exports.requireFromFile = requireFromFile;
-// Dynamically require from string
-// - `code` - Required - Type: string - Module code.
-// - `filename` - Type: string - Default: '' - Optional filename.
-// - `options.appendPaths` Type: Array List of paths, that will be appended to module paths.
-// Useful, when you want to be able require modules from these paths.
-// - `options.prependPaths` Type: Array Same as appendPaths, but paths will be prepended.
-function requireFromString(code, filename = '', options) {
-    if (typeof filename === 'object') {
-        options = filename;
-        filename = '';
-    }
-    if (typeof code !== 'string') {
-        throw new Error(`code must be a string, not ${typeof code}`);
-    }
-    // @ts-ignore
-    const paths = module_1.default._nodeModulePaths(path_1.default.dirname(filename));
-    const parent = module.parent;
-    // @ts-ignore
-    const newModule = new module_1.default(filename, parent);
-    newModule.filename = filename;
-    newModule.paths = []
-        .concat(options?.prependPaths || [])
-        .concat(paths)
-        .concat(options?.appendPaths || []);
-    // @ts-ignore
-    newModule._compile(code, filename);
-    if (parent && parent.children) {
-        parent.children.splice(parent.children.indexOf(newModule), 1);
-    }
-    return newModule.exports;
-}
-exports.requireFromString = requireFromString;

package/dist/lib/node/worker_threads-browser.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parentPort = exports.NodeWorkerType = exports.NodeWorker = exports.Worker = void 0;
-// Browser fills for Node.js built-in `worker_threads` module.
-// These fills are non-functional, and just intended to ensure that
-// `import 'worker_threads` doesn't break browser builds.
-// The replacement is done in package.json browser field
-class Worker {
-    // eslint-disable-next-line @typescript-eslint/no-empty-function
-    terminate() { }
-}
-exports.Worker = Worker;
-exports.NodeWorker = Worker;
-exports.NodeWorkerType = Worker;
-exports.parentPort = null;

package/dist/lib/node/worker_threads.js

@@ -1,33 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeWorker = void 0;
-const WorkerThreads = __importStar(require("worker_threads"));
-__exportStar(require("worker_threads"), exports);
-exports.NodeWorker = WorkerThreads.Worker;

package/dist/lib/process-utils/child-process-proxy.js

@@ -1,136 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable no-console */
-// Avoid using named imports for Node builtins to help with "empty" resolution
-// for bundlers targeting browser environments. Access imports & types
-// through the `ChildProcess` object (e.g. `ChildProcess.spawn`, `ChildProcess.ChildProcess`).
-const ChildProcess = __importStar(require("child_process"));
-const process_utils_1 = require("./process-utils");
-const DEFAULT_PROPS = {
-    command: '',
-    arguments: [],
-    port: 5000,
-    autoPort: true,
-    wait: 2000,
-    onSuccess: (processProxy) => {
-        console.log(`Started ${processProxy.props.command}`);
-    }
-};
-/**
- * Manager for a Node.js child process
- * Prepares arguments, starts, stops and tracks output
- */
-class ChildProcessProxy {
-    // constructor(props?: {id?: string});
-    constructor({ id = 'browser-driver' } = {}) {
-        this.props = { ...DEFAULT_PROPS };
-        this.childProcess = null;
-        this.port = 0;
-        this.id = id;
-    }
-    /** Starts a child process with the provided props */
-    async start(props) {
-        props = { ...DEFAULT_PROPS, ...props };
-        this.props = props;
-        const args = [...props.arguments];
-        // If portArg is set, we can look up an available port
-        this.port = Number(props.port);
-        if (props.portArg) {
-            if (props.autoPort) {
-                this.port = await (0, process_utils_1.getAvailablePort)(props.port);
-            }
-            args.push(props.portArg, String(this.port));
-        }
-        return await new Promise((resolve, reject) => {
-            try {
-                this._setTimeout(() => {
-                    if (props.onSuccess) {
-                        props.onSuccess(this);
-                    }
-                    resolve({});
-                });
-                console.log(`Spawning ${props.command} ${props.arguments.join(' ')}`);
-                const childProcess = ChildProcess.spawn(props.command, args, props.spawn);
-                this.childProcess = childProcess;
-                childProcess.stdout.on('data', (data) => {
-                    console.log(data.toString());
-                });
-                childProcess.stderr.on('data', (data) => {
-                    console.log(`Child process wrote to stderr: "${data}".`);
-                    if (!props.ignoreStderr) {
-                        this._clearTimeout();
-                        reject(new Error(data));
-                    }
-                });
-                childProcess.on('error', (error) => {
-                    console.log(`Child process errored with ${error}`);
-                    this._clearTimeout();
-                    reject(error);
-                });
-                childProcess.on('close', (code) => {
-                    console.log(`Child process exited with ${code}`);
-                    this.childProcess = null;
-                    this._clearTimeout();
-                    resolve({});
-                });
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
-    }
-    /** Stops a running child process */
-    async stop() {
-        if (this.childProcess) {
-            this.childProcess.kill();
-            this.childProcess = null;
-        }
-    }
-    /** Exits this process */
-    async exit(statusCode = 0) {
-        try {
-            await this.stop();
-            // eslint-disable-next-line no-process-exit
-            process.exit(statusCode);
-        }
-        catch (error) {
-            console.error(error.message || error);
-            // eslint-disable-next-line no-process-exit
-            process.exit(1);
-        }
-    }
-    _setTimeout(callback) {
-        if (Number(this.props.wait) > 0) {
-            this.successTimer = setTimeout(callback, this.props.wait);
-        }
-    }
-    _clearTimeout() {
-        if (this.successTimer) {
-            clearTimeout(this.successTimer);
-        }
-    }
-}
-exports.default = ChildProcessProxy;

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

@@ -1,35 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAvailablePort = void 0;
-const child_process_1 = __importDefault(require("child_process"));
-// Get an available port
-// Works on Unix systems
-function getAvailablePort(defaultPort = 3000) {
-    return new Promise((resolve) => {
-        // Get a list of all ports in use
-        child_process_1.default.exec('lsof -i -P -n | grep LISTEN', (error, stdout) => {
-            if (error) {
-                // likely no permission, e.g. CI
-                resolve(defaultPort);
-                return;
-            }
-            const portsInUse = [];
-            const regex = /:(\d+) \(LISTEN\)/;
-            stdout.split('\n').forEach((line) => {
-                const match = regex.exec(line);
-                if (match) {
-                    portsInUse.push(Number(match[1]));
-                }
-            });
-            let port = defaultPort;
-            while (portsInUse.includes(port)) {
-                port++;
-            }
-            resolve(port);
-        });
-    });
-}
-exports.getAvailablePort = getAvailablePort;