npm - @nerest/nerest - Versions diffs - 0.1.0 → 1.5.0 - Mend

@nerest/nerest 0.1.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (89) hide show

package/LICENSE.md +178 -0
package/README.md +129 -40
package/bin/index.ts +3 -0
package/bin/typegen.ts +35 -0
package/bin/watch.ts +3 -2
package/build/configs/development.ts +63 -0
package/build/configs/production.ts +59 -0
package/build/configs/shared.ts +51 -0
package/build/configs/vite-logger.development.ts +30 -0
package/build/index.ts +53 -76
package/client/index.ts +14 -2
package/dist/bin/index.js +4 -0
package/dist/bin/typegen.d.ts +1 -0
package/dist/bin/typegen.js +31 -0
package/dist/bin/watch.js +1 -2
package/dist/build/configs/development.d.ts +4 -0
package/dist/build/configs/development.js +53 -0
package/dist/build/configs/production.d.ts +4 -0
package/dist/build/configs/production.js +50 -0
package/dist/build/configs/shared.d.ts +10 -0
package/dist/build/configs/shared.js +24 -0
package/dist/build/configs/vite-logger.development.d.ts +2 -0
package/dist/build/configs/vite-logger.development.js +25 -0
package/dist/build/index.js +39 -69
package/dist/client/index.js +9 -2
package/dist/server/development.d.ts +1 -1
package/dist/server/development.js +51 -134
package/dist/server/hooks/logger.d.ts +1 -2
package/dist/server/hooks/logger.js +3 -0
package/dist/server/hooks/props.d.ts +2 -2
package/dist/server/hooks/props.js +2 -2
package/dist/server/hooks/runtime.js +3 -3
package/dist/server/{parts → loaders}/apps.d.ts +2 -1
package/dist/server/loaders/apps.js +36 -0
package/dist/server/loaders/assets.js +25 -2
package/dist/server/loaders/build.d.ts +2 -0
package/dist/server/loaders/build.js +11 -0
package/dist/server/loaders/examples.js +7 -13
package/dist/server/loaders/manifest.d.ts +8 -1
package/dist/server/loaders/manifest.js +12 -4
package/dist/server/loaders/preview.d.ts +4 -0
package/dist/server/loaders/preview.js +11 -0
package/dist/server/loaders/project.d.ts +16 -0
package/dist/server/loaders/project.js +11 -0
package/dist/server/loaders/schema.d.ts +2 -1
package/dist/server/loaders/schema.js +12 -8
package/dist/server/parts/k8s-probes.js +10 -6
package/dist/server/parts/preview.d.ts +2 -1
package/dist/server/parts/preview.js +5 -4
package/dist/server/parts/render.d.ts +5 -3
package/dist/server/parts/render.js +8 -8
package/dist/server/parts/swagger.d.ts +2 -1
package/dist/server/parts/swagger.js +8 -19
package/dist/server/parts/validator.d.ts +3 -1
package/dist/server/parts/validator.js +13 -0
package/dist/server/production.js +17 -83
package/dist/server/shared.d.ts +14 -0
package/dist/server/shared.js +94 -0
package/dist/server/utils.d.ts +1 -0
package/dist/server/utils.js +5 -0
package/package.json +46 -43
package/schemas/nerest-build.schema.d.ts +19 -1
package/schemas/nerest-build.schema.json +21 -1
package/server/development.ts +67 -172
package/server/hooks/logger.ts +3 -0
package/server/hooks/props.ts +5 -5
package/server/hooks/runtime.ts +3 -3
package/server/loaders/apps.ts +58 -0
package/server/loaders/assets.ts +30 -2
package/server/loaders/build.ts +14 -0
package/server/loaders/examples.ts +7 -15
package/server/loaders/manifest.ts +23 -4
package/server/loaders/preview.ts +17 -0
package/server/loaders/project.ts +33 -0
package/server/loaders/schema.ts +12 -10
package/server/parts/k8s-probes.ts +26 -13
package/server/parts/preview.ts +11 -4
package/server/parts/render.ts +13 -9
package/server/parts/swagger.ts +10 -29
package/server/parts/validator.ts +14 -0
package/server/production.ts +22 -110
package/server/shared.ts +150 -0
package/server/utils.ts +6 -0
package/dist/server/parts/apps.js +0 -37
package/dist/server/parts/props-hook.d.ts +0 -1
package/dist/server/parts/props-hook.js +0 -8
package/dist/server/parts/runtime-hook.d.ts +0 -2
package/dist/server/parts/runtime-hook.js +0 -28
package/server/parts/apps.ts +0 -59

