Build a Serverless REST API

1import { defineApp, api, storage, queue } from "novaserve";
2
3export const app = defineApp({
4  name: "order-management-service",
5  region: "us-east-1",
6});
7
8// 1. Storage bucket for order receipts
9export const orderStorage = storage("order-receipts-bucket", {
10  public: false,
11});
12
13// 2. Message queue for async order processing
14export const orderQueue = queue("order-processing-queue");
15
16// 3. Health check endpoint
17export const healthApi = api.get("/health", async () => {
18  return {
19    status: "healthy",
20    timestamp: new Date().toISOString(),
21    version: "1.0.0",
22  };
23});
24
25// 4. Create order endpoint
26export const createOrderApi = api.post("/api/v1/orders", async (req) => {
27  const body = await req.json();
28
29  if (!body.customerEmail || !body.items?.length) {
30    return new Response(
31      JSON.stringify({ error: "Missing customerEmail or items" }),
32      { status: 400 }
33    );
34  }
35
36  const orderId = `ord-${Date.now()}`;
37  const orderPayload = {
38    orderId,
39    customerEmail: body.customerEmail,
40    items: body.items,
41    createdAt: new Date().toISOString(),
42  };
43
44  // Store receipt in object storage
45  await orderStorage.put(
46    `receipts/${orderId}.json`,
47    JSON.stringify(orderPayload)
48  );
49
50  // Dispatch to processing queue
51  await orderQueue.push({
52    event: "ORDER_CREATED",
53    orderId,
54    customerEmail: body.customerEmail,
55  });
56
57  return { status: 201, orderId };
58});

nova dev

curl http://localhost:3000/health

curl -X POST http://localhost:3000/api/v1/orders \
  -H "Content-Type: application/json" \
  -d '{"customerEmail": "user@example.com", "items": [{"id": "item-1", "price": 49.99}]}'

nova deploy --target aws