Finish new with new package "@workadventure/map-starter-kit-core"

Author: gparant

README.md

@@ -24,53 +24,43 @@ Uploading a map using the [WA map storage](https://docs.workadventu.re/map-build
 
 ```
 map-starter-kit/
-├── 📁 app/                    # Server-side code (Node.js/Express)
-│   ├── app.ts                 # Main Express application
-│   └── controller/            # Express route controllers
-│       ├── FrontController.ts
-│       ├── MapController.ts
-│       └── UploaderController.ts
+├── 📁 app/                    # Server entry point (loads @workadventure/map-starter-kit-core)
+│   └── app.ts                 # Re-exports the Express app from the core package
 │
 ├── 📁 src/                    # Map scripts (Browser/WorkAdventure) ⚠️ REQUIRED
 │   └── main.ts                # Your map scripts go here
 │
-├── 📁 public/                 # Static assets (images, CSS, etc.)
-│   ├── assets/
-│   ├── images/
-│   └── styles.css
 │
 ├── 📁 tilesets/               # Map tileset images (PNG)
 │
 ├── 📄 *.tmj                   # Map files (office.tmj, conference.tmj, etc.)
-├── 📄 *.html                  # HTML pages (index.html, step1-git.html, etc.)
 ├── 📄 vite.config.ts          # Vite configuration
 └── 📄 package.json            # Dependencies and scripts
 ```
 
+The **server** (Express app, controllers, HTML publishing pages, static assets) is provided by the npm package **`@workadventure/map-starter-kit-core`**. Updating this dependency gives you new publishing UI and server features without changing your maps or config.
+
 ### Quick Reference
 
-- *`public/`*: Static files like PDFs or audio files
 - *`src/`*: **Map scripts** (MUST be here for compilation) ⚠️
 - *`tilesets/`*: All PNG tilesets
-- *`app/`*: **Server-side code** (Express.js backend)
+- *`app/`*: **Server entry point** – loads the core package; do not add server logic here
 
 > [!TIP]
 > - If you want to use more than one map file, just add the new map file in the root folder (we recommend creating a copy of *office.tmj* and editing it to avoid any mistakes).
 > - We recommend using **512x512** images for the map thumbnails.
-> - If you are going to create custom websites to embed in the map, please reference the HTML files in the `input` option in *vite.config.js*.
+> - If you are going to create custom websites to embed in the map, please reference the HTML files in the `input` option in *buildmap.vite.config.js*.
+
+### 📁 Server entry point (`app/`)
 
-### 📁 Server-side Development (`app/`)
+The `app/` directory contains only the **entry point** that loads the server from **`@workadventure/map-starter-kit-core`**.
 
-The `app/` directory contains the server-side Express.js application code. See [app/README.md](./app/README.md) for detailed documentation.
+- *`app.ts`*: Imports and re-exports the Express app from the core package (for Vite’s server plugin).
 
-- *`app.ts`*: Main Express application entry point
-- *`controller/`*: Express controllers for handling routes
-  - *`FrontController.ts`*: Handles frontend routes and HTML rendering
-  - *`MapController.ts`*: Handles map-related API endpoints
-  - *`UploaderController.ts`*: Handles map upload and configuration
+The actual server (Express, routes, HTML pages, upload, map storage) lives in the dependency. To get updates to the publishing UI and server behaviour, run `npm update @workadventure/map-starter-kit-core`.
 
 > [!IMPORTANT]
-> **Server-side code** should be placed in the `app/` directory. This code runs on the Node.js server and is not compiled by Vite for the browser.
+> Do **not** add server logic or new controllers in `app/`. The server is fully provided by the core package.
 
 ### 📁 Map Scripts Development (`src/`) ⚠️
 
@@ -109,7 +99,7 @@ The `src/` directory is where you **MUST** place **all map-related scripts** tha
 npm install
 ```
 
-This will install all required dependencies including Vite, TypeScript, WorkAdventure packages, and Express.js.
+This will install all required dependencies, including Vite, TypeScript, WorkAdventure packages, and **`@workadventure/map-starter-kit-core`** (server and publishing UI).
 
 ### 🚀 Development
 

app/README.md

@@ -1,123 +1,4 @@
-import express from 'express';
-import * as path from "node:path";
-import * as fs from "node:fs";
-import cors from 'cors';
-import { FrontController } from './controller/FrontController';
-import { MapController } from './controller/MapController';
-import { UploaderController } from './controller/UploaderController';
+import core from '@workadventure/map-starter-kit-core/dist/server.js';
 
-const app = express();
-
-const corsOptions = {
-    credentials: true, // Allow sending cookies
-    methods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS'],
-    allowedHeaders: [
-        'Content-Type',
-        'Authorization',
-        'X-Requested-With',
-        'Accept',
-        'Origin',
-        'Access-Control-Request-Method',
-        'Access-Control-Request-Headers'
-    ],
-    exposedHeaders: ['Content-Length', 'Content-Type'],
-    maxAge: 86400, // Cache the OPTIONS requests for 24 hours
-};
-
-// Apply the CORS middleware
-// The CORS middleware automatically handles the OPTIONS requests (preflight)
-app.use(cors(corsOptions));
-
-// Parse JSON bodies
-app.use(express.json());
-
-// Configure the static assets for Express
-const staticOptions = {
-    maxAge: '1d', // Cache the files for 1 day
-    etag: true, // Enable ETag for cache validation
-    lastModified: true, // Enable Last-Modified header
-};
-
-// Serve dist/assets FIRST with explicit MIME type configuration
-// This ensures compiled JavaScript files from getMapsScripts are served correctly
-// This route must be before express.static('.') to take precedence
-app.use('/assets', express.static(path.join(process.cwd(), 'dist', 'assets'), staticOptions));
-// Serve the public folder with a custom path
-app.use('/public', express.static(path.join(process.cwd(), 'public'), staticOptions));
-// Serve the tilesets folder with a longer cache (rarely modified)
-app.use('/tilesets', express.static(path.join(process.cwd(), 'tilesets'), {
-    maxAge: '7d',
-    etag: true,
-    lastModified: true,
-}));
-
-// Middleware to exclude /src from express.static - let Vite handle TypeScript transformation
-// VitePluginNode will automatically add Vite middleware that transforms TypeScript files
-const staticMiddleware = express.static('.', staticOptions);
-
-// Middleware to transform and serve TypeScript files as JavaScript
-// This bundles the file with its dependencies to resolve npm imports
-app.use('/src', async (req, res, next) => {
-    // Only handle .ts and .tsx files - transform them to JavaScript
-    if (req.path.endsWith('.ts') || req.path.endsWith('.tsx')) {
-        try {
-            // req.path includes /src/, so we need to join it correctly
-            const filePath = path.join(process.cwd(), 'src', req.path.startsWith('/') ? req.path.slice(1) : req.path);
-            
-            // Check if file exists
-            if (!fs.existsSync(filePath)) {
-                return res.status(404).send('File not found');
-            }
-            
-            // Use dynamic import to get esbuild (available via Vite)
-            const esbuild = await import('esbuild');
-            
-            // Bundle the TypeScript file with its dependencies
-            // This resolves npm imports like @workadventure/scripting-api-extra
-            const result = await esbuild.build({
-                entryPoints: [filePath],
-                bundle: true,
-                format: 'esm',
-                target: 'esnext',
-                write: false,
-                platform: 'browser',
-                sourcemap: false,
-                // Externalize WorkAdventure global API (available in the browser)
-                external: ['WA'],
-            });
-            
-            res.setHeader('Content-Type', 'application/javascript; charset=utf-8');
-            return res.send(result.outputFiles[0].text);
-        } catch (error) {
-            console.error('Error transforming TypeScript file:', error);
-            return next(error);
-        }
-    }
-    // For non-TypeScript files in /src, pass to next middleware
-    next();
-});
-
-// Serve static files, but skip /src (handled above)
-app.use((req, res, next) => {
-    // Skip /src requests - they are handled by the transformation middleware above
-    if (req.path.startsWith('/src/')) {
-        return next(); // Let the transformation middleware handle it or pass to Vite
-    }
-    // For other files, use express.static
-    staticMiddleware(req, res, next);
-});
-
-const controllers = [
-    new MapController(app),
-    new FrontController(app),
-    new UploaderController(app),
-];
-
-// Verify and log all controllers created
-controllers.forEach(controller => {
-    console.info(`Controller started: ${controller.constructor.name}`);
-});
-
-export default app;
-// Export for VitePluginNode compatibility
-export const viteNodeApp = app;
+export default core.default;
+export const viteNodeApp = core.viteNodeApp;