@visulima/pail 4.0.0-alpha.9 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/CHANGELOG.md +511 -0
  2. package/LICENSE.md +270 -166
  3. package/README.md +53 -24
  4. package/dist/error.d.ts +95 -96
  5. package/dist/error.js +5 -76
  6. package/dist/index.browser.d.ts +568 -47
  7. package/dist/index.browser.js +19 -1499
  8. package/dist/index.server.d.ts +749 -65
  9. package/dist/index.server.js +32 -3179
  10. package/dist/middleware/elysia.d.ts +66 -63
  11. package/dist/middleware/elysia.js +1 -70
  12. package/dist/middleware/express.d.ts +74 -71
  13. package/dist/middleware/express.js +1 -29
  14. package/dist/middleware/fastify.d.ts +70 -67
  15. package/dist/middleware/fastify.js +1 -46
  16. package/dist/middleware/hono.d.ts +75 -72
  17. package/dist/middleware/hono.js +1 -33
  18. package/dist/middleware/next/handler.d.ts +102 -34
  19. package/dist/middleware/next/handler.js +1 -53
  20. package/dist/middleware/sveltekit.d.ts +101 -98
  21. package/dist/middleware/sveltekit.js +1 -43
  22. package/dist/object-tree.d.ts +67 -70
  23. package/dist/object-tree.js +2 -89
  24. package/dist/packem_shared/AbstractJsonReporter-Bp_JCrMQ.js +1 -0
  25. package/dist/packem_shared/AbstractJsonReporter-w_bGGiD-.js +1 -0
  26. package/dist/packem_shared/JsonReporter-Sd_lJGS-.js +2 -0
  27. package/dist/packem_shared/JsonReporter-bmem9lcg.js +1 -0
  28. package/dist/packem_shared/PailError-CbU1Ogfa.js +5 -0
  29. package/dist/packem_shared/PrettyReporter-CcDdPQSt.js +44 -0
  30. package/dist/packem_shared/PrettyReporter-DsHfKOU7.js +5 -0
  31. package/dist/packem_shared/abstract-json-reporter.d-wfESoEa-.d.ts +62 -0
  32. package/dist/packem_shared/abstract-pretty-reporter-DrLBJ6ds.js +57 -0
  33. package/dist/packem_shared/addKnownErrorConstructor-C1OJTj2D-0FlJMfXz.js +25 -0
  34. package/dist/packem_shared/constants-DKfCaSUR.js +1 -0
  35. package/dist/packem_shared/constants-ep2nsfdy.js +1 -0
  36. package/dist/packem_shared/create-middleware-logger.d-B-JmQ1Sl.d.ts +47 -0
  37. package/dist/packem_shared/headers-DH0H2s8W.js +1 -0
  38. package/dist/packem_shared/index-Q1764hvO.js +1 -0
  39. package/dist/packem_shared/index.d-T71KjNAr.d.ts +16 -0
  40. package/dist/packem_shared/pailMiddleware-B5DJoBYl.js +1 -0
  41. package/dist/packem_shared/serializeError-C-NFvZ8_-D0CA_Qlx.js +1 -0
  42. package/dist/packem_shared/storage-DaXAlpiO.js +1 -0
  43. package/dist/packem_shared/types.d-Cz9S7jZh.d.ts +201 -0
  44. package/dist/packem_shared/types.d-bWnqHJKL.d.ts +211 -0
  45. package/dist/packem_shared/types.d-xxE3FOD3.d.ts +229 -0
  46. package/dist/packem_shared/useLogger-DB34CuU5.js +1 -0
  47. package/dist/packem_shared/wide-event.d-D3ATYpoK.d.ts +717 -0
  48. package/dist/packem_shared/write-console-log-based-on-level-BqjxV016.js +1 -0
  49. package/dist/packem_shared/write-stream-C7jxLxIT.js +1 -0
  50. package/dist/processor/caller/caller-processor.d.ts +50 -47
  51. package/dist/processor/caller/caller-processor.js +1 -59
  52. package/dist/processor/environment-processor.d.ts +114 -113
  53. package/dist/processor/environment-processor.js +1 -78
  54. package/dist/processor/message-formatter-processor.d.ts +59 -49
  55. package/dist/processor/message-formatter-processor.js +1 -713
  56. package/dist/processor/opentelemetry-processor.d.ts +70 -66
  57. package/dist/processor/opentelemetry-processor.js +1 -52
  58. package/dist/processor/redact-processor.d.ts +99 -41
  59. package/dist/processor/redact-processor.js +1 -30
  60. package/dist/processor/sampling-processor.d.ts +103 -101
  61. package/dist/processor/sampling-processor.js +1 -59
  62. package/dist/reporter/file/json-file-reporter.d.ts +109 -42
  63. package/dist/reporter/file/json-file-reporter.js +2 -136
  64. package/dist/reporter/http/abstract-http-reporter.d.ts +256 -211
  65. package/dist/reporter/http/abstract-http-reporter.js +2 -435
  66. package/dist/reporter/http/http-reporter.d.ts +41 -36
  67. package/dist/reporter/http/http-reporter.edge-light.d.ts +487 -39
  68. package/dist/reporter/http/http-reporter.edge-light.js +2 -733
  69. package/dist/reporter/http/http-reporter.js +1 -13
  70. package/dist/reporter/json/index.browser.d.ts +98 -3
  71. package/dist/reporter/json/index.browser.js +1 -2
  72. package/dist/reporter/json/index.d.ts +53 -3
  73. package/dist/reporter/json/index.js +1 -2
  74. package/dist/reporter/pretty/index.browser.d.ts +105 -2
  75. package/dist/reporter/pretty/index.browser.js +1 -1
  76. package/dist/reporter/pretty/index.d.ts +270 -2
  77. package/dist/reporter/pretty/index.js +1 -1
  78. package/dist/reporter/simple/simple-reporter.server.d.ts +215 -18
  79. package/dist/reporter/simple/simple-reporter.server.js +8 -182
  80. package/dist/wide-event.d.ts +6 -300
  81. package/dist/wide-event.js +1 -281
  82. package/package.json +22 -37
  83. package/dist/constants.d.ts +0 -37
  84. package/dist/interactive/index.d.ts +0 -2
  85. package/dist/interactive/index.js +0 -2
  86. package/dist/interactive/interactive-manager.d.ts +0 -108
  87. package/dist/interactive/interactive-stream-hook.d.ts +0 -68
  88. package/dist/middleware/next/middleware.d.ts +0 -59
  89. package/dist/middleware/next/storage.d.ts +0 -14
  90. package/dist/middleware/shared/create-middleware-logger.d.ts +0 -82
  91. package/dist/middleware/shared/headers.d.ts +0 -14
  92. package/dist/middleware/shared/routes.d.ts +0 -30
  93. package/dist/middleware/shared/storage.d.ts +0 -29
  94. package/dist/packem_shared/AbstractJsonReporter-CGKHS8_M.js +0 -286
  95. package/dist/packem_shared/AbstractJsonReporter-DDjDkciI.js +0 -286
  96. package/dist/packem_shared/InteractiveManager-Cd6A14ZK.js +0 -172
  97. package/dist/packem_shared/InteractiveStreamHook-ePIURL_U.js +0 -133
  98. package/dist/packem_shared/JsonReporter-B3XX8GHN.js +0 -58
  99. package/dist/packem_shared/JsonReporter-p_BXg6Sj.js +0 -28
  100. package/dist/packem_shared/PrettyReporter-BYL3NrdA.js +0 -214
  101. package/dist/packem_shared/PrettyReporter-CvBn-hxP.js +0 -1459
  102. package/dist/packem_shared/Spinner-DIdVcfWq.js +0 -2183
  103. package/dist/packem_shared/abstract-pretty-reporter-jU8WL_6c.js +0 -2602
  104. package/dist/packem_shared/constants-B1RjD_ps.js +0 -99
  105. package/dist/packem_shared/constants-omsTHUWB.js +0 -119
  106. package/dist/packem_shared/createPailError-B11aRfrT.js +0 -76
  107. package/dist/packem_shared/getBarChar-BWj1UrH3.js +0 -404
  108. package/dist/packem_shared/headers-Cp4uLtr4.js +0 -123
  109. package/dist/packem_shared/index-DnkF86LQ.js +0 -658
  110. package/dist/packem_shared/index-frijFf5m.js +0 -1252
  111. package/dist/packem_shared/pailMiddleware-Ci88geIF.js +0 -24
  112. package/dist/packem_shared/storage-D0vqz8OX.js +0 -36
  113. package/dist/packem_shared/useLogger-D0rU3lcX.js +0 -33
  114. package/dist/packem_shared/write-console-log-based-on-level-DBmRYXpj.js +0 -14
  115. package/dist/packem_shared/write-stream-BG8fhcs3.js +0 -6
  116. package/dist/pail.browser.d.ts +0 -412
  117. package/dist/pail.server.d.ts +0 -233
  118. package/dist/processor/caller/get-caller-filename.d.ts +0 -23
  119. package/dist/progress-bar.d.ts +0 -136
  120. package/dist/progress-bar.js +0 -404
  121. package/dist/reporter/file/utils/rotating-file-stream.d.ts +0 -48
  122. package/dist/reporter/http/utils/compression.d.ts +0 -7
  123. package/dist/reporter/http/utils/log-size-error.d.ts +0 -30
  124. package/dist/reporter/http/utils/retry.d.ts +0 -27
  125. package/dist/reporter/json/abstract-json-reporter.d.ts +0 -61
  126. package/dist/reporter/json/json-reporter.browser.d.ts +0 -40
  127. package/dist/reporter/json/json-reporter.server.d.ts +0 -50
  128. package/dist/reporter/pretty/abstract-pretty-reporter.d.ts +0 -83
  129. package/dist/reporter/pretty/pretty-reporter.browser.d.ts +0 -36
  130. package/dist/reporter/pretty/pretty-reporter.server.d.ts +0 -70
  131. package/dist/reporter/raw/raw-reporter.browser.d.ts +0 -5
  132. package/dist/reporter/raw/raw-reporter.server.d.ts +0 -13
  133. package/dist/reporter/utils/default-inspector-config.d.ts +0 -3
  134. package/dist/reporter/utils/format-label.d.ts +0 -3
  135. package/dist/spinner.d.ts +0 -220
  136. package/dist/spinner.js +0 -2183
  137. package/dist/types.d.ts +0 -241
  138. package/dist/utils/ansi-escapes.d.ts +0 -4
  139. package/dist/utils/arrayify.d.ts +0 -2
  140. package/dist/utils/get-longest-badge.d.ts +0 -4
  141. package/dist/utils/get-longest-label.d.ts +0 -4
  142. package/dist/utils/merge-types.d.ts +0 -4
  143. package/dist/utils/stream/safe-stream-handler.d.ts +0 -21
  144. package/dist/utils/write-console-log-based-on-level.d.ts +0 -4
  145. package/dist/utils/write-stream.d.ts +0 -2
