create-nexwire 4.2.4 → 4.3.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 (113) hide show
  1. package/README.md +20 -8
  2. package/express/.env +1 -1
  3. package/express/.vscode/extensions.json +6 -0
  4. package/express/.vscode/settings.json +37 -26
  5. package/express/biome.json +99 -66
  6. package/express/package.json +31 -29
  7. package/express/src/config/database.ts +48 -29
  8. package/express/src/config/index.ts +83 -83
  9. package/express/src/config/openapi.ts +6 -24
  10. package/express/src/config/queue.ts +30 -30
  11. package/express/src/config/validate.ts +50 -40
  12. package/express/src/database/migrations/sqlite/0000_init.sql +47 -47
  13. package/express/src/database/migrations/sqlite/meta/0000_snapshot.json +1 -1
  14. package/express/src/database/migrations/sqlite/meta/_journal.json +1 -1
  15. package/express/src/database/schema.ts +2 -2
  16. package/express/src/framework/cache/cache.ts +40 -8
  17. package/express/src/framework/circuit-breaker/cb.ts +88 -60
  18. package/express/src/framework/database/connection.ts +52 -27
  19. package/express/src/framework/events/dispatcher.ts +61 -49
  20. package/express/src/framework/facade.ts +46 -3
  21. package/express/src/framework/http/app.ts +28 -22
  22. package/express/src/framework/http/logger.ts +27 -16
  23. package/express/src/framework/http/openapi.ts +9 -11
  24. package/express/src/framework/modules/routes.ts +26 -21
  25. package/express/src/framework/notification/channels/broadcast.ts +15 -0
  26. package/express/src/framework/notification/channels/mail.ts +40 -0
  27. package/express/src/framework/notification/contracts.ts +29 -0
  28. package/express/src/framework/notification/index.ts +19 -94
  29. package/express/src/framework/notification/registry.ts +15 -0
  30. package/express/src/framework/providers/adapter.ts +27 -17
  31. package/express/src/framework/queue/queue.ts +43 -44
  32. package/express/src/framework/realtime/broadcast.ts +29 -5
  33. package/express/src/framework/realtime/socket.ts +149 -119
  34. package/express/src/framework/redis/client.ts +148 -151
  35. package/express/src/framework/runtime/server-adapter.ts +39 -34
  36. package/express/src/framework/scheduler/lock.ts +128 -116
  37. package/express/src/framework/server.ts +33 -49
  38. package/express/src/framework/session/session.ts +69 -14
  39. package/express/src/framework/storage/storage.ts +744 -785
  40. package/express/src/framework/support/mail.ts +15 -7
  41. package/express/src/providers/notification.ts +4 -0
  42. package/express/src/resources/src/components/Checkbox.vue +32 -29
  43. package/express/src/resources/src/components/Input.vue +243 -223
  44. package/express/src/resources/src/components/InputGroup.vue +147 -145
  45. package/express/src/resources/src/components/InputPasswordToggle.vue +229 -213
  46. package/express/src/resources/src/components/Modal.vue +71 -55
  47. package/express/src/resources/src/components/Refresh.vue +19 -0
  48. package/express/src/resources/src/helpers/assets.ts +51 -0
  49. package/express/src/resources/src/layouts/Layout/Header.vue +124 -105
  50. package/express/src/resources/src/main.ts +3 -1
  51. package/express/src/resources/src/plugins/gum.ts +1 -1
  52. package/express/src/resources/src/plugins/pulse.ts +157 -147
  53. package/express/src/resources/src/stores/auth.ts +184 -164
  54. package/express/src/resources/vite.config.ts +54 -36
  55. package/express/src/storage/database/nexwire.sqlite +0 -0
  56. package/express/src/storage/logs/app.log +0 -0
  57. package/express/src/storage/logs/fatal.log +0 -0
  58. package/express/src/types/global.d.ts +32 -26
  59. package/hono/.env +1 -1
  60. package/hono/.vscode/extensions.json +6 -0
  61. package/hono/.vscode/settings.json +37 -26
  62. package/hono/biome.json +25 -2
  63. package/hono/package.json +25 -23
  64. package/hono/src/config/database.ts +48 -29
  65. package/hono/src/config/index.ts +83 -83
  66. package/hono/src/config/openapi.ts +6 -24
  67. package/hono/src/config/queue.ts +30 -30
  68. package/hono/src/config/validate.ts +50 -40
  69. package/hono/src/database/migrations/sqlite/0000_init.sql +47 -47
  70. package/hono/src/database/migrations/sqlite/meta/0000_snapshot.json +1 -1
  71. package/hono/src/database/migrations/sqlite/meta/_journal.json +1 -1
  72. package/hono/src/database/schema.ts +2 -2
  73. package/hono/src/framework/cache/cache.ts +40 -8
  74. package/hono/src/framework/circuit-breaker/cb.ts +88 -60
  75. package/hono/src/framework/database/connection.ts +52 -27
  76. package/hono/src/framework/events/dispatcher.ts +61 -49
  77. package/hono/src/framework/facade.ts +38 -1
  78. package/hono/src/framework/http/openapi.ts +7 -9
  79. package/hono/src/framework/notification/channels/broadcast.ts +15 -0
  80. package/hono/src/framework/notification/channels/mail.ts +40 -0
  81. package/hono/src/framework/notification/contracts.ts +29 -0
  82. package/hono/src/framework/notification/index.ts +19 -94
  83. package/hono/src/framework/notification/registry.ts +15 -0
  84. package/hono/src/framework/providers/adapter.ts +27 -17
  85. package/hono/src/framework/queue/queue.ts +43 -44
  86. package/hono/src/framework/realtime/broadcast.ts +29 -5
  87. package/hono/src/framework/realtime/socket.ts +217 -196
  88. package/hono/src/framework/redis/client.ts +148 -151
  89. package/hono/src/framework/scheduler/lock.ts +128 -116
  90. package/hono/src/framework/server.ts +27 -29
  91. package/hono/src/framework/session/session.ts +62 -14
  92. package/hono/src/framework/storage/storage.ts +744 -785
  93. package/hono/src/framework/support/mail.ts +56 -48
  94. package/hono/src/providers/notification.ts +4 -0
  95. package/hono/src/resources/src/components/Checkbox.vue +32 -29
  96. package/hono/src/resources/src/components/Input.vue +243 -234
  97. package/hono/src/resources/src/components/InputGroup.vue +147 -149
  98. package/hono/src/resources/src/components/InputPasswordToggle.vue +229 -222
  99. package/hono/src/resources/src/components/Modal.vue +71 -55
  100. package/hono/src/resources/src/components/Refresh.vue +19 -0
  101. package/hono/src/resources/src/helpers/assets.ts +51 -0
  102. package/hono/src/resources/src/layouts/Layout/Header.vue +124 -105
  103. package/hono/src/resources/src/main.ts +3 -1
  104. package/hono/src/resources/src/plugins/gum.ts +1 -1
  105. package/hono/src/resources/src/plugins/pulse.ts +157 -147
  106. package/hono/src/resources/src/stores/auth.ts +184 -164
  107. package/hono/src/resources/vite.config.ts +54 -36
  108. package/hono/src/storage/database/nexwire.sqlite +0 -0
  109. package/hono/src/storage/logs/app.log +0 -0
  110. package/hono/src/storage/logs/fatal.log +0 -0
  111. package/hono/src/types/global.d.ts +32 -26
  112. package/package.json +2 -2
  113. package/src/index.js +139 -14
