@adaptivestone/framework 5.6.0 → 5.7.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 (131) hide show
  1. package/CHANGELOG.md +78 -1
  2. package/README.md +98 -0
  3. package/dist/clusterRunner.js +9 -4
  4. package/dist/clusterRunner.js.map +1 -1
  5. package/dist/codegen/appTypes.js +9 -6
  6. package/dist/codegen/appTypes.js.map +1 -1
  7. package/dist/codegen/astEmit.js +7 -0
  8. package/dist/codegen/astEmit.js.map +1 -1
  9. package/dist/codegen/astExtract.d.ts +3 -0
  10. package/dist/codegen/astExtract.js +1 -0
  11. package/dist/codegen/astExtract.js.map +1 -1
  12. package/dist/codegen/astResolve.d.ts +2 -0
  13. package/dist/codegen/astResolve.js +1 -0
  14. package/dist/codegen/astResolve.js.map +1 -1
  15. package/dist/codegen/emit.js +1 -1
  16. package/dist/codegen/index.js +1 -1
  17. package/dist/codegen/index.js.map +1 -1
  18. package/dist/commands/CreateUser.d.ts +1 -0
  19. package/dist/commands/CreateUser.js +1 -0
  20. package/dist/commands/CreateUser.js.map +1 -1
  21. package/dist/commands/SyncIndexes.js +4 -12
  22. package/dist/commands/SyncIndexes.js.map +1 -1
  23. package/dist/commands/migration/Migrate.js +3 -2
  24. package/dist/commands/migration/Migrate.js.map +1 -1
  25. package/dist/config/http.d.ts +1 -0
  26. package/dist/config/http.js +13 -2
  27. package/dist/config/http.js.map +1 -1
  28. package/dist/controllers/Auth.d.ts +22 -14
  29. package/dist/controllers/Auth.js +38 -72
  30. package/dist/controllers/Auth.js.map +1 -1
  31. package/dist/controllers/Auth.routes.gen.d.ts +1 -1
  32. package/dist/controllers/Auth.routes.gen.js +1 -1
  33. package/dist/controllers/Health.d.ts +8 -5
  34. package/dist/controllers/Health.js +11 -6
  35. package/dist/controllers/Health.js.map +1 -1
  36. package/dist/controllers/Health.routes.gen.d.ts +1 -1
  37. package/dist/controllers/Health.routes.gen.js +1 -1
  38. package/dist/controllers/Home.d.ts +3 -2
  39. package/dist/controllers/Home.js +6 -2
  40. package/dist/controllers/Home.js.map +1 -1
  41. package/dist/controllers/Home.routes.gen.d.ts +1 -1
  42. package/dist/controllers/Home.routes.gen.js +1 -1
  43. package/dist/controllers/index.js +83 -42
  44. package/dist/controllers/index.js.map +1 -1
  45. package/dist/helpers/crypto.d.ts +6 -0
  46. package/dist/helpers/crypto.js +21 -4
  47. package/dist/helpers/crypto.js.map +1 -1
  48. package/dist/helpers/logger.d.ts +3 -1
  49. package/dist/helpers/logger.js +11 -1
  50. package/dist/helpers/logger.js.map +1 -1
  51. package/dist/helpers/passwordPolicy.d.ts +23 -0
  52. package/dist/helpers/passwordPolicy.js +62 -0
  53. package/dist/helpers/passwordPolicy.js.map +1 -0
  54. package/dist/helpers/redis/redisConnection.d.ts +1 -0
  55. package/dist/helpers/redis/redisConnection.js +1 -0
  56. package/dist/helpers/redis/redisConnection.js.map +1 -1
  57. package/dist/helpers/yup.d.ts +11 -5
  58. package/dist/helpers/yup.js +12 -6
  59. package/dist/helpers/yup.js.map +1 -1
  60. package/dist/locales/ru/translation.json +31 -0
  61. package/dist/models/Lock.d.ts +2 -2
  62. package/dist/models/Lock.js +64 -15
  63. package/dist/models/Lock.js.map +1 -1
  64. package/dist/models/User.d.ts +5 -4
  65. package/dist/models/User.js +4 -4
  66. package/dist/models/User.js.map +1 -1
  67. package/dist/models/UserOld.d.ts +2 -0
  68. package/dist/models/UserOld.js +9 -3
  69. package/dist/models/UserOld.js.map +1 -1
  70. package/dist/modules/BaseCli.d.ts +5 -0
  71. package/dist/modules/BaseCli.js +10 -1
  72. package/dist/modules/BaseCli.js.map +1 -1
  73. package/dist/server.d.ts +22 -2
  74. package/dist/server.js +127 -18
  75. package/dist/server.js.map +1 -1
  76. package/dist/services/cache/Cache.js +16 -8
  77. package/dist/services/cache/Cache.js.map +1 -1
  78. package/dist/services/cache/drivers/RedisDriver.js +15 -11
  79. package/dist/services/cache/drivers/RedisDriver.js.map +1 -1
  80. package/dist/services/http/ExpressResponseWriter.d.ts +30 -0
  81. package/dist/services/http/ExpressResponseWriter.js +447 -0
  82. package/dist/services/http/ExpressResponseWriter.js.map +1 -0
  83. package/dist/services/http/HttpServer.d.ts +17 -11
  84. package/dist/services/http/HttpServer.js +71 -23
  85. package/dist/services/http/HttpServer.js.map +1 -1
  86. package/dist/services/http/ResponseWriter.d.ts +11 -0
  87. package/dist/services/http/ResponseWriter.js +2 -0
  88. package/dist/services/http/ResponseWriter.js.map +1 -0
  89. package/dist/services/http/builtInResponse.d.ts +26 -0
  90. package/dist/services/http/builtInResponse.js +70 -0
  91. package/dist/services/http/builtInResponse.js.map +1 -0
  92. package/dist/services/http/builtinErrorHandlers.d.ts +60 -7
  93. package/dist/services/http/builtinErrorHandlers.js +86 -5
  94. package/dist/services/http/builtinErrorHandlers.js.map +1 -1
  95. package/dist/services/http/files.d.ts +21 -8
  96. package/dist/services/http/files.js +2 -18
  97. package/dist/services/http/files.js.map +1 -1
  98. package/dist/services/http/httpErrors.d.ts +40 -2
  99. package/dist/services/http/httpErrors.js +50 -2
  100. package/dist/services/http/httpErrors.js.map +1 -1
  101. package/dist/services/http/middleware/Cors.js +5 -0
  102. package/dist/services/http/middleware/Cors.js.map +1 -1
  103. package/dist/services/http/middleware/IpDetector.js +23 -4
  104. package/dist/services/http/middleware/IpDetector.js.map +1 -1
  105. package/dist/services/http/middleware/Pagination.js +4 -2
  106. package/dist/services/http/middleware/Pagination.js.map +1 -1
  107. package/dist/services/http/middleware/RateLimiter.d.ts +1 -0
  108. package/dist/services/http/middleware/RateLimiter.js +37 -13
  109. package/dist/services/http/middleware/RateLimiter.js.map +1 -1
  110. package/dist/services/http/middleware/RequestParser.d.ts +9 -3
  111. package/dist/services/http/middleware/RequestParser.js +108 -36
  112. package/dist/services/http/middleware/RequestParser.js.map +1 -1
  113. package/dist/services/http/responses.d.ts +114 -0
  114. package/dist/services/http/responses.js +191 -0
  115. package/dist/services/http/responses.js.map +1 -0
  116. package/dist/services/http/routing/ExpressAdapter.d.ts +4 -1
  117. package/dist/services/http/routing/ExpressAdapter.js +82 -9
  118. package/dist/services/http/routing/ExpressAdapter.js.map +1 -1
  119. package/dist/services/http/routing/RouteRegistry.js +21 -10
  120. package/dist/services/http/routing/RouteRegistry.js.map +1 -1
  121. package/dist/services/i18n/I18n.js.map +1 -1
  122. package/dist/services/i18n/types.d.ts +2 -1
  123. package/dist/services/validate/ValidationError.d.ts +8 -1
  124. package/dist/services/validate/ValidationError.js +10 -2
  125. package/dist/services/validate/ValidationError.js.map +1 -1
  126. package/dist/services/validate/drivers/YupDriver.js +44 -6
  127. package/dist/services/validate/drivers/YupDriver.js.map +1 -1
  128. package/dist/tests/setupFramework.d.ts +4 -1
  129. package/dist/tests/setupFramework.js +15 -9
  130. package/dist/tests/setupFramework.js.map +1 -1
  131. package/package.json +5 -5
