@c15t/backend 0.0.1-rc.21 → 0.0.1-rc.23

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 (132) hide show
  1. package/.turbo/turbo-build.log +5 -5
  2. package/.turbo/turbo-fmt.log +3 -3
  3. package/.turbo/turbo-test.log +509 -36
  4. package/coverage/coverage-final.json +83 -0
  5. package/coverage/coverage-summary.json +84 -0
  6. package/coverage/html/backend/index.html +116 -0
  7. package/coverage/html/backend/rslib.config.ts.html +424 -0
  8. package/coverage/html/backend/src/core.ts.html +796 -0
  9. package/coverage/html/backend/src/index.html +131 -0
  10. package/coverage/html/backend/src/init.ts.html +1072 -0
  11. package/coverage/html/backend/src/integrations/cloudflare.ts.html +889 -0
  12. package/coverage/html/backend/src/integrations/index.html +146 -0
  13. package/coverage/html/backend/src/integrations/next.ts.html +691 -0
  14. package/coverage/html/backend/src/integrations/node.ts.html +505 -0
  15. package/coverage/html/backend/src/pkgs/api-router/hooks/index.html +116 -0
  16. package/coverage/html/backend/src/pkgs/api-router/hooks/processor.ts.html +538 -0
  17. package/coverage/html/backend/src/pkgs/api-router/index.html +131 -0
  18. package/coverage/html/backend/src/pkgs/api-router/index.ts.html +529 -0
  19. package/coverage/html/backend/src/pkgs/api-router/telemetry.ts.html +334 -0
  20. package/coverage/html/backend/src/pkgs/api-router/utils/cors.ts.html +304 -0
  21. package/coverage/html/backend/src/pkgs/api-router/utils/define-route.ts.html +1315 -0
  22. package/coverage/html/backend/src/pkgs/api-router/utils/index.html +146 -0
  23. package/coverage/html/backend/src/pkgs/api-router/utils/ip.ts.html +361 -0
  24. package/coverage/html/backend/src/pkgs/data-model/fields/field-factory.ts.html +709 -0
  25. package/coverage/html/backend/src/pkgs/data-model/fields/id-generator.ts.html +256 -0
  26. package/coverage/html/backend/src/pkgs/data-model/fields/index.html +161 -0
  27. package/coverage/html/backend/src/pkgs/data-model/fields/superjson-utils.ts.html +136 -0
  28. package/coverage/html/backend/src/pkgs/data-model/fields/zod-fields.ts.html +496 -0
  29. package/coverage/html/backend/src/pkgs/data-model/hooks/create-hooks.ts.html +349 -0
  30. package/coverage/html/backend/src/pkgs/data-model/hooks/index.html +176 -0
  31. package/coverage/html/backend/src/pkgs/data-model/hooks/update-hooks.ts.html +358 -0
  32. package/coverage/html/backend/src/pkgs/data-model/hooks/update-many-hooks.ts.html +613 -0
  33. package/coverage/html/backend/src/pkgs/data-model/hooks/utils.ts.html +538 -0
  34. package/coverage/html/backend/src/pkgs/data-model/hooks/with-hooks-factory.ts.html +289 -0
  35. package/coverage/html/backend/src/pkgs/db-adapters/adapter-factory.ts.html +277 -0
  36. package/coverage/html/backend/src/pkgs/db-adapters/adapters/drizzle-adapter/drizzle-adapter.ts.html +2212 -0
  37. package/coverage/html/backend/src/pkgs/db-adapters/adapters/drizzle-adapter/index.html +116 -0
  38. package/coverage/html/backend/src/pkgs/db-adapters/adapters/index.html +116 -0
  39. package/coverage/html/backend/src/pkgs/db-adapters/adapters/kysely-adapter/dialect.ts.html +676 -0
  40. package/coverage/html/backend/src/pkgs/db-adapters/adapters/kysely-adapter/index.html +131 -0
  41. package/coverage/html/backend/src/pkgs/db-adapters/adapters/kysely-adapter/kysely-adapter.ts.html +3637 -0
  42. package/coverage/html/backend/src/pkgs/db-adapters/adapters/kysely-adapter/tests/index.html +116 -0
  43. package/coverage/html/backend/src/pkgs/db-adapters/adapters/kysely-adapter/tests/test-utils.ts.html +1417 -0
  44. package/coverage/html/backend/src/pkgs/db-adapters/adapters/memory-adapter/index.html +116 -0
  45. package/coverage/html/backend/src/pkgs/db-adapters/adapters/memory-adapter/memory-adapter.ts.html +2074 -0
  46. package/coverage/html/backend/src/pkgs/db-adapters/adapters/prisma-adapter/index.html +116 -0
  47. package/coverage/html/backend/src/pkgs/db-adapters/adapters/prisma-adapter/prisma-adapter.ts.html +1837 -0
  48. package/coverage/html/backend/src/pkgs/db-adapters/adapters/test.ts.html +316 -0
  49. package/coverage/html/backend/src/pkgs/db-adapters/index.html +131 -0
  50. package/coverage/html/backend/src/pkgs/db-adapters/utils.ts.html +238 -0
  51. package/coverage/html/backend/src/pkgs/logger/console-formatter.ts.html +310 -0
  52. package/coverage/html/backend/src/pkgs/logger/index.html +176 -0
  53. package/coverage/html/backend/src/pkgs/logger/log-levels.ts.html +223 -0
  54. package/coverage/html/backend/src/pkgs/logger/logger-factory.ts.html +448 -0
  55. package/coverage/html/backend/src/pkgs/logger/result-logging.ts.html +487 -0
  56. package/coverage/html/backend/src/pkgs/logger/telemetry.ts.html +373 -0
  57. package/coverage/html/backend/src/pkgs/migrations/get-migration.ts.html +343 -0
  58. package/coverage/html/backend/src/pkgs/migrations/get-schema/get-schema.ts.html +217 -0
  59. package/coverage/html/backend/src/pkgs/migrations/get-schema/index.html +146 -0
  60. package/coverage/html/backend/src/pkgs/migrations/get-schema/process-fields.ts.html +280 -0
  61. package/coverage/html/backend/src/pkgs/migrations/get-schema/process-tables.ts.html +289 -0
  62. package/coverage/html/backend/src/pkgs/migrations/index.html +176 -0
  63. package/coverage/html/backend/src/pkgs/migrations/migration-builders.ts.html +595 -0
  64. package/coverage/html/backend/src/pkgs/migrations/migration-execution.ts.html +301 -0
  65. package/coverage/html/backend/src/pkgs/migrations/schema-comparison.ts.html +691 -0
  66. package/coverage/html/backend/src/pkgs/migrations/type-mapping.ts.html +817 -0
  67. package/coverage/html/backend/src/pkgs/results/core/error-class.ts.html +1012 -0
  68. package/coverage/html/backend/src/pkgs/results/core/error-codes.ts.html +703 -0
  69. package/coverage/html/backend/src/pkgs/results/core/index.html +146 -0
  70. package/coverage/html/backend/src/pkgs/results/core/tracing.ts.html +280 -0
  71. package/coverage/html/backend/src/pkgs/results/create-telemetry-options.ts.html +271 -0
  72. package/coverage/html/backend/src/pkgs/results/h3-integration.ts.html +511 -0
  73. package/coverage/html/backend/src/pkgs/results/index.html +131 -0
  74. package/coverage/html/backend/src/pkgs/results/pipeline/index.html +131 -0
  75. package/coverage/html/backend/src/pkgs/results/pipeline/retrieval-pipeline.ts.html +649 -0
  76. package/coverage/html/backend/src/pkgs/results/pipeline/validation-pipeline.ts.html +577 -0
  77. package/coverage/html/backend/src/pkgs/results/results/index.html +131 -0
  78. package/coverage/html/backend/src/pkgs/results/results/recovery-utils.ts.html +628 -0
  79. package/coverage/html/backend/src/pkgs/results/results/result-helpers.ts.html +1234 -0
  80. package/coverage/html/backend/src/pkgs/utils/env.ts.html +337 -0
  81. package/coverage/html/backend/src/pkgs/utils/index.html +131 -0
  82. package/coverage/html/backend/src/pkgs/utils/url.ts.html +400 -0
  83. package/coverage/html/backend/src/routes/index.html +176 -0
  84. package/coverage/html/backend/src/routes/index.ts.html +121 -0
  85. package/coverage/html/backend/src/routes/set-consent.ts.html +832 -0
  86. package/coverage/html/backend/src/routes/show-consent-banner.ts.html +478 -0
  87. package/coverage/html/backend/src/routes/status.ts.html +268 -0
  88. package/coverage/html/backend/src/routes/verify-consent.ts.html +703 -0
  89. package/coverage/html/backend/src/schema/audit-log/index.html +146 -0
  90. package/coverage/html/backend/src/schema/audit-log/registry.ts.html +436 -0
  91. package/coverage/html/backend/src/schema/audit-log/schema.ts.html +223 -0
  92. package/coverage/html/backend/src/schema/audit-log/table.ts.html +640 -0
  93. package/coverage/html/backend/src/schema/consent/index.html +146 -0
  94. package/coverage/html/backend/src/schema/consent/registry.ts.html +616 -0
  95. package/coverage/html/backend/src/schema/consent/schema.ts.html +238 -0
  96. package/coverage/html/backend/src/schema/consent/table.ts.html +748 -0
  97. package/coverage/html/backend/src/schema/consent-policy/index.html +146 -0
  98. package/coverage/html/backend/src/schema/consent-policy/registry.ts.html +1063 -0
  99. package/coverage/html/backend/src/schema/consent-policy/schema.ts.html +265 -0
  100. package/coverage/html/backend/src/schema/consent-policy/table.ts.html +535 -0
  101. package/coverage/html/backend/src/schema/consent-purpose/index.html +146 -0
  102. package/coverage/html/backend/src/schema/consent-purpose/registry.ts.html +589 -0
  103. package/coverage/html/backend/src/schema/consent-purpose/schema.ts.html +259 -0
  104. package/coverage/html/backend/src/schema/consent-purpose/table.ts.html +547 -0
  105. package/coverage/html/backend/src/schema/consent-record/index.html +131 -0
  106. package/coverage/html/backend/src/schema/consent-record/schema.ts.html +211 -0
  107. package/coverage/html/backend/src/schema/consent-record/table.ts.html +457 -0
  108. package/coverage/html/backend/src/schema/create-registry.ts.html +148 -0
  109. package/coverage/html/backend/src/schema/definition.ts.html +685 -0
  110. package/coverage/html/backend/src/schema/domain/index.html +146 -0
  111. package/coverage/html/backend/src/schema/domain/registry.ts.html +973 -0
  112. package/coverage/html/backend/src/schema/domain/schema.ts.html +214 -0
  113. package/coverage/html/backend/src/schema/domain/table.ts.html +496 -0
  114. package/coverage/html/backend/src/schema/index.html +146 -0
  115. package/coverage/html/backend/src/schema/schemas.ts.html +166 -0
  116. package/coverage/html/backend/src/schema/subject/index.html +146 -0
  117. package/coverage/html/backend/src/schema/subject/registry.ts.html +973 -0
  118. package/coverage/html/backend/src/schema/subject/schema.ts.html +208 -0
  119. package/coverage/html/backend/src/schema/subject/table.ts.html +499 -0
  120. package/coverage/html/base.css +224 -0
  121. package/coverage/html/block-navigation.js +87 -0
  122. package/coverage/html/favicon.png +0 -0
  123. package/coverage/html/index.html +581 -0
  124. package/coverage/html/prettify.css +1 -0
  125. package/coverage/html/prettify.js +2 -0
  126. package/coverage/html/sort-arrow-sprite.png +0 -0
  127. package/coverage/html/sorter.js +196 -0
  128. package/dist/index.cjs +1 -1
  129. package/dist/index.js +1 -1
  130. package/package.json +13 -12
  131. package/vitest.config.ts +14 -11
  132. package/.turbo/turbo-lint.log +0 -6
