@blamejs/core 0.7.18 → 0.7.20

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 (169) hide show
  1. package/CHANGELOG.md +427 -423
  2. package/README.md +150 -150
  3. package/bin/blamejs.js +0 -0
  4. package/index.js +310 -308
  5. package/lib/api-key.js +660 -660
  6. package/lib/api-snapshot.js +338 -338
  7. package/lib/app-shutdown.js +385 -385
  8. package/lib/app.js +365 -365
  9. package/lib/archive.js +250 -250
  10. package/lib/atomic-file.js +544 -544
  11. package/lib/audit-chain.js +177 -177
  12. package/lib/audit-sign.js +344 -344
  13. package/lib/audit-tools.js +677 -677
  14. package/lib/audit.js +766 -766
  15. package/lib/auth/jwt-external.js +365 -0
  16. package/lib/auth/jwt.js +337 -311
  17. package/lib/auth/lockout.js +436 -436
  18. package/lib/auth/oauth.js +721 -721
  19. package/lib/auth/passkey.js +181 -181
  20. package/lib/auth/password.js +628 -594
  21. package/lib/backup/bundle.js +217 -217
  22. package/lib/backup/crypto.js +176 -176
  23. package/lib/backup/index.js +515 -515
  24. package/lib/backup/manifest.js +282 -282
  25. package/lib/break-glass.js +1338 -1338
  26. package/lib/bundler.js +441 -441
  27. package/lib/cache-redis.js +256 -256
  28. package/lib/cache.js +1206 -1206
  29. package/lib/canonical-json.js +115 -115
  30. package/lib/chain-writer.js +234 -234
  31. package/lib/cli-helpers.js +206 -206
  32. package/lib/cli.js +2334 -2334
  33. package/lib/cluster-provider-db.js +317 -317
  34. package/lib/cluster-storage.js +226 -226
  35. package/lib/cluster.js +703 -703
  36. package/lib/config-drift.js +301 -301
  37. package/lib/consent.js +222 -222
  38. package/lib/constants.js +191 -191
  39. package/lib/cookies.js +350 -315
  40. package/lib/credential-hash.js +322 -322
  41. package/lib/crypto.js +266 -266
  42. package/lib/csv.js +275 -275
  43. package/lib/db-declare-row-policy.js +267 -267
  44. package/lib/db-declare-view.js +420 -420
  45. package/lib/db-query.js +406 -406
  46. package/lib/db-schema.js +319 -319
  47. package/lib/db.js +1288 -1288
  48. package/lib/deprecate.js +222 -222
  49. package/lib/dev.js +335 -335
  50. package/lib/dual-control.js +473 -473
  51. package/lib/error-page.js +420 -420
  52. package/lib/external-db-migrate.js +441 -441
  53. package/lib/external-db.js +1061 -1061
  54. package/lib/file-type.js +273 -273
  55. package/lib/forms.js +422 -422
  56. package/lib/framework-error.js +293 -293
  57. package/lib/framework-schema.js +717 -717
  58. package/lib/handlers.js +350 -350
  59. package/lib/http-client-cookie-jar.js +508 -508
  60. package/lib/http-client.js +1195 -1195
  61. package/lib/i18n.js +878 -878
  62. package/lib/jobs.js +185 -185
  63. package/lib/log-stream-cloudwatch.js +369 -369
  64. package/lib/log-stream-local.js +146 -146
  65. package/lib/log-stream-otlp-grpc.js +410 -410
  66. package/lib/log-stream-otlp.js +286 -286
  67. package/lib/log-stream-syslog.js +302 -302
  68. package/lib/log-stream-webhook.js +199 -199
  69. package/lib/log-stream.js +330 -330
  70. package/lib/log.js +500 -500
  71. package/lib/mail-bounce.js +528 -528
  72. package/lib/mail-dkim.js +369 -369
  73. package/lib/mail.js +981 -981
  74. package/lib/metrics.js +683 -683
  75. package/lib/middleware/api-encrypt.js +936 -936
  76. package/lib/middleware/attach-user.js +157 -157
  77. package/lib/middleware/bearer-auth.js +152 -0
  78. package/lib/middleware/body-parser.js +1170 -1170
  79. package/lib/middleware/bot-guard.js +178 -178
  80. package/lib/middleware/compression.js +452 -452
  81. package/lib/middleware/cors.js +314 -314
  82. package/lib/middleware/csp-nonce.js +348 -348
  83. package/lib/middleware/csrf-protect.js +399 -316
  84. package/lib/middleware/db-role-for.js +264 -264
  85. package/lib/middleware/fetch-metadata.js +129 -0
  86. package/lib/middleware/health.js +392 -392
  87. package/lib/middleware/index.js +85 -79
  88. package/lib/middleware/rate-limit.js +358 -358
  89. package/lib/middleware/request-id.js +61 -61
  90. package/lib/middleware/request-log.js +168 -168
  91. package/lib/middleware/require-auth.js +104 -104
  92. package/lib/middleware/security-headers.js +121 -116
  93. package/lib/middleware/sse.js +166 -166
  94. package/lib/migrations.js +383 -383
  95. package/lib/mtls-ca.js +518 -518
  96. package/lib/mtls-engine-default.js +481 -481
  97. package/lib/network-dns.js +632 -632
  98. package/lib/network-heartbeat.js +290 -290
  99. package/lib/network-nts.js +574 -574
  100. package/lib/network-proxy.js +265 -265
  101. package/lib/network-tls.js +328 -328
  102. package/lib/network.js +233 -233
  103. package/lib/notify.js +612 -612
  104. package/lib/ntp-check.js +229 -229
  105. package/lib/numeric-bounds.js +111 -111
  106. package/lib/object-store/azure-blob-bucket-ops.js +349 -349
  107. package/lib/object-store/azure-blob.js +488 -488
  108. package/lib/object-store/gcs-bucket-ops.js +351 -351
  109. package/lib/object-store/gcs.js +519 -519
  110. package/lib/object-store/http-put.js +153 -153
  111. package/lib/object-store/index.js +197 -197
  112. package/lib/object-store/sigv4-bucket-ops.js +1092 -1092
  113. package/lib/object-store/sigv4.js +903 -903
  114. package/lib/observability.js +151 -151
  115. package/lib/otel-export.js +269 -269
  116. package/lib/pagination.js +464 -464
  117. package/lib/parsers/index.js +80 -80
  118. package/lib/parsers/safe-env.js +642 -642
  119. package/lib/parsers/safe-ini.js +292 -292
  120. package/lib/parsers/safe-toml.js +784 -784
  121. package/lib/parsers/safe-xml.js +390 -390
  122. package/lib/parsers/safe-yaml.js +1015 -1015
  123. package/lib/permissions.js +708 -708
  124. package/lib/pqc-agent.js +87 -87
  125. package/lib/pqc-gate.js +279 -279
  126. package/lib/protobuf-encoder.js +190 -190
  127. package/lib/protocol-dispatcher.js +161 -161
  128. package/lib/pubsub-redis.js +167 -167
  129. package/lib/pubsub.js +429 -429
  130. package/lib/queue-local.js +476 -476
  131. package/lib/queue-redis.js +745 -745
  132. package/lib/queue-sqs.js +319 -319
  133. package/lib/queue.js +695 -695
  134. package/lib/redis-client.js +519 -519
  135. package/lib/request-helpers.js +340 -340
  136. package/lib/restore-bundle.js +237 -237
  137. package/lib/restore-rollback.js +259 -259
  138. package/lib/restore.js +409 -409
  139. package/lib/retry.js +376 -376
  140. package/lib/router.js +748 -748
  141. package/lib/safe-async.js +735 -735
  142. package/lib/safe-buffer.js +237 -237
  143. package/lib/safe-json.js +541 -541
  144. package/lib/safe-schema.js +1266 -1266
  145. package/lib/safe-url.js +159 -159
  146. package/lib/scheduler.js +706 -706
  147. package/lib/security-assert.js +373 -373
  148. package/lib/seeders.js +618 -618
  149. package/lib/session.js +535 -478
  150. package/lib/slug.js +269 -269
  151. package/lib/ssrf-guard.js +401 -401
  152. package/lib/static.js +7 -5
  153. package/lib/storage.js +471 -471
  154. package/lib/subject.js +281 -281
  155. package/lib/template.js +791 -791
  156. package/lib/testing.js +798 -798
  157. package/lib/time.js +310 -310
  158. package/lib/totp.js +302 -302
  159. package/lib/tracing.js +494 -494
  160. package/lib/uuid.js +132 -132
  161. package/lib/validate-opts.js +340 -340
  162. package/lib/vault/index.js +308 -308
  163. package/lib/vault/rotate.js +784 -784
  164. package/lib/vault/wrap.js +296 -296
  165. package/lib/vendor/noble-ciphers.cjs +9 -9
  166. package/lib/webhook.js +595 -595
  167. package/lib/websocket.js +1048 -1048
  168. package/package.json +77 -77
  169. package/sbom.cyclonedx.json +7 -7
