odac 0.9.0 → 1.0.0

package/src/WebSocket.js

@@ -0,0 +1,403 @@
+const nodeCrypto = require('crypto')
+
+const WS_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11'
+const MAX_PAYLOAD_LENGTH = 10 * 1024 * 1024
+const OPCODE = {
+  CONTINUATION: 0x0,
+  TEXT: 0x1,
+  BINARY: 0x2,
+  CLOSE: 0x8,
+  PING: 0x9,
+  PONG: 0xa
+}
+
+class WebSocketClient {
+  #socket
+  #handlers = {}
+  #closed = false
+  #server
+  #id
+  #rooms = new Set()
+  data = {}
+
+  constructor(socket, server, id) {
+    this.#socket = socket
+    this.#server = server
+    this.#id = id
+    this.#setupListeners()
+  }
+
+  get id() {
+    return this.#id
+  }
+
+  get rooms() {
+    return Array.from(this.#rooms)
+  }
+
+  #setupListeners() {
+    let buffer = Buffer.alloc(0)
+
+    this.#socket.on('data', chunk => {
+      buffer = Buffer.concat([buffer, chunk])
+
+      while (buffer.length >= 2) {
+        const frame = this.#parseFrame(buffer)
+        if (!frame) break
+
+        buffer = buffer.slice(frame.totalLength)
+        this.#handleFrame(frame)
+      }
+    })
+
+    this.#socket.on('close', () => this.#handleClose())
+    this.#socket.on('error', err => this.#emit('error', err))
+  }
+
+  #parseFrame(buffer) {
+    if (buffer.length < 2) return null
+
+    const firstByte = buffer[0]
+    const secondByte = buffer[1]
+
+    const fin = (firstByte & 0x80) !== 0
+    const opcode = firstByte & 0x0f
+    const masked = (secondByte & 0x80) !== 0
+
+    if (!masked) {
+      this.close(1002, 'Protocol error: client-to-server frames must be masked.')
+      return null
+    }
+
+    let payloadLength = secondByte & 0x7f
+
+    let offset = 2
+
+    if (payloadLength === 126) {
+      if (buffer.length < 4) return null
+      payloadLength = buffer.readUInt16BE(2)
+      offset = 4
+    } else if (payloadLength === 127) {
+      if (buffer.length < 10) return null
+      const payloadLengthBigInt = buffer.readBigUInt64BE(2)
+      if (payloadLengthBigInt > Number.MAX_SAFE_INTEGER) {
+        this.close(1009, 'Payload too large')
+        return null
+      }
+      payloadLength = Number(payloadLengthBigInt)
+      offset = 10
+    }
+
+    if (payloadLength > MAX_PAYLOAD_LENGTH) {
+      this.close(1009, 'Payload too large')
+      return null
+    }
+
+    let maskKey = null
+    if (masked) {
+      if (buffer.length < offset + 4) return null
+      maskKey = buffer.slice(offset, offset + 4)
+      offset += 4
+    }
+
+    if (buffer.length < offset + payloadLength) return null
+
+    let payload = buffer.slice(offset, offset + payloadLength)
+
+    if (masked && maskKey) {
+      payload = Buffer.from(payload)
+      for (let i = 0; i < payload.length; i++) {
+        payload[i] ^= maskKey[i % 4]
+      }
+    }
+
+    return {
+      fin,
+      opcode,
+      payload,
+      totalLength: offset + payloadLength
+    }
+  }
+
+  #handleFrame(frame) {
+    switch (frame.opcode) {
+      case OPCODE.TEXT:
+        this.#handleMessage(frame.payload.toString('utf8'))
+        break
+      case OPCODE.BINARY:
+        this.#handleMessage(frame.payload)
+        break
+      case OPCODE.PING:
+        this.#sendFrame(OPCODE.PONG, frame.payload)
+        break
+      case OPCODE.PONG:
+        this.#emit('pong')
+        break
+      case OPCODE.CLOSE:
+        this.close()
+        break
+    }
+  }
+
+  #handleMessage(data) {
+    try {
+      const parsed = JSON.parse(data)
+      this.#emit('message', parsed)
+    } catch {
+      this.#emit('message', data)
+    }
+  }
+
+  #handleClose() {
+    if (this.#closed) return
+    this.#closed = true
+
+    for (const room of this.#rooms) {
+      this.#server.leaveRoom(this.#id, room)
+    }
+
+    this.#emit('close')
+    this.#server.removeClient(this.#id)
+  }
+
+  #sendFrame(opcode, data) {
+    if (this.#closed) return
+
+    const payload = Buffer.isBuffer(data) ? data : Buffer.from(data)
+    const length = payload.length
+
+    let header
+    if (length < 126) {
+      header = Buffer.alloc(2)
+      header[0] = 0x80 | opcode
+      header[1] = length
+    } else if (length < 65536) {
+      header = Buffer.alloc(4)
+      header[0] = 0x80 | opcode
+      header[1] = 126
+      header.writeUInt16BE(length, 2)
+    } else {
+      header = Buffer.alloc(10)
+      header[0] = 0x80 | opcode
+      header[1] = 127
+      header.writeBigUInt64BE(BigInt(length), 2)
+    }
+
+    this.#socket.write(Buffer.concat([header, payload]))
+  }
+
+  #emit(event, ...args) {
+    if (this.#handlers[event]) {
+      for (const handler of this.#handlers[event]) {
+        handler(...args)
+      }
+    }
+  }
+
+  on(event, handler) {
+    if (!this.#handlers[event]) this.#handlers[event] = []
+    this.#handlers[event].push(handler)
+    return this
+  }
+
+  off(event, handler) {
+    if (!this.#handlers[event]) return this
+    if (handler) {
+      this.#handlers[event] = this.#handlers[event].filter(h => h !== handler)
+    } else {
+      delete this.#handlers[event]
+    }
+    return this
+  }
+
+  send(data) {
+    if (this.#closed) return this
+    const payload = typeof data === 'object' ? JSON.stringify(data) : String(data)
+    this.#sendFrame(OPCODE.TEXT, payload)
+    return this
+  }
+
+  sendBinary(data) {
+    if (this.#closed) return this
+    this.#sendFrame(OPCODE.BINARY, data)
+    return this
+  }
+
+  ping() {
+    this.#sendFrame(OPCODE.PING, Buffer.alloc(0))
+    return this
+  }
+
+  close(code = 1000, reason = '') {
+    if (this.#closed) return
+    this.#closed = true
+
+    const reasonBuffer = Buffer.from(reason)
+    const payload = Buffer.alloc(2 + reasonBuffer.length)
+    payload.writeUInt16BE(code, 0)
+    reasonBuffer.copy(payload, 2)
+
+    this.#sendFrame(OPCODE.CLOSE, payload)
+    this.#socket.end()
+
+    for (const room of this.#rooms) {
+      this.#server.leaveRoom(this.#id, room)
+    }
+
+    this.#emit('close')
+    this.#server.removeClient(this.#id)
+  }
+
+  join(room) {
+    this.#rooms.add(room)
+    this.#server.joinRoom(this.#id, room)
+    return this
+  }
+
+  leave(room) {
+    this.#rooms.delete(room)
+    this.#server.leaveRoom(this.#id, room)
+    return this
+  }
+
+  to(room) {
+    return {
+      send: data => this.#server.toRoom(room, data),
+      sendBinary: data => this.#server.toRoomBinary(room, data)
+    }
+  }
+
+  broadcast(data, includesSelf = false) {
+    this.#server.broadcast(data, includesSelf ? null : this.#id)
+    return this
+  }
+}
+
+class WebSocketServer {
+  #clients = new Map()
+  #rooms = new Map()
+  #routes = new Map()
+
+  route(path, handler) {
+    this.#routes.set(path, handler)
+  }
+
+  getRoute(path) {
+    if (this.#routes.has(path)) return this.#routes.get(path)
+
+    for (const [pattern, handler] of this.#routes) {
+      if (!pattern.includes('{')) continue
+      const regex = new RegExp('^' + pattern.replace(/\{[^}]+\}/g, '([^/]+)') + '$')
+      const match = path.match(regex)
+      if (match) {
+        const params = {}
+        const paramNames = pattern.match(/\{([^}]+)\}/g) || []
+        paramNames.forEach((name, i) => {
+          params[name.slice(1, -1)] = match[i + 1]
+        })
+        return {handler, params}
+      }
+    }
+    return null
+  }
+
+  handleUpgrade(req, socket, head, Odac) {
+    const path = req.url.split('?')[0]
+    const routeInfo = this.getRoute(path)
+
+    if (!routeInfo) {
+      socket.write('HTTP/1.1 404 Not Found\r\n\r\n')
+      socket.destroy()
+      return
+    }
+
+    const handler = typeof routeInfo === 'function' ? routeInfo : routeInfo.handler
+    const params = routeInfo.params || {}
+
+    const key = req.headers['sec-websocket-key']
+    if (!key) {
+      socket.write('HTTP/1.1 400 Bad Request\r\n\r\n')
+      socket.destroy()
+      return
+    }
+
+    const acceptKey = nodeCrypto
+      .createHash('sha1')
+      .update(key + WS_GUID)
+      .digest('base64')
+
+    const responseHeaders = [
+      'HTTP/1.1 101 Switching Protocols',
+      'Upgrade: websocket',
+      'Connection: Upgrade',
+      `Sec-WebSocket-Accept: ${acceptKey}`,
+      '',
+      ''
+    ]
+
+    socket.write(responseHeaders.join('\r\n'))
+
+    const clientId = nodeCrypto.randomUUID()
+    const client = new WebSocketClient(socket, this, clientId)
+    this.#clients.set(clientId, client)
+
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        Odac.Request.data.url[k] = v
+      }
+    }
+
+    if (Odac.Request && req.headers) {
+      Odac.Request._wsHeaders = req.headers
+    }
+
+    handler(client, Odac)
+  }
+
+  removeClient(id) {
+    this.#clients.delete(id)
+  }
+
+  joinRoom(clientId, room) {
+    if (!this.#rooms.has(room)) this.#rooms.set(room, new Set())
+    this.#rooms.get(room).add(clientId)
+  }
+
+  leaveRoom(clientId, room) {
+    if (!this.#rooms.has(room)) return
+    this.#rooms.get(room).delete(clientId)
+    if (this.#rooms.get(room).size === 0) this.#rooms.delete(room)
+  }
+
+  toRoom(room, data) {
+    if (!this.#rooms.has(room)) return
+    for (const clientId of this.#rooms.get(room)) {
+      const client = this.#clients.get(clientId)
+      if (client) client.send(data)
+    }
+  }
+
+  toRoomBinary(room, data) {
+    if (!this.#rooms.has(room)) return
+    for (const clientId of this.#rooms.get(room)) {
+      const client = this.#clients.get(clientId)
+      if (client) client.sendBinary(data)
+    }
+  }
+
+  broadcast(data, excludeId = null) {
+    for (const [id, client] of this.#clients) {
+      if (id !== excludeId) client.send(data)
+    }
+  }
+
+  get clients() {
+    return this.#clients
+  }
+
+  get clientCount() {
+    return this.#clients.size
+  }
+}
+
+module.exports = {WebSocketServer, WebSocketClient}

package/template/config.json

@@ -0,0 +1,5 @@
+{
+  "route": {
+    "/assets/js/odac.js": "${odac}/framework/web/odac.js"
+  }
+}

package/{web → template}/controller/page/about.js

@@ -1,23 +1,23 @@
 /**
  * About Page Controller
  *
- * This controller renders the about page using CandyPack's skeleton-based view system.
- * Provides information about CandyPack and its key components.
+ * This controller renders the about page using Odac's skeleton-based view system.
+ * Provides information about Odac and its key components.
  *
  * For AJAX requests, only content is returned. For full page loads, skeleton + content.
  */
 
-module.exports = function (Candy) {
+module.exports = function (Odac) {
   // Set variables for AJAX responses
-  Candy.set(
+  Odac.set(
     {
-      pageTitle: 'About CandyPack',
+      pageTitle: 'About Odac',
       version: '1.0.0'
     },
     true
   )
 
-  Candy.View.set({
+  Odac.View.set({
     skeleton: 'main',
     head: 'main',
     header: 'main',

package/{web → template}/controller/page/index.js

@@ -1,30 +1,30 @@
 /**
  * Home Page Controller
  *
- * This controller renders the home page using CandyPack's skeleton-based view system.
+ * This controller renders the home page using Odac's skeleton-based view system.
  * The skeleton provides the layout (header, nav, footer) and the view provides the content.
  *
- * For AJAX requests (candy-link navigation), only the content is returned.
+ * For AJAX requests (odac-link navigation), only the content is returned.
  * For full page loads, skeleton + content is returned.
  *
  * This page demonstrates:
  * - Modern, responsive design
- * - candy.js AJAX form handling
- * - candy.js GET requests
- * - Dynamic page loading with candy-link
+ * - odac.js AJAX form handling
+ * - odac.js GET requests
+ * - Dynamic page loading with odac-link
  */
 
-module.exports = function (Candy) {
+module.exports = function (Odac) {
   // Set variables that will be available in AJAX responses
-  Candy.set(
+  Odac.set(
     {
-      welcomeMessage: 'Welcome to CandyPack!',
+      welcomeMessage: 'Welcome to Odac!',
       timestamp: Date.now()
     },
     true
   ) // true = include in AJAX responses
 
-  Candy.View.set({
+  Odac.View.set({
     skeleton: 'main',
     head: 'main',
     header: 'main',

package/{web → template}/package.json

@@ -3,16 +3,15 @@
   "version": "1.0.0",
   "description": "Website for {{domain_original}}",
   "scripts": {
-    "start": "candy framework run",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "odac dev"
   },
   "dependencies": {
-    "candypack": "*"
+    "odac": "*"
   },
   "keywords": [
-    "candypack",
+    "odac",
     "website"
   ],
   "author": "",
   "license": "ISC"
-}
+}

package/{web → template}/public/assets/css/style.css

@@ -1,5 +1,5 @@
 /* ============================================
-   CandyPack Template Stylesheet
+   Odac Template Stylesheet
    Modern, responsive design with smooth transitions
    ============================================ */
 
@@ -536,7 +536,7 @@ textarea.error {
   display: block;
 }
 
-[candy-form-success] {
+[odac-form-success] {
   background-color: var(--accent);
   color: var(--white);
   padding: var(--spacing-sm);
@@ -545,7 +545,7 @@ textarea.error {
   display: none;
 }
 
-[candy-form-success]:not(:empty) {
+[odac-form-success]:not(:empty) {
   display: block;
 }
 
@@ -1333,7 +1333,7 @@ footer a:hover {
 }
 
 /* Smooth page transitions */
-[candy-page] {
+[odac-page] {
   animation: fadeIn 0.4s ease-out;
 }
 

package/{web → template}/public/assets/js/app.js

@@ -1,13 +1,13 @@
 /**
- * CandyPack Template - Client-Side Application
+ * Odac Template - Client-Side Application
  *
- * This file demonstrates candy.js features including:
- * - AJAX page loading with Candy.loader() for smooth navigation
+ * This file demonstrates odac.js features including:
+ * - AJAX page loading with odac.loader() for smooth navigation
  * - History API integration
  * - Event delegation
  */
 
-Candy.action({
+odac.action({
   /**
    * AJAX Navigation
    * Enables smooth page transitions without full page reloads
@@ -22,7 +22,7 @@ Candy.action({
 
   /**
    * Custom functions
-   * These become available as Candy.fn.functionName()
+   * These become available as odac.fn.functionName()
    */
   function: {
     /**
@@ -56,7 +56,7 @@ Candy.action({
    */
   load: function () {
     // Set initial active navigation state
-    Candy.fn.updateActiveNav(window.location.pathname)
+    odac.fn.updateActiveNav(window.location.pathname)
   },
 
   /**

package/{web → template}/route/www.js

@@ -1,19 +1,19 @@
 // ============================================
 // Page Routes
 // ============================================
-// Page routes render HTML views and support AJAX loading via candy.js
+// Page routes render HTML views and support AJAX loading via odac.js
 // Controllers are located in controller/page/ directory
 
 // Home page - displays welcome message, features, and interactive demos
-Candy.Route.page('/', 'index')
+Odac.Route.page('/', 'index')
 
-// About page - provides information about CandyPack
-Candy.Route.page('/about', 'about')
+// About page - provides information about Odac
+Odac.Route.page('/about', 'about')
 
 // ============================================
 // API Routes
 // ============================================
 // Add your API routes here
 // Example:
-// Candy.Route.post('/api/contact', 'contact')
-// Candy.Route.get('/api/data', 'data')
+// Odac.Route.post('/api/contact', 'contact')
+// Odac.Route.get('/api/data', 'data')

package/{web → template}/skeleton/main.html

@@ -16,7 +16,7 @@
         {{ FOOTER }}
     </footer>
 
-    <script src="/assets/js/candy.js"></script>
+    <script src="/assets/js/odac.js"></script>
     <script src="/assets/js/app.js"></script>
 </body>
 </html>

package/{web → template}/view/content/about.html

@@ -1,13 +1,13 @@
 <div class="container">
   <section class="page-hero">
     <h1>🍭 About This Template</h1>
-    <p class="lead">This is a starter template for your CandyPack website. Customize it to build your own application.</p>
+    <p class="lead">This is a starter template for your Odac website. Customize it to build your own application.</p>
   </section>
 
   <section class="content-section">
     <h2>What You Can Build</h2>
     <p>
-      With CandyPack, you can build any type of web application - from simple websites to complex web apps. 
+      With Odac, you can build any type of web application - from simple websites to complex web apps. 
       This template provides a solid foundation with modern features and best practices already configured.
     </p>
   </section>
@@ -51,13 +51,13 @@
   <section class="content-section">
     <h2>Learn More</h2>
     <div class="links-grid">
-      <a href="https://docs.candypack.dev" class="link-card" target="_blank" data-navigate="false">
+      <a href="https://docs.odac.run" class="link-card" target="_blank" data-navigate="false">
         <h3>📚 Documentation</h3>
         <p>Complete guides, API reference, and tutorials</p>
       </a>
       
-      <a href="https://candypack.dev" class="link-card" target="_blank" data-navigate="false">
-        <h3>🌐 CandyPack.dev</h3>
+      <a href="https://odac.run" class="link-card" target="_blank" data-navigate="false">
+        <h3>🌐 odac.run</h3>
         <p>Official website with examples and community</p>
       </a>
     </div>