@rip-lang/api 0.7.7 → 0.8.1

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]
@@ -506,92 +508,81 @@ export getValidator      = (name)     -> validators[name]
 # read() — Sinatra-style Parameter Reading
 # ==============================================================================
 
-export read = (keyOrTag = null, tagOrMiss = null, missOrNil = null) ->
-  store = requestContext.getStore()
-  unless store?
-    throw new Error 'read() called outside request context'
-
-  data = store.data or {}
-  key  = 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
+export read = (name = null, type = null, miss = null) ->
+  store = requestContext.getStore() or throw new Error 'no context for read()'
+
+  # missing value helper
+  done = (must = false) ->
+    return miss() if typeof miss is 'function'
+    throw new Error "Missing required field: #{name}" if must
+    return miss ?? null
+
+  # get value from store
+  v = store.data or {}
+  v = v[name] if name?
+  v = v.trim() if typeof v is 'string'
 
-  raw = if key? then data[key] else data
-  return raw unless tag?
+  # value only, no validator
+  if !type?
+    return v if v?
+    return done()
 
-  required = false
-  if typeof tag is 'string' and tag.endsWith('!')
-    required = true
-    tag = tag.slice(0, -1)
+  # String: apply validator function
+  else if typeof type is 'string'
 
-  v = raw
+    # detect required value (trailing '!')
+    if type.endsWith '!'
+      must = true
+      type = type.slice(0, -1)
 
-  # Named validator
-  if typeof tag is 'string'
-    fn = getValidator(tag)
-    v = if fn then fn(String(v or '')) else null
+    # apply validator function
+    f = getValidator(type)
+    v = String(v ?? '') unless type in ['array', 'hash', 'json']
+    v = if f then f(v) else null
+
+  # Regex: apply regex pattern
+  else if type instanceof RegExp
+    s = String(v ?? '')
+    v = s.match(type)?[0] or null
 
   # Array: [min, max] constraint or enumeration
-  else if Array.isArray(tag)
-    if typeof tag[0] is 'number'
-      minVal = tag[0]
-      maxVal = tag[1]
-      if typeof v is 'number' or (String(v) =~ /^[-+]?\d+$/)
-        n = if typeof v is 'number' then v else parseInt(String(v))
-        ok = not isNaN(n)
-        ok = false if minVal? and n < minVal
-        ok = false if maxVal? and n > maxVal
-        v = if ok then n else null
+  else if Array.isArray(type)
+    s = String(v ?? '')
+    y = true
+    if typeof type[0] is 'number'
+      [min, max] = type
+      if typeof v is 'number' or (s =~ /^[-+]?\d+$/)
+        n = if typeof v is 'number' then v else +s
+        y = false if min? and n < min
+        y = false if max? and n > max
+        v = if y then n else null
       else
-        s = String(v or '')
-        ok = true
-        ok = false if minVal? and s.length < minVal
-        ok = false if maxVal? and s.length > maxVal
-        v = if ok then s else null
+        y = false if min? and s.length < min
+        y = false if max? and s.length > max
+        v = if y then s else null
     else
-      v = if tag.includes(String(v)) then String(v) else null
-
-  # Regex
-  else if tag instanceof RegExp
-    v = String(v or '')[tag] or null
-
-  # Object constraints
-  else if typeof tag is 'object'
-    if tag.start? or tag.end?
-      n = parseInt(v)
-      v = if not isNaN(n) and (not tag.start? or n >= tag.start) and (not tag.end? or n <= tag.end) then n else null
-    else if tag.min? or tag.max?
-      if typeof v is 'number' or (String(v or '') =~ /^[-+]?\d+$/)
-        n = if typeof v is 'number' then v else parseInt(String(v))
-        ok = not isNaN(n)
-        ok = false if tag.min? and n < tag.min
-        ok = false if tag.max? and n > tag.max
-        v = if ok then n else null
+      v = if type.includes(s) then s else null
+
+  # Object: start/end, min/max
+  else if type? and typeof type is 'object'
+    s = String(v ?? '')
+    if type.start? or type.end?
+      n = if s =~ /^[-+]?\d+$/ then +s else NaN
+      v = if not isNaN(n) and (not type.start? or n >= type.start) and (not type.end? or n <= type.end) then n else null
+    else if type.min? or type.max?
+      y = true
+      if typeof v is 'number' or (s =~ /^[-+]?\d+$/)
+        n = if typeof v is 'number' then v else +s
+        y = false if type.min? and n < type.min
+        y = false if type.max? and n > type.max
+        v = if y then n else null
       else
-        s = String(v or '')
-        ok = true
-        ok = false if tag.min? and s.length < tag.min
-        ok = false if tag.max? and s.length > tag.max
-        v = if ok then s else null
-
-  blank = v is null or v is undefined or (typeof v is 'string' and v.trim() is '')
-
-  if blank
-    if required
-      return miss?() if typeof miss is 'function'
-      throw new Error "Missing required field: #{key}"
-    else
-      return miss?() if typeof miss is 'function'
-      return null if miss is '' or not miss?  # Empty string or null/undefined → null
-      return miss  # Return 0, false, etc. as-is
+        y = false if type.min? and s.length < type.min
+        y = false if type.max? and s.length > type.max
+        v = if y then s else null
+
+  # blank / missing value handling
+  if not v? or (typeof v is 'string' and v.trim() is '')
+    return done(must)
 
   v

package/package.json

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