@rip-lang/api 0.7.6 → 0.8.0

package/README.md

@@ -39,12 +39,12 @@ before ->
   session.views ?= 0
   session.views += 1
 
-get '/', -> 'Hello, World!'
-get '/json', -> { message: 'It works!', timestamp: Date.now() }
-get '/users/:id', -> { user: { id: read('id', 'id!') } }
-get '/session', -> { views: session.views, loggedIn: session.userId? }
-get '/login', -> session.userId = 123; { loggedIn: true, userId: 123 }
-get '/logout', -> delete session.userId; { loggedOut: true }
+get '/' -> 'Hello, World!'
+get '/json' -> { message: 'It works!', timestamp: Date.now() }
+get '/users/:id' -> { user: { id: read('id', 'id!') } }
+get '/session' -> { views: session.views, loggedIn: session.userId? }
+get '/login' -> session.userId = 123; { loggedIn: true, userId: 123 }
+get '/logout' -> delete session.userId; { loggedOut: true }
 
 start port: 3000
 ```
@@ -99,17 +99,19 @@ bun add @rip-lang/api
 import { get, post, use, read, start } from '@rip-lang/api'
 
 # Context-free handlers — just return data!
-get '/', -> 'Hello, World!'
+# Note: In Rip, the comma after a string/regex is optional when immediately
+# followed by an arrow function. So `get '/', ->` can be `get '/' ->`
+get '/' -> 'Hello, World!'
 
-get '/json', -> { message: 'It works!', timestamp: Date.now() }
+get '/json' -> { message: 'It works!', timestamp: Date.now() }
 
 # Path parameters
-get '/users/:id', ->
+get '/users/:id' ->
   id = read 'id', 'id!'
   { user: { id, name: "User #{id}" } }
 
 # Form validation
-post '/signup', ->
+post '/signup' ->
   email = read 'email', 'email!'
   phone = read 'phone', 'phone'
   age   = read 'age', 'int', [18, 120]
@@ -122,6 +124,7 @@ start port: 3000
 
 ```coffee
 # Access full context for headers, redirects, etc.
+# Note: Comma IS needed when there's a parameter between the path and arrow
 get '/download/:id', (env) ->
   env.header 'Content-Disposition', 'attachment'
   env.body getFile!(read 'id', 'id!')
@@ -280,31 +283,31 @@ code = read 'postal', 'postalCode!'
 ```coffee
 import { get, post, put, patch, del, all } from '@rip-lang/api'
 
-get    '/users',     -> listUsers!
-post   '/users',     -> createUser!
-get    '/users/:id', -> getUser!
-put    '/users/:id', -> updateUser!
-patch  '/users/:id', -> patchUser!
-del    '/users/:id', -> deleteUser!
-all    '/health',    -> 'ok'  # All methods
+get    '/users'     -> listUsers!
+post   '/users'     -> createUser!
+get    '/users/:id' -> getUser!
+put    '/users/:id' -> updateUser!
+patch  '/users/:id' -> patchUser!
+del    '/users/:id' -> deleteUser!
+all    '/health'    -> 'ok'  # All methods
 ```
 
 ### Path Parameters
 
 ```coffee
 # Basic parameters
-get '/users/:id', ->
+get '/users/:id' ->
   id = read 'id', 'id!'
   { id }
 
 # Multiple parameters
-get '/users/:userId/posts/:postId', ->
+get '/users/:userId/posts/:postId' ->
   userId = read 'userId', 'id!'
   postId = read 'postId', 'id!'
   { userId, postId }
 
 # Custom patterns
-get '/files/:name{[a-z]+\\.txt}', ->
+get '/files/:name{[a-z]+\\.txt}' ->
   name = read 'name'
   { file: name }
 
@@ -318,12 +321,12 @@ get '/static/*', (env) ->
 ```coffee
 import { prefix } from '@rip-lang/api'
 
-prefix '/api/v1', ->
-  get '/users', -> listUsers!
-  get '/posts', -> listPosts!
+prefix '/api/v1' ->
+  get '/users' -> listUsers!
+  get '/posts' -> listPosts!
 
