1. /**
    
  2.  * Copyright (c) Meta Platforms, Inc. and affiliates.
    
  3.  *
    
  4.  * This source code is licensed under the MIT license found in the
    
  5.  * LICENSE file in the root directory of this source tree.
    
  6.  *
    
  7.  * @flow
    
  8.  */
    
  9. 
    
  10. import type {
    
  11.   Request,
    
  12.   ReactClientValue,
    
  13. } from 'react-server/src/ReactFlightServer';
    
  14. import type {Destination} from 'react-server/src/ReactServerStreamConfigNode';
    
  15. import type {ClientManifest} from './ReactFlightServerConfigTurbopackBundler';
    
  16. import type {ServerManifest} from 'react-client/src/ReactFlightClientConfig';
    
  17. import type {Busboy} from 'busboy';
    
  18. import type {Writable} from 'stream';
    
  19. import type {ServerContextJSONValue, Thenable} from 'shared/ReactTypes';
    
  20. 
    
  21. import {
    
  22.   createRequest,
    
  23.   startWork,
    
  24.   startFlowing,
    
  25.   abort,
    
  26. } from 'react-server/src/ReactFlightServer';
    
  27. 
    
  28. import {
    
  29.   createResponse,
    
  30.   reportGlobalError,
    
  31.   close,
    
  32.   resolveField,
    
  33.   resolveFileInfo,
    
  34.   resolveFileChunk,
    
  35.   resolveFileComplete,
    
  36.   getRoot,
    
  37. } from 'react-server/src/ReactFlightReplyServer';
    
  38. 
    
  39. import {decodeAction} from 'react-server/src/ReactFlightActionServer';
    
  40. 
    
  41. export {
    
  42.   registerServerReference,
    
  43.   registerClientReference,
    
  44.   createClientModuleProxy,
    
  45. } from './ReactFlightTurbopackReferences';
    
  46. 
    
  47. function createDrainHandler(destination: Destination, request: Request) {
    
  48.   return () => startFlowing(request, destination);
    
  49. }
    
  50. 
    
  51. type Options = {
    
  52.   onError?: (error: mixed) => void,
    
  53.   onPostpone?: (reason: string) => void,
    
  54.   context?: Array<[string, ServerContextJSONValue]>,
    
  55.   identifierPrefix?: string,
    
  56. };
    
  57. 
    
  58. type PipeableStream = {
    
  59.   abort(reason: mixed): void,
    
  60.   pipe<T: Writable>(destination: T): T,
    
  61. };
    
  62. 
    
  63. function renderToPipeableStream(
    
  64.   model: ReactClientValue,
    
  65.   turbopackMap: ClientManifest,
    
  66.   options?: Options,
    
  67. ): PipeableStream {
    
  68.   const request = createRequest(
    
  69.     model,
    
  70.     turbopackMap,
    
  71.     options ? options.onError : undefined,
    
  72.     options ? options.context : undefined,
    
  73.     options ? options.identifierPrefix : undefined,
    
  74.     options ? options.onPostpone : undefined,
    
  75.   );
    
  76.   let hasStartedFlowing = false;
    
  77.   startWork(request);
    
  78.   return {
    
  79.     pipe<T: Writable>(destination: T): T {
    
  80.       if (hasStartedFlowing) {
    
  81.         throw new Error(
    
  82.           'React currently only supports piping to one writable stream.',
    
  83.         );
    
  84.       }
    
  85.       hasStartedFlowing = true;
    
  86.       startFlowing(request, destination);
    
  87.       destination.on('drain', createDrainHandler(destination, request));
    
  88.       return destination;
    
  89.     },
    
  90.     abort(reason: mixed) {
    
  91.       abort(request, reason);
    
  92.     },
    
  93.   };
    
  94. }
    
  95. 
    
  96. function decodeReplyFromBusboy<T>(
    
  97.   busboyStream: Busboy,
    
  98.   turbopackMap: ServerManifest,
    
  99. ): Thenable<T> {
    
  100.   const response = createResponse(turbopackMap, '');
    
  101.   let pendingFiles = 0;
    
  102.   const queuedFields: Array<string> = [];
    
  103.   busboyStream.on('field', (name, value) => {
    
  104.     if (pendingFiles > 0) {
    
  105.       // Because the 'end' event fires two microtasks after the next 'field'
    
  106.       // we would resolve files and fields out of order. To handle this properly
    
  107.       // we queue any fields we receive until the previous file is done.
    
  108.       queuedFields.push(name, value);
    
  109.     } else {
    
  110.       resolveField(response, name, value);
    
  111.     }
    
  112.   });
    
  113.   busboyStream.on('file', (name, value, {filename, encoding, mimeType}) => {
    
  114.     if (encoding.toLowerCase() === 'base64') {
    
  115.       throw new Error(
    
  116.         "React doesn't accept base64 encoded file uploads because we don't expect " +
    
  117.           "form data passed from a browser to ever encode data that way. If that's " +
    
  118.           'the wrong assumption, we can easily fix it.',
    
  119.       );
    
  120.     }
    
  121.     pendingFiles++;
    
  122.     const file = resolveFileInfo(response, name, filename, mimeType);
    
  123.     value.on('data', chunk => {
    
  124.       resolveFileChunk(response, file, chunk);
    
  125.     });
    
  126.     value.on('end', () => {
    
  127.       resolveFileComplete(response, name, file);
    
  128.       pendingFiles--;
    
  129.       if (pendingFiles === 0) {
    
  130.         // Release any queued fields
    
  131.         for (let i = 0; i < queuedFields.length; i += 2) {
    
  132.           resolveField(response, queuedFields[i], queuedFields[i + 1]);
    
  133.         }
    
  134.         queuedFields.length = 0;
    
  135.       }
    
  136.     });
    
  137.   });
    
  138.   busboyStream.on('finish', () => {
    
  139.     close(response);
    
  140.   });
    
  141.   busboyStream.on('error', err => {
    
  142.     reportGlobalError(
    
  143.       response,
    
  144.       // $FlowFixMe[incompatible-call] types Error and mixed are incompatible
    
  145.       err,
    
  146.     );
    
  147.   });
    
  148.   return getRoot(response);
    
  149. }
    
  150. 
    
  151. function decodeReply<T>(
    
  152.   body: string | FormData,
    
  153.   turbopackMap: ServerManifest,
    
  154. ): Thenable<T> {
    
  155.   if (typeof body === 'string') {
    
  156.     const form = new FormData();
    
  157.     form.append('0', body);
    
  158.     body = form;
    
  159.   }
    
  160.   const response = createResponse(turbopackMap, '', body);
    
  161.   const root = getRoot<T>(response);
    
  162.   close(response);
    
  163.   return root;
    
  164. }
    
  165. 
    
  166. export {
    
  167.   renderToPipeableStream,
    
  168.   decodeReplyFromBusboy,
    
  169.   decodeReply,
    
  170.   decodeAction,
    
  171. };