package/server/parts/preview.ts CHANGED Viewed

@@ -1,10 +1,20 @@
+import type { PreviewParts } from '../loaders/preview.js';
 // Renders the preview page available by convention at /api/{name}/examples/{example}
-export function renderPreviewPage(html: string, assets: string[]) {
+export function renderPreviewPage(
+  html: string,
+  assets: string[],
+  parts: PreviewParts
+) {
   const { scripts, styles } = mapAssets(assets);
   return `
+  <!DOCTYPE html>
   <html>
   <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
     ${styles.join('\n')}
+    ${parts.head}
   </head>
   <body>
     ${html}
@@ -15,9 +25,6 @@ export function renderPreviewPage(html: string, assets: string[]) {
 }
 function mapAssets(assets: string[]) {
-  // TODO: script type="module" is not supported by older browsers
-  // but vite doesn't provide `nomodule` fallback by default
-  // see @vitejs/plugin-legacy
   const scripts = assets
     .filter((src) => src.endsWith('.js'))
     .map((src) => `<script type="module" src="${src}"></script>`);

package/server/parts/render.ts CHANGED Viewed

@@ -1,35 +1,39 @@
-import React from 'react';
+import type { ComponentType } from 'react';
+import { createElement } from 'react';
 import { renderToString } from 'react-dom/server';
-import { nanoid } from 'nanoid';
+import type { Project } from '../loaders/project.js';
+import { randomId } from '../utils.js';
 type RenderProps = {
   name: string;
   assets: string[];
-  component: React.ComponentType;
+  component: ComponentType;
+  project: Project;
 };
 export function renderApp(
-  { name, assets, component }: RenderProps,
+  { name, assets, component, project }: RenderProps,
   props: Record<string, unknown> = {}
 ) {
-  const html = renderSsrComponent(name, component, props);
+  const html = renderSsrComponent(name, component, project, props);
   return { html, assets };
 }
 function renderSsrComponent(
   appName: string,
-  appComponent: React.ComponentType,
+  appComponent: ComponentType,
+  project: Project,
   props: Record<string, unknown>
 ) {
-  const html = renderToString(React.createElement(appComponent, props));
+  const html = renderToString(createElement(appComponent, props));
   // There may be multiple instances of the same app on the page,
   // so we will use a randomized id to avoid collisions
-  const appId = nanoid();
+  const appId = randomId();
   // data-app-name and data-app-id are used by client entrypoint to hydrate
   // apps using correct serialized props
-  const container = `<div data-app-name="${appName}" data-app-id="${appId}">${html}</div>`;
+  const container = `<div data-project-name="${project.name}" data-app-name="${appName}" data-app-id="${appId}">${html}</div>`;
   const script = `<script type="application/json" data-app-id="${appId}">${JSON.stringify(
     props
   )}</script>`;

package/server/parts/swagger.ts CHANGED Viewed

@@ -1,43 +1,24 @@
-import path from 'path';
-import fs from 'fs';
 import type { FastifyInstance } from 'fastify';
 import fastifySwagger from '@fastify/swagger';
 import fastifySwaggerUi from '@fastify/swagger-ui';
+import type { Project } from '../loaders/project.js';
 // Setup automatic OpenAPI specification compilation and enable
 // Swagger UI at the `/api` route
-export async function setupSwagger(app: FastifyInstance) {
-  let appInfo: {
-    name?: string;
-    description?: string;
-    version?: string;
-    homepage?: string;
-    repository?: string | { url?: string };
-  } = {};
-  try {
-    const packageJson = fs.readFileSync(
-      path.join(process.cwd(), 'package.json'),
-      { encoding: 'utf-8' }
-    );
-    appInfo = JSON.parse(packageJson);
-  } catch (e) {
-    // We only use package.json info to setup Swagger info and links,
-    // if we are unable to load them -- that's fine
-  }
+export async function setupSwagger(app: FastifyInstance, project: Project) {
   const homepage =
-    appInfo.homepage ||
-    (typeof appInfo.repository === 'string'
-      ? appInfo.repository
-      : appInfo.repository?.url);
+    project.homepage ||
+    (typeof project.repository === 'string'
+      ? project.repository
+      : project.repository?.url);
   await app.register(fastifySwagger, {
     openapi: {
       info: {
-        title: appInfo.name ?? 'Nerest micro frontend',
-        description: appInfo.description,
-        version: appInfo.version ?? '',
+        title: project.name || 'Nerest micro frontend',
+        description: project.description,
+        version: project.version ?? '',
         contact: homepage
           ? {
               name: 'Homepage',

package/server/parts/validator.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import Ajv from 'ajv';
 import fastUri from 'fast-uri';
 import addFormats from 'ajv-formats';
+import type { FastifyInstance } from 'fastify';
 // Ajv default export is broken, so we have to specify `.default`
 // manually: https://github.com/ajv-validator/ajv/issues/2132
@@ -20,3 +21,16 @@ export const validator = new Ajv.default({
 // `email`, `url`, etc. Used by default in fastify
 // https://www.npmjs.com/package/ajv-formats
 addFormats.default(validator);
+// Setup schema validation. We have to use our own ajv instance that
+// we can use both to validate request bodies and examples against
+// app schemas
+export function setupValidator(app: FastifyInstance) {
+  if (process.env.DISABLE_SCHEMA_VALIDATION) {
+    // If schema validation is disabled, return data as is without any checks
+    app.setValidatorCompiler(() => (data) => ({ value: data }));
+  } else {
+    // If schema validation is enabled, validate and coerce data via ajv
+    app.setValidatorCompiler(({ schema }) => validator.compile(schema));
+  }
+}

package/server/production.ts CHANGED Viewed

@@ -1,130 +1,42 @@
 // This is the nerest production server entrypoint
-import path from 'path';
-import fs from 'fs/promises';
+import type { ComponentType } from 'react';
+import { createServer } from './shared.js';
+import { loadNerestManifest } from './loaders/manifest.js';
-import fastify from 'fastify';
-import fastifyGracefulShutdown from 'fastify-graceful-shutdown';
-import type { RouteShorthandOptions } from 'fastify';
-import type { AppEntry } from './parts/apps.js';
-import { renderApp } from './parts/render.js';
-import { setupSwagger } from './parts/swagger.js';
-import { validator } from './parts/validator.js';
-import { renderPreviewPage } from './parts/preview.js';
-import { setupK8SProbes } from './parts/k8s-probes.js';
-import { runRuntimeHook } from './hooks/runtime.js';
-import { runPropsHook } from './hooks/props.js';
-import { runLoggerHook } from './hooks/logger.js';
-// TODO: refactor to merge the similar parts between production and development server?
-async function runProductionServer() {
+// Important: this file is the server entrypoint that will be built by vite
+// in `build/index.ts`. All of the import.meta.glob's will be resolved at build time
+async function runProductionServer(port: number) {
   const root = process.cwd();
-  // TODO: error handling for file reading
-  const apps = JSON.parse(
-    await fs.readFile(path.join(root, 'build/nerest-manifest.json'), {
-      encoding: 'utf-8',
-    })
-  ) as Record<string, AppEntry>;
+  // Load project information from the manifest generated during production build
+  const { project, apps } = await loadNerestManifest(root);
   const components = import.meta.glob('/apps/*/index.tsx', {
     import: 'default',
     eager: true,
-  }) as Record<string, React.ComponentType>;
+  }) as Record<string, ComponentType>;
   const propsHooks = import.meta.glob('/apps/*/props.ts', {
     eager: true,
   });
-  const runtimeHook = import.meta.glob('/nerest-runtime.ts', { eager: true });
-  const app = fastify({
-    // Receive logger configuration from `nerest-runtime.logger()` or
-    // use the default fastify one (`true`)
-    logger:
-      (await runLoggerHook(async () => runtimeHook['/nerest-runtime.ts'])) ??
-      true,
+  const runtimeHook = import.meta.glob('/nerest/runtime.ts', { eager: true });
+  const app = await createServer({
+    root,
+    project,
+    apps,
+    loadComponent: async (entry: string) =>
+      components[`/apps/${entry}/index.tsx`],
+    loadPropsHook: async (entry: string) =>
+      propsHooks[`/apps/${entry}/props.ts`],
+    loadRuntimeHook: async () => runtimeHook['/nerest/runtime.ts'],
   });
-  // Setup schema validation. We have to use our own ajv instance that
-  // we can use both to validate request bodies and examples against
-  // app schemas
-  app.setValidatorCompiler(({ schema }) => validator.compile(schema));
-  await setupSwagger(app);
-  for (const appEntry of Object.values(apps)) {
-    const { name, examples, schema, assets } = appEntry;
-    const component = components[`/apps/${name}/index.tsx`];
-    const propsHook = async () => propsHooks[`/apps/${name}/props.ts`];
-    const routeOptions: RouteShorthandOptions = {};
-    // TODO: report error if schema is missing, unless this app is client-only
-    // TODO: disallow apps without schemas in production build
-    if (schema) {
-      routeOptions.schema = {
-        // Use description as Swagger summary, since summary is visible
-        // even when the route is collapsed in the UI
-        summary: schema.description as string,
-        // TODO: do we need to mix in examples like in the development server?
-        body: schema,
-      };
-    }
-    // POST /api/{name} -> render app with request.body as props
-    app.post(`/api/${name}`, routeOptions, async (request) => {
-      const props = await runPropsHook(request.body, request.log, propsHook);
-      return renderApp({ name, assets, component }, props);
-    });
-    for (const [exampleName, example] of Object.entries(examples)) {
-      // GET /api/{name}/examples/{example} -> render a preview page
-      // with a predefined example body
-      const exampleRoute = `/api/${name}/examples/${exampleName}`;
-      app.get(
-        exampleRoute,
-        {
-          schema: {
-            // Add a clickable link to the example route in route's Swagger
-            // description so it's easier to navigate to
-            description: `Open sandbox: [${exampleRoute}](${exampleRoute})`,
-          },
-        },
-        async (request, reply) => {
-          const props = await runPropsHook(example, request.log, propsHook);
-          const { html, assets: outAssets } = renderApp(
-            {
-              name,
-              assets,
-              component,
-            },
-            props
-          );
-          reply.type('text/html');
-          return renderPreviewPage(html, outAssets);
-        }
-      );
-    }
-  }
-  // Add graceful shutdown handler to prevent requests errors
-  await app.register(fastifyGracefulShutdown);
-  if (process.env.ENABLE_K8S_PROBES) {
-    await setupK8SProbes(app);
-  }
-  // Execute runtime hook in nerest-runtime.ts if it exists
-  await runRuntimeHook(app, async () => runtimeHook['/nerest-runtime.ts']);
-  // TODO: remove hardcoded port
   await app.listen({
     host: '0.0.0.0',
-    port: 3000,
+    port,
   });
 }
-runProductionServer();
+runProductionServer(process.env.PORT ? Number(process.env.PORT) : 3000);

package/server/shared.ts ADDED Viewed

@@ -0,0 +1,150 @@
+import fastify from 'fastify';
+import type { FastifyInstance } from 'fastify';
+import type { RouteShorthandOptions } from 'fastify';
+import fastifyGracefulShutdown from 'fastify-graceful-shutdown';
+import type { ComponentType } from 'react';
+import { renderApp } from './parts/render.js';
+import { setupSwagger } from './parts/swagger.js';
+import { setupValidator, validator } from './parts/validator.js';
+import { renderPreviewPage } from './parts/preview.js';
+import { setupK8SProbes } from './parts/k8s-probes.js';
+import { runRuntimeHook } from './hooks/runtime.js';
+import { runPropsHook } from './hooks/props.js';
+import { runLoggerHook } from './hooks/logger.js';
+import type { Project } from './loaders/project.js';
+import { loadPreviewParts } from './loaders/preview.js';
+import type { PreviewParts } from './loaders/preview.js';
+import type { AppEntry } from './loaders/apps.js';
+import { randomId } from './utils.js';
+type ServerOptions = {
+  root: string;
+  project: Project;
+  apps: Record<string, AppEntry>;
+  loadComponent: (entry: string) => Promise<ComponentType>;
+  loadPropsHook: (entry: string) => Promise<unknown>;
+  loadRuntimeHook: () => Promise<unknown>;
+};
+type ServerOptionsWithPreview = ServerOptions & {
+  previewParts: PreviewParts;
+};
+export async function createServer(options: ServerOptions) {
+  const { project, root, loadRuntimeHook } = options;
+  const app = fastify({
+    logger: (await runLoggerHook(loadRuntimeHook)) ?? true,
+    ignoreTrailingSlash: true,
+    useSemicolonDelimiter: false,
+    // JSON parsing can take a long time and blocks the event loop,
+    // so we need to limit the size of the body. 10MB is a good compromise
+    // baseline that was chosen by experimenting with real world usage
+    bodyLimit: 10 * 1024 * 1024,
+    genReqId(req): string {
+      return String(req.headers['x-request-id'] || randomId());
+    },
+  });
+  // Setup payload validation and Swagger based on apps' JSON Schema
+  setupValidator(app);
+  await setupSwagger(app, project);
+  // Load preview parts from `nerest/preview-{part}.html` files
+  const previewParts = await loadPreviewParts(root);
+  await setupRoutes(app, { ...options, previewParts });
+  // Add graceful shutdown handler to prevent requests errors
+  await app.register(fastifyGracefulShutdown);
+  if (process.env.ENABLE_K8S_PROBES) {
+    await setupK8SProbes(app);
+  }
+  // Execute runtime hook in nerest/runtime.ts if it exists
+  await runRuntimeHook(app, loadRuntimeHook);
+  return app;
+}
+async function setupRoutes(
+  app: FastifyInstance,
+  options: ServerOptionsWithPreview
+) {
+  const { project, apps, previewParts, loadComponent, loadPropsHook } = options;
+  for (const appEntry of Object.values(apps)) {
+    const { name, examples, schema, assets } = appEntry;
+    const routeOptions: RouteShorthandOptions = {};
+    // TODO: report error if schema is missing, making it mandatory
+    if (schema) {
+      routeOptions.schema = {
+        summary: schema.description as string,
+        // Tags are used to group routes in Swagger UI
+        tags: [name],
+        body: {
+          ...schema,
+          // Examples are also displayed in Swagger UI
+          examples: Object.values(examples),
+        },
+      };
+    }
+    // POST /api/{name} -> render app with request.body as props
+    app.post(`/api/${name}`, routeOptions, async (request) => {
+      const component = await loadComponent(name);
+      const props = await runPropsHook(
+        app,
+        () => loadPropsHook(name),
+        request.body
+      );
+      return renderApp({ name, assets, component, project }, props);
+    });
+    for (const [exampleName, example] of Object.entries(examples)) {
+      // Validate examples against schema
+      if (schema && !validator.validate(schema, example)) {
+        app.log.error(
+          `Example "${exampleName}" of app "${name}" does not satisfy schema: ${validator.errorsText()}`
+        );
+      }
+      // GET /api/{name}/examples/{example} -> render a preview page
+      const exampleRoute = `/api/${name}/examples/${exampleName}`;
+      app.get(
+        exampleRoute,
+        {
+          schema: {
+            // Add clickable link to go to the example in Swagger UI
+            description: `Open sandbox: [${exampleRoute}](${exampleRoute})`,
+            // Place examples under the same tag as the app
+            tags: [name],
+          },
+        },
+        async (request, reply) => {
+          const component = await loadComponent(name);
+          const props = await runPropsHook(
+            app,
+            () => loadPropsHook(name),
+            example
+          );
+          const { html, assets: outAssets } = renderApp(
+            {
+              name,
+              assets,
+              component,
+              project,
+            },
+            props
+          );
+          reply.type('text/html');
+          return renderPreviewPage(html, outAssets, previewParts);
+        }
+      );
+    }
+  }
+}

package/server/utils.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import crypto from 'crypto';
+// Generate a random string ID 20 characters long
+export function randomId() {
+  return crypto.randomBytes(10).toString('hex');
+}

package/dist/server/parts/apps.js DELETED Viewed

@@ -1,37 +0,0 @@
-import path from 'path';
-import fs from 'fs/promises';
-import { loadAppAssets } from '../loaders/assets.js';
-import { loadAppExamples } from '../loaders/examples.js';
-import { loadAppSchema } from '../loaders/schema.js';
-import { loadAppManifest } from '../loaders/manifest.js';
-// Build the record of the available apps by convention
-// apps -> /apps/{name}/index.tsx
-// examples -> /apps/{name}/examples/{example}.json
-export async function loadApps(root, deployedStaticPath) {
-    const appsRoot = path.join(root, 'apps');
-    const manifest = await loadAppManifest(root);
-    const appsDirs = (await fs.readdir(appsRoot, { withFileTypes: true }))
-        .filter((d) => d.isDirectory())
-        .map((d) => d.name);
-    const apps = [];
-    for (const appDir of appsDirs) {
-        apps.push(await loadApp(appsRoot, appDir, manifest, deployedStaticPath));
-    }
-    return Object.fromEntries(apps);
-}
-async function loadApp(appsRoot, name, manifest, deployedStaticPath) {
-    // TODO: report problems with loading entries, assets and/or examples
-    const appRoot = path.join(appsRoot, name);
-    return [
-        name,
-        {
-            name,
-            root: appRoot,
-            entry: path.join(appRoot, 'index.tsx'),
-            propsHookEntry: path.join(appRoot, 'props.ts'),
-            assets: loadAppAssets(name, manifest, deployedStaticPath),
-            examples: await loadAppExamples(appRoot),
-            schema: await loadAppSchema(appRoot),
-        },
-    ];
-}

package/dist/server/parts/props-hook.d.ts DELETED Viewed

	@@ -1 +0,0 @@
1	- export declare function runPropsHook(props: unknown, loader: () => Promise<unknown>): Promise<Record<string, unknown>>;

package/dist/server/parts/props-hook.js DELETED Viewed

@@ -1,8 +0,0 @@
-export async function runPropsHook(props, loader) {
-    let module;
-    try {
-        module = (await loader());
-    }
-    catch { }
-    return (typeof module?.default === 'function' ? module.default(props) : props);
-}

package/dist/server/parts/runtime-hook.d.ts DELETED Viewed

	@@ -1,2 +0,0 @@
1	- import type { FastifyInstance } from 'fastify';
2	- export declare function runRuntimeHook(app: FastifyInstance, loader: () => Promise<unknown>): Promise<void>;

package/dist/server/parts/runtime-hook.js DELETED Viewed

@@ -1,28 +0,0 @@
-// Load the runtime hook module and run it if it exists, passing down our
-// fastify instance. This hook can be used to modify fastify settings, add
-// plugins or routes on an individual app level.
-export async function runRuntimeHook(app, loader) {
-    let module;
-    try {
-        module = (await loader());
-    }
-    catch { }
-    if (typeof module?.default === 'function') {
-        // If module exists and exports a default function, execute it and
-        // pass down the fastify instance
-        try {
-            await module.default(app);
-        }
-        catch (e) {
-            console.error('Failed to execute runtime hook', e);
-            process.exit(1);
-        }
-    }
-    else if (module) {
-        console.error("Runtime hook found, but doesn't export default function!");
-        process.exit(1);
-    }
-    else {
-        console.log('Runtime hook not found, skipping...');
-    }
-}

package/server/parts/apps.ts DELETED Viewed

@@ -1,59 +0,0 @@
-import path from 'path';
-import fs from 'fs/promises';
-import type { Manifest } from 'vite';
-import { loadAppAssets } from '../loaders/assets.js';
-import { loadAppExamples } from '../loaders/examples.js';
-import { loadAppSchema } from '../loaders/schema.js';
-import { loadAppManifest } from '../loaders/manifest.js';
-export type AppEntry = {
-  name: string;
-  root: string;
-  entry: string;
-  propsHookEntry: string;
-  assets: string[];
-  examples: Record<string, unknown>;
-  schema: Record<string, unknown> | null;
-};
-// Build the record of the available apps by convention
-// apps -> /apps/{name}/index.tsx
-// examples -> /apps/{name}/examples/{example}.json
-export async function loadApps(root: string, deployedStaticPath: string) {
-  const appsRoot = path.join(root, 'apps');
-  const manifest = await loadAppManifest(root);
-  const appsDirs = (await fs.readdir(appsRoot, { withFileTypes: true }))
-    .filter((d) => d.isDirectory())
-    .map((d) => d.name);
-  const apps: Array<[name: string, entry: AppEntry]> = [];
-  for (const appDir of appsDirs) {
-    apps.push(await loadApp(appsRoot, appDir, manifest, deployedStaticPath));
-  }
-  return Object.fromEntries(apps);
-}
-async function loadApp(
-  appsRoot: string,
-  name: string,
-  manifest: Manifest,
-  deployedStaticPath: string
-): Promise<[name: string, entry: AppEntry]> {
-  // TODO: report problems with loading entries, assets and/or examples
-  const appRoot = path.join(appsRoot, name);
-  return [
-    name,
-    {
-      name,
-      root: appRoot,
-      entry: path.join(appRoot, 'index.tsx'),
-      propsHookEntry: path.join(appRoot, 'props.ts'),
-      assets: loadAppAssets(name, manifest, deployedStaticPath),
-      examples: await loadAppExamples(appRoot),
-      schema: await loadAppSchema(appRoot),
-    },
-  ];
-}