@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.
Files changed (58) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/LICENSE.md +6 -6
  3. package/README.md +323 -0
  4. package/dist/error.d.ts +104 -0
  5. package/dist/error.js +76 -0
  6. package/dist/index.browser.d.ts +2 -0
  7. package/dist/index.browser.js +2 -1
  8. package/dist/index.server.d.ts +2 -0
  9. package/dist/index.server.js +6 -4
  10. package/dist/interactive/index.js +1 -1
  11. package/dist/middleware/elysia.d.ts +71 -0
  12. package/dist/middleware/elysia.js +70 -0
  13. package/dist/middleware/express.d.ts +86 -0
  14. package/dist/middleware/express.js +29 -0
  15. package/dist/middleware/fastify.d.ts +81 -0
  16. package/dist/middleware/fastify.js +46 -0
  17. package/dist/middleware/hono.d.ts +85 -0
  18. package/dist/middleware/hono.js +33 -0
  19. package/dist/middleware/next/handler.d.ts +36 -0
  20. package/dist/middleware/next/handler.js +53 -0
  21. package/dist/middleware/next/middleware.d.ts +59 -0
  22. package/dist/middleware/next/storage.d.ts +14 -0
  23. package/dist/middleware/shared/create-middleware-logger.d.ts +82 -0
  24. package/dist/middleware/shared/headers.d.ts +14 -0
  25. package/dist/middleware/shared/routes.d.ts +30 -0
  26. package/dist/middleware/shared/storage.d.ts +29 -0
  27. package/dist/middleware/sveltekit.d.ts +123 -0
  28. package/dist/middleware/sveltekit.js +43 -0
  29. package/dist/packem_shared/{AbstractJsonReporter-DWRpTtGw.js → AbstractJsonReporter-CGKHS8_M.js} +103 -21
  30. package/dist/packem_shared/{AbstractJsonReporter-BaZ33PlE.js → AbstractJsonReporter-DDjDkciI.js} +103 -21
  31. package/dist/packem_shared/{InteractiveManager-CbE7d1kY.js → InteractiveManager-Cd6A14ZK.js} +1 -1
  32. package/dist/packem_shared/{JsonReporter-BV5lMnJX.js → JsonReporter-B3XX8GHN.js} +1 -1
  33. package/dist/packem_shared/{JsonReporter-BRw4skd5.js → JsonReporter-p_BXg6Sj.js} +1 -1
  34. package/dist/packem_shared/{PrettyReporter-DLQtmATi.js → PrettyReporter-CvBn-hxP.js} +5 -4
  35. package/dist/packem_shared/{Spinner-B9JUdsbY.js → Spinner-DIdVcfWq.js} +34 -1
  36. package/dist/packem_shared/{abstract-pretty-reporter-DckLMlGF.js → abstract-pretty-reporter-jU8WL_6c.js} +121 -15
  37. package/dist/packem_shared/createPailError-B11aRfrT.js +76 -0
  38. package/dist/packem_shared/headers-Cp4uLtr4.js +123 -0
  39. package/dist/packem_shared/{index-EZ_WSQZS.js → index-frijFf5m.js} +120 -14
  40. package/dist/packem_shared/pailMiddleware-Ci88geIF.js +24 -0
  41. package/dist/packem_shared/storage-D0vqz8OX.js +36 -0
  42. package/dist/packem_shared/useLogger-D0rU3lcX.js +33 -0
  43. package/dist/processor/environment-processor.d.ts +124 -0
  44. package/dist/processor/environment-processor.js +78 -0
  45. package/dist/processor/message-formatter-processor.d.ts +1 -2
  46. package/dist/processor/sampling-processor.d.ts +111 -0
  47. package/dist/processor/sampling-processor.js +59 -0
  48. package/dist/reporter/file/json-file-reporter.js +1 -1
  49. package/dist/reporter/http/abstract-http-reporter.js +1 -1
  50. package/dist/reporter/http/http-reporter.edge-light.js +103 -21
  51. package/dist/reporter/json/index.browser.js +2 -2
  52. package/dist/reporter/json/index.js +2 -2
  53. package/dist/reporter/pretty/index.js +1 -1
  54. package/dist/reporter/simple/simple-reporter.server.js +4 -3
  55. package/dist/spinner.js +34 -1
  56. package/dist/wide-event.d.ts +300 -0
  57. package/dist/wide-event.js +281 -0
  58. 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
