@argos-js/net 0.0.0-stage → 0.1.1

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 (63) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +79 -2
  3. package/dist/adapter.d.ts +66 -0
  4. package/dist/adapter.d.ts.map +1 -0
  5. package/dist/adapter.js +216 -0
  6. package/dist/adapter.js.map +1 -0
  7. package/dist/binary-stream.d.ts +67 -0
  8. package/dist/binary-stream.d.ts.map +1 -0
  9. package/dist/binary-stream.js +201 -0
  10. package/dist/binary-stream.js.map +1 -0
  11. package/dist/context.d.ts +5 -0
  12. package/dist/context.d.ts.map +1 -0
  13. package/dist/context.js +9 -0
  14. package/dist/context.js.map +1 -0
  15. package/dist/errors.d.ts +20 -0
  16. package/dist/errors.d.ts.map +1 -0
  17. package/dist/errors.js +31 -0
  18. package/dist/errors.js.map +1 -0
  19. package/dist/http-status.d.ts +26 -0
  20. package/dist/http-status.d.ts.map +1 -0
  21. package/dist/http-status.js +34 -0
  22. package/dist/http-status.js.map +1 -0
  23. package/dist/index.d.ts +19 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +35 -0
  26. package/dist/index.js.map +1 -0
  27. package/dist/inject.d.ts +82 -0
  28. package/dist/inject.d.ts.map +1 -0
  29. package/dist/inject.js +127 -0
  30. package/dist/inject.js.map +1 -0
  31. package/dist/native-bridge.d.ts +63 -0
  32. package/dist/native-bridge.d.ts.map +1 -0
  33. package/dist/native-bridge.js +82 -0
  34. package/dist/native-bridge.js.map +1 -0
  35. package/dist/radix-tree.d.ts +53 -0
  36. package/dist/radix-tree.d.ts.map +1 -0
  37. package/dist/radix-tree.js +152 -0
  38. package/dist/radix-tree.js.map +1 -0
  39. package/dist/router.d.ts +32 -0
  40. package/dist/router.d.ts.map +1 -0
  41. package/dist/router.js +66 -0
  42. package/dist/router.js.map +1 -0
  43. package/dist/server.d.ts +15 -0
  44. package/dist/server.d.ts.map +1 -0
  45. package/dist/server.js +31 -0
  46. package/dist/server.js.map +1 -0
  47. package/dist/tcp-channel.d.ts +56 -0
  48. package/dist/tcp-channel.d.ts.map +1 -0
  49. package/dist/tcp-channel.js +240 -0
  50. package/dist/tcp-channel.js.map +1 -0
  51. package/dist/types.d.ts +190 -0
  52. package/dist/types.d.ts.map +1 -0
  53. package/dist/types.js +547 -0
  54. package/dist/types.js.map +1 -0
  55. package/dist/validation.d.ts +172 -0
  56. package/dist/validation.d.ts.map +1 -0
  57. package/dist/validation.js +468 -0
  58. package/dist/validation.js.map +1 -0
  59. package/dist/websocket-channel.d.ts +47 -0
  60. package/dist/websocket-channel.d.ts.map +1 -0
  61. package/dist/websocket-channel.js +165 -0
  62. package/dist/websocket-channel.js.map +1 -0
  63. package/package.json +33 -3
