naider 1.24.4 → 2.0.0

package/SPEC-X.nx

@@ -1,276 +0,0 @@
--- ============================================
--- NAIDE-X Language Specification
--- ~80% fewer tokens than JavaScript
--- AI-only readability. Maximum generation speed.
--- ============================================
--- Rule: first char of line = intent
---   > return    ? if       | elif     : else
---   @ loop      * while    ! try      !! catch   !!! ensure
---   $ server    ^ model    < import   % match   X patch
---   f func      ~f async   + export
---   s:i:n:b:l:m:a: typed vars
---   ~ await     ~~ await.all
--- ============================================
-
--- Types: s=str i=int n=num b=bool l=list m=map a=any
-s:name="hello"
-i:count=42
-n:price=9.99
-b:active=true
-l:items=[1,2,3]
-m:cfg={host:"localhost",port:3000}
-a:data=null
-
--- Mutable: ~ prefix
-~i:counter=0
-~s:label="init"
-
--- String interpolation: "{expr}" (double quotes)
-s:greet="Hello {name}, count is {count}"
-
--- Functions: f name(TYPE:param,...)RETTYPE
-f add(i:a,i:b)i
-  >a+b
-
-f sayHi(s:who)
-  log"Hi {who}"
-
-f greet2(s:name,s:prefix="Hello")
-  log"{prefix}, {name}!"
-
--- Async: ~f
-~f fetchUser(s:id)m
-  a:res=~fetch("/api/users/{id}")
-  a:data=~res.json()
-  >data
-
--- Return: >
--- Return with status: >.s CODE BODY
-
--- If/elif/else: ? | :
-?count>10
-  log"many"
-|count>5
-  log"some"
-:
-  log"few"
-
--- Inline ternary (same as NAIDE v1)
--- s:size=if count>10 then "big" else "small"
-
--- Each: @var<collection
-@item<items
-  log item
-
--- Each with key: @key,val<collection
-@k,v<cfg
-  log"{k}: {v}"
-
--- For range: @var<start..end
-@i<0..10
-  log i
-
--- While: *condition
-*active
-  log"running"
-  active=false
-
--- Match: %value
-s:status="ok"
-%status
-  "ok": log "success"
-  "error": log "failed"
-  _: log "unknown"
-
--- Try/catch/ensure: ! / !!var / !!!
-~f safe(s:url)m
-  !
-    a:data=~fetch(url)
-    >{ok:true,data:data}
-  !!e
-    log.e"fail: {e.message}"
-    >{ok:false,error:e.message}
-  !!!
-    log"request done"
-
--- typeof / instanceof
-?typeof x=="string"
-  log"is string"
-?err instanceof TypeError
-  log"type error"
-
--- Pipe: |> (same)
-l:result=[1,2,3,4,5]
-  |>filter((x)=>x>2)
-  |>map((x)=>x*10)
-
--- Model: ^Name
-^User
-  s:name
-  s:email
-  i:age=0
-  f greet()s
-    >"Hi, I'm {self.name}"
-  ~f save()
-    log"Saving {self.name}..."
-
--- Inheritance: ^Child<Parent
-^Admin<User
-  s:role="admin"
-  f perms()l
-    >["read","write","delete"]
-
--- DB persistence: db "path/"
-db "data/"
-
--- SQL database: db.sql "driver" "connection"
--- db.sql "sqlite" "app.db"
--- db.sql "postgres" "postgresql://localhost/mydb"
-
--- Environment variables
-env:
-  PORT int default(3000)
-  JWT_SECRET str required
-
--- Schema: types + modifiers
-schema User:
-  id auto
-  name str required min(2) max(50)
-  email str required email unique
-  role enum("admin","user") default("user")
-  joined timestamp auto
-
--- Server with high-level features
-$app:PORT
-  cors "*"
-  auth JWT_SECRET:
-    protect "/api/*"
-    public "/api/auth/*"
-  limit "/api/*" 100 "1m"
-  static "/public"
-  crud "/api/users" User
-  cookie
-  session JWT_SECRET
-  cache "/api/*" "5m"
-  view "./views"
-  sse "/events"
-  upload "/api/upload" "avatar" (req,res):
-    >{file:req.file.filename}
-  -- Route middleware: [mid1, mid2]
-  G"/admin"[authCheck](req,res)
-    >{admin:true}
-  P"/api/secure"[auth,logger](req,res)
-    >req.body
-  group "/api/v1":
-    G"/status"
-      >{version:"1.0"}
-  G"/"
-    >.h "<h1>Welcome</h1>"
-  P"/api/auth/register"(req,res)
-    s:hashed=hash(req.body.password)
-    user=UserStore.create({...req.body,password:hashed})
-    token=auth.sign({id:user.id})
-    >{token,user}
-  P"/api/auth/login"(req,res)
-    user=UserStore.where({email:req.body.email})[0]
-    ?not user
-      >.s 401 {error:"Invalid credentials"}
-    ?not verify(req.body.password,user.password)
-      >.s 401 {error:"Invalid credentials"}
-    token=sign({id:user.id})
-    >{token}
-  ws "/chat":
-    on "connect":
-      send({type:"welcome"})
-    on "message" (data):
-      broadcast(data)
-
--- Error handler
-  error (err, req, res):
-    log.e err.message
-    >.s 500 {error:"Internal error"}
-
--- HTTP client (auto-imported)
--- api.get(url) api.post(url,body) api.put(url,body) api.del(url) api.raw(url,opts)
-
--- Return helpers
--- >expr         → JSON
--- >.s CODE expr → status code
--- >.r "/path"   → redirect
--- >.h "<html>"  → HTML
--- >.t "text"    → plain text
--- >.f "/file"   → send file
--- >.d "/file"   → download
--- >.v "tmpl" {} → render template
-
--- Built-in functions (auto-imported)
--- uuid()                → UUID
--- hash("password")      → scrypt hash
--- verify("pw",hashed)   → verify
--- sign({id:1})          → JWT (uses auth secret)
--- sign({id:1},"secret") → JWT (explicit)
-
--- Validate: auto-validate POST/PUT/PATCH bodies
---   validate "/api/users" User
-
--- Test (node:test)
-test "math":
-  assert 1+1==2
-  assert 2*3==6
-
--- Queue (async job queue)
-queue jobs:
-  job "notify" (data):
-    log data.msg
-
--- OpenAPI: auto-generate spec from schemas
---   openapi "/docs"
-
--- AI / LLM integration (auto-imported, zero-dep)
--- s:answer=~ai.ask("Explain NAIDE")
--- m:result=~ai.json("List 3 colors",{colors:["string"]})
--- s:reply=~ai.chat(msgs)
--- s:a=~ai.ask("hi",{model:"gpt-4o",maxTokens:100})
--- Streaming: ~f main(): @chunk<~ai.stream("poem") ...
--- Embed: l:vec=~ai.embed("hello")
--- Similarity: n:score=ai.similarity(a,b)
-
--- Prompt template
--- prompt summarize {lang:"en"}:
---   "Summarize in {lang}: {text}"
-
--- Inter-file import (.naide/.nx → .mjs auto-rewrite)
--- <{handler}"./routes.naide"
-
--- Scheduled tasks
-every "5m":
-  log"cleanup"
-
--- Event watch
-watch User.create (event):
-  log"new: {event.data.name}"
-
--- Import: <module or <{names}"module"
--- <express
--- <{readFile,writeFile}"fs/promises"
-
--- Export: + prefix
-+f helper()s
-  >"exported"
-+s:VER="1.0.0"
-
--- Log: log, log.e, log.w, log.i, log.d
-log"info"
-log.e"error"
-log.w"warning"
-log.i"info level"
-log.d"debug level"
-
--- Null safe: ?. and ?? (same)
-a:val=data?.nested?.value??"default"
-
--- Await all: ~~[expr1,expr2]
-
--- Spread: ...
-l:combined=[...items,4,5,6]
-m:merged={...cfg,debug:true}

