stratal 0.0.17 → 0.0.18

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 (178) hide show
  1. package/dist/{base-email.provider-DypUAfWm.mjs → base-email.provider-Cuw4OAB0.mjs} +1 -1
  2. package/dist/{base-email.provider-DypUAfWm.mjs.map → base-email.provider-Cuw4OAB0.mjs.map} +1 -1
  3. package/dist/bin/cloudflare-workers-loader.mjs +33 -1
  4. package/dist/bin/cloudflare-workers-loader.mjs.map +1 -1
  5. package/dist/bin/quarry.mjs +182 -5
  6. package/dist/bin/quarry.mjs.map +1 -1
  7. package/dist/cache/index.d.mts +2 -2
  8. package/dist/cache/index.d.mts.map +1 -1
  9. package/dist/cache/index.mjs +3 -10
  10. package/dist/cache/index.mjs.map +1 -1
  11. package/dist/{colors-Y7WIFXs7.mjs → colors-BTAnQRGU.mjs} +1 -1
  12. package/dist/{colors-Y7WIFXs7.mjs.map → colors-BTAnQRGU.mjs.map} +1 -1
  13. package/dist/{command-TnkPYWta.d.mts → command-B1YuV-UZ.d.mts} +2 -2
  14. package/dist/{command-TnkPYWta.d.mts.map → command-B1YuV-UZ.d.mts.map} +1 -1
  15. package/dist/{command-B1CPgsrU.mjs → command-DjGqCYHv.mjs} +3 -3
  16. package/dist/command-DjGqCYHv.mjs.map +1 -0
  17. package/dist/config/index.d.mts +2 -2
  18. package/dist/config/index.mjs +12 -19
  19. package/dist/config/index.mjs.map +1 -1
  20. package/dist/{consumer-registry-Bymm6ff4.d.mts → consumer-registry-BkuHXR_u.d.mts} +1 -1
  21. package/dist/{consumer-registry-Bymm6ff4.d.mts.map → consumer-registry-BkuHXR_u.d.mts.map} +1 -1
  22. package/dist/cron/index.d.mts +2 -2
  23. package/dist/cron/index.d.mts.map +1 -1
  24. package/dist/cron/index.mjs +1 -3
  25. package/dist/{cron-manager-CFBamKKk.mjs → cron-manager-1KnZvojs.mjs} +3 -3
  26. package/dist/{cron-manager-CFBamKKk.mjs.map → cron-manager-1KnZvojs.mjs.map} +1 -1
  27. package/dist/{cron-manager-D7imGwUT.d.mts → cron-manager-BnEZquBL.d.mts} +2 -2
  28. package/dist/{cron-manager-D7imGwUT.d.mts.map → cron-manager-BnEZquBL.d.mts.map} +1 -1
  29. package/dist/di/index.d.mts +2 -2
  30. package/dist/di/index.mjs +3 -3
  31. package/dist/email/index.d.mts +3 -3
  32. package/dist/email/index.mjs +8 -16
  33. package/dist/email/index.mjs.map +1 -1
  34. package/dist/{en-DaewN8hc.mjs → en-3QnZwP-u.mjs} +10 -1
  35. package/dist/en-3QnZwP-u.mjs.map +1 -0
  36. package/dist/errors/index.d.mts +2 -2
  37. package/dist/errors/index.mjs +2 -3
  38. package/dist/errors--RBIvDXr.mjs +1560 -0
  39. package/dist/errors--RBIvDXr.mjs.map +1 -0
  40. package/dist/{errors-DuAR5Wke.mjs → errors-B7hCnXgB.mjs} +2 -2
  41. package/dist/{errors-DuAR5Wke.mjs.map → errors-B7hCnXgB.mjs.map} +1 -1
  42. package/dist/events/index.d.mts +2 -2
  43. package/dist/events/index.mjs +1 -2
  44. package/dist/{events-CvUSgEuN.mjs → events-UTJliZhl.mjs} +2 -2
  45. package/dist/{events-CvUSgEuN.mjs.map → events-UTJliZhl.mjs.map} +1 -1
  46. package/dist/{gateway-context-CNOLkLUC.mjs → gateway-context-BdBFoQd8.mjs} +66 -10
  47. package/dist/gateway-context-BdBFoQd8.mjs.map +1 -0
  48. package/dist/guards/index.d.mts +3 -3
  49. package/dist/guards/index.d.mts.map +1 -1
  50. package/dist/guards/index.mjs +1 -1
  51. package/dist/{guards-DUk_Kzst.mjs → guards-MtDgcHnF.mjs} +1 -1
  52. package/dist/{guards-DUk_Kzst.mjs.map → guards-MtDgcHnF.mjs.map} +1 -1
  53. package/dist/i18n/index.d.mts +3 -3
  54. package/dist/i18n/index.mjs +3 -16
  55. package/dist/i18n/messages/en/index.d.mts +1 -1
  56. package/dist/i18n/messages/en/index.mjs +1 -1
  57. package/dist/i18n/utils/index.d.mts +30 -0
  58. package/dist/i18n/utils/index.d.mts.map +1 -0
  59. package/dist/i18n/utils/index.mjs +2 -0
  60. package/dist/i18n/validation/index.d.mts +1 -1
  61. package/dist/i18n/validation/index.mjs +1 -1
  62. package/dist/i18n.module-BpLLLCTg.mjs +2462 -0
  63. package/dist/i18n.module-BpLLLCTg.mjs.map +1 -0
  64. package/dist/{index-D_w_Rmtd.d.mts → index-BDh9J2KD.d.mts} +10 -1
  65. package/dist/{index-D_w_Rmtd.d.mts.map → index-BDh9J2KD.d.mts.map} +1 -1
  66. package/dist/{index-Dp6A5ywM.d.mts → index-BR23zDMy.d.mts} +1 -1
  67. package/dist/{index-Dp6A5ywM.d.mts.map → index-BR23zDMy.d.mts.map} +1 -1
  68. package/dist/index-BrmS34sa.d.mts +4287 -0
  69. package/dist/index-BrmS34sa.d.mts.map +1 -0
  70. package/dist/{index-DGRe6Yoa.d.mts → index-DPxmo6AY.d.mts} +4 -4
  71. package/dist/{index-DGRe6Yoa.d.mts.map → index-DPxmo6AY.d.mts.map} +1 -1
  72. package/dist/{index-NGxg-KP_.d.mts → index-Dfpd_ypO.d.mts} +36 -7
  73. package/dist/index-Dfpd_ypO.d.mts.map +1 -0
  74. package/dist/index.d.mts +4 -3
  75. package/dist/index.d.mts.map +1 -1
  76. package/dist/index.mjs +1 -20
  77. package/dist/{is-command-DJVI6wEJ.mjs → is-command-PvULqiTa.mjs} +2 -2
  78. package/dist/{is-command-DJVI6wEJ.mjs.map → is-command-PvULqiTa.mjs.map} +1 -1
  79. package/dist/{is-seeder-D5MIEcdz.mjs → is-seeder-BN9Ej1r7.mjs} +1 -1
  80. package/dist/{is-seeder-D5MIEcdz.mjs.map → is-seeder-BN9Ej1r7.mjs.map} +1 -1
  81. package/dist/logger/index.d.mts +1 -1
  82. package/dist/logger/index.mjs +1 -1
  83. package/dist/{logger-CGT91VY6.mjs → logger-c0ftIK4G.mjs} +29 -29
  84. package/dist/logger-c0ftIK4G.mjs.map +1 -0
  85. package/dist/module/index.d.mts +3 -4
  86. package/dist/module/index.d.mts.map +1 -1
  87. package/dist/module/index.mjs +1 -10
  88. package/dist/module-C3YZ-kZN.mjs +719 -0
  89. package/dist/module-C3YZ-kZN.mjs.map +1 -0
  90. package/dist/openapi/index.d.mts +3 -3
  91. package/dist/openapi/index.mjs +2 -15
  92. package/dist/{openapi-tools.service-B3TxYKoQ.mjs → openapi-tools.service-B77QXD56.mjs} +1 -1
  93. package/dist/{openapi-tools.service-B3TxYKoQ.mjs.map → openapi-tools.service-B77QXD56.mjs.map} +1 -1
  94. package/dist/{openapi.service-DGnX3Fc4.d.mts → openapi.service-6yj0BUY4.d.mts} +9 -17
  95. package/dist/openapi.service-6yj0BUY4.d.mts.map +1 -0
  96. package/dist/quarry/index.d.mts +25 -11
  97. package/dist/quarry/index.d.mts.map +1 -1
  98. package/dist/quarry/index.mjs +4 -8
  99. package/dist/{quarry-registry-B2rkO-JS.mjs → quarry-registry-CQCIlYTO.mjs} +37 -34
  100. package/dist/quarry-registry-CQCIlYTO.mjs.map +1 -0
  101. package/dist/queue/index.d.mts +2 -2
  102. package/dist/queue/index.mjs +3 -13
  103. package/dist/queue/index.mjs.map +1 -1
  104. package/dist/{queue.module-BtI8f4Jo.mjs → queue.module-DIjD6nr-.mjs} +39 -42
  105. package/dist/queue.module-DIjD6nr-.mjs.map +1 -0
  106. package/dist/{resend.provider-bXMEkdRJ.mjs → resend.provider-Bvw36rQy.mjs} +2 -4
  107. package/dist/{resend.provider-bXMEkdRJ.mjs.map → resend.provider-Bvw36rQy.mjs.map} +1 -1
  108. package/dist/router/index.d.mts +2 -2
  109. package/dist/router/index.mjs +5 -16
  110. package/dist/{s3-storage.provider-CttzNnDR.mjs → s3-storage.provider-BAhHDMI3.mjs} +13 -5
  111. package/dist/s3-storage.provider-BAhHDMI3.mjs.map +1 -0
  112. package/dist/seeder/index.d.mts +3 -4
  113. package/dist/seeder/index.d.mts.map +1 -1
  114. package/dist/seeder/index.mjs +2 -6
  115. package/dist/{seeder-R7RXJC35.mjs → seeder-D7VXULXB.mjs} +5 -5
  116. package/dist/{seeder-R7RXJC35.mjs.map → seeder-D7VXULXB.mjs.map} +1 -1
  117. package/dist/setup-BRIN-iYT.mjs +37 -0
  118. package/dist/setup-BRIN-iYT.mjs.map +1 -0
  119. package/dist/{smtp.provider-DrbHQztF.mjs → smtp.provider-CAwpvzvD.mjs} +2 -4
  120. package/dist/{smtp.provider-DrbHQztF.mjs.map → smtp.provider-CAwpvzvD.mjs.map} +1 -1
  121. package/dist/storage/index.d.mts +2 -2
  122. package/dist/storage/index.d.mts.map +1 -1
  123. package/dist/storage/index.mjs +2 -13
  124. package/dist/storage/providers/index.d.mts +2 -1
  125. package/dist/storage/providers/index.d.mts.map +1 -1
  126. package/dist/storage/providers/index.mjs +1 -4
  127. package/dist/{storage-CZKHOhci.mjs → storage-CJ-QOwNv.mjs} +8 -9
  128. package/dist/storage-CJ-QOwNv.mjs.map +1 -0
  129. package/dist/{storage-provider.interface-0IqcdhBf.d.mts → storage-provider.interface-YRtyYBxV.d.mts} +8 -2
  130. package/dist/storage-provider.interface-YRtyYBxV.d.mts.map +1 -0
  131. package/dist/stratal-B7G4i9-N.mjs +502 -0
  132. package/dist/stratal-B7G4i9-N.mjs.map +1 -0
  133. package/dist/{types-DahElfUw.d.mts → types-CN0zONAZ.d.mts} +2 -2
  134. package/dist/types-CN0zONAZ.d.mts.map +1 -0
  135. package/dist/{usage-generator-CVIsENuE.mjs → usage-generator-Cl1HPlUp.mjs} +2 -2
  136. package/dist/{usage-generator-CVIsENuE.mjs.map → usage-generator-Cl1HPlUp.mjs.map} +1 -1
  137. package/dist/{validation-DQTC259A.mjs → validation-B4bePOa_.mjs} +2 -2
  138. package/dist/{validation-DQTC259A.mjs.map → validation-B4bePOa_.mjs.map} +1 -1
  139. package/dist/websocket/index.d.mts +2 -2
  140. package/dist/websocket/index.d.mts.map +1 -1
  141. package/dist/websocket/index.mjs +1 -4
  142. package/dist/workers/index.d.mts +1 -1
  143. package/dist/workers/index.d.mts.map +1 -1
  144. package/dist/workers/index.mjs +2 -20
  145. package/dist/workers/index.mjs.map +1 -1
  146. package/package.json +34 -31
  147. package/dist/application-DfPtIzxF.d.mts +0 -177
  148. package/dist/application-DfPtIzxF.d.mts.map +0 -1
  149. package/dist/command-B1CPgsrU.mjs.map +0 -1
  150. package/dist/en-DaewN8hc.mjs.map +0 -1
  151. package/dist/errors-DSKapqD8.mjs +0 -707
  152. package/dist/errors-DSKapqD8.mjs.map +0 -1
  153. package/dist/gateway-context-CNOLkLUC.mjs.map +0 -1
  154. package/dist/i18n.module-Dn9SrFdS.mjs +0 -1841
  155. package/dist/i18n.module-Dn9SrFdS.mjs.map +0 -1
  156. package/dist/index-BFCxSp_f.d.mts +0 -2625
  157. package/dist/index-BFCxSp_f.d.mts.map +0 -1
  158. package/dist/index-NGxg-KP_.d.mts.map +0 -1
  159. package/dist/logger-CGT91VY6.mjs.map +0 -1
  160. package/dist/middleware/index.d.mts +0 -2
  161. package/dist/middleware/index.mjs +0 -5
  162. package/dist/middleware-Bl-b5pkt.mjs +0 -362
  163. package/dist/middleware-Bl-b5pkt.mjs.map +0 -1
  164. package/dist/module-registry-CmjBX6ol.d.mts +0 -121
  165. package/dist/module-registry-CmjBX6ol.d.mts.map +0 -1
  166. package/dist/module-tUtyVJ5E.mjs +0 -371
  167. package/dist/module-tUtyVJ5E.mjs.map +0 -1
  168. package/dist/openapi.service-DGnX3Fc4.d.mts.map +0 -1
  169. package/dist/quarry-registry-B2rkO-JS.mjs.map +0 -1
  170. package/dist/queue.module-BtI8f4Jo.mjs.map +0 -1
  171. package/dist/router-context-D9R1v2Ac.mjs +0 -267
  172. package/dist/router-context-D9R1v2Ac.mjs.map +0 -1
  173. package/dist/s3-storage.provider-CttzNnDR.mjs.map +0 -1
  174. package/dist/storage-CZKHOhci.mjs.map +0 -1
  175. package/dist/storage-provider.interface-0IqcdhBf.d.mts.map +0 -1
  176. package/dist/stratal-D5smIU1y.mjs +0 -315
  177. package/dist/stratal-D5smIU1y.mjs.map +0 -1
  178. package/dist/types-DahElfUw.d.mts.map +0 -1
