create-caspian-app 0.3.0-rc.2 → 0.3.0-rc.21

package/dist/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "my-app"
+name = "caspian-app"
 version = "1.0.0"
 requires-python = ">=3.14"
 dependencies = []

package/dist/settings/bs-config.json

@@ -1,7 +1,7 @@
-{
-  "local": "http://localhost:5090",
-  "external": "http://172.18.64.1:5090",
-  "ui": "http://localhost:3001",
-  "uiExternal": "http://172.18.64.1:3001",
-  "backend": "http://localhost:5091"
+{
+  "local": "http://localhost:5091",
+  "external": "http://192.168.1.109:5091",
+  "ui": "http://localhost:3003",
+  "uiExternal": "http://192.168.1.109:3003",
+  "backend": "http://localhost:5201"
 }

package/dist/settings/bs-config.ts

@@ -8,6 +8,7 @@ import { DebouncedWorker, createSrcWatcher, DEFAULT_AWF } from "./utils.js";
 import {
   startPythonServer,
   restartPythonServer,
+  stopPythonServer,
   waitForPort,
 } from "./python-server.js";
 import { componentMap } from "./component-map.js";
@@ -25,6 +26,7 @@ const PUBLIC_ROOT = join(WORKSPACE_ROOT, PUBLIC_DIR);
 const PUBLIC_IGNORE_DIRS = ["uploads"];
 let previousRouteFiles: string[] = [];
 let lastChangedFile: string | null = null;
+let shuttingDown = false;
 
 let pythonPort = 0;
 let bsPort = 0;
@@ -173,7 +175,9 @@ const pipeline = new DebouncedWorker(
       if (isReady && bs.active) {
         bs.reload();
       } else {
-        console.error(chalk.red("⚠ Server failed to start or timed out."));
+        console.error(
+          chalk.red("Warning: Server failed to start or timed out."),
+        );
       }
       return;
     }
@@ -199,7 +203,7 @@ const pipeline = new DebouncedWorker(
       if (previousRouteFiles.length > 0 && routesChanged) {
         console.log(
           chalk.yellow(
-            "→ Structure changed (New/Deleted file), restarting Python server...",
+            "-> Structure changed (New/Deleted file), restarting Python server...",
           ),
         );
         await restartPythonServer(pythonPort, bsPort);
@@ -238,13 +242,48 @@ function isIgnoredPublicPath(absPath: string): boolean {
 
 const publicPipeline = new DebouncedWorker(
   async () => {
-    console.log(chalk.cyan("→ Public directory changed, reloading browser..."));
+    console.log(
+      chalk.cyan("-> Public directory changed, reloading browser..."),
+    );
     if (bs.active) bs.reload();
   },
   350,
   "bs-public-pipeline",
 );
 
+type ClosableWatcher = {
+  close: () => Promise<void>;
+};
+
+const sourceWatchers: ClosableWatcher[] = [];
+
+async function closeWatchers(): Promise<void> {
+  await Promise.all(
+    sourceWatchers.splice(0).map(async (watcher) => {
+      try {
+        await watcher.close();
+      } catch {}
+    }),
+  );
+}
+
+async function shutdown(exitCode: number): Promise<void> {
+  if (shuttingDown) {
+    return;
+  }
+
+  shuttingDown = true;
+
+  await closeWatchers();
+
+  if (bs.active) {
+    bs.exit();
+  }
+
+  stopPythonServer();
+  process.exit(exitCode);
+}
+
 (async () => {
   const reservedPorts = getReservedPorts();
 
@@ -253,77 +292,90 @@ const publicPipeline = new DebouncedWorker(
 
   updateRouteFilesCache();
 
-  createSrcWatcher(join(SRC_DIR, "**", "*"), {
-    onEvent: (_ev, _abs, rel) => {
-      if (rel.includes("__pycache__") || rel.endsWith(".pyc")) return;
-      lastChangedFile = rel;
-      pipeline.schedule(rel);
-    },
-    awaitWriteFinish: DEFAULT_AWF,
-    logPrefix: "watch-src",
-    usePolling: true,
-    interval: 1000,
-  });
+  sourceWatchers.push(
+    createSrcWatcher(join(SRC_DIR, "**", "*"), {
+      onEvent: (_ev, _abs, rel) => {
+        if (rel.includes("__pycache__") || rel.endsWith(".pyc")) return;
+        lastChangedFile = rel;
+        pipeline.schedule(rel);
+      },
+      awaitWriteFinish: DEFAULT_AWF,
+      logPrefix: "watch-src",
+      usePolling: true,
+      interval: 1000,
+    }),
+  );
 
-  createSrcWatcher(join(PUBLIC_DIR, "**", "*"), {
-    onEvent: (_ev, abs, _) => {
-      const relFromPublic = relative(PUBLIC_ROOT, abs).replace(/\\/g, "/");
-      if (isIgnoredPublicPath(abs)) return;
-      publicPipeline.schedule(relFromPublic);
-    },
-    awaitWriteFinish: DEFAULT_AWF,
-    logPrefix: "watch-public",
-    usePolling: true,
-    interval: 1000,
-  });
+  sourceWatchers.push(
+    createSrcWatcher(join(PUBLIC_DIR, "**", "*"), {
+      onEvent: (_ev, abs, _) => {
+        const relFromPublic = relative(PUBLIC_ROOT, abs).replace(/\\/g, "/");
+        if (isIgnoredPublicPath(abs)) return;
+        publicPipeline.schedule(relFromPublic);
+      },
+      awaitWriteFinish: DEFAULT_AWF,
+      logPrefix: "watch-public",
+      usePolling: true,
+      interval: 1000,
+    }),
+  );
 
   const viteFlagFile = join(__dirname, "..", ".casp", ".vite-build-complete");
   mkdirSync(dirname(viteFlagFile), { recursive: true });
   if (!existsSync(viteFlagFile)) writeFileSync(viteFlagFile, "0");
 
-  createSrcWatcher(viteFlagFile, {
-    onEvent: (ev) => {
-      if (ev === "change" && bs.active) {
-        bs.reload();
-      }
-    },
-    awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
-    logPrefix: "watch-vite",
-    usePolling: true,
-    interval: 500,
-  });
+  sourceWatchers.push(
+    createSrcWatcher(viteFlagFile, {
+      onEvent: (ev) => {
+        if (ev === "change" && bs.active) {
+          bs.reload();
+        }
+      },
+      awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+      logPrefix: "watch-vite",
+      usePolling: true,
+      interval: 500,
+    }),
+  );
 
-  createSrcWatcher(join(__dirname, "..", "utils", "**", "*.py"), {
-    onEvent: async (_ev, _abs, _) => {
-      if (_abs.includes("__pycache__")) return;
-      await restartPythonServer(pythonPort, bsPort);
-      const isReady = await waitForPort(pythonPort);
-      if (isReady && bs.active) bs.reload();
-    },
-    awaitWriteFinish: DEFAULT_AWF,
-    logPrefix: "watch-utils",
-    usePolling: true,
-    interval: 1000,
-  });
+  sourceWatchers.push(
+    createSrcWatcher(join(__dirname, "..", "utils", "**", "*.py"), {
+      onEvent: async (_ev, _abs, _) => {
+        if (_abs.includes("__pycache__")) return;
+        await restartPythonServer(pythonPort, bsPort);
+        const isReady = await waitForPort(pythonPort);
+        if (isReady && bs.active) bs.reload();
+      },
+      awaitWriteFinish: DEFAULT_AWF,
+      logPrefix: "watch-utils",
+      usePolling: true,
+      interval: 1000,
+    }),
+  );
 
-  createSrcWatcher(join(__dirname, "..", "main.py"), {
-    onEvent: async (_ev, _abs, _) => {
-      if (_abs.includes("__pycache__")) return;
-      await restartPythonServer(pythonPort, bsPort);
-      const isReady = await waitForPort(pythonPort);
-      if (isReady && bs.active) bs.reload();
-    },
-    awaitWriteFinish: DEFAULT_AWF,
-    logPrefix: "watch-main",
-    usePolling: true,
-    interval: 1000,
-  });
+  sourceWatchers.push(
+    createSrcWatcher(join(__dirname, "..", "main.py"), {
+      onEvent: async (_ev, _abs, _) => {
+        if (_abs.includes("__pycache__")) return;
+        await restartPythonServer(pythonPort, bsPort);
+        const isReady = await waitForPort(pythonPort);
+        if (isReady && bs.active) bs.reload();
+      },
+      awaitWriteFinish: DEFAULT_AWF,
+      logPrefix: "watch-main",
+      usePolling: true,
+      interval: 1000,
+    }),
+  );
 
   startPythonServer(pythonPort, bsPort);
 
   bs.init(
     {
-      proxy: `http://localhost:${pythonPort}`,
+      proxy: {
+        target: `http://localhost:${pythonPort}`,
+        ws: true,
+      },
       port: bsPort,
       online: true,
       middleware: [
@@ -356,7 +408,7 @@ const publicPipeline = new DebouncedWorker(
       const uiExtUrl = urls.get("ui-external");
 
       console.log("");
-      console.log(chalk.green.bold("✔ Ports Configured:"));
+      console.log(chalk.green.bold("OK Ports Configured:"));
       console.log(
         `  ${chalk.blue.bold("Frontend (BrowserSync):")} ${chalk.magenta(localUrl)}`,
       );
@@ -394,3 +446,21 @@ const publicPipeline = new DebouncedWorker(
     },
   );
 })();
+
+process.once("SIGINT", () => {
+  void shutdown(0);
+});
+
+process.once("SIGTERM", () => {
+  void shutdown(0);
+});
+
+process.once("uncaughtException", (error) => {
+  console.error(error);
+  void shutdown(1);
+});
+
+process.once("unhandledRejection", (reason) => {
+  console.error(reason);
+  void shutdown(1);
+});

package/dist/settings/component-map.ts

@@ -981,7 +981,7 @@ function analyzeFile(filePath: string, rootDir: string): ComponentMetadata[] {
 
 function loadConfig(): CaspianConfig {
   if (!fs.existsSync(CONFIG_PATH)) {
-    console.error(`❌ Configuration file not found at: ${CONFIG_PATH}`);
+    console.error(`Error: Configuration file not found at: ${CONFIG_PATH}`);
     process.exit(1);
   }
   return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf-8"));
@@ -1024,7 +1024,7 @@ function walkDirectory(
  */
 
 export async function componentMap() {
-  console.log(`🔍 Starting Component Analysis (Lezer AST-first)...`);
+  console.log("Starting Component Analysis (Lezer AST-first)...");
   const config = loadConfig();
   let allFiles: string[] = [];
 
@@ -1036,7 +1036,7 @@ export async function componentMap() {
     );
   });
 
-  console.log(`📂 Found ${allFiles.length} Python files.`);
+  console.log(`Found ${allFiles.length} Python files.`);
   const componentRegistry: ComponentMetadata[] = [];
 
   allFiles.forEach((file) => {
@@ -1044,15 +1044,15 @@ export async function componentMap() {
       const foundComponents = analyzeFile(file, PROJECT_ROOT);
       componentRegistry.push(...foundComponents);
     } catch (e) {
-      console.warn(`⚠️ Failed to parse ${file}:`, e);
+      console.warn(`Warning: Failed to parse ${file}:`, e);
     }
   });
 
-  console.log(`✅ Discovered ${componentRegistry.length} Components.`);
+  console.log(`Discovered ${componentRegistry.length} Components.`);
 
   const outputPath = path.join(__dirname, "component-map.json");
   if (componentRegistry.length > 0 || !fs.existsSync(outputPath)) {
     fs.writeFileSync(outputPath, JSON.stringify(componentRegistry, null, 2));
-    console.log(`📝 Component map written to: ${outputPath}`);
+    console.log(`Component map written to: ${outputPath}`);
   }
 }

package/dist/settings/python-server.ts

@@ -17,7 +17,7 @@ function getVenvPythonPath(): string {
     : join(".venv", "bin", "python");
 
   if (!existsSync(venvPython)) {
-    console.warn(`⚠ Virtual environment not found, using system python`);
+    console.warn("Warning: Virtual environment not found, using system python");
     return isWindows() ? "python" : "python3";
   }
   return venvPython;
@@ -118,7 +118,7 @@ function spawnPython(port: number, browserSyncPort?: number): ChildProcess {
   const pythonPath = getVenvPythonPath();
   const args = ["-u", "main.py"];
 
-  console.log(`→ Starting Python server on port ${port}...`);
+  console.log(`-> Starting Python server on port ${port}...`);
 
   const env = {
     ...process.env,
@@ -156,7 +156,7 @@ export async function restartPythonServer(
   isRestarting = true;
 
   try {
-    console.log("→ Restarting Python server...");
+    console.log("-> Restarting Python server...");
     const prev = pythonProcess;
     pythonProcess = null;
 
@@ -171,18 +171,8 @@ export async function restartPythonServer(
   }
 }
 
-export function stopPythonServer(): void {
-  const prev = pythonProcess;
-  pythonProcess = null;
-  if (prev) killProcessTree(prev);
-}
-
-process.on("exit", () => stopPythonServer());
-process.on("SIGINT", () => {
-  stopPythonServer();
-  process.exit(0);
-});
-process.on("SIGTERM", () => {
-  stopPythonServer();
-  process.exit(0);
-});
+export function stopPythonServer(): void {
+  const prev = pythonProcess;
+  pythonProcess = null;
+  if (prev) killProcessTree(prev);
+}

package/dist/settings/utils.ts

@@ -109,7 +109,7 @@ export class DebouncedWorker {
   ) {}
 
   schedule(reason?: string) {
-    if (reason) console.log(`[${this.name}] ${reason} → scheduled`);
+    if (reason) console.log(`[${this.name}] ${reason} -> scheduled`);
     if (this.timer) clearTimeout(this.timer);
     this.timer = setTimeout(() => {
       this.timer = null;
@@ -203,7 +203,7 @@ export function createRestartableProcess(spec: {
   async function stop(): Promise<void> {
     if (!child || child.killed) return;
     const pid = child.pid!;
-    console.log(`[${name}] Stopping…`);
+    console.log(`[${name}] Stopping...`);
 
     if (process.platform === "win32" && windowsKillTree) {
       await killOnWindows(pid);
@@ -245,7 +245,7 @@ export function createRestartableProcess(spec: {
 
 export function onExit(fn: () => Promise<void> | void) {
   const wrap = (sig: string) => async () => {
-    console.log(`[proc] Received ${sig}, shutting down…`);
+    console.log(`[proc] Received ${sig}, shutting down...`);
     try {
       await fn();
     } finally {

package/dist/src/lib/auth/auth_config.py

@@ -26,7 +26,7 @@ def build_auth_settings() -> AuthSettings:
         # This app-owned starter config begins public-first; switch to True only when most routes require auth.
         # Use all-private mode when only a few routes should stay public.
         is_all_routes_private=False,
-        public_routes=["/"],
+        public_routes=["/", "/health"],
         # Sign-in and signup stay public by default; only change this when the app explicitly needs it.
         auth_routes=["/signin", "/signup"],
         private_routes=[],  # unused when all-routes-private is True

package/dist/src/lib/mcp/mcp_server.py

@@ -14,13 +14,13 @@ FILES_LIST_PATH = PROJECT_ROOT / "settings" / "files-list.json"
 COMPONENT_MAP_PATH = PROJECT_ROOT / "settings" / "component-map.json"
 
 
-mcp = FastMCP(
-    name="Mapka MCP",
-    instructions=(
-        "Read-only workspace metadata for the Mapka Caspian application. "
-        "Use these tools for project configuration, generated file inventory, and component discovery."
-    ),
-)
+mcp = FastMCP(
+    name="Caspian MCP",
+    instructions=(
+        "Read-only workspace metadata for the Caspian application. "
+        "Use these tools for project configuration, generated file inventory, and component discovery."
+    ),
+)
 
 
 def _load_json(path: Path, fallback: Any) -> Any:
@@ -88,4 +88,4 @@ def component_inventory() -> dict[str, Any]:
     return {
         "count": len(components),
         "components": components,
-    }
+    }

package/dist/src/lib/websocket/websocket_security.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+from collections.abc import MutableMapping
+from datetime import datetime, timezone
+from typing import Any
+
+from fastapi import WebSocket
+
+
+def get_websocket_session(websocket: WebSocket) -> MutableMapping[str, Any]:
+    session = getattr(websocket, "session", None)
+    if isinstance(session, MutableMapping):
+        return session
+
+    scope_session = websocket.scope.get("session")
+    if isinstance(scope_session, MutableMapping):
+        return scope_session
+
+    return {}
+
+
+def get_authenticated_payload_from_session(
+    session: MutableMapping[str, Any],
+    auth_instance: Any,
+) -> dict[str, Any] | None:
+    payload_key = getattr(auth_instance, "PAYLOAD_SESSION_KEY", "")
+    payload_name = getattr(auth_instance, "PAYLOAD_NAME", "")
+
+    payload_wrapper = session.get(payload_key)
+    if not isinstance(payload_wrapper, dict):
+        return None
+
+    exp = payload_wrapper.get("exp")
+    if exp is not None:
+        try:
+            if float(exp) < datetime.now(timezone.utc).timestamp():
+                session.pop(payload_key, None)
+                return None
+        except Exception:
+            session.pop(payload_key, None)
+            return None
+
+    payload = payload_wrapper.get(payload_name)
+    if payload is None:
+        session.pop(payload_key, None)
+        return None
+
+    if isinstance(payload, dict):
+        if getattr(getattr(auth_instance, "settings", None), "token_auto_refresh", False):
+            refreshed_wrapper = dict(payload_wrapper)
+            refreshed_wrapper["exp"] = auth_instance._calculate_expiration(
+                auth_instance.settings.default_token_validity
+            )
+            session[payload_key] = refreshed_wrapper
+        return payload
+
+    return {"value": payload}
+
+
+class WebSocketConnectionManager:
+    def __init__(self) -> None:
+        self._connections: set[WebSocket] = set()
+
+    async def connect(self, websocket: WebSocket) -> None:
+        await websocket.accept()
+        self._connections.add(websocket)
+
+    def disconnect(self, websocket: WebSocket) -> None:
+        self._connections.discard(websocket)
+
+    async def broadcast_json(self, payload: dict[str, Any]) -> None:
+        stale: list[WebSocket] = []
+        for websocket in list(self._connections):
+            try:
+                await websocket.send_json(payload)
+            except RuntimeError:
+                stale.append(websocket)
+
+        for websocket in stale:
+            self.disconnect(websocket)
+
+
+websocket_connections = WebSocketConnectionManager()
+public_websocket_connections = WebSocketConnectionManager()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-caspian-app",
-  "version": "0.3.0-rc.2",
+  "version": "0.3.0-rc.21",
   "description": "Scaffold a new Caspian project (FastAPI-powered reactive Python framework).",
   "main": "dist/index.js",
   "type": "module",