package/examples/ai-app.nx

@@ -1,21 +0,0 @@
--- AI-powered API (NAIDE-X)
--- Set AI_KEY or OPENAI_API_KEY env var
-
-$app:3000
-  cors "*"
-
-  P"/api/ask"(req,res)
-    s:answer=~ai.ask(req.body.prompt)
-    >{answer}
-
-  P"/api/summarize"(req,res)
-    s:summary=~ai.ask("Summarize: {req.body.text}")
-    >{summary}
-
-  P"/api/extract"(req,res)
-    m:data=~ai.json("Extract name, email, phone: {req.body.text}",{name:"string",email:"string",phone:"string"})
-    >data
-
-  P"/api/chat"(req,res)
-    s:reply=~ai.chat(req.body.messages)
-    >{reply}

package/examples/async.nx

@@ -1,40 +0,0 @@
--- NAIDE-X async/await
-
-~f fetchData(s:url)a
-  a:res=~fetch(url)
-  a:data=~res.json()
-  >data
-
-~f getTopUsers()l
-  a:data=~fetchData("https://jsonplaceholder.typicode.com/users")
-  l:result=data
-    |>filter((u)=>u.name.length>5)
-    |>map((u)=>({name:u.name,email:u.email}))
-  >result
-
-~f safeFetch(s:url)m
-  !
-    a:data=~fetchData(url)
-    >{ok:true,data:data}
-  !!e
-    log.e"Fetch failed: {e.message}"
-    >{ok:false,error:e.message}
-
-~f loadDash()m
-  l:urls=[
-    "https://jsonplaceholder.typicode.com/users",
-    "https://jsonplaceholder.typicode.com/posts",
-    "https://jsonplaceholder.typicode.com/todos"
-  ]
-  l:results=~~urls.map((url)=>fetchData(url))
-  >{users:results[0],posts:results[1],todos:results[2]}
-
-~f main()
-  log"Fetching data..."
-  m:dash=~safeFetch("https://jsonplaceholder.typicode.com/users")
-  ?dash.ok
-    log"Got {dash.data.length} items"
-  :
-    log.e dash.error
-
-main()