- function isAmbiguous(x) {
83
- return x === 161 || x === 164 || x === 167 || x === 168 || x === 170 || x === 173 || x === 174 || x >= 176 && x <= 180 || x >= 182 && x <= 186 || x >= 188 && x <= 191 || x === 198 || x === 208 || x === 215 || x === 216 || x >= 222 && x <= 225 || x === 230 || x >= 232 && x <= 234 || x === 236 || x === 237 || x === 240 || x === 242 || x === 243 || x >= 247 && x <= 250 || x === 252 || x === 254 || x === 257 || x === 273 || x === 275 || x === 283 || x === 294 || x === 295 || x === 299 || x >= 305 && x <= 307 || x === 312 || x >= 319 && x <= 322 || x === 324 || x >= 328 && x <= 331 || x === 333 || x === 338 || x === 339 || x === 358 || x === 359 || x === 363 || x === 462 || x === 464 || x === 466 || x === 468 || x === 470 || x === 472 || x === 474 || x === 476 || x === 593 || x === 609 || x === 708 || x === 711 || x >= 713 && x <= 715 || x === 717 || x === 720 || x >= 728 && x <= 731 || x === 733 || x === 735 || x >= 768 && x <= 879 || x >= 913 && x <= 929 || x >= 931 && x <= 937 || x >= 945 && x <= 961 || x >= 963 && x <= 969 || x === 1025 || x >= 1040 && x <= 1103 || x === 1105 || x === 8208 || x >= 8211 && x <= 8214 || x === 8216 || x === 8217 || x === 8220 || x === 8221 || x >= 8224 && x <= 8226 || x >= 8228 && x <= 8231 || x === 8240 || x === 8242 || x === 8243 || x === 8245 || x === 8251 || x === 8254 || x === 8308 || x === 8319 || x >= 8321 && x <= 8324 || x === 8364 || x === 8451 || x === 8453 || x === 8457 || x === 8467 || x === 8470 || x === 8481 || x === 8482 || x === 8486 || x === 8491 || x === 8531 || x === 8532 || x >= 8539 && x <= 8542 || x >= 8544 && x <= 8555 || x >= 8560 && x <= 8569 || x === 8585 || x >= 8592 && x <= 8601 || x === 8632 || x === 8633 || x === 8658 || x === 8660 || x === 8679 || x === 8704 || x === 8706 || x === 8707 || x === 8711 || x === 8712 || x === 8715 || x === 8719 || x === 8721 || x === 8725 || x === 8730 || x >= 8733 && x <= 8736 || x === 8739 || x === 8741 || x >= 8743 && x <= 8748 || x === 8750 || x >= 8756 && x <= 8759 || x === 8764 || x === 8765 || x === 8776 || x === 8780 || x === 8786 || x === 8800 || x === 8801 || x >= 8804 && x <= 8807 || x === 8810 || x === 8811 || x === 8814 || x === 8815 || x === 8834 || x === 8835 || x === 8838 || x === 8839 || x === 8853 || x === 8857 || x === 8869 || x === 8895 || x === 8978 || x >= 9312 && x <= 9449 || x >= 9451 && x <= 9547 || x >= 9552 && x <= 9587 || x >= 9600 && x <= 9615 || x >= 9618 && x <= 9621 || x === 9632 || x === 9633 || x >= 9635 && x <= 9641 || x === 9650 || x === 9651 || x === 9654 || x === 9655 || x === 9660 || x === 9661 || x === 9664 || x === 9665 || x >= 9670 && x <= 9672 || x === 9675 || x >= 9678 && x <= 9681 || x >= 9698 && x <= 9701 || x === 9711 || x === 9733 || x === 9734 || x === 9737 || x === 9742 || x === 9743 || x === 9756 || x === 9758 || x === 9792 || x === 9794 || x === 9824 || x === 9825 || x >= 9827 && x <= 9829 || x >= 9831 && x <= 9834 || x === 9836 || x === 9837 || x === 9839 || x === 9886 || x === 9887 || x === 9919 || x >= 9926 && x <= 9933 || x >= 9935 && x <= 9939 || x >= 9941 && x <= 9953 || x === 9955 || x === 9960 || x === 9961 || x >= 9963 && x <= 9969 || x === 9972 || x >= 9974 && x <= 9977 || x === 9979 || x === 9980 || x === 9982 || x === 9983 || x === 10045 || x >= 10102 && x <= 10111 || x >= 11094 && x <= 11097 || x >= 12872 && x <= 12879 || x >= 57344 && x <= 63743 || x >= 65024 && x <= 65039 || x === 65533 || x >= 127232 && x <= 127242 || x >= 127248 && x <= 127277 || x >= 127280 && x <= 127337 || x >= 127344 && x <= 127373 || x === 127375 || x === 127376 || x >= 127387 && x <= 127404 || x >= 917760 && x <= 917999 || x >= 983040 && x <= 1048573 || x >= 1048576 && x <= 1114109;
84
- }
85
- function isFullWidth(x) {
86
- return x === 12288 || x >= 65281 && x <= 65376 || x >= 65504 && x <= 65510;
87
- }
88
- function isWide(x) {
89
- return x >= 4352 && x <= 4447 || x === 8986 || x === 8987 || x === 9001 || x === 9002 || x >= 9193 && x <= 9196 || x === 9200 || x === 9203 || x === 9725 || x === 9726 || x === 9748 || x === 9749 || x >= 9776 && x <= 9783 || x >= 9800 && x <= 9811 || x === 9855 || x >= 9866 && x <= 9871 || x === 9875 || x === 9889 || x === 9898 || x === 9899 || x === 9917 || x === 9918 || x === 9924 || x === 9925 || x === 9934 || x === 9940 || x === 9962 || x === 9970 || x === 9971 || x === 9973 || x === 9978 || x === 9981 || x === 9989 || x === 9994 || x === 9995 || x === 10024 || x === 10060 || x === 10062 || x >= 10067 && x <= 10069 || x === 10071 || x >= 10133 && x <= 10135 || x === 10160 || x === 10175 || x === 11035 || x === 11036 || x === 11088 || x === 11093 || x >= 11904 && x <= 11929 || x >= 11931 && x <= 12019 || x >= 12032 && x <= 12245 || x >= 12272 && x <= 12287 || x >= 12289 && x <= 12350 || x >= 12353 && x <= 12438 || x >= 12441 && x <= 12543 || x >= 12549 && x <= 12591 || x >= 12593 && x <= 12686 || x >= 12688 && x <= 12773 || x >= 12783 && x <= 12830 || x >= 12832 && x <= 12871 || x >= 12880 && x <= 42124 || x >= 42128 && x <= 42182 || x >= 43360 && x <= 43388 || x >= 44032 && x <= 55203 || x >= 63744 && x <= 64255 || x >= 65040 && x <= 65049 || x >= 65072 && x <= 65106 || x >= 65108 && x <= 65126 || x >= 65128 && x <= 65131 || x >= 94176 && x <= 94180 || x >= 94192 && x <= 94198 || x >= 94208 && x <= 101589 || x >= 101631 && x <= 101662 || x >= 101760 && x <= 101874 || x >= 110576 && x <= 110579 || x >= 110581 && x <= 110587 || x === 110589 || x === 110590 || x >= 110592 && x <= 110882 || x === 110898 || x >= 110928 && x <= 110930 || x === 110933 || x >= 110948 && x <= 110951 || x >= 110960 && x <= 111355 || x >= 119552 && x <= 119638 || x >= 119648 && x <= 119670 || x === 126980 || x === 127183 || x === 127374 || x >= 127377 && x <= 127386 || x >= 127488 && x <= 127490 || x >= 127504 && x <= 127547 || x >= 127552 && x <= 127560 || x === 127568 || x === 127569 || x >= 127584 && x <= 127589 || x >= 127744 && x <= 127776 || x >= 127789 && x <= 127797 || x >= 127799 && x <= 127868 || x >= 127870 && x <= 127891 || x >= 127904 && x <= 127946 || x >= 127951 && x <= 127955 || x >= 127968 && x <= 127984 || x === 127988 || x >= 127992 && x <= 128062 || x === 128064 || x >= 128066 && x <= 128252 || x >= 128255 && x <= 128317 || x >= 128331 && x <= 128334 || x >= 128336 && x <= 128359 || x === 128378 || x === 128405 || x === 128406 || x === 128420 || x >= 128507 && x <= 128591 || x >= 128640 && x <= 128709 || x === 128716 || x >= 128720 && x <= 128722 || x >= 128725 && x <= 128728 || x >= 128732 && x <= 128735 || x === 128747 || x === 128748 || x >= 128756 && x <= 128764 || x >= 128992 && x <= 129003 || x === 129008 || x >= 129292 && x <= 129338 || x >= 129340 && x <= 129349 || x >= 129351 && x <= 129535 || x >= 129648 && x <= 129660 || x >= 129664 && x <= 129674 || x >= 129678 && x <= 129734 || x === 129736 || x >= 129741 && x <= 129756 || x >= 129759 && x <= 129770 || x >= 129775 && x <= 129784 || x >= 131072 && x <= 196605 || x >= 196608 && x <= 262141;
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
- function getCategory(x) {
92
- if (isAmbiguous(x)) return "ambiguous";
93
- if (isFullWidth(x)) return "fullwidth";
94
- if (x === 8361 || x >= 65377 && x <= 65470 || x >= 65474 && x <= 65479 || x >= 65482 && x <= 65487 || x >= 65490 && x <= 65495 || x >= 65498 && x <= 65500 || x >= 65512 && x <= 65518) {
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 (x >= 32 && x <= 126 || x === 162 || x === 163 || x === 165 || x === 166 || x === 172 || x === 175 || x >= 10214 && x <= 10221 || x === 10629 || x === 10630) {
174
+ if (isNarrow(codePoint)) {
98
175
  return "narrow";
99
176
  }
100
- if (isWide(x)) return "wide";
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
  *