React Streaming and SSR feature flag

packages/cli/src/commands/experimental/setupStreamingSsr.js

@@ -0,0 +1,30 @@
+import { recordTelemetryAttributes } from '@redwoodjs/cli-helpers'
+
+import { getEpilogue } from './util'
+
+export const command = 'setup-streaming-ssr'
+
+export const description =
+  'Enable React Streaming and Server Side Rendering (SSR)'
+
+export const EXPERIMENTAL_TOPIC_ID = 5052
+
+export const builder = (yargs) => {
+  yargs
+    .option('force', {
+      alias: 'f',
+      default: false,
+      description: 'Overwrite existing configuration',
+      type: 'boolean',
+    })
+    .epilogue(getEpilogue(command, description, EXPERIMENTAL_TOPIC_ID, true))
+}
+
+export const handler = async (options) => {
+  recordTelemetryAttributes({
+    command: ['experimental', command].join(' '),
+    force: options.force,
+  })
+  const { handler } = await import('./setupStreamingSsrHandler.js')
+  return handler(options)
+}

packages/cli/src/commands/experimental/setupStreamingSsrHandler.js

@@ -0,0 +1,54 @@
+import fs from 'fs'
+
+import { getConfigPath } from '@redwoodjs/project-config'
+
+import { writeFile } from '../../lib'
+
+import {
+  command,
+  description,
+  EXPERIMENTAL_TOPIC_ID,
+} from './setupStreamingSsr'
+import { printTaskEpilogue } from './util'
+
+export const handler = async ({ force }) => {
+  const redwoodTomlPath = getConfigPath()
+  const configContent = fs.readFileSync(redwoodTomlPath, 'utf-8')
+
+  if (!configContent.includes('[experimental.streamingSsr]')) {
+    console.log('Adding config to redwood.toml...')
+
+    // Use string replace to preserve comments and formatting
+    writeFile(
+      redwoodTomlPath,
+      configContent.concat(`\n[experimental.streamingSsr]\n  enabled = true\n`),
+      {
+        overwriteExisting: true, // redwood.toml always exists
+      }
+    )
+  } else {
+    if (force) {
+      console.log('Updating config in redwood.toml...')
+      writeFile(
+        redwoodTomlPath,
+        configContent.replace(
+          // Enable if it's currently disabled
+          `\n[experimental.streamingSsr]\n  enabled = false\n`,
+          `\n[experimental.streamingSsr]\n  enabled = true\n`
+        ),
+        {
+          overwriteExisting: true, // redwood.toml always exists
+        }
+      )
+    } else {
+      console.log('Adding config to redwood.toml...')
+      console.log(
+        "  The [experimental.studio] config block already exists in your 'redwood.toml' file."
+      )
+    }
+  }
+
+  console.log()
+
+  printTaskEpilogue(command, description, EXPERIMENTAL_TOPIC_ID)
+}

packages/project-config/src/__tests__/config.test.ts

@@ -55,6 +55,9 @@ describe('getConfig', () => {
             "apiSdk": undefined,
             "enabled": false,
           },
+          "streamingSsr": {
+            "enabled": false,
+          },
           "studio": {
             "graphiql": {
               "authImpersonation": {

packages/project-config/src/config.ts

@@ -104,6 +104,9 @@ export interface Config {
       plugins: CLIPlugin[]
     }
     useSDLCodeGenForGraphQLTypes: boolean
+    streamingSsr: {
+      enabled: boolean
+    }
   }
 }
 
@@ -177,6 +180,9 @@ const DEFAULT_CONFIG: Config = {
       ],
     },
     useSDLCodeGenForGraphQLTypes: false,
+    streamingSsr: {
+      enabled: false,
+    },
   },
 }
 

packages/vite/src/index.ts

@@ -99,6 +99,9 @@ export default function redwoodPluginVite(): PluginOption[] {
               RWJS_API_URL: rwConfig.web.apiUrl,
               __REDWOOD__APP_TITLE:
                 rwConfig.web.title || path.basename(rwPaths.base),
+              RWJS_EXP_STREAMING_SSR:
+                rwConfig.experimental.streamingSsr &&
+                rwConfig.experimental.streamingSsr.enabled,
             },
             RWJS_DEBUG_ENV: {
               RWJS_SRC_ROOT: rwPaths.web.src,

packages/web/ambient.d.ts

@@ -13,6 +13,7 @@ declare global {
     RWJS_API_GRAPHQL_URL: string
     /** URL or absolute path to serverless functions */
     RWJS_API_URL: string
+    RWJS_EXP_STREAMING_SSR: boolean
 
     __REDWOOD__APP_TITLE: string
     __REDWOOD__APOLLO_STATE: NormalizedCacheObject
@@ -31,6 +32,8 @@ declare global {
   var RWJS_API_URL: string
   /** Path to Redwood app source used by Development Error page to resolve source code paths */
   var RWJS_SRC_ROOT: string
+  /** Flag for experimental Streaming and SSR support */
+  var RWJS_EXP_STREAMING_SSR: boolean
 
   namespace NodeJS {
     interface Global {

packages/web/src/config.ts

@@ -5,3 +5,4 @@
 globalThis.RWJS_API_GRAPHQL_URL = RWJS_ENV.RWJS_API_GRAPHQL_URL as string
 globalThis.RWJS_API_URL = RWJS_ENV.RWJS_API_URL as string
 globalThis.__REDWOOD__APP_TITLE = RWJS_ENV.__REDWOOD__APP_TITLE as string
+globalThis.RWJS_EXP_STREAMING_SSR = RWJS_ENV.RWJS_EXP_STREAMING_SSR as boolean