-prefix '/api/v2', ->
-  get '/users', -> listUsersV2!
+prefix '/api/v2' ->
+  get '/users' -> listUsersV2!
 ```
 
 ## Middleware
@@ -386,14 +389,14 @@ before ->
   session.views ?= 0
   session.views += 1
 
-get '/profile', ->
+get '/profile' ->
   { userId: session.userId, views: session.views }
 
-get '/login', ->
+get '/login' ->
   session.userId = 123
   { loggedIn: true }
 
-get '/logout', ->
+get '/logout' ->
   delete session.userId
   { loggedOut: true }
 ```
@@ -488,7 +491,7 @@ after ->
 ```coffee
 import { get, read, session } from '@rip-lang/api'
 
-get '/profile', ->
+get '/profile' ->
   id = read 'id', 'id!'     # Works anywhere
   { id, user: session.userId }  # No @ needed
 ```
@@ -496,7 +499,7 @@ get '/profile', ->
 **Note:** In nested callbacks, use fat arrow `=>` to preserve `@`:
 
 ```coffee
-get '/delayed', ->
+get '/delayed' ->
   @user = 'alice'
   setTimeout =>           # Fat arrow preserves @
     console.log @user     # Works!
@@ -505,59 +508,55 @@ get '/delayed', ->
 
 ## Context Object
 
-When you need full control, handlers receive a context object:
+Use `@` to access the context directly — no parameter needed:
 
 ### Response Helpers
 
 ```coffee
-get '/demo', (c) ->
+get '/demo' ->
   # JSON response
-  c.json { data: 'value' }
-  c.json { data: 'value' }, 201  # With status
-  c.json { data: 'value' }, 200, { 'X-Custom': 'header' }
+  @json { data: 'value' }
+  @json { data: 'value' }, 201  # With status
+  @json { data: 'value' }, 200, { 'X-Custom': 'header' }
 
   # Text response
-  c.text 'Hello'
-  c.text 'Created', 201
+  @text 'Hello'
+  @text 'Created', 201
 
   # HTML response
-  c.html '<h1>Hello</h1>'
+  @html '<h1>Hello</h1>'
 
   # Redirect
-  c.redirect '/new-location'
-  c.redirect '/new-location', 301  # Permanent
+  @redirect '/new-location'
+  @redirect '/new-location', 301  # Permanent
 
   # Raw body
-  c.body data, 200, { 'Content-Type': 'application/octet-stream' }
+  @body data, 200, { 'Content-Type': 'application/octet-stream' }
 ```
 
 ### Request Helpers
 
 ```coffee
-get '/info', (c) ->
-  # Path parameters
-  id = c.req.param 'id'
-  allParams = c.req.param()
-
-  # Query parameters
-  q = c.req.query 'q'
-  allQuery = c.req.query()
+get '/info' ->
+  # Path and query parameters — use read() for validation!
+  id = read 'id', 'id!'
+  q  = read 'q'  # Raw value; use 'string' validator to collapse whitespace
 
   # Headers
-  auth = c.req.header 'Authorization'
-  allHeaders = c.req.header()
+  auth = @req.header 'Authorization'
+  allHeaders = @req.header()
 
   # Body (async)
-  json = c.req.json!
-  text = c.req.text!
-  form = c.req.formData!
-  parsed = c.req.parseBody!
+  json = @req.json!
+  text = @req.text!
+  form = @req.formData!
+  parsed = @req.parseBody!
 
   # Raw request
-  c.req.raw     # Native Request object
-  c.req.method  # 'GET', 'POST', etc.
-  c.req.url     # Full URL
-  c.req.path    # Path only
+  @req.raw     # Native Request object
+  @req.method  # 'GET', 'POST', etc.
+  @req.url     # Full URL
+  @req.path    # Path only
 ```
 
 ### Request-Scoped State
@@ -571,7 +570,7 @@ use (c, next) ->
   @startTime = Date.now()
   await next()
 
-get '/profile', ->
+get '/profile' ->
   @json @user
 ```
 
@@ -640,7 +639,7 @@ logRequest = ->
   console.log "#{c.req.method} #{c.req.path}" if c
 
 # Works in callbacks, helpers, anywhere during request
