/** * Copyright (c) 2015-present, Facebook, Inc. * All rights reserved. * * This source code is licensed under the BSD-style license found in the * LICENSE file in the root directory of this source tree. An additional grant * of patent rights can be found in the PATENTS file in the same directory. * * @flow */ 'use strict'; const Logger = require('./src/Logger'); const debug = require('debug'); const invariant = require('fbjs/lib/invariant'); import type {PostProcessModules, PostMinifyProcess} from './src/Bundler'; import type Server from './src/Server'; import type {GlobalTransformCache} from './src/lib/GlobalTransformCache'; import type {Reporter} from './src/lib/reporting'; import type {HasteImpl} from './src/node-haste/Module'; exports.createServer = createServer; exports.Logger = Logger; type Options = { hasteImpl?: HasteImpl, globalTransformCache: ?GlobalTransformCache, nonPersistent?: boolean, postProcessModules?: PostProcessModules, postMinifyProcess?: PostMinifyProcess, projectRoots: $ReadOnlyArray, reporter?: Reporter, +sourceExts: ?Array, +transformModulePath: string, watch?: boolean, }; type StrictOptions = {...Options, reporter: Reporter}; type PublicBundleOptions = { +dev?: boolean, +entryFile: string, +generateSourceMaps?: boolean, +inlineSourceMap?: boolean, +minify?: boolean, +platform?: string, +runModule?: boolean, +sourceMapUrl?: string, }; /** * This is a public API, so we don't trust the value and purposefully downgrade * it as `mixed`. Because it understands `invariant`, Flow ensure that we * refine these values completely. */ function assertPublicBundleOptions(bo: mixed): PublicBundleOptions { invariant(typeof bo === 'object' && bo != null, 'bundle options must be an object'); invariant(bo.dev === undefined || typeof bo.dev === 'boolean', 'bundle options field `dev` must be a boolean'); const {entryFile} = bo; invariant(typeof entryFile === 'string', 'bundle options must contain a string field `entryFile`'); invariant(bo.generateSourceMaps === undefined || typeof bo.generateSourceMaps === 'boolean', 'bundle options field `generateSourceMaps` must be a boolean'); invariant(bo.inlineSourceMap === undefined || typeof bo.inlineSourceMap === 'boolean', 'bundle options field `inlineSourceMap` must be a boolean'); invariant(bo.minify === undefined || typeof bo.minify === 'boolean', 'bundle options field `minify` must be a boolean'); invariant(bo.platform === undefined || typeof bo.platform === 'string', 'bundle options field `platform` must be a string'); invariant(bo.runModule === undefined || typeof bo.runModule === 'boolean', 'bundle options field `runModule` must be a boolean'); invariant(bo.sourceMapUrl === undefined || typeof bo.sourceMapUrl === 'string', 'bundle options field `sourceMapUrl` must be a boolean'); return {entryFile, ...bo}; } exports.buildBundle = function(options: Options, bundleOptions: PublicBundleOptions) { var server = createNonPersistentServer(options); const ServerClass = require('./src/Server'); return server.buildBundle({ ...ServerClass.DEFAULT_BUNDLE_OPTIONS, ...assertPublicBundleOptions(bundleOptions), }).then(p => { server.end(); return p; }); }; exports.getOrderedDependencyPaths = function(options: Options, depOptions: { +entryFile: string, +dev: boolean, +platform: string, }) { var server = createNonPersistentServer(options); return server.getOrderedDependencyPaths(depOptions) .then(function(paths) { server.end(); return paths; }); }; function enableDebug() { // react-packager logs debug messages using the 'debug' npm package, and uses // the following prefix throughout. // To enable debugging, we need to set our pattern or append it to any // existing pre-configured pattern to avoid disabling logging for // other packages var debugPattern = 'RNP:*'; var existingPattern = debug.load(); if (existingPattern) { debugPattern += ',' + existingPattern; } debug.enable(debugPattern); } function createServer(options: StrictOptions): Server { // the debug module is configured globally, we need to enable debugging // *before* requiring any packages that use `debug` for logging if (options.verbose) { enableDebug(); } // Some callsites may not be Flowified yet. invariant(options.reporter != null, 'createServer() requires reporter'); const serverOptions = Object.assign({}, options); delete serverOptions.verbose; const ServerClass = require('./src/Server'); return new ServerClass(serverOptions); } function createNonPersistentServer(options: Options): Server { const serverOptions = { // It's unsound to set-up the reporter here, // but this allows backward compatibility. reporter: options.reporter == null ? require('./src/lib/reporting').nullReporter : options.reporter, ...options, watch: !options.nonPersistent, }; return createServer(serverOptions); }