npm - odac - Versions diffs - 1.4.0 → 1.4.2 - Mend

odac 1.4.0 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (96) hide show

package/.agent/rules/memory.md +8 -0
package/.github/workflows/release.yml +1 -1
package/.releaserc.js +9 -2
package/CHANGELOG.md +61 -0
package/README.md +10 -0
package/bin/odac.js +193 -2
package/client/odac.js +32 -13
package/docs/ai/skills/SKILL.md +4 -3
package/docs/ai/skills/backend/authentication.md +7 -0
package/docs/ai/skills/backend/config.md +7 -0
package/docs/ai/skills/backend/controllers.md +7 -0
package/docs/ai/skills/backend/cron.md +9 -2
package/docs/ai/skills/backend/database.md +37 -2
package/docs/ai/skills/backend/forms.md +112 -11
package/docs/ai/skills/backend/ipc.md +7 -0
package/docs/ai/skills/backend/mail.md +7 -0
package/docs/ai/skills/backend/migrations.md +86 -0
package/docs/ai/skills/backend/request_response.md +7 -0
package/docs/ai/skills/backend/routing.md +7 -0
package/docs/ai/skills/backend/storage.md +7 -0
package/docs/ai/skills/backend/streaming.md +7 -0
package/docs/ai/skills/backend/structure.md +8 -1
package/docs/ai/skills/backend/translations.md +7 -0
package/docs/ai/skills/backend/utilities.md +7 -0
package/docs/ai/skills/backend/validation.md +138 -31
package/docs/ai/skills/backend/views.md +7 -0
package/docs/ai/skills/frontend/core.md +7 -0
package/docs/ai/skills/frontend/forms.md +48 -13
package/docs/ai/skills/frontend/navigation.md +7 -0
package/docs/ai/skills/frontend/realtime.md +7 -0
package/docs/backend/08-database/02-basics.md +49 -9
package/docs/backend/08-database/04-migrations.md +259 -37
package/package.json +1 -1
package/src/Auth.js +82 -43
package/src/Config.js +1 -1
package/src/Database/ConnectionFactory.js +70 -0
package/src/Database/Migration.js +1228 -0
package/src/Database/nanoid.js +30 -0
package/src/Database.js +157 -46
package/src/Ipc.js +37 -0
package/src/Odac.js +1 -1
package/src/Route/Cron.js +11 -0
package/src/Route.js +8 -0
package/src/Server.js +77 -23
package/src/Storage.js +15 -1
package/src/Validator.js +22 -20
package/template/schema/users.js +23 -0
package/test/{Auth.test.js → Auth/check.test.js} +153 -6
package/test/Client/data.test.js +91 -0
package/test/Client/get.test.js +90 -0
package/test/Client/storage.test.js +87 -0
package/test/Client/token.test.js +82 -0
package/test/Client/ws.test.js +86 -0
package/test/Config/deepMerge.test.js +14 -0
package/test/Config/init.test.js +66 -0
package/test/Config/interpolate.test.js +35 -0
package/test/Database/ConnectionFactory/buildConnectionConfig.test.js +13 -0
package/test/Database/ConnectionFactory/buildConnections.test.js +31 -0
package/test/Database/ConnectionFactory/resolveClient.test.js +12 -0
package/test/Database/Migration/migrate_column.test.js +52 -0
package/test/Database/Migration/migrate_files.test.js +70 -0
package/test/Database/Migration/migrate_index.test.js +89 -0
package/test/Database/Migration/migrate_nanoid.test.js +160 -0
package/test/Database/Migration/migrate_seed.test.js +77 -0
package/test/Database/Migration/migrate_table.test.js +88 -0
package/test/Database/Migration/rollback.test.js +61 -0
package/test/Database/Migration/snapshot.test.js +38 -0
package/test/Database/Migration/status.test.js +41 -0
package/test/Database/autoNanoid.test.js +215 -0
package/test/Database/nanoid.test.js +19 -0
package/test/Lang/constructor.test.js +25 -0
package/test/Lang/get.test.js +65 -0
package/test/Lang/set.test.js +49 -0
package/test/Odac/init.test.js +42 -0
package/test/Odac/instance.test.js +58 -0
package/test/Route/{Middleware.test.js → Middleware/chaining.test.js} +5 -29
package/test/Route/Middleware/use.test.js +35 -0
package/test/{Route.test.js → Route/check.test.js} +4 -55
package/test/Route/set.test.js +52 -0
package/test/Route/ws.test.js +23 -0
package/test/View/EarlyHints/cache.test.js +32 -0
package/test/View/EarlyHints/extractFromHtml.test.js +143 -0
package/test/View/EarlyHints/formatLinkHeader.test.js +33 -0
package/test/View/EarlyHints/send.test.js +99 -0
package/test/View/{Form.test.js → Form/generateFieldHtml.test.js} +2 -2
package/test/View/constructor.test.js +22 -0
package/test/View/print.test.js +19 -0
package/test/WebSocket/Client/limits.test.js +55 -0
package/test/WebSocket/Server/broadcast.test.js +33 -0
package/test/WebSocket/Server/route.test.js +37 -0
package/test/Client.test.js +0 -197
package/test/Config.test.js +0 -112
package/test/Lang.test.js +0 -92
package/test/Odac.test.js +0 -88
package/test/View/EarlyHints.test.js +0 -282
package/test/WebSocket.test.js +0 -238