-get '/demo', ->
+get '/demo' ->
   logRequest()
   { ok: true }
 ```

package/api.rip

@@ -294,6 +294,8 @@ export fetch = (req) ->
         data = c.req.json!
       else if ct =~ /x-www-form-urlencoded|form-data/i
         data = c.req.parseBody!
+        keys = Object.keys(data)
+        data = { body: keys[0] } if keys.length is 1 and data[keys[0]] is ''
       else if ct =~ /text\//i
         data = { body: c.req.text! }
   catch
@@ -315,7 +317,7 @@ runHandler = (c, handler) ->
     if _errorHandler?
       _errorHandler.call!(c, err, c)
     else
-      new Response err?.message or 'Internal Server Error', { status: 500 }
+      new Response err?.message or 'Internal Server Error', { status: err?.status or 500 }
 
 # ==============================================================================
 # Server Startup
@@ -443,8 +445,8 @@ export validators =
   text:      (v) -> v.replace(/  +/g, ' ')
 
   # Name/address
-  name:      (v) -> v.replace(/\s+/g, ' ').trim()
-  address:   (v) -> v.replace(/\s+/g, ' ').trim()
+  name:      (v) -> v.replace(/\s+/g, ' ')
+  address:   (v) -> v.replace(/\s+/g, ' ')
 
   # Time & date
   time:      (v) -> v[/^([01]?\d|2[0-3]):[0-5]\d(:[0-5]\d)?$/] and _[0]
@@ -454,7 +456,7 @@ export validators =
   # Booleans
   truthy:    (v) -> (v =~ /^(true|t|1|yes|y|on)$/i)  and true
   falsy:     (v) -> (v =~ /^(false|f|0|no|n|off)$/i) and true
-  bool:      (v) -> (v =~ /^(true|t|1|yes|y|on|false|f|0|no|n|off)$/i) and (v =~ /^(true|t|1|yes|y|on)$/i)
+  bool:      (v) -> if v =~ /^(true|t|1|yes|y|on)$/i then true else if v =~ /^(false|f|0|no|n|off)$/i then false else null
 
   # Contact, geo, identity
   email:     (v) -> v[/^([a-zA-Z0-9._%+-]+)@([a-zA-Z0-9.-]+\.[a-zA-Z]{2,})$/] and _[0]
@@ -516,17 +518,15 @@ export read = (keyOrTag = null, tagOrMiss = null, missOrNil = null) ->
   tag  = null
   miss = null
 
-  if keyOrTag? and (tagOrMiss? or missOrNil isnt null)
-    key  = keyOrTag
-    tag  = tagOrMiss
-    miss = missOrNil
-  else
-    key  = null
-    tag  = keyOrTag
-    miss = tagOrMiss
+  [key, tag, miss] = typeof keyOrTag is 'string' \
+    ? [keyOrTag, tagOrMiss, missOrNil]           \
+    : [null    , keyOrTag , tagOrMiss]
 
   raw = if key? then data[key] else data
-  return raw unless tag?
+  unless tag?
+    return raw if raw?
+    return miss() if typeof miss is 'function'
+    return if miss? and miss isnt '' then miss else null
 
   required = false
   if typeof tag is 'string' and tag.endsWith('!')
@@ -534,6 +534,7 @@ export read = (keyOrTag = null, tagOrMiss = null, missOrNil = null) ->
     tag = tag.slice(0, -1)
 
   v = raw
+  v = v.trim() if typeof v is 'string'
 
   # Named validator
   if typeof tag is 'string'
@@ -562,7 +563,7 @@ export read = (keyOrTag = null, tagOrMiss = null, missOrNil = null) ->
 
   # Regex
   else if tag instanceof RegExp
-    v = String(v or '')[tag] or null
+    v = String(v or '').match(tag)?[0] or null
 
   # Object constraints
   else if typeof tag is 'object'
@@ -592,6 +593,6 @@ export read = (keyOrTag = null, tagOrMiss = null, missOrNil = null) ->
     else
       return miss?() if typeof miss is 'function'
       return null if miss is '' or not miss?  # Empty string or null/undefined → null
-      miss  # Return 0, false, etc. as-is
+      return miss  # Return 0, false, etc. as-is
 
   v

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rip-lang/api",
-  "version": "0.7.6",
+  "version": "0.8.0",
   "description": "Pure Rip API framework — elegant, fast, zero dependencies",
   "type": "module",
   "main": "api.rip",