@visulima/pail 4.0.0-alpha.5 → 4.0.0-alpha.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +37 -0
- package/LICENSE.md +6 -6
- package/README.md +323 -0
- package/dist/error.d.ts +104 -0
- package/dist/error.js +76 -0
- package/dist/index.browser.d.ts +2 -0
- package/dist/index.browser.js +2 -1
- package/dist/index.server.d.ts +2 -0
- package/dist/index.server.js +6 -4
- package/dist/interactive/index.js +1 -1
- package/dist/middleware/elysia.d.ts +71 -0
- package/dist/middleware/elysia.js +70 -0
- package/dist/middleware/express.d.ts +86 -0
- package/dist/middleware/express.js +29 -0
- package/dist/middleware/fastify.d.ts +81 -0
- package/dist/middleware/fastify.js +46 -0
- package/dist/middleware/hono.d.ts +85 -0
- package/dist/middleware/hono.js +33 -0
- package/dist/middleware/next/handler.d.ts +36 -0
- package/dist/middleware/next/handler.js +53 -0
- package/dist/middleware/next/middleware.d.ts +59 -0
- package/dist/middleware/next/storage.d.ts +14 -0
- package/dist/middleware/shared/create-middleware-logger.d.ts +82 -0
- package/dist/middleware/shared/headers.d.ts +14 -0
- package/dist/middleware/shared/routes.d.ts +30 -0
- package/dist/middleware/shared/storage.d.ts +29 -0
- package/dist/middleware/sveltekit.d.ts +123 -0
- package/dist/middleware/sveltekit.js +43 -0
- package/dist/packem_shared/{AbstractJsonReporter-DWRpTtGw.js → AbstractJsonReporter-CGKHS8_M.js} +103 -21
- package/dist/packem_shared/{AbstractJsonReporter-BaZ33PlE.js → AbstractJsonReporter-DDjDkciI.js} +103 -21
- package/dist/packem_shared/{InteractiveManager-CbE7d1kY.js → InteractiveManager-Cd6A14ZK.js} +1 -1
- package/dist/packem_shared/{JsonReporter-BV5lMnJX.js → JsonReporter-B3XX8GHN.js} +1 -1
- package/dist/packem_shared/{JsonReporter-BRw4skd5.js → JsonReporter-p_BXg6Sj.js} +1 -1
- package/dist/packem_shared/{PrettyReporter-DLQtmATi.js → PrettyReporter-CvBn-hxP.js} +5 -4
- package/dist/packem_shared/{Spinner-B9JUdsbY.js → Spinner-DIdVcfWq.js} +34 -1
- package/dist/packem_shared/{abstract-pretty-reporter-DckLMlGF.js → abstract-pretty-reporter-jU8WL_6c.js} +121 -15
- package/dist/packem_shared/createPailError-B11aRfrT.js +76 -0
- package/dist/packem_shared/headers-Cp4uLtr4.js +123 -0
- package/dist/packem_shared/{index-EZ_WSQZS.js → index-frijFf5m.js} +120 -14
- package/dist/packem_shared/pailMiddleware-Ci88geIF.js +24 -0
- package/dist/packem_shared/storage-D0vqz8OX.js +36 -0
- package/dist/packem_shared/useLogger-D0rU3lcX.js +33 -0
- package/dist/processor/environment-processor.d.ts +124 -0
- package/dist/processor/environment-processor.js +78 -0
- package/dist/processor/message-formatter-processor.d.ts +1 -2
- package/dist/processor/sampling-processor.d.ts +111 -0
- package/dist/processor/sampling-processor.js +59 -0
- package/dist/reporter/file/json-file-reporter.js +1 -1
- package/dist/reporter/http/abstract-http-reporter.js +1 -1
- package/dist/reporter/http/http-reporter.edge-light.js +103 -21
- package/dist/reporter/json/index.browser.js +2 -2
- package/dist/reporter/json/index.js +2 -2
- package/dist/reporter/pretty/index.js +1 -1
- package/dist/reporter/simple/simple-reporter.server.js +4 -3
- package/dist/spinner.js +34 -1
- package/dist/wide-event.d.ts +300 -0
- package/dist/wide-event.js +281 -0
- package/package.json +68 -4
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { WideEvent } from '../wide-event.js';
|
|
2
|
+
|
|
3
|
+
const patternToRegex = (pattern) => {
|
|
4
|
+
let regex = "^";
|
|
5
|
+
let index = 0;
|
|
6
|
+
while (index < pattern.length) {
|
|
7
|
+
const char = pattern[index];
|
|
8
|
+
if (char === "*" && pattern[index + 1] === "*") {
|
|
9
|
+
index += 2;
|
|
10
|
+
if (pattern[index] === "/") {
|
|
11
|
+
index += 1;
|
|
12
|
+
}
|
|
13
|
+
if (index >= pattern.length && regex.endsWith("/")) {
|
|
14
|
+
regex = `${regex.slice(0, -1)}(/.*)?`;
|
|
15
|
+
} else if (index >= pattern.length) {
|
|
16
|
+
regex += ".*";
|
|
17
|
+
} else {
|
|
18
|
+
regex += "(.*/)?";
|
|
19
|
+
}
|
|
20
|
+
} else {
|
|
21
|
+
switch (char) {
|
|
22
|
+
case "*": {
|
|
23
|
+
regex += "[^/]*";
|
|
24
|
+
index += 1;
|
|
25
|
+
break;
|
|
26
|
+
}
|
|
27
|
+
case ".": {
|
|
28
|
+
regex += String.raw`\.`;
|
|
29
|
+
index += 1;
|
|
30
|
+
break;
|
|
31
|
+
}
|
|
32
|
+
case "?": {
|
|
33
|
+
regex += "[^/]";
|
|
34
|
+
index += 1;
|
|
35
|
+
break;
|
|
36
|
+
}
|
|
37
|
+
default: {
|
|
38
|
+
regex += char;
|
|
39
|
+
index += 1;
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
regex += "$";
|
|
45
|
+
return new RegExp(regex);
|
|
46
|
+
};
|
|
47
|
+
const matchesPattern = (path, pattern) => patternToRegex(pattern).test(path);
|
|
48
|
+
const shouldLog = (path, include, exclude) => {
|
|
49
|
+
if (exclude?.some((pattern) => matchesPattern(path, pattern))) {
|
|
50
|
+
return false;
|
|
51
|
+
}
|
|
52
|
+
if (!include?.length) {
|
|
53
|
+
return true;
|
|
54
|
+
}
|
|
55
|
+
return include.some((pattern) => matchesPattern(path, pattern));
|
|
56
|
+
};
|
|
57
|
+
const getServiceForPath = (path, routes) => {
|
|
58
|
+
if (!routes) {
|
|
59
|
+
return void 0;
|
|
60
|
+
}
|
|
61
|
+
for (const [pattern, config] of Object.entries(routes)) {
|
|
62
|
+
if (matchesPattern(path, pattern)) {
|
|
63
|
+
return config.service;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return void 0;
|
|
67
|
+
};
|
|
68
|
+
|
|
69
|
+
const createMiddlewareLogger = (options, request) => {
|
|
70
|
+
const { exclude, include, pail, routes, service } = options;
|
|
71
|
+
const { headers, method, path, requestId } = request;
|
|
72
|
+
if (!shouldLog(path, include, exclude)) {
|
|
73
|
+
const noopLogger = new WideEvent({ autoEmit: false, name: `${method} ${path}`, pail });
|
|
74
|
+
return {
|
|
75
|
+
finish: () => {
|
|
76
|
+
},
|
|
77
|
+
logger: noopLogger,
|
|
78
|
+
skipped: true
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
const routeService = getServiceForPath(path, routes) ?? service;
|
|
82
|
+
const logger = new WideEvent({
|
|
83
|
+
name: `${method} ${path}`,
|
|
84
|
+
pail,
|
|
85
|
+
service: routeService
|
|
86
|
+
});
|
|
87
|
+
logger.set({
|
|
88
|
+
method,
|
|
89
|
+
path,
|
|
90
|
+
requestId,
|
|
91
|
+
...headers ? { headers } : {}
|
|
92
|
+
});
|
|
93
|
+
const finish = (finishOptions) => {
|
|
94
|
+
logger.finish(finishOptions);
|
|
95
|
+
};
|
|
96
|
+
return {
|
|
97
|
+
finish,
|
|
98
|
+
logger,
|
|
99
|
+
skipped: false
|
|
100
|
+
};
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
const SENSITIVE_HEADERS = /* @__PURE__ */ new Set(["authorization", "cookie", "proxy-authorization", "set-cookie", "x-api-key", "x-auth-token"]);
|
|
104
|
+
const extractSafeHeaders = (headers) => {
|
|
105
|
+
const safe = {};
|
|
106
|
+
headers.forEach((value, key) => {
|
|
107
|
+
if (!SENSITIVE_HEADERS.has(key.toLowerCase())) {
|
|
108
|
+
safe[key.toLowerCase()] = value;
|
|
109
|
+
}
|
|
110
|
+
});
|
|
111
|
+
return safe;
|
|
112
|
+
};
|
|
113
|
+
const extractSafeNodeHeaders = (headers) => {
|
|
114
|
+
const safe = {};
|
|
115
|
+
for (const [key, value] of Object.entries(headers)) {
|
|
116
|
+
if (!SENSITIVE_HEADERS.has(key.toLowerCase()) && value !== void 0) {
|
|
117
|
+
safe[key.toLowerCase()] = Array.isArray(value) ? value.join(", ") : value;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
return safe;
|
|
121
|
+
};
|
|
122
|
+
|
|
123
|
+
export { extractSafeHeaders as a, createMiddlewareLogger as c, extractSafeNodeHeaders as e };
|
|
@@ -79,25 +79,104 @@ const RE_ANSI = /[\u001B\u009B](?:[[()#;?]{0,10}(?:\d{1,4}(?:;\d{0,4})*)?[0-9A-O
|
|
|
79
79
|
const RE_CONTROL = /[\u0000-\u0008\n-\u001F\u007F-\u009F]{1,1000}/y;
|
|
80
80
|
const RE_EMOJI = emojiRegex();
|
|
81
81
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
82
|
+
const ambiguousRanges = [161, 161, 164, 164, 167, 168, 170, 170, 173, 174, 176, 180, 182, 186, 188, 191, 198, 198, 208, 208, 215, 216, 222, 225, 230, 230, 232, 234, 236, 237, 240, 240, 242, 243, 247, 250, 252, 252, 254, 254, 257, 257, 273, 273, 275, 275, 283, 283, 294, 295, 299, 299, 305, 307, 312, 312, 319, 322, 324, 324, 328, 331, 333, 333, 338, 339, 358, 359, 363, 363, 462, 462, 464, 464, 466, 466, 468, 468, 470, 470, 472, 472, 474, 474, 476, 476, 593, 593, 609, 609, 708, 708, 711, 711, 713, 715, 717, 717, 720, 720, 728, 731, 733, 733, 735, 735, 768, 879, 913, 929, 931, 937, 945, 961, 963, 969, 1025, 1025, 1040, 1103, 1105, 1105, 8208, 8208, 8211, 8214, 8216, 8217, 8220, 8221, 8224, 8226, 8228, 8231, 8240, 8240, 8242, 8243, 8245, 8245, 8251, 8251, 8254, 8254, 8308, 8308, 8319, 8319, 8321, 8324, 8364, 8364, 8451, 8451, 8453, 8453, 8457, 8457, 8467, 8467, 8470, 8470, 8481, 8482, 8486, 8486, 8491, 8491, 8531, 8532, 8539, 8542, 8544, 8555, 8560, 8569, 8585, 8585, 8592, 8601, 8632, 8633, 8658, 8658, 8660, 8660, 8679, 8679, 8704, 8704, 8706, 8707, 8711, 8712, 8715, 8715, 8719, 8719, 8721, 8721, 8725, 8725, 8730, 8730, 8733, 8736, 8739, 8739, 8741, 8741, 8743, 8748, 8750, 8750, 8756, 8759, 8764, 8765, 8776, 8776, 8780, 8780, 8786, 8786, 8800, 8801, 8804, 8807, 8810, 8811, 8814, 8815, 8834, 8835, 8838, 8839, 8853, 8853, 8857, 8857, 8869, 8869, 8895, 8895, 8978, 8978, 9312, 9449, 9451, 9547, 9552, 9587, 9600, 9615, 9618, 9621, 9632, 9633, 9635, 9641, 9650, 9651, 9654, 9655, 9660, 9661, 9664, 9665, 9670, 9672, 9675, 9675, 9678, 9681, 9698, 9701, 9711, 9711, 9733, 9734, 9737, 9737, 9742, 9743, 9756, 9756, 9758, 9758, 9792, 9792, 9794, 9794, 9824, 9825, 9827, 9829, 9831, 9834, 9836, 9837, 9839, 9839, 9886, 9887, 9919, 9919, 9926, 9933, 9935, 9939, 9941, 9953, 9955, 9955, 9960, 9961, 9963, 9969, 9972, 9972, 9974, 9977, 9979, 9980, 9982, 9983, 10045, 10045, 10102, 10111, 11094, 11097, 12872, 12879, 57344, 63743, 65024, 65039, 65533, 65533, 127232, 127242, 127248, 127277, 127280, 127337, 127344, 127373, 127375, 127376, 127387, 127404, 917760, 917999, 983040, 1048573, 1048576, 1114109];
|
|
83
|
+
const fullwidthRanges = [12288, 12288, 65281, 65376, 65504, 65510];
|
|
84
|
+
const halfwidthRanges = [8361, 8361, 65377, 65470, 65474, 65479, 65482, 65487, 65490, 65495, 65498, 65500, 65512, 65518];
|
|
85
|
+
const narrowRanges = [32, 126, 162, 163, 165, 166, 172, 172, 175, 175, 10214, 10221, 10629, 10630];
|
|
86
|
+
const wideRanges = [4352, 4447, 8986, 8987, 9001, 9002, 9193, 9196, 9200, 9200, 9203, 9203, 9725, 9726, 9748, 9749, 9776, 9783, 9800, 9811, 9855, 9855, 9866, 9871, 9875, 9875, 9889, 9889, 9898, 9899, 9917, 9918, 9924, 9925, 9934, 9934, 9940, 9940, 9962, 9962, 9970, 9971, 9973, 9973, 9978, 9978, 9981, 9981, 9989, 9989, 9994, 9995, 10024, 10024, 10060, 10060, 10062, 10062, 10067, 10069, 10071, 10071, 10133, 10135, 10160, 10160, 10175, 10175, 11035, 11036, 11088, 11088, 11093, 11093, 11904, 11929, 11931, 12019, 12032, 12245, 12272, 12287, 12289, 12350, 12353, 12438, 12441, 12543, 12549, 12591, 12593, 12686, 12688, 12773, 12783, 12830, 12832, 12871, 12880, 42124, 42128, 42182, 43360, 43388, 44032, 55203, 63744, 64255, 65040, 65049, 65072, 65106, 65108, 65126, 65128, 65131, 94176, 94180, 94192, 94198, 94208, 101589, 101631, 101662, 101760, 101874, 110576, 110579, 110581, 110587, 110589, 110590, 110592, 110882, 110898, 110898, 110928, 110930, 110933, 110933, 110948, 110951, 110960, 111355, 119552, 119638, 119648, 119670, 126980, 126980, 127183, 127183, 127374, 127374, 127377, 127386, 127488, 127490, 127504, 127547, 127552, 127560, 127568, 127569, 127584, 127589, 127744, 127776, 127789, 127797, 127799, 127868, 127870, 127891, 127904, 127946, 127951, 127955, 127968, 127984, 127988, 127988, 127992, 128062, 128064, 128064, 128066, 128252, 128255, 128317, 128331, 128334, 128336, 128359, 128378, 128378, 128405, 128406, 128420, 128420, 128507, 128591, 128640, 128709, 128716, 128716, 128720, 128722, 128725, 128728, 128732, 128735, 128747, 128748, 128756, 128764, 128992, 129003, 129008, 129008, 129292, 129338, 129340, 129349, 129351, 129535, 129648, 129660, 129664, 129674, 129678, 129734, 129736, 129736, 129741, 129756, 129759, 129770, 129775, 129784, 131072, 196605, 196608, 262141];
|
|
87
|
+
const isInRange = (ranges, codePoint) => {
|
|
88
|
+
let low = 0;
|
|
89
|
+
let high = Math.floor(ranges.length / 2) - 1;
|
|
90
|
+
while (low <= high) {
|
|
91
|
+
const mid = Math.floor((low + high) / 2);
|
|
92
|
+
const i = mid * 2;
|
|
93
|
+
if (codePoint < ranges[i]) {
|
|
94
|
+
high = mid - 1;
|
|
95
|
+
} else if (codePoint > ranges[i + 1]) {
|
|
96
|
+
low = mid + 1;
|
|
97
|
+
} else {
|
|
98
|
+
return true;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
return false;
|
|
102
|
+
};
|
|
103
|
+
const minimumAmbiguousCodePoint = ambiguousRanges[0];
|
|
104
|
+
const maximumAmbiguousCodePoint = ambiguousRanges.at(-1);
|
|
105
|
+
const minimumFullWidthCodePoint = fullwidthRanges[0];
|
|
106
|
+
const maximumFullWidthCodePoint = fullwidthRanges.at(-1);
|
|
107
|
+
const minimumHalfWidthCodePoint = halfwidthRanges[0];
|
|
108
|
+
const maximumHalfWidthCodePoint = halfwidthRanges.at(-1);
|
|
109
|
+
const minimumNarrowCodePoint = narrowRanges[0];
|
|
110
|
+
const maximumNarrowCodePoint = narrowRanges.at(-1);
|
|
111
|
+
const minimumWideCodePoint = wideRanges[0];
|
|
112
|
+
const maximumWideCodePoint = wideRanges.at(-1);
|
|
113
|
+
const commonCjkCodePoint = 19968;
|
|
114
|
+
const [wideFastPathStart, wideFastPathEnd] = findWideFastPathRange(wideRanges);
|
|
115
|
+
function findWideFastPathRange(ranges) {
|
|
116
|
+
let fastPathStart = ranges[0];
|
|
117
|
+
let fastPathEnd = ranges[1];
|
|
118
|
+
for (let index = 0; index < ranges.length; index += 2) {
|
|
119
|
+
const start = ranges[index];
|
|
120
|
+
const end = ranges[index + 1];
|
|
121
|
+
if (commonCjkCodePoint >= start && commonCjkCodePoint <= end) {
|
|
122
|
+
return [start, end];
|
|
123
|
+
}
|
|
124
|
+
if (end - start > fastPathEnd - fastPathStart) {
|
|
125
|
+
fastPathStart = start;
|
|
126
|
+
fastPathEnd = end;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
return [fastPathStart, fastPathEnd];
|
|
90
130
|
}
|
|
91
|
-
|
|
92
|
-
if (
|
|
93
|
-
|
|
94
|
-
|
|
131
|
+
const isAmbiguous = (codePoint) => {
|
|
132
|
+
if (codePoint < minimumAmbiguousCodePoint || codePoint > maximumAmbiguousCodePoint) {
|
|
133
|
+
return false;
|
|
134
|
+
}
|
|
135
|
+
return isInRange(ambiguousRanges, codePoint);
|
|
136
|
+
};
|
|
137
|
+
const isFullWidth = (codePoint) => {
|
|
138
|
+
if (codePoint < minimumFullWidthCodePoint || codePoint > maximumFullWidthCodePoint) {
|
|
139
|
+
return false;
|
|
140
|
+
}
|
|
141
|
+
return isInRange(fullwidthRanges, codePoint);
|
|
142
|
+
};
|
|
143
|
+
const isHalfWidth = (codePoint) => {
|
|
144
|
+
if (codePoint < minimumHalfWidthCodePoint || codePoint > maximumHalfWidthCodePoint) {
|
|
145
|
+
return false;
|
|
146
|
+
}
|
|
147
|
+
return isInRange(halfwidthRanges, codePoint);
|
|
148
|
+
};
|
|
149
|
+
const isNarrow = (codePoint) => {
|
|
150
|
+
if (codePoint < minimumNarrowCodePoint || codePoint > maximumNarrowCodePoint) {
|
|
151
|
+
return false;
|
|
152
|
+
}
|
|
153
|
+
return isInRange(narrowRanges, codePoint);
|
|
154
|
+
};
|
|
155
|
+
const isWide = (codePoint) => {
|
|
156
|
+
if (codePoint >= wideFastPathStart && codePoint <= wideFastPathEnd) {
|
|
157
|
+
return true;
|
|
158
|
+
}
|
|
159
|
+
if (codePoint < minimumWideCodePoint || codePoint > maximumWideCodePoint) {
|
|
160
|
+
return false;
|
|
161
|
+
}
|
|
162
|
+
return isInRange(wideRanges, codePoint);
|
|
163
|
+
};
|
|
164
|
+
function getCategory(codePoint) {
|
|
165
|
+
if (isAmbiguous(codePoint)) {
|
|
166
|
+
return "ambiguous";
|
|
167
|
+
}
|
|
168
|
+
if (isFullWidth(codePoint)) {
|
|
169
|
+
return "fullwidth";
|
|
170
|
+
}
|
|
171
|
+
if (isHalfWidth(codePoint)) {
|
|
95
172
|
return "halfwidth";
|
|
96
173
|
}
|
|
97
|
-
if (
|
|
174
|
+
if (isNarrow(codePoint)) {
|
|
98
175
|
return "narrow";
|
|
99
176
|
}
|
|
100
|
-
if (isWide(
|
|
177
|
+
if (isWide(codePoint)) {
|
|
178
|
+
return "wide";
|
|
179
|
+
}
|
|
101
180
|
return "neutral";
|
|
102
181
|
}
|
|
103
182
|
function validate(codePoint) {
|
|
@@ -1092,6 +1171,30 @@ const createIfNotDefault = (maybeColumns, maybeRows) => {
|
|
|
1092
1171
|
}
|
|
1093
1172
|
return { columns, rows };
|
|
1094
1173
|
};
|
|
1174
|
+
const isForegroundProcess = () => {
|
|
1175
|
+
if (process.platform !== "linux") {
|
|
1176
|
+
return true;
|
|
1177
|
+
}
|
|
1178
|
+
try {
|
|
1179
|
+
const statContents = fs.readFileSync("/proc/self/stat", "utf8");
|
|
1180
|
+
const closingParenthesisIndex = statContents.lastIndexOf(") ");
|
|
1181
|
+
if (closingParenthesisIndex === -1) {
|
|
1182
|
+
return false;
|
|
1183
|
+
}
|
|
1184
|
+
const statFields = statContents.slice(closingParenthesisIndex + 2).trim().split(/\s+/);
|
|
1185
|
+
const processGroupId = Number.parseInt(statFields[2], 10);
|
|
1186
|
+
const foregroundProcessGroupId = Number.parseInt(statFields[5], 10);
|
|
1187
|
+
if (Number.isNaN(processGroupId) || Number.isNaN(foregroundProcessGroupId)) {
|
|
1188
|
+
return false;
|
|
1189
|
+
}
|
|
1190
|
+
if (foregroundProcessGroupId <= 0) {
|
|
1191
|
+
return false;
|
|
1192
|
+
}
|
|
1193
|
+
return processGroupId === foregroundProcessGroupId;
|
|
1194
|
+
} catch {
|
|
1195
|
+
return false;
|
|
1196
|
+
}
|
|
1197
|
+
};
|
|
1095
1198
|
function terminalSize() {
|
|
1096
1199
|
const { env, stdout, stderr } = process;
|
|
1097
1200
|
if (stdout?.columns && stdout?.rows) {
|
|
@@ -1135,6 +1238,9 @@ const tput = () => {
|
|
|
1135
1238
|
};
|
|
1136
1239
|
const resize = () => {
|
|
1137
1240
|
try {
|
|
1241
|
+
if (!isForegroundProcess()) {
|
|
1242
|
+
return;
|
|
1243
|
+
}
|
|
1138
1244
|
const size = exec("resize", ["-u"]).match(/\d+/g);
|
|
1139
1245
|
if (size.length === 2) {
|
|
1140
1246
|
return createIfNotDefault(size[0], size[1]);
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
const GLOB_STRIP_RE = /\*+/g;
|
|
2
|
+
const pailMiddleware = (NextResponseClass, options) => {
|
|
3
|
+
const { exclude, include } = options ?? {};
|
|
4
|
+
return (request) => {
|
|
5
|
+
const path = request.nextUrl.pathname;
|
|
6
|
+
if (exclude?.some((p) => path.startsWith(p.replaceAll(GLOB_STRIP_RE, "")))) {
|
|
7
|
+
return NextResponseClass.next();
|
|
8
|
+
}
|
|
9
|
+
if (include?.length && !include.some((p) => path.startsWith(p.replaceAll(GLOB_STRIP_RE, "")))) {
|
|
10
|
+
return NextResponseClass.next();
|
|
11
|
+
}
|
|
12
|
+
const requestId = request.headers.get("x-request-id") ?? crypto.randomUUID();
|
|
13
|
+
const requestHeaders = new Headers(request.headers);
|
|
14
|
+
requestHeaders.set("x-request-id", requestId);
|
|
15
|
+
requestHeaders.set("x-pail-start", String(Date.now()));
|
|
16
|
+
const response = NextResponseClass.next({
|
|
17
|
+
request: { headers: requestHeaders }
|
|
18
|
+
});
|
|
19
|
+
response.headers.set("x-request-id", requestId);
|
|
20
|
+
return response;
|
|
21
|
+
};
|
|
22
|
+
};
|
|
23
|
+
|
|
24
|
+
export { pailMiddleware };
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { createRequire as __cjs_createRequire } from "node:module";
|
|
2
|
+
|
|
3
|
+
const __cjs_require = __cjs_createRequire(import.meta.url);
|
|
4
|
+
|
|
5
|
+
const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
|
|
6
|
+
|
|
7
|
+
const __cjs_getBuiltinModule = (module) => {
|
|
8
|
+
// Check if we're in Node.js and version supports getBuiltinModule
|
|
9
|
+
if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
|
|
10
|
+
const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
|
|
11
|
+
// Node.js 20.16.0+ and 22.3.0+
|
|
12
|
+
if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
|
|
13
|
+
return __cjs_getProcess.getBuiltinModule(module);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
// Fallback to createRequire
|
|
17
|
+
return __cjs_require(module);
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
const {
|
|
21
|
+
AsyncLocalStorage
|
|
22
|
+
} = __cjs_getBuiltinModule("node:async_hooks");
|
|
23
|
+
|
|
24
|
+
const createLoggerStorage = (contextHint) => {
|
|
25
|
+
const storage = new AsyncLocalStorage();
|
|
26
|
+
const useLogger = () => {
|
|
27
|
+
const logger = storage.getStore();
|
|
28
|
+
if (!logger) {
|
|
29
|
+
throw new Error(`[pail] useLogger() called outside of ${contextHint}`);
|
|
30
|
+
}
|
|
31
|
+
return logger;
|
|
32
|
+
};
|
|
33
|
+
return { storage, useLogger };
|
|
34
|
+
};
|
|
35
|
+
|
|
36
|
+
export { createLoggerStorage as c };
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { createRequire as __cjs_createRequire } from "node:module";
|
|
2
|
+
|
|
3
|
+
const __cjs_require = __cjs_createRequire(import.meta.url);
|
|
4
|
+
|
|
5
|
+
const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
|
|
6
|
+
|
|
7
|
+
const __cjs_getBuiltinModule = (module) => {
|
|
8
|
+
// Check if we're in Node.js and version supports getBuiltinModule
|
|
9
|
+
if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
|
|
10
|
+
const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
|
|
11
|
+
// Node.js 20.16.0+ and 22.3.0+
|
|
12
|
+
if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
|
|
13
|
+
return __cjs_getProcess.getBuiltinModule(module);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
// Fallback to createRequire
|
|
17
|
+
return __cjs_require(module);
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
const {
|
|
21
|
+
AsyncLocalStorage
|
|
22
|
+
} = __cjs_getBuiltinModule("node:async_hooks");
|
|
23
|
+
|
|
24
|
+
const pailStorage = new AsyncLocalStorage();
|
|
25
|
+
const useLogger = () => {
|
|
26
|
+
const logger = pailStorage.getStore();
|
|
27
|
+
if (!logger) {
|
|
28
|
+
throw new Error("[pail] useLogger() called outside of withPail() context. Wrap your route handler or server action with withPail().");
|
|
29
|
+
}
|
|
30
|
+
return logger;
|
|
31
|
+
};
|
|
32
|
+
|
|
33
|
+
export { pailStorage, useLogger };
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import type { Meta, Processor } from "../types.d.ts";
|
|
2
|
+
/**
|
|
3
|
+
* Detected environment information.
|
|
4
|
+
*
|
|
5
|
+
* Contains runtime environment details that are automatically detected
|
|
6
|
+
* from environment variables and process information.
|
|
7
|
+
*/
|
|
8
|
+
interface EnvironmentInfo {
|
|
9
|
+
/** Git commit hash or short SHA */
|
|
10
|
+
commit?: string;
|
|
11
|
+
/** Runtime environment (e.g., "production", "development", "test") */
|
|
12
|
+
environment?: string;
|
|
13
|
+
/** Hostname of the machine */
|
|
14
|
+
hostname?: string;
|
|
15
|
+
/** Process ID */
|
|
16
|
+
pid?: number;
|
|
17
|
+
/** Cloud region (e.g., "us-east-1") */
|
|
18
|
+
region?: string;
|
|
19
|
+
/** Application/service name */
|
|
20
|
+
service?: string;
|
|
21
|
+
/** Application version */
|
|
22
|
+
version?: string;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Environment processor configuration options.
|
|
26
|
+
*/
|
|
27
|
+
interface EnvironmentProcessorOptions {
|
|
28
|
+
/**
|
|
29
|
+
* Whether to include the hostname. Defaults to false.
|
|
30
|
+
*/
|
|
31
|
+
includeHostname?: boolean;
|
|
32
|
+
/**
|
|
33
|
+
* Whether to include the process ID. Defaults to false.
|
|
34
|
+
*/
|
|
35
|
+
includePid?: boolean;
|
|
36
|
+
/**
|
|
37
|
+
* Static environment info to use instead of or in addition to auto-detection.
|
|
38
|
+
* Values provided here take precedence over auto-detected values.
|
|
39
|
+
*/
|
|
40
|
+
overrides?: Partial<EnvironmentInfo>;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Detects the runtime environment from environment variables.
|
|
44
|
+
*
|
|
45
|
+
* Checks common environment variable patterns used by various hosting
|
|
46
|
+
* platforms (Vercel, AWS, GCP, Heroku, Railway, Fly.io, Render, etc.)
|
|
47
|
+
* to automatically determine service name, version, environment, region,
|
|
48
|
+
* and commit hash.
|
|
49
|
+
* @returns Detected environment information
|
|
50
|
+
*/
|
|
51
|
+
declare const detectEnvironment: () => EnvironmentInfo;
|
|
52
|
+
/**
|
|
53
|
+
* Environment Enrichment Processor.
|
|
54
|
+
*
|
|
55
|
+
* Inspired by evlog's automatic environment detection, this processor
|
|
56
|
+
* enriches log metadata with runtime environment information. It auto-detects
|
|
57
|
+
* details like service name, version, environment, region, and commit hash
|
|
58
|
+
* from common environment variables used by popular hosting platforms.
|
|
59
|
+
*
|
|
60
|
+
* The detected info is added to the log's context, making it easier to
|
|
61
|
+
* correlate logs across services and deployments in production.
|
|
62
|
+
* @template L - The log level type
|
|
63
|
+
* @example
|
|
64
|
+
* ```typescript
|
|
65
|
+
* import { createPail } from "@visulima/pail";
|
|
66
|
+
* import EnvironmentProcessor from "@visulima/pail/processor/environment";
|
|
67
|
+
*
|
|
68
|
+
* const logger = createPail({
|
|
69
|
+
* processors: [
|
|
70
|
+
* new EnvironmentProcessor({
|
|
71
|
+
* overrides: { service: "my-api" },
|
|
72
|
+
* includePid: true,
|
|
73
|
+
* }),
|
|
74
|
+
* ],
|
|
75
|
+
* });
|
|
76
|
+
*
|
|
77
|
+
* logger.info("Server started");
|
|
78
|
+
* // Log metadata will include: { __env: { service: "my-api", environment: "production", ... } }
|
|
79
|
+
* ```
|
|
80
|
+
* @example
|
|
81
|
+
* ```typescript
|
|
82
|
+
* // With static configuration only (no auto-detection)
|
|
83
|
+
* new EnvironmentProcessor({
|
|
84
|
+
* overrides: {
|
|
85
|
+
* service: "payment-service",
|
|
86
|
+
* version: "2.1.0",
|
|
87
|
+
* environment: "staging",
|
|
88
|
+
* },
|
|
89
|
+
* });
|
|
90
|
+
* ```
|
|
91
|
+
*/
|
|
92
|
+
declare class EnvironmentProcessor<L extends string = string> implements Processor<L> {
|
|
93
|
+
#private;
|
|
94
|
+
/**
|
|
95
|
+
* Creates a new EnvironmentProcessor instance.
|
|
96
|
+
*
|
|
97
|
+
* Auto-detects environment information on construction and merges
|
|
98
|
+
* with any provided overrides. Undefined values in overrides are
|
|
99
|
+
* filtered out so they don't overwrite detected values.
|
|
100
|
+
* @param options Processor configuration options
|
|
101
|
+
*/
|
|
102
|
+
constructor(options?: EnvironmentProcessorOptions);
|
|
103
|
+
/**
|
|
104
|
+
* Processes log metadata to add environment information.
|
|
105
|
+
*
|
|
106
|
+
* Adds a `__env` property to the meta containing detected and
|
|
107
|
+
* configured environment details. Each call receives a shallow
|
|
108
|
+
* clone of the environment info to prevent cross-record mutation.
|
|
109
|
+
* @param meta The log metadata to process
|
|
110
|
+
* @returns The processed metadata with environment info added
|
|
111
|
+
*/
|
|
112
|
+
process(meta: Meta<L>): Meta<L>;
|
|
113
|
+
/**
|
|
114
|
+
* Returns the detected environment information.
|
|
115
|
+
*
|
|
116
|
+
* Useful for inspecting what environment details were auto-detected.
|
|
117
|
+
* Returns a shallow clone to prevent external mutation.
|
|
118
|
+
* @returns The environment information object
|
|
119
|
+
*/
|
|
120
|
+
getEnvironmentInfo(): Readonly<EnvironmentInfo>;
|
|
121
|
+
}
|
|
122
|
+
export { detectEnvironment };
|
|
123
|
+
export default EnvironmentProcessor;
|
|
124
|
+
export type { EnvironmentInfo, EnvironmentProcessorOptions };
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
const detectEnvironment = () => {
|
|
2
|
+
if (!process.env) {
|
|
3
|
+
return {};
|
|
4
|
+
}
|
|
5
|
+
const { env } = process;
|
|
6
|
+
const info = {
|
|
7
|
+
// Commit hash
|
|
8
|
+
commit: env.COMMIT_SHA || env.GIT_COMMIT || env.VERCEL_GIT_COMMIT_SHA?.slice(0, 7) || env.RAILWAY_GIT_COMMIT_SHA?.slice(0, 7) || env.RENDER_GIT_COMMIT?.slice(0, 7) || env.HEROKU_SLUG_COMMIT?.slice(0, 7) || env.CF_PAGES_COMMIT_SHA?.slice(0, 7) || void 0,
|
|
9
|
+
// Environment / Node env
|
|
10
|
+
environment: env.NODE_ENV || env.ENVIRONMENT || env.APP_ENV || void 0,
|
|
11
|
+
// Hostname
|
|
12
|
+
hostname: env.HOSTNAME || env.HOST || void 0,
|
|
13
|
+
// PID
|
|
14
|
+
pid: process.pid,
|
|
15
|
+
// Region (including GCP Cloud Functions FUNCTION_REGION and GOOGLE_CLOUD_REGION)
|
|
16
|
+
region: env.AWS_REGION || env.VERCEL_REGION || env.FLY_REGION || env.RENDER_REGION || env.CF_REGION || env.GOOGLE_CLOUD_REGION || env.FUNCTION_REGION || void 0,
|
|
17
|
+
// Service name - check common platform variables (including GCP Cloud Run / App Engine)
|
|
18
|
+
service: env.SERVICE_NAME || env.APP_NAME || env.K_SERVICE || env.GAE_SERVICE || env.FUNCTION_TARGET || env.VERCEL_PROJECT_PRODUCTION_URL || env.FLY_APP_NAME || env.RAILWAY_SERVICE_NAME || env.RENDER_SERVICE_NAME || env.HEROKU_APP_NAME || void 0,
|
|
19
|
+
// Version (including GCP Cloud Run K_REVISION and App Engine GAE_VERSION)
|
|
20
|
+
version: env.APP_VERSION || env.npm_package_version || env.K_REVISION || env.GAE_VERSION || env.RAILWAY_GIT_COMMIT_SHA?.slice(0, 7) || env.RENDER_GIT_COMMIT?.slice(0, 7) || void 0
|
|
21
|
+
};
|
|
22
|
+
return Object.fromEntries(Object.entries(info).filter(([, v]) => v !== void 0));
|
|
23
|
+
};
|
|
24
|
+
class EnvironmentProcessor {
|
|
25
|
+
#envInfo;
|
|
26
|
+
/**
|
|
27
|
+
* Creates a new EnvironmentProcessor instance.
|
|
28
|
+
*
|
|
29
|
+
* Auto-detects environment information on construction and merges
|
|
30
|
+
* with any provided overrides. Undefined values in overrides are
|
|
31
|
+
* filtered out so they don't overwrite detected values.
|
|
32
|
+
* @param options Processor configuration options
|
|
33
|
+
*/
|
|
34
|
+
constructor(options = {}) {
|
|
35
|
+
const detected = detectEnvironment();
|
|
36
|
+
const cleanOverrides = {};
|
|
37
|
+
if (options.overrides) {
|
|
38
|
+
for (const [key, value] of Object.entries(options.overrides)) {
|
|
39
|
+
if (value !== void 0) {
|
|
40
|
+
cleanOverrides[key] = value;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
const merged = { ...detected, ...cleanOverrides };
|
|
45
|
+
if (!options.includePid && cleanOverrides.pid === void 0) {
|
|
46
|
+
delete merged.pid;
|
|
47
|
+
}
|
|
48
|
+
if (!options.includeHostname && cleanOverrides.hostname === void 0) {
|
|
49
|
+
delete merged.hostname;
|
|
50
|
+
}
|
|
51
|
+
this.#envInfo = merged;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Processes log metadata to add environment information.
|
|
55
|
+
*
|
|
56
|
+
* Adds a `__env` property to the meta containing detected and
|
|
57
|
+
* configured environment details. Each call receives a shallow
|
|
58
|
+
* clone of the environment info to prevent cross-record mutation.
|
|
59
|
+
* @param meta The log metadata to process
|
|
60
|
+
* @returns The processed metadata with environment info added
|
|
61
|
+
*/
|
|
62
|
+
process(meta) {
|
|
63
|
+
const enriched = { ...meta, envStorage: { ...this.#envInfo } };
|
|
64
|
+
return enriched;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Returns the detected environment information.
|
|
68
|
+
*
|
|
69
|
+
* Useful for inspecting what environment details were auto-detected.
|
|
70
|
+
* Returns a shallow clone to prevent external mutation.
|
|
71
|
+
* @returns The environment information object
|
|
72
|
+
*/
|
|
73
|
+
getEnvironmentInfo() {
|
|
74
|
+
return { ...this.#envInfo };
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
export { EnvironmentProcessor as default, detectEnvironment };
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import type { FormatterFunction } from "@visulima/fmt";
|
|
2
|
-
import type { stringify } from "safe-stable-stringify";
|
|
3
2
|
import type { Meta, StringifyAwareProcessor } from "../types.d.ts";
|
|
4
3
|
/**
|
|
5
4
|
* Message Formatter Processor.
|
|
@@ -39,7 +38,7 @@ declare class MessageFormatterProcessor<L extends string = string> implements St
|
|
|
39
38
|
* Sets the stringify function for object serialization.
|
|
40
39
|
* @param function_ The stringify function to use for serializing objects
|
|
41
40
|
*/
|
|
42
|
-
setStringify(function_: typeof stringify): void;
|
|
41
|
+
setStringify(function_: typeof JSON.stringify): void;
|
|
43
42
|
/**
|
|
44
43
|
* Processes log metadata to format messages.
|
|
45
44
|
*
|