#oboard/mocket

#Quick Start

moon run src/main/main.mbt --target js

#Usage

#Features

#Dynamic Routes

app.get("/hello/:name", fn(event) {
  let name = event.params.get("name").or("World")
  "Hello, \{name}!"
})

#Wildcard Routes

// Single wildcard - matches one path segment
app.get("/hello/*", fn(event) {
  let name = event.params.get("_").or("World")
  "Hello, \{name}!"
})

// Double wildcard - matches multiple path segments
app.get("/hello/**", fn(event) {
  let path = event.params.get("_").or("")
  "Hello, \{path}!"
})

#Async Support

• readFile: Asynchronously read files
• readDir: Asynchronously read directories
• exec: Asynchronously execute commands
• fetch: Asynchronously make HTTP requests

#Async /GET Example

// async json data example
app.get("/async_data", async fn(event) {
  { "name": "John Doe", "age": 30, "city": "New York" }
})

run_async(fn() {
  try {
    let result = @mocket.exec!!("ls")
    println(result)
  } catch {
    err => println("Error executing command: \{err}")
  }
})
run_async(fn() {
  try {
    let response = @mocket.fetch!!("https://api64.ipify.org/")
    println(response)
  } catch {
    err => println("Error fetching data: \{err}")
  }
})

#Error Handling

• readFile: Returns Bytes!Error
• exec: Returns String!Error
• fetch: Returns FetchResponse!NetworkError

#Example usage

fn main {
  let app = @mocket.new()

  // Text Response
  app.get("/", _event => "⚡️ Tadaa!")

  // JSON Response
  app.get("/json", _event => {
    "name": "John Doe",
    "age": 30,
    "city": "New York",
  })

  // Async Response
  app.get("/async_data", async fn(_event) {
    { "name": "John Doe", "age": 30, "city": "New York" }
  })

  // Dynamic Routes
  app.get("/hello/:name", fn(event) {
    let name = event.params.get("name").or("World")
    "Hello, \{name}!"
  })

  // Wildcard Routes
  app.get("/hello/*", fn(event) {
    let name = event.params.get("_").or("World")
    "Hello, \{name}!"
  })

  app.get("/hello/**", fn(event) {
    let path = event.params.get("_").or("")
    "Hello, \{path}!"
  })

  // Echo Server
  app.post("/echo", e => e.req.body.to_json())

  // 404 Page
  app.get("/404", e => {
    e.res.statusCode = 404
    @mocket.html(
      #|<html>
      #|<body>
      #|  <h1>404</h1>
      #|</body>
      #|</html>
      ,
    )
  })

  // Serve
  app.serve(port=4000)

  // Print Server URL
  println("http://localhost:4000")
}

#Route Matching Examples