@blamejs/core 0.13.23 → 0.13.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4 -0
- package/lib/agent-idempotency.js +50 -10
- package/lib/agent-orchestrator.js +58 -5
- package/lib/agent-saga.js +8 -4
- package/lib/agent-tenant.js +56 -4
- package/lib/agent-trace.js +4 -3
- package/lib/guard-archive.js +2 -2
- package/lib/guard-auth.js +5 -5
- package/lib/guard-cidr.js +4 -4
- package/lib/guard-csv.js +6 -6
- package/lib/guard-domain.js +4 -4
- package/lib/guard-email.js +6 -5
- package/lib/guard-filename.js +4 -4
- package/lib/guard-graphql.js +5 -5
- package/lib/guard-html.js +2 -2
- package/lib/guard-image.js +1 -1
- package/lib/guard-json.js +5 -5
- package/lib/guard-jsonpath.js +4 -4
- package/lib/guard-jwt.js +5 -5
- package/lib/guard-markdown.js +6 -6
- package/lib/guard-mime.js +6 -6
- package/lib/guard-oauth.js +5 -5
- package/lib/guard-pdf.js +1 -1
- package/lib/guard-regex.js +4 -4
- package/lib/guard-shell.js +4 -4
- package/lib/guard-svg.js +5 -5
- package/lib/guard-template.js +4 -4
- package/lib/guard-time.js +6 -6
- package/lib/guard-uuid.js +6 -6
- package/lib/guard-xml.js +4 -4
- package/lib/guard-yaml.js +5 -5
- package/lib/vault/index.js +1 -0
- package/package.json +1 -1
- package/sbom.cdx.json +6 -6
package/lib/guard-graphql.js
CHANGED
|
@@ -458,7 +458,7 @@ function _detectIssues(req, opts) {
|
|
|
458
458
|
* @related b.guardGraphql.sanitize, b.guardGraphql.gate
|
|
459
459
|
*
|
|
460
460
|
* Apply the full guard-graphql threat catalog to a request bundle
|
|
461
|
-
* (or batch array). Returns `{ ok, issues
|
|
461
|
+
* (or batch array). Returns `{ ok, issues }` per
|
|
462
462
|
* `gateContract.aggregateIssues`. Detected classes include
|
|
463
463
|
* `query-missing`, `query-cap`, `variables-cap`, `request-cap`,
|
|
464
464
|
* `batch-size`, `introspection`, `persisted-query-missing`,
|
|
@@ -469,7 +469,7 @@ function _detectIssues(req, opts) {
|
|
|
469
469
|
*
|
|
470
470
|
* @opts
|
|
471
471
|
* profile: "strict"|"balanced"|"permissive",
|
|
472
|
-
*
|
|
472
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
473
473
|
* introspectionPolicy: "reject"|"audit"|"allow",
|
|
474
474
|
* persistedQueryPolicy: "require"|"audit"|"allow",
|
|
475
475
|
* operationNamePolicy: "reject"|"audit"|"allow",
|
|
@@ -528,7 +528,7 @@ function validate(input, opts) {
|
|
|
528
528
|
*
|
|
529
529
|
* @opts
|
|
530
530
|
* profile: "strict"|"balanced"|"permissive",
|
|
531
|
-
*
|
|
531
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
532
532
|
* ...: every guardGraphql.validate opt is honored,
|
|
533
533
|
*
|
|
534
534
|
* @example
|
|
@@ -573,13 +573,13 @@ function sanitize(input, opts) {
|
|
|
573
573
|
*
|
|
574
574
|
* @opts
|
|
575
575
|
* profile: "strict"|"balanced"|"permissive",
|
|
576
|
-
*
|
|
576
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
577
577
|
* name: string, // gate label for audit trails
|
|
578
578
|
* ...: every guardGraphql.validate opt is honored,
|
|
579
579
|
*
|
|
580
580
|
* @example
|
|
581
581
|
* var gqlGate = b.guardGraphql.gate({ profile: "strict" });
|
|
582
|
-
* var rv = await gqlGate.
|
|
582
|
+
* var rv = await gqlGate.check({
|
|
583
583
|
* graphqlRequest: {
|
|
584
584
|
* query: "{ a:me { id } b:me { id } c:me { id } d:me { id } " +
|
|
585
585
|
* "e:me { id } f:me { id } g:me { id } h:me { id } " +
|
package/lib/guard-html.js
CHANGED
|
@@ -1030,7 +1030,7 @@ function sanitize(input, opts) {
|
|
|
1030
1030
|
* Returns a guard descriptor that plugs into the framework's
|
|
1031
1031
|
* content-safety wiring (`b.fileUpload.contentSafety` /
|
|
1032
1032
|
* `b.staticServe.contentSafety` / `b.guardAll`). The descriptor's
|
|
1033
|
-
* `
|
|
1033
|
+
* `check(ctx)` resolves to one of four actions: `serve` (no
|
|
1034
1034
|
* issues), `audit-only` (low-severity issues observed), `sanitize`
|
|
1035
1035
|
* (sanitized buffer attached when no policy is "reject"), or
|
|
1036
1036
|
* `refuse` (critical issue with at least one reject-policy active).
|
|
@@ -1057,7 +1057,7 @@ function sanitize(input, opts) {
|
|
|
1057
1057
|
*
|
|
1058
1058
|
* // Refuse on tag-budget exceeded — strict profile rejects <script>.
|
|
1059
1059
|
* var hostileBuf = Buffer.from("<p>hi</p><script>alert(1)</script>", "utf8");
|
|
1060
|
-
* var rv = await g.
|
|
1060
|
+
* var rv = await g.check({ bytes: hostileBuf, contentType: "text/html" });
|
|
1061
1061
|
* rv.ok; // → false
|
|
1062
1062
|
* rv.action; // → "refuse"
|
|
1063
1063
|
*/
|
package/lib/guard-image.js
CHANGED
|
@@ -421,7 +421,7 @@ function sanitize(input, opts) {
|
|
|
421
421
|
*
|
|
422
422
|
* @opts
|
|
423
423
|
* profile: "strict"|"balanced"|"permissive",
|
|
424
|
-
*
|
|
424
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
425
425
|
* name: string,
|
|
426
426
|
* ...: any validate opt
|
|
427
427
|
*
|
package/lib/guard-json.js
CHANGED
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
*
|
|
60
60
|
* Profiles: `strict` / `balanced` / `permissive`. Compliance
|
|
61
61
|
* postures: `hipaa` / `pci-dss` / `gdpr` / `soc2`. Operators select
|
|
62
|
-
* via `{ profile: "strict" }` or `{
|
|
62
|
+
* via `{ profile: "strict" }` or `{ compliancePosture: "hipaa" }`;
|
|
63
63
|
* postures overlay on top of the profile baseline.
|
|
64
64
|
*
|
|
65
65
|
* Source files MUST be pure ASCII; threat-detection regexes
|
|
@@ -571,7 +571,7 @@ function _stripPollutionTree(value, opts, depth) {
|
|
|
571
571
|
*
|
|
572
572
|
* Inspect `input` (string of JSON source) for the full guard-json
|
|
573
573
|
* threat catalog without committing to a parsed value. Returns
|
|
574
|
-
* `{ ok, issues
|
|
574
|
+
* `{ ok, issues }` where `issues` is the aggregated
|
|
575
575
|
* detector output — every prototype-pollution key, depth/breadth
|
|
576
576
|
* cap hit, duplicate-key smuggle, JSON5-quirk match, BOM placement,
|
|
577
577
|
* unicode threat, and numeric-precision-loss candidate is reported
|
|
@@ -587,7 +587,7 @@ function _stripPollutionTree(value, opts, depth) {
|
|
|
587
587
|
*
|
|
588
588
|
* @opts
|
|
589
589
|
* profile: "strict"|"balanced"|"permissive",
|
|
590
|
-
*
|
|
590
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
591
591
|
* pollutionPolicy: "reject"|"strip"|"audit"|"allow",
|
|
592
592
|
* duplicateKeyPolicy: "reject"|"audit"|"allow",
|
|
593
593
|
* nanInfinityPolicy: "reject"|"audit"|"allow",
|
|
@@ -660,7 +660,7 @@ function validate(input, opts) {
|
|
|
660
660
|
*
|
|
661
661
|
* @opts
|
|
662
662
|
* profile: "strict"|"balanced"|"permissive",
|
|
663
|
-
*
|
|
663
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
664
664
|
* pollutionPolicy: "reject"|"strip"|"audit"|"allow",
|
|
665
665
|
* bomPolicy: "reject"|"strip"|"allow",
|
|
666
666
|
* controlPolicy: "reject"|"strip"|"allow",
|
|
@@ -770,7 +770,7 @@ function _policyKeyForRuleId(ruleId) {
|
|
|
770
770
|
*
|
|
771
771
|
* @opts
|
|
772
772
|
* profile: "strict"|"balanced"|"permissive",
|
|
773
|
-
*
|
|
773
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
774
774
|
* name: string, // gate identity for audit / observability
|
|
775
775
|
*
|
|
776
776
|
* @example
|
package/lib/guard-jsonpath.js
CHANGED
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
* Profiles: `strict` / `balanced` / `permissive`. Compliance
|
|
35
35
|
* postures: `hipaa` / `pci-dss` / `gdpr` / `soc2`. Operators
|
|
36
36
|
* select via `{ profile: "strict" }` or
|
|
37
|
-
* `{
|
|
37
|
+
* `{ compliancePosture: "hipaa" }`; postures overlay on top of the
|
|
38
38
|
* profile baseline. Filter / script / dynamic-hint refusal holds
|
|
39
39
|
* at every profile — the RCE class is never an operator opt-in.
|
|
40
40
|
*
|
|
@@ -257,7 +257,7 @@ function _detectIssues(input, opts) {
|
|
|
257
257
|
*
|
|
258
258
|
* @opts
|
|
259
259
|
* profile: "strict"|"balanced"|"permissive",
|
|
260
|
-
*
|
|
260
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
261
261
|
* bidiPolicy: "reject"|"audit"|"allow",
|
|
262
262
|
* controlPolicy: "reject"|"audit"|"allow",
|
|
263
263
|
* nullBytePolicy: "reject"|"audit"|"allow",
|
|
@@ -308,7 +308,7 @@ function validate(input, opts) {
|
|
|
308
308
|
*
|
|
309
309
|
* @opts
|
|
310
310
|
* profile: "strict"|"balanced"|"permissive",
|
|
311
|
-
*
|
|
311
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
312
312
|
* filterExprPolicy: "reject"|"audit"|"allow",
|
|
313
313
|
* scriptExprPolicy: "reject"|"audit"|"allow",
|
|
314
314
|
* dynamicHintPolicy: "reject"|"audit"|"allow",
|
|
@@ -360,7 +360,7 @@ function sanitize(input, opts) {
|
|
|
360
360
|
*
|
|
361
361
|
* @opts
|
|
362
362
|
* profile: "strict"|"balanced"|"permissive",
|
|
363
|
-
*
|
|
363
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
364
364
|
* name: string, // override gate name in audit emissions
|
|
365
365
|
* filterExprPolicy: "reject"|"audit"|"allow",
|
|
366
366
|
* scriptExprPolicy: "reject"|"audit"|"allow",
|
package/lib/guard-jwt.js
CHANGED
|
@@ -441,7 +441,7 @@ function _detectIssues(input, opts) {
|
|
|
441
441
|
* @related b.guardJwt.sanitize, b.guardJwt.gate
|
|
442
442
|
*
|
|
443
443
|
* Apply the full guard-jwt threat catalog to a JWT compact-
|
|
444
|
-
* serialization string. Returns `{ ok, issues
|
|
444
|
+
* serialization string. Returns `{ ok, issues }` per
|
|
445
445
|
* `gateContract.aggregateIssues`. Detected classes include
|
|
446
446
|
* `alg-none` (always critical), `kid-traversal` (always critical),
|
|
447
447
|
* `alg-not-allowed`, `typ-confusion`, `crit-unknown`, `exp-past`,
|
|
@@ -456,7 +456,7 @@ function _detectIssues(input, opts) {
|
|
|
456
456
|
*
|
|
457
457
|
* @opts
|
|
458
458
|
* profile: "strict"|"balanced"|"permissive",
|
|
459
|
-
*
|
|
459
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
460
460
|
* allowedAlgs: string[],
|
|
461
461
|
* requiredClaims: string[],
|
|
462
462
|
* knownCrit: string[],
|
|
@@ -524,7 +524,7 @@ function validate(input, opts) {
|
|
|
524
524
|
*
|
|
525
525
|
* @opts
|
|
526
526
|
* profile: "strict"|"balanced"|"permissive",
|
|
527
|
-
*
|
|
527
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
528
528
|
* ...: every guardJwt.validate opt is honored,
|
|
529
529
|
*
|
|
530
530
|
* @example
|
|
@@ -573,13 +573,13 @@ function sanitize(input, opts) {
|
|
|
573
573
|
*
|
|
574
574
|
* @opts
|
|
575
575
|
* profile: "strict"|"balanced"|"permissive",
|
|
576
|
-
*
|
|
576
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
577
577
|
* name: string, // gate label for audit trails
|
|
578
578
|
* ...: every guardJwt.validate opt is honored,
|
|
579
579
|
*
|
|
580
580
|
* @example
|
|
581
581
|
* var jwtGate = b.guardJwt.gate({ profile: "strict" });
|
|
582
|
-
* var rv = await jwtGate.
|
|
582
|
+
* var rv = await jwtGate.check({
|
|
583
583
|
* identifier:
|
|
584
584
|
* "eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0." +
|
|
585
585
|
* "eyJzdWIiOiJhdHRhY2tlciJ9.",
|
package/lib/guard-markdown.js
CHANGED
|
@@ -505,7 +505,7 @@ function _detectIssues(input, opts) {
|
|
|
505
505
|
*
|
|
506
506
|
* @opts
|
|
507
507
|
* profile: "strict"|"balanced"|"permissive",
|
|
508
|
-
*
|
|
508
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
509
509
|
* bidiPolicy: "reject"|"strip"|"audit"|"allow",
|
|
510
510
|
* controlPolicy: "reject"|"strip"|"allow",
|
|
511
511
|
* nullBytePolicy: "reject"|"strip"|"allow",
|
|
@@ -568,7 +568,7 @@ function validate(input, opts) {
|
|
|
568
568
|
*
|
|
569
569
|
* @opts
|
|
570
570
|
* profile: "strict"|"balanced"|"permissive",
|
|
571
|
-
*
|
|
571
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
572
572
|
* ...: same shape as b.guardMarkdown.validate opts,
|
|
573
573
|
*
|
|
574
574
|
* @example
|
|
@@ -606,7 +606,7 @@ function sanitize(input, opts) {
|
|
|
606
606
|
* @compliance hipaa, pci-dss, gdpr, soc2
|
|
607
607
|
* @related b.guardMarkdown.validate, b.guardMarkdown.sanitize, b.guardAll.gate, b.staticServe.create
|
|
608
608
|
*
|
|
609
|
-
* Build
|
|
609
|
+
* Build a guard gate whose async `check(ctx)` returns `{ ok, action, issues }`, consumable
|
|
610
610
|
* by `b.guardAll`, `b.staticServe`, `b.fileUpload`, and any host
|
|
611
611
|
* that ingests user-supplied markdown. The gate decodes
|
|
612
612
|
* `ctx.bytes` / `ctx.bodyText`, runs `validate`, and maps
|
|
@@ -617,15 +617,15 @@ function sanitize(input, opts) {
|
|
|
617
617
|
* @opts
|
|
618
618
|
* name: string, // gate label for audit / observability
|
|
619
619
|
* profile: "strict"|"balanced"|"permissive",
|
|
620
|
-
*
|
|
620
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
621
621
|
* ...: same shape as b.guardMarkdown.validate opts,
|
|
622
622
|
*
|
|
623
623
|
* @example
|
|
624
624
|
* var g = b.guardMarkdown.gate({ profile: "strict" });
|
|
625
|
-
* var rv = await g({ bytes: Buffer.from("# hello\n", "utf8") });
|
|
625
|
+
* var rv = await g.check({ bytes: Buffer.from("# hello\n", "utf8") });
|
|
626
626
|
* rv.action; // → "serve"
|
|
627
627
|
*
|
|
628
|
-
* var bad = await g({ bytes: Buffer.from("[x](javascript:1)", "utf8") });
|
|
628
|
+
* var bad = await g.check({ bytes: Buffer.from("[x](javascript:1)", "utf8") });
|
|
629
629
|
* bad.action; // → "refuse"
|
|
630
630
|
*/
|
|
631
631
|
function gate(opts) {
|
package/lib/guard-mime.js
CHANGED
|
@@ -369,7 +369,7 @@ function _detectIssues(input, opts) {
|
|
|
369
369
|
*
|
|
370
370
|
* @opts
|
|
371
371
|
* profile: "strict"|"balanced"|"permissive",
|
|
372
|
-
*
|
|
372
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
373
373
|
* bidiPolicy: "reject"|"strip"|"audit"|"allow",
|
|
374
374
|
* controlPolicy: "reject"|"strip"|"allow",
|
|
375
375
|
* nullBytePolicy: "reject"|"strip"|"allow",
|
|
@@ -423,7 +423,7 @@ function validate(input, opts) {
|
|
|
423
423
|
*
|
|
424
424
|
* @opts
|
|
425
425
|
* profile: "strict"|"balanced"|"permissive",
|
|
426
|
-
*
|
|
426
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
427
427
|
* ...: same shape as b.guardMime.validate opts,
|
|
428
428
|
*
|
|
429
429
|
* @example
|
|
@@ -467,7 +467,7 @@ function sanitize(input, opts) {
|
|
|
467
467
|
* @compliance hipaa, pci-dss, gdpr, soc2
|
|
468
468
|
* @related b.guardMime.validate, b.guardMime.sanitize, b.guardAll.gate
|
|
469
469
|
*
|
|
470
|
-
* Build
|
|
470
|
+
* Build a guard gate whose async `check(ctx)` returns `{ ok, action, issues }`, consumable
|
|
471
471
|
* by `b.guardAll`, `b.staticServe`, `b.fileUpload`, and any other
|
|
472
472
|
* host that integrates the guard contract. The gate reads
|
|
473
473
|
* `ctx.identifier` (or `ctx.mime`), runs `validate`, and maps
|
|
@@ -477,15 +477,15 @@ function sanitize(input, opts) {
|
|
|
477
477
|
* @opts
|
|
478
478
|
* name: string, // gate label for audit / observability
|
|
479
479
|
* profile: "strict"|"balanced"|"permissive",
|
|
480
|
-
*
|
|
480
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
481
481
|
* ...: same shape as b.guardMime.validate opts,
|
|
482
482
|
*
|
|
483
483
|
* @example
|
|
484
484
|
* var g = b.guardMime.gate({ profile: "strict" });
|
|
485
|
-
* var rv = await g({ identifier: "application/json" });
|
|
485
|
+
* var rv = await g.check({ identifier: "application/json" });
|
|
486
486
|
* rv.action; // → "serve"
|
|
487
487
|
*
|
|
488
|
-
* var bad = await g({ identifier: "application/x-msdownload" });
|
|
488
|
+
* var bad = await g.check({ identifier: "application/x-msdownload" });
|
|
489
489
|
* bad.action; // → "refuse"
|
|
490
490
|
*/
|
|
491
491
|
function gate(opts) {
|
package/lib/guard-oauth.js
CHANGED
|
@@ -352,7 +352,7 @@ function _detectIssues(flow, opts) {
|
|
|
352
352
|
* @related b.guardOauth.sanitize, b.guardOauth.gate
|
|
353
353
|
*
|
|
354
354
|
* Apply the full guard-oauth threat catalog to a flow bundle.
|
|
355
|
-
* Returns `{ ok, issues
|
|
355
|
+
* Returns `{ ok, issues }` per
|
|
356
356
|
* `gateContract.aggregateIssues`. Detected classes include
|
|
357
357
|
* `pkce-missing`, `pkce-method` (e.g. plain under require-s256),
|
|
358
358
|
* `state-missing`, `redirect-uri-not-allowed`,
|
|
@@ -365,7 +365,7 @@ function _detectIssues(flow, opts) {
|
|
|
365
365
|
*
|
|
366
366
|
* @opts
|
|
367
367
|
* profile: "strict"|"balanced"|"permissive",
|
|
368
|
-
*
|
|
368
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
369
369
|
* pkcePolicy: "require-s256"|"require-any"|"audit"|"allow",
|
|
370
370
|
* statePolicy: "require"|"audit"|"allow",
|
|
371
371
|
* redirectUriPolicy: "require-exact-allowlist"|"audit"|"allow",
|
|
@@ -427,7 +427,7 @@ function validate(input, opts) {
|
|
|
427
427
|
*
|
|
428
428
|
* @opts
|
|
429
429
|
* profile: "strict"|"balanced"|"permissive",
|
|
430
|
-
*
|
|
430
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
431
431
|
* ...: every guardOauth.validate opt is honored,
|
|
432
432
|
*
|
|
433
433
|
* @example
|
|
@@ -475,7 +475,7 @@ function sanitize(input, opts) {
|
|
|
475
475
|
*
|
|
476
476
|
* @opts
|
|
477
477
|
* profile: "strict"|"balanced"|"permissive",
|
|
478
|
-
*
|
|
478
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
479
479
|
* name: string, // gate label for audit trails
|
|
480
480
|
* ...: every guardOauth.validate opt is honored,
|
|
481
481
|
*
|
|
@@ -484,7 +484,7 @@ function sanitize(input, opts) {
|
|
|
484
484
|
* profile: "strict",
|
|
485
485
|
* allowedRedirectUris: ["https://app.example.com/callback"],
|
|
486
486
|
* });
|
|
487
|
-
* var rv = await oauthGate.
|
|
487
|
+
* var rv = await oauthGate.check({
|
|
488
488
|
* oauthFlow: {
|
|
489
489
|
* response_type: "code",
|
|
490
490
|
* redirect_uri: "https://attacker.example/callback",
|
package/lib/guard-pdf.js
CHANGED
|
@@ -410,7 +410,7 @@ function sanitize(input, opts) {
|
|
|
410
410
|
*
|
|
411
411
|
* @opts
|
|
412
412
|
* profile: "strict"|"balanced"|"permissive",
|
|
413
|
-
*
|
|
413
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
414
414
|
* name: string,
|
|
415
415
|
* ...: any validate opt
|
|
416
416
|
*
|
package/lib/guard-regex.js
CHANGED
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
* Profiles: `strict` / `balanced` / `permissive`. Compliance
|
|
31
31
|
* postures: `hipaa` / `pci-dss` / `gdpr` / `soc2`. Operators
|
|
32
32
|
* select via `{ profile: "strict" }` or
|
|
33
|
-
* `{
|
|
33
|
+
* `{ compliancePosture: "hipaa" }`; postures overlay on top of the
|
|
34
34
|
* profile baseline. Nested-quantifier rejection holds at every
|
|
35
35
|
* profile — the catastrophic class is never an operator opt-in.
|
|
36
36
|
*
|
|
@@ -368,7 +368,7 @@ function _detectNestedExtglob(input, opts, issues) {
|
|
|
368
368
|
*
|
|
369
369
|
* @opts
|
|
370
370
|
* profile: "strict"|"balanced"|"permissive",
|
|
371
|
-
*
|
|
371
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
372
372
|
* bidiPolicy: "reject"|"audit"|"allow",
|
|
373
373
|
* controlPolicy: "reject"|"audit"|"allow",
|
|
374
374
|
* nullBytePolicy: "reject"|"audit"|"allow",
|
|
@@ -422,7 +422,7 @@ function validate(input, opts) {
|
|
|
422
422
|
*
|
|
423
423
|
* @opts
|
|
424
424
|
* profile: "strict"|"balanced"|"permissive",
|
|
425
|
-
*
|
|
425
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
426
426
|
* nestedQuantPolicy: "reject"|"audit"|"allow",
|
|
427
427
|
* alternationQuantPolicy: "reject"|"audit"|"allow",
|
|
428
428
|
* boundedRepeatPolicy: "reject"|"audit"|"allow",
|
|
@@ -477,7 +477,7 @@ function sanitize(input, opts) {
|
|
|
477
477
|
*
|
|
478
478
|
* @opts
|
|
479
479
|
* profile: "strict"|"balanced"|"permissive",
|
|
480
|
-
*
|
|
480
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
481
481
|
* name: string, // override gate name in audit emissions
|
|
482
482
|
* nestedQuantPolicy: "reject"|"audit"|"allow",
|
|
483
483
|
* alternationQuantPolicy: "reject"|"audit"|"allow",
|
package/lib/guard-shell.js
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
*
|
|
29
29
|
* Profiles: `strict` / `balanced` / `permissive`. Compliance
|
|
30
30
|
* postures: `hipaa` / `pci-dss` / `gdpr` / `soc2`. Operators select
|
|
31
|
-
* via `{ profile: "strict" }` or `{
|
|
31
|
+
* via `{ profile: "strict" }` or `{ compliancePosture: "hipaa" }`;
|
|
32
32
|
* postures overlay on top of the profile baseline.
|
|
33
33
|
*
|
|
34
34
|
* Shell args cannot be repaired safely — `sanitize` either passes
|
|
@@ -262,7 +262,7 @@ function _detectIssues(input, opts) {
|
|
|
262
262
|
*
|
|
263
263
|
* @opts
|
|
264
264
|
* profile: "strict"|"balanced"|"permissive",
|
|
265
|
-
*
|
|
265
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
266
266
|
* bidiPolicy: "reject"|"audit"|"allow",
|
|
267
267
|
* controlPolicy: "reject"|"audit"|"allow",
|
|
268
268
|
* nullBytePolicy: "reject"|"audit"|"allow",
|
|
@@ -314,7 +314,7 @@ function validate(input, opts) {
|
|
|
314
314
|
*
|
|
315
315
|
* @opts
|
|
316
316
|
* profile: "strict"|"balanced"|"permissive",
|
|
317
|
-
*
|
|
317
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
318
318
|
* posixMetaPolicy: "reject"|"audit"|"allow",
|
|
319
319
|
* cmdMetaPolicy: "reject"|"audit"|"allow",
|
|
320
320
|
* dollarSubstPolicy: "reject"|"audit"|"allow",
|
|
@@ -369,7 +369,7 @@ function sanitize(input, opts) {
|
|
|
369
369
|
*
|
|
370
370
|
* @opts
|
|
371
371
|
* profile: "strict"|"balanced"|"permissive",
|
|
372
|
-
*
|
|
372
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
373
373
|
* name: string, // override gate name in audit emissions
|
|
374
374
|
* posixMetaPolicy: "reject"|"audit"|"allow",
|
|
375
375
|
* cmdMetaPolicy: "reject"|"audit"|"allow",
|
package/lib/guard-svg.js
CHANGED
|
@@ -1017,9 +1017,9 @@ function sanitize(input, opts) {
|
|
|
1017
1017
|
* @status stable
|
|
1018
1018
|
* @related b.guardSvg.validate, b.guardSvg.sanitize, b.fileUpload, b.staticServe
|
|
1019
1019
|
*
|
|
1020
|
-
* Build a uniform gate over guard-* family contract. Returns
|
|
1021
|
-
* async
|
|
1022
|
-
* sanitized? }` where `action` is `serve` / `audit-only` /
|
|
1020
|
+
* Build a uniform gate over the guard-* family contract. Returns a
|
|
1021
|
+
* gate whose async `check(ctx)` produces a verdict `{ ok, action,
|
|
1022
|
+
* issues?, sanitized? }` where `action` is `serve` / `audit-only` /
|
|
1023
1023
|
* `sanitize` / `refuse`. SVGZ inputs always refuse — operators
|
|
1024
1024
|
* ungzip and re-gate the inner SVG. External `xlink:href` on
|
|
1025
1025
|
* `<use>` / `<feImage>` refuses under `strict` (SSRF + XSS chain).
|
|
@@ -1042,13 +1042,13 @@ function sanitize(input, opts) {
|
|
|
1042
1042
|
*
|
|
1043
1043
|
* @example
|
|
1044
1044
|
* var g = b.guardSvg.gate({ profile: "strict" });
|
|
1045
|
-
* var verdict = await g({
|
|
1045
|
+
* var verdict = await g.check({
|
|
1046
1046
|
* bytes: Buffer.from('<svg><circle r="10"/></svg>', "utf8"),
|
|
1047
1047
|
* });
|
|
1048
1048
|
* verdict.action; // → "serve"
|
|
1049
1049
|
*
|
|
1050
1050
|
* // Refuses external xlink:href under strict:
|
|
1051
|
-
* var refuse = await g({
|
|
1051
|
+
* var refuse = await g.check({
|
|
1052
1052
|
* bytes: Buffer.from(
|
|
1053
1053
|
* '<svg><use xlink:href="https://evil.example/x.svg#a"/></svg>',
|
|
1054
1054
|
* "utf8"),
|
package/lib/guard-template.js
CHANGED
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
* Profiles: `strict` / `balanced` / `permissive`. Compliance
|
|
35
35
|
* postures: `hipaa` / `pci-dss` / `gdpr` / `soc2`. Operators
|
|
36
36
|
* select via `{ profile: "strict" }` or
|
|
37
|
-
* `{
|
|
37
|
+
* `{ compliancePosture: "hipaa" }`; postures overlay on top of the
|
|
38
38
|
* profile baseline. Jinja / ERB / Pug shape rejection holds at
|
|
39
39
|
* every profile — the SSTI class is never an operator opt-in.
|
|
40
40
|
*
|
|
@@ -237,7 +237,7 @@ function _detectIssues(input, opts) {
|
|
|
237
237
|
*
|
|
238
238
|
* @opts
|
|
239
239
|
* profile: "strict"|"balanced"|"permissive",
|
|
240
|
-
*
|
|
240
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
241
241
|
* bidiPolicy: "reject"|"audit"|"allow",
|
|
242
242
|
* controlPolicy: "reject"|"audit"|"allow",
|
|
243
243
|
* nullBytePolicy: "reject"|"audit"|"allow",
|
|
@@ -287,7 +287,7 @@ function validate(input, opts) {
|
|
|
287
287
|
*
|
|
288
288
|
* @opts
|
|
289
289
|
* profile: "strict"|"balanced"|"permissive",
|
|
290
|
-
*
|
|
290
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
291
291
|
* jinjaPolicy: "reject"|"audit"|"allow",
|
|
292
292
|
* erbPolicy: "reject"|"audit"|"allow",
|
|
293
293
|
* pugPolicy: "reject"|"audit"|"allow",
|
|
@@ -339,7 +339,7 @@ function sanitize(input, opts) {
|
|
|
339
339
|
*
|
|
340
340
|
* @opts
|
|
341
341
|
* profile: "strict"|"balanced"|"permissive",
|
|
342
|
-
*
|
|
342
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
343
343
|
* name: string, // override gate name in audit emissions
|
|
344
344
|
* jinjaPolicy: "reject"|"audit"|"allow",
|
|
345
345
|
* erbPolicy: "reject"|"audit"|"allow",
|
package/lib/guard-time.js
CHANGED
|
@@ -347,7 +347,7 @@ function _detectIssues(input, opts) {
|
|
|
347
347
|
*
|
|
348
348
|
* @opts
|
|
349
349
|
* profile: "strict"|"balanced"|"permissive",
|
|
350
|
-
*
|
|
350
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
351
351
|
* bidiPolicy: "reject"|"strip"|"audit"|"allow",
|
|
352
352
|
* controlPolicy: "reject"|"strip"|"allow",
|
|
353
353
|
* nullBytePolicy: "reject"|"strip"|"allow",
|
|
@@ -403,7 +403,7 @@ function validate(input, opts) {
|
|
|
403
403
|
*
|
|
404
404
|
* @opts
|
|
405
405
|
* profile: "strict"|"balanced"|"permissive",
|
|
406
|
-
*
|
|
406
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
407
407
|
* ...: same shape as b.guardTime.validate opts,
|
|
408
408
|
*
|
|
409
409
|
* @example
|
|
@@ -442,7 +442,7 @@ function sanitize(input, opts) {
|
|
|
442
442
|
* @compliance hipaa, pci-dss, gdpr, soc2
|
|
443
443
|
* @related b.guardTime.validate, b.guardTime.sanitize, b.guardAll.gate
|
|
444
444
|
*
|
|
445
|
-
* Build
|
|
445
|
+
* Build a guard gate whose async `check(ctx)` returns `{ ok, action, issues }`, consumable
|
|
446
446
|
* by `b.guardAll`, audit pipelines, scheduling primitives, and
|
|
447
447
|
* retention readers. The gate reads `ctx.identifier` (or
|
|
448
448
|
* `ctx.timestamp` / `ctx.time`), runs `validate`, and maps
|
|
@@ -452,15 +452,15 @@ function sanitize(input, opts) {
|
|
|
452
452
|
* @opts
|
|
453
453
|
* name: string, // gate label for audit / observability
|
|
454
454
|
* profile: "strict"|"balanced"|"permissive",
|
|
455
|
-
*
|
|
455
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
456
456
|
* ...: same shape as b.guardTime.validate opts,
|
|
457
457
|
*
|
|
458
458
|
* @example
|
|
459
459
|
* var g = b.guardTime.gate({ profile: "strict" });
|
|
460
|
-
* var rv = await g({ identifier: "2026-05-05T12:34:56Z" });
|
|
460
|
+
* var rv = await g.check({ identifier: "2026-05-05T12:34:56Z" });
|
|
461
461
|
* rv.action; // → "serve"
|
|
462
462
|
*
|
|
463
|
-
* var bad = await g({ identifier: "2026-05-05 12:34:56" });
|
|
463
|
+
* var bad = await g.check({ identifier: "2026-05-05 12:34:56" });
|
|
464
464
|
* bad.action; // → "refuse"
|
|
465
465
|
*/
|
|
466
466
|
function gate(opts) {
|
package/lib/guard-uuid.js
CHANGED
|
@@ -307,7 +307,7 @@ function _detectIssues(input, opts) {
|
|
|
307
307
|
*
|
|
308
308
|
* @opts
|
|
309
309
|
* profile: "strict"|"balanced"|"permissive",
|
|
310
|
-
*
|
|
310
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
311
311
|
* bidiPolicy: "reject"|"strip"|"audit"|"allow",
|
|
312
312
|
* controlPolicy: "reject"|"strip"|"allow",
|
|
313
313
|
* nullBytePolicy: "reject"|"strip"|"allow",
|
|
@@ -361,7 +361,7 @@ function validate(input, opts) {
|
|
|
361
361
|
*
|
|
362
362
|
* @opts
|
|
363
363
|
* profile: "strict"|"balanced"|"permissive",
|
|
364
|
-
*
|
|
364
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
365
365
|
* ...: same shape as b.guardUuid.validate opts,
|
|
366
366
|
*
|
|
367
367
|
* @example
|
|
@@ -406,7 +406,7 @@ function sanitize(input, opts) {
|
|
|
406
406
|
* @compliance hipaa, pci-dss, gdpr, soc2
|
|
407
407
|
* @related b.guardUuid.validate, b.guardUuid.sanitize, b.guardAll.gate
|
|
408
408
|
*
|
|
409
|
-
* Build
|
|
409
|
+
* Build a guard gate whose async `check(ctx)` returns `{ ok, action, issues }`, consumable
|
|
410
410
|
* by `b.guardAll`, ID validators, and any host that handles
|
|
411
411
|
* UUID-shaped tokens. The gate reads `ctx.identifier` (or
|
|
412
412
|
* `ctx.uuid`), runs `validate`, and maps severity to action: zero
|
|
@@ -416,15 +416,15 @@ function sanitize(input, opts) {
|
|
|
416
416
|
* @opts
|
|
417
417
|
* name: string, // gate label for audit / observability
|
|
418
418
|
* profile: "strict"|"balanced"|"permissive",
|
|
419
|
-
*
|
|
419
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
420
420
|
* ...: same shape as b.guardUuid.validate opts,
|
|
421
421
|
*
|
|
422
422
|
* @example
|
|
423
423
|
* var g = b.guardUuid.gate({ profile: "strict" });
|
|
424
|
-
* var rv = await g({ identifier: "550e8400-e29b-41d4-a716-446655440000" });
|
|
424
|
+
* var rv = await g.check({ identifier: "550e8400-e29b-41d4-a716-446655440000" });
|
|
425
425
|
* rv.action; // → "serve"
|
|
426
426
|
*
|
|
427
|
-
* var bad = await g({ identifier: "{550e8400-e29b-41d4-a716-446655440000}" });
|
|
427
|
+
* var bad = await g.check({ identifier: "{550e8400-e29b-41d4-a716-446655440000}" });
|
|
428
428
|
* bad.action; // → "refuse"
|
|
429
429
|
*/
|
|
430
430
|
function gate(opts) {
|
package/lib/guard-xml.js
CHANGED
|
@@ -371,7 +371,7 @@ function _detectIssues(input, opts) {
|
|
|
371
371
|
*
|
|
372
372
|
* Inspect `input` (string of XML source) for the full guard-xml
|
|
373
373
|
* threat catalog without invoking a parser. Returns
|
|
374
|
-
* `{ ok, issues
|
|
374
|
+
* `{ ok, issues }` where `issues` enumerates every
|
|
375
375
|
* DOCTYPE declaration, `<!ENTITY>` definition (including parameter
|
|
376
376
|
* entities), SYSTEM/PUBLIC external-entity reference, XInclude
|
|
377
377
|
* directive, xsi:schemaLocation hint, processing instruction (after
|
|
@@ -388,7 +388,7 @@ function _detectIssues(input, opts) {
|
|
|
388
388
|
*
|
|
389
389
|
* @opts
|
|
390
390
|
* profile: "strict"|"balanced"|"permissive",
|
|
391
|
-
*
|
|
391
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
392
392
|
* doctypePolicy: "reject"|"audit"|"allow",
|
|
393
393
|
* entityPolicy: "reject"|"audit"|"allow",
|
|
394
394
|
* externalEntityPolicy: "reject"|"audit"|"allow",
|
|
@@ -455,7 +455,7 @@ function validate(input, opts) {
|
|
|
455
455
|
*
|
|
456
456
|
* @opts
|
|
457
457
|
* profile: "strict"|"balanced"|"permissive",
|
|
458
|
-
*
|
|
458
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
459
459
|
* bidiPolicy: "reject"|"strip"|"audit"|"allow",
|
|
460
460
|
* controlPolicy: "reject"|"strip"|"allow",
|
|
461
461
|
* nullBytePolicy: "reject"|"strip"|"allow",
|
|
@@ -514,7 +514,7 @@ function sanitize(input, opts) {
|
|
|
514
514
|
*
|
|
515
515
|
* @opts
|
|
516
516
|
* profile: "strict"|"balanced"|"permissive",
|
|
517
|
-
*
|
|
517
|
+
* compliancePosture: "hipaa"|"pci-dss"|"gdpr"|"soc2",
|
|
518
518
|
* name: string, // gate identity for audit / observability
|
|
519
519
|
*
|
|
520
520
|
* @example
|