@@ -1,292 +1,292 @@
1
- "use strict";
2
- /**
3
- * INI parser — same security defaults as the framework's other parsers.
4
- *
5
- * INI is the Windows config-file format (also used by systemd unit
6
- * files, .gitconfig, php.ini, tox.ini, and a long tail of operator
7
- * tooling). The format has no formal spec — we implement the
8
- * widely-compatible subset:
9
- *
10
- * - Sections: [section-name] -> object key
11
- * - Subsections: [parent.child] / [parent "child"] -> nested object
12
- * - Key-value: key = value / key: value
13
- * - Comments: ; or # at the start of a line, or after a value
14
- * - Quoted values: "double" / 'single' (escapes: \\ \" \' \n \t)
15
- * - Booleans: true/false/yes/no/on/off (case-insensitive)
16
- * - Numbers: decimal integers + floats; hex (0xABCD)
17
- *
18
- * Security defaults:
19
- * - maxBytes: 1 MiB (operator override via opts.maxBytes)
20
- * - maxSections: 500 (depth + breadth limit)
21
- * - maxKeysPerSection: 1000
22
- * - maxValueBytes: 64 KiB
23
- * - prototype-pollution: keys named __proto__, constructor, prototype
24
- * are rejected (would otherwise let an attacker poison Object.prototype
25
- * when a downstream consumer uses bracket access)
26
- * - Duplicate-key policy: opts.onDuplicate = "throw" (default) | "first" | "last".
27
- * Silent overwrite (the bare-INI default) is OFF — operators almost
28
- * never want a config error to silently shadow earlier values.
29
- *
30
- * Public API:
31
- * parsers.ini.parse(input, opts?) -> object
32
- * parsers.ini.IniSafeError (with .code matching ini/...)
33
- *
34
- * Input validation throws at parse time — every malformed input
35
- * surfaces immediately, never silently coerces to a usable shape.
36
- */
37
-
38
- var C = require("../constants");
39
- var numericBounds = require("../numeric-bounds");
40
- var { defineClass } = require("../framework-error");
41
-
42
- var IniSafeError = defineClass("IniSafeError", { alwaysPermanent: true });
43
-
44
- // parseInt radix — named so the call site doesn't carry a bare 16
45
- // integer literal that reads as a byte count.
46
- var RADIX_HEX = 0x10;
47
-
48
- var DEFAULT_MAX_BYTES = C.BYTES.mib(1);
49
- var DEFAULT_MAX_SECTIONS = 500;
50
- var DEFAULT_MAX_KEYS_SECTION = 1_000;
51
- var DEFAULT_MAX_VALUE_BYTES = C.BYTES.kib(64);
52
-
53
- var FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
54
-
55
- var TRUE_VALUES = new Set(["true", "yes", "on"]);
56
- var FALSE_VALUES = new Set(["false", "no", "off"]);
57
-
58
- function _err(code, message) { return new IniSafeError(code, message); }
59
-
60
- function _stripComment(line) {
61
- var inSingle = false, inDouble = false, escape = false;
62
- for (var i = 0; i < line.length; i++) {
63
- var c = line.charAt(i);
64
- if (escape) { escape = false; continue; }
65
- if (c === "\\" && (inSingle || inDouble)) { escape = true; continue; }
66
- if (c === "\"" && !inSingle) { inDouble = !inDouble; continue; }
67
- if (c === "'" && !inDouble) { inSingle = !inSingle; continue; }
68
- if (!inSingle && !inDouble && (c === ";" || c === "#")) {
69
- if (i === 0 || /\s/.test(line.charAt(i - 1))) {
70
- return line.slice(0, i);
71
- }
72
- }
73
- }
74
- return line;
75
- }
76
-
77
- function _unquote(raw) {
78
- var s = raw.trim();
79
- if (s.length === 0) return s;
80
- var first = s.charAt(0), last = s.charAt(s.length - 1);
81
- if ((first === "\"" && last === "\"") || (first === "'" && last === "'")) {
82
- if (s.length < 2) {
83
- throw _err("ini/bad-quote", "unbalanced quote in value: " + JSON.stringify(s));
84
- }
85
- var inner = s.slice(1, -1);
86
- var out = "";
87
- var i = 0;
88
- while (i < inner.length) {
89
- var c = inner.charAt(i);
90
- if (c === "\\" && i + 1 < inner.length) {
91
- var next = inner.charAt(i + 1);
92
- if (next === "\\") out += "\\";
93
- else if (next === "n") out += "\n";
94
- else if (next === "t") out += "\t";
95
- else if (next === "r") out += "\r";
96
- else if (next === "\"") out += "\"";
97
- else if (next === "'") out += "'";
98
- else throw _err("ini/bad-escape", "unknown escape sequence \\" + next);
99
- i += 2;
100
- } else {
101
- out += c;
102
- i += 1;
103
- }
104
- }
105
- return out;
106
- }
107
- return s;
108
- }
109
-
110
- function _coerceValue(raw) {
111
- if (raw.length === 0) return raw;
112
- var first = raw.charAt(0);
113
- if (first === "\"" || first === "'") return _unquote(raw);
114
- var lower = raw.toLowerCase();
115
- if (TRUE_VALUES.has(lower)) return true;
116
- if (FALSE_VALUES.has(lower)) return false;
117
- if (/^0x[0-9a-f]+$/i.test(raw)) {
118
- var hex = parseInt(raw, RADIX_HEX);
119
- if (!Number.isSafeInteger(hex)) {
120
- throw _err("ini/value-out-of-range", "hex integer exceeds safe-integer range: " + raw);
121
- }
122
- return hex;
123
- }
124
- if (/^-?\d+$/.test(raw)) {
125
- var n = Number(raw);
126
- if (!Number.isSafeInteger(n)) {
127
- throw _err("ini/value-out-of-range", "integer exceeds safe-integer range: " + raw);
128
- }
129
- return n;
130
- }
131
- if (/^-?\d+\.\d+([eE][+-]?\d+)?$/.test(raw) || /^-?\d+[eE][+-]?\d+$/.test(raw)) {
132
- return Number(raw);
133
- }
134
- return _unquote(raw);
135
- }
136
-
137
- function _validateKey(name) {
138
- if (FORBIDDEN_KEYS.has(name)) {
139
- throw _err("ini/forbidden-key", "key '" + name + "' is reserved (prototype pollution defense)");
140
- }
141
- }
142
-
143
- function _ensureSection(root, sectionPath) {
144
- if (sectionPath.length === 0) return root;
145
- var node = root;
146
- for (var i = 0; i < sectionPath.length; i++) {
147
- var seg = sectionPath[i];
148
- _validateKey(seg);
149
- if (Object.prototype.hasOwnProperty.call(node, seg)) {
150
- var existing = node[seg];
151
- if (typeof existing !== "object" || existing === null || Array.isArray(existing)) {
152
- throw _err("ini/section-conflict",
153
- "section path [" + sectionPath.join(".") + "] collides with existing scalar at '" + seg + "'");
154
- }
155
- node = existing;
156
- } else {
157
- var child = {};
158
- node[seg] = child;
159
- node = child;
160
- }
161
- }
162
- return node;
163
- }
164
-
165
- function _parseSectionHeader(line) {
166
- var inner = line.slice(1, line.lastIndexOf("]")).trim();
167
- if (inner.length === 0) {
168
- throw _err("ini/empty-section", "section header [] has no name");
169
- }
170
- var quotedMatch = /^([A-Za-z0-9._-]+)\s+"([^"\\]*(?:\\.[^"\\]*)*)"$/.exec(inner);
171
- if (quotedMatch) {
172
- return [quotedMatch[1], quotedMatch[2]];
173
- }
174
- var parts = inner.split(".");
175
- for (var i = 0; i < parts.length; i++) {
176
- if (parts[i].length === 0) {
177
- throw _err("ini/bad-section", "section name has empty segment: " + JSON.stringify(inner));
178
- }
179
- if (!/^[A-Za-z0-9_-]+$/.test(parts[i])) {
180
- throw _err("ini/bad-section",
181
- "section segment must match [A-Za-z0-9_-]+ (got " + JSON.stringify(parts[i]) + ")");
182
- }
183
- }
184
- return parts;
185
- }
186
-
187
- function parse(input, opts) {
188
- opts = opts || {};
189
- // Validate operator-supplied numeric opts via lib/numeric-bounds —
190
- // Infinity / NaN / negative / non-integer all bypass `|| DEFAULT_*`
191
- // (Infinity is truthy) and silently lift the DoS cap they were meant
192
- // to enforce.
193
- var _numericOpts = ["maxBytes", "maxSections", "maxKeysPerSection", "maxValueBytes"];
194
- for (var _ni = 0; _ni < _numericOpts.length; _ni++) {
195
- var _name = _numericOpts[_ni];
196
- if (opts[_name] !== undefined && !numericBounds.isPositiveFiniteInt(opts[_name])) {
197
- throw _err("ini/bad-opt",
198
- "ini.parse: " + _name + " must be a positive finite integer; got " +
199
- numericBounds.shape(opts[_name]));
200
- }
201
- }
202
- var maxBytes = opts.maxBytes !== undefined ? opts.maxBytes : DEFAULT_MAX_BYTES;
203
- var maxSections = opts.maxSections !== undefined ? opts.maxSections : DEFAULT_MAX_SECTIONS;
204
- var maxKeysPerSect = opts.maxKeysPerSection !== undefined ? opts.maxKeysPerSection : DEFAULT_MAX_KEYS_SECTION;
205
- var maxValueBytes = opts.maxValueBytes !== undefined ? opts.maxValueBytes : DEFAULT_MAX_VALUE_BYTES;
206
- var onDuplicate = opts.onDuplicate || "throw";
207
-
208
- if (typeof input !== "string") {
209
- throw _err("ini/bad-input", "ini.parse: input must be a string, got " + typeof input);
210
- }
211
- if (Buffer.byteLength(input, "utf8") > maxBytes) {
212
- throw _err("ini/too-large",
213
- "ini.parse: input exceeds " + maxBytes + " bytes");
214
- }
215
- if (onDuplicate !== "throw" && onDuplicate !== "first" && onDuplicate !== "last") {
216
- throw _err("ini/bad-opt",
217
- "ini.parse: onDuplicate must be 'throw' | 'first' | 'last', got " + JSON.stringify(onDuplicate));
218
- }
219
-
220
- var root = {};
221
- var currentSectionPath = [];
222
- var currentSection = root;
223
- var sectionCount = 0;
224
- var keysInCurrentSection = 0;
225
-
226
- var lines = input.split(/\r?\n/);
227
- for (var li = 0; li < lines.length; li++) {
228
- var raw = lines[li];
229
- var stripped = _stripComment(raw).trim();
230
- if (stripped.length === 0) continue;
231
-
232
- if (stripped.charAt(0) === "[") {
233
- if (stripped.charAt(stripped.length - 1) !== "]") {
234
- throw _err("ini/bad-section", "section header at line " + (li + 1) + " missing closing ']'");
235
- }
236
- sectionCount += 1;
237
- if (sectionCount > maxSections) {
238
- throw _err("ini/too-many-sections",
239
- "ini.parse: section count exceeds " + maxSections);
240
- }
241
- currentSectionPath = _parseSectionHeader(stripped);
242
- currentSection = _ensureSection(root, currentSectionPath);
243
- keysInCurrentSection = 0;
244
- continue;
245
- }
246
-
247
- var eqIdx = stripped.indexOf("=");
248
- var coIdx = stripped.indexOf(":");
249
- var sepIdx;
250
- if (eqIdx === -1) sepIdx = coIdx;
251
- else if (coIdx === -1) sepIdx = eqIdx;
252
- else sepIdx = Math.min(eqIdx, coIdx);
253
- if (sepIdx === -1) {
254
- throw _err("ini/bad-line",
255
- "line " + (li + 1) + " is neither blank nor key=value: " + JSON.stringify(stripped));
256
- }
257
-
258
- var key = stripped.slice(0, sepIdx).trim();
259
- var valueRaw = stripped.slice(sepIdx + 1).trim();
260
- if (key.length === 0) {
261
- throw _err("ini/empty-key", "line " + (li + 1) + " has empty key");
262
- }
263
- _validateKey(key);
264
- if (Buffer.byteLength(valueRaw, "utf8") > maxValueBytes) {
265
- throw _err("ini/value-too-large",
266
- "line " + (li + 1) + " value exceeds " + maxValueBytes + " bytes");
267
- }
268
- keysInCurrentSection += 1;
269
- if (keysInCurrentSection > maxKeysPerSect) {
270
- throw _err("ini/too-many-keys",
271
- "section [" + currentSectionPath.join(".") + "] exceeds " + maxKeysPerSect + " keys");
272
- }
273
- var value = _coerceValue(valueRaw);
274
-
275
- if (Object.prototype.hasOwnProperty.call(currentSection, key)) {
276
- if (onDuplicate === "throw") {
277
- throw _err("ini/duplicate-key",
278
- "section [" + currentSectionPath.join(".") + "] redefines key '" + key + "' " +
279
- "(opt onDuplicate:'first' or 'last' to allow)");
280
- }
281
- if (onDuplicate === "first") continue;
282
- }
283
- currentSection[key] = value;
284
- }
285
-
286
- return root;
287
- }
288
-
289
- module.exports = {
290
- parse: parse,
291
- IniSafeError: IniSafeError,
292
- };
1
+ "use strict";
2
+ /**
3
+ * INI parser — same security defaults as the framework's other parsers.
4
+ *
5
+ * INI is the Windows config-file format (also used by systemd unit
6
+ * files, .gitconfig, php.ini, tox.ini, and a long tail of operator
7
+ * tooling). The format has no formal spec — we implement the
8
+ * widely-compatible subset:
9
+ *
10
+ * - Sections: [section-name] -> object key
11
+ * - Subsections: [parent.child] / [parent "child"] -> nested object
12
+ * - Key-value: key = value / key: value
13
+ * - Comments: ; or # at the start of a line, or after a value
14
+ * - Quoted values: "double" / 'single' (escapes: \\ \" \' \n \t)
15
+ * - Booleans: true/false/yes/no/on/off (case-insensitive)
16
+ * - Numbers: decimal integers + floats; hex (0xABCD)
17
+ *
18
+ * Security defaults:
19
+ * - maxBytes: 1 MiB (operator override via opts.maxBytes)
20
+ * - maxSections: 500 (depth + breadth limit)
21
+ * - maxKeysPerSection: 1000
22
+ * - maxValueBytes: 64 KiB
23
+ * - prototype-pollution: keys named __proto__, constructor, prototype
24
+ * are rejected (would otherwise let an attacker poison Object.prototype
25
+ * when a downstream consumer uses bracket access)
26
+ * - Duplicate-key policy: opts.onDuplicate = "throw" (default) | "first" | "last".
27
+ * Silent overwrite (the bare-INI default) is OFF — operators almost
28
+ * never want a config error to silently shadow earlier values.
29
+ *
30
+ * Public API:
31
+ * parsers.ini.parse(input, opts?) -> object
32
+ * parsers.ini.IniSafeError (with .code matching ini/...)
33
+ *
34
+ * Input validation throws at parse time — every malformed input
35
+ * surfaces immediately, never silently coerces to a usable shape.
36
+ */
37
+
38
+ var C = require("../constants");
39
+ var numericBounds = require("../numeric-bounds");
40
+ var { defineClass } = require("../framework-error");
41
+
42
+ var IniSafeError = defineClass("IniSafeError", { alwaysPermanent: true });
43
+
44
+ // parseInt radix — named so the call site doesn't carry a bare 16
45
+ // integer literal that reads as a byte count.
46
+ var RADIX_HEX = 0x10;
47
+
48
+ var DEFAULT_MAX_BYTES = C.BYTES.mib(1);
49
+ var DEFAULT_MAX_SECTIONS = 500;
50
+ var DEFAULT_MAX_KEYS_SECTION = 1_000;
51
+ var DEFAULT_MAX_VALUE_BYTES = C.BYTES.kib(64);
52
+
53
+ var FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
54
+
55
+ var TRUE_VALUES = new Set(["true", "yes", "on"]);
56
+ var FALSE_VALUES = new Set(["false", "no", "off"]);
57
+
58
+ function _err(code, message) { return new IniSafeError(code, message); }
59
+
60
+ function _stripComment(line) {
61
+ var inSingle = false, inDouble = false, escape = false;
62
+ for (var i = 0; i < line.length; i++) {
63
+ var c = line.charAt(i);
64
+ if (escape) { escape = false; continue; }
65
+ if (c === "\\" && (inSingle || inDouble)) { escape = true; continue; }
66
+ if (c === "\"" && !inSingle) { inDouble = !inDouble; continue; }
67
+ if (c === "'" && !inDouble) { inSingle = !inSingle; continue; }
68
+ if (!inSingle && !inDouble && (c === ";" || c === "#")) {
69
+ if (i === 0 || /\s/.test(line.charAt(i - 1))) {
70
+ return line.slice(0, i);
71
+ }
72
+ }
73
+ }
74
+ return line;
75
+ }
76
+
77
+ function _unquote(raw) {
78
+ var s = raw.trim();
79
+ if (s.length === 0) return s;
80
+ var first = s.charAt(0), last = s.charAt(s.length - 1);
81
+ if ((first === "\"" && last === "\"") || (first === "'" && last === "'")) {
82
+ if (s.length < 2) {
83
+ throw _err("ini/bad-quote", "unbalanced quote in value: " + JSON.stringify(s));
84
+ }
85
+ var inner = s.slice(1, -1);
86
+ var out = "";
87
+ var i = 0;
88
+ while (i < inner.length) {
89
+ var c = inner.charAt(i);
90
+ if (c === "\\" && i + 1 < inner.length) {
91
+ var next = inner.charAt(i + 1);
92
+ if (next === "\\") out += "\\";
93
+ else if (next === "n") out += "\n";
94
+ else if (next === "t") out += "\t";
95
+ else if (next === "r") out += "\r";
96
+ else if (next === "\"") out += "\"";
97
+ else if (next === "'") out += "'";
98
+ else throw _err("ini/bad-escape", "unknown escape sequence \\" + next);
99
+ i += 2;
100
+ } else {
101
+ out += c;
102
+ i += 1;
103
+ }
104
+ }
105
+ return out;
106
+ }
107
+ return s;
108
+ }
109
+
110
+ function _coerceValue(raw) {
111
+ if (raw.length === 0) return raw;
112
+ var first = raw.charAt(0);
113
+ if (first === "\"" || first === "'") return _unquote(raw);
114
+ var lower = raw.toLowerCase();
115
+ if (TRUE_VALUES.has(lower)) return true;
116
+ if (FALSE_VALUES.has(lower)) return false;
117
+ if (/^0x[0-9a-f]+$/i.test(raw)) {
118
+ var hex = parseInt(raw, RADIX_HEX);
119
+ if (!Number.isSafeInteger(hex)) {
120
+ throw _err("ini/value-out-of-range", "hex integer exceeds safe-integer range: " + raw);
121
+ }
122
+ return hex;
123
+ }
124
+ if (/^-?\d+$/.test(raw)) {
125
+ var n = Number(raw);
126
+ if (!Number.isSafeInteger(n)) {
127
+ throw _err("ini/value-out-of-range", "integer exceeds safe-integer range: " + raw);
128
+ }
129
+ return n;
130
+ }
131
+ if (/^-?\d+\.\d+([eE][+-]?\d+)?$/.test(raw) || /^-?\d+[eE][+-]?\d+$/.test(raw)) {
132
+ return Number(raw);
133
+ }
134
+ return _unquote(raw);
135
+ }
136
+
137
+ function _validateKey(name) {
138
+ if (FORBIDDEN_KEYS.has(name)) {
139
+ throw _err("ini/forbidden-key", "key '" + name + "' is reserved (prototype pollution defense)");
140
+ }
141
+ }
142
+
143
+ function _ensureSection(root, sectionPath) {
144
+ if (sectionPath.length === 0) return root;
145
+ var node = root;
146
+ for (var i = 0; i < sectionPath.length; i++) {
147
+ var seg = sectionPath[i];
148
+ _validateKey(seg);
149
+ if (Object.prototype.hasOwnProperty.call(node, seg)) {
150
+ var existing = node[seg];
151
+ if (typeof existing !== "object" || existing === null || Array.isArray(existing)) {
152
+ throw _err("ini/section-conflict",
153
+ "section path [" + sectionPath.join(".") + "] collides with existing scalar at '" + seg + "'");
154
+ }
155
+ node = existing;
156
+ } else {
157
+ var child = {};
158
+ node[seg] = child;
159
+ node = child;
160
+ }
161
+ }
162
+ return node;
163
+ }
164
+
165
+ function _parseSectionHeader(line) {
166
+ var inner = line.slice(1, line.lastIndexOf("]")).trim();
167
+ if (inner.length === 0) {
168
+ throw _err("ini/empty-section", "section header [] has no name");
169
+ }
170
+ var quotedMatch = /^([A-Za-z0-9._-]+)\s+"([^"\\]*(?:\\.[^"\\]*)*)"$/.exec(inner);
171
+ if (quotedMatch) {
172
+ return [quotedMatch[1], quotedMatch[2]];
173
+ }
174
+ var parts = inner.split(".");
175
+ for (var i = 0; i < parts.length; i++) {
176
+ if (parts[i].length === 0) {
177
+ throw _err("ini/bad-section", "section name has empty segment: " + JSON.stringify(inner));
178
+ }
179
+ if (!/^[A-Za-z0-9_-]+$/.test(parts[i])) {
180
+ throw _err("ini/bad-section",
181
+ "section segment must match [A-Za-z0-9_-]+ (got " + JSON.stringify(parts[i]) + ")");
182
+ }
183
+ }
184
+ return parts;
185
+ }
186
+
187
+ function parse(input, opts) {
188
+ opts = opts || {};
189
+ // Validate operator-supplied numeric opts via lib/numeric-bounds —
190
+ // Infinity / NaN / negative / non-integer all bypass `|| DEFAULT_*`
191
+ // (Infinity is truthy) and silently lift the DoS cap they were meant
192
+ // to enforce.
193
+ var _numericOpts = ["maxBytes", "maxSections", "maxKeysPerSection", "maxValueBytes"];
194
+ for (var _ni = 0; _ni < _numericOpts.length; _ni++) {
195
+ var _name = _numericOpts[_ni];
196
+ if (opts[_name] !== undefined && !numericBounds.isPositiveFiniteInt(opts[_name])) {
197
+ throw _err("ini/bad-opt",
198
+ "ini.parse: " + _name + " must be a positive finite integer; got " +
199
+ numericBounds.shape(opts[_name]));
200
+ }
201
+ }
202
+ var maxBytes = opts.maxBytes !== undefined ? opts.maxBytes : DEFAULT_MAX_BYTES;
203
+ var maxSections = opts.maxSections !== undefined ? opts.maxSections : DEFAULT_MAX_SECTIONS;
204
+ var maxKeysPerSect = opts.maxKeysPerSection !== undefined ? opts.maxKeysPerSection : DEFAULT_MAX_KEYS_SECTION;
205
+ var maxValueBytes = opts.maxValueBytes !== undefined ? opts.maxValueBytes : DEFAULT_MAX_VALUE_BYTES;
206
+ var onDuplicate = opts.onDuplicate || "throw";
207
+
208
+ if (typeof input !== "string") {
209
+ throw _err("ini/bad-input", "ini.parse: input must be a string, got " + typeof input);
210
+ }
211
+ if (Buffer.byteLength(input, "utf8") > maxBytes) {
212
+ throw _err("ini/too-large",
213
+ "ini.parse: input exceeds " + maxBytes + " bytes");
214
+ }
215
+ if (onDuplicate !== "throw" && onDuplicate !== "first" && onDuplicate !== "last") {
216
+ throw _err("ini/bad-opt",
217
+ "ini.parse: onDuplicate must be 'throw' | 'first' | 'last', got " + JSON.stringify(onDuplicate));
218
+ }
219
+
220
+ var root = {};
221
+ var currentSectionPath = [];
222
+ var currentSection = root;
223
+ var sectionCount = 0;
224
+ var keysInCurrentSection = 0;
225
+
226
+ var lines = input.split(/\r?\n/);
227
+ for (var li = 0; li < lines.length; li++) {
228
+ var raw = lines[li];
229
+ var stripped = _stripComment(raw).trim();
230
+ if (stripped.length === 0) continue;
231
+
232
+ if (stripped.charAt(0) === "[") {
233
+ if (stripped.charAt(stripped.length - 1) !== "]") {
234
+ throw _err("ini/bad-section", "section header at line " + (li + 1) + " missing closing ']'");
235
+ }
236
+ sectionCount += 1;
237
+ if (sectionCount > maxSections) {
238
+ throw _err("ini/too-many-sections",
239
+ "ini.parse: section count exceeds " + maxSections);
240
+ }
241
+ currentSectionPath = _parseSectionHeader(stripped);
242
+ currentSection = _ensureSection(root, currentSectionPath);
243
+ keysInCurrentSection = 0;
244
+ continue;
245
+ }
246
+
247
+ var eqIdx = stripped.indexOf("=");
248
+ var coIdx = stripped.indexOf(":");
249
+ var sepIdx;
250
+ if (eqIdx === -1) sepIdx = coIdx;
251
+ else if (coIdx === -1) sepIdx = eqIdx;
252
+ else sepIdx = Math.min(eqIdx, coIdx);
253
+ if (sepIdx === -1) {
254
+ throw _err("ini/bad-line",
255
+ "line " + (li + 1) + " is neither blank nor key=value: " + JSON.stringify(stripped));
256
+ }
257
+
258
+ var key = stripped.slice(0, sepIdx).trim();
259
+ var valueRaw = stripped.slice(sepIdx + 1).trim();
260
+ if (key.length === 0) {
261
+ throw _err("ini/empty-key", "line " + (li + 1) + " has empty key");
262
+ }
263
+ _validateKey(key);
264
+ if (Buffer.byteLength(valueRaw, "utf8") > maxValueBytes) {
265
+ throw _err("ini/value-too-large",
266
+ "line " + (li + 1) + " value exceeds " + maxValueBytes + " bytes");
267
+ }
268
+ keysInCurrentSection += 1;
269
+ if (keysInCurrentSection > maxKeysPerSect) {
270
+ throw _err("ini/too-many-keys",
271
+ "section [" + currentSectionPath.join(".") + "] exceeds " + maxKeysPerSect + " keys");
272
+ }
273
+ var value = _coerceValue(valueRaw);
274
+
275
+ if (Object.prototype.hasOwnProperty.call(currentSection, key)) {
276
+ if (onDuplicate === "throw") {
277
+ throw _err("ini/duplicate-key",
278
+ "section [" + currentSectionPath.join(".") + "] redefines key '" + key + "' " +
279
+ "(opt onDuplicate:'first' or 'last' to allow)");
280
+ }
281
+ if (onDuplicate === "first") continue;
282
+ }
283
+ currentSection[key] = value;
284
+ }
285
+
286
+ return root;
287
+ }
288
+
289
+ module.exports = {
290
+ parse: parse,
291
+ IniSafeError: IniSafeError,
292
+ };