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.
- 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
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
const fs = require('fs')
|
|
2
|
+
|
|
3
|
+
module.exports = {
|
|
4
|
+
init: function (dir) {
|
|
5
|
+
const envPath = (dir || __dir) + '/.env'
|
|
6
|
+
if (!fs.existsSync(envPath)) return
|
|
7
|
+
|
|
8
|
+
try {
|
|
9
|
+
const envContent = fs.readFileSync(envPath, 'utf8')
|
|
10
|
+
envContent.split('\n').forEach(line => {
|
|
11
|
+
line = line.trim()
|
|
12
|
+
if (!line || line.startsWith('#')) return
|
|
13
|
+
|
|
14
|
+
const separatorIndex = line.indexOf('=')
|
|
15
|
+
if (separatorIndex === -1) return
|
|
16
|
+
|
|
17
|
+
const key = line.slice(0, separatorIndex).trim()
|
|
18
|
+
let value = line.slice(separatorIndex + 1).trim()
|
|
19
|
+
|
|
20
|
+
// Parse quoted values
|
|
21
|
+
value = this._parseValue(value)
|
|
22
|
+
|
|
23
|
+
process.env[key] = value
|
|
24
|
+
})
|
|
25
|
+
} catch (err) {
|
|
26
|
+
console.error('Error reading .env file:', err.message)
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
|
|
30
|
+
_parseValue: function (value) {
|
|
31
|
+
// Handle double quotes
|
|
32
|
+
if (value.startsWith('"') && value.endsWith('"')) {
|
|
33
|
+
value = value.slice(1, -1)
|
|
34
|
+
// Unescape characters
|
|
35
|
+
value = value.replace(/\\n/g, '\n')
|
|
36
|
+
value = value.replace(/\\r/g, '\r')
|
|
37
|
+
value = value.replace(/\\t/g, '\t')
|
|
38
|
+
value = value.replace(/\\"/g, '"')
|
|
39
|
+
value = value.replace(/\\\\/g, '\\')
|
|
40
|
+
return value
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
// Handle single quotes (no escaping in single quotes)
|
|
44
|
+
if (value.startsWith("'") && value.endsWith("'")) {
|
|
45
|
+
return value.slice(1, -1)
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// Unquoted value - trim inline comments
|
|
49
|
+
const commentIndex = value.indexOf('#')
|
|
50
|
+
if (commentIndex !== -1) {
|
|
51
|
+
value = value.slice(0, commentIndex).trim()
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
return value
|
|
55
|
+
},
|
|
56
|
+
|
|
57
|
+
get: function (key, defaultValue) {
|
|
58
|
+
return process.env[key] !== undefined ? process.env[key] : defaultValue
|
|
59
|
+
}
|
|
60
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
const fs = require('fs')
|
|
2
|
+
|
|
3
|
+
class Lang {
|
|
4
|
+
#candy
|
|
5
|
+
#data = {}
|
|
6
|
+
#lang
|
|
7
|
+
|
|
8
|
+
constructor(Candy) {
|
|
9
|
+
this.#candy = Candy
|
|
10
|
+
this.set()
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
get(...args) {
|
|
14
|
+
if (typeof args[0] !== 'string') return args[0]
|
|
15
|
+
if (!this.#data[args[0]]) {
|
|
16
|
+
this.#data[args[0]] = args[0]
|
|
17
|
+
this.#save()
|
|
18
|
+
}
|
|
19
|
+
let str = this.#data[args[0]]
|
|
20
|
+
|
|
21
|
+
// Support both %s (sequential) and %s1, %s2 (numbered) placeholders
|
|
22
|
+
const hasNumberedPlaceholders = /%s\d+/.test(str)
|
|
23
|
+
|
|
24
|
+
if (hasNumberedPlaceholders) {
|
|
25
|
+
for (let i = 1; i < args.length; i++) {
|
|
26
|
+
const numberedPattern = new RegExp(`%s${i}`, 'g')
|
|
27
|
+
str = str.replace(numberedPattern, args[i])
|
|
28
|
+
}
|
|
29
|
+
} else {
|
|
30
|
+
for (let i = 1; i < args.length; i++) {
|
|
31
|
+
str = str.replace('%s', args[i])
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
return str
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
#save() {
|
|
38
|
+
if (!this.#lang) return
|
|
39
|
+
if (!fs.existsSync(__dir + '/storage/')) fs.mkdirSync(__dir + '/storage/')
|
|
40
|
+
if (!fs.existsSync(__dir + '/storage/language/')) fs.mkdirSync(__dir + '/storage/language/')
|
|
41
|
+
fs.writeFileSync(__dir + '/storage/language/' + this.#lang + '.json', JSON.stringify(this.#data, null, 4))
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
set(lang) {
|
|
45
|
+
if (!lang || lang.length !== 2 || !this.#candy.Var(lang).is('alpha')) {
|
|
46
|
+
if (this.#candy.Request.header('ACCEPT-LANGUAGE') && this.#candy.Request.header('ACCEPT-LANGUAGE').length > 1)
|
|
47
|
+
lang = this.#candy.Request.header('ACCEPT-LANGUAGE').substr(0, 2)
|
|
48
|
+
else lang = this.#candy.Config.lang?.default || 'en'
|
|
49
|
+
}
|
|
50
|
+
this.#lang = lang
|
|
51
|
+
if (fs.existsSync(__dir + '/storage/language/' + lang + '.json'))
|
|
52
|
+
this.#data = JSON.parse(fs.readFileSync(__dir + '/storage/language/' + lang + '.json'))
|
|
53
|
+
else this.#data = {}
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
module.exports = Lang
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
const axios = require('axios')
|
|
2
|
+
const fs = require('fs')
|
|
3
|
+
|
|
4
|
+
class Mail {
|
|
5
|
+
#header = {}
|
|
6
|
+
#from
|
|
7
|
+
#subject = ''
|
|
8
|
+
#template
|
|
9
|
+
#to
|
|
10
|
+
|
|
11
|
+
constructor(template) {
|
|
12
|
+
this.#template = template
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
header(header) {
|
|
16
|
+
this.#header = header
|
|
17
|
+
return this
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
from(email, name) {
|
|
21
|
+
this.#from = {email: email, name: name}
|
|
22
|
+
return this
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
subject(subject) {
|
|
26
|
+
this.#subject = subject
|
|
27
|
+
return this
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
to(email) {
|
|
31
|
+
email = {value: [{address: email}]}
|
|
32
|
+
this.#to = email
|
|
33
|
+
return this
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
send(data) {
|
|
37
|
+
return new Promise(resolve => {
|
|
38
|
+
if (!fs.existsSync(__dir + '/view/mail/' + this.#template + '.html')) return console.log('Template not found') && false
|
|
39
|
+
if (!this.#from || !this.#subject || !this.#to) return console.log('From, Subject and To fields are required') && false
|
|
40
|
+
if (!Candy.Var(this.#from.email).is('email')) return console.log('From field is not a valid e-mail address') && false
|
|
41
|
+
if (!Candy.Var(this.#to.value[0].address).is('email')) return console.log('To field is not a valid e-mail address') && false
|
|
42
|
+
if (!this.#header['From']) this.#header['From'] = `${this.#from.name} <${this.#from.email}>`
|
|
43
|
+
if (!this.#header['To']) this.#header['To'] = this.#to
|
|
44
|
+
if (!this.#header['Subject']) this.#header['Subject'] = this.#subject
|
|
45
|
+
if (!this.#header['Message-ID']) this.#header['Message-ID'] = `<${crypto.randomBytes(16).toString('hex')}-${Date.now()}@candypack>`
|
|
46
|
+
if (!this.#header['Content-Transfer-Encoding']) this.#header['Content-Transfer-Encoding'] = 'quoted-printable'
|
|
47
|
+
if (!this.#header['Date']) this.#header['Date'] = new Date().toUTCString()
|
|
48
|
+
if (!this.#header['Content-Type'])
|
|
49
|
+
this.#header['Content-Type'] = 'multipart/alternative; boundary="----=' + crypto.randomBytes(32).toString('hex') + '"'
|
|
50
|
+
if (!this.#header['X-Mailer']) this.#header['X-Mailer'] = 'CandyPack'
|
|
51
|
+
if (!this.#header['MIME-Version']) this.#header['MIME-Version'] = '1.0'
|
|
52
|
+
let content = fs.readFileSync(__dir + '/view/mail/' + this.#template + '.html').toString()
|
|
53
|
+
for (const iterator of Object.keys(data)) content = content.replace(new RegExp(`{${iterator}}`, 'g'), data[iterator])
|
|
54
|
+
axios
|
|
55
|
+
.post(
|
|
56
|
+
'http://127.0.0.1:1453',
|
|
57
|
+
{
|
|
58
|
+
action: 'mail.send',
|
|
59
|
+
data: [
|
|
60
|
+
{
|
|
61
|
+
subject: this.#subject,
|
|
62
|
+
from: {value: [{address: this.#from.email, name: this.#from.name}]},
|
|
63
|
+
to: this.#to,
|
|
64
|
+
header: this.#header,
|
|
65
|
+
html: content,
|
|
66
|
+
text: content.replace(/<[^>]*>?/gm, '')
|
|
67
|
+
}
|
|
68
|
+
]
|
|
69
|
+
},
|
|
70
|
+
{headers: {Authorization: Candy.Config.system.api.auth}}
|
|
71
|
+
)
|
|
72
|
+
.then(response => {
|
|
73
|
+
resolve(response.data)
|
|
74
|
+
})
|
|
75
|
+
.catch(error => {
|
|
76
|
+
console.log(error)
|
|
77
|
+
resolve(false)
|
|
78
|
+
})
|
|
79
|
+
})
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
module.exports = Mail
|