package/test/View/EarlyHints.test.js DELETED Viewed

@@ -1,282 +0,0 @@
-const EarlyHints = require('../../src/View/EarlyHints')
-describe('EarlyHints', () => {
-  let earlyHints
-  let mockConfig
-  beforeEach(() => {
-    mockConfig = {
-      enabled: true,
-      auto: true,
-      maxResources: 5
-    }
-    earlyHints = new EarlyHints(mockConfig)
-  })
-  describe('initialization', () => {
-    it('should create instance with default config', () => {
-      const hints = new EarlyHints()
-      expect(hints).toBeDefined()
-    })
-    it('should create instance with custom config', () => {
-      const hints = new EarlyHints({enabled: false})
-      expect(hints).toBeDefined()
-    })
-  })
-  describe('extractFromHtml', () => {
-    it('should extract CSS resources from head', () => {
-      const html = `
-        <html>
-          <head>
-            <link rel="stylesheet" href="/css/main.css">
-            <link rel="stylesheet" href="/css/theme.css">
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(2)
-      expect(resources[0]).toEqual({href: '/css/main.css', as: 'style'})
-      expect(resources[1]).toEqual({href: '/css/theme.css', as: 'style'})
-    })
-    it('should extract JS resources from head', () => {
-      const html = `
-        <html>
-          <head>
-            <script src="/js/app.js"></script>
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(1)
-      expect(resources[0]).toEqual({href: '/js/app.js', as: 'script'})
-    })
-    it('should not extract deferred JS', () => {
-      const html = `
-        <html>
-          <head>
-            <script src="/js/app.js" defer></script>
-            <script src="/js/async.js" async></script>
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(0)
-    })
-    it('should extract font resources', () => {
-      const html = `
-        <html>
-          <head>
-            <link rel="preload" href="/fonts/main.woff2" as="font">
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(1)
-      expect(resources[0]).toEqual({
-        href: '/fonts/main.woff2',
-        as: 'font',
-        crossorigin: 'anonymous'
-      })
-    })
-    it('should limit resources to maxResources', () => {
-      const html = `
-        <html>
-          <head>
-            <link rel="stylesheet" href="/css/1.css">
-            <link rel="stylesheet" href="/css/2.css">
-            <link rel="stylesheet" href="/css/3.css">
-            <link rel="stylesheet" href="/css/4.css">
-            <link rel="stylesheet" href="/css/5.css">
-            <link rel="stylesheet" href="/css/6.css">
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(5)
-    })
-    it('should return empty array when no head tag', () => {
-      const html = '<html><body></body></html>'
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toEqual([])
-    })
-    it('should return empty array when disabled', () => {
-      const hints = new EarlyHints({enabled: false})
-      const html = '<html><head><link rel="stylesheet" href="/css/main.css"></head></html>'
-      const resources = hints.extractFromHtml(html)
-      expect(resources).toEqual([])
-    })
-    it('should skip resources with defer attribute', () => {
-      const html = `
-        <html>
-          <head>
-            <link rel="stylesheet" href="/css/critical.css">
-            <link rel="stylesheet" href="/css/non-critical.css" defer>
-            <script src="/js/app.js"></script>
-            <script src="/js/analytics.js" defer></script>
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(2)
-      expect(resources[0]).toEqual({href: '/css/critical.css', as: 'style'})
-      expect(resources[1]).toEqual({href: '/js/app.js', as: 'script'})
-    })
-    it('should only detect stylesheets with rel="stylesheet"', () => {
-      const html = `
-        <html>
-          <head>
-            <link rel="stylesheet" href="/css/main.css">
-            <link rel="icon" href="/favicon.css">
-            <link rel="preload" href="/data.css" as="fetch">
-            <link href="/other.css">
-          </head>
-          <body></body>
-        </html>
-      `
-      const resources = earlyHints.extractFromHtml(html)
-      expect(resources).toHaveLength(1)
-      expect(resources[0]).toEqual({href: '/css/main.css', as: 'style'})
-    })
-  })
-  describe('formatLinkHeader', () => {
-    it('should format basic resource', () => {
-      const resource = {href: '/css/main.css', as: 'style'}
-      const header = earlyHints.formatLinkHeader(resource)
-      expect(header).toBe('</css/main.css>; rel=preload; as=style')
-    })
-    it('should format resource with crossorigin', () => {
-      const resource = {href: '/font.woff2', as: 'font', crossorigin: 'anonymous'}
-      const header = earlyHints.formatLinkHeader(resource)
-      expect(header).toBe('</font.woff2>; rel=preload; as=font; crossorigin')
-    })
-    it('should format resource with type', () => {
-      const resource = {href: '/data.json', as: 'fetch', type: 'application/json'}
-      const header = earlyHints.formatLinkHeader(resource)
-      expect(header).toBe('</data.json>; rel=preload; as=fetch; type=application/json')
-    })
-  })
-  describe('caching', () => {
-    it('should cache hints for route', () => {
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      earlyHints.cacheHints('/home', resources)
-      const cached = earlyHints.getHints(null, '/home')
-      expect(cached).toEqual(resources)
-    })
-    it('should not cache when disabled', () => {
-      const hints = new EarlyHints({enabled: false})
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      hints.cacheHints('/home', resources)
-      const cached = hints.getHints(null, '/home')
-      expect(cached).toBeNull()
-    })
-  })
-  describe('send', () => {
-    it('should return false when disabled', () => {
-      const hints = new EarlyHints({enabled: false})
-      const mockRes = {
-        headersSent: false,
-        writableEnded: false,
-        writeEarlyHints: jest.fn()
-      }
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      const result = hints.send(mockRes, resources)
-      expect(result).toBe(false)
-      expect(mockRes.writeEarlyHints).not.toHaveBeenCalled()
-    })
-    it('should return false when headers already sent', () => {
-      const mockRes = {
-        headersSent: true,
-        writableEnded: false,
-        writeEarlyHints: jest.fn()
-      }
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      const result = earlyHints.send(mockRes, resources)
-      expect(result).toBe(false)
-      expect(mockRes.writeEarlyHints).not.toHaveBeenCalled()
-    })
-    it('should return false when response ended', () => {
-      const mockRes = {
-        headersSent: false,
-        writableEnded: true,
-        writeEarlyHints: jest.fn()
-      }
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      const result = earlyHints.send(mockRes, resources)
-      expect(result).toBe(false)
-      expect(mockRes.writeEarlyHints).not.toHaveBeenCalled()
-    })
-    it('should return true even when writeEarlyHints not available', () => {
-      const mockRes = {
-        headersSent: false,
-        writableEnded: false,
-        setHeader: jest.fn()
-      }
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      const result = earlyHints.send(mockRes, resources)
-      expect(result).toBe(true)
-      expect(mockRes.setHeader).toHaveBeenCalledWith('X-Odac-Early-Hints', JSON.stringify(['</css/main.css>; rel=preload; as=style']))
-    })
-    it('should send early hints successfully', () => {
-      const mockRes = {
-        headersSent: false,
-        writableEnded: false,
-        writeEarlyHints: jest.fn(),
-        setHeader: jest.fn()
-      }
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      const result = earlyHints.send(mockRes, resources)
-      expect(result).toBe(true)
-      expect(mockRes.writeEarlyHints).toHaveBeenCalledWith({
-        link: ['</css/main.css>; rel=preload; as=style']
-      })
-      expect(mockRes.setHeader).toHaveBeenCalledWith('X-Odac-Early-Hints', JSON.stringify(['</css/main.css>; rel=preload; as=style']))
-    })
-    it('should handle writeEarlyHints errors gracefully', () => {
-      const mockRes = {
-        headersSent: false,
-        writableEnded: false,
-        writeEarlyHints: jest.fn(() => {
-          throw new Error('Write error')
-        })
-      }
-      const resources = [{href: '/css/main.css', as: 'style'}]
-      const result = earlyHints.send(mockRes, resources)
-      expect(result).toBe(false)
-    })
-  })
-})

