npm - odac - Versions diffs - 0.9.0 - Mend

odac 0.9.0

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 (213) hide show

package/.editorconfig +21 -0
package/.github/workflows/auto-pr-description.yml +49 -0
package/.github/workflows/release.yml +32 -0
package/.github/workflows/test-coverage.yml +58 -0
package/.husky/pre-commit +2 -0
package/.kiro/steering/code-style.md +56 -0
package/.kiro/steering/product.md +20 -0
package/.kiro/steering/structure.md +77 -0
package/.kiro/steering/tech.md +87 -0
package/.prettierrc +10 -0
package/.releaserc.js +134 -0
package/AGENTS.md +84 -0
package/CHANGELOG.md +181 -0
package/CODE_OF_CONDUCT.md +83 -0
package/CONTRIBUTING.md +63 -0
package/LICENSE +661 -0
package/README.md +57 -0
package/SECURITY.md +26 -0
package/bin/candy +10 -0
package/bin/candypack +10 -0
package/cli/index.js +3 -0
package/cli/src/Cli.js +348 -0
package/cli/src/Connector.js +93 -0
package/cli/src/Monitor.js +416 -0
package/core/Candy.js +87 -0
package/core/Commands.js +239 -0
package/core/Config.js +1094 -0
package/core/Lang.js +52 -0
package/core/Log.js +43 -0
package/core/Process.js +26 -0
package/docs/backend/01-overview/01-whats-in-the-candy-box.md +9 -0
package/docs/backend/01-overview/02-super-handy-helper-functions.md +9 -0
package/docs/backend/01-overview/03-development-server.md +79 -0
package/docs/backend/02-structure/01-typical-project-layout.md +39 -0
package/docs/backend/03-config/00-configuration-overview.md +214 -0
package/docs/backend/03-config/01-database-connection.md +60 -0
package/docs/backend/03-config/02-static-route-mapping-optional.md +20 -0
package/docs/backend/03-config/03-request-timeout.md +11 -0
package/docs/backend/03-config/04-environment-variables.md +227 -0
package/docs/backend/03-config/05-early-hints.md +352 -0
package/docs/backend/04-routing/01-basic-page-routes.md +28 -0
package/docs/backend/04-routing/02-controller-less-view-routes.md +43 -0
package/docs/backend/04-routing/03-api-and-data-routes.md +20 -0
package/docs/backend/04-routing/04-authentication-aware-routes.md +48 -0
package/docs/backend/04-routing/05-advanced-routing.md +14 -0
package/docs/backend/04-routing/06-error-pages.md +101 -0
package/docs/backend/04-routing/07-cron-jobs.md +149 -0
package/docs/backend/05-controllers/01-how-to-build-a-controller.md +17 -0
package/docs/backend/05-controllers/02-your-trusty-candy-assistant.md +20 -0
package/docs/backend/05-controllers/03-controller-classes.md +93 -0
package/docs/backend/05-forms/01-custom-forms.md +395 -0
package/docs/backend/05-forms/02-automatic-database-insert.md +297 -0
package/docs/backend/06-request-and-response/01-the-request-object-what-is-the-user-asking-for.md +96 -0
package/docs/backend/06-request-and-response/02-sending-a-response-replying-to-the-user.md +40 -0
package/docs/backend/07-views/01-the-view-directory.md +73 -0
package/docs/backend/07-views/02-rendering-a-view.md +179 -0
package/docs/backend/07-views/03-template-syntax.md +181 -0
package/docs/backend/07-views/03-variables.md +328 -0
package/docs/backend/07-views/04-request-data.md +231 -0
package/docs/backend/07-views/05-conditionals.md +290 -0
package/docs/backend/07-views/06-loops.md +353 -0
package/docs/backend/07-views/07-translations.md +358 -0
package/docs/backend/07-views/08-backend-javascript.md +398 -0
package/docs/backend/07-views/09-comments.md +297 -0
package/docs/backend/08-database/01-database-connection.md +99 -0
package/docs/backend/08-database/02-using-mysql.md +322 -0
package/docs/backend/09-validation/01-the-validator-service.md +424 -0
package/docs/backend/10-authentication/01-user-logins-with-authjs.md +53 -0
package/docs/backend/10-authentication/02-foiling-villains-with-csrf-protection.md +55 -0
package/docs/backend/10-authentication/03-register.md +134 -0
package/docs/backend/10-authentication/04-candy-register-forms.md +676 -0
package/docs/backend/10-authentication/05-session-management.md +159 -0
package/docs/backend/10-authentication/06-candy-login-forms.md +596 -0
package/docs/backend/11-mail/01-the-mail-service.md +42 -0
package/docs/backend/12-streaming/01-streaming-overview.md +300 -0
package/docs/backend/13-utilities/01-candy-var.md +504 -0
package/docs/frontend/01-overview/01-introduction.md +146 -0
package/docs/frontend/02-ajax-navigation/01-quick-start.md +608 -0
package/docs/frontend/02-ajax-navigation/02-configuration.md +370 -0
package/docs/frontend/02-ajax-navigation/03-advanced-usage.md +519 -0
package/docs/frontend/03-forms/01-form-handling.md +420 -0
package/docs/frontend/04-api-requests/01-get-post.md +443 -0
package/docs/frontend/05-streaming/01-client-streaming.md +163 -0
package/docs/index.json +452 -0
package/docs/server/01-installation/01-quick-install.md +19 -0
package/docs/server/01-installation/02-manual-installation-via-npm.md +9 -0
package/docs/server/02-get-started/01-core-concepts.md +7 -0
package/docs/server/02-get-started/02-basic-commands.md +57 -0
package/docs/server/02-get-started/03-cli-reference.md +276 -0
package/docs/server/02-get-started/04-cli-quick-reference.md +102 -0
package/docs/server/03-service/01-start-a-new-service.md +57 -0
package/docs/server/03-service/02-delete-a-service.md +48 -0
package/docs/server/04-web/01-create-a-website.md +36 -0
package/docs/server/04-web/02-list-websites.md +9 -0
package/docs/server/04-web/03-delete-a-website.md +29 -0
package/docs/server/05-subdomain/01-create-a-subdomain.md +32 -0
package/docs/server/05-subdomain/02-list-subdomains.md +33 -0
package/docs/server/05-subdomain/03-delete-a-subdomain.md +41 -0
package/docs/server/06-ssl/01-renew-an-ssl-certificate.md +34 -0
package/docs/server/07-mail/01-create-a-mail-account.md +23 -0
package/docs/server/07-mail/02-delete-a-mail-account.md +20 -0
package/docs/server/07-mail/03-list-mail-accounts.md +20 -0
package/docs/server/07-mail/04-change-account-password.md +23 -0
package/eslint.config.mjs +120 -0
package/framework/index.js +4 -0
package/framework/src/Auth.js +309 -0
package/framework/src/Candy.js +81 -0
package/framework/src/Config.js +79 -0
package/framework/src/Env.js +60 -0
package/framework/src/Lang.js +57 -0
package/framework/src/Mail.js +83 -0
package/framework/src/Mysql.js +575 -0
package/framework/src/Request.js +301 -0
package/framework/src/Route/Cron.js +128 -0
package/framework/src/Route/Internal.js +439 -0
package/framework/src/Route.js +455 -0
package/framework/src/Server.js +15 -0
package/framework/src/Stream.js +163 -0
package/framework/src/Token.js +37 -0
package/framework/src/Validator.js +271 -0
package/framework/src/Var.js +211 -0
package/framework/src/View/EarlyHints.js +190 -0
package/framework/src/View/Form.js +600 -0
package/framework/src/View.js +513 -0
package/framework/web/candy.js +838 -0
package/jest.config.js +22 -0
package/locale/de-DE.json +80 -0
package/locale/en-US.json +79 -0
package/locale/es-ES.json +80 -0
package/locale/fr-FR.json +80 -0
package/locale/pt-BR.json +80 -0
package/locale/ru-RU.json +80 -0
package/locale/tr-TR.json +85 -0
package/locale/zh-CN.json +80 -0
package/package.json +86 -0
package/server/index.js +5 -0
package/server/src/Api.js +88 -0
package/server/src/DNS.js +940 -0
package/server/src/Hub.js +535 -0
package/server/src/Mail.js +571 -0
package/server/src/SSL.js +180 -0
package/server/src/Server.js +27 -0
package/server/src/Service.js +248 -0
package/server/src/Subdomain.js +64 -0
package/server/src/Web/Firewall.js +170 -0
package/server/src/Web/Proxy.js +134 -0
package/server/src/Web.js +451 -0
package/server/src/mail/imap.js +1091 -0
package/server/src/mail/server.js +32 -0
package/server/src/mail/smtp.js +786 -0
package/test/cli/Cli.test.js +36 -0
package/test/core/Candy.test.js +234 -0
package/test/core/Commands.test.js +538 -0
package/test/core/Config.test.js +1435 -0
package/test/core/Lang.test.js +250 -0
package/test/core/Process.test.js +156 -0
package/test/framework/Route.test.js +239 -0
package/test/framework/View/EarlyHints.test.js +282 -0
package/test/scripts/check-coverage.js +132 -0
package/test/server/Api.test.js +647 -0
package/test/server/Client.test.js +338 -0
package/test/server/DNS.test.js +2050 -0
package/test/server/DNS.test.js.bak +2084 -0
package/test/server/Log.test.js +73 -0
package/test/server/Mail.account.test_.js +460 -0
package/test/server/Mail.init.test_.js +411 -0
package/test/server/Mail.test_.js +1340 -0
package/test/server/SSL.test_.js +1491 -0
package/test/server/Server.test.js +765 -0
package/test/server/Service.test_.js +1127 -0
package/test/server/Subdomain.test.js +440 -0
package/test/server/Web/Firewall.test.js +175 -0
package/test/server/Web.test_.js +1562 -0
package/test/server/__mocks__/acme-client.js +17 -0
package/test/server/__mocks__/bcrypt.js +50 -0
package/test/server/__mocks__/child_process.js +389 -0
package/test/server/__mocks__/crypto.js +432 -0
package/test/server/__mocks__/fs.js +450 -0
package/test/server/__mocks__/globalCandy.js +227 -0
package/test/server/__mocks__/http-proxy.js +105 -0
package/test/server/__mocks__/http.js +575 -0
package/test/server/__mocks__/https.js +272 -0
package/test/server/__mocks__/index.js +249 -0
package/test/server/__mocks__/mail/server.js +100 -0
package/test/server/__mocks__/mail/smtp.js +31 -0
package/test/server/__mocks__/mailparser.js +81 -0
package/test/server/__mocks__/net.js +369 -0
package/test/server/__mocks__/node-forge.js +328 -0
package/test/server/__mocks__/os.js +320 -0
package/test/server/__mocks__/path.js +291 -0
package/test/server/__mocks__/selfsigned.js +8 -0
package/test/server/__mocks__/server/src/mail/server.js +100 -0
package/test/server/__mocks__/server/src/mail/smtp.js +31 -0
package/test/server/__mocks__/smtp-server.js +106 -0
package/test/server/__mocks__/sqlite3.js +394 -0
package/test/server/__mocks__/testFactories.js +299 -0
package/test/server/__mocks__/testHelpers.js +363 -0
package/test/server/__mocks__/tls.js +229 -0
package/watchdog/index.js +3 -0
package/watchdog/src/Watchdog.js +156 -0
package/web/config.json +5 -0
package/web/controller/page/about.js +27 -0
package/web/controller/page/index.js +34 -0
package/web/package.json +18 -0
package/web/public/assets/css/style.css +1835 -0
package/web/public/assets/js/app.js +96 -0
package/web/route/www.js +19 -0
package/web/skeleton/main.html +22 -0
package/web/view/content/about.html +65 -0
package/web/view/content/home.html +205 -0
package/web/view/footer/main.html +11 -0
package/web/view/head/main.html +5 -0
package/web/view/header/main.html +14 -0

