@almadar/shell 2.16.1 → 2.16.3

package/packages/server/src/app.ts

@@ -0,0 +1,41 @@
+/**
+ * Express Application Setup
+ */
+
+import express, { type Express } from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import rateLimit from 'express-rate-limit';
+import {
+  env,
+  logger,
+  errorHandler,
+  notFoundHandler,
+  debugEventsRouter,
+} from '@almadar/server';
+import { registerRoutes } from './routes.js';
+
+export const app: Express = express();
+
+// Middleware
+app.use(helmet());
+// CORS: env-driven allowlist (CORS_ORIGIN) — never reflect arbitrary origins with credentials.
+app.use(cors({ origin: env.CORS_ORIGIN, credentials: true }));
+app.use(express.json({ limit: '1mb' }));
+app.use(express.urlencoded({ extended: true, limit: '1mb' }));
+app.use('/api', rateLimit({ windowMs: 15 * 60 * 1000, max: 300, standardHeaders: true, legacyHeaders: false }));
+
+// Health check
+app.get('/health', (_req, res) => {
+  res.json({ status: 'ok' });
+});
+
+// Debug event bus endpoints (dev-only, no-op in production)
+app.use('/api/debug', debugEventsRouter());
+
+// Register generated routes
+registerRoutes(app);
+
+// Error handling
+app.use(notFoundHandler);
+app.use(errorHandler);

package/packages/server/src/index.ts

@@ -0,0 +1,30 @@
+/**
+ * Server Entry Point
+ */
+
+import { initializeFirebase, env, logger } from '@almadar/server';
+
+// Initialize Firebase before anything else uses it
+initializeFirebase();
+
+import { app } from './app.js';
+
+const PORT = env.PORT || 3030;
+
+async function start(): Promise<void> {
+  // Seed mock data when USE_MOCK_DATA is enabled
+  if (env.USE_MOCK_DATA) {
+    try {
+      const { initializeMockData } = await import(/* @vite-ignore */ './seedMockData.js' as string);
+      await initializeMockData();
+    } catch {
+      logger.warn('seedMockData.ts not found — skipping mock data seeding');
+    }
+  }
+
+  app.listen(PORT, () => {
+    logger.info(`Server running on port ${PORT}`);
+  });
+}
+
+start();

package/packages/server/src/routes.ts

@@ -0,0 +1,11 @@
+/**
+ * Route Registration
+ *
+ * Compiler generates route registration code here.
+ */
+
+import type { Express } from 'express';
+
+export function registerRoutes(app: Express): void {
+  // {{GENERATED_ROUTE_REGISTRATION}}
+}

package/packages/server/src/types/express.d.ts

@@ -0,0 +1,17 @@
+import type { EventPayloadValue } from '@almadar/core';
+
+declare global {
+  namespace Express {
+    interface Request {
+      firebaseUser?: {
+        uid: string;
+        email?: string;
+        name?: string;
+        picture?: string;
+        [key: string]: EventPayloadValue;
+      };
+    }
+  }
+}
+
+export {};

package/packages/server/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "strict": true,
+    "strictNullChecks": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@app/shared": ["../shared/src/index.ts"],
+      "@app/shared/*": ["../shared/src/*"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "src/**/__tests__/**", "src/**/*.test.ts", "src/**/*.spec.ts"]
+}

package/packages/shared/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@app/shared",
+  "version": "1.0.0",
+  "private": true,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "dependencies": {
+    "@almadar/core": "^7.14.3",
+    "zod": "^3.22.0"
+  }
+}

package/packages/shared/pnpm-lock.yaml

@@ -0,0 +1,22 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      zod:
+        specifier: ^3.22.0
+        version: 3.25.76
+
+packages:
+
+  zod@3.25.76:
+    resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
+
+snapshots:
+
+  zod@3.25.76: {}

package/packages/shared/src/index.ts

@@ -0,0 +1,2 @@
+// Placeholder — the compiler generates actual shared types here.
+export {};