Initial version (#1)

Co-authored-by: Julien Valverdé <julien.valverde@mailo.com>
Reviewed-on: #1

packages/server/.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

packages/server/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@website/server",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "lint:tsc": "tsc --noEmit",
+    "bun:dev": "NODE_ENV=development bun --hot ./src/entrypoint.bun.ts",
+    "bun:build": "esbuild ./src/entrypoint.bun.ts --outdir=./dist --bundle --minify --format=esm --sourcemap --platform=node",
+    "bun:start": "NODE_ENV=production bun ./dist/entrypoint.bun.js",
+    "node:dev": "NODE_ENV=development tsx --watch ./src/entrypoint.node.ts",
+    "node:build": "esbuild ./src/entrypoint.node.ts --outdir=./dist --bundle --minify --format=esm --sourcemap --platform=node",
+    "node:start": "NODE_ENV=production node --enable-source-maps ./dist/entrypoint.node.js",
+    "clean:dist": "rm -rf dist",
+    "clean:modules": "rm -rf node_modules"
+  },
+  "dependencies": {
+    "@effect/opentelemetry": "^0.56.6",
+    "@effect/platform": "^0.90.9",
+    "@effect/platform-bun": "^0.79.0",
+    "@effect/platform-node": "^0.96.1",
+    "@effect/rpc": "^0.69.2",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.205.0",
+    "@opentelemetry/sdk-metrics": "^2.1.0",
+    "@opentelemetry/sdk-trace-base": "^2.1.0",
+    "@opentelemetry/sdk-trace-node": "^2.1.0",
+    "@opentelemetry/sdk-trace-web": "^2.1.0",
+    "@website/common": "workspace:*",
+    "effect": "^3.17.13"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.9",
+    "tsx": "^4.20.5"
+  }
+}

packages/server/src/config/ServerConfig.ts

@@ -0,0 +1,10 @@
+import { Config, Schema } from "effect"
+
+
+export const mode = Schema.Config("NODE_ENV",
+    Schema.compose(Schema.String, Schema.Literal("development", "production"))
+).pipe(
+    Config.withDefault("development")
+)
+
+export const httpPort = Config.withDefault(Config.port("SERVER_HTTP_PORT"), 80)

packages/server/src/config/index.ts

@@ -0,0 +1 @@
+export * as ServerConfig from "./ServerConfig"

packages/server/src/entrypoint.bun.ts

@@ -0,0 +1,17 @@
+import { BunContext, BunHttpServer, BunRuntime } from "@effect/platform-bun"
+import { Effect, Layer } from "effect"
+import { ServerConfig } from "./config"
+import { Server } from "./server"
+
+
+Layer.launch(Server).pipe(
+    Effect.provide(Layer.empty.pipe(
+        Layer.provideMerge(ServerConfig.httpPort.pipe(
+            Effect.map(port => BunHttpServer.layer({ port })),
+            Layer.unwrapEffect,
+        )),
+        Layer.provideMerge(BunContext.layer),
+    )),
+
+    BunRuntime.runMain,
+)

packages/server/src/entrypoint.node.ts

@@ -0,0 +1,18 @@
+import { NodeContext, NodeHttpServer, NodeRuntime } from "@effect/platform-node"
+import { Effect, Layer } from "effect"
+import { createServer } from "node:http"
+import { ServerConfig } from "./config"
+import { Server } from "./server"
+
+
+Layer.launch(Server).pipe(
+    Effect.provide(Layer.empty.pipe(
+        Layer.provideMerge(ServerConfig.httpPort.pipe(
+            Effect.map(port => NodeHttpServer.layer(createServer, { port })),
+            Layer.unwrapEffect,
+        )),
+        Layer.provideMerge(NodeContext.layer),
+    )),
+
+    NodeRuntime.runMain,
+)

packages/server/src/http.ts

