Function createOrpcServer

src/node/orpc/server.ts:740–1816

({
  host = "127.0.0.1",
  port = 0,
  authToken,
  context,
  serveStatic = false,
  allowHttpOrigin = false,
  // Default for non-bundled mode: from dist/node/orpc/, go up 2 levels to dist/.
  // In bundled mode (dist/runtime/), serverService computes the static dir.
  staticDir = path.join(__dirname, "../.."),
  onOrpcError = (error, options) => {
    // Auth failures are expected in browser mode while the user enters the token.
    // Avoid spamming error logs with stack traces on every unauthenticated request.
    if (error instanceof ORPCError && error.code === "UNAUTHORIZED") {
      log.debug("ORPC unauthorized request");
      return;
    }

    const formatted = formatOrpcError(error, options);
    log.error(formatted.message);

    if (log.isDebugMode()) {
      const suffix = Math.random().toString(16).slice(2);
      log.debug_obj(`orpc/${Date.now()}_${suffix}.json`, formatted.debugDump);
    }
  },
  router: existingRouter,
  desktopBridgeServer = context.desktopBridgeServer,
  browserBridgeServer = context.browserBridgeServer,
}: OrpcServerOptions)

 * Version: /version
 */
export async function createOrpcServer({
  host = "127.0.0.1",
  port = 0,
  authToken,
  context,
  serveStatic = false,
  allowHttpOrigin = false,
  // Default for non-bundled mode: from dist/node/orpc/, go up 2 levels to dist/.
  // In bundled mode (dist/runtime/), serverService computes the static dir.
  staticDir = path.join(__dirname, "../.."),
  onOrpcError = (error, options) => {
    // Auth failures are expected in browser mode while the user enters the token.
    // Avoid spamming error logs with stack traces on every unauthenticated request.
    if (error instanceof ORPCError && error.code === "UNAUTHORIZED") {
      log.debug("ORPC unauthorized request");
      return;
    }

    const formatted = formatOrpcError(error, options);
    log.error(formatted.message);

    if (log.isDebugMode()) {
      const suffix = Math.random().toString(16).slice(2);
      log.debug_obj(`orpc/${Date.now()}_${suffix}.json`, formatted.debugDump);
    }
  },
  router: existingRouter,
  desktopBridgeServer = context.desktopBridgeServer,
  browserBridgeServer = context.browserBridgeServer,
}: OrpcServerOptions): Promise<OrpcServer> {
  // Express app setup
  const app = express();
  app.use((req, res, next) => {
    const requestPath = splitRequestUrlPathAndQuery(req.url);
    if (requestPath && isValidUrlPathname(requestPath.pathname)) {
      const { basePath, routePathname } = stripAppProxyBasePath(requestPath.pathname);
      if (basePath) {
        setResponsePublicBasePath(res, basePath);
        req.url = `${routePathname}${requestPath.querySuffix}`;
        next();
        return;
      }
    }

    const publicBasePath = getRequestPublicBasePath(req);
    if (publicBasePath !== "/") {
      setResponsePublicBasePath(res, publicBasePath);
    }

    next();
  });

  app.use((req, res, next) => {
    if (!shouldEnforceOriginValidation(req)) {
      next();
      return;
    }