@callstack/repack-dev-server 5.0.0-rc.10 → 5.0.0-rc.11

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Callstack
+Copyright (c) 2025 Callstack
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,32 +1,27 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/callstack/repack/HEAD/logo.png">
-</p>
-<p align="center">
-A toolkit to build your React Native application with Rspack or Webpack.
-</p>
+<div align="center">
+  <img src="https://raw.githubusercontent.com/callstack/repack/HEAD/logo.png" width="650" alt="Re.Pack logo" />
+  <h3>A toolkit to build your React Native application with Rspack or Webpack.</h3>
+</div>
+<div align="center">
 
----
-
-[![Build Status][build-badge]][build]
-[![Version][version-badge]][version]
-[![MIT License][license-badge]][license]
+[![mit licence][license-badge]][license]
+[![npm downloads][npm-downloads-badge]][npm-downloads]
+[![Chat][chat-badge]][chat]
 [![PRs Welcome][prs-welcome-badge]][prs-welcome]
-[![Code of Conduct][coc-badge]][coc]
 
-`@callstack/repack-dev-sever` is bundler-agnostic development server for React Native applications as part of `@callstack/repack`.
+</div>
+
+`@callstack/repack-dev-server` is a bundler-agnostic development server for React Native applications as part of [`@callstack/repack`](https://github.com/callstack/repack).
 
 Check out our website at https://re-pack.dev for more info and documentation or out GitHub: https://github.com/callstack/repack.
 
 <!-- badges -->
 
-[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com&utm_medium=referral&utm_campaign=react-native-paper&utm_term=readme-with-love
-[build-badge]: https://img.shields.io/github/workflow/status/callstack/repack/CI/main?style=flat-square
-[build]: https://github.com/callstack/repack/actions/workflows/main.yml
-[version-badge]: https://img.shields.io/npm/v/@callstack/repack-dev-server?style=flat-square
-[version]: https://www.npmjs.com/package/@callstack/repack-dev-server
-[license-badge]: https://img.shields.io/npm/l/@callstack/repack-debugger-app?style=flat-square
-[license]: https://github.com/callstack/repack/blob/master/LICENSE
-[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square
+[license-badge]: https://img.shields.io/npm/l/@callstack/repack?style=for-the-badge
+[license]: https://github.com/callstack/repack/blob/main/LICENSE
+[npm-downloads-badge]: https://img.shields.io/npm/dm/@callstack/repack?style=for-the-badge
+[npm-downloads]: https://www.npmjs.com/package/@callstack/repack
+[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
 [prs-welcome]: ./CONTRIBUTING.md
-[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=flat-square
-[coc]: https://github.com/callstack/repack/blob/master/CODE_OF_CONDUCT.md
+[chat-badge]: https://img.shields.io/discord/426714625279524876.svg?style=for-the-badge
+[chat]: https://discord.gg/Q4yr2rTWYF

package/dist/createServer.js

@@ -11,6 +11,7 @@ import multipartPlugin from './plugins/multipart/multipartPlugin.js';
 import symbolicatePlugin from './plugins/symbolicate/sybmolicatePlugin.js';
 import wssPlugin from './plugins/wss/wssPlugin.js';
 import { Internal } from './types.js';
+import { normalizeOptions } from './utils/normalizeOptions.js';
 /**
  * Create instance of development server, powered by Fastify.
  *
@@ -20,9 +21,10 @@ import { Internal } from './types.js';
 export async function createServer(config) {
     // biome-ignore lint/style/useConst: needed in fastify constructor
     let delegate;
+    const options = normalizeOptions(config.options);
     /** Fastify instance powering the development server. */
     const instance = Fastify({
-        disableRequestLogging: !config.options.logRequests,
+        disableRequestLogging: options.disableRequestLogging,
         logger: {
             level: 'trace',
             stream: new Writable({
@@ -34,9 +36,10 @@ export async function createServer(config) {
                 },
             }),
         },
-        ...(config.options.https ? { https: config.options.https } : undefined),
+        ...(options.https ? { https: options.https } : {}),
     });
-    delegate = await config.delegate({
+    delegate = config.delegate({
+        options,
         log: instance.log,
         notifyBuildStart: (platform) => {
             instance.wss.apiServer.send({
@@ -58,8 +61,8 @@ export async function createServer(config) {
         },
     });
     const devMiddleware = createDevMiddleware({
-        projectRoot: config.options.rootDir,
-        serverBaseUrl: `http://${config.options.host}:${config.options.port}`,
+        projectRoot: options.rootDir,
+        serverBaseUrl: options.url,
         logger: instance.log,
         unstable_experiments: {
             // @ts-expect-error removed in 0.76, keep this for backkwards compatibility
@@ -70,11 +73,8 @@ export async function createServer(config) {
     await instance.register(fastifySensible);
     await instance.register(middie);
     await instance.register(wssPlugin, {
-        options: {
-            ...config.options,
-            endpoints: devMiddleware.websocketEndpoints,
-        },
         delegate,
+        endpoints: devMiddleware.websocketEndpoints,
     });
     await instance.register(multipartPlugin);
     await instance.register(apiPlugin, {
@@ -85,7 +85,7 @@ export async function createServer(config) {
         delegate,
     });
     await instance.register(devtoolsPlugin, {
-        options: config.options,
+        rootDir: options.rootDir,
     });
     await instance.register(symbolicatePlugin, {
         delegate,
@@ -95,7 +95,7 @@ export async function createServer(config) {
     await instance.register(faviconPlugin);
     instance.addHook('onSend', async (request, reply, payload) => {
         reply.header('X-Content-Type-Options', 'nosniff');
-        reply.header('X-React-Native-Project-Root', config.options.rootDir);
+        reply.header('X-React-Native-Project-Root', options.rootDir);
         const [pathname] = request.url.split('?');
         if (pathname.endsWith('.map')) {
             reply.header('Access-Control-Allow-Origin', 'devtools://devtools');
@@ -110,8 +110,8 @@ export async function createServer(config) {
     /** Start the development server. */
     async function start() {
         await instance.listen({
-            port: config.options.port,
-            host: config.options.host,
+            port: options.port,
+            host: options.host,
         });
     }
     /** Stop the development server. */

package/dist/plugins/devtools/devtoolsPlugin.d.ts

@@ -1,7 +1,6 @@
 import type { FastifyInstance } from 'fastify';
-import type { Server } from '../../types.js';
-declare function devtoolsPlugin(instance: FastifyInstance, { options }: {
-    options: Server.Options;
+declare function devtoolsPlugin(instance: FastifyInstance, { rootDir }: {
+    rootDir: string;
 }): Promise<void>;
 declare const _default: typeof devtoolsPlugin;
 export default _default;

package/dist/plugins/devtools/devtoolsPlugin.js

@@ -1,9 +1,9 @@
 import { openStackFrameInEditorMiddleware, openURLMiddleware, } from '@react-native-community/cli-server-api';
 import fastifyPlugin from 'fastify-plugin';
-async function devtoolsPlugin(instance, { options }) {
+async function devtoolsPlugin(instance, { rootDir }) {
     instance.use('/open-url', openURLMiddleware);
     instance.use('/open-stack-frame', openStackFrameInEditorMiddleware({
-        watchFolders: [options.rootDir],
+        watchFolders: [rootDir],
     }));
     instance.route({
         method: ['GET', 'POST', 'PUT'],

package/dist/plugins/wss/wssPlugin.d.ts

@@ -1,4 +1,5 @@
 import type { FastifyInstance } from 'fastify';
+import type { WebSocketServer } from 'ws';
 import type { Server } from '../../types.js';
 import { WebSocketRouter } from './WebSocketRouter.js';
 import { WebSocketServerAdapter } from './WebSocketServerAdapter.js';
@@ -21,9 +22,9 @@ declare module 'fastify' {
         };
     }
 }
-declare function wssPlugin(instance: FastifyInstance, { options, delegate, }: {
-    options: Server.Options;
+declare function wssPlugin(instance: FastifyInstance, { delegate, endpoints, }: {
     delegate: Server.Delegate;
+    endpoints?: Record<string, WebSocketServer>;
 }): Promise<void>;
 declare const _default: typeof wssPlugin;
 export default _default;

package/dist/plugins/wss/wssPlugin.js

@@ -12,7 +12,7 @@ import { WebSocketMessageServer } from './servers/WebSocketMessageServer.js';
  */
 const WS_DEVICE_URL = '/inspector/device';
 const WS_DEBUGGER_URL = '/inspector/debug';
-async function wssPlugin(instance, { options, delegate, }) {
+async function wssPlugin(instance, { delegate, endpoints, }) {
     const router = new WebSocketRouter(instance);
     const devClientServer = new WebSocketDevClientServer(instance);
     const messageServer = new WebSocketMessageServer(instance);
@@ -22,8 +22,8 @@ async function wssPlugin(instance, { options, delegate, }) {
     const apiServer = new WebSocketApiServer(instance);
     const hmrServer = new WebSocketHMRServer(instance, delegate.hmr);
     // @react-native/dev-middleware servers
-    const deviceConnectionServer = new WebSocketServerAdapter(instance, WS_DEVICE_URL, options.endpoints?.[WS_DEVICE_URL]);
-    const debuggerConnectionServer = new WebSocketServerAdapter(instance, WS_DEBUGGER_URL, options.endpoints?.[WS_DEBUGGER_URL]);
+    const deviceConnectionServer = new WebSocketServerAdapter(instance, WS_DEVICE_URL, endpoints?.[WS_DEVICE_URL]);
+    const debuggerConnectionServer = new WebSocketServerAdapter(instance, WS_DEBUGGER_URL, endpoints?.[WS_DEBUGGER_URL]);
     router.registerServer(devClientServer);
     router.registerServer(messageServer);
     router.registerServer(eventsServer);

package/dist/types.d.ts

@@ -1,11 +1,31 @@
+import type { ServerOptions as HttpsServerOptions } from 'node:https';
 import type { FastifyBaseLogger } from 'fastify';
-import type { WebSocketServer } from 'ws';
 import type { CompilerDelegate } from './plugins/compiler/types.js';
 import type { CodeFrame, InputStackFrame, ReactNativeStackFrame, StackFrame, SymbolicatorDelegate, SymbolicatorResults } from './plugins/symbolicate/types.js';
 import type { HmrDelegate } from './plugins/wss/types.js';
+import type { NormalizedOptions } from './utils/normalizeOptions.js';
 export type { CompilerDelegate };
 export type { CodeFrame, InputStackFrame, ReactNativeStackFrame, StackFrame, SymbolicatorDelegate, SymbolicatorResults, };
 export type { HmrDelegate };
+export interface DevServerOptions {
+    /**
+     * Hostname or IP address under which to run the development server.
+     * Can be 'local-ip', 'local-ipv4', 'local-ipv6' or a custom string.
+     * When left unspecified, it will listen on all available network interfaces.
+     */
+    host?: 'local-ip' | 'local-ipv4' | 'local-ipv6' | string;
+    /** Port under which to run the development server. */
+    port?: number;
+    /** Whether to enable Hot Module Replacement. */
+    hot?: boolean;
+    /** Options for running the server as HTTPS. If `undefined`, the server will run as HTTP. */
+    server?: 'http' | 'https' | {
+        type: 'http';
+    } | {
+        type: 'https';
+        options?: HttpsServerOptions;
+    };
+}
 export declare namespace Server {
     /** Development server configuration. */
     interface Config {
@@ -15,25 +35,9 @@ export declare namespace Server {
         delegate: (context: DelegateContext) => Delegate;
     }
     /** Development server options. */
-    interface Options {
+    interface Options extends DevServerOptions {
         /** Root directory of the project. */
         rootDir: string;
-        /** Port under which to run the development server. */
-        port: number;
-        /**
-         * Hostname or IP address under which to run the development server.
-         * When left unspecified, it will listen on all available network interfaces, similarly to listening on '0.0.0.0'.
-         */
-        host?: string;
-        /** Options for running the server as HTTPS. If `undefined`, the server will run as HTTP. */
-        https?: {
-            /** Path to certificate when running server as HTTPS. */
-            cert?: string;
-            /** Path to certificate key when running server as HTTPS. */
-            key?: string;
-        };
-        /** Additional endpoints with pre-configured servers */
-        endpoints?: Record<string, WebSocketServer>;
         /** Whether to enable logging requests. */
         logRequests?: boolean;
     }
@@ -60,6 +64,8 @@ export declare namespace Server {
      * Allows to emit logs, notify about compilation events and broadcast events to connected clients.
      */
     interface DelegateContext {
+        /** Normalized development server options. */
+        options: NormalizedOptions;
         /** A logger instance, useful for emitting logs from the delegate. */
         log: FastifyBaseLogger;
         /** Send notification about compilation start for given `platform`. */

package/dist/utils/normalizeOptions.d.ts

@@ -0,0 +1,12 @@
+import type { ServerOptions as HttpsServerOptions } from 'node:https';
+import type { Server } from '../types.js';
+export interface NormalizedOptions {
+    host: string;
+    port: number;
+    https: HttpsServerOptions | undefined;
+    hot: boolean;
+    url: string;
+    disableRequestLogging: boolean;
+    rootDir: string;
+}
+export declare function normalizeOptions(options: Server.Options): NormalizedOptions;

package/dist/utils/normalizeOptions.js

@@ -0,0 +1,28 @@
+function normalizeHttpsOptions(serverOptions) {
+    if (serverOptions &&
+        typeof serverOptions === 'object' &&
+        serverOptions.type === 'https') {
+        return serverOptions.options;
+    }
+    return undefined;
+}
+export function normalizeOptions(options) {
+    const host = options.host ?? 'localhost';
+    const port = options.port ?? 8081;
+    const https = normalizeHttpsOptions(options.server);
+    const hot = options.hot ?? false;
+    const protocol = https ? 'https' : 'http';
+    const url = `${protocol}://${host}:${options.port}`;
+    return {
+        // webpack dev server compatible options
+        host,
+        port,
+        https,
+        hot,
+        url,
+        // fastify options
+        disableRequestLogging: !options.logRequests,
+        // project options
+        rootDir: options.rootDir,
+    };
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@callstack/repack-dev-server",
   "description": "A bundler-agnostic development server for React Native applications as part of @callstack/repack.",
   "license": "MIT",
-  "version": "5.0.0-rc.10",
+  "version": "5.0.0-rc.11",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",