package/hono/package.json CHANGED
@@ -1,16 +1,17 @@
1
1
  {
2
2
  "name": "nexwire-hono",
3
- "private": true,
4
- "type": "module",
5
3
  "version": "1.0.0",
4
+ "private": true,
6
5
  "bin": {
7
6
  "maker": "./src/framework/maker-cli/index.mjs"
8
7
  },
8
+ "type": "module",
9
9
  "scripts": {
10
10
  "build": "npm run build:all",
11
11
  "build:all": "npm run build:backend && npm run build:ui",
12
12
  "build:backend": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
13
- "build:ui": "node src/framework/maker-cli/runtime/build-ui.mjs",
13
+ "build:ui": "npm run typecheck:ui && node src/framework/maker-cli/runtime/build-ui.mjs",
14
+ "typecheck:ui": "vue-tsc --noEmit -p src/resources/tsconfig.json",
14
15
  "dev": "node src/framework/maker-cli/index.mjs dev",
15
16
  "backend": "node src/framework/maker-cli/index.mjs serve --src",
16
17
  "ui": "node src/framework/maker-cli/index.mjs ui:dev",
@@ -61,7 +62,7 @@
61
62
  "ioredis": "^5.11.1",
62
63
  "lodash-es": "^4.18.1",
63
64
  "luxon": "^3.7.2",
64
- "maildev": "^3.0.0",
65
+ "maildev": "^2.2.1",
65
66
  "mysql2": "^3.23.3",
66
67
  "nodemailer": "^10.2.1",
67
68
  "pinia": "^3.0.4",
@@ -78,6 +79,19 @@
78
79
  "vue-select": "^4.0.0-beta.6",
79
80
  "zod": "^4.6.7"
80
81
  },
82
+ "devDependencies": {
83
+ "@biomejs/biome": "^2.5.7",
84
+ "@types/bootstrap": "^5.2.11",
85
+ "@types/lodash-es": "^4.17.12",
86
+ "@types/node": "^25.9.9",
87
+ "@vitest/coverage-v8": "^5.0.5",
88
+ "drizzle-kit": "^0.31.11",
89
+ "tsc-alias": "^1.9.9",
90
+ "tsx": "^4.23.15",
91
+ "typescript": "^6.0.3",
92
+ "vitest": "^5.0.5",
93
+ "vue-tsc": "^3.3.13"
94
+ },
81
95
  "overrides": {
82
96
  "@esbuild-kit/core-utils": {
83
97
  "esbuild": "^0.25.12"
@@ -96,29 +110,17 @@
96
110
  "bcryptjs": "^3.0.3"
97
111
  }
98
112
  },
113
+ "engines": {
114
+ "bun": ">=1.3",
115
+ "node": ">=22.12.0",
116
+ "pnpm": ">=11",
117
+ "yarn": ">=4"
118
+ },
99
119
  "allowScripts": {
100
120
  "@parcel/watcher": true,
101
121
  "esbuild": true,
102
122
  "msgpackr-extract": true,
103
123
  "redis-commander": true,
104
124
  "vue-demi": true
105
- },
106
- "devDependencies": {
107
- "@biomejs/biome": "^2.5.7",
108
- "@types/bootstrap": "^5.2.11",
109
- "@types/lodash-es": "^4.17.12",
110
- "@types/node": "^25.9.9",
111
- "@vitest/coverage-v8": "^5.0.5",
112
- "drizzle-kit": "^0.31.11",
113
- "tsc-alias": "^1.9.9",
114
- "tsx": "^4.23.15",
115
- "typescript": "^6.0.3",
116
- "vitest": "^5.0.5"
117
- },
118
- "engines": {
119
- "node": ">=22.12.0",
120
- "bun": ">=1.3",
121
- "pnpm": ">=11",
122
- "yarn": ">=4"
123
125
  }
124
- }
126
+ }
@@ -1,29 +1,48 @@
1
- import { env } from "@/env.js";
2
-
3
- /**
4
- * Why: Database connection settings for Drizzle.
5
- * When: Database bootstrap and dialect detection.
6
- * Where: src/config/database.ts.
7
- * How: The connection URL contains credentials, so it stays in .env
8
- * (`DATABASE_URL`). Dialect is derived from the URL prefix.
9
- */
10
- export const databaseConfig = {
11
- url: env.DATABASE_URL
12
- };
13
-
14
- export type DatabaseConfig = typeof databaseConfig;
15
-
16
- /**
17
- * Why: Maps a connection URL to its Drizzle dialect.
18
- * When: Selecting the pool driver and dialect-specific branching.
19
- * Where: Framework database connection helpers.
20
- * How: Matches the URL prefix; anything that isn't mysql/postgres is sqlite.
21
- */
22
- export function detectDialectFrom(url: string): "sqlite" | "mysql" | "postgresql" {
23
- const value = url.toLowerCase();
24
- if (value.startsWith("mysql")) return "mysql";
25
- if (value.startsWith("postgres")) return "postgresql";
26
- return "sqlite";
27
- }
28
-
29
- export const databaseDialect = detectDialectFrom(databaseConfig.url);
1
+ import { env } from "@/env.js";
2
+
3
+ /**
4
+ * Why: Database connection settings.
5
+ * When: Database bootstrap and dialect detection.
6
+ * Where: src/config/database.ts.
7
+ * How: Only DATABASE_URL is required. Pool settings use generic,
8
+ * provider-agnostic defaults.
9
+ */
10
+
11
+ const rawUrl = env.DATABASE_URL;
12
+
13
+ export const databaseConfig = {
14
+ // If it's sqlite, convert "sqlite:./db.sqlite" to "file:./db.sqlite"
15
+ url: rawUrl.startsWith("sqlite:") ? `file:${rawUrl.slice("sqlite:".length)}` : rawUrl,
16
+
17
+ /** Generic, sensible pool defaults for any provider */
18
+ pool: {
19
+ max: 10,
20
+ idleTimeout: 20000, // ms
21
+ connectTimeout: 10000, // ms
22
+ keepAlive: true
23
+ },
24
+
25
+ /**
26
+ * Default to true. If a provider (like a pooler) doesn't support it,
27
+ * they usually indicate this in the connection string or require the user
28
+ * to handle it at the driver level.
29
+ */
30
+ prepare: true,
31
+
32
+ /**
33
+ * Require TLS for MySQL and PostgreSQL connections. Set this to true, or
34
+ * append `?sslmode=require` to DATABASE_URL if your provider documents that.
35
+ */
36
+ ssl: false
37
+ };
38
+
39
+ export type DatabaseConfig = typeof databaseConfig;
40
+
41
+ export function detectDialectFrom(url: string): "sqlite" | "mysql" | "postgresql" {
42
+ const value = url.toLowerCase();
43
+ if (value.startsWith("mysql")) return "mysql";
44
+ if (value.startsWith("postgres")) return "postgresql";
45
+ return "sqlite";
46
+ }
47
+
48
+ export const databaseDialect = detectDialectFrom(rawUrl);
@@ -1,83 +1,83 @@
1
- import { type AppConfig, appConfig } from "./app.js";
2
- import { type AuthConfig, authConfig } from "./auth.js";
3
- import { type CacheConfig, cacheConfig } from "./cache.js";
4
- import { type CookieConfig, cookieConfig } from "./cookie.js";
5
- import { type CorsConfig, corsConfig } from "./cors.js";
6
- import { type DatabaseConfig, databaseConfig } from "./database.js";
7
- import { type JwtConfig, jwtConfig } from "./jwt.js";
8
- import { type LoggingConfig, loggingConfig } from "./logging.js";
9
- import { type MailConfig, mailConfig } from "./mail.js";
10
- import { type OpenApiConfig, openApiConfig } from "./openapi.js";
11
- import { type QueueConfig, queueConfig } from "./queue.js";
12
- import { type RateLimitConfig, rateLimitConfig } from "./rateLimit.js";
13
- import { type RealtimeConfig, realtimeConfig } from "./realtime.js";
14
- import { type RedisConfig, redisConfig } from "./redis.js";
15
- import { type SecurityConfig, securityConfig } from "./security.js";
16
- import { type SessionConfig, sessionConfig } from "./session.js";
17
- import { type StorageConfig, storageConfig } from "./storage.js";
18
-
19
- export { appConfig } from "./app.js";
20
- export { authConfig } from "./auth.js";
21
- export { cacheConfig } from "./cache.js";
22
- export { cookieConfig } from "./cookie.js";
23
- export { corsConfig } from "./cors.js";
24
- export { databaseConfig } from "./database.js";
25
- export { jwtConfig } from "./jwt.js";
26
- export { loggingConfig } from "./logging.js";
27
- export { mailConfig } from "./mail.js";
28
- export { openApiConfig } from "./openapi.js";
29
- export { queueConfig } from "./queue.js";
30
- export { rateLimitConfig } from "./rateLimit.js";
31
- export { realtimeConfig } from "./realtime.js";
32
- export { redisConfig } from "./redis.js";
33
- export { securityConfig } from "./security.js";
34
- export { sessionConfig } from "./session.js";
35
- export { storageConfig } from "./storage.js";
36
-
37
- /**
38
- * Why: Single import point for every config domain.
39
- * When: Application code needs configuration values.
40
- * Where: Imported as `import { config } from "@/config/index.js"`.
41
- * How: Aggregates per-domain config objects; individual files remain the
42
- * place to edit each setting.
43
- */
44
- export const config = {
45
- app: appConfig,
46
- auth: authConfig,
47
- cache: cacheConfig,
48
- cookie: cookieConfig,
49
- cors: corsConfig,
50
- database: databaseConfig,
51
- jwt: jwtConfig,
52
- logging: loggingConfig,
53
- mail: mailConfig,
54
- openApi: openApiConfig,
55
- queue: queueConfig,
56
- rateLimit: rateLimitConfig,
57
- realtime: realtimeConfig,
58
- redis: redisConfig,
59
- session: sessionConfig,
60
- security: securityConfig,
61
- storage: storageConfig
62
- } as const;
63
-
64
- export type Config = typeof config;
65
- export type {
66
- AppConfig,
67
- AuthConfig,
68
- CacheConfig,
69
- CookieConfig,
70
- CorsConfig,
71
- DatabaseConfig,
72
- JwtConfig,
73
- LoggingConfig,
74
- MailConfig,
75
- OpenApiConfig,
76
- QueueConfig,
77
- RateLimitConfig,
78
- RealtimeConfig,
79
- RedisConfig,
80
- SecurityConfig,
81
- SessionConfig,
82
- StorageConfig
83
- };
1
+ import { type AppConfig, appConfig } from "./app.js";
2
+ import { type AuthConfig, authConfig } from "./auth.js";
3
+ import { type CacheConfig, cacheConfig } from "./cache.js";
4
+ import { type CookieConfig, cookieConfig } from "./cookie.js";
5
+ import { type CorsConfig, corsConfig } from "./cors.js";
6
+ import { type DatabaseConfig, databaseConfig } from "./database.js";
7
+ import { type JwtConfig, jwtConfig } from "./jwt.js";
8
+ import { type LoggingConfig, loggingConfig } from "./logging.js";
9
+ import { type MailConfig, mailConfig } from "./mail.js";
10
+ import { type OpenApiConfig, openApiConfig } from "./openapi.js";
11
+ import { type QueueConfig, queueConfig } from "./queue.js";
12
+ import { type RateLimitConfig, rateLimitConfig } from "./rateLimit.js";
13
+ import { type RealtimeConfig, realtimeConfig } from "./realtime.js";
14
+ import { type RedisConfig, redisConfig } from "./redis.js";
15
+ import { type SecurityConfig, securityConfig } from "./security.js";
16
+ import { type SessionConfig, sessionConfig } from "./session.js";
17
+ import { type StorageConfig, storageConfig } from "./storage.js";
18
+
19
+ export { appConfig } from "./app.js";
20
+ export { authConfig } from "./auth.js";
21
+ export { cacheConfig } from "./cache.js";
22
+ export { cookieConfig } from "./cookie.js";
23
+ export { corsConfig } from "./cors.js";
24
+ export { databaseConfig, databaseDialect, detectDialectFrom } from "./database.js";
25
+ export { jwtConfig } from "./jwt.js";
26
+ export { loggingConfig } from "./logging.js";
27
+ export { mailConfig } from "./mail.js";
28
+ export { openApiConfig } from "./openapi.js";
29
+ export { queueConfig } from "./queue.js";
30
+ export { rateLimitConfig } from "./rateLimit.js";
31
+ export { realtimeConfig } from "./realtime.js";
32
+ export { redisConfig } from "./redis.js";
33
+ export { securityConfig } from "./security.js";
34
+ export { sessionConfig } from "./session.js";
35
+ export { storageConfig } from "./storage.js";
36
+
37
+ /**
38
+ * Why: Single import point for every config domain.
39
+ * When: Application code needs configuration values.
40
+ * Where: Imported as `import { config } from "@/config/index.js"`.
41
+ * How: Aggregates per-domain config objects; individual files remain the
42
+ * place to edit each setting.
43
+ */
44
+ export const config = {
45
+ app: appConfig,
46
+ auth: authConfig,
47
+ cache: cacheConfig,
48
+ cookie: cookieConfig,
49
+ cors: corsConfig,
50
+ database: databaseConfig,
51
+ jwt: jwtConfig,
52
+ logging: loggingConfig,
53
+ mail: mailConfig,
54
+ openApi: openApiConfig,
55
+ queue: queueConfig,
56
+ rateLimit: rateLimitConfig,
57
+ realtime: realtimeConfig,
58
+ redis: redisConfig,
59
+ session: sessionConfig,
60
+ security: securityConfig,
61
+ storage: storageConfig
62
+ } as const;
63
+
64
+ export type Config = typeof config;
65
+ export type {
66
+ AppConfig,
67
+ AuthConfig,
68
+ CacheConfig,
69
+ CookieConfig,
70
+ CorsConfig,
71
+ DatabaseConfig,
72
+ JwtConfig,
73
+ LoggingConfig,
74
+ MailConfig,
75
+ OpenApiConfig,
76
+ QueueConfig,
77
+ RateLimitConfig,
78
+ RealtimeConfig,
79
+ RedisConfig,
80
+ SecurityConfig,
81
+ SessionConfig,
82
+ StorageConfig
83
+ };
@@ -8,46 +8,28 @@ import { appConfig } from "./app.js";
8
8
  * and the Scalar docs UI appearance.