package/examples/crud.nx

@@ -1,64 +0,0 @@
--- NAIDE-X full CRUD
-
-^Todo
-  s:id
-  s:title
-  b:done=false
-  s:createdAt
-
-  f toggle()
-    self.done=not self.done
-
-  f toJSON()m
-    >{id:self.id,title:self.title,done:self.done,createdAt:self.createdAt}
-
-~l:todos=[]
-~i:nextId=1
-
-f findTodo(s:id)a
-  @todo<todos
-    ?todo.id==id
-      >todo
-  >null
-
-f genId()s
-  s:id="todo_{nextId}"
-  nextId+=1
-  >id
-
-$app:8080
-
-  G"/api/todos"
-    >{todos:todos,count:todos.length}
-
-  G"/api/todos/:id"(req,res)
-    a:todo=findTodo(req.params.id)
-    ?todo==null
-      >.s 404 {error:"Todo not found"}
-    >todo
-
-  P"/api/todos"(req,res)
-    m:body=req.body
-    ?not body.title
-      >.s 400 {error:"Title is required"}
-    m:todo={id:genId(),title:body.title,done:false,createdAt:new Date().toISOString()}
-    todos.push(todo)
-    >.s 201 todo
-
-  U"/api/todos/:id"(req,res)
-    a:todo=findTodo(req.params.id)
-    ?todo==null
-      >.s 404 {error:"Todo not found"}
-    m:body=req.body
-    ?body.title
-      todo.title=body.title
-    ?body.done!=null
-      todo.done=body.done
-    >todo
-
-  D"/api/todos/:id"(req,res)
-    i:idx=todos.findIndex((t)=>t.id==req.params.id)
-    ?idx==-1
-      >.s 404 {error:"Todo not found"}
-    todos.splice(idx,1)
-    >{status:"deleted"}

package/examples/fullapp.nx