@@ -1,13 +1,59 @@
1
1
  import { unlink } from 'node:fs/promises';
2
2
  import formidable, { json, multipart, octetstream, querystring, } from 'formidable';
3
3
  import { normalizeContentType } from '../../validate/contentType.js';
4
+ import { FRAMEWORK_ERROR_CODES, HttpError } from '../httpErrors.js';
4
5
  import AbstractMiddleware from './AbstractMiddleware.js';
6
+ const bodyFormats = {
7
+ json: { plugin: json, mediaType: 'application/json' },
8
+ urlencoded: {
9
+ plugin: querystring,
10
+ mediaType: 'application/x-www-form-urlencoded',
11
+ },
12
+ };
13
+ /**
14
+ * The body format `config.http.requestParser.mediaTypes` assigns to a media
15
+ * type. Keys match case-insensitively; unknown formats are ignored.
16
+ */
17
+ function findBodyFormat(mediaType, mediaTypes) {
18
+ if (!mediaType || typeof mediaTypes !== 'object' || mediaTypes === null) {
19
+ return undefined;
20
+ }
21
+ let format;
22
+ for (const [key, value] of Object.entries(mediaTypes)) {
23
+ if (key.toLowerCase() === mediaType) {
24
+ format = value;
25
+ }
26
+ }
27
+ return typeof format === 'string' && Object.hasOwn(bodyFormats, format)
28
+ ? bodyFormats[format]
29
+ : undefined;
30
+ }
31
+ /**
32
+ * Formidable's plugins check the `Content-Type` header themselves. Show the
33
+ * plugin its own media type so a mapped type reaches that parser.
34
+ */
35
+ function asMediaType(plugin, mediaType) {
36
+ return (form, options) => {
37
+ const target = form;
38
+ const { headers } = target;
39
+ target.headers = { ...headers, 'content-type': mediaType };
40
+ try {
41
+ plugin(form, options);
42
+ }
43
+ finally {
44
+ target.headers = headers;
45
+ }
46
+ };
47
+ }
5
48
  /**
6
49
  * Parses multipart / urlencoded / json request bodies (via formidable) into
7
50
  * `req.body`. Size and count limits come from `config.http.requestParser`
8
- * (explicit per-mount params override them). Spooled upload temp files are
51
+ * (explicit per-mount params override them), and so do extra media types to
52
+ * parse as JSON or urlencoded (`mediaTypes`). Spooled upload temp files are
9
53
  * unlinked once the response finishes — a handler that needs to keep an upload
10
- * MUST move or copy it (e.g. `fs.rename`) before responding.
54
+ * MUST move or copy it (e.g. `fs.rename`) before responding. An oversized body
55
+ * (413) or an unparsable one (400) is passed on as an `HttpError`, so the
56
+ * error-handler registry answers it.
11
57
  */