@@ -0,0 +1,66 @@
+import { FileSystem, HttpMiddleware, HttpRouter, HttpServer, HttpServerRequest, HttpServerResponse, Path } from "@effect/platform"
+import { RpcServer } from "@effect/rpc"
+import { CommonConfig } from "@website/common/config"
+import { WebRpc, WebRpcSerializationDevelopment, WebRpcSerializationProduction } from "@website/common/webrpc"
+import { Duration, Effect, flow, Layer } from "effect"
+import { WebRpcLive } from "./webrpc"
+
+
+const router = HttpRouter.empty
+
+const makeWebRpcRoute = Effect.all([
+    CommonConfig.webRpcHttpPath,
+    RpcServer.toHttpApp(WebRpc),
+]).pipe(
+    Effect.map(([path, app]) => HttpRouter.mountApp(path, app)),
+    Effect.provide(WebRpcLive),
+)
+
+const makeProductionWebappMiddleware = Effect.gen(function*() {
+    const path = yield* Path.Path
+    const fs = yield* FileSystem.FileSystem
+    const dist = path.join(yield* path.fromFileUrl(new URL(".", import.meta.resolve("@website/webapp"))), "dist")
+
+    return () => Effect.gen(function*() {
+        const req = yield* HttpServerRequest.HttpServerRequest
+        const source = path.join(dist, req.url)
+        const isValid = yield* fs.stat(source).pipe(
+            Effect.andThen(stat => stat.type === "File"),
+            Effect.catchAll(() => Effect.succeed(false)),
+        )
+
+        return yield* HttpServerResponse.setHeader(
+            yield* HttpServerResponse.file(isValid ? source : path.join(dist, "index.html")),
+            "Cache-Control",
+            `public, max-age=${Duration.toSeconds("365 days")}, immutable`
+        )
+    })
+})
+
+
+export const HttpAppDevelopment = Effect.provide(makeWebRpcRoute, WebRpcSerializationDevelopment).pipe(
+    Effect.map(serveWebRpc => router.pipe(
+        serveWebRpc,
+        HttpServer.serve(flow(
+            HttpMiddleware.logger,
+            HttpMiddleware.xForwardedHeaders,
+        )),
+        HttpServer.withLogAddress,
+    )),
+
+    Layer.unwrapScoped,
+)
+
+export const HttpAppProduction = Effect.all([
+    Effect.provide(makeWebRpcRoute, WebRpcSerializationProduction),
+    makeProductionWebappMiddleware,
+]).pipe(
+    Effect.map(([serveWebRpc, serveProductionWebapp]) => router.pipe(
+        serveWebRpc,
+        serveProductionWebapp,
+        HttpServer.serve(HttpMiddleware.xForwardedHeaders),
+        HttpServer.withLogAddress,
+    )),
+
+    Layer.unwrapScoped,
+)

packages/server/src/server.ts

@@ -0,0 +1,31 @@
+import { NodeSdk } from "@effect/opentelemetry"
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http"
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base"
+import { Effect, flow, Layer, Logger, Match } from "effect"
+import { ServerConfig } from "./config"
+import { HttpAppDevelopment, HttpAppProduction } from "./http"
+
+
+const ServerDevelopment = Layer.empty.pipe(
+    Layer.provideMerge(NodeSdk.layer(() => ({
+        resource: { serviceName: "server" },
+        spanProcessor: new BatchSpanProcessor(new OTLPTraceExporter({ url: "http://tempo:4318/v1/traces" }))
+    }))),
+    Layer.provideMerge(HttpAppDevelopment),
+)
+
+const ServerProduction = Layer.empty.pipe(
+    Layer.provideMerge(HttpAppProduction),
+)
+
+export const Server = ServerConfig.mode.pipe(
+    Effect.map(flow(
+        Match.value,
+        Match.when("development", () => ServerDevelopment),
+        Match.when("production", () => ServerProduction),
+        Match.exhaustive,
+    )),
+
+    Layer.unwrapEffect,
+    Layer.provideMerge(Logger.pretty),
+)

packages/server/src/webrpc/WebRpcTestLive.ts

@@ -0,0 +1,9 @@
+import { WebRpcTest } from "@website/common/webrpc"
+import { Effect, Layer } from "effect"
+
+
+export const PingV1Live = WebRpcTest.WebRpcTest.toLayerHandler("Test.PingV1", Effect.succeed(() => Effect.succeed("pong" as const)))
+
+export const WebRpcTestLive = Layer.mergeAll(
+    PingV1Live,
+) satisfies ReturnType<typeof WebRpcTest.WebRpcTest.toLayer>

packages/server/src/webrpc/index.ts

@@ -0,0 +1,10 @@
+import type { WebRpc } from "@website/common/webrpc"
+import { Layer } from "effect"
+import * as WebRpcTestLive from "./WebRpcTestLive"
+
+
+export const WebRpcLive = Layer.mergeAll(
+    WebRpcTestLive.WebRpcTestLive,
+) satisfies ReturnType<typeof WebRpc.toLayer>
+
+export * as WebRpcTestLive from "./WebRpcTestLive"

packages/server/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false,
+
+    "plugins": [
+      { "name": "@effect/language-service" }
+    ]
+  }
+}