@@ -1,74 +0,0 @@
--- Full NAIDE-X app with all features
-
-db "data/"
-
-env:
-  PORT int default(3000)
-  JWT_SECRET str required
-
-schema User:
-  id auto
-  name str required min(2) max(50)
-  email str required email
-  password str required
-  role str default("user")
-
-schema Todo:
-  id auto
-  title str required min(1)
-  done bool default(false)
-  created timestamp auto
-
-$app:PORT
-  cors "*"
-  cookie
-  auth JWT_SECRET:
-    protect "/api/*"
-    public "/api/auth/*"
-  limit "/api/*" 100 "1m"
-  static "/public"
-  crud "/api/users" User
-  crud "/api/todos" Todo
-
-  group "/api/v1":
-    G"/status"
-      >{version:"1.0",status:"ok"}
-
-  P"/api/auth/register"(req,res)
-    s:hashed=hash(req.body.password)
-    user=UserStore.create({name:req.body.name,email:req.body.email,password:hashed})
-    ?user.error
-      >.s 400 {errors:user.error}
-    token=auth.sign({id:user.id,role:user.role})
-    >{token,user:{id:user.id,name:user.name,email:user.email}}
-
-  P"/api/auth/login"(req,res)
-    user=UserStore.where({email:req.body.email})[0]
-    ?not user
-      >.s 401 {error:"Invalid credentials"}
-    ?not verify(req.body.password,user.password)
-      >.s 401 {error:"Invalid credentials"}
-    token=auth.sign({id:user.id,role:user.role})
-    >{token}
-
-  G"/health"
-    >{status:"ok"}
-
-  G"/"
-    >.h "<h1>Welcome to NAIDE</h1>"
-
-  ws "/chat":
-    on "connect":
-      send({type:"welcome"})
-    on "message" (data):
-      broadcast(data)
-
-  error (err, req, res):
-    log.error err.message
-    >.s 500 {error:"Internal server error"}
-
-every "30m":
-  log"cleanup running"
-
-watch User.create (event):
-  log"new user: {event.data.name}"

package/examples/hello.nx

@@ -1,29 +0,0 @@
--- NAIDE-X hello world
-
-s:name="World"
-i:count=3
-
-f greet(s:who)s
-  >"Hello, {who}!"
-
-@i<0..count
-  s:msg=greet(name)
-  log msg
-
-?count>5
-  log"many"
-|count>2
-  log"a few"
-:
-  log"few"
-
-l:items=["apple","banana","cherry"]
-
-@fruit<items
-  log"I like {fruit}"
-
-s:status="ok"
-%status
-  "ok": log "All good"
-  "error": log "Something went wrong"
-  _: log "Unknown"

package/examples/server.nx

@@ -1,27 +0,0 @@
--- NAIDE-X REST API server
-
-$app:3000
-
-  G"/"
-    >{message:"Welcome to NAIDE-X API"}
-
-  G"/users"
-    l:users=[
-      {id:1,name:"Alice",age:30},
-      {id:2,name:"Bob",age:25}
-    ]
-    >users
-
-  G"/users/:id"(req,res)
-    s:id=req.params.id
-    >{id:id,name:"User {id}"}
-
-  P"/users"(req,res)
-    m:body=req.body
-    log"Creating user: {body.name}"
-    >{status:"created",user:body}
-
-  D"/users/:id"(req,res)
-    s:id=req.params.id
-    log"Deleting user {id}"
-    >{status:"deleted",id:id}

package/examples/sql-app.nx

@@ -1,23 +0,0 @@
--- SQLite-backed API (NAIDE-X)
--- npm install better-sqlite3
-
-db.sql "sqlite" "app.db"
-
-env:
-  PORT int default(3000)
-
-schema Task:
-  id auto
-  title str required min(1) max(200)
-  done bool default(false)
-
-$app:PORT
-  cors "*"
-  crud "/api/tasks" Task
-
-  U"/api/tasks/:id/toggle"(req,res)
-    task=TaskStore.getById(req.params.id)
-    ?not task
-      >.s 404 {error:"Not found"}
-    updated=TaskStore.update(req.params.id,{done:!task.done})
-    >updated

package/examples/todo-api.nx

@@ -1,31 +0,0 @@
--- Todo API in NAIDE-X (~80% fewer tokens)
--- Run: naide examples/todo-api.nx
-
-db "data/"
-
-env:
-  PORT int default(3000)
-
-schema Todo:
-  id auto
-  title str required min(1) max(200)
-  done bool default(false)
-  created timestamp auto
-
-$app:PORT
-  cors "*"
-  cookie
-  cache "/api/todos" "30s"
-  validate "/api/todos" Todo
-  crud "/api/todos" Todo
-  openapi "/docs"
-  G"/"
-    >.h "<h1>Todo API</h1><p>GET /api/todos | /docs</p>"
-  G"/api/stats"(req,res)
-    l:all=TodoStore.all()
-    i:total=all.length
-    i:done=all.filter((t)=>t.done).length
-    >{total,done,pending:total-done}
-  error (err,req,res):
-    log.e err.message
-    >.s 500 {error:err.message}