@@ -0,0 +1,719 @@
1
+ import { A as Scope, H as ApplicationError, S as HttpException, k as ERROR_CODES } from "./errors--RBIvDXr.mjs";
2
+ import { a as isListener } from "./events-UTJliZhl.mjs";
3
+ import { t as isCommand } from "./is-command-PvULqiTa.mjs";
4
+ import { t as isSeeder } from "./is-seeder-BN9Ej1r7.mjs";
5
+ import { injectable, instancePerContainerCachingFactory, registry } from "tsyringe";
6
+ //#region src/module/errors/invalid-module-provider.error.ts
7
+ /**
8
+ * InvalidModuleProviderError
9
+ *
10
+ * Thrown when a module provider configuration is invalid.
11
+ * This indicates a misconfiguration in the @Module decorator providers array.
12
+ */
13
+ var InvalidModuleProviderError = class extends ApplicationError {
14
+ constructor(provider) {
15
+ super("errors.invalidModuleProvider", ERROR_CODES.SYSTEM.INVALID_MODULE_PROVIDER, { provider: JSON.stringify(provider) });
16
+ }
17
+ };
18
+ //#endregion
19
+ //#region src/module/module.decorator.ts
20
+ const MODULE_OPTIONS_KEY = Symbol.for("stratal:module:options");
21
+ /**
22
+ * `@Module` decorator - defines a module with imports, providers, controllers, consumers, jobs
23
+ *
24
+ * Uses tsyringe's `@registry` internally to auto-register providers when module is imported.
25
+ *
26
+ * @example
27
+ * ```typescript
28
+ * @Module({
29
+ * imports: [OtherModule],
30
+ * providers: [MyService, MyRepository],
31
+ * controllers: [MyController],
32
+ * })
33
+ * export class MyModule {}
34
+ * ```
35
+ */
36
+ function Module(options) {
37
+ return (target) => {
38
+ Reflect.defineMetadata(MODULE_OPTIONS_KEY, options, target);
39
+ const registryEntries = buildRegistryEntries(options.providers ?? []);
40
+ if (registryEntries.length > 0) registry(registryEntries)(target);
41
+ return target;
42
+ };
43
+ }
44
+ /**
45
+ * Get module options from decorated class
46
+ */
47
+ function getModuleOptions(target) {
48
+ return Reflect.getMetadata(MODULE_OPTIONS_KEY, target);
49
+ }
50
+ /**
51
+ * Check if a class is decorated with `@Module`
52
+ */
53
+ function isModuleClass(target) {
54
+ return typeof target === "function" && Reflect.hasMetadata(MODULE_OPTIONS_KEY, target);
55
+ }
56
+ /**
57
+ * Convert our Provider types to tsyringe registry format
58
+ *
59
+ * Maps provider scope to tsyringe's lifecycle option.
60
+ * Scope enum values map directly to Lifecycle enum values.
61
+ */
62
+ function buildRegistryEntries(providers) {
63
+ return providers.map((provider) => {
64
+ if (typeof provider === "function") return {
65
+ token: provider,
66
+ useClass: provider
67
+ };
68
+ if ("useClass" in provider) return {
69
+ token: provider.provide,
70
+ useClass: provider.useClass,
71
+ options: provider.scope !== void 0 ? { lifecycle: provider.scope } : void 0
72
+ };
73
+ if ("useValue" in provider) return {
74
+ token: provider.provide,
75
+ useValue: provider.useValue
76
+ };
77
+ if ("useFactory" in provider) {
78
+ const { provide, useFactory, inject = [] } = provider;
79
+ return {
80
+ token: provide,
81
+ useFactory: instancePerContainerCachingFactory((dependencyContainer) => {
82
+ return useFactory(...inject.map((token) => dependencyContainer.resolve(token)));
83
+ })
84
+ };
85
+ }
86
+ if ("useExisting" in provider) return {
87
+ token: provider.provide,
88
+ useToken: provider.useExisting
89
+ };
90
+ throw new InvalidModuleProviderError(provider);
91
+ });
92
+ }
93
+ //#endregion
94
+ //#region src/router/errors/controller-method-not-found.error.ts
95
+ /**
96
+ * ControllerMethodNotFoundError
97
+ *
98
+ * Thrown when a controller method is registered but doesn't exist on the controller instance.
99
+ * This typically indicates a mismatch between route registration and controller implementation.
100
+ */
101
+ var ControllerMethodNotFoundError = class extends ApplicationError {
102
+ constructor(methodName, controllerName) {
103
+ super("errors.controllerMethodNotFound", ERROR_CODES.ROUTER.CONTROLLER_METHOD_NOT_FOUND, {
104
+ methodName,
105
+ controllerName
106
+ });
107
+ }
108
+ };
109
+ //#endregion
110
+ //#region src/router/errors/controller-registration.error.ts
111
+ /**
112
+ * Error thrown when a controller fails to register
113
+ *
114
+ * This typically happens when:
115
+ * - Controller is missing the `@Controller` decorator
116
+ * - Controller route metadata is not set
117
+ * - Controller class name is invalid
118
+ *
119
+ * Error Code: 9005
120
+ */
121
+ var ControllerRegistrationError = class extends ApplicationError {
122
+ constructor(controllerName, reason) {
123
+ super("errors.controllerRegistration", ERROR_CODES.ROUTER.CONTROLLER_REGISTRATION_ERROR, {
124
+ controllerName,
125
+ reason
126
+ });
127
+ }
128
+ };
129
+ //#endregion
130
+ //#region src/router/errors/hono-app-already-configured.error.ts
131
+ /**
132
+ * Error thrown when HonoApp.configure() is called more than once.
133
+ *
134
+ * HonoApp can only be configured a single time during application bootstrap.
135
+ */
136
+ var HonoAppAlreadyConfiguredError = class extends ApplicationError {
137
+ constructor() {
138
+ super("errors.honoAppAlreadyConfigured", ERROR_CODES.SYSTEM.CONFIGURATION_ERROR);
139
+ }
140
+ };
141
+ //#endregion
142
+ //#region src/router/errors/openapi-route-registration.error.ts
143
+ /**
144
+ * OpenAPIRouteRegistrationError
145
+ *
146
+ * Thrown when an OpenAPI route fails to register properly
147
+ * This indicates a configuration issue with route decorators or metadata
148
+ * Uses i18n key for localized error messages
149
+ *
150
+ * @example
151
+ * ```typescript
152
+ * throw new OpenAPIRouteRegistrationError('/api/v1/users', 'Missing response schema')
153
+ * ```
154
+ */
155
+ var OpenAPIRouteRegistrationError = class extends ApplicationError {
156
+ constructor(path, reason) {
157
+ super("errors.openapiRouteRegistration", ERROR_CODES.ROUTER.OPENAPI_ROUTE_REGISTRATION, {
158
+ path,
159
+ reason
160
+ });
161
+ }
162
+ };
163
+ //#endregion
164
+ //#region src/router/errors/openapi-validation.error.ts
165
+ /**
166
+ * OpenAPIValidationError
167
+ *
168
+ * Thrown when OpenAPI request/response validation fails
169
+ * Uses i18n key for localized error messages
170
+ *
171
+ * HTTP Status: 400 Bad Request
172
+ * Error Code: 1004
173
+ *
174
+ * @example
175
+ * ```typescript
176
+ * throw new OpenAPIValidationError('Request body missing required field: email')
177
+ * ```
178
+ */
179
+ var OpenAPIValidationError = class extends ApplicationError {
180
+ constructor(details) {
181
+ super("errors.openapiValidation", ERROR_CODES.VALIDATION.REQUEST_VALIDATION, { details });
182
+ }
183
+ };
184
+ //#endregion
185
+ //#region src/router/errors/route-not-found.error.ts
186
+ /**
187
+ * Error thrown when a requested route is not found
188
+ *
189
+ * HTTP Status: 404 Not Found
190
+ * Error Code: 4004
191
+ */
192
+ var RouteNotFoundError = class extends ApplicationError {
193
+ constructor(path, method) {
194
+ super("errors.routeNotFound", ERROR_CODES.RESOURCE.ROUTE_NOT_FOUND, {
195
+ path,
196
+ method
197
+ });
198
+ }
199
+ };
200
+ //#endregion
201
+ //#region src/router/errors/schema-validation.error.ts
202
+ /**
203
+ * SchemaValidationError
204
+ *
205
+ * Thrown when Zod schema validation fails
206
+ */
207
+ var SchemaValidationError = class extends ApplicationError {
208
+ constructor(zodError) {
209
+ const issues = zodError.issues.map((err) => ({
210
+ path: err.path.join("."),
211
+ message: err.message,
212
+ code: err.code
213
+ }));
214
+ super("errors.schemaValidation", ERROR_CODES.VALIDATION.SCHEMA_VALIDATION, { issues });
215
+ }
216
+ };
217
+ //#endregion
218
+ //#region src/router/errors/index.ts
219
+ /**
220
+ * Error thrown when a request's host header does not match the expected domain pattern.
221
+ *
222
+ * HTTP Status: 404 Not Found
223
+ */
224
+ var DomainMismatchError = class extends HttpException {
225
+ constructor() {
226
+ super(404, "errors.domainMismatch");
227
+ }
228
+ };
229
+ /**
230
+ * Thrown when registering a named route that conflicts with an existing route name.
231
+ *
232
+ * Error Code: 9010
233
+ */
234
+ var DuplicateRouteNameError = class extends ApplicationError {
235
+ constructor(name, existingHandler, newHandler) {
236
+ super("errors.duplicateRouteName", ERROR_CODES.ROUTER.DUPLICATE_ROUTE_NAME, {
237
+ name,
238
+ existingHandler,
239
+ newHandler
240
+ });
241
+ }
242
+ };
243
+ /**
244
+ * Error thrown when a signed URL has an invalid or expired signature.
245
+ *
246
+ * HTTP Status: 403 Forbidden
247
+ */
248
+ var InvalidSignatureError = class extends HttpException {
249
+ constructor() {
250
+ super(403, "errors.invalidSignature");
251
+ }
252
+ };
253
+ /**
254
+ * Thrown when a required environment variable is not set.
255
+ *
256
+ * Maps to HTTP 500 via error code range (9xxx → 500).
257
+ */
258
+ var MissingEnvironmentVariableError = class extends ApplicationError {
259
+ constructor(variable) {
260
+ super("errors.missingEnvironmentVariable", ERROR_CODES.SYSTEM.MISSING_ENVIRONMENT_VARIABLE, { variable });
261
+ }
262
+ };
263
+ /**
264
+ * Thrown when a required path or domain parameter is missing during URL generation.
265
+ *
266
+ * Error Code: 9012
267
+ */
268
+ var MissingRouteParamError = class extends ApplicationError {
269
+ constructor(param, name, path) {
270
+ super("errors.missingRouteParam", ERROR_CODES.ROUTER.MISSING_ROUTE_PARAM, {
271
+ param,
272
+ name,
273
+ path
274
+ });
275
+ }
276
+ };
277
+ /**
278
+ * ResponseValidationError
279
+ *
280
+ * Thrown when a controller's response body does not match the declared Zod response schema.
281
+ * Indicates a server-side schema mismatch — the controller is returning data that
282
+ * violates its own API contract.
283
+ */
284
+ var ResponseValidationError = class extends ApplicationError {
285
+ constructor(zodError) {
286
+ const issues = zodError.issues.map((err) => ({
287
+ path: err.path.join("."),
288
+ message: err.message,
289
+ code: err.code
290
+ }));
291
+ super("errors.responseValidation", ERROR_CODES.VALIDATION.RESPONSE_VALIDATION, { issues });
292
+ }
293
+ };
294
+ /**
295
+ * Thrown when attempting to generate a URL for a route name that doesn't exist in the registry.
296
+ *
297
+ * Error Code: 9011
298
+ */
299
+ var RouteNameNotFoundError = class extends ApplicationError {
300
+ constructor(name) {
301
+ super("errors.routeNameNotFound", ERROR_CODES.ROUTER.ROUTE_NAME_NOT_FOUND, { name });
302
+ }
303
+ };
304
+ /**
305
+ * Thrown when `router.use()` is called inside a `group()` callback.
306
+ * `use()` registers global middleware and is only allowed on the root Router.
307
+ *
308
+ * Error Code: 9013
309
+ */
310
+ var RouterUseScopeError = class extends ApplicationError {
311
+ constructor() {
312
+ super("errors.routerUseScopeViolation", ERROR_CODES.ROUTER.USE_SCOPE_VIOLATION);
313
+ }
314
+ };
315
+ //#endregion
316
+ //#region src/router/router.internals.ts
317
+ /**
318
+ * Symbol keys for Router internal accessors.
319
+ *
320
+ * These symbols are NOT exported from the public `stratal/router` barrel.
321
+ * Only internal modules (RouterResolver) import them, keeping the Router's
322
+ * public API clean — users never see these methods.
323
+ *
324
+ * Declared as individual unique symbols so TypeScript can distinguish
325
+ * their return types in computed property access.
326
+ *
327
+ * @internal
328
+ */
329
+ /** @internal */
330
+ const getDefaultEntry = Symbol("Router.getDefaultEntry");
331
+ /** @internal */
332
+ const getGroups = Symbol("Router.getGroups");
333
+ /** @internal */
334
+ const getGlobalMiddleware = Symbol("Router.getGlobalMiddleware");
335
+ //#endregion
336
+ //#region src/router/router.ts
337
+ /**
338
+ * Fluent builder for route and middleware configuration.
339
+ *
340
+ * Scoped methods (`middleware()`, `prefix()`, `domain()`, `name()`, `version()`, `hideFromDocs()`)
341
+ * apply only to this module's controllers or the sub-group's controllers.
342
+ *
343
+ * `use()` registers global middleware (all routes in the entire app).
344
+ * Only callable on the root Router — throws inside `group()` callbacks.
345
+ *
346
+ * `group()` creates sub-groups for specific controllers with a callback.
347
+ * Controllers in a sub-group are excluded from the parent scope.
348
+ */
349
+ var Router = class Router {
350
+ _isChild;
351
+ _defaultEntry = { middleware: [] };
352
+ _groups = [];
353
+ _globalMiddleware = [];
354
+ constructor(isChild = false) {
355
+ this._isChild = isChild;
356
+ }
357
+ /** Dynamic path prefix. For shared segments like `/:companyId` */
358
+ prefix(path, params) {
359
+ this._defaultEntry.prefix = path;
360
+ this._defaultEntry.params = params;
361
+ return this;
362
+ }
363
+ /** Domain pattern for controllers in this scope */
364
+ domain(pattern) {
365
+ this._defaultEntry.domain = pattern;
366
+ return this;
367
+ }
368
+ /** Name prefix for routes in this scope */
369
+ name(prefix) {
370
+ this._defaultEntry.name = prefix;
371
+ return this;
372
+ }
373
+ /** Middleware applied to controllers in this scope */
374
+ middleware(...middlewares) {
375
+ this._defaultEntry.middleware.push(...middlewares);
376
+ return this;
377
+ }
378
+ /** API version for controllers in this scope */
379
+ version(version) {
380
+ this._defaultEntry.version = version;
381
+ return this;
382
+ }
383
+ /** Hide/show routes in this scope from OpenAPI docs */
384
+ hideFromDocs(hide = true) {
385
+ this._defaultEntry.hideFromDocs = hide;
386
+ return this;
387
+ }
388
+ /**
389
+ * Global middleware — applied to ALL routes in the entire app.
390
+ * Only callable on the root Router. Throws if called inside `group()`.
391
+ */
392
+ use(...middlewares) {
393
+ if (this._isChild) throw new RouterUseScopeError();
394
+ this._globalMiddleware.push(...middlewares);
395
+ return this;
396
+ }
397
+ /**
398
+ * Create a sub-group for specific controllers/gateways.
399
+ * Controllers in a sub-group are excluded from the parent (default) scope.
400
+ * The callback receives a new Router (without `use()`) for fluent configuration.
401
+ */
402
+ group(controllers, callback) {
403
+ const childRouter = new Router(true);
404
+ callback(childRouter);
405
+ this._groups.push({
406
+ ...childRouter._defaultEntry,
407
+ controllers
408
+ });
409
+ return this;
410
+ }
411
+ [getDefaultEntry]() {
412
+ return this._defaultEntry;
413
+ }
414
+ [getGroups]() {
415
+ return this._groups;
416
+ }
417
+ [getGlobalMiddleware]() {
418
+ return this._globalMiddleware;
419
+ }
420
+ };
421
+ //#endregion
422
+ //#region src/module/module-registry.ts
423
+ /**
424
+ * Module Registry
425
+ *
426
+ * Manages module lifecycle for the @Module decorator pattern.
427
+ * Simplified for tsyringe's flat container model:
428
+ * - Imports are traversed for registration (organization only)
429
+ * - Modules registered in declaration order
430
+ * - Lifecycle hooks: onInitialize, onShutdown
431
+ */
432
+ /**
433
+ * ModuleRegistry - manages module lifecycle
434
+ *
435
+ * @example
436
+ * ```typescript
437
+ * const registry = new ModuleRegistry(container, logger)
438
+ * registry.register(AppModule) // Traverses imports recursively
439
+ * await registry.initialize()
440
+ * // ... application running ...
441
+ * await registry.shutdown()
442
+ * ```
443
+ */
444
+ var ModuleRegistry = class {
445
+ modules = [];
446
+ registeredClasses = /* @__PURE__ */ new Set();
447
+ initialized = false;
448
+ allControllers = [];
449
+ allConsumers = [];
450
+ allJobs = [];
451
+ allListeners = [];
452
+ allCommands = [];
453
+ allSeeders = [];
454
+ allRouterConfigs = [];
455
+ constructor(container, logger) {
456
+ this.container = container;
457
+ this.logger = logger;
458
+ }
459
+ /**
460
+ * Register a module (static or dynamic)
461
+ *
462
+ * @param moduleOrDynamic - Module class decorated with `@Module` or DynamicModule from configure()
463
+ */
464
+ register(moduleOrDynamic) {
465
+ const { moduleClass, options } = this.resolveModule(moduleOrDynamic);
466
+ const isDynamic = this.isDynamicModule(moduleOrDynamic);
467
+ if (this.registeredClasses.has(moduleClass)) {
468
+ if (isDynamic) {
469
+ this.logger.debug(`Module ${moduleClass.name} already registered, registering DynamicModule providers`);
470
+ const { module: _, ...dynamicRest } = moduleOrDynamic;
471
+ for (const provider of dynamicRest.providers ?? []) this.registerProvider(provider);
472
+ } else this.logger.debug(`Module ${moduleClass.name} already registered, skipping`);
473
+ return;
474
+ }
475
+ this.registeredClasses.add(moduleClass);
476
+ this.logger.info(`Registering module: ${moduleClass.name}`);
477
+ for (const ImportedModule of options.imports ?? []) this.register(ImportedModule);
478
+ for (const provider of options.providers ?? []) this.registerProvider(provider);
479
+ for (const controller of options.controllers ?? []) {
480
+ this.container.register(controller);
481
+ this.allControllers.push(controller);
482
+ }
483
+ for (const consumer of options.consumers ?? []) {
484
+ this.container.register(consumer, Scope.Singleton);
485
+ this.allConsumers.push(consumer);
486
+ this.logger.info(`Collected consumer: ${consumer.name}`, { queueCount: this.allConsumers.length });
487
+ }
488
+ for (const job of options.jobs ?? []) {
489
+ this.container.register(job, Scope.Singleton);
490
+ this.allJobs.push(job);
491
+ }
492
+ this.modules.push({
493
+ moduleClass,
494
+ options,
495
+ instance: null
496
+ });
497
+ }
498
+ /**
499
+ * Register multiple modules in order
500
+ */
501
+ registerAll(modules) {
502
+ for (const module of modules) this.register(module);
503
+ }
504
+ /**
505
+ * Initialize all modules (call configure and onInitialize hooks)
506
+ */
507
+ async initialize() {
508
+ if (this.initialized) return;
509
+ this.logger.info("Initializing modules...");
510
+ const context = {
511
+ container: this.container,
512
+ logger: this.logger
513
+ };
514
+ for (const registered of this.modules) {
515
+ const instance = new registered.moduleClass();
516
+ registered.instance = instance;
517
+ if (this.hasRouteConfigurable(instance)) {
518
+ this.logger.debug(`Configuring routes for: ${registered.moduleClass.name}`);
519
+ const router = new Router();
520
+ instance.configureRoutes(router);
521
+ const moduleControllers = registered.options.controllers ?? [];
522
+ this.allRouterConfigs.push({
523
+ router,
524
+ controllers: moduleControllers
525
+ });
526
+ this.logger.debug(`Collected route config from ${registered.moduleClass.name} (${moduleControllers.length} controllers)`);
527
+ }
528
+ if (this.hasOnInitialize(instance)) {
529
+ this.logger.info(`Initializing: ${registered.moduleClass.name}`);
530
+ await instance.onInitialize(context);
531
+ }
532
+ }
533
+ this.initialized = true;
534
+ this.logger.info("All modules initialized");
535
+ }
536
+ /**
537
+ * Get all controllers registered from all modules
538
+ */
539
+ getAllControllers() {
540
+ return this.allControllers;
541
+ }
542
+ /**
543
+ * Get all consumers registered from all modules
544
+ */
545
+ getAllConsumers() {
546
+ return this.allConsumers;
547
+ }
548
+ /**
549
+ * Get all jobs registered from all modules
550
+ */
551
+ getAllJobs() {
552
+ return this.allJobs;
553
+ }
554
+ /**
555
+ * Get all listeners registered from all modules
556
+ */
557
+ getAllListeners() {
558
+ return this.allListeners;
559
+ }
560
+ /**
561
+ * Get all commands registered from all modules
562
+ */
563
+ getAllCommands() {
564
+ return this.allCommands;
565
+ }
566
+ /**
567
+ * Get all seeders registered from all modules
568
+ */
569
+ getAllSeeders() {
570
+ return this.allSeeders;
571
+ }
572
+ /**
573
+ * Get all Router configurations from modules implementing RouteConfigurable
574
+ */
575
+ getAllRouterConfigs() {
576
+ return this.allRouterConfigs;
577
+ }
578
+ /**
579
+ * Call `onException()` on all modules that implement the OnException interface.
580
+ * Invoked by Application after the ExceptionHandler is resolved and `register()` is called.
581
+ *
582
+ * @param handler - The resolved ExceptionHandler instance
583
+ */
584
+ configureExceptionHandlers(handler) {
585
+ for (const { moduleClass, instance } of this.modules) if (instance && this.hasOnException(instance)) {
586
+ this.logger.debug(`Configuring exception handlers for: ${moduleClass.name}`);
587
+ instance.onException(handler);
588
+ }
589
+ }
590
+ /**
591
+ * Shutdown all modules (call onShutdown hooks in reverse order)
592
+ */
593
+ async shutdown() {
594
+ this.logger.info("Shutting down modules...");
595
+ const context = {
596
+ container: this.container,
597
+ logger: this.logger
598
+ };
599
+ const reversed = [...this.modules].reverse();
600
+ for (const { moduleClass, instance } of reversed) if (instance && this.hasOnShutdown(instance)) try {
601
+ await instance.onShutdown(context);
602
+ } catch (error) {
603
+ this.logger.error(`Error shutting down ${moduleClass.name}:`, error);
604
+ }
605
+ this.logger.info("All modules shut down");
606
+ }
607
+ /**
608
+ * Type guard for RouteConfigurable
609
+ */
610
+ hasRouteConfigurable(instance) {
611
+ return typeof instance === "object" && instance !== null && "configureRoutes" in instance && typeof instance.configureRoutes === "function";
612
+ }
613
+ /**
614
+ * Type guard for OnInitialize
615
+ */
616
+ hasOnInitialize(instance) {
617
+ return typeof instance === "object" && instance !== null && "onInitialize" in instance && typeof instance.onInitialize === "function";
618
+ }
619
+ /**
620
+ * Type guard for OnShutdown
621
+ */
622
+ hasOnShutdown(instance) {
623
+ return typeof instance === "object" && instance !== null && "onShutdown" in instance && typeof instance.onShutdown === "function";
624
+ }
625
+ /**
626
+ * Type guard for OnException
627
+ */
628
+ hasOnException(instance) {
629
+ return typeof instance === "object" && instance !== null && "onException" in instance && typeof instance.onException === "function";
630
+ }
631
+ /**
632
+ * Resolve module class and options from static or dynamic module
633
+ *
634
+ * For DynamicModules, merges the decorator metadata (consumers, controllers, jobs)
635
+ * with the DynamicModule options (providers, imports). This ensures modules using
636
+ * forRoot/forRootAsync patterns still have their decorator-defined consumers registered.
637
+ */
638
+ resolveModule(moduleOrDynamic) {
639
+ if (this.isDynamicModule(moduleOrDynamic)) {
640
+ const { module: moduleClass, ...dynamicRest } = moduleOrDynamic;
641
+ const decoratorOptions = getModuleOptions(moduleClass) ?? {};
642
+ return {
643
+ moduleClass,
644
+ options: {
645
+ ...decoratorOptions,
646
+ ...dynamicRest,
647
+ providers: [...decoratorOptions.providers ?? [], ...dynamicRest.providers ?? []],
648
+ imports: [...decoratorOptions.imports ?? []]
649
+ }
650
+ };
651
+ }
652
+ const moduleClass = moduleOrDynamic;
653
+ return {
654
+ moduleClass,
655
+ options: getModuleOptions(moduleClass) ?? {}
656
+ };
657
+ }
658
+ /**
659
+ * Type guard for DynamicModule
660
+ */
661
+ isDynamicModule(value) {
662
+ return typeof value === "object" && value !== null && "module" in value && typeof value.module === "function";
663
+ }
664
+ /**
665
+ * Register a single provider in the container
666
+ */
667
+ registerProvider(provider) {
668
+ if (typeof provider === "function") {
669
+ this.container.register(provider);
670
+ this.collectIfListener(provider);
671
+ this.collectIfCommand(provider);
672
+ this.collectIfSeeder(provider);
673
+ } else if ("useClass" in provider) {
674
+ this.container.register(provider.provide, provider.useClass, provider.scope);
675
+ this.collectIfListener(provider.useClass);
676
+ this.collectIfCommand(provider.useClass);
677
+ this.collectIfSeeder(provider.useClass);
678
+ } else if ("useValue" in provider) this.container.registerValue(provider.provide, provider.useValue);
679
+ else if ("useFactory" in provider) {
680
+ const { provide, useFactory, inject = [] } = provider;
681
+ this.container.getTsyringeContainer().register(provide, { useFactory: instancePerContainerCachingFactory((dependencyContainer) => {
682
+ return useFactory(...inject.map((token) => dependencyContainer.resolve(token)));
683
+ }) });
684
+ } else if ("useExisting" in provider) this.container.registerExisting(provider.provide, provider.useExisting);
685
+ }
686
+ /**
687
+ * Check if a class is a `Command` and collect it for auto-wiring
688
+ */
689
+ collectIfCommand(providerClass) {
690
+ if (isCommand(providerClass) && !this.allCommands.includes(providerClass)) {
691
+ injectable()(providerClass);
692
+ this.allCommands.push(providerClass);
693
+ this.logger.debug(`Collected command: ${providerClass.name}`);
694
+ }
695
+ }
696
+ /**
697
+ * Check if a class is a `Seeder` and collect it for auto-wiring
698
+ */
699
+ collectIfSeeder(providerClass) {
700
+ if (isSeeder(providerClass) && !this.allSeeders.includes(providerClass)) {
701
+ this.allSeeders.push(providerClass);
702
+ this.logger.debug(`Collected seeder: ${providerClass.name}`);
703
+ }
704
+ }
705
+ /**
706
+ * Check if a class is a `@Listener()` and collect it for auto-wiring
707
+ */
708
+ collectIfListener(providerClass) {
709
+ if (isListener(providerClass)) {
710
+ this.container.register(providerClass, providerClass, Scope.Singleton);
711
+ this.allListeners.push(providerClass);
712
+ this.logger.debug(`Collected listener: ${providerClass.name}`);
713
+ }
714
+ }
715
+ };
716
+ //#endregion
717
+ export { getModuleOptions as C, Module as S, OpenAPIRouteRegistrationError as _, getGroups as a, ControllerMethodNotFoundError as b, InvalidSignatureError as c, ResponseValidationError as d, RouteNameNotFoundError as f, OpenAPIValidationError as g, RouteNotFoundError as h, getGlobalMiddleware as i, MissingEnvironmentVariableError as l, SchemaValidationError as m, Router as n, DomainMismatchError as o, RouterUseScopeError as p, getDefaultEntry as r, DuplicateRouteNameError as s, ModuleRegistry as t, MissingRouteParamError as u, HonoAppAlreadyConfiguredError as v, isModuleClass as w, MODULE_OPTIONS_KEY as x, ControllerRegistrationError as y };
718
+
719
+ //# sourceMappingURL=module-C3YZ-kZN.mjs.map