9
9
  */
10
10
  export const openApiConfig = {
11
- /** OpenAPI spec version */
12
11
  version: "3.0.0",
13
-
14
- /** API title shown in docs and the /doc spec */
15
12
  title: `${appConfig.name} API`,
16
-
17
- /** API version shown in docs */
18
13
  apiVersion: "1.0.0",
19
-
20
- /** Optional description shown in the /doc spec */
21
14
  description: "",
22
15
 
23
16
  /** Scalar docs UI settings */
24
17
  scalar: {
25
- /** URL path to the OpenAPI JSON spec */
26
- specUrl: "/doc",
27
-
28
- /** URL path to the interactive docs UI */
29
- docsPath: "/api-docs",
30
-
31
- /** UI layout: "classic" or "modern" */
32
- layout: "classic" as const,
33
-
18
+ specUrl: "/doc", // URL path to the OpenAPI JSON spec
19
+ docsPath: "/api-docs", // URL path to the interactive docs UI
20
+ layout: "classic" as const, // UI layout: "classic" or "modern"
34
21
  /** UI theme: "default", "moon", "purple", "solarized", "bluePlanet", "fastify", "kepler", "mars", "nebula", "none" */
35
22
  theme: "moon" as const,
36
-
37
- /** HTML page title for the /api-docs page */
38
- pageTitle: `${appConfig.name} API`,
39
-
23
+ pageTitle: `${appConfig.name} API`, // HTML page title for the /api-docs page
40
24
  /** Favicon file (project-relative) served at /favicon.ico for the /api-docs page */
41
25
  favicon: "src/resources/src/assets/images/favicon/favicon.ico",
42
-
43
26
  /** Default HTTP client shown in code examples */
44
27
  defaultHttpClient: {
45
28
  targetKey: "js" as const,
46
29
  clientKey: "fetch" as const
47
30
  },
48
-
49
- /** Expand all tags on load */
50
- defaultOpenAllTags: true
31
+ defaultOpenAllTags: true, // Expand all tags on load
32
+ showDeveloperTools: "never"
51
33
  }
52
34
  } as const;