@@ -0,0 +1,240 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.TcpChannel = void 0;
37
+ const node_events_1 = require("node:events");
38
+ const net = __importStar(require("node:net"));
39
+ const native_bridge_1 = require("./native-bridge");
40
+ /**
41
+ * High-performance TCP Channel with zero-copy delimited frame parser.
42
+ * Backed by Tokio / Rust native bindings with graceful fallback to node:net.
43
+ */
44
+ class TcpChannel extends node_events_1.EventEmitter {
45
+ nativeInstance;
46
+ jsSocket;
47
+ _isClosed = false;
48
+ _isNative = false;
49
+ constructor() {
50
+ super();
51
+ }
52
+ /**
53
+ * Connects to a remote TCP server endpoint.
54
+ */
55
+ static async connect(options) {
56
+ const channel = new TcpChannel();
57
+ const useNative = !options.forceJsFallback && (0, native_bridge_1.isNativeNetAvailable)();
58
+ if (useNative) {
59
+ const bindings = (0, native_bridge_1.getNativeNetBindings)();
60
+ const delimiterStr = typeof options.delimiter === 'string'
61
+ ? options.delimiter
62
+ : options.delimiter
63
+ ? Buffer.from(options.delimiter).toString('utf-8')
64
+ : '\r\n\r\n';
65
+ try {
66
+ const nativeOptions = {
67
+ host: options.host,
68
+ port: options.port,
69
+ delimiter: delimiterStr,
70
+ noDelay: options.noDelay ?? true,
71
+ };
72
+ if (options.maxFrameSize !== undefined) {
73
+ nativeOptions.maxFrameSize = options.maxFrameSize;
74
+ }
75
+ if (options.keepAlive && options.keepAliveInitialDelayMs !== undefined) {
76
+ nativeOptions.keepAliveMs = options.keepAliveInitialDelayMs;
77
+ }
78
+ const nativeInst = await bindings.NativeTcpChannel.connect(nativeOptions);
79
+ channel.nativeInstance = nativeInst;
80
+ channel._isNative = true;
81
+ nativeInst.onFrame((buf) => {
82
+ channel.emit('frame', buf);
83
+ });
84
+ nativeInst.onError((errStr) => {
85
+ channel.emit('error', new Error(errStr));
86
+ });
87
+ nativeInst.onClose(() => {
88
+ channel._isClosed = true;
89
+ channel.emit('close');
90
+ });
91
+ return channel;
92
+ }
93
+ catch (err) {
94
+ if (options.forceJsFallback === false) {
95
+ throw err;
96
+ }
97
+ // Fall back to JavaScript implementation on connection error if fallback permitted
98
+ }
99
+ }
100
+ // JavaScript / node:net Fallback implementation
101
+ channel._isNative = false;
102
+ await channel.initJsFallback(options);
103
+ return channel;
104
+ }
105
+ initJsFallback(options) {
106
+ return new Promise((resolve, reject) => {
107
+ const socket = net.createConnection({
108
+ host: options.host,
109
+ port: options.port,
110
+ });
111
+ this.jsSocket = socket;
112
+ socket.setNoDelay(options.noDelay ?? true);
113
+ if (options.keepAlive) {
114
+ socket.setKeepAlive(true, options.keepAliveInitialDelayMs ?? 1000);
115
+ }
116
+ const delimiterBuf = typeof options.delimiter === 'string'
117
+ ? Buffer.from(options.delimiter)
118
+ : options.delimiter
119
+ ? Buffer.from(options.delimiter)
120
+ : Buffer.from('\r\n\r\n');
121
+ const maxFrameSize = options.maxFrameSize ?? 10 * 1024 * 1024;
122
+ let accumulator = Buffer.alloc(0);
123
+ socket.once('connect', () => {
124
+ resolve();
125
+ });
126
+ socket.once('error', (err) => {
127
+ reject(err);
128
+ });
129
+ socket.on('data', (chunk) => {
130
+ accumulator = Buffer.concat([accumulator, chunk]);
131
+ while (true) {
132
+ const index = accumulator.indexOf(delimiterBuf);
133
+ if (index !== -1) {
134
+ if (index > maxFrameSize) {
135
+ this.emit('error', new Error(`Max frame size of ${maxFrameSize} bytes exceeded (current: ${index} bytes)`));
136
+ this._isClosed = true;
137
+ socket.destroy();
138
+ return;
139
+ }
140
+ const frame = accumulator.subarray(0, index);
141
+ accumulator = accumulator.subarray(index + delimiterBuf.length);
142
+ this.emit('frame', frame);
143
+ }
144
+ else {
145
+ if (accumulator.length > maxFrameSize) {
146
+ this.emit('error', new Error(`Max frame size of ${maxFrameSize} bytes exceeded (current: ${accumulator.length} bytes)`));
147
+ this._isClosed = true;
148
+ socket.destroy();
149
+ }
150
+ break;
151
+ }
152
+ }
153
+ });
154
+ socket.on('error', (err) => {
155
+ if (!this._isClosed) {
156
+ this.emit('error', err);
157
+ }
158
+ });
159
+ socket.on('close', () => {
160
+ this._isClosed = true;
161
+ this.emit('close');
162
+ });
163
+ });
164
+ }
165
+ /**
166
+ * Sends raw byte payload or string across the socket.
167
+ */
168
+ async send(payload) {
169
+ if (this._isClosed) {
170
+ throw new Error('Cannot send on closed TCP channel');
171
+ }
172
+ const data = typeof payload === 'string' ? Buffer.from(payload) : Buffer.from(payload);
173
+ if (this._isNative && this.nativeInstance) {
174
+ await this.nativeInstance.send(data);
175
+ return;
176
+ }
177
+ if (this.jsSocket) {
178
+ return new Promise((resolve, reject) => {
179
+ this.jsSocket.write(data, (err) => {
180
+ if (err)
181
+ reject(err);
182
+ else
183
+ resolve();
184
+ });
185
+ });
186
+ }
187
+ throw new Error('TCP socket connection not initialized');
188
+ }
189
+ /**
190
+ * Gracefully closes the TCP channel.
191
+ */
192
+ async disconnect() {
193
+ if (this._isClosed) {
194
+ return;
195
+ }
196
+ this._isClosed = true;
197
+ if (this._isNative && this.nativeInstance) {
198
+ await this.nativeInstance.close();
199
+ return;
200
+ }
201
+ if (this.jsSocket) {
202
+ return new Promise((resolve) => {
203
+ this.jsSocket.end(() => {
204
+ this.jsSocket.destroy();
205
+ resolve();
206
+ });
207
+ });
208
+ }
209
+ }
210
+ /**
211
+ * Alias for disconnect().
212
+ */
213
+ async close() {
214
+ return this.disconnect();
215
+ }
216
+ /**
217
+ * Indicates whether this channel is powered by native Rust/Tokio bindings.
218
+ */
219
+ get isNative() {
220
+ return this._isNative;
221
+ }
222
+ /**
223
+ * Indicates whether the channel has closed.
224
+ */
225
+ get isClosed() {
226
+ return this._isClosed;
227
+ }
228
+ // Typed EventEmitter overrides
229
+ on(event, listener) {
230
+ return super.on(event, listener);
231
+ }
232
+ once(event, listener) {
233
+ return super.once(event, listener);
234
+ }
235
+ emit(event, ...args) {
236
+ return super.emit(event, ...args);
237
+ }
238
+ }
239
+ exports.TcpChannel = TcpChannel;
240
+ //# sourceMappingURL=tcp-channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tcp-channel.js","sourceRoot":"","sources":["../src/tcp-channel.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2C;AAC3C,8CAAgC;AAChC,mDAIyB;AAmBzB;;;GAGG;AACH,MAAa,UAAW,SAAQ,0BAAY;IAClC,cAAc,CAA4B;IAC1C,QAAQ,CAAc;IACtB,SAAS,GAAG,KAAK,CAAC;IAClB,SAAS,GAAG,KAAK,CAAC;IAE1B;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAA0B;QACpD,MAAM,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,IAAA,oCAAoB,GAAE,CAAC;QAErE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,QAAQ,GAAG,IAAA,oCAAoB,GAAG,CAAC;YACzC,MAAM,YAAY,GAChB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;gBACnC,CAAC,CAAC,OAAO,CAAC,SAAS;gBACnB,CAAC,CAAC,OAAO,CAAC,SAAS;oBACjB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAClD,CAAC,CAAC,UAAU,CAAC;YAEnB,IAAI,CAAC;gBACH,MAAM,aAAa,GAA+C;oBAChE,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,SAAS,EAAE,YAAY;oBACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;iBACjC,CAAC;gBACF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;oBACvC,aAAa,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;gBACpD,CAAC;gBACD,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,uBAAuB,KAAK,SAAS,EAAE,CAAC;oBACvE,aAAa,CAAC,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC;gBAC9D,CAAC;gBAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBAE1E,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC;gBACpC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;gBAEzB,UAAU,CAAC,OAAO,CAAC,CAAC,GAAW,EAAE,EAAE;oBACjC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC7B,CAAC,CAAC,CAAC;gBAEH,UAAU,CAAC,OAAO,CAAC,CAAC,MAAc,EAAE,EAAE;oBACpC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3C,CAAC,CAAC,CAAC;gBAEH,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE;oBACtB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;oBACzB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC,CAAC,CAAC;gBAEH,OAAO,OAAO,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;oBACtC,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,mFAAmF;YACrF,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;QAC1B,MAAM,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,cAAc,CAAC,OAA0B;QAC/C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC;gBAClC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;YACvB,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;YAE3C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,YAAY,GAChB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;gBACnC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBAChC,CAAC,CAAC,OAAO,CAAC,SAAS;oBACjB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;oBAChC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEhC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;YAC9D,IAAI,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAElC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBAC1B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC3B,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBAClC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;gBAElD,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBAChD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;wBACjB,IAAI,KAAK,GAAG,YAAY,EAAE,CAAC;4BACzB,IAAI,CAAC,IAAI,CACP,OAAO,EACP,IAAI,KAAK,CAAC,qBAAqB,YAAY,6BAA6B,KAAK,SAAS,CAAC,CACxF,CAAC;4BACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;4BACtB,MAAM,CAAC,OAAO,EAAE,CAAC;4BACjB,OAAO;wBACT,CAAC;wBAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;wBAC7C,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;wBAChE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;oBAC5B,CAAC;yBAAM,CAAC;wBACN,IAAI,WAAW,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;4BACtC,IAAI,CAAC,IAAI,CACP,OAAO,EACP,IAAI,KAAK,CACP,qBAAqB,YAAY,6BAA6B,WAAW,CAAC,MAAM,SAAS,CAC1F,CACF,CAAC;4BACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;4BACtB,MAAM,CAAC,OAAO,EAAE,CAAC;wBACnB,CAAC;wBACD,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAI,CAAC,OAA4B;QAC5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEvF,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC3C,IAAI,CAAC,QAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;oBACjC,IAAI,GAAG;wBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;wBAChB,OAAO,EAAE,CAAC;gBACjB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACnC,IAAI,CAAC,QAAS,CAAC,GAAG,CAAC,GAAG,EAAE;oBACtB,IAAI,CAAC,QAAS,CAAC,OAAO,EAAE,CAAC;oBACzB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QAChB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,+BAA+B;IACf,EAAE,CAChB,KAAQ,EACR,QAA+B;QAE/B,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAC;IAC/D,CAAC;IAEe,IAAI,CAClB,KAAQ,EACR,QAA+B;QAE/B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAoC,CAAC,CAAC;IACjE,CAAC;IAEe,IAAI,CAClB,KAAQ,EACR,GAAG,IAAuC;QAE1C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAtPD,gCAsPC"}
@@ -0,0 +1,190 @@
1
+ import type { JsHttpRequest, JsHttpResponse } from '@argos-js/argox-core';
2
+ import { BaseValidator, type SchemaDefinition, type Infer } from './validation';
3
+ export interface HttpContextHelpers {
4
+ ok(data?: unknown, message?: string): JsHttpResponse;
5
+ created(data?: unknown, message?: string): JsHttpResponse;
6
+ noContent(): JsHttpResponse;
7
+ badRequest(error?: unknown): JsHttpResponse;
8
+ unauthorized(error?: unknown): JsHttpResponse;
9
+ forbidden(error?: unknown): JsHttpResponse;
10
+ notFound(error?: unknown): JsHttpResponse;
11
+ unprocessableEntity(errors?: unknown): JsHttpResponse;
12
+ tooManyRequests(error?: unknown): JsHttpResponse;
13
+ internalServerError(error?: unknown): JsHttpResponse;
14
+ }
15
+ export interface UploadedFile {
16
+ name: string;
17
+ filename: string;
18
+ data: Buffer;
19
+ size: number;
20
+ mimeType: string;
21
+ }
22
+ /**
23
+ * Configuration options for setting HTTP cookies (RFC 6265).
24
+ */
25
+ export interface CookieOptions {
26
+ maxAge?: number;
27
+ expires?: Date;
28
+ httpOnly?: boolean;
29
+ secure?: boolean;
30
+ sameSite?: 'Strict' | 'Lax' | 'None';
31
+ domain?: string;
32
+ path?: string;
33
+ }
34
+ /**
35
+ * Execution context representing an active HTTP request and its lifecycle.
36
+ */
37
+ export declare class ArgosContext {
38
+ readonly id: string;
39
+ readonly method: string;
40
+ readonly path: string;
41
+ readonly headers: Record<string, string>;
42
+ query: Record<string, string>;
43
+ params: Record<string, string>;
44
+ readonly rawText?: string | undefined;
45
+ readonly rawBody?: Buffer | undefined;
46
+ readonly http: HttpContextHelpers;
47
+ private state;
48
+ private _statusCode;
49
+ private _responseHeaders;
50
+ private _parsedCookies?;
51
+ private _cookiesToSet;
52
+ private _formDataCache?;
53
+ private _parsedBodyCache?;
54
+ constructor(raw: JsHttpRequest & {
55
+ rawBody?: Buffer;
56
+ rawBuffer?: Buffer;
57
+ });
58
+ /**
59
+ * Helper genérico e inteligente para leitura do payload da requisição.
60
+ * Suporta JSON parsing automático com fallback para o texto bruto acumulado.
61
+ */
62
+ body<T = unknown>(): Promise<T>;
63
+ /**
64
+ * Helper to safely parse JSON body content.
65
+ */
66
+ bodyJson<T = unknown>(): T | null;
67
+ /**
68
+ * Helper to parse URL-encoded form body payload (application/x-www-form-urlencoded).
69
+ */
70
+ bodyForm(): Record<string, string>;
71
+ /**
72
+ * Faz a leitura e parsing de formulários application/x-www-form-urlencoded ou multipart/form-data.
73
+ * Separa os campos em texto simples e os arquivos anexados em objetos UploadedFile contendo Buffer.
74
+ */
75
+ formData(): Promise<{
76
+ fields: Record<string, string>;
77
+ files: Record<string, UploadedFile>;
78
+ }>;
79
+ /**
80
+ * Armazena um valor tipado no mapa de estado da requisição.
81
+ */
82
+ set<T = unknown>(key: string, value: T): void;
83
+ /**
84
+ * Recupera um valor tipado do estado da requisição.
85
+ */
86
+ get<T = unknown>(key: string): T | undefined;
87
+ /**
88
+ * Recupera um valor tipado do estado, disparando erro se a chave não existir.
89
+ */
90
+ getOrThrow<T = unknown>(key: string): T;
91
+ /**
92
+ * Armazena o código de status HTTP e retorna a própria instância de contexto para encadeamento.
93
+ */
94
+ status(code: number): this;
95
+ /**
96
+ * Define um cabeçalho para a resposta e retorna a própria instância de contexto para encadeamento.
97
+ */
98
+ header(name: string, value: string): this;
99
+ /**
100
+ * Lê um cabeçalho da requisição recebida (busca case-insensitive).
101
+ */
102
+ getHeader(name: string): string | undefined;
103
+ /**
104
+ * Lê um cookie da requisição recebida decodificando seu valor.
105
+ */
106
+ getCookie(name: string): string | undefined;
107
+ /**
108
+ * Configura um cookie na resposta HTTP compatível com a RFC 6265.
109
+ */
110
+ setCookie(name: string, value: string, options?: CookieOptions): this;
111
+ /**
112
+ * Remove um cookie definindo valor vazio e expiração imediata no passado.
113
+ */
114
+ clearCookie(name: string, options?: CookieOptions): this;
115
+ /**
116
+ * Constrói os cabeçalhos de resposta HTTP mesclando customHeaders,
117
+ * _responseHeaders e os cabeçalhos Set-Cookie configurados.
118
+ */
119
+ private buildResponseHeaders;
120
+ /**
121
+ * Retorna resposta formatada em JSON, respeitando o status previamente definido via status()
122
+ * caso nenhum status explícito seja fornecido.
123
+ */
124
+ json(data: unknown, statusCode?: number, customHeaders?: Record<string, string>): JsHttpResponse;
125
+ /**
126
+ * Retorna o corpo da requisição como texto (quando chamado sem parâmetros)
127
+ * ou formata uma resposta HTTP em texto simples (text/plain; charset=utf-8).
128
+ */
129
+ text(): Promise<string>;
130
+ text(content: string, status?: number): JsHttpResponse;
131
+ /**
132
+ * Retorna resposta em HTML (text/html; charset=utf-8).
133
+ */
134
+ html(content: string, status?: number): JsHttpResponse;
135
+ /**
136
+ * Helper semântico HTTP 200 OK.
137
+ */
138
+ ok(data?: unknown, message?: string): JsHttpResponse;
139
+ /**
140
+ * Helper semântico HTTP 201 Created.
141
+ */
142
+ created(data?: unknown, message?: string): JsHttpResponse;
143
+ /**
144
+ * Helper semântico HTTP 204 No Content.
145
+ */
146
+ noContent(): JsHttpResponse;
147
+ /**
148
+ * Helper semântico HTTP 400 Bad Request.
149
+ */
150
+ badRequest(error?: unknown): JsHttpResponse;
151
+ /**
152
+ * Helper semântico HTTP 401 Unauthorized.
153
+ */
154
+ unauthorized(error?: unknown): JsHttpResponse;
155
+ /**
156
+ * Helper semântico HTTP 403 Forbidden.
157
+ */
158
+ forbidden(error?: unknown): JsHttpResponse;
159
+ /**
160
+ * Helper semântico HTTP 404 Not Found.
161
+ */
162
+ notFound(error?: unknown): JsHttpResponse;
163
+ /**
164
+ * Helper semântico HTTP 422 Unprocessable Entity.
165
+ */
166
+ unprocessableEntity(errors?: unknown): JsHttpResponse;
167
+ /**
168
+ * Helper semântico HTTP 429 Too Many Requests.
169
+ */
170
+ tooManyRequests(error?: unknown): JsHttpResponse;
171
+ /**
172
+ * Helper semântico HTTP 500 Internal Server Error.
173
+ */
174
+ internalServerError(error?: unknown): JsHttpResponse;
175
+ /**
176
+ * Fluent validation helper for request payloads (body, query, or path params).
177
+ * Automatically extracts from body for POST/PUT/PATCH, and query for GET/DELETE if source is omitted.
178
+ * Throws a ValidationError (HTTP 422 Unprocessable Entity) if fields are invalid or missing.
179
+ */
180
+ validate<S extends Record<string, BaseValidator<any>>>(schema: S, source?: 'body' | 'query' | 'params'): Promise<{
181
+ [K in keyof S]: Infer<S[K]>;
182
+ }>;
183
+ validate<S extends BaseValidator<any>>(schema: S, source?: 'body' | 'query' | 'params'): Promise<Infer<S>>;
184
+ validate<T = any>(schema: SchemaDefinition, source?: 'body' | 'query' | 'params'): Promise<T>;
185
+ }
186
+ /**
187
+ * Handler interface for dispatching requests through the middleware pipeline.
188
+ */
189
+ export type RequestHandler = (ctx: ArgosContext) => Promise<JsHttpResponse> | JsHttpResponse;
190
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,aAAa,EAAmB,KAAK,gBAAgB,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAGjG,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC1D,SAAS,IAAI,cAAc,CAAC;IAC5B,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAC5C,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAC9C,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAC1C,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACtD,eAAe,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACjD,mBAAmB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAgB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAgB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAgB,IAAI,EAAE,kBAAkB,CAAC;IAEzC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,cAAc,CAAC,CAAyB;IAChD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAC,CAA0E;IACjG,OAAO,CAAC,gBAAgB,CAAC,CAAU;gBAEvB,GAAG,EAAE,aAAa,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAwBzE;;;OAGG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;IAuB5C;;OAEG;IACI,QAAQ,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,IAAI;IAexC;;OAEG;IACI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAezC;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;KAAE,CAAC;IAuIzG;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIpD;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAInD;;OAEG;IACI,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAO9C;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAalD;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA0BlD;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAkC5E;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAS/D;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACI,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,cAAc;IAY3G;;;OAGG;IACI,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IACvB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc;IAiB7D;;OAEG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc;IAY7D;;OAEG;IACI,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;IAI3D;;OAEG;IACI,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc;IAIhE;;OAEG;IACI,SAAS,IAAI,cAAc;IASlC;;OAEG;IACI,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc;IAIlD;;OAEG;IACI,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc;IAIpD;;OAEG;IACI,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc;IAIjD;;OAEG;IACI,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc;IAIhD;;OAEG;IACI,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,cAAc;IAI5D;;OAEG;IACI,eAAe,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc;IAIvD;;OAEG;IACI,mBAAmB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc;IAI3D;;;;OAIG;IACU,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,EAChE,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GACnC,OAAO,CAAC;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAC9B,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,EAChD,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GACnC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACP,QAAQ,CAAC,CAAC,GAAG,GAAG,EAC3B,MAAM,EAAE,gBAAgB,EACxB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GACnC,OAAO,CAAC,CAAC,CAAC;CAsEd;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC"}