@starci/eslint-canon-be 3.8.20 → 3.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/package.json +1 -1
- package/runtime/bundle.json +192 -0
- package/runtime/engine/by-code-unit.mjs +6 -6
- package/runtime/engine/model-config.mjs +98 -76
- package/runtime/engine/orca-config.mjs +22 -17
- package/runtime/engine/release-config.mjs +22 -18
- package/runtime/engine/removed-vocabulary.mjs +21 -20
- package/runtime/engine/resources-config.mjs +42 -35
- package/runtime/engine/runtime-root.mjs +11 -13
- package/runtime/engine/secrets.mjs +170 -102
- package/runtime/engine/sonar-config.mjs +16 -13
- package/runtime/engine/temp-root.mjs +3 -9
- package/runtime/knowledge/hfs/canon-pins.yaml +10 -10
- package/runtime/knowledge/hfs/rules.yaml +6 -6
- package/runtime/knowledge/hfs/slots.yaml +2 -2
- package/runtime/knowledge/sonar-gate.yaml +1 -1
- package/runtime/packages/hfs/templates/app/package-scripts/package.json +1 -1
- package/runtime/scripts/api/git/cat-file.mjs +0 -1
- package/runtime/scripts/api/git/config-get.mjs +1 -2
- package/runtime/scripts/api/git/diff.mjs +0 -1
- package/runtime/scripts/api/git/lib.mjs +32 -32
- package/runtime/scripts/api/git/ls-files.mjs +0 -1
- package/runtime/scripts/api/git/ls-tree.mjs +0 -1
- package/runtime/scripts/api/git/merge-base.mjs +2 -3
- package/runtime/scripts/api/git/remote.mjs +0 -1
- package/runtime/scripts/api/git/rev-parse-query.mjs +0 -1
- package/runtime/scripts/api/git/show.mjs +0 -1
- package/runtime/scripts/hfs/allows.mjs +37 -38
- package/runtime/scripts/hfs/architecture/ast-walks.mjs +180 -163
- package/runtime/scripts/hfs/architecture/automatic-gates.mjs +80 -73
- package/runtime/scripts/hfs/architecture/backend-app-files.mjs +88 -77
- package/runtime/scripts/hfs/architecture/backend.mjs +378 -357
- package/runtime/scripts/hfs/architecture/background-unowned.mjs +201 -187
- package/runtime/scripts/hfs/architecture/canon-clones.mjs +260 -209
- package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +149 -116
- package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +72 -68
- package/runtime/scripts/hfs/architecture/clones.mjs +212 -217
- package/runtime/scripts/hfs/architecture/config-unread.mjs +7 -9
- package/runtime/scripts/hfs/architecture/config.mjs +302 -268
- package/runtime/scripts/hfs/architecture/connection-map.mjs +258 -225
- package/runtime/scripts/hfs/architecture/constructor-deps.mjs +80 -71
- package/runtime/scripts/hfs/architecture/context-coupling.mjs +82 -77
- package/runtime/scripts/hfs/architecture/context-map.mjs +267 -234
- package/runtime/scripts/hfs/architecture/context-owner.mjs +73 -61
- package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +47 -43
- package/runtime/scripts/hfs/architecture/context-transaction.mjs +54 -52
- package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +113 -104
- package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +288 -270
- package/runtime/scripts/hfs/architecture/contracts.mjs +408 -393
- package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +50 -51
- package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +143 -119
- package/runtime/scripts/hfs/architecture/dead-exports.mjs +286 -228
- package/runtime/scripts/hfs/architecture/default-deny.mjs +129 -110
- package/runtime/scripts/hfs/architecture/doc-language.mjs +24 -19
- package/runtime/scripts/hfs/architecture/entity-registry.mjs +20 -22
- package/runtime/scripts/hfs/architecture/entrypoint.mjs +47 -45
- package/runtime/scripts/hfs/architecture/error-codes.mjs +37 -35
- package/runtime/scripts/hfs/architecture/error-masked.mjs +55 -59
- package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +24 -23
- package/runtime/scripts/hfs/architecture/feature-shape.mjs +40 -38
- package/runtime/scripts/hfs/architecture/framework-pinned.mjs +21 -21
- package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +106 -98
- package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +153 -150
- package/runtime/scripts/hfs/architecture/frontend-routing.mjs +161 -149
- package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +343 -305
- package/runtime/scripts/hfs/architecture/frontend-world.mjs +340 -294
- package/runtime/scripts/hfs/architecture/frontend.mjs +174 -184
- package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +124 -106
- package/runtime/scripts/hfs/architecture/hfs-graph.mjs +52 -48
- package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +81 -71
- package/runtime/scripts/hfs/architecture/i18n-keys.mjs +155 -141
- package/runtime/scripts/hfs/architecture/identity.mjs +141 -125
- package/runtime/scripts/hfs/architecture/index.mjs +272 -272
- package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +45 -43
- package/runtime/scripts/hfs/architecture/jwt-ast.mjs +195 -176
- package/runtime/scripts/hfs/architecture/machine-ast.mjs +163 -155
- package/runtime/scripts/hfs/architecture/managed-scripts.mjs +19 -20
- package/runtime/scripts/hfs/architecture/module-per-transport.mjs +177 -172
- package/runtime/scripts/hfs/architecture/next-data-contract.mjs +100 -78
- package/runtime/scripts/hfs/architecture/next-data-inference.mjs +170 -154
- package/runtime/scripts/hfs/architecture/next-data-key.mjs +311 -275
- package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +17 -17
- package/runtime/scripts/hfs/architecture/next-data.mjs +351 -334
- package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +39 -37
- package/runtime/scripts/hfs/architecture/owners.mjs +97 -98
- package/runtime/scripts/hfs/architecture/package-shape.mjs +56 -55
- package/runtime/scripts/hfs/architecture/presentation.mjs +138 -130
- package/runtime/scripts/hfs/architecture/reachability.mjs +258 -241
- package/runtime/scripts/hfs/architecture/register-once.mjs +152 -139
- package/runtime/scripts/hfs/architecture/registration.mjs +301 -267
- package/runtime/scripts/hfs/architecture/required-files.mjs +172 -167
- package/runtime/scripts/hfs/architecture/route-files-thin.mjs +85 -77
- package/runtime/scripts/hfs/architecture/schema-owner.mjs +206 -181
- package/runtime/scripts/hfs/architecture/server-action.mjs +48 -48
- package/runtime/scripts/hfs/architecture/side-boundary.mjs +2 -5
- package/runtime/scripts/hfs/architecture/source-names-shape.mjs +261 -259
- package/runtime/scripts/hfs/architecture/source-names.mjs +304 -278
- package/runtime/scripts/hfs/architecture/sql-keys.mjs +277 -194
- package/runtime/scripts/hfs/architecture/sql-owner.mjs +236 -194
- package/runtime/scripts/hfs/architecture/sql-returning.mjs +46 -45
- package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +86 -74
- package/runtime/scripts/hfs/architecture/sql-tokens.mjs +456 -341
- package/runtime/scripts/hfs/architecture/staged-consumers.mjs +35 -30
- package/runtime/scripts/hfs/architecture/surface.mjs +64 -74
- package/runtime/scripts/hfs/architecture/symbols.mjs +209 -216
- package/runtime/scripts/hfs/architecture/test-world-files.mjs +165 -155
- package/runtime/scripts/hfs/architecture/tiers.mjs +161 -154
- package/runtime/scripts/hfs/architecture/transport-owner.mjs +155 -149
- package/runtime/scripts/hfs/architecture/type-context.mjs +255 -250
- package/runtime/scripts/hfs/architecture/typescript.mjs +358 -318
- package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +110 -92
- package/runtime/scripts/hfs/declaration-shape.mjs +140 -103
- package/runtime/scripts/hfs/declaration-slots.mjs +64 -61
- package/runtime/scripts/hfs/edition-slots.mjs +43 -40
- package/runtime/scripts/hfs/linear-text.mjs +20 -20
- package/runtime/scripts/hfs/param-names.mjs +6 -11
- package/runtime/scripts/hfs/path-findings.mjs +120 -100
- package/runtime/scripts/hfs/repo-identity.mjs +55 -42
- package/runtime/scripts/hfs/rule-catalog.mjs +353 -257
- package/runtime/scripts/hfs/rule-params-shape.mjs +60 -47
- package/runtime/scripts/hfs/rules/database-migrations.mjs +428 -388
- package/runtime/scripts/hfs/rules/fe-no-tests.mjs +37 -36
- package/runtime/scripts/hfs/rules/read.mjs +19 -15
- package/runtime/scripts/hfs/rules/secrets.mjs +1 -1
- package/runtime/scripts/hfs/rules/spec-placement.mjs +12 -13
- package/runtime/scripts/hfs/slot-app-view.mjs +69 -74
- package/runtime/scripts/hfs/slot-classify.mjs +42 -38
- package/runtime/scripts/hfs/slot-errors.mjs +8 -7
- package/runtime/scripts/hfs/slot-imports.mjs +70 -63
- package/runtime/scripts/hfs/slot-manifest-shape.mjs +74 -52
- package/runtime/scripts/hfs/slot-match.mjs +122 -111
- package/runtime/scripts/hfs/slot-path.mjs +0 -2
- package/runtime/scripts/hfs/slot-required.mjs +65 -59
- package/runtime/scripts/hfs/slot-semantic-problems.mjs +138 -112
- package/runtime/scripts/hfs/slot-side-problems.mjs +23 -19
- package/runtime/scripts/hfs/slots.mjs +175 -152
- package/runtime/scripts/hfs/test-world-slot.mjs +0 -1
- package/runtime/scripts/hfs/trailing-slashes.mjs +4 -4
- package/runtime/scripts/hfs/typescript-programs.mjs +66 -69
- package/runtime/scripts/hfs/view.mjs +38 -40
- package/runtime/scripts/lib/dockerfile.mjs +131 -114
- package/runtime/scripts/lib/env.mjs +3 -6
- package/runtime/scripts/lib/event-contract.mjs +73 -78
- package/runtime/scripts/lib/git.mjs +15 -16
- package/runtime/scripts/lib/glob.mjs +23 -14
- package/runtime/scripts/lib/grammar-lint.mjs +33 -37
- package/runtime/scripts/lib/i18n.mjs +32 -35
- package/runtime/scripts/lib/in-order.mjs +57 -38
- package/runtime/scripts/lib/json-clone.mjs +45 -36
- package/runtime/scripts/lib/json.mjs +26 -14
- package/runtime/scripts/lib/language.mjs +133 -129
- package/runtime/scripts/lib/list.mjs +9 -14
- package/runtime/scripts/lib/mutation-fence.mjs +10 -5
- package/runtime/scripts/lib/path-key.mjs +53 -38
- package/runtime/scripts/lib/read-text.mjs +30 -17
- package/runtime/scripts/lib/regex.mjs +1 -2
- package/runtime/scripts/lib/same-text.mjs +0 -1
- package/runtime/scripts/lib/sops-envelope.mjs +148 -120
- package/runtime/scripts/lib/stack-services.mjs +128 -129
- package/runtime/scripts/lib/ts-analysis.mjs +28 -26
- package/runtime/scripts/lib/ts-ast.mjs +36 -42
- package/runtime/scripts/lib/walk.mjs +33 -27
- package/runtime/scripts/lib/yaml-cached.mjs +4 -4
|
@@ -1,4 +1,3 @@
|
|
|
1
1
|
// regex.mjs - building a RegExp from text.
|
|
2
|
-
|
|
3
2
|
/** `text` with every regular-expression metacharacter escaped, so it matches itself literally. */
|
|
4
|
-
export const escapeRegExp = (text) => String(text).replace(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
|
|
3
|
+
export const escapeRegExp = (text) => String(text).replace(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
// same-text.mjs - text equality that ignores the line-ending form and a trailing blank tail (a git runner may trim stdout, a work tree may
|
|
2
2
|
// carry CRLF): the one comparison the database rules use for a committed file against its base or against a regenerated one.
|
|
3
|
-
|
|
4
3
|
/** True when both texts exist and are equal once CRLF is folded to LF and trailing whitespace at the end is dropped. */
|
|
5
4
|
export const sameText = (a, b) => a !== null && b !== null && a.replaceAll('\r\n', '\n').trimEnd() === b.replaceAll('\r\n', '\n').trimEnd();
|
|
@@ -4,181 +4,209 @@
|
|
|
4
4
|
// scripts/uat/test-secret.mjs; the sops binary is found by scripts/api/sops/lib.mjs.
|
|
5
5
|
import path from 'node:path';
|
|
6
6
|
import { parseYaml } from '../../engine/yaml.mjs';
|
|
7
|
-
|
|
8
7
|
const NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/;
|
|
9
8
|
const STACK = /^[a-z0-9][a-z0-9-]{0,31}$/;
|
|
10
9
|
/** One sops-encrypted leaf: `ENC[AES256_GCM,data:...,iv:...,tag:...,type:...]` (data may be empty). */
|
|
11
10
|
const SOPS_VALUE = /^ENC\[AES256_GCM,data:[A-Za-z0-9+/=]*,iv:[A-Za-z0-9+/=]+,tag:[A-Za-z0-9+/=]+,type:[a-z]+\]$/;
|
|
12
|
-
|
|
13
11
|
/** Where test credential `name` of `stack` lives in `repo`: {plain, enc, rel}. `rel` is the path the repo's
|
|
14
12
|
* `stack-secret.mjs set` takes. */
|
|
15
13
|
export function testSecretPaths(name, { repo, stack = 'dev' } = {}) {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
14
|
+
if (!NAME.test(String(name ?? '')))
|
|
15
|
+
throw new Error(`test secret name must match ${NAME} (got ${JSON.stringify(name)})`);
|
|
16
|
+
if (!STACK.test(String(stack ?? '')))
|
|
17
|
+
throw new Error(`stack must match ${STACK} (got ${JSON.stringify(stack)})`);
|
|
18
|
+
if (!repo)
|
|
19
|
+
throw new Error('test secret needs {repo}: the product repository whose .starcistacks holds it');
|
|
20
|
+
const rel = `${stack}/secrets/test/${name}`;
|
|
21
|
+
const plain = path.join(path.resolve(String(repo)), '.starcistacks', stack, 'secrets', 'test', name);
|
|
22
|
+
return { plain, enc: `${plain}.enc`, rel };
|
|
22
23
|
}
|
|
23
|
-
|
|
24
24
|
/** The command that stores a test credential, in the product repository's own tooling. */
|
|
25
25
|
export const setCommand = (name = '<name>', stack = 'dev') => `node scripts/stack-secret.mjs set ${stack}/secrets/test/${name}`;
|
|
26
|
-
|
|
27
26
|
/** sops' format for a plaintext path, as the repository's stack-secret.mjs formatFor decides it. */
|
|
28
27
|
export const sopsFormatFor = (file) => {
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
28
|
+
if (file.endsWith('.env'))
|
|
29
|
+
return 'dotenv';
|
|
30
|
+
if (file.endsWith('.json'))
|
|
31
|
+
return 'json';
|
|
32
|
+
if (/\.(ya?ml|kubeconfig)$/.test(file))
|
|
33
|
+
return 'yaml';
|
|
34
|
+
return 'binary';
|
|
33
35
|
};
|
|
34
|
-
|
|
35
36
|
/** Every leaf outside the `sops` block is an ENC[...] value (or null); the block itself carries a mac. */
|
|
36
37
|
const allEncrypted = (node) => {
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
38
|
+
if (node === null)
|
|
39
|
+
return true;
|
|
40
|
+
if (Array.isArray(node))
|
|
41
|
+
return node.every(allEncrypted);
|
|
42
|
+
if (typeof node === 'object')
|
|
43
|
+
return Object.values(node).every(allEncrypted);
|
|
44
|
+
return typeof node === 'string' && SOPS_VALUE.test(node);
|
|
41
45
|
};
|
|
46
|
+
// reason: a sops document is JSON or YAML parsed from a committed file; the envelope test reads it structurally.
|
|
42
47
|
const sopsTree = (doc) => !!doc && typeof doc === 'object' && !Array.isArray(doc) && !!doc.sops && typeof doc.sops === 'object'
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
48
|
+
&& typeof doc.sops.mac === 'string' && SOPS_VALUE.test(doc.sops.mac)
|
|
49
|
+
&& Object.keys(doc).length > 1 && Object.entries(doc).every(([k, v]) => k === 'sops' || allEncrypted(v));
|
|
46
50
|
/**
|
|
47
51
|
* True only for a sops-encrypted file with no plaintext value: binary/json form ({"data": ENC[...], "sops": {...}}),
|
|
48
52
|
* yaml form (every value ENC[...] plus the sops block) or dotenv form (KEY=ENC[...] lines plus sops_* metadata).
|
|
49
53
|
* The sops metadata must carry its mac. A key kept plaintext through `unencrypted_suffix` does not pass.
|
|
50
54
|
*/
|
|
51
55
|
export function isSopsEnvelope(text) {
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
const
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
56
|
+
const src = String(text ?? '').replace(/^/, '');
|
|
57
|
+
if (!src.trim())
|
|
58
|
+
return false;
|
|
59
|
+
try {
|
|
60
|
+
return sopsTree(JSON.parse(src));
|
|
61
|
+
}
|
|
62
|
+
catch { /* not JSON */ }
|
|
63
|
+
const lines = src.split(/\r?\n/).filter((l) => l.trim() && !/^\s*#/.test(l));
|
|
64
|
+
if (lines.length && lines.every((l) => /^[A-Za-z_]\w*=/.test(l))) {
|
|
65
|
+
const pairs = lines.map((l) => [l.slice(0, l.indexOf('=')), l.slice(l.indexOf('=') + 1)]);
|
|
66
|
+
const meta = pairs.filter(([k]) => k.startsWith('sops_'));
|
|
67
|
+
const vals = pairs.filter(([k]) => !k.startsWith('sops_'));
|
|
68
|
+
return vals.length > 0 && vals.every(([, v]) => SOPS_VALUE.test(v)) && meta.some(([k, v]) => k === 'sops_mac' && SOPS_VALUE.test(v));
|
|
69
|
+
}
|
|
70
|
+
try {
|
|
71
|
+
return sopsTree(parseYaml(src));
|
|
72
|
+
}
|
|
73
|
+
catch {
|
|
74
|
+
return false;
|
|
75
|
+
}
|
|
63
76
|
}
|
|
64
|
-
|
|
65
77
|
/** A refused admission, named by its reason. */
|
|
66
78
|
const refusal = (reason) => ({ ok: false, reason });
|
|
67
|
-
|
|
68
79
|
const DOTENV_AGE_FIELD = /^age__list_(0|[1-9]\d{0,2})__map_(recipient|enc)$/u;
|
|
69
|
-
|
|
70
80
|
function dotenvMetadataValue(meta, age, key, value) {
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
if (
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
+
const field = DOTENV_AGE_FIELD.exec(key);
|
|
82
|
+
if (field) {
|
|
83
|
+
const entry = (age[Number(field[1])] ??= {});
|
|
84
|
+
entry[field[2]] = value;
|
|
85
|
+
}
|
|
86
|
+
else if (key === 'mac_only_encrypted') {
|
|
87
|
+
if (value !== 'false')
|
|
88
|
+
return 'partial-mac';
|
|
89
|
+
meta[key] = false;
|
|
90
|
+
}
|
|
91
|
+
else if (key.includes('__'))
|
|
92
|
+
return 'unsupported-key-group';
|
|
93
|
+
else
|
|
94
|
+
meta[key] = value;
|
|
95
|
+
return null;
|
|
81
96
|
}
|
|
82
|
-
|
|
83
97
|
function readDotenvMetadata(text) {
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
const
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
98
|
+
const pairs = new Map();
|
|
99
|
+
for (const line of String(text).split('\n')) {
|
|
100
|
+
if (!line || line.startsWith('#'))
|
|
101
|
+
continue;
|
|
102
|
+
if (line.includes('\r'))
|
|
103
|
+
return { refusal: 'unsupported-dotenv' };
|
|
104
|
+
const at = line.indexOf('=');
|
|
105
|
+
if (at < 1)
|
|
106
|
+
return { refusal: 'unsupported-dotenv' };
|
|
107
|
+
const name = line.slice(0, at);
|
|
108
|
+
if (pairs.has(name))
|
|
109
|
+
return { refusal: 'duplicate-key' };
|
|
110
|
+
pairs.set(name, line.slice(at + 1).replaceAll(String.raw `\n`, '\n'));
|
|
111
|
+
}
|
|
112
|
+
const meta = {};
|
|
113
|
+
const age = [];
|
|
114
|
+
for (const [name, value] of pairs) {
|
|
115
|
+
if (!name.startsWith('sops_'))
|
|
116
|
+
continue;
|
|
117
|
+
const reason = dotenvMetadataValue(meta, age, name.slice('sops_'.length), value);
|
|
118
|
+
if (reason)
|
|
119
|
+
return { refusal: reason };
|
|
120
|
+
}
|
|
121
|
+
// A gap in the list indices is an entry sops never wrote: refused as an empty entry, never skipped.
|
|
122
|
+
meta.age = Array.from(age, (entry) => entry ?? null);
|
|
123
|
+
return { meta };
|
|
104
124
|
}
|
|
105
|
-
|
|
106
125
|
function readStructuredMetadata(text, format) {
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
126
|
+
const doc = parseYaml(String(text));
|
|
127
|
+
if (format !== 'yaml')
|
|
128
|
+
JSON.parse(String(text));
|
|
129
|
+
if (format === 'binary' && (!doc || Object.keys(doc).length !== 2 || !Object.hasOwn(doc, 'data') || !Object.hasOwn(doc, 'sops') || typeof doc.data !== 'string'))
|
|
130
|
+
return { refusal: 'unsupported-binary-shape' };
|
|
131
|
+
return { meta: doc?.sops };
|
|
112
132
|
}
|
|
113
|
-
|
|
114
133
|
function readAgeMetadata(text, format) {
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
134
|
+
try {
|
|
135
|
+
return format === 'dotenv' ? readDotenvMetadata(text) : readStructuredMetadata(text, format);
|
|
136
|
+
}
|
|
137
|
+
catch {
|
|
138
|
+
return { refusal: 'invalid-envelope' };
|
|
139
|
+
}
|
|
118
140
|
}
|
|
119
|
-
|
|
120
141
|
function hasNonAgeProvider(meta, providers) {
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
142
|
+
for (const name of providers) {
|
|
143
|
+
const provider = meta[name];
|
|
144
|
+
if (Object.hasOwn(meta, name) && (!Array.isArray(provider) || provider.length))
|
|
145
|
+
return true;
|
|
146
|
+
}
|
|
147
|
+
return false;
|
|
125
148
|
}
|
|
126
|
-
|
|
127
149
|
function isAgeEntry(entry) {
|
|
128
|
-
|
|
129
|
-
|
|
150
|
+
return !!entry && typeof entry === 'object' && !Array.isArray(entry)
|
|
151
|
+
&& !Object.keys(entry).some(name => !['recipient', 'enc'].includes(name));
|
|
130
152
|
}
|
|
131
|
-
|
|
132
153
|
function hasValidAgePayload(entry) {
|
|
133
|
-
|
|
134
|
-
|
|
154
|
+
return typeof entry.enc === 'string' && entry.enc.startsWith('-----BEGIN AGE ENCRYPTED FILE-----\n')
|
|
155
|
+
&& entry.enc.includes('\n-----END AGE ENCRYPTED FILE-----');
|
|
135
156
|
}
|
|
136
|
-
|
|
137
157
|
function hasValidEnvelopeVersion(meta) {
|
|
138
|
-
|
|
139
|
-
|
|
158
|
+
return typeof meta.version === 'string' && /^\d+\.\d+\.\d+$/.test(meta.version)
|
|
159
|
+
&& typeof meta.lastmodified === 'string' && Number.isFinite(Date.parse(meta.lastmodified));
|
|
140
160
|
}
|
|
141
|
-
|
|
142
161
|
function validateAgeMetadata(meta, text, recipient) {
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
162
|
+
if (!meta || typeof meta !== 'object' || Array.isArray(meta) || !isSopsEnvelope(text))
|
|
163
|
+
return refusal('invalid-envelope');
|
|
164
|
+
if (Object.hasOwn(meta, 'key_groups') || Object.hasOwn(meta, 'shamir_threshold'))
|
|
165
|
+
return refusal('unsupported-key-group');
|
|
166
|
+
const providers = ['kms', 'gcp_kms', 'hckms', 'azure_kv', 'hc_vault', 'pgp'];
|
|
167
|
+
if (hasNonAgeProvider(meta, providers))
|
|
168
|
+
return refusal('non-age-provider');
|
|
169
|
+
const fields = new Set([...providers, 'age', 'lastmodified', 'mac', 'version', 'unencrypted_suffix', 'encrypted_suffix', 'unencrypted_regex', 'encrypted_regex', 'unencrypted_comment_regex', 'encrypted_comment_regex', 'mac_only_encrypted']);
|
|
170
|
+
if (Object.keys(meta).some(name => !fields.has(name)))
|
|
171
|
+
return refusal('unknown-metadata');
|
|
172
|
+
if (Object.hasOwn(meta, 'mac_only_encrypted') && meta.mac_only_encrypted !== false)
|
|
173
|
+
return refusal('partial-mac');
|
|
174
|
+
const set = ageSet(meta.age);
|
|
175
|
+
if (!set.ok)
|
|
176
|
+
return set;
|
|
177
|
+
if (!set.recipients.includes(recipient))
|
|
178
|
+
return refusal('recipient-mismatch');
|
|
179
|
+
if (!hasValidEnvelopeVersion(meta))
|
|
180
|
+
return refusal('invalid-envelope');
|
|
181
|
+
return { ok: true };
|
|
155
182
|
}
|
|
156
|
-
|
|
157
183
|
const AGE_RECIPIENT = /^age1[ac-hj-np-z02-9]+$/u;
|
|
158
|
-
|
|
159
184
|
/**
|
|
160
185
|
* The age set of an envelope: one or more entries (the owner key and an environment's server key are the standard pair), each a
|
|
161
186
|
* well-formed recipient with its wrapped data key; an empty entry or a recipient named twice is refused.
|
|
162
187
|
*/
|
|
163
188
|
function ageSet(entries) {
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
189
|
+
if (!Array.isArray(entries) || entries.length === 0)
|
|
190
|
+
return refusal('unsupported-age-set');
|
|
191
|
+
const recipients = [];
|
|
192
|
+
for (const entry of entries) {
|
|
193
|
+
if (!isAgeEntry(entry) || typeof entry.recipient !== 'string' || !AGE_RECIPIENT.test(entry.recipient) || !hasValidAgePayload(entry))
|
|
194
|
+
return refusal('invalid-age-entry');
|
|
195
|
+
if (recipients.includes(entry.recipient))
|
|
196
|
+
return refusal('duplicate-age-recipient');
|
|
197
|
+
recipients.push(entry.recipient);
|
|
198
|
+
}
|
|
199
|
+
return { ok: true, recipients };
|
|
173
200
|
}
|
|
174
|
-
|
|
175
201
|
/**
|
|
176
202
|
* Admit one flat age envelope for the native selected-identity invocation when `recipient` (the selected identity's public key) is
|
|
177
203
|
* one of its age set. Shape admission, never cryptographic proof.
|
|
178
204
|
*/
|
|
179
205
|
export function selectedAgeEnvelope(text, format, recipient) {
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
206
|
+
if (!['binary', 'json', 'yaml', 'dotenv'].includes(format))
|
|
207
|
+
return refusal('unsupported-format');
|
|
208
|
+
const parsed = readAgeMetadata(text, format);
|
|
209
|
+
if (parsed.refusal)
|
|
210
|
+
return refusal(parsed.refusal);
|
|
211
|
+
return validateAgeMetadata(parsed.meta, text, recipient);
|
|
184
212
|
}
|