53
35
 
@@ -1,30 +1,30 @@
1
- import { redisConfig } from "./redis.js";
2
-
3
- /**
4
- * Why: Queue workers, concurrency, and BullMQ key namespaces.
5
- * When: The queue facade bootstraps workers and the dashboard connects.
6
- * Where: src/config/queue.ts.
7
- * How: `queues` lists which queue names get a worker by default (default,
8
- * mail, maintenance). `concurrency` caps parallel jobs per worker.
9
- * Key prefixes derive from the shared `REDIS_PREFIX`.
10
- */
11
- export const queueConfig = {
12
- queues: ["default", "mail", "maintenance"],
13
- concurrency: 10,
14
- /**
15
- * autoPruneQueues
16
- * Why: Automatically deletes phantom queues (Redis keys for queue names that
17
- * no longer exist in `queues`) when a queue worker boots. Safe because
18
- * only empty, unconfigured queues are removed, and BullMQ recreates a
19
- * queue's keys on demand if code still dispatches to it.
20
- * When: Set false to disable automatic pruning and rely on manual
21
- * `queue:clear` instead.
22
- */
23
- autoPruneQueues: true,
24
- prefix: `${redisConfig.prefix}:queue`,
25
- durablePrefix: `${redisConfig.prefix}:durable`,
26
- queueUi: "/queues",
27
- allowedEmails: ""
28
- };
29
-
30
- export type QueueConfig = typeof queueConfig;
1
+ import { redisConfig } from "./redis.js";
2
+
3
+ /**
4
+ * Why: Queue workers, concurrency, and BullMQ key namespaces.
5
+ * When: The queue facade bootstraps workers and the dashboard connects.
6
+ * Where: src/config/queue.ts.
7
+ * How: `queues` lists which queue names get a worker by default (default,
8
+ * mail, maintenance). `concurrency` caps parallel jobs per worker.
9
+ * Key prefixes derive from the shared `REDIS_PREFIX`.
10
+ */
11
+ export const queueConfig = {
12
+ queues: ["default", "mail", "maintenance"],
13
+ concurrency: 10,
14
+ /**
15
+ * autoPruneQueues
16
+ * Why: Automatically deletes phantom queues (Redis keys for queue names that
17
+ * no longer exist in `queues`) when a queue worker boots. Safe because
18
+ * only empty, unconfigured queues are removed, and BullMQ recreates a
19
+ * queue's keys on demand if code still dispatches to it.
20
+ * When: Set false to disable automatic pruning and rely on manual
21
+ * `queue:clear` instead.
22
+ */
23
+ autoPruneQueues: true,
24
+ prefix: `${redisConfig.prefix}:queue`,
25
+ durablePrefix: `${redisConfig.prefix}:durable`,
26
+ queueUi: "/queues",
27
+ allowedEmails: "" // Comma-separated list of email addresses allowed to access the queue UI. Empty means no restriction.
28
+ };
29
+
30
+ export type QueueConfig = typeof queueConfig;
@@ -1,40 +1,50 @@
1
- import { databaseConfig } from "./database.js";
2
- import { mailConfig } from "./mail.js";
3
- import { redisConfig } from "./redis.js";
4
- import { storageConfig } from "./storage.js";
5
-
6
- /**
7
- * Why: Validates that resolved configs are internally consistent at startup.
8
- * When: Called before any framework subsystem initializes.
9
- * Where: kernel.ts, before storage.init() and initRedis().
10
- * How: Checks cross-config dependencies and throws clear errors for inconsistencies.
11
- */
12
- export function validateConfig(): void {
13
- if (!databaseConfig.url) {
14
- throw new Error("DATABASE_URL is required but is empty");
15
- }
16
-
17
- if (storageConfig.driver === "s3") {
18
- if (!storageConfig.bucket) {
19
- throw new Error("STORAGE_BUCKET is required when storage driver is s3");
20
- }
21
- if (!storageConfig.accessKeyId || !storageConfig.secretAccessKey) {
22
- throw new Error("STORAGE_ACCESS_KEY_ID and STORAGE_SECRET_ACCESS_KEY are required when storage driver is s3");
23
- }
24
- }
25
-
26
- if (redisConfig.enabled) {
27
- try {
28
- const url = new URL(redisConfig.url);
29
- if (!url.hostname || url.port === "") {
30
- throw new Error(`REDIS_URL is invalid: "${redisConfig.url}" — must include host and port`);
31
- }
32
- } catch (error) {
33
- throw new Error(`REDIS_URL is invalid: "${redisConfig.url}" — ${error instanceof Error ? error.message : error}`);
34
- }
35
- }
36
-
37
- if (!mailConfig.failSilent && !mailConfig.username) {
38
- throw new Error("MAIL_USERNAME is required when MAIL_FAIL_SILENT is false");
39
- }
40
- }
1
+ import { databaseConfig } from "./database.js";
2
+ import { mailConfig } from "./mail.js";
3
+ import { redisConfig } from "./redis.js";
4
+ import { storageConfig } from "./storage.js";
5
+
6
+ /**
7
+ * Why: Validates that resolved configs are internally consistent at startup.
8
+ * When: Called before any framework subsystem initializes.
9
+ * Where: kernel.ts, before storage.init() and initRedis().
10
+ * How: Checks cross-config dependencies and throws clear errors for inconsistencies.
11
+ */
12
+ export function validateConfig(): void {
13
+ if (!databaseConfig.url) {
14
+ throw new Error("DATABASE_URL is required but is empty");
15
+ }
16
+
17
+ if (storageConfig.driver === "s3") {
18
+ if (!storageConfig.bucket) {
19
+ throw new Error("STORAGE_BUCKET is required when storage driver is s3");
20
+ }
21
+ if (!storageConfig.accessKeyId || !storageConfig.secretAccessKey) {
22
+ throw new Error("STORAGE_ACCESS_KEY_ID and STORAGE_SECRET_ACCESS_KEY are required when storage driver is s3");
23
+ }
24
+ }
25
+
26
+ if (redisConfig.enabled) {
27
+ try {
28
+ const url = new URL(redisConfig.url);
29
+
30
+ // Ensure it starts with redis:// or rediss://
31
+ if (url.protocol !== "redis:" && url.protocol !== "rediss:") {
32
+ throw new Error("URL must start with redis:// or rediss://");
33
+ }
34
+
35
+ // Hostname is mandatory (e.g., localhost, 127.0.0.1, redis-container)
36
+ if (!url.hostname) {
37
+ throw new Error("URL must include a valid hostname");
38
+ }
39
+
40
+ // Note: We do NOT check if the port is empty.
41
+ // ioredis automatically defaults to 6379 if no port is provided.
42
+ } catch (error) {
43
+ throw new Error(`REDIS_URL is invalid: "${redisConfig.url}" — ${error instanceof Error ? error.message : error}`);
44
+ }
45
+ }
46
+
47
+ if (!mailConfig.failSilent && !mailConfig.username) {
48
+ throw new Error("MAIL_USERNAME is required when MAIL_FAIL_SILENT is false");
49
+ }
50
+ }
@@ -1,48 +1,48 @@
1
- CREATE TABLE `roles` (
2
- `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
3
- `name` text NOT NULL,
4
- `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
5
- `updated_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL
6
- );
7
- --> statement-breakpoint
8
- CREATE UNIQUE INDEX `roles_name_unique` ON `roles` (`name`);--> statement-breakpoint
9
- CREATE TABLE `email_verification_tokens` (
10
- `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
11
- `email` text NOT NULL,
12
- `token` text NOT NULL,
13
- `expires_at` integer NOT NULL,
14
- `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL
15
- );
16
- --> statement-breakpoint
17
- CREATE TABLE `password_reset_tokens` (
18
- `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
19
- `email` text NOT NULL,
20
- `token` text NOT NULL,
21
- `expires_at` integer NOT NULL,
22
- `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL
23
- );
24
- --> statement-breakpoint
25
- CREATE TABLE `refresh_tokens` (
26
- `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
27
- `user_id` integer,
28
- `jti` text NOT NULL,
29
- `revoked` integer DEFAULT false,
30
- `expires_at` integer NOT NULL,
31
- `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
32
- FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE cascade ON DELETE set null
33
- );
34
- --> statement-breakpoint
35
- CREATE UNIQUE INDEX `refresh_tokens_jti_unique` ON `refresh_tokens` (`jti`);--> statement-breakpoint
36
- CREATE TABLE `users` (
37
- `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
38
- `name` text NOT NULL,
39
- `email` text NOT NULL,
40
- `password` text NOT NULL,
41
- `role_id` integer,
42
- `email_verified_at` integer,
43
- `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
44
- `updated_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
45
- FOREIGN KEY (`role_id`) REFERENCES `roles`(`id`) ON UPDATE cascade ON DELETE set null
46
- );
47
- --> statement-breakpoint
1
+ CREATE TABLE `roles` (
2
+ `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
3
+ `name` text NOT NULL,
4
+ `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
5
+ `updated_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL
6
+ );
7
+ --> statement-breakpoint
8
+ CREATE UNIQUE INDEX `roles_name_unique` ON `roles` (`name`);--> statement-breakpoint
9
+ CREATE TABLE `email_verification_tokens` (
10
+ `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
11
+ `email` text NOT NULL,
12
+ `token` text NOT NULL,
13
+ `expires_at` integer NOT NULL,
14
+ `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL
15
+ );
16
+ --> statement-breakpoint
17
+ CREATE TABLE `password_reset_tokens` (
18
+ `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
19
+ `email` text NOT NULL,
20
+ `token` text NOT NULL,
21
+ `expires_at` integer NOT NULL,
22
+ `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL
23
+ );
24
+ --> statement-breakpoint
25
+ CREATE TABLE `refresh_tokens` (
26
+ `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
27
+ `user_id` integer,
28
+ `jti` text NOT NULL,
29
+ `revoked` integer DEFAULT false,
30
+ `expires_at` integer NOT NULL,
31
+ `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
32
+ FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE cascade ON DELETE set null
33
+ );
34
+ --> statement-breakpoint
35
+ CREATE UNIQUE INDEX `refresh_tokens_jti_unique` ON `refresh_tokens` (`jti`);--> statement-breakpoint
36
+ CREATE TABLE `users` (
37
+ `id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
38
+ `name` text NOT NULL,
39
+ `email` text NOT NULL,
40
+ `password` text NOT NULL,
41
+ `role_id` integer,
42
+ `email_verified_at` integer,
43
+ `created_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
44
+ `updated_at` integer DEFAULT (cast((julianday('now') - 2440587.5)*86400000 as integer)) NOT NULL,
45
+ FOREIGN KEY (`role_id`) REFERENCES `roles`(`id`) ON UPDATE cascade ON DELETE set null
46
+ );
47
+ --> statement-breakpoint
48
48
  CREATE UNIQUE INDEX `users_email_unique` ON `users` (`email`);
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": "6",
3
3
  "dialect": "sqlite",
4
- "id": "f0fe475e-8a3e-4c5c-9b5e-9ec41ddfde71",
4
+ "id": "af502348-be37-45c6-84e4-df4db9f31bfb",
5
5
  "prevId": "00000000-0000-0000-0000-000000000000",
6
6
  "tables": {
7
7
  "roles": {
@@ -5,7 +5,7 @@
5
5
  {
6
6
  "idx": 0,
7
7
  "version": "6",
8
- "when": 1792936160057,
8
+ "when": 1793719238470,
9
9
  "tag": "0000_init",
10
10
  "breakpoints": true
11
11
  }