@almadar/orb 0.2.0

package/shells/orb-shell/packages/server/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@almadar/shell-server",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/index.js",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@almadar/server": "^2.0.2",
+    "@almadar/evaluator": "^2.0.0",
+    "@almadar/core": "^2.1.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "firebase-admin": "^12.7.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@almadar/eslint-plugin": ">=2.3.0",
+    "@typescript-eslint/parser": "8.56.0",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/node": "^20.17.19",
+    "eslint": "10.0.0",
+    "esbuild": "^0.25.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
+  }
+}

package/shells/orb-shell/packages/server/src/app.ts

@@ -0,0 +1,36 @@
+/**
+ * Express Application Setup
+ */
+
+import express, { type Express } from 'express';
+import cors from 'cors';
+import {
+  env,
+  logger,
+  errorHandler,
+  notFoundHandler,
+  debugEventsRouter,
+} from '@almadar/server';
+import { registerRoutes } from './routes.js';
+
+export const app: Express = express();
+
+// Middleware
+app.use(cors({ origin: true, credentials: true }));
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+// 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/shells/orb-shell/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/shells/orb-shell/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/shells/orb-shell/packages/server/src/types/express.d.ts

@@ -0,0 +1,15 @@
+declare global {
+  namespace Express {
+    interface Request {
+      firebaseUser?: {
+        uid: string;
+        email?: string;
+        name?: string;
+        picture?: string;
+        [key: string]: unknown;
+      };
+    }
+  }
+}
+
+export {};

package/shells/orb-shell/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/shells/orb-shell/packages/shared/package-lock.json

@@ -0,0 +1,24 @@
+{
+  "name": "@app/shared",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@app/shared",
+      "version": "1.0.0",
+      "dependencies": {
+        "zod": "^3.22.0"
+      }
+    },
+    "node_modules/zod": {
+      "version": "3.25.76",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
+      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

package/shells/orb-shell/packages/shared/package.json

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

package/shells/orb-shell/packages/shared/src/index.ts

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