package/LICENSE.md CHANGED
@@ -57,136 +57,14 @@ Repository: git+https://github.com/visulima/visulima.git
57
57
  >
58
58
  >
59
59
  > # Licenses of bundled dependencies
60
+ >
60
61
  > The published @visulima/error artifact additionally contains code with the following licenses:
61
62
  > MIT
62
63
  >
63
64
  > # Bundled dependencies:
64
- > ## @visulima/path
65
- > License: MIT
66
- > By: Daniel Bannert
67
- > Repository: git+https://github.com/visulima/visulima.git
68
- >
69
- > > MIT License
70
- > >
71
- > > Copyright (c) 2026 visulima
72
- > >
73
- > > Permission is hereby granted, free of charge, to any person obtaining a copy
74
- > > of this software and associated documentation files (the "Software"), to deal
75
- > > in the Software without restriction, including without limitation the rights
76
- > > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
77
- > > copies of the Software, and to permit persons to whom the Software is
78
- > > furnished to do so, subject to the following conditions:
79
- > >
80
- > > The above copyright notice and this permission notice shall be included in all
81
- > > copies or substantial portions of the Software.
82
- > >
83
- > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
84
- > > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
85
- > > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
86
- > > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
87
- > > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
88
- > > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
89
- > > SOFTWARE.
90
- > >
91
- > > ---
92
- > >
93
- > > MIT License
94
- > >
95
- > > Copyright (c) Pooya Parsa <pooya@pi0.io> - Daniel Roe <daniel@roe.dev>
96
- > >
97
- > > Permission is hereby granted, free of charge, to any person obtaining a copy
98
- > > of this software and associated documentation files (the "Software"), to deal
99
- > > in the Software without restriction, including without limitation the rights
100
- > > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
101
- > > copies of the Software, and to permit persons to whom the Software is
102
- > > furnished to do so, subject to the following conditions:
103
- > >
104
- > > The above copyright notice and this permission notice shall be included in all
105
- > > copies or substantial portions of the Software.
106
- > >
107
- > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
108
- > > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
109
- > > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
110
- > > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
111
- > > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
112
- > > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
113
- > > SOFTWARE.
114
- > >
115
- > > ---
116
- > >
117
- > > Copyright Joyent, Inc. and other Node contributors.
118
- > >
119
- > > Permission is hereby granted, free of charge, to any person obtaining a
120
- > > copy of this software and associated documentation files (the
121
- > > "Software"), to deal in the Software without restriction, including
122
- > > without limitation the rights to use, copy, modify, merge, publish,
123
- > > distribute, sublicense, and/or sell copies of the Software, and to permit
124
- > > persons to whom the Software is furnished to do so, subject to the
125
- > > following conditions:
126
- > >
127
- > > The above copyright notice and this permission notice shall be included
128
- > > in all copies or substantial portions of the Software.
129
- > >
130
- > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
131
- > > OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
132
- > > MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
133
- > > NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
134
- > > DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
135
- > > OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
136
- > > USE OR OTHER DEALINGS IN THE SOFTWARE.
137
- > >
138
- > > ---
139
- > >
140
- > > Bundled zeptomatch (https://github.com/fabiospampinato/zeptomatch)
141
- > >
142
- > > The MIT License (MIT)
143
- > >
144
- > > Copyright (c) 2023-present Fabio Spampinato
145
- > >
146
- > > Permission is hereby granted, free of charge, to any person obtaining a
147
- > > copy of this software and associated documentation files (the "Software"),
148
- > > to deal in the Software without restriction, including without limitation
149
- > > the rights to use, copy, modify, merge, publish, distribute, sublicense,
150
- > > and/or sell copies of the Software, and to permit persons to whom the
151
- > > Software is furnished to do so, subject to the following conditions:
152
- > >
153
- > > The above copyright notice and this permission notice shall be included in
154
- > > all copies or substantial portions of the Software.
155
- > >
156
- > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
157
- > > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
158
- > > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
159
- > > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
160
- > > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
161
- > > FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
162
- > > DEALINGS IN THE SOFTWARE.
163
- > >
164
- > >
165
- > >
166
- > > # Licenses of bundled dependencies
167
- > > The published @visulima/path artifact additionally contains code with the following licenses:
168
- > > MIT
169
- > >
170
- > > # Bundled dependencies:
171
- > > ## binary-extensions
172
- > > License: MIT
173
- > > By: Sindre Sorhus
174
- > > Repository: sindresorhus/binary-extensions
175
- > >
176
- > > > MIT License
177
- > > >
178
- > > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
179
- > > > Copyright (c) Paul Miller (https://paulmillr.com)
180
- > > >
181
- > > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
182
- > > >
183
- > > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
184
- > > >
185
- > > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
186
- >
187
- > ---------------------------------------
188
65
  >
189
66
  > ## is-plain-obj
67
+ >
190
68
  > License: MIT
191
69
  > By: Sindre Sorhus
192
70
  > Repository: sindresorhus/is-plain-obj
@@ -200,6 +78,33 @@ Repository: git+https://github.com/visulima/visulima.git
200
78
  > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
201
79
  > >
202
80
  > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
81
+ >
82
+ >
83
+ >
84
+ >
85
+ >
86
+ > # Licenses of bundled types
87
+ > The published @visulima/error artifact additionally contains code with the following licenses:
88
+ > Apache-2.0
89
+ >
90
+ > # Bundled types:
91
+ > ## ai
92
+ > License: Apache-2.0
93
+ > Repository: https://github.com/vercel/ai
94
+ >
95
+ > > Copyright 2023 Vercel, Inc.
96
+ > >
97
+ > > Licensed under the Apache License, Version 2.0 (the "License");
98
+ > > you may not use this file except in compliance with the License.
99
+ > > You may obtain a copy of the License at
100
+ > >
101
+ > > http://www.apache.org/licenses/LICENSE-2.0
102
+ > >
103
+ > > Unless required by applicable law or agreed to in writing, software
104
+ > > distributed under the License is distributed on an "AS IS" BASIS,
105
+ > > WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
106
+ > > See the License for the specific language governing permissions and
107
+ > > limitations under the License.
203
108
 
204
109
  ---------------------------------------
205
110
 
@@ -578,6 +483,23 @@ Repository: git+https://github.com/visulima/visulima.git
578
483
  >
579
484
  > ---------------------------------------
580
485
  >
486
+ > ## indent-string
487
+ > License: MIT
488
+ > By: Sindre Sorhus
489
+ > Repository: sindresorhus/indent-string
490
+ >
491
+ > > MIT License
492
+ > >
493
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
494
+ > >
495
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
496
+ > >
497
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
498
+ > >
499
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
500
+ >
501
+ > ---------------------------------------
502
+ >
581
503
  > ## lodash-es
582
504
  > License: MIT
583
505
  > By: John-David Dalton, Mathias Bynens
@@ -753,6 +675,23 @@ Repository: git+https://github.com/visulima/visulima.git
753
675
  >
754
676
  > ---------------------------------------
755
677
  >
678
+ > ## redent
679
+ > License: MIT
680
+ > By: Sindre Sorhus
681
+ > Repository: sindresorhus/redent
682
+ >
683
+ > > MIT License
684
+ > >
685
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
686
+ > >
687
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
688
+ > >
689
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
690
+ > >
691
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
692
+ >
693
+ > ---------------------------------------
694
+ >
756
695
  > ## rfdc
757
696
  > License: MIT
758
697
  > By: David Mark Clements
@@ -866,6 +805,23 @@ Repository: git+https://github.com/visulima/visulima.git
866
805
  >
867
806
  > ---------------------------------------
868
807
  >
808
+ > ## strip-indent
809
+ > License: MIT
810
+ > By: Sindre Sorhus
811
+ > Repository: sindresorhus/strip-indent
812
+ >
813
+ > > MIT License
814
+ > >
815
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
816
+ > >
817
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
818
+ > >
819
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
820
+ > >
821
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
822
+ >
823
+ > ---------------------------------------
824
+ >
869
825
  > ## tiny-invariant
870
826
  > License: MIT
871
827
  > By: Alex Reardon
@@ -928,52 +884,74 @@ Repository: git+https://github.com/visulima/visulima.git
928
884
  > > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
929
885
  > > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
930
886
  > > SOFTWARE.
931
-
932
- ---------------------------------------
933
-
934
- ## cli-spinners
935
- License: MIT
936
- By: Sindre Sorhus
937
- Repository: sindresorhus/cli-spinners
938
-
939
- > MIT License
940
887
  >
941
- > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
888
+ > ---------------------------------------
942
889
  >
943
- > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
890
+ > ## get-east-asian-width
891
+ > License: MIT
892
+ > By: Sindre Sorhus
893
+ > Repository: sindresorhus/get-east-asian-width
944
894
  >
945
- > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
895
+ > > MIT License
896
+ > >
897
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
898
+ > >
899
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
900
+ > >
901
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
902
+ > >
903
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
946
904
  >
947
- > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
948
-
949
- ---------------------------------------
950
-
951
- ## safe-stable-stringify
952
- License: MIT
953
- By: Ruben Bridgewater
954
- Repository: git+https://github.com/BridgeAR/safe-stable-stringify.git
955
-
956
- > The MIT License (MIT)
905
+ > ---------------------------------------
957
906
  >
958
- > Copyright (c) Ruben Bridgewater
907
+ > ## indent-string
908
+ > License: MIT
909
+ > By: Sindre Sorhus
910
+ > Repository: sindresorhus/indent-string
959
911
  >
960
- > Permission is hereby granted, free of charge, to any person obtaining a copy
961
- > of this software and associated documentation files (the "Software"), to deal
962
- > in the Software without restriction, including without limitation the rights
963
- > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
964
- > copies of the Software, and to permit persons to whom the Software is
965
- > furnished to do so, subject to the following conditions:
912
+ > > MIT License
913
+ > >
914
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
915
+ > >
916
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
917
+ > >
918
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
919
+ > >
920
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
966
921
  >
967
- > The above copyright notice and this permission notice shall be included in all
968
- > copies or substantial portions of the Software.
922
+ > ---------------------------------------
969
923
  >
970
- > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
971
- > IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
972
- > FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
973
- > AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
974
- > LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
975
- > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
976
- > SOFTWARE.
924
+ > ## redent
925
+ > License: MIT
926
+ > By: Sindre Sorhus
927
+ > Repository: sindresorhus/redent
928
+ >
929
+ > > MIT License
930
+ > >
931
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
932
+ > >
933
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
934
+ > >
935
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
936
+ > >
937
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
938
+ >
939
+ > ---------------------------------------
940
+ >
941
+ > ## strip-indent
942
+ > License: MIT
943
+ > By: Sindre Sorhus
944
+ > Repository: sindresorhus/strip-indent
945
+ >
946
+ > > MIT License
947
+ > >
948
+ > > Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
949
+ > >
950
+ > > Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
951
+ > >
952
+ > > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
953
+ > >
954
+ > > THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
977
955
 
978
956
  ---------------------------------------
979
957
 
@@ -997,14 +975,11 @@ Repository: sindresorhus/terminal-size
997
975
  <!-- TYPE_DEPENDENCIES -->
998
976
 
999
977
  # Licenses of bundled types
1000
-
1001
978
  The published @visulima/pail artifact additionally contains code with the following licenses:
1002
- MIT
979
+ MIT, (MIT OR CC0-1.0)
1003
980
 
1004
981
  # Bundled types:
1005
-
1006
982
  ## safe-stable-stringify
1007
-
1008
983
  License: MIT
1009
984
  By: Ruben Bridgewater
1010
985
  Repository: git+https://github.com/BridgeAR/safe-stable-stringify.git
@@ -1031,4 +1006,133 @@ Repository: git+https://github.com/BridgeAR/safe-stable-stringify.git
1031
1006
  > OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
1032
1007
  > SOFTWARE.
1033
1008
 
1009
+ ---------------------------------------
1010
+
1011
+ ## type-fest
1012
+ License: (MIT OR CC0-1.0)
1013
+ By: Sindre Sorhus
1014
+ Repository: sindresorhus/type-fest
1015
+
1016
+ > Creative Commons Legal Code
1017
+ >
1018
+ > CC0 1.0 Universal
1019
+ >
1020
+ > CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
1021
+ > LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
1022
+ > ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
1023
+ > INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
1024
+ > REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
1025
+ > PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
1026
+ > THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
1027
+ > HEREUNDER.
1028
+ >
1029
+ > Statement of Purpose
1030
+ >
1031
+ > The laws of most jurisdictions throughout the world automatically confer
1032
+ > exclusive Copyright and Related Rights (defined below) upon the creator
1033
+ > and subsequent owner(s) (each and all, an "owner") of an original work of
1034
+ > authorship and/or a database (each, a "Work").
1035
+ >
1036
+ > Certain owners wish to permanently relinquish those rights to a Work for
1037
+ > the purpose of contributing to a commons of creative, cultural and
1038
+ > scientific works ("Commons") that the public can reliably and without fear
1039
+ > of later claims of infringement build upon, modify, incorporate in other
1040
+ > works, reuse and redistribute as freely as possible in any form whatsoever
1041
+ > and for any purposes, including without limitation commercial purposes.
1042
+ > These owners may contribute to the Commons to promote the ideal of a free
1043
+ > culture and the further production of creative, cultural and scientific
1044
+ > works, or to gain reputation or greater distribution for their Work in
1045
+ > part through the use and efforts of others.
1046
+ >
1047
+ > For these and/or other purposes and motivations, and without any
1048
+ > expectation of additional consideration or compensation, the person
1049
+ > associating CC0 with a Work (the "Affirmer"), to the extent that he or she
1050
+ > is an owner of Copyright and Related Rights in the Work, voluntarily
1051
+ > elects to apply CC0 to the Work and publicly distribute the Work under its
1052
+ > terms, with knowledge of his or her Copyright and Related Rights in the
1053
+ > Work and the meaning and intended legal effect of CC0 on those rights.
1054
+ >
1055
+ > 1. Copyright and Related Rights. A Work made available under CC0 may be
1056
+ > protected by copyright and related or neighboring rights ("Copyright and
1057
+ > Related Rights"). Copyright and Related Rights include, but are not
1058
+ > limited to, the following:
1059
+ >
1060
+ > i. the right to reproduce, adapt, distribute, perform, display,
1061
+ > communicate, and translate a Work;
1062
+ > ii. moral rights retained by the original author(s) and/or performer(s);
1063
+ > iii. publicity and privacy rights pertaining to a person's image or
1064
+ > likeness depicted in a Work;
1065
+ > iv. rights protecting against unfair competition in regards to a Work,
1066
+ > subject to the limitations in paragraph 4(a), below;
1067
+ > v. rights protecting the extraction, dissemination, use and reuse of data
1068
+ > in a Work;
1069
+ > vi. database rights (such as those arising under Directive 96/9/EC of the
1070
+ > European Parliament and of the Council of 11 March 1996 on the legal
1071
+ > protection of databases, and under any national implementation
1072
+ > thereof, including any amended or successor version of such
1073
+ > directive); and
1074
+ > vii. other similar, equivalent or corresponding rights throughout the
1075
+ > world based on applicable law or treaty, and any national
1076
+ > implementations thereof.
1077
+ >
1078
+ > 2. Waiver. To the greatest extent permitted by, but not in contravention
1079
+ > of, applicable law, Affirmer hereby overtly, fully, permanently,
1080
+ > irrevocably and unconditionally waives, abandons, and surrenders all of
1081
+ > Affirmer's Copyright and Related Rights and associated claims and causes
1082
+ > of action, whether now known or unknown (including existing as well as
1083
+ > future claims and causes of action), in the Work (i) in all territories
1084
+ > worldwide, (ii) for the maximum duration provided by applicable law or
1085
+ > treaty (including future time extensions), (iii) in any current or future
1086
+ > medium and for any number of copies, and (iv) for any purpose whatsoever,
1087
+ > including without limitation commercial, advertising or promotional
1088
+ > purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
1089
+ > member of the public at large and to the detriment of Affirmer's heirs and
1090
+ > successors, fully intending that such Waiver shall not be subject to
1091
+ > revocation, rescission, cancellation, termination, or any other legal or
1092
+ > equitable action to disrupt the quiet enjoyment of the Work by the public
1093
+ > as contemplated by Affirmer's express Statement of Purpose.
1094
+ >
1095
+ > 3. Public License Fallback. Should any part of the Waiver for any reason
1096
+ > be judged legally invalid or ineffective under applicable law, then the
1097
+ > Waiver shall be preserved to the maximum extent permitted taking into
1098
+ > account Affirmer's express Statement of Purpose. In addition, to the
1099
+ > extent the Waiver is so judged Affirmer hereby grants to each affected
1100
+ > person a royalty-free, non transferable, non sublicensable, non exclusive,
1101
+ > irrevocable and unconditional license to exercise Affirmer's Copyright and
1102
+ > Related Rights in the Work (i) in all territories worldwide, (ii) for the
1103
+ > maximum duration provided by applicable law or treaty (including future
1104
+ > time extensions), (iii) in any current or future medium and for any number
1105
+ > of copies, and (iv) for any purpose whatsoever, including without
1106
+ > limitation commercial, advertising or promotional purposes (the
1107
+ > "License"). The License shall be deemed effective as of the date CC0 was
1108
+ > applied by Affirmer to the Work. Should any part of the License for any
1109
+ > reason be judged legally invalid or ineffective under applicable law, such
1110
+ > partial invalidity or ineffectiveness shall not invalidate the remainder
1111
+ > of the License, and in such case Affirmer hereby affirms that he or she
1112
+ > will not (i) exercise any of his or her remaining Copyright and Related
1113
+ > Rights in the Work or (ii) assert any associated claims and causes of
1114
+ > action with respect to the Work, in either case contrary to Affirmer's
1115
+ > express Statement of Purpose.
1116
+ >
1117
+ > 4. Limitations and Disclaimers.
1118
+ >
1119
+ > a. No trademark or patent rights held by Affirmer are waived, abandoned,
1120
+ > surrendered, licensed or otherwise affected by this document.
1121
+ > b. Affirmer offers the Work as-is and makes no representations or
1122
+ > warranties of any kind concerning the Work, express, implied,
1123
+ > statutory or otherwise, including without limitation warranties of
1124
+ > title, merchantability, fitness for a particular purpose, non
1125
+ > infringement, or the absence of latent or other defects, accuracy, or
1126
+ > the present or absence of errors, whether or not discoverable, all to
1127
+ > the greatest extent permissible under applicable law.
1128
+ > c. Affirmer disclaims responsibility for clearing rights of other persons
1129
+ > that may apply to the Work or any use thereof, including without
1130
+ > limitation any person's Copyright and Related Rights in the Work.
1131
+ > Further, Affirmer disclaims responsibility for obtaining any necessary
1132
+ > consents, permissions or other rights required for any use of the
1133
+ > Work.
1134
+ > d. Affirmer understands and acknowledges that Creative Commons is not a
1135
+ > party to this document and has no duty or obligation with respect to
1136
+ > this CC0 or use of the Work.
1137
+
1034
1138
  <!-- /TYPE_DEPENDENCIES -->
package/README.md CHANGED
@@ -1041,30 +1041,59 @@ When a log entry exceeds `maxLogSize`, a `LogSizeError` is thrown. When a batch
1041
1041
 
1042
1042
  ### Configuration Options
1043
1043
 
1044
- | Option | Type | Default | Description |
1045
- | ------------------------ | ------------------------------------------ | -------------------- | --------------------------------------------- |
1046
- | `url` | `string` | **required** | HTTP endpoint URL |
1047
- | `method` | `string` | `"POST"` | HTTP method |
1048
- | `headers` | `Record<string, string> \| (() => ...)` | `{}` | Request headers (object or function) |
1049
- | `contentType` | `string` | `"application/json"` | Content type for single requests |
1050
- | `batchContentType` | `string` | `"application/json"` | Content type for batch requests |
1051
- | `enableBatchSend` | `boolean` | `true` | Enable automatic batching |
1052
- | `batchSize` | `number` | `100` | Number of logs to batch before sending |
1053
- | `batchSendTimeout` | `number` | `5000` | Timeout (ms) to send batch regardless of size |
1054
- | `batchMode` | `"delimiter" \| "array" \| "field"` | `"delimiter"` | Batch format mode |
1055
- | `batchSendDelimiter` | `string` | `"\n"` | Delimiter for batch entries |
1056
- | `batchFieldName` | `string` | `undefined` | Field name for "field" batch mode |
1057
- | `compression` | `boolean` | `false` | Enable gzip compression |
1058
- | `maxRetries` | `number` | `3` | Maximum retry attempts |
1059
- | `retryDelay` | `number` | `1000` | Base delay between retries (ms) |
1060
- | `respectRateLimit` | `boolean` | `true` | Wait on 429 rate limit responses |
1061
- | `maxLogSize` | `number` | `1048576` | Maximum size per log entry (bytes) |
1062
- | `maxPayloadSize` | `number` | `5242880` | Maximum size per payload (bytes) |
1063
- | `edgeCompat` | `boolean` | `false` | Enable Edge Runtime compatibility |
1064
- | `onError` | `(error: Error) => void` | `undefined` | Error callback |
1065
- | `onDebug` | `(entry: Record<string, unknown>) => void` | `undefined` | Debug callback for log entries |
1066
- | `onDebugRequestResponse` | `(reqRes: {...}) => void` | `undefined` | Debug callback for HTTP requests/responses |
1067
- | `payloadTemplate` | `(data: {...}) => string` | `undefined` | Custom payload formatter |
1044
+ | Option | Type | Default | Description |
1045
+ | ------------------------ | ------------------------------------------ | -------------------- | ---------------------------------------------- |
1046
+ | `url` | `string` | **required** | HTTP endpoint URL |
1047
+ | `method` | `string` | `"POST"` | HTTP method |
1048
+ | `headers` | `Record<string, string> \| (() => ...)` | `{}` | Request headers (object or function) |
1049
+ | `contentType` | `string` | `"application/json"` | Content type for single requests |
1050
+ | `batchContentType` | `string` | `"application/json"` | Content type for batch requests |
1051
+ | `enableBatchSend` | `boolean` | `true` | Enable automatic batching |
1052
+ | `batchSize` | `number` | `100` | Number of logs to batch before sending |
1053
+ | `batchSendTimeout` | `number` | `5000` | Timeout (ms) to send batch regardless of size |
1054
+ | `batchMode` | `"delimiter" \| "array" \| "field"` | `"delimiter"` | Batch format mode |
1055
+ | `batchSendDelimiter` | `string` | `"\n"` | Delimiter for batch entries |
1056
+ | `batchFieldName` | `string` | `undefined` | Field name for "field" batch mode |
1057
+ | `compression` | `boolean` | `false` | Enable gzip compression |
1058
+ | `maxRetries` | `number` | `3` | Maximum retry attempts |
1059
+ | `retryDelay` | `number` | `1000` | Base delay between retries (ms) |
1060
+ | `respectRateLimit` | `boolean` | `true` | Wait on 429 rate limit responses |
1061
+ | `maxLogSize` | `number` | `1048576` | Maximum size per log entry (bytes) |
1062
+ | `maxPayloadSize` | `number` | `5242880` | Maximum size per payload (bytes) |
1063
+ | `maxQueueSize` | `number` | `10000` | Max queued entries before drop-oldest kicks in |
1064
+ | `edgeCompat` | `boolean` | `false` | Enable Edge Runtime compatibility |
1065
+ | `onError` | `(error: Error) => void` | `undefined` | Error callback |
1066
+ | `onDrop` | `(droppedCount: number) => void` | `undefined` | Called when queued entries are dropped |
1067
+ | `onDebug` | `(entry: Record<string, unknown>) => void` | `undefined` | Debug callback for log entries |
1068
+ | `onDebugRequestResponse` | `(reqRes: {...}) => void` | `undefined` | Debug callback for HTTP requests/responses |
1069
+ | `payloadTemplate` | `(data: {...}) => string` | `undefined` | Custom payload formatter |
1070
+
1071
+ ### Flushing & Shutdown
1072
+
1073
+ `HttpReporter` batches entries (up to `batchSize`, or every `batchSendTimeout` ms). Before a
1074
+ short-lived or serverless process exits, call `flush()` (or `close()` / `dispose()`) so the
1075
+ tail of the batch is shipped rather than lost:
1076
+
1077
+ ```typescript
1078
+ const reporter = new HttpReporter({ url: "https://logs.example.com" });
1079
+
1080
+ // ... log ...
1081
+
1082
+ // Drain the queue before exit
1083
+ await reporter.flush();
1084
+ ```
1085
+
1086
+ If the endpoint is unavailable, the queue is capped at `maxQueueSize` entries using a
1087
+ drop-oldest policy, so a sustained outage cannot grow memory without bound. Provide `onDrop`
1088
+ to be notified when entries are dropped.
1089
+
1090
+ `JsonFileReporter` likewise exposes `close()` / `dispose()` to end its rotating-file stream:
1091
+
1092
+ ```typescript
1093
+ process.on("beforeExit", () => {
1094
+ fileReporter.close();
1095
+ });
1096
+ ```
1068
1097
 
1069
1098
  ## Wide Events
1070
1099