@rip-lang/server 1.3.7 → 1.3.9

package/api.rip

@@ -10,6 +10,7 @@
 #   Server:     start, startHandler, fetch, App
 #   Filters:    raw, before, after
 #   Handlers:   onError, notFound
+#   Errors:     error!, notice!, bail!
 #   Validation: read, validators, registerValidator, getValidator
 #   Context:    ctx, session, env, subrequest
 #   Utilities:  isBlank, toName, toPhone, mimeType
@@ -184,7 +185,7 @@ createContext = (req, params = {}) ->
             else n
         else parseInt(duration) or 0
       else 0
-      out.set 'Cache-Control', "public, max-age=#{seconds}"
+      out.set 'Cache-Control', "public, max-age=#{seconds}, immutable"
       return
 
     session: {}
@@ -271,8 +272,12 @@ smart = (fn) ->
     catch err
       status = err?.status or 500
       console.error 'Handler error:', err if status >= 500
-      message = err?.message or 'Internal Server Error'
-      new Response message, { status, headers: { 'Content-Type': 'text/plain' } }
+      if err?.notice
+        body = JSON.stringify { error: { notice: err.notice } }
+        new Response body, { status, headers: { 'Content-Type': 'application/json' } }
+      else
+        message = err?.message or 'Internal Server Error'
+        new Response message, { status, headers: { 'Content-Type': 'text/plain' } }
 
 # ==============================================================================
 # DSL: Route Registration
@@ -449,6 +454,23 @@ export session = new Proxy {},
 # Env proxy — access env.FOO anywhere (shortcut for process.env)
 export env = new Proxy {}, get: (_, key) -> process.env[key]
 
+# ==============================================================================
+# Error Helpers — Halt request with an HTTP error
+# ==============================================================================
+
+export error = (message = 'Bad request', status = 400) ->
+  throw Object.assign(new Error(message), { status })
+
+export notice = (message = 'Something went wrong', status = 400) ->
+  throw Object.assign(new Error(message), { status, notice: message })
+
+export bail = ->
+  store = requestContext.getStore()
+  if store?.env?.session?
+    for key of store.env.session
+      delete store.env.session[key]
+  throw Object.assign(new Error('Forbidden'), { status: 403 })
+
 # ==============================================================================
 # Utility Functions
 # ==============================================================================
@@ -607,7 +629,7 @@ export read = (name = null, type = null, miss = null) ->
   # missing value helper
   done = (must = false) ->
     return miss() if typeof miss is 'function'
-    throw new Error "Missing required field: #{name}" if must
+    throw Object.assign(new Error("Missing required field: #{name}"), { status: 400 }) if must
     return miss ?? null
 
   # get value from store

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rip-lang/server",
-  "version": "1.3.7",
+  "version": "1.3.9",
   "description": "Pure Rip web framework and application server",
   "type": "module",
   "main": "api.rip",