/** * Copyright (c) Facebook, Inc. and its affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. * * @flow * @format */ 'use strict'; const IncrementalBundler = require('./IncrementalBundler'); const MultipartResponse = require('./Server/MultipartResponse'); const ResourceNotFoundError = require('./IncrementalBundler/ResourceNotFoundError'); const baseJSBundle = require('./DeltaBundler/Serializers/baseJSBundle'); const bundleToString = require('./lib/bundleToString'); const {codeFrameColumns} = require('@babel/code-frame'); const debug = require('debug')('Metro:Server'); const formatBundlingError = require('./lib/formatBundlingError'); const fs = require('graceful-fs'); const getAllFiles = require('./DeltaBundler/Serializers/getAllFiles'); const getAssets = require('./DeltaBundler/Serializers/getAssets'); const getGraphId = require('./lib/getGraphId'); const getRamBundleInfo = require('./DeltaBundler/Serializers/getRamBundleInfo'); const mime = require('mime-types'); const parseOptionsFromUrl = require('./lib/parseOptionsFromUrl'); const parsePlatformFilePath = require('./node-haste/lib/parsePlatformFilePath'); const path = require('path'); const sourceMapString = require('./DeltaBundler/Serializers/sourceMapString'); const splitBundleOptions = require('./lib/splitBundleOptions'); const symbolicate = require('./Server/symbolicate'); const transformHelpers = require('./lib/transformHelpers'); const url = require('url'); const {getAsset} = require('./Assets'); const { getExplodedSourceMap, } = require('./DeltaBundler/Serializers/getExplodedSourceMap'); const { Logger, Logger: {createActionStartEntry, createActionEndEntry, log}, } = require('metro-core'); import type {AssetData} from './Assets'; import type {ExplodedSourceMap} from './DeltaBundler/Serializers/getExplodedSourceMap'; import type {RamBundleInfo} from './DeltaBundler/Serializers/getRamBundleInfo'; import type {Graph, Module} from './DeltaBundler/types.flow'; import type {MixedOutput, TransformResult} from './DeltaBundler/types.flow'; import type {RevisionId} from './IncrementalBundler'; import type {GraphId} from './lib/getGraphId'; import type {Reporter} from './lib/reporting'; import type { BundleOptions, GraphOptions, SplitBundleOptions, } from './shared/types.flow'; import type {IncomingMessage, ServerResponse} from 'http'; import type {CacheStore} from 'metro-cache'; import type {ConfigT} from 'metro-config/src/configTypes.flow'; import type { ActionLogEntryData, ActionStartLogEntry, LogEntry, } from 'metro-core/src/Logger'; export type SegmentLoadData = {[number]: [Array, ?number], ...}; export type BundleMetadata = { hash: string, otaBuildNumber: ?string, mobileConfigs: Array, segmentHashes: Array, segmentLoadData: SegmentLoadData, ... }; type ProcessStartContext = {| +buildID: string, +bundleOptions: BundleOptions, +graphId: GraphId, +graphOptions: GraphOptions, +mres: MultipartResponse, +req: IncomingMessage, +revisionId?: ?RevisionId, ...SplitBundleOptions, |}; type ProcessEndContext = {| ...ProcessStartContext, +result: T, |}; export type ServerOptions = $ReadOnly<{| watch?: boolean, |}>; const DELTA_ID_HEADER = 'X-Metro-Delta-ID'; const FILES_CHANGED_COUNT_HEADER = 'X-Metro-Files-Changed-Count'; class Server { _config: ConfigT; _createModuleId: (path: string) => number; _reporter: Reporter; _logger: typeof Logger; _platforms: Set; _nextBundleBuildID: number; _bundler: IncrementalBundler; _isEnded: boolean; constructor(config: ConfigT, options?: ServerOptions) { this._config = config; if (this._config.resetCache) { this._config.cacheStores.forEach((store: CacheStore>) => store.clear(), ); this._config.reporter.update({type: 'transform_cache_reset'}); } this._reporter = config.reporter; this._logger = Logger; this._platforms = new Set(this._config.resolver.platforms); this._isEnded = false; // TODO(T34760917): These two properties should eventually be instantiated // elsewhere and passed as parameters, since they are also needed by // the HmrServer. // The whole bundling/serializing logic should follow as well. this._createModuleId = config.serializer.createModuleIdFactory(); this._bundler = new IncrementalBundler(config, { watch: options ? options.watch : undefined, }); this._nextBundleBuildID = 1; } end() { if (!this._isEnded) { this._bundler.end(); this._isEnded = true; } } getBundler(): IncrementalBundler { return this._bundler; } getCreateModuleId(): (path: string) => number { return this._createModuleId; } async build( options: BundleOptions, ): Promise<{ code: string, map: string, ... }> { const { entryFile, graphOptions, onProgress, serializerOptions, transformOptions, } = splitBundleOptions(options); const {prepend, graph} = await this._bundler.buildGraph( entryFile, transformOptions, { onProgress, shallow: graphOptions.shallow, }, ); const entryPoint = path.resolve(this._config.projectRoot, entryFile); const bundleOptions = { asyncRequireModulePath: this._config.transformer.asyncRequireModulePath, processModuleFilter: this._config.serializer.processModuleFilter, createModuleId: this._createModuleId, getRunModuleStatement: this._config.serializer.getRunModuleStatement, dev: transformOptions.dev, projectRoot: this._config.projectRoot, modulesOnly: serializerOptions.modulesOnly, runBeforeMainModule: this._config.serializer.getModulesRunBeforeMainModule( path.relative(this._config.projectRoot, entryPoint), ), runModule: serializerOptions.runModule, sourceMapUrl: serializerOptions.sourceMapUrl, sourceUrl: serializerOptions.sourceUrl, inlineSourceMap: serializerOptions.inlineSourceMap, }; let bundleCode = null; let bundleMap = null; if (this._config.serializer.customSerializer) { const bundle = this._config.serializer.customSerializer( entryPoint, prepend, graph, bundleOptions, ); if (typeof bundle === 'string') { bundleCode = bundle; } else { bundleCode = bundle.code; bundleMap = bundle.map; } } else { bundleCode = bundleToString( baseJSBundle(entryPoint, prepend, graph, bundleOptions), ).code; } if (!bundleMap) { bundleMap = sourceMapString( [...prepend, ...this._getSortedModules(graph)], { excludeSource: serializerOptions.excludeSource, processModuleFilter: this._config.serializer.processModuleFilter, }, ); } return { code: bundleCode, map: bundleMap, }; } async getRamBundleInfo(options: BundleOptions): Promise { const { entryFile, graphOptions, onProgress, serializerOptions, transformOptions, } = splitBundleOptions(options); const {prepend, graph} = await this._bundler.buildGraph( entryFile, transformOptions, {onProgress, shallow: graphOptions.shallow}, ); const entryPoint = path.resolve(this._config.projectRoot, entryFile); return await getRamBundleInfo(entryPoint, prepend, graph, { asyncRequireModulePath: this._config.transformer.asyncRequireModulePath, processModuleFilter: this._config.serializer.processModuleFilter, createModuleId: this._createModuleId, dev: transformOptions.dev, excludeSource: serializerOptions.excludeSource, getRunModuleStatement: this._config.serializer.getRunModuleStatement, getTransformOptions: this._config.transformer.getTransformOptions, platform: transformOptions.platform, projectRoot: this._config.projectRoot, modulesOnly: serializerOptions.modulesOnly, runBeforeMainModule: this._config.serializer.getModulesRunBeforeMainModule( path.relative(this._config.projectRoot, entryPoint), ), runModule: serializerOptions.runModule, sourceMapUrl: serializerOptions.sourceMapUrl, sourceUrl: serializerOptions.sourceUrl, inlineSourceMap: serializerOptions.inlineSourceMap, }); } async getAssets(options: BundleOptions): Promise<$ReadOnlyArray> { const {entryFile, transformOptions, onProgress} = splitBundleOptions( options, ); const {graph} = await this._bundler.buildGraph( entryFile, transformOptions, {onProgress, shallow: false}, ); return await getAssets(graph, { processModuleFilter: this._config.serializer.processModuleFilter, assetPlugins: this._config.transformer.assetPlugins, platform: transformOptions.platform, projectRoot: this._config.projectRoot, publicPath: this._config.transformer.publicPath, }); } async getOrderedDependencyPaths(options: { +dev: boolean, +entryFile: string, +minify: boolean, +platform: string, ... }): Promise> { const {entryFile, transformOptions, onProgress} = splitBundleOptions({ ...Server.DEFAULT_BUNDLE_OPTIONS, /* $FlowFixMe(>=0.111.0 site=react_native_fb) This comment suppresses an * error found when Flow v0.111 was deployed. To see the error, delete * this comment and run Flow. */ ...options, bundleType: 'bundle', }); const {prepend, graph} = await this._bundler.buildGraph( entryFile, transformOptions, {onProgress, shallow: false}, ); const platform = transformOptions.platform || parsePlatformFilePath(entryFile, this._platforms).platform; return await getAllFiles(prepend, graph, { platform, processModuleFilter: this._config.serializer.processModuleFilter, }); } _rangeRequestMiddleware( req: IncomingMessage, res: ServerResponse, data: string | Buffer, assetPath: string, ) { if (req.headers && req.headers.range) { const [rangeStart, rangeEnd] = req.headers.range .replace(/bytes=/, '') .split('-'); const dataStart = parseInt(rangeStart, 10); const dataEnd = rangeEnd ? parseInt(rangeEnd, 10) : data.length - 1; const chunksize = dataEnd - dataStart + 1; res.writeHead(206, { 'Accept-Ranges': 'bytes', 'Content-Length': chunksize.toString(), 'Content-Range': `bytes ${dataStart}-${dataEnd}/${data.length}`, 'Content-Type': mime.lookup(path.basename(assetPath)), }); return data.slice(dataStart, dataEnd + 1); } return data; } async _processSingleAssetRequest(req: IncomingMessage, res: ServerResponse) { const urlObj = url.parse(decodeURI(req.url), true); const assetPath = urlObj && urlObj.pathname && urlObj.pathname.match(/^\/assets\/(.+)$/); if (!assetPath) { throw new Error('Could not extract asset path from URL'); } const processingAssetRequestLogEntry = log( createActionStartEntry({ action_name: 'Processing asset request', asset: assetPath[1], }), ); try { const data = await getAsset( assetPath[1], this._config.projectRoot, this._config.watchFolders, /* $FlowFixMe: query may be empty for invalid URLs */ urlObj.query.platform, this._config.resolver.assetExts, ); // Tell clients to cache this for 1 year. // This is safe as the asset url contains a hash of the asset. if (process.env.REACT_NATIVE_ENABLE_ASSET_CACHING === true) { res.setHeader('Cache-Control', 'max-age=31536000'); } res.end(this._rangeRequestMiddleware(req, res, data, assetPath[1])); process.nextTick(() => { log(createActionEndEntry(processingAssetRequestLogEntry)); }); } catch (error) { console.error(error.stack); res.writeHead(404); res.end('Asset not found'); } } processRequest: ( IncomingMessage, ServerResponse, (e: ?Error) => mixed, ) => void = ( req: IncomingMessage, res: ServerResponse, next: (?Error) => mixed, ) => { this._processRequest(req, res, next).catch(next); }; async _processRequest( req: IncomingMessage, res: ServerResponse, next: (?Error) => mixed, ) { const urlObj = url.parse(req.url, true); const {host} = req.headers; debug(`Handling request: ${host ? 'http://' + host : ''}${req.url}`); /* $FlowFixMe: Could be empty if the URL is invalid. */ const pathname: string = urlObj.pathname; if (pathname.match(/\.bundle$/)) { await this._processBundleRequest(req, res); } else if (pathname.match(/\.map$/)) { // Chrome dev tools may need to access the source maps. res.setHeader('Access-Control-Allow-Origin', 'devtools://devtools'); await this._processSourceMapRequest(req, res); } else if (pathname.match(/\.assets$/)) { await this._processAssetsRequest(req, res); } else if (pathname.match(/^\/assets\//)) { await this._processSingleAssetRequest(req, res); } else if (pathname === '/symbolicate') { await this._symbolicate(req, res); } else { next(); } } _createRequestProcessor({ createStartEntry, createEndEntry, build, finish, }: {| +createStartEntry: (context: ProcessStartContext) => ActionLogEntryData, +createEndEntry: ( context: ProcessEndContext, ) => $Rest, +build: (context: ProcessStartContext) => Promise, +finish: (context: ProcessEndContext) => void, |}) { return async function requestProcessor( req: IncomingMessage, res: ServerResponse, ): Promise { const mres = MultipartResponse.wrap(req, res); const bundleOptions = parseOptionsFromUrl( url.format({ ...url.parse(req.url), protocol: 'http', host: req.headers.host, }), new Set(this._config.resolver.platforms), ); const { entryFile, graphOptions, transformOptions, serializerOptions, } = splitBundleOptions(bundleOptions); /** * `entryFile` is relative to projectRoot, we need to use resolution function * to find the appropriate file with supported extensions. */ const resolutionFn = await transformHelpers.getResolveDependencyFn( this._bundler.getBundler(), transformOptions.platform, ); const resolvedEntryFilePath = resolutionFn( `${this._config.projectRoot}/.`, entryFile, ); const graphId = getGraphId(resolvedEntryFilePath, transformOptions, { shallow: graphOptions.shallow, experimentalImportBundleSupport: this._config.transformer .experimentalImportBundleSupport, }); const buildID = this.getNewBuildID(); let onProgress = null; if (this._config.reporter) { onProgress = (transformedFileCount: number, totalFileCount: number) => { mres.writeChunk( {'Content-Type': 'application/json'}, JSON.stringify({done: transformedFileCount, total: totalFileCount}), ); this._reporter.update({ buildID, type: 'bundle_transform_progressed', transformedFileCount, totalFileCount, }); }; } this._reporter.update({ buildID, bundleDetails: { entryFile: resolvedEntryFilePath, platform: transformOptions.platform, dev: transformOptions.dev, minify: transformOptions.minify, bundleType: bundleOptions.bundleType, }, type: 'bundle_build_started', }); const startContext = { buildID, bundleOptions, entryFile: resolvedEntryFilePath, graphId, graphOptions, mres, onProgress, req, serializerOptions, transformOptions, }; const logEntry = log( createActionStartEntry(createStartEntry(startContext)), ); let result; try { result = await build(startContext); } catch (error) { const formattedError = formatBundlingError(error); const status = error instanceof ResourceNotFoundError ? 404 : 500; mres.writeHead(status, { 'Content-Type': 'application/json; charset=UTF-8', }); mres.end(JSON.stringify(formattedError)); this._reporter.update({ buildID, type: 'bundle_build_failed', bundleOptions, }); this._reporter.update({error, type: 'bundling_error'}); log({ action_name: 'bundling_error', error_type: formattedError.type, log_entry_label: 'bundling_error', bundle_id: graphId, build_id: buildID, stack: formattedError.message, }); return; } const endContext = { ...startContext, result, }; finish(endContext); this._reporter.update({ buildID, type: 'bundle_build_done', }); log( createActionEndEntry({ ...logEntry, /* $FlowFixMe(>=0.111.0 site=react_native_fb) This comment suppresses * an error found when Flow v0.111 was deployed. To see the error, * delete this comment and run Flow. */ ...createEndEntry(endContext), }), ); }; } _processBundleRequest = this._createRequestProcessor({ createStartEntry(context: ProcessStartContext) { return { action_name: 'Requesting bundle', bundle_url: context.req.url, entry_point: context.entryFile, bundler: 'delta', build_id: context.buildID, bundle_options: context.bundleOptions, bundle_hash: context.graphId, }; }, createEndEntry( context: ProcessEndContext<{| bundle: string, lastModifiedDate: Date, nextRevId: RevisionId, numModifiedFiles: number, |}>, ) { return { outdated_modules: context.result.numModifiedFiles, }; }, build: async ({ entryFile, graphId, graphOptions, onProgress, serializerOptions, transformOptions, }) => { const revPromise = this._bundler.getRevisionByGraphId(graphId); const {delta, revision} = await (revPromise != null ? this._bundler.updateGraph(await revPromise, false) : this._bundler.initializeGraph(entryFile, transformOptions, { onProgress, shallow: graphOptions.shallow, })); const serializer = this._config.serializer.customSerializer || ((...args) => bundleToString(baseJSBundle(...args)).code); const bundle = serializer(entryFile, revision.prepend, revision.graph, { asyncRequireModulePath: this._config.transformer.asyncRequireModulePath, processModuleFilter: this._config.serializer.processModuleFilter, createModuleId: this._createModuleId, getRunModuleStatement: this._config.serializer.getRunModuleStatement, dev: transformOptions.dev, projectRoot: this._config.projectRoot, modulesOnly: serializerOptions.modulesOnly, runBeforeMainModule: this._config.serializer.getModulesRunBeforeMainModule( path.relative(this._config.projectRoot, entryFile), ), runModule: serializerOptions.runModule, sourceMapUrl: serializerOptions.sourceMapUrl, sourceUrl: serializerOptions.sourceUrl, inlineSourceMap: serializerOptions.inlineSourceMap, }); const bundleCode = typeof bundle === 'string' ? bundle : bundle.code; return { numModifiedFiles: delta.reset ? delta.added.size + revision.prepend.length : delta.added.size + delta.modified.size + delta.deleted.size, lastModifiedDate: revision.date, nextRevId: revision.id, bundle: bundleCode, }; }, finish({req, mres, result}) { if ( // We avoid parsing the dates since the client should never send a more // recent date than the one returned by the Delta Bundler (if that's the // case it's fine to return the whole bundle). req.headers['if-modified-since'] === result.lastModifiedDate.toUTCString() ) { debug('Responding with 304'); mres.writeHead(304); mres.end(); } else { mres.setHeader( FILES_CHANGED_COUNT_HEADER, String(result.numModifiedFiles), ); mres.setHeader(DELTA_ID_HEADER, String(result.nextRevId)); mres.setHeader('Content-Type', 'application/javascript'); mres.setHeader('Last-Modified', result.lastModifiedDate.toUTCString()); mres.setHeader( 'Content-Length', String(Buffer.byteLength(result.bundle)), ); mres.end(result.bundle); } }, }); // This function ensures that modules in source maps are sorted in the same // order as in a plain JS bundle. _getSortedModules(graph: Graph<>): $ReadOnlyArray> { const modules = [...graph.dependencies.values()]; // Assign IDs to modules in a consistent order for (const module of modules) { this._createModuleId(module.path); } // Sort by IDs return modules.sort( (a: Module, b: Module) => this._createModuleId(a.path) - this._createModuleId(b.path), ); } _processSourceMapRequest = this._createRequestProcessor({ createStartEntry(context: ProcessStartContext) { return { action_name: 'Requesting sourcemap', bundle_url: context.req.url, entry_point: context.entryFile, bundler: 'delta', }; }, createEndEntry(context: ProcessEndContext) { return { bundler: 'delta', }; }, build: async ({ entryFile, graphId, graphOptions, onProgress, serializerOptions, transformOptions, }) => { let revision; const revPromise = this._bundler.getRevisionByGraphId(graphId); if (revPromise == null) { ({revision} = await this._bundler.initializeGraph( entryFile, transformOptions, {onProgress, shallow: graphOptions.shallow}, )); } else { revision = await revPromise; } let {prepend, graph} = revision; if (serializerOptions.modulesOnly) { prepend = []; } return sourceMapString([...prepend, ...this._getSortedModules(graph)], { excludeSource: serializerOptions.excludeSource, processModuleFilter: this._config.serializer.processModuleFilter, }); }, finish({mres, result}) { mres.setHeader('Content-Type', 'application/json'); mres.end(result.toString()); }, }); _processAssetsRequest = this._createRequestProcessor({ createStartEntry(context: ProcessStartContext) { return { action_name: 'Requesting assets', bundle_url: context.req.url, entry_point: context.entryFile, bundler: 'delta', }; }, createEndEntry(context: ProcessEndContext<$ReadOnlyArray>) { return { bundler: 'delta', }; }, build: async ({entryFile, transformOptions, onProgress}) => { const {graph} = await this._bundler.buildGraph( entryFile, transformOptions, {onProgress, shallow: false}, ); return await getAssets(graph, { processModuleFilter: this._config.serializer.processModuleFilter, assetPlugins: this._config.transformer.assetPlugins, platform: transformOptions.platform, publicPath: this._config.transformer.publicPath, projectRoot: this._config.projectRoot, }); }, finish({mres, result}) { mres.setHeader('Content-Type', 'application/json'); mres.end(JSON.stringify(result)); }, }); async _symbolicate(req: IncomingMessage, res: ServerResponse) { const getCodeFrame = (urls, symbolicatedStack) => { for (let i = 0; i < symbolicatedStack.length; i++) { const {collapse, column, file, lineNumber} = symbolicatedStack[i]; if (collapse || lineNumber == null || urls.has(file)) { continue; } return { content: codeFrameColumns( fs.readFileSync(file, 'utf8'), { // Metro returns 0 based columns but codeFrameColumns expects 1-based columns start: {column: column + 1, line: lineNumber}, }, {forceColor: true}, ), location: { row: lineNumber, column, }, fileName: file, }; } return null; }; try { const symbolicatingLogEntry = log( createActionStartEntry('Symbolicating'), ); debug('Start symbolication'); /* $FlowFixMe: where is `rawBody` defined? Is it added by the `connect` framework? */ const body = await req.rawBody; const stack = JSON.parse(body).stack; // In case of multiple bundles / HMR, some stack frames can have different URLs from others const urls = new Set(); stack.forEach(frame => { const sourceUrl = frame.file; // Skip `/debuggerWorker.js` which does not need symbolication. if ( sourceUrl != null && !urls.has(sourceUrl) && !sourceUrl.endsWith('/debuggerWorker.js') && sourceUrl.startsWith('http') ) { urls.add(sourceUrl); } }); debug('Getting source maps for symbolication'); const sourceMaps = await Promise.all( Array.from(urls.values()).map(this._explodedSourceMapForURL, this), ); debug('Performing fast symbolication'); const symbolicatedStack = await await symbolicate( stack, zip(urls.values(), sourceMaps), this._config, ); debug('Symbolication done'); res.end( JSON.stringify({ codeFrame: getCodeFrame(urls, symbolicatedStack), stack: symbolicatedStack, }), ); process.nextTick(() => { log(createActionEndEntry(symbolicatingLogEntry)); }); } catch (error) { console.error(error.stack || error); res.statusCode = 500; res.end(JSON.stringify({error: error.message})); } } async _explodedSourceMapForURL(reqUrl: string): Promise { const options = parseOptionsFromUrl( reqUrl, new Set(this._config.resolver.platforms), ); const { entryFile, transformOptions, serializerOptions, graphOptions, onProgress, } = splitBundleOptions(options); /** * `entryFile` is relative to projectRoot, we need to use resolution function * to find the appropriate file with supported extensions. */ const resolutionFn = await transformHelpers.getResolveDependencyFn( this._bundler.getBundler(), transformOptions.platform, ); const resolvedEntryFilePath = resolutionFn( `${this._config.projectRoot}/.`, entryFile, ); const graphId = getGraphId(resolvedEntryFilePath, transformOptions, { shallow: graphOptions.shallow, experimentalImportBundleSupport: this._config.transformer .experimentalImportBundleSupport, }); let revision; const revPromise = this._bundler.getRevisionByGraphId(graphId); if (revPromise == null) { ({revision} = await this._bundler.initializeGraph( resolvedEntryFilePath, transformOptions, {onProgress, shallow: graphOptions.shallow}, )); } else { revision = await revPromise; } let {prepend, graph} = revision; if (serializerOptions.modulesOnly) { prepend = []; } return getExplodedSourceMap( [...prepend, ...this._getSortedModules(graph)], { processModuleFilter: this._config.serializer.processModuleFilter, }, ); } getNewBuildID(): string { return (this._nextBundleBuildID++).toString(36); } getPlatforms(): $ReadOnlyArray { return this._config.resolver.platforms; } getWatchFolders(): $ReadOnlyArray { return this._config.watchFolders; } static DEFAULT_GRAPH_OPTIONS: {| customTransformOptions: any, dev: boolean, hot: boolean, minify: boolean, |} = { customTransformOptions: Object.create(null), dev: true, hot: false, minify: false, }; static DEFAULT_BUNDLE_OPTIONS: {| ...typeof Server.DEFAULT_GRAPH_OPTIONS, excludeSource: false, inlineSourceMap: false, modulesOnly: false, onProgress: null, runModule: true, shallow: false, sourceMapUrl: null, sourceUrl: null, |} = { ...Server.DEFAULT_GRAPH_OPTIONS, excludeSource: false, inlineSourceMap: false, modulesOnly: false, onProgress: null, runModule: true, shallow: false, sourceMapUrl: null, sourceUrl: null, }; } function* zip(xs: Iterable, ys: Iterable): Iterable<[X, Y]> { //$FlowIssue #9324959 const ysIter: Iterator = ys[Symbol.iterator](); for (const x of xs) { const y = ysIter.next(); if (y.done) { return; } yield [x, y.value]; } } module.exports = Server;