12
58
  class RequestParser extends AbstractMiddleware {
13
59
  static get description() {
@@ -18,56 +64,66 @@ class RequestParser extends AbstractMiddleware {
18
64
  this.logger?.verbose(`Parsing request`);
19
65
  const { requestParser } = this.app.getConfig('http');
20
66
  // Config defaults bound unauthenticated uploads; explicit per-mount params win.
21
- const parserOptions = { ...requestParser, ...this.params };
67
+ const { mediaTypes, ...parserOptions } = {
68
+ ...requestParser,
69
+ ...this.params,
70
+ };
22
71
  const mediaType = normalizeContentType(req.headers?.['content-type']);
23
- const isMultipart = mediaType === 'multipart/form-data' || mediaType === 'multipart/related';
72
+ const mapped = findBodyFormat(mediaType, mediaTypes);
73
+ const isMultipart = !mapped &&
74
+ (mediaType === 'multipart/form-data' ||
75
+ mediaType === 'multipart/related');
76
+ const isOctetStream = !mapped && mediaType === 'application/octet-stream';
24
77
  // Formidable's default plugins inspect the entire header. Select one for
25
78
  // known media types so parameter text cannot switch the parser.
26
- const plugin = isMultipart
27
- ? multipart
28
- : mediaType === 'application/json' || mediaType?.endsWith('+json')
29
- ? json
30
- : mediaType === 'application/x-www-form-urlencoded'
31
- ? querystring
32
- : mediaType === 'application/octet-stream'
33
- ? octetstream
34
- : undefined;
79
+ const plugin = mapped
80
+ ? asMediaType(mapped.plugin, mapped.mediaType)
81
+ : isMultipart
82
+ ? multipart
83
+ : mediaType === 'application/json' || mediaType?.endsWith('+json')
84
+ ? json
85
+ : mediaType === 'application/x-www-form-urlencoded'
86
+ ? querystring
87
+ : isOctetStream
88
+ ? octetstream
89
+ : undefined;
35
90
  const form = formidable({
36
91
  ...parserOptions,
37
92
  ...(plugin ? { enabledPlugins: [plugin] } : {}),
38
93
  });
39
- // JSON/urlencoded parsing buffers the body; multipart has its own field
40
- // and file limits. Unknown media types retain the v5 fallback, bounded below.
41
- const maxBodySize = typeof parserOptions.maxFieldsSize === 'number'
42
- ? parserOptions.maxFieldsSize
43
- : 2 * 1024 * 1024;
94
+ // JSON/urlencoded parsing buffers the body, bounded by maxFieldsSize, and
95
+ // unknown media types retain the v5 fallback. Multipart uses Formidable's
96
+ // file limits. An octet-stream body is one file, but Formidable checks
97
+ // those limits only on multipart parts, so it is bounded here by them.
98
+ const { maxFileSize, maxTotalFileSize } = form.options;
99
+ const limitName = isOctetStream ? 'maxFileSize' : 'maxFieldsSize';
100
+ const maxBodySize = isOctetStream
101
+ ? Math.min(maxFileSize, maxTotalFileSize)
102
+ : typeof parserOptions.maxFieldsSize === 'number'
103
+ ? parserOptions.maxFieldsSize
104
+ : 2 * 1024 * 1024;
44
105
  let bodyTooLarge = false;
45
106
  if (!isMultipart) {
46
107
  const declaredLength = Number(req.headers?.['content-length']);
47
108
  if (Number.isFinite(declaredLength) && declaredLength > maxBodySize) {
48
- this.logger?.error(`Request body ${declaredLength}B exceeds maxFieldsSize ${maxBodySize}B`);
109
+ this.logger?.error(`Request body ${declaredLength}B exceeds ${limitName} ${maxBodySize}B`);
49
110
  // Close after the 413 instead of draining the unread body.
50
111
  res.setHeader('Connection', 'close');
51
- return res.status(413).json({
52
- message: this.translate(req, 'middleware.requestParser.entityTooLarge', 'Request entity too large. Your upload exceeds the allowed size or count limits.'),
53
- });
112
+ return next(this.#entityTooLarge(req));
54
113
  }
55
114
  }
56
- // Also guard chunked bodies. Only a genuinely selected multipart parser
57
- // may rely on the separate file/field limits. Pausing (not destroying) the
58
- // request keeps the socket writable, so the client receives the 413; its
59
- // `Connection: close` then ends the connection.
115
+ // Also guard chunked bodies. Multipart enforces its own file limits. Pausing (not destroying) the request keeps the socket writable,
116
+ // so the client receives the 413; its `Connection: close` then ends the
117
+ // connection.
60
118
  let rejectOversized = () => { };
61
119
  const oversized = new Promise((_resolve, reject) => {
62
120
  rejectOversized = reject;
63
121
  });
64
122
  form.on('progress', (bytesReceived) => {
65
- if (!bodyTooLarge &&
66
- form.type !== 'multipart' &&
67
- bytesReceived > maxBodySize) {
123
+ if (!bodyTooLarge && !isMultipart && bytesReceived > maxBodySize) {
68
124
  bodyTooLarge = true;
69
125
  req.pause();
70
- rejectOversized(new Error('Request body exceeds maxFieldsSize'));
126
+ rejectOversized(new Error(`Request body exceeds ${limitName}`));
71
127
  }
72
128
  });
73
129
  // Track every temp file formidable opens (via fileBegin, so a file that
@@ -77,6 +133,12 @@ class RequestParser extends AbstractMiddleware {
77
133
  const openedFiles = [];
78
134
  form.on('fileBegin', (_name, file) => {
79
135
  openedFiles.push(file);
136
+ // Formidable handles a temp-file write error (disk full, missing
137
+ // uploadDir) for multipart parts only; for an octet-stream body it was
138
+ // an uncaught error that crashed the process. Fail the parse instead.
139
+ if (isOctetStream) {
140
+ file.on('error', (err) => form.emit('error', err));
141
+ }
80
142
  });
81
143
  let cleaned = false;
82
144
  const cleanup = () => {
@@ -97,7 +159,7 @@ class RequestParser extends AbstractMiddleware {
97
159
  // Pausing the stream cannot cancel a chunk already inside the parser.
98
160
  // Even if that chunk completes parsing, an oversized body must not advance.
99
161
  if (bodyTooLarge) {
100
- throw new Error('Request body exceeds maxFieldsSize');
162
+ throw new Error(`Request body exceeds ${limitName}`);
101
163
  }
102
164
  }
103
165
  catch (err) {
@@ -110,13 +172,12 @@ class RequestParser extends AbstractMiddleware {
110
172
  // The rest of the body stays unread; close rather than drain it.
111
173
  res.setHeader('Connection', 'close');
112
174
  }
113
- return res.status(413).json({
114
- message: this.translate(req, 'middleware.requestParser.entityTooLarge', 'Request entity too large. Your upload exceeds the allowed size or count limits.'),
115
- });
175
+ return next(this.#entityTooLarge(req));
116
176
  }
117
- return res.status(400).json({
177
+ return next(new HttpError(400, {
178
+ code: FRAMEWORK_ERROR_CODES.malformedBody,
118
179
  message: this.translate(req, 'middleware.requestParser.parseError', `Error to parse your request. You provided invalid content type or content-length. Please check your request headers and content type.`),
119
- });
180
+ }));
120
181
  }
121
182
  this.logger?.verbose(`Parsing multipart/formdata request DONE ${Date.now() - time}ms`);
122
183
  // formidable wraps multipart/urlencoded fields in arrays (one entry per
@@ -132,6 +193,11 @@ class RequestParser extends AbstractMiddleware {
132
193
  ? [key, value[0]]
133
194
  : [key, value]))
134
195
  : fields;
196
+ // Formidable lists a field's files as their writes finish; keep the order
197
+ // they were sent, which is the order they began.
198
+ for (const list of Object.values(files)) {
199
+ list?.sort((a, b) => openedFiles.indexOf(a) - openedFiles.indexOf(b));
200
+ }
135
201
  req.body = {
136
202
  // todo avoid body in next versions
137
203
  ...(req.body || {}),
@@ -140,6 +206,12 @@ class RequestParser extends AbstractMiddleware {
140
206
  };
141
207
  return next();
142
208
  }
209
+ #entityTooLarge(req) {
210
+ return new HttpError(413, {
211
+ code: FRAMEWORK_ERROR_CODES.payloadTooLarge,
212
+ message: this.translate(req, 'middleware.requestParser.entityTooLarge', 'Request entity too large. Your upload exceeds the allowed size or count limits.'),
213
+ });
214
+ }
143
215
  }
144
216
  export default RequestParser;
145
217
  //# sourceMappingURL=RequestParser.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"RequestParser.js","sourceRoot":"","sources":["../../../../src/services/http/middleware/RequestParser.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"RequestParser.js","sourceRoot":"","sources":["../../../../src/services/http/middleware/RequestParser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Typed response values. A route handler returns one instead of writing to
3
+ * Express `res`; the framework renders it. Descriptors are immutable data:
4
+ * build them with the `HttpResponse` factories, never by hand.
5
+ *
6
+ * @example
7
+ * async create(req: CreateUserRequest): Promise<JsonResponse<201, UserDto>> {
8
+ * const user = await this.app.getModel('User').create(req.appInfo.request);
9
+ * return HttpResponse.json(201, user);
10
+ * }
11
+ */
12
+ /** Registered, not module-private, so two installed copies of the framework recognize each other's responses. */
13
+ declare const BRAND: unique symbol;
14
+ /** Statuses that never carry a body; only `HttpResponse.empty` accepts them. */
15
+ export type NoBodyStatus = 204 | 205 | 304;
16
+ /** Statuses accepted by `HttpResponse.redirect`. */
17
+ export type RedirectStatus = 301 | 302 | 303 | 307 | 308;
18
+ /** A literal status a body response cannot use (1xx, 204/205/304, 206) becomes `never`. */
19
+ type BodyStatus<S extends number> = S extends NoBodyStatus | 206 ? never : `${S}` extends `1${string}` ? never : S;
20
+ /** A literal status `HttpResponse.empty` cannot use (1xx, 206) becomes `never`. */
21
+ type EmptyStatus<S extends number> = S extends 206 ? never : `${S}` extends `1${string}` ? never : S;
22
+ /** Response headers: lower-case names, one entry per `set-cookie` value. */
23
+ export type ResponseHeaders = ReadonlyArray<readonly [name: string, value: string]>;
24
+ /** Anything the Web `Headers` constructor accepts, including a descriptor's `headers`. */
25
+ export type ResponseHeadersInit = Headers | Record<string, string> | ReadonlyArray<readonly [string, string]>;
26
+ /** A byte source for `HttpResponse.stream`; a Node `Readable` is an async iterable too. */
27
+ export type ByteStream = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
28
+ export interface ResponseOptions {
29
+ headers?: ResponseHeadersInit;
30
+ }
31
+ export interface BodyResponseOptions<M extends string> extends ResponseOptions {
32
+ /** Media type; set it here, not as a `content-type` header. */
33
+ contentType?: M;
34
+ }
35
+ interface ResponseBase<K extends string, S extends number> {
36
+ readonly [BRAND]: true;
37
+ readonly kind: K;
38
+ readonly status: S;
39
+ readonly headers: ResponseHeaders;
40
+ }
41
+ export interface JsonResponse<S extends number = number, B = unknown, M extends string = 'application/json'> extends ResponseBase<'json', S> {
42
+ readonly contentType: M;
43
+ readonly body: B;
44
+ }
45
+ export interface TextResponse<S extends number = number, M extends string = 'text/plain'> extends ResponseBase<'text', S> {
46
+ readonly contentType: M;
47
+ readonly body: string;
48
+ }
49
+ export interface BytesResponse<S extends number = number, M extends string = 'application/octet-stream'> extends ResponseBase<'bytes', S> {
50
+ readonly contentType: M;
51
+ readonly body: Uint8Array;
52
+ }
53
+ export interface StreamResponse<S extends number = number, M extends string = 'application/octet-stream'> extends ResponseBase<'stream', S> {
54
+ readonly contentType: M;
55
+ readonly body: ByteStream;
56
+ }
57
+ export interface RedirectResponse<S extends RedirectStatus = RedirectStatus> extends ResponseBase<'redirect', S> {
58
+ readonly location: string;
59
+ }
60
+ export interface EmptyResponse<S extends number = number> extends ResponseBase<'empty', S> {
61
+ }
62
+ /** A Web `Response` passed through as-is; its status and body types are not tracked. */
63
+ export interface NativeResponse extends ResponseBase<'native', number> {
64
+ readonly response: Response;
65
+ }
66
+ /** Statuses that never carry a body, as a runtime set. */
67
+ export declare const NO_BODY_STATUSES: ReadonlySet<number>;
68
+ declare function json<S extends number, B, M extends string = 'application/json'>(status: BodyStatus<S>, body: B, options?: BodyResponseOptions<M>): JsonResponse<S, B, M>;
69
+ declare function text<S extends number, M extends string = 'text/plain'>(status: BodyStatus<S>, body: string, options?: BodyResponseOptions<M>): TextResponse<S, M>;
70
+ declare function bytes<S extends number, M extends string = 'application/octet-stream'>(status: BodyStatus<S>, body: Uint8Array, options?: BodyResponseOptions<M>): BytesResponse<S, M>;
71
+ /**
72
+ * Stream bytes. The status and headers are sent with the first chunk, so an
73
+ * error before it is answered like a thrown error; a later error aborts the
74
+ * response. A client that disconnects stops the source (`return()` on the
75
+ * iterator, `cancel()` on a `ReadableStream`).
76
+ */
77
+ declare function stream<S extends number, M extends string = 'application/octet-stream'>(status: BodyStatus<S>, body: ByteStream, options?: BodyResponseOptions<M>): StreamResponse<S, M>;
78
+ declare function redirect<S extends RedirectStatus>(status: S, location: string | URL, options?: ResponseOptions): RedirectResponse<S>;
79
+ declare function empty<S extends number>(status: EmptyStatus<S>, options?: ResponseOptions): EmptyResponse<S>;
80
+ /**
81
+ * Pass a Web `Response` through: its status, status text, headers and body
82
+ * are sent as they are, except the framing headers the server sets itself
83
+ * (`connection`, `transfer-encoding`, …). A `fetch()` response (non-empty
84
+ * `url`) with a body, a status other than 206 and only codings `fetch` decodes
85
+ * (`gzip`, `deflate`, `br`, `zstd`; under Bun a single one) also loses its
86
+ * upstream `content-encoding`, `content-length` and digest headers, which
87
+ * describe the encoded bytes; any other response is passed on as received,
88
+ * headers intact.
89
+ * To forward the upstream bytes exactly as received (for example fetched with
90
+ * decoding turned off), pass `new Response(upstream.body, upstream)`, which
91
+ * has no `url`.
92
+ */
93
+ declare function native(response: Response): NativeResponse;
94
+ /** Is `value` a response built by an `HttpResponse` factory? */
95
+ declare function is(value: unknown): value is HttpResponse;
96
+ /**
97
+ * Response factories. Status is always the first argument. Statuses a kind
98
+ * cannot use fail to compile when written as literals and throw a
99
+ * `RangeError` at runtime: 1xx everywhere; 204, 205 and 304 everywhere but
100
+ * `empty`; 206 (reserved for range-aware file responses) everywhere.
101
+ */
102
+ export declare const HttpResponse: Readonly<{
103
+ json: typeof json;
104
+ text: typeof text;
105
+ bytes: typeof bytes;
106
+ stream: typeof stream;
107
+ redirect: typeof redirect;
108
+ empty: typeof empty;
109
+ native: typeof native;
110
+ is: typeof is;
111
+ }>;
112
+ /** Any response a handler can return. */
113
+ export type HttpResponse = JsonResponse<number, unknown, string> | TextResponse<number, string> | BytesResponse<number, string> | StreamResponse<number, string> | RedirectResponse | EmptyResponse | NativeResponse;
114
+ export {};
@@ -0,0 +1,191 @@
1
+ /**
2
+ * Typed response values. A route handler returns one instead of writing to
3
+ * Express `res`; the framework renders it. Descriptors are immutable data:
4
+ * build them with the `HttpResponse` factories, never by hand.
5
+ *
6
+ * @example
7
+ * async create(req: CreateUserRequest): Promise<JsonResponse<201, UserDto>> {
8
+ * const user = await this.app.getModel('User').create(req.appInfo.request);
9
+ * return HttpResponse.json(201, user);
10
+ * }
11
+ */
12
+ /** Registered, not module-private, so two installed copies of the framework recognize each other's responses. */
13
+ const BRAND = Symbol.for('@adaptivestone/framework/HttpResponse');
14
+ /** Statuses that never carry a body, as a runtime set. */
15
+ export const NO_BODY_STATUSES = new Set([204, 205, 304]);
16
+ const REDIRECT_STATUSES = new Set([
17
+ 301, 302, 303, 307, 308,
18
+ ]);
19
+ const NO_HEADERS = Object.freeze([]);
20
+ function assertFinalStatus(factory, status) {
21
+ if (!Number.isInteger(status) || status < 200 || status > 599) {
22
+ throw new RangeError(`HttpResponse.${factory}: status must be an integer from 200 to 599, got ${status}`);
23
+ }
24
+ }
25
+ function assertBodyStatus(factory, status) {
26
+ assertFinalStatus(factory, status);
27
+ if (NO_BODY_STATUSES.has(status)) {
28
+ throw new RangeError(`HttpResponse.${factory}: status ${status} never carries a body; use HttpResponse.empty(${status})`);
29
+ }
30
+ if (status === 206) {
31
+ throw new RangeError(`HttpResponse.${factory}: status 206 is reserved for range-aware file responses`);
32
+ }
33
+ }
34
+ /** Normalize through Web `Headers` (validates names and values) into frozen pairs. */
35
+ function toHeaders(factory, init, owned) {
36
+ if (init === undefined) {
37
+ return NO_HEADERS;
38
+ }
39
+ // Headers accepts any sequence of pairs; its type only lists mutable ones.
40
+ const headers = new Headers(init);
41
+ if (owned && headers.has(owned)) {
42
+ throw new TypeError(owned === 'location'
43
+ ? `HttpResponse.${factory}: pass the location as the second argument, not as a location header`
44
+ : `HttpResponse.${factory}: pass the media type as options.contentType, not as a content-type header`);
45
+ }
46
+ return Object.freeze([...headers].map(([name, value]) => Object.freeze([name, value])));
47
+ }
48
+ function json(status, body, options) {
49
+ assertBodyStatus('json', status);
50
+ if (body === undefined) {
51
+ throw new TypeError('HttpResponse.json: body is undefined; use HttpResponse.empty(status) for a response without a body');
52
+ }
53
+ return Object.freeze({
54
+ [BRAND]: true,
55
+ kind: 'json',
56
+ status: status,
57
+ headers: toHeaders('json', options?.headers, 'content-type'),
58
+ contentType: (options?.contentType ?? 'application/json'),
59
+ body,
60
+ });
61
+ }
62
+ function text(status, body, options) {
63
+ assertBodyStatus('text', status);
64
+ if (typeof body !== 'string') {
65
+ throw new TypeError('HttpResponse.text: body must be a string');
66
+ }
67
+ return Object.freeze({
68
+ [BRAND]: true,
69
+ kind: 'text',
70
+ status: status,
71
+ headers: toHeaders('text', options?.headers, 'content-type'),
72
+ contentType: (options?.contentType ?? 'text/plain'),
73
+ body,
74
+ });
75
+ }
76
+ function bytes(status, body, options) {
77
+ assertBodyStatus('bytes', status);
78
+ if (!(body instanceof Uint8Array)) {
79
+ throw new TypeError('HttpResponse.bytes: body must be a Uint8Array');
80
+ }
81
+ return Object.freeze({
82
+ [BRAND]: true,
83
+ kind: 'bytes',
84
+ status: status,
85
+ headers: toHeaders('bytes', options?.headers, 'content-type'),
86
+ contentType: (options?.contentType ?? 'application/octet-stream'),
87
+ body,
88
+ });
89
+ }
90
+ /**
91
+ * Stream bytes. The status and headers are sent with the first chunk, so an
92
+ * error before it is answered like a thrown error; a later error aborts the
93
+ * response. A client that disconnects stops the source (`return()` on the
94
+ * iterator, `cancel()` on a `ReadableStream`).
95
+ */
96
+ function stream(status, body, options) {
97
+ assertBodyStatus('stream', status);
98
+ if (typeof body?.[Symbol.asyncIterator] !== 'function') {
99
+ throw new TypeError('HttpResponse.stream: body must be a ReadableStream or an async iterable of bytes');
100
+ }
101
+ return Object.freeze({
102
+ [BRAND]: true,
103
+ kind: 'stream',
104
+ status: status,
105
+ headers: toHeaders('stream', options?.headers, 'content-type'),
106
+ contentType: (options?.contentType ?? 'application/octet-stream'),
107
+ body,
108
+ });
109
+ }
110
+ function redirect(status, location, options) {
111
+ if (!REDIRECT_STATUSES.has(status)) {
112
+ throw new RangeError(`HttpResponse.redirect: status must be 301, 302, 303, 307 or 308, got ${status}`);
113
+ }
114
+ const target = String(location);
115
+ if (target === '') {
116
+ throw new TypeError('HttpResponse.redirect: location must not be empty');
117
+ }
118
+ return Object.freeze({
119
+ [BRAND]: true,
120
+ kind: 'redirect',
121
+ status,
122
+ headers: toHeaders('redirect', options?.headers, 'location'),
123
+ location: target,
124
+ });
125
+ }
126
+ function empty(status, options) {
127
+ assertFinalStatus('empty', status);
128
+ if (status === 206) {
129
+ throw new RangeError('HttpResponse.empty: status 206 is reserved for range-aware file responses');
130
+ }
131
+ return Object.freeze({
132
+ [BRAND]: true,
133
+ kind: 'empty',
134
+ status: status,
135
+ headers: toHeaders('empty', options?.headers, null),
136
+ });
137
+ }
138
+ /**
139
+ * Pass a Web `Response` through: its status, status text, headers and body
140
+ * are sent as they are, except the framing headers the server sets itself
141
+ * (`connection`, `transfer-encoding`, …). A `fetch()` response (non-empty
142
+ * `url`) with a body, a status other than 206 and only codings `fetch` decodes
143
+ * (`gzip`, `deflate`, `br`, `zstd`; under Bun a single one) also loses its
144
+ * upstream `content-encoding`, `content-length` and digest headers, which
145
+ * describe the encoded bytes; any other response is passed on as received,
146
+ * headers intact.
147
+ * To forward the upstream bytes exactly as received (for example fetched with
148
+ * decoding turned off), pass `new Response(upstream.body, upstream)`, which
149
+ * has no `url`.
150
+ */
151
+ function native(response) {
152
+ if (!(response instanceof Response)) {
153
+ throw new TypeError('HttpResponse.native: expected a Web Response');
154
+ }
155
+ if (response.type === 'error') {
156
+ throw new TypeError('HttpResponse.native: a network-error Response (Response.error()) has no status to send');
157
+ }
158
+ if (response.bodyUsed) {
159
+ throw new TypeError('HttpResponse.native: the Response body was already read');
160
+ }
161
+ return Object.freeze({
162
+ [BRAND]: true,
163
+ kind: 'native',
164
+ status: response.status,
165
+ headers: NO_HEADERS,
166
+ response,
167
+ });
168
+ }
169
+ /** Is `value` a response built by an `HttpResponse` factory? */
170
+ function is(value) {
171
+ return (typeof value === 'object' &&
172
+ value !== null &&
173
+ value[BRAND] === true);
174
+ }
175
+ /**
176
+ * Response factories. Status is always the first argument. Statuses a kind
177
+ * cannot use fail to compile when written as literals and throw a
178
+ * `RangeError` at runtime: 1xx everywhere; 204, 205 and 304 everywhere but
179
+ * `empty`; 206 (reserved for range-aware file responses) everywhere.
180
+ */
181
+ export const HttpResponse = Object.freeze({
182
+ json,
183
+ text,
184
+ bytes,
185
+ stream,
186
+ redirect,
187
+ empty,
188
+ native,
189
+ is,
190
+ });
191
+ //# sourceMappingURL=responses.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"responses.js","sourceRoot":"","sources":["../../../src/services/http/responses.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,9 @@
7
7
  */
8
8
  import type { NextFunction, Request, Response } from 'express';
9
9
  import type { IApp } from '../../../server.ts';
10
+ import type { ResponseWriter } from '../ResponseWriter.ts';
10
11
  import type { RouteRegistry } from './RouteRegistry.ts';
12
+ /** @internal A failure for `next`: a falsy one would fall through to the 404. */
13
+ export declare function failure(reason: unknown): unknown;
11
14
  export type ExpressAdapter = (req: Request, res: Response, next: NextFunction) => Promise<void>;
12
- export declare function createExpressAdapter(registry: RouteRegistry, app: IApp): ExpressAdapter;
15
+ export declare function createExpressAdapter(registry: RouteRegistry, app: IApp, writer?: ResponseWriter<Request, Response>): ExpressAdapter;