package/test/framework/View/EarlyHints.test.js ADDED Viewed

@@ -0,0 +1,282 @@
+const EarlyHints = require('../../../framework/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-Candy-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-Candy-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/scripts/check-coverage.js ADDED Viewed

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Pre-commit hook to check test coverage for changed files
+ * Only runs tests for files that have been modified
+ */
+const {execSync} = require('child_process')
+const fs = require('fs')
+// Get list of staged files
+function getStagedFiles() {
+  try {
+    const output = execSync('git diff --cached --name-only --diff-filter=ACM', {
+      encoding: 'utf8'
+    })
+    return output
+      .split('\n')
+      .filter(file => file.endsWith('.js'))
+      .filter(file => file.startsWith('core/') || file.startsWith('server/'))
+      .filter(file => !file.includes('.test.js') && !file.includes('.spec.js'))
+  } catch (err) {
+    console.error('Error getting staged files:', err.message)
+    return []
+  }
+}
+// Check if there are corresponding test files
+function checkTestFiles(changedFiles) {
+  const missingTests = []
+  for (const file of changedFiles) {
+    // Skip if file doesn't exist (deleted files)
+    if (!fs.existsSync(file)) continue
+    // Determine test file path
+    const testFile = file.replace(/^(core|server)\//, 'test/$1/').replace(/\.js$/, '.test.js')
+    if (!fs.existsSync(testFile)) {
+      missingTests.push({
+        source: file,
+        test: testFile
+      })
+    }
+  }
+  return missingTests
+}
+// Run tests for specific files
+function runTestsForFiles(files) {
+  if (files.length === 0) {
+    console.log('✓ No testable files changed')
+    return true
+  }
+  console.log(`\n📊 Running tests for ${files.length} changed file(s)...\n`)
+  try {
+    // Create a pattern to match test files for changed source files
+    const testPatterns = files
+      .map(file => {
+        const testFile = file.replace(/^(core|server)\//, 'test/$1/').replace(/\.js$/, '.test.js')
+        return testFile
+      })
+      .filter(testFile => fs.existsSync(testFile))
+    if (testPatterns.length === 0) {
+      console.log('⚠️  No test files found for changed files')
+      console.log('Skipping coverage check (no tests available yet)\n')
+      return true // Don't block commit if no tests exist yet
+    }
+    // Run Jest for specific test files - no coverage threshold enforcement
+    const testFiles = testPatterns.join(' ')
+    const command = `npx jest ${testFiles} --passWithNoTests`
+    execSync(command, {
+      stdio: 'inherit',
+      encoding: 'utf8'
+    })
+    console.log('\n✓ All tests passed\n')
+    return true
+  } catch (err) {
+    console.error('\n✗ Tests failed\n')
+    console.error('Please ensure:')
+    console.error('  1. All tests pass')
+    console.error('  2. Add tests for new functionality\n')
+    return false
+  }
+}
+// Main execution
+function main() {
+  console.log('\n🔍 Checking test coverage for changed files...\n')
+  const changedFiles = getStagedFiles()
+  if (changedFiles.length === 0) {
+    console.log('✓ No core or server files changed\n')
+    process.exit(0)
+  }
+  console.log('Changed files:')
+  changedFiles.forEach(file => console.log(`  - ${file}`))
+  console.log('')
+  // Check for missing test files
+  const missingTests = checkTestFiles(changedFiles)
+  if (missingTests.length > 0) {
+    console.log('⚠️  Warning: Missing test files for:')
+    missingTests.forEach(({source, test}) => {
+      console.log(`  - ${source}`)
+      console.log(`    Expected: ${test}`)
+    })
+    console.log('')
+    console.log('Consider adding tests for better coverage.\n')
+  }
+  // Run tests
+  const success = runTestsForFiles(changedFiles)
+  if (!success) {
+    process.exit(1)
+  }
+  process.exit(0)
+}
+main()