package/test/WebSocket.test.js DELETED Viewed

@@ -1,238 +0,0 @@
-const {WebSocketServer} = require('../src/WebSocket.js')
-describe('WebSocketServer', () => {
-  let server
-  beforeEach(() => {
-    server = new WebSocketServer()
-  })
-  describe('route', () => {
-    it('should register a route', () => {
-      const handler = jest.fn()
-      server.route('/chat', handler)
-      expect(server.getRoute('/chat').handler).toBe(handler)
-    })
-    it('should return null for unregistered route', () => {
-      expect(server.getRoute('/unknown')).toBeNull()
-    })
-    it('should match parameterized routes', () => {
-      const handler = jest.fn()
-      server.route('/room/{id}', handler)
-      const result = server.getRoute('/room/123')
-      expect(result).toBeDefined()
-      expect(result.handler).toBe(handler)
-      expect(result.params).toEqual({id: '123'})
-    })
-    it('should match multiple parameters', () => {
-      const handler = jest.fn()
-      server.route('/chat/{room}/user/{userId}', handler)
-      const result = server.getRoute('/chat/general/user/42')
-      expect(result.params).toEqual({room: 'general', userId: '42'})
-    })
-  })
-  describe('rooms', () => {
-    it('should join and leave rooms', () => {
-      server.joinRoom('client1', 'room1')
-      server.joinRoom('client2', 'room1')
-      server.leaveRoom('client1', 'room1')
-      server.leaveRoom('client2', 'room1')
-    })
-  })
-  describe('broadcast', () => {
-    it('should send message to all connected clients', () => {
-      const client1 = {id: 'c1', send: jest.fn()}
-      const client2 = {id: 'c2', send: jest.fn()}
-      server.clients.set('c1', client1)
-      server.clients.set('c2', client2)
-      server.broadcast('hello')
-      expect(client1.send).toHaveBeenCalledWith('hello')
-      expect(client2.send).toHaveBeenCalledWith('hello')
-    })
-    it('should exclude specified client from broadcast', () => {
-      const client1 = {id: 'c1', send: jest.fn()}
-      const client2 = {id: 'c2', send: jest.fn()}
-      server.clients.set('c1', client1)
-      server.clients.set('c2', client2)
-      server.broadcast('hello', 'c1')
-      expect(client1.send).not.toHaveBeenCalled()
-      expect(client2.send).toHaveBeenCalledWith('hello')
-    })
-  })
-  describe('clients', () => {
-    it('should track client count', () => {
-      expect(server.clientCount).toBe(0)
-    })
-  })
-  describe('cleanup on disconnect', () => {
-    it('should be handled by Route.setWs wrapper', () => {
-      expect(true).toBe(true)
-    })
-  })
-  describe('maxPayload', () => {
-    it('should close connection if payload exceeds limit', () => {
-      const socket = {
-        pause: jest.fn(),
-        resume: jest.fn(),
-        on: jest.fn(),
-        write: jest.fn(),
-        end: jest.fn(),
-        removeAllListeners: jest.fn()
-      }
-      const {WebSocketClient} = require('../src/WebSocket.js')
-      new WebSocketClient(socket, server, 'test-id', {maxPayload: 10})
-      // We must send a MASKED frame because server expects masked frames from client
-      const buffer = Buffer.alloc(100)
-      buffer[0] = 0x81 // fin + text
-      buffer[1] = 0x80 | 20 // masked + length 20
-      // Mask key (4 bytes) + Payload (20 bytes) needed but header check happens first
-      const dataHandler = socket.on.mock.calls.find(call => call[0] === 'data')[1]
-      dataHandler(buffer)
-      expect(socket.end).toHaveBeenCalled()
-      // Verify close frame sent with 1009
-      // socket.write is called to send the Close frame
-      const writeCall = socket.write.mock.calls[0][0]
-      expect(writeCall[2]).toBe(0x03) // 1009 >> 8
-      expect(writeCall[3]).toBe(0xf1) // 1009 & 0xff
-    })
-  })
-  describe('rateLimit', () => {
-    it('should close connection if rate limit exceeded', () => {
-      const socket = {
-        pause: jest.fn(),
-        resume: jest.fn(),
-        on: jest.fn(),
-        write: jest.fn(),
-        end: jest.fn(),
-        removeAllListeners: jest.fn()
-      }
-      const {WebSocketClient} = require('../src/WebSocket.js')
-      new WebSocketClient(socket, server, 'test-id', {
-        rateLimit: {max: 2, window: 1000}
-      })
-      // Valid MASKED frame (exact size 7 bytes)
-      const buffer = Buffer.alloc(7)
-      buffer[0] = 0x81
-      buffer[1] = 0x80 | 1 // masked + length 1
-      buffer[2] = 0x00
-      buffer[3] = 0x00
-      buffer[4] = 0x00
-      buffer[5] = 0x00 // mask key (0)
-      buffer[6] = 0x61 // 'a' (masked with 0 remains 'a')
-      const dataHandler = socket.on.mock.calls.find(call => call[0] === 'data')[1]
-      // Send 3 messages (limit is 2)
-      dataHandler(buffer)
-      dataHandler(buffer)
-      dataHandler(buffer)
-      expect(socket.end).toHaveBeenCalled()
-      // Verify close frame sent with 1008
-      const writeCalls = socket.write.mock.calls
-      const writeCall = writeCalls[writeCalls.length - 1][0]
-      expect(writeCall[2]).toBe(0x03) // 1008 >> 8
-      expect(writeCall[3]).toBe(0xf0) // 1008 & 0xff
-    })
-    it('should reset count after window', done => {
-      const socket = {
-        pause: jest.fn(),
-        resume: jest.fn(),
-        on: jest.fn(),
-        write: jest.fn(),
-        end: jest.fn(),
-        removeAllListeners: jest.fn()
-      }
-      const {WebSocketClient} = require('../src/WebSocket.js')
-      const client = new WebSocketClient(socket, server, 'test-id', {
-        rateLimit: {max: 2, window: 200}
-      })
-      const buffer = Buffer.alloc(7)
-      buffer[0] = 0x81
-      buffer[1] = 0x80 | 1
-      buffer[2] = 0x00
-      buffer[3] = 0x00
-      buffer[4] = 0x00
-      buffer[5] = 0x00
-      buffer[6] = 0x61
-      const dataHandler = socket.on.mock.calls.find(call => call[0] === 'data')[1]
-      // Send 2 messages
-      dataHandler(buffer)
-      dataHandler(buffer)
-      expect(socket.end).not.toHaveBeenCalled()
-      setTimeout(() => {
-        // Send 1 more after window reset
-        dataHandler(buffer)
-        try {
-          expect(socket.end).not.toHaveBeenCalled()
-          client.close()
-          done()
-        } catch (error) {
-          client.close()
-          done(error)
-        }
-      }, 300)
-    })
-  })
-})
-describe('Route WebSocket Integration', () => {
-  const Route = require('../src/Route.js')
-  beforeEach(() => {
-    global.Odac = {
-      Route: new Route()
-    }
-  })
-  it('should support ws() method', () => {
-    expect(typeof Odac.Route.ws).toBe('function')
-  })
-  it('should support auth.ws() method', () => {
-    expect(typeof Odac.Route.auth.ws).toBe('function')
-  })
-  it('should support middleware with ws()', () => {
-    const chain = Odac.Route.use('test-middleware')
-    expect(typeof chain.ws).toBe('function')
-  })
-  it('should support middleware with auth.ws()', () => {
-    const chain = Odac.Route.use('test-middleware')
-    expect(typeof chain.auth.ws).toBe('function')
-  })
-  it('should support auth.use() with ws()', () => {
-    const chain = Odac.Route.auth.use('test-middleware')
-    expect(typeof chain.ws).toBe('function')
-  })
-})