package/coverage/html/backend/src/pkgs/api-router/utils/index.html ADDED
@@ -0,0 +1,146 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for backend/src/pkgs/api-router/utils</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="../../../../../prettify.css" />
9
+ <link rel="stylesheet" href="../../../../../base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="../../../../../favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(../../../../../sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="../../../../../index.html">All files</a> backend/src/pkgs/api-router/utils</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">39.47% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>45/114</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">34.72% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>25/72</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">25% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>4/16</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">39.47% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>45/114</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line low'></div>
65
+ <div class="pad1">
66
+ <table class="coverage-summary">
67
+ <thead>
68
+ <tr>
69
+ <th data-col="file" data-fmt="html" data-html="true" class="file">File</th>
70
+ <th data-col="pic" data-type="number" data-fmt="html" data-html="true" class="pic"></th>
71
+ <th data-col="statements" data-type="number" data-fmt="pct" class="pct">Statements</th>
72
+ <th data-col="statements_raw" data-type="number" data-fmt="html" class="abs"></th>
73
+ <th data-col="branches" data-type="number" data-fmt="pct" class="pct">Branches</th>
74
+ <th data-col="branches_raw" data-type="number" data-fmt="html" class="abs"></th>
75
+ <th data-col="functions" data-type="number" data-fmt="pct" class="pct">Functions</th>
76
+ <th data-col="functions_raw" data-type="number" data-fmt="html" class="abs"></th>
77
+ <th data-col="lines" data-type="number" data-fmt="pct" class="pct">Lines</th>
78
+ <th data-col="lines_raw" data-type="number" data-fmt="html" class="abs"></th>
79
+ </tr>
80
+ </thead>
81
+ <tbody><tr>
82
+ <td class="file high" data-value="cors.ts"><a href="cors.ts.html">cors.ts</a></td>
83
+ <td data-value="85.71" class="pic high">
84
+ <div class="chart"><div class="cover-fill" style="width: 85%"></div><div class="cover-empty" style="width: 15%"></div></div>
85
+ </td>
86
+ <td data-value="85.71" class="pct high">85.71%</td>
87
+ <td data-value="28" class="abs high">24/28</td>
88
+ <td data-value="83.33" class="pct high">83.33%</td>
89
+ <td data-value="12" class="abs high">10/12</td>
90
+ <td data-value="100" class="pct high">100%</td>
91
+ <td data-value="2" class="abs high">2/2</td>
92
+ <td data-value="85.71" class="pct high">85.71%</td>
93
+ <td data-value="28" class="abs high">24/28</td>
94
+ </tr>
95
+
96
+ <tr>
97
+ <td class="file low" data-value="define-route.ts"><a href="define-route.ts.html">define-route.ts</a></td>
98
+ <td data-value="30" class="pic low">
99
+ <div class="chart"><div class="cover-fill" style="width: 30%"></div><div class="cover-empty" style="width: 70%"></div></div>
100
+ </td>
101
+ <td data-value="30" class="pct low">30%</td>
102
+ <td data-value="70" class="abs low">21/70</td>
103
+ <td data-value="32.6" class="pct low">32.6%</td>
104
+ <td data-value="46" class="abs low">15/46</td>
105
+ <td data-value="15.38" class="pct low">15.38%</td>
106
+ <td data-value="13" class="abs low">2/13</td>
107
+ <td data-value="30" class="pct low">30%</td>
108
+ <td data-value="70" class="abs low">21/70</td>
109
+ </tr>
110
+
111
+ <tr>
112
+ <td class="file low" data-value="ip.ts"><a href="ip.ts.html">ip.ts</a></td>
113
+ <td data-value="0" class="pic low">
114
+ <div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
115
+ </td>
116
+ <td data-value="0" class="pct low">0%</td>
117
+ <td data-value="16" class="abs low">0/16</td>
118
+ <td data-value="0" class="pct low">0%</td>
119
+ <td data-value="14" class="abs low">0/14</td>
120
+ <td data-value="0" class="pct low">0%</td>
121
+ <td data-value="1" class="abs low">0/1</td>
122
+ <td data-value="0" class="pct low">0%</td>
123
+ <td data-value="16" class="abs low">0/16</td>
124
+ </tr>
125
+
126
+ </tbody>
127
+ </table>
128
+ </div>
129
+ <div class='push'></div><!-- for sticky footer -->
130
+ </div><!-- /wrapper -->
131
+ <div class='footer quiet pad2 space-top1 center small'>
132
+ Code coverage generated by
133
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
134
+ at 2025-04-14T10:55:46.797Z
135
+ </div>
136
+ <script src="../../../../../prettify.js"></script>
137
+ <script>
138
+ window.onload = function () {
139
+ prettyPrint();
140
+ };
141
+ </script>
142
+ <script src="../../../../../sorter.js"></script>
143
+ <script src="../../../../../block-navigation.js"></script>
144
+ </body>
145
+ </html>
146
+
package/coverage/html/backend/src/pkgs/api-router/utils/ip.ts.html ADDED
@@ -0,0 +1,361 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en">
4
+
5
+ <head>
6
+ <title>Code coverage report for backend/src/pkgs/api-router/utils/ip.ts</title>
7
+ <meta charset="utf-8" />
8
+ <link rel="stylesheet" href="../../../../../prettify.css" />
9
+ <link rel="stylesheet" href="../../../../../base.css" />
10
+ <link rel="shortcut icon" type="image/x-icon" href="../../../../../favicon.png" />
11
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
12
+ <style type='text/css'>
13
+ .coverage-summary .sorter {
14
+ background-image: url(../../../../../sort-arrow-sprite.png);
15
+ }
16
+ </style>
17
+ </head>
18
+
19
+ <body>
20
+ <div class='wrapper'>
21
+ <div class='pad1'>
22
+ <h1><a href="../../../../../index.html">All files</a> / <a href="index.html">backend/src/pkgs/api-router/utils</a> ip.ts</h1>
23
+ <div class='clearfix'>
24
+
25
+ <div class='fl pad1y space-right2'>
26
+ <span class="strong">0% </span>
27
+ <span class="quiet">Statements</span>
28
+ <span class='fraction'>0/16</span>
29
+ </div>
30
+
31
+
32
+ <div class='fl pad1y space-right2'>
33
+ <span class="strong">0% </span>
34
+ <span class="quiet">Branches</span>
35
+ <span class='fraction'>0/14</span>
36
+ </div>
37
+
38
+
39
+ <div class='fl pad1y space-right2'>
40
+ <span class="strong">0% </span>
41
+ <span class="quiet">Functions</span>
42
+ <span class='fraction'>0/1</span>
43
+ </div>
44
+
45
+
46
+ <div class='fl pad1y space-right2'>
47
+ <span class="strong">0% </span>
48
+ <span class="quiet">Lines</span>
49
+ <span class='fraction'>0/16</span>
50
+ </div>
51
+
52
+
53
+ </div>
54
+ <p class="quiet">
55
+ Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
56
+ </p>
57
+ <template id="filterTemplate">
58
+ <div class="quiet">
59
+ Filter:
60
+ <input type="search" id="fileSearch">
61
+ </div>
62
+ </template>
63
+ </div>
64
+ <div class='status-line low'></div>
65
+ <pre><table class="coverage">
66
+ <tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
67
+ <a name='L2'></a><a href='#L2'>2</a>
68
+ <a name='L3'></a><a href='#L3'>3</a>
69
+ <a name='L4'></a><a href='#L4'>4</a>
70
+ <a name='L5'></a><a href='#L5'>5</a>
71
+ <a name='L6'></a><a href='#L6'>6</a>
72
+ <a name='L7'></a><a href='#L7'>7</a>
73
+ <a name='L8'></a><a href='#L8'>8</a>
74
+ <a name='L9'></a><a href='#L9'>9</a>
75
+ <a name='L10'></a><a href='#L10'>10</a>
76
+ <a name='L11'></a><a href='#L11'>11</a>
77
+ <a name='L12'></a><a href='#L12'>12</a>
78
+ <a name='L13'></a><a href='#L13'>13</a>
79
+ <a name='L14'></a><a href='#L14'>14</a>
80
+ <a name='L15'></a><a href='#L15'>15</a>
81
+ <a name='L16'></a><a href='#L16'>16</a>
82
+ <a name='L17'></a><a href='#L17'>17</a>
83
+ <a name='L18'></a><a href='#L18'>18</a>
84
+ <a name='L19'></a><a href='#L19'>19</a>
85
+ <a name='L20'></a><a href='#L20'>20</a>
86
+ <a name='L21'></a><a href='#L21'>21</a>
87
+ <a name='L22'></a><a href='#L22'>22</a>
88
+ <a name='L23'></a><a href='#L23'>23</a>
89
+ <a name='L24'></a><a href='#L24'>24</a>
90
+ <a name='L25'></a><a href='#L25'>25</a>
91
+ <a name='L26'></a><a href='#L26'>26</a>
92
+ <a name='L27'></a><a href='#L27'>27</a>
93
+ <a name='L28'></a><a href='#L28'>28</a>
94
+ <a name='L29'></a><a href='#L29'>29</a>
95
+ <a name='L30'></a><a href='#L30'>30</a>
96
+ <a name='L31'></a><a href='#L31'>31</a>
97
+ <a name='L32'></a><a href='#L32'>32</a>
98
+ <a name='L33'></a><a href='#L33'>33</a>
99
+ <a name='L34'></a><a href='#L34'>34</a>
100
+ <a name='L35'></a><a href='#L35'>35</a>
101
+ <a name='L36'></a><a href='#L36'>36</a>
102
+ <a name='L37'></a><a href='#L37'>37</a>
103
+ <a name='L38'></a><a href='#L38'>38</a>
104
+ <a name='L39'></a><a href='#L39'>39</a>
105
+ <a name='L40'></a><a href='#L40'>40</a>
106
+ <a name='L41'></a><a href='#L41'>41</a>
107
+ <a name='L42'></a><a href='#L42'>42</a>
108
+ <a name='L43'></a><a href='#L43'>43</a>
109
+ <a name='L44'></a><a href='#L44'>44</a>
110
+ <a name='L45'></a><a href='#L45'>45</a>
111
+ <a name='L46'></a><a href='#L46'>46</a>
112
+ <a name='L47'></a><a href='#L47'>47</a>
113
+ <a name='L48'></a><a href='#L48'>48</a>
114
+ <a name='L49'></a><a href='#L49'>49</a>
115
+ <a name='L50'></a><a href='#L50'>50</a>
116
+ <a name='L51'></a><a href='#L51'>51</a>
117
+ <a name='L52'></a><a href='#L52'>52</a>
118
+ <a name='L53'></a><a href='#L53'>53</a>
119
+ <a name='L54'></a><a href='#L54'>54</a>
120
+ <a name='L55'></a><a href='#L55'>55</a>
121
+ <a name='L56'></a><a href='#L56'>56</a>
122
+ <a name='L57'></a><a href='#L57'>57</a>
123
+ <a name='L58'></a><a href='#L58'>58</a>
124
+ <a name='L59'></a><a href='#L59'>59</a>
125
+ <a name='L60'></a><a href='#L60'>60</a>
126
+ <a name='L61'></a><a href='#L61'>61</a>
127
+ <a name='L62'></a><a href='#L62'>62</a>
128
+ <a name='L63'></a><a href='#L63'>63</a>
129
+ <a name='L64'></a><a href='#L64'>64</a>
130
+ <a name='L65'></a><a href='#L65'>65</a>
131
+ <a name='L66'></a><a href='#L66'>66</a>
132
+ <a name='L67'></a><a href='#L67'>67</a>
133
+ <a name='L68'></a><a href='#L68'>68</a>
134
+ <a name='L69'></a><a href='#L69'>69</a>
135
+ <a name='L70'></a><a href='#L70'>70</a>
136
+ <a name='L71'></a><a href='#L71'>71</a>
137
+ <a name='L72'></a><a href='#L72'>72</a>
138
+ <a name='L73'></a><a href='#L73'>73</a>
139
+ <a name='L74'></a><a href='#L74'>74</a>
140
+ <a name='L75'></a><a href='#L75'>75</a>
141
+ <a name='L76'></a><a href='#L76'>76</a>
142
+ <a name='L77'></a><a href='#L77'>77</a>
143
+ <a name='L78'></a><a href='#L78'>78</a>
144
+ <a name='L79'></a><a href='#L79'>79</a>
145
+ <a name='L80'></a><a href='#L80'>80</a>
146
+ <a name='L81'></a><a href='#L81'>81</a>
147
+ <a name='L82'></a><a href='#L82'>82</a>
148
+ <a name='L83'></a><a href='#L83'>83</a>
149
+ <a name='L84'></a><a href='#L84'>84</a>
150
+ <a name='L85'></a><a href='#L85'>85</a>
151
+ <a name='L86'></a><a href='#L86'>86</a>
152
+ <a name='L87'></a><a href='#L87'>87</a>
153
+ <a name='L88'></a><a href='#L88'>88</a>
154
+ <a name='L89'></a><a href='#L89'>89</a>
155
+ <a name='L90'></a><a href='#L90'>90</a>
156
+ <a name='L91'></a><a href='#L91'>91</a>
157
+ <a name='L92'></a><a href='#L92'>92</a>
158
+ <a name='L93'></a><a href='#L93'>93</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
159
+ <span class="cline-any cline-neutral">&nbsp;</span>
160
+ <span class="cline-any cline-neutral">&nbsp;</span>
161
+ <span class="cline-any cline-no">&nbsp;</span>
162
+ <span class="cline-any cline-neutral">&nbsp;</span>
163
+ <span class="cline-any cline-neutral">&nbsp;</span>
164
+ <span class="cline-any cline-neutral">&nbsp;</span>
165
+ <span class="cline-any cline-neutral">&nbsp;</span>
166
+ <span class="cline-any cline-neutral">&nbsp;</span>
167
+ <span class="cline-any cline-neutral">&nbsp;</span>
168
+ <span class="cline-any cline-neutral">&nbsp;</span>
169
+ <span class="cline-any cline-neutral">&nbsp;</span>
170
+ <span class="cline-any cline-neutral">&nbsp;</span>
171
+ <span class="cline-any cline-neutral">&nbsp;</span>
172
+ <span class="cline-any cline-neutral">&nbsp;</span>
173
+ <span class="cline-any cline-neutral">&nbsp;</span>
174
+ <span class="cline-any cline-neutral">&nbsp;</span>
175
+ <span class="cline-any cline-neutral">&nbsp;</span>
176
+ <span class="cline-any cline-neutral">&nbsp;</span>
177
+ <span class="cline-any cline-neutral">&nbsp;</span>
178
+ <span class="cline-any cline-neutral">&nbsp;</span>
179
+ <span class="cline-any cline-neutral">&nbsp;</span>
180
+ <span class="cline-any cline-neutral">&nbsp;</span>
181
+ <span class="cline-any cline-neutral">&nbsp;</span>
182
+ <span class="cline-any cline-neutral">&nbsp;</span>
183
+ <span class="cline-any cline-neutral">&nbsp;</span>
184
+ <span class="cline-any cline-neutral">&nbsp;</span>
185
+ <span class="cline-any cline-neutral">&nbsp;</span>
186
+ <span class="cline-any cline-neutral">&nbsp;</span>
187
+ <span class="cline-any cline-neutral">&nbsp;</span>
188
+ <span class="cline-any cline-neutral">&nbsp;</span>
189
+ <span class="cline-any cline-neutral">&nbsp;</span>
190
+ <span class="cline-any cline-neutral">&nbsp;</span>
191
+ <span class="cline-any cline-neutral">&nbsp;</span>
192
+ <span class="cline-any cline-neutral">&nbsp;</span>
193
+ <span class="cline-any cline-neutral">&nbsp;</span>
194
+ <span class="cline-any cline-neutral">&nbsp;</span>
195
+ <span class="cline-any cline-neutral">&nbsp;</span>
196
+ <span class="cline-any cline-neutral">&nbsp;</span>
197
+ <span class="cline-any cline-neutral">&nbsp;</span>
198
+ <span class="cline-any cline-neutral">&nbsp;</span>
199
+ <span class="cline-any cline-neutral">&nbsp;</span>
200
+ <span class="cline-any cline-neutral">&nbsp;</span>
201
+ <span class="cline-any cline-neutral">&nbsp;</span>
202
+ <span class="cline-any cline-neutral">&nbsp;</span>
203
+ <span class="cline-any cline-neutral">&nbsp;</span>
204
+ <span class="cline-any cline-neutral">&nbsp;</span>
205
+ <span class="cline-any cline-neutral">&nbsp;</span>
206
+ <span class="cline-any cline-neutral">&nbsp;</span>
207
+ <span class="cline-any cline-neutral">&nbsp;</span>
208
+ <span class="cline-any cline-neutral">&nbsp;</span>
209
+ <span class="cline-any cline-neutral">&nbsp;</span>
210
+ <span class="cline-any cline-neutral">&nbsp;</span>
211
+ <span class="cline-any cline-neutral">&nbsp;</span>
212
+ <span class="cline-any cline-neutral">&nbsp;</span>
213
+ <span class="cline-any cline-neutral">&nbsp;</span>
214
+ <span class="cline-any cline-neutral">&nbsp;</span>
215
+ <span class="cline-any cline-neutral">&nbsp;</span>
216
+ <span class="cline-any cline-neutral">&nbsp;</span>
217
+ <span class="cline-any cline-neutral">&nbsp;</span>
218
+ <span class="cline-any cline-neutral">&nbsp;</span>
219
+ <span class="cline-any cline-neutral">&nbsp;</span>
220
+ <span class="cline-any cline-no">&nbsp;</span>
221
+ <span class="cline-any cline-neutral">&nbsp;</span>
222
+ <span class="cline-any cline-neutral">&nbsp;</span>
223
+ <span class="cline-any cline-neutral">&nbsp;</span>
224
+ <span class="cline-any cline-neutral">&nbsp;</span>
225
+ <span class="cline-any cline-neutral">&nbsp;</span>
226
+ <span class="cline-any cline-neutral">&nbsp;</span>
227
+ <span class="cline-any cline-no">&nbsp;</span>
228
+ <span class="cline-any cline-no">&nbsp;</span>
229
+ <span class="cline-any cline-neutral">&nbsp;</span>
230
+ <span class="cline-any cline-neutral">&nbsp;</span>
231
+ <span class="cline-any cline-no">&nbsp;</span>
232
+ <span class="cline-any cline-no">&nbsp;</span>
233
+ <span class="cline-any cline-no">&nbsp;</span>
234
+ <span class="cline-any cline-neutral">&nbsp;</span>
235
+ <span class="cline-any cline-neutral">&nbsp;</span>
236
+ <span class="cline-any cline-no">&nbsp;</span>
237
+ <span class="cline-any cline-neutral">&nbsp;</span>
238
+ <span class="cline-any cline-no">&nbsp;</span>
239
+ <span class="cline-any cline-no">&nbsp;</span>
240
+ <span class="cline-any cline-no">&nbsp;</span>
241
+ <span class="cline-any cline-no">&nbsp;</span>
242
+ <span class="cline-any cline-no">&nbsp;</span>
243
+ <span class="cline-any cline-no">&nbsp;</span>
244
+ <span class="cline-any cline-no">&nbsp;</span>
245
+ <span class="cline-any cline-neutral">&nbsp;</span>
246
+ <span class="cline-any cline-neutral">&nbsp;</span>
247
+ <span class="cline-any cline-neutral">&nbsp;</span>
248
+ <span class="cline-any cline-no">&nbsp;</span>
249
+ <span class="cline-any cline-neutral">&nbsp;</span>
250
+ <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import type { C15TOptions } from '~/types';
251
+ import { isTest } from '../../utils/env';
252
+ &nbsp;
253
+ const DEFAULT_IP_HEADERS = <span class="cstat-no" title="statement not covered" >[</span>
254
+ 'x-client-ip',
255
+ 'x-forwarded-for',
256
+ 'cf-connecting-ip',
257
+ 'fastly-client-ip',
258
+ 'x-real-ip',
259
+ 'x-cluster-client-ip',
260
+ 'x-forwarded',
261
+ 'forwarded-for',
262
+ 'forwarded',
263
+ ];
264
+ &nbsp;
265
+ /**
266
+ * Gets the client IP address from request headers
267
+ *
268
+ * This utility function extracts the client IP address from various standard and
269
+ * non-standard headers found in HTTP requests. It respects privacy settings from
270
+ * the configuration options and follows a fallback strategy when multiple
271
+ * IP-related headers are present.
272
+ *
273
+ * @param req - The request object or headers to extract the IP from
274
+ * @param options - Configuration options containing IP address settings
275
+ * @returns The client IP address or null if tracking is disabled or no IP can be found
276
+ *
277
+ * @remarks
278
+ * The function checks headers in the following order:
279
+ * 1. Custom headers specified in options.advanced.ipAddress.ipAddressHeaders
280
+ * 2. Standard headers like x-forwarded-for, cf-connecting-ip, etc.
281
+ *
282
+ * For headers that may contain multiple IPs (like x-forwarded-for), it takes the
283
+ * first one in the list, which typically represents the client's actual IP.
284
+ *
285
+ * @example
286
+ * ```typescript
287
+ * // Get IP address from a Request object
288
+ * const request = new Request('https://api.example.com');
289
+ * const clientIp = getIp(request, {
290
+ * advanced: {
291
+ * ipAddress: {
292
+ * disableIpTracking: false,
293
+ * ipAddressHeaders: ['x-real-client-ip', 'x-forwarded-for']
294
+ * }
295
+ * }
296
+ * });
297
+ *
298
+ * // Log the client IP if found
299
+ * if (clientIp) {
300
+ * console.log(`Request from IP: ${clientIp}`);
301
+ * } else {
302
+ * console.log('IP tracking disabled or IP not found');
303
+ * }
304
+ * ```
305
+ */
306
+ export function <span class="fstat-no" title="function not covered" >getIp(</span>
307
+ req: Request | Headers,
308
+ options: C15TOptions
309
+ ): string | null {
310
+ // Safe access to potentially undefined properties
311
+ const advanced =
312
+ (<span class="cstat-no" title="statement not covered" >options.advanced as {</span>
313
+ ipAddress?: {
314
+ disableIpTracking?: boolean;
315
+ ipAddressHeaders?: string[];
316
+ };
317
+ }) || {};
318
+ &nbsp;
319
+ <span class="cstat-no" title="statement not covered" > if (advanced?.ipAddress?.disableIpTracking) {</span>
320
+ <span class="cstat-no" title="statement not covered" > return null;</span>
321
+ }
322
+ &nbsp;
323
+ const testIP = <span class="cstat-no" title="statement not covered" >'127.0.0.1';</span>
324
+ <span class="cstat-no" title="statement not covered" > if (isTest) {</span>
325
+ <span class="cstat-no" title="statement not covered" > return testIP;</span>
326
+ }
327
+ &nbsp;
328
+ const ipHeaders = <span class="cstat-no" title="statement not covered" >advanced?.ipAddress?.ipAddressHeaders || DEFAULT_IP_HEADERS;</span>
329
+ &nbsp;
330
+ const headers = <span class="cstat-no" title="statement not covered" >req instanceof Request ? req.headers : req;</span>
331
+ <span class="cstat-no" title="statement not covered" > for (const key of ipHeaders) {</span>
332
+ const value = <span class="cstat-no" title="statement not covered" >headers.get(key);</span>
333
+ <span class="cstat-no" title="statement not covered" > if (value) {</span>
334
+ const ip = <span class="cstat-no" title="statement not covered" >value.split(',')[0]?.trim();</span>
335
+ <span class="cstat-no" title="statement not covered" > if (ip) {</span>
336
+ <span class="cstat-no" title="statement not covered" > return ip;</span>
337
+ }
338
+ }
339
+ }
340
+ <span class="cstat-no" title="statement not covered" > return null;</span>
341
+ }
342
+ &nbsp;</pre></td></tr></table></pre>
343
+
344
+ <div class='push'></div><!-- for sticky footer -->
345
+ </div><!-- /wrapper -->
346
+ <div class='footer quiet pad2 space-top1 center small'>
347
+ Code coverage generated by
348
+ <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
349
+ at 2025-04-14T10:55:46.797Z
350
+ </div>
351
+ <script src="../../../../../prettify.js"></script>
352
+ <script>
353
+ window.onload = function () {
354
+ prettyPrint();
355
+ };
356
+ </script>
357
+ <script src="../../../../../sorter.js"></script>
358
+ <script src="../../../../../block-navigation.js"></script>
359
+ </body>
360
+ </html>
361
+