@niscorp/charter 0.1.2 → 0.1.4
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 +24 -0
- package/DESIGN.md +9 -5
- package/DOCS.md +13 -9
- package/dist/index.cjs +10 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.js +10 -3
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,29 @@
|
|
|
1
1
|
# @niscorp/charter
|
|
2
2
|
|
|
3
|
+
## 0.1.4
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 9e6a7c3: The charter decides which of an app's functions a principal may call. **Breaking.**
|
|
8
|
+
|
|
9
|
+
BREAKING — approved by moccadroid, 2026-10-14: give every role of the charter a `functions` part, the functions its actions call, or `functions: ['*']` to keep calling all of them; a role written as a list (`member: ['home', 'settings']`) becomes `member: { actions: ['home', 'settings'], functions: [...] }`.
|
|
10
|
+
- **A shell holds only the functions its principal's roles grant** (`functions`, beside `actions`, `data` and `layouts`, with the same globs, `extends` and `deny`). A role with no `functions` may call none. Before, every shell held every function. A living shell follows the roles an adopt answers, as its actions do.
|
|
11
|
+
- **The boot is refused, with the list of what to grant**, where a role on its own, a combination people wear, or `public` holds an action (or the shells ship a fragment) that calls a function its grants miss: `"member" hold "chrome.topbar", which calls "auth.leave": their functions do not grant it`. A name with a template in it is decided when it is called.
|
|
12
|
+
- **`'*'` is said at boot**: `role "member" allows every function ('*'): the generated actions of the people who hold it, or a role that extends it, may call any it does not deny`.
|
|
13
|
+
- **A grant that names no function** (a typo) is said at the first shell a process builds, with a deny that matches nothing and a function no role grants: the names of the app's functions are known once `functions(session)` has run, and are read as that first session's.
|
|
14
|
+
- **A generated action or fragment may call a function its owner's roles grant**, named written out; one they do not grant is refused when it is saved and left out when a shell is built. `session.functions()` lists the functions a session may call, `{ id, description? }`, for the model that writes one.
|
|
15
|
+
- `@niscorp/charter` has the `functions` section, and `verifyCharter` checks it where a `functions` universe is handed in.
|
|
16
|
+
|
|
17
|
+
For whoever upgrades an app, person or agent: boot it. The refusal lists, per role combination, each function an action calls that the charter does not grant. Add those names to the `functions` of the role that holds the action, or `['*']` to the roles whose people may call everything. This is the app's permissions table: write it deliberately, and do not generate it.
|
|
18
|
+
|
|
19
|
+
## 0.1.3
|
|
20
|
+
|
|
21
|
+
### Patch Changes
|
|
22
|
+
|
|
23
|
+
- de2a757: DOCS.md no longer tells an app to import `auditClosure` from `@niscorp/moss`. Moss stops exporting it (see the moss changeset): it supplies its own closure auditor whenever it verifies an app, at boot and in `verifyApp(app, grants)`. The `ClosureAuditor` section says so, and the usage pattern calls `verifyCharter` without an auditor, which is what a consumer with no auditor of its own does. No code changed.
|
|
24
|
+
|
|
25
|
+
**What to change:** nothing.
|
|
26
|
+
|
|
3
27
|
## 0.1.2
|
|
4
28
|
|
|
5
29
|
### Patch Changes
|
package/DESIGN.md
CHANGED
|
@@ -172,12 +172,14 @@ glob.
|
|
|
172
172
|
|
|
173
173
|
## Sections
|
|
174
174
|
|
|
175
|
-
A `Section` is `'actions' | 'data' | 'layouts'` — each a
|
|
176
|
-
selects Nova action ids; `data` selects `table.verb`
|
|
177
|
-
selects layout-variant ids (ring 2)
|
|
175
|
+
A `Section` is `'actions' | 'data' | 'layouts' | 'functions'` — each a
|
|
176
|
+
universe. `actions` selects Nova action ids; `data` selects `table.verb`
|
|
177
|
+
capabilities; `layouts` selects layout-variant ids (ring 2); `functions` selects
|
|
178
|
+
the names of the app's functions. The sugar keeps the common role terse: a
|
|
178
179
|
bare `string[]` is an actions-only role, and top-level `allow`/`deny` are the
|
|
179
180
|
`actions` section (so an actions-only role never names a section). Explicit
|
|
180
|
-
`actions:`/`data:`/`layouts:` selections address each universe
|
|
181
|
+
`actions:`/`data:`/`layouts:`/`functions:` selections address each universe
|
|
182
|
+
directly. Having
|
|
181
183
|
*both* the sugar and an explicit `actions:` on one role is the
|
|
182
184
|
`ambiguous-selection` error — resolution would silently drop one.
|
|
183
185
|
|
|
@@ -193,7 +195,9 @@ and the verifier all run per section against the right universe — one matcher,
|
|
|
193
195
|
one resolver, one set of lints, reused. **Adding a governed surface is adding a
|
|
194
196
|
`Section` value, a universe, and a compiler in the *target* — never a grammar
|
|
195
197
|
change here.** The `layouts` section was exactly that: one enum value, moss
|
|
196
|
-
hands the universe in, moss compiles it to substituted layouts.
|
|
198
|
+
hands the universe in, moss compiles it to substituted layouts. So was
|
|
199
|
+
`functions`: moss hands each shell only the functions its principal's roles
|
|
200
|
+
select.
|
|
197
201
|
|
|
198
202
|
---
|
|
199
203
|
|
package/DOCS.md
CHANGED
|
@@ -26,6 +26,7 @@ type RoleDef =
|
|
|
26
26
|
actions?: Selection; // the actions universe
|
|
27
27
|
data?: Selection; // the data universe
|
|
28
28
|
layouts?: Selection; // the layouts universe
|
|
29
|
+
functions?: Selection; // the app's functions this role may call
|
|
29
30
|
scoping?: string; // how far this role reaches (see below)
|
|
30
31
|
};
|
|
31
32
|
```
|
|
@@ -94,12 +95,13 @@ Within a section: a bare glob list (sugar for `{ allow }`) or explicit
|
|
|
94
95
|
### `Section`
|
|
95
96
|
|
|
96
97
|
```typescript
|
|
97
|
-
type Section = 'actions' | 'data' | 'layouts';
|
|
98
|
+
type Section = 'actions' | 'data' | 'layouts' | 'functions';
|
|
98
99
|
```
|
|
99
100
|
|
|
100
101
|
Which universe a selection resolves in. `actions` selects Nova action ids,
|
|
101
102
|
`data` selects `table.verb` capabilities, `layouts` selects layout-variant ids
|
|
102
|
-
(ring 2 — moss's dialect)
|
|
103
|
+
(ring 2 — moss's dialect), `functions` selects the names of the app's
|
|
104
|
+
functions (moss's too). A role with no `functions` may call none.
|
|
103
105
|
|
|
104
106
|
---
|
|
105
107
|
|
|
@@ -163,11 +165,12 @@ catches these and reports them as `resolution` errors rather than throwing.
|
|
|
163
165
|
Run every coherence check, per section, against that section's universe. Call
|
|
164
166
|
at boot/CI; refuse to serve if `report.errors` is non-empty.
|
|
165
167
|
|
|
166
|
-
- `universes: { actions: readonly string[]; data: readonly string[]; layouts?: readonly string[] }`
|
|
168
|
+
- `universes: { actions: readonly string[]; data: readonly string[]; layouts?: readonly string[]; functions?: readonly string[] }`
|
|
167
169
|
— the id sets each section resolves against, handed in by the composer. The
|
|
168
170
|
`layouts` universe is optional: absent, the section is inert (a charter's
|
|
169
171
|
`layouts` keys resolve against nothing and are not verified); handed in, its
|
|
170
172
|
dead-deny/dead-allow/orphan/leaves-only checks run like any other section.
|
|
173
|
+
So is `functions`, with the same checks.
|
|
171
174
|
- `wearable?: readonly (readonly string[])[]` — the role combinations a principal
|
|
172
175
|
may wear, one entry per combination (not one per person). Defaults to `[]`.
|
|
173
176
|
Read only by the `subtractive-assigned` check. A composer that has an
|
|
@@ -182,10 +185,10 @@ type ClosureAuditor = (grantedIds: readonly string[], layoutIds?: readonly strin
|
|
|
182
185
|
|
|
183
186
|
Given a role's resolved action ids (and, when the app governs layouts, its
|
|
184
187
|
granted variant ids), return the cross-action wiring problems inside that
|
|
185
|
-
closure. Supplied by the consumer that owns actions
|
|
186
|
-
`
|
|
187
|
-
substitutes granted variants so the audit sees each
|
|
188
|
-
definitions
|
|
188
|
+
closure. Supplied by the consumer that owns actions. Moss supplies its own
|
|
189
|
+
whenever it verifies an app, at boot and in `verifyApp(app, grants)`: built on
|
|
190
|
+
Nova's `auditAction`, it substitutes granted variants so the audit sees each
|
|
191
|
+
role's effective definitions. Absent, every role's `issues` is empty.
|
|
189
192
|
|
|
190
193
|
### `VerifyReport`
|
|
191
194
|
|
|
@@ -220,16 +223,17 @@ type RoleClosure = { role: string; actions: string[]; data: string[]; layouts: s
|
|
|
220
223
|
|
|
221
224
|
```typescript
|
|
222
225
|
import { resolvePrincipal, verifyCharter } from '@niscorp/charter';
|
|
223
|
-
import { auditClosure } from '@niscorp/moss';
|
|
224
226
|
import { createScopePolicy, scopeGrants } from '@niscorp/vex';
|
|
225
227
|
|
|
226
228
|
// 1. Boot: derive the universes from the governed targets, refuse incoherence.
|
|
229
|
+
// (An app served by moss does not write this step: moss runs it at boot,
|
|
230
|
+
// with its closure auditor, and `verifyApp(app, grants)` runs it for a check.)
|
|
227
231
|
const universes = {
|
|
228
232
|
actions: Object.keys(app.actions), // the shell's dialect
|
|
229
233
|
data: scopeGrants(tableNames), // vex's dialect — `table.verb` leaves
|
|
230
234
|
};
|
|
231
235
|
const wearable = Object.values(app.assignments); // the role combinations in use
|
|
232
|
-
const report = verifyCharter(app.charter, universes, wearable
|
|
236
|
+
const report = verifyCharter(app.charter, universes, wearable);
|
|
233
237
|
if (report.errors.length > 0) {
|
|
234
238
|
throw new Error(report.errors.map((e) => `${e.rule}: ${e.detail}`).join('\n'));
|
|
235
239
|
}
|
package/dist/index.cjs
CHANGED
|
@@ -60,16 +60,22 @@ var resolvePrincipal = (charter, universe, roles, section = "actions") => {
|
|
|
60
60
|
// src/verify.ts
|
|
61
61
|
var verifyCharter = (charter, universes, wearable = [], closure) => {
|
|
62
62
|
const actionUniverse = universes.actions;
|
|
63
|
-
const sections =
|
|
63
|
+
const sections = [
|
|
64
|
+
"actions",
|
|
65
|
+
"data",
|
|
66
|
+
...universes.layouts === void 0 ? [] : ["layouts"],
|
|
67
|
+
...universes.functions === void 0 ? [] : ["functions"]
|
|
68
|
+
];
|
|
64
69
|
const universeOf = {
|
|
65
70
|
actions: universes.actions,
|
|
66
71
|
data: universes.data,
|
|
67
|
-
layouts: universes.layouts ?? []
|
|
72
|
+
layouts: universes.layouts ?? [],
|
|
73
|
+
functions: universes.functions ?? []
|
|
68
74
|
};
|
|
69
75
|
const errors = [];
|
|
70
76
|
const warnings = [];
|
|
71
77
|
const perRole = [];
|
|
72
|
-
const resolved = { actions: /* @__PURE__ */ new Map(), data: /* @__PURE__ */ new Map(), layouts: /* @__PURE__ */ new Map() };
|
|
78
|
+
const resolved = { actions: /* @__PURE__ */ new Map(), data: /* @__PURE__ */ new Map(), layouts: /* @__PURE__ */ new Map(), functions: /* @__PURE__ */ new Map() };
|
|
73
79
|
for (const section of sections) {
|
|
74
80
|
const memo = /* @__PURE__ */ new Map();
|
|
75
81
|
for (const role of Object.keys(charter)) {
|
|
@@ -122,6 +128,7 @@ var verifyCharter = (charter, universes, wearable = [], closure) => {
|
|
|
122
128
|
};
|
|
123
129
|
orphans("actions", "action");
|
|
124
130
|
if (universes.layouts !== void 0) orphans("layouts", "layout variant");
|
|
131
|
+
if (universes.functions !== void 0) orphans("functions", "function");
|
|
125
132
|
const ancestorDenied = (role, section, seen = /* @__PURE__ */ new Set()) => {
|
|
126
133
|
const out = /* @__PURE__ */ new Set();
|
|
127
134
|
const def = charter[role];
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/glob.ts","../src/resolve.ts","../src/verify.ts"],"names":[],"mappings":";;;AAIA,IAAM,eAAe,CAAC,CAAA,KAAsB,CAAA,CAAE,OAAA,CAAQ,uBAAuB,MAAM,CAAA;AAEnF,IAAM,WAAW,CAAC,OAAA,KAA4B,IAAI,MAAA,CAAO,IAAI,OAAA,CAAQ,KAAA,CAAM,GAAG,CAAA,CAAE,IAAI,YAAY,CAAA,CAAE,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAG,CAAA;AAExG,IAAM,SAAA,GAAY,CAAC,OAAA,EAAiB,EAAA,KAAwB,SAAS,OAAO,CAAA,CAAE,KAAK,EAAE;AAGrF,IAAM,QAAA,GAAW,CAAC,QAAA,EAA6B,GAAA,KAAwC;AAC5F,EAAA,MAAM,GAAA,uBAAU,GAAA,EAAY;AAC5B,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,MAAM,EAAA,GAAK,SAAS,OAAO,CAAA;AAC3B,IAAA,KAAA,MAAW,EAAA,IAAM,KAAK,IAAI,EAAA,CAAG,KAAK,EAAE,CAAA,EAAG,GAAA,CAAI,GAAA,CAAI,EAAE,CAAA;AAAA,EACnD;AACA,EAAA,OAAO,GAAA;AACT;;;ACAO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EACtC,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AAAA,EACd;AACF;AAQA,IAAM,WAAA,GAAc,CAAC,CAAA,KACnB,CAAA,KAAM,SAAY,EAAE,KAAA,EAAO,EAAC,EAAG,MAAM,EAAC,EAAE,GAAI,KAAA,CAAM,QAAQ,CAAC,CAAA,GAAI,EAAE,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,EAAC,KAAM,EAAE,KAAA,EAAO,CAAA,CAAE,KAAA,IAAS,EAAC,EAAG,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,EAAC,EAAE;AAK9H,IAAM,aAAA,GAAgB,CAC3B,GAAA,EACA,OAAA,KAC8E;AAC9E,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACtB,IAAA,OAAO,OAAA,KAAY,SAAA,GACf,EAAE,KAAA,EAAO,GAAA,EAAK,IAAA,EAAM,EAAC,EAAG,OAAA,EAAS,EAAC,EAAG,OAAA,EAAS,EAAC,EAAE,GACjD,EAAE,KAAA,EAAO,EAAC,EAAG,IAAA,EAAM,EAAC,EAAG,OAAA,EAAS,EAAC,EAAG,OAAA,EAAS,EAAC,EAAE;AAAA,EACtD;AACA,EAAA,MAAM,WAAA,GAAc,EAAE,OAAA,EAAS,GAAA,CAAI,OAAA,IAAW,EAAC,EAAG,OAAA,EAAS,GAAA,CAAI,OAAA,IAAW,EAAC,EAAE;AAE7E,EAAA,MAAM,GAAA,GACJ,YAAY,SAAA,IAAa,GAAA,CAAI,YAAY,MAAA,GACrC,EAAE,OAAO,GAAA,CAAI,KAAA,IAAS,EAAC,EAAG,IAAA,EAAM,IAAI,IAAA,IAAQ,IAAG,GAC/C,WAAA,CAAY,GAAA,CAAI,OAAO,CAAC,CAAA;AAC9B,EAAA,OAAO,EAAE,GAAG,GAAA,EAAK,GAAG,WAAA,EAAY;AAClC;AAEO,IAAM,WAAA,GAAc,CACzB,OAAA,EACA,QAAA,EACA,IAAA,EACA,OAAA,EACA,IAAA,mBAAyC,IAAI,GAAA,EAAI,EACjD,QAAA,mBAAwB,IAAI,KAAI,KACR;AACxB,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA;AAC5B,EAAA,IAAI,MAAA,KAAW,QAAW,OAAO,MAAA;AACjC,EAAA,MAAM,GAAA,GAAM,QAAQ,IAAI,CAAA;AACxB,EAAA,IAAI,QAAQ,MAAA,EAAW,MAAM,IAAI,YAAA,CAAa,CAAA,cAAA,EAAiB,IAAI,CAAA,CAAA,CAAG,CAAA;AACtE,EAAA,IAAI,QAAA,CAAS,IAAI,IAAI,CAAA,QAAS,IAAI,YAAA,CAAa,CAAA,oBAAA,EAAuB,IAAI,CAAA,CAAA,CAAG,CAAA;AAC7E,EAAA,QAAA,CAAS,IAAI,IAAI,CAAA;AAEjB,EAAA,MAAM,EAAE,OAAO,OAAA,EAAS,OAAA,EAAS,MAAM,OAAA,EAAQ,GAAI,aAAA,CAAc,GAAA,EAAK,OAAO,CAAA;AAC7E,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAY;AACjC,EAAA,KAAA,MAAW,MAAA,IAAU,OAAA,EAAS,KAAA,MAAW,EAAA,IAAM,YAAY,OAAA,EAAS,QAAA,EAAU,MAAA,EAAQ,OAAA,EAAS,IAAA,EAAM,QAAQ,CAAA,EAAG,QAAA,CAAS,IAAI,EAAE,CAAA;AAC/H,EAAA,KAAA,MAAW,MAAM,QAAA,CAAS,KAAA,EAAO,QAAQ,CAAA,EAAG,QAAA,CAAS,IAAI,EAAE,CAAA;AAC3D,EAAA,KAAA,MAAW,MAAM,QAAA,CAAS,IAAA,EAAM,QAAQ,CAAA,EAAG,QAAA,CAAS,OAAO,EAAE,CAAA;AAC7D,EAAA,KAAA,MAAW,GAAA,IAAO,OAAA,EAAS,KAAA,MAAW,EAAA,IAAM,YAAY,OAAA,EAAS,QAAA,EAAU,GAAA,EAAK,OAAA,EAAS,IAAA,EAAM,QAAQ,CAAA,EAAG,QAAA,CAAS,OAAO,EAAE,CAAA;AAE5H,EAAA,QAAA,CAAS,OAAO,IAAI,CAAA;AACpB,EAAA,IAAA,CAAK,GAAA,CAAI,MAAM,QAAQ,CAAA;AACvB,EAAA,OAAO,QAAA;AACT;AAkBO,IAAM,cAAA,GAAiB,CAAC,OAAA,EAAkB,IAAA,KAAqC;AACpF,EAAA,MAAM,GAAA,GAAM,QAAQ,IAAI,CAAA;AACxB,EAAA,OAAO,QAAQ,MAAA,IAAa,KAAA,CAAM,QAAQ,GAAG,CAAA,GAAI,SAAY,GAAA,CAAI,OAAA;AACnE;AAEO,IAAM,mBAAmB,CAC9B,OAAA,EACA,QAAA,EACA,KAAA,EACA,UAAmB,SAAA,KACH;AAChB,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAiC;AAClD,EAAA,MAAM,GAAA,uBAAU,GAAA,EAAY;AAC5B,EAAA,KAAA,MAAW,IAAA,IAAQ,KAAA,EAAO,KAAA,MAAW,EAAA,IAAM,WAAA,CAAY,OAAA,EAAS,QAAA,EAAU,IAAA,EAAM,OAAA,EAAS,IAAI,CAAA,EAAG,GAAA,CAAI,IAAI,EAAE,CAAA;AAC1G,EAAA,OAAO,GAAA;AACT;;;AChFO,IAAM,gBAAgB,CAC3B,OAAA,EACA,WAMA,QAAA,GAA2C,IAC3C,OAAA,KACiB;AACjB,EAAA,MAAM,iBAAiB,SAAA,CAAU,OAAA;AAIjC,EAAA,MAAM,QAAA,GAAsB,SAAA,CAAU,OAAA,KAAY,MAAA,GAAY,CAAC,SAAA,EAAW,MAAM,CAAA,GAAI,CAAC,SAAA,EAAW,MAAA,EAAQ,SAAS,CAAA;AACjH,EAAA,MAAM,UAAA,GAAiD;AAAA,IACrD,SAAS,SAAA,CAAU,OAAA;AAAA,IACnB,MAAM,SAAA,CAAU,IAAA;AAAA,IAChB,OAAA,EAAS,SAAA,CAAU,OAAA,IAAW;AAAC,GACjC;AAEA,EAAA,MAAM,SAAwB,EAAC;AAC/B,EAAA,MAAM,WAA0B,EAAC;AACjC,EAAA,MAAM,UAAyB,EAAC;AAIhC,EAAA,MAAM,QAAA,GAA8D,EAAE,OAAA,kBAAS,IAAI,GAAA,EAAI,EAAG,IAAA,kBAAM,IAAI,GAAA,EAAI,EAAG,OAAA,kBAAS,IAAI,KAAI,EAAE;AAC9H,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,MAAM,IAAA,uBAAW,GAAA,EAAiC;AAClD,IAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAG;AACvC,MAAA,IAAI;AACF,QAAA,QAAA,CAAS,OAAO,CAAA,CAAE,GAAA,CAAI,IAAA,EAAM,WAAA,CAAY,OAAA,EAAS,UAAA,CAAW,OAAO,CAAA,EAAG,IAAA,EAAM,OAAA,EAAS,IAAI,CAAC,CAAA;AAAA,MAC5F,SAAS,CAAA,EAAG;AACV,QAAA,MAAA,CAAO,KAAK,EAAE,KAAA,EAAO,SAAS,IAAA,EAAM,YAAA,EAAc,QAAQ,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,CAAA,YAAa,eAAe,CAAA,CAAE,OAAA,GAAU,OAAO,CAAC,CAAC,IAAI,CAAA;AAAA,MAChI;AAAA,IACF;AAAA,EACF;AAIA,EAAA,MAAM,UAAA,GAAa,CAAC,QAAA,EAA6B,IAAA,KAAuB;AACtE,IAAA,KAAA,MAAW,KAAK,QAAA,EAAU;AACxB,MAAA,KAAA,MAAW,KAAK,QAAA,EAAU;AACxB,QAAA,IAAI,CAAA,CAAE,UAAA,CAAW,CAAA,EAAG,CAAC,GAAG,CAAA,EAAG;AACzB,UAAA,MAAA,CAAO,IAAA,CAAK,EAAE,KAAA,EAAO,OAAA,EAAS,MAAM,aAAA,EAAe,MAAA,EAAQ,CAAA,IAAA,EAAO,CAAC,CAAA,qBAAA,EAAwB,CAAC,CAAA,8BAAA,EAA4B,IAAI,IAAI,CAAA;AAChI,UAAA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAA;AACA,EAAA,UAAA,CAAW,gBAAgB,SAAS,CAAA;AACpC,EAAA,IAAI,UAAU,OAAA,KAAY,MAAA,EAAW,UAAA,CAAW,SAAA,CAAU,SAAS,UAAU,CAAA;AAK7E,EAAA,KAAA,MAAW,CAAC,IAAA,EAAM,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACjD,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACxB,IAAA,IAAI,GAAA,CAAI,YAAY,MAAA,KAAc,GAAA,CAAI,UAAU,MAAA,IAAa,GAAA,CAAI,SAAS,MAAA,CAAA,EAAY;AACpF,MAAA,MAAA,CAAO,IAAA,CAAK,EAAE,KAAA,EAAO,OAAA,EAAS,IAAA,EAAM,uBAAuB,MAAA,EAAQ,CAAA,MAAA,EAAS,IAAI,CAAA,yFAAA,CAAA,EAAwF,CAAA;AAAA,IAC1K;AAAA,EACF;AAGA,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,GAAG,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACjD,MAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,aAAA,CAAc,KAAK,OAAO,CAAA;AAClD,MAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,QAAA,IAAI,QAAA,CAAS,CAAC,IAAI,CAAA,EAAG,WAAW,OAAO,CAAC,CAAA,CAAE,IAAA,KAAS,CAAA,EAAG;AACpD,UAAA,MAAA,CAAO,IAAA,CAAK,EAAE,KAAA,EAAO,OAAA,EAAS,MAAM,WAAA,EAAa,MAAA,EAAQ,CAAA,MAAA,EAAS,IAAI,CAAA,UAAA,EAAa,IAAI,CAAA,GAAA,EAAM,OAAO,2DAAsD,CAAA;AAAA,QAC5J;AAAA,MACF;AACA,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,IAAI,QAAA,CAAS,CAAC,IAAI,CAAA,EAAG,WAAW,OAAO,CAAC,CAAA,CAAE,IAAA,KAAS,CAAA,EAAG;AACpD,UAAA,QAAA,CAAS,IAAA,CAAK,EAAE,KAAA,EAAO,SAAA,EAAW,MAAM,YAAA,EAAc,MAAA,EAAQ,CAAA,MAAA,EAAS,IAAI,CAAA,UAAA,EAAa,IAAI,CAAA,GAAA,EAAM,OAAO,2BAA2B,CAAA;AAAA,QACtI;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAKA,EAAA,MAAM,OAAA,GAAU,CAAC,OAAA,EAAkB,IAAA,KAAuB;AACxD,IAAA,MAAM,SAAA,uBAAgB,GAAA,EAAY;AAClC,IAAA,KAAA,MAAW,GAAA,IAAO,QAAA,CAAS,OAAO,CAAA,CAAE,MAAA,EAAO,EAAG,KAAA,MAAW,EAAA,IAAM,GAAA,EAAK,SAAA,CAAU,GAAA,CAAI,EAAE,CAAA;AACpF,IAAA,KAAA,MAAW,EAAA,IAAM,UAAA,CAAW,OAAO,CAAA,EAAG;AACpC,MAAA,IAAI,CAAC,SAAA,CAAU,GAAA,CAAI,EAAE,CAAA,EAAG,QAAA,CAAS,KAAK,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA,EAAM,UAAU,MAAA,EAAQ,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,EAAE,2DAAsD,CAAA;AAAA,IACxJ;AAAA,EACF,CAAA;AACA,EAAA,OAAA,CAAQ,WAAW,QAAQ,CAAA;AAC3B,EAAA,IAAI,SAAA,CAAU,OAAA,KAAY,MAAA,EAAW,OAAA,CAAQ,WAAW,gBAAgB,CAAA;AAGxE,EAAA,MAAM,iBAAiB,CAAC,IAAA,EAAc,SAAkB,IAAA,mBAAoB,IAAI,KAAI,KAAmB;AACrG,IAAA,MAAM,GAAA,uBAAU,GAAA,EAAY;AAC5B,IAAA,MAAM,GAAA,GAAM,QAAQ,IAAI,CAAA;AACxB,IAAA,IAAI,QAAQ,MAAA,IAAa,IAAA,CAAK,GAAA,CAAI,IAAI,GAAG,OAAO,GAAA;AAChD,IAAA,IAAA,CAAK,IAAI,IAAI,CAAA;AACb,IAAA,KAAA,MAAW,MAAA,IAAU,aAAA,CAAc,GAAA,EAAK,OAAO,EAAE,OAAA,EAAS;AACxD,MAAA,MAAM,SAAA,GAAY,QAAQ,MAAM,CAAA;AAChC,MAAA,IAAI,cAAc,MAAA,EAAW;AAC7B,MAAA,KAAA,MAAW,EAAA,IAAM,QAAA,CAAS,aAAA,CAAc,SAAA,EAAW,OAAO,CAAA,CAAE,IAAA,EAAM,UAAA,CAAW,OAAO,CAAC,CAAA,EAAG,GAAA,CAAI,IAAI,EAAE,CAAA;AAClG,MAAA,KAAA,MAAW,EAAA,IAAM,eAAe,MAAA,EAAQ,OAAA,EAAS,IAAI,CAAA,EAAG,GAAA,CAAI,IAAI,EAAE,CAAA;AAAA,IACpE;AACA,IAAA,OAAO,GAAA;AAAA,EACT,CAAA;AACA,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,GAAG,CAAA,IAAK,QAAA,CAAS,OAAO,CAAA,EAAG;AAC3C,MAAA,KAAA,MAAW,EAAA,IAAM,cAAA,CAAe,IAAA,EAAM,OAAO,CAAA,EAAG;AAC9C,QAAA,IAAI,GAAA,CAAI,GAAA,CAAI,EAAE,CAAA,EAAG;AACf,UAAA,QAAA,CAAS,IAAA,CAAK,EAAE,KAAA,EAAO,SAAA,EAAW,MAAM,UAAA,EAAY,MAAA,EAAQ,CAAA,MAAA,EAAS,IAAI,CAAA,aAAA,EAAgB,EAAE,CAAA,GAAA,EAAM,OAAO,8BAA8B,CAAA;AAAA,QACxI;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAY;AACpC,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA,EAAG;AACxC,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA,EAAG;AACxB,IAAA,KAAA,MAAW,OAAO,GAAA,CAAI,OAAA,IAAW,EAAC,EAAG,WAAA,CAAY,IAAI,GAAG,CAAA;AAAA,EAC1D;AACA,EAAA,MAAM,IAAA,GAAO,IAAI,GAAA,CAAI,QAAA,CAAS,MAAM,CAAA;AACpC,EAAA,KAAA,MAAW,QAAQ,WAAA,EAAa;AAC9B,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA,EAAG;AAClB,MAAA,QAAA,CAAS,IAAA,CAAK,EAAE,KAAA,EAAO,SAAA,EAAW,IAAA,EAAM,wBAAwB,MAAA,EAAQ,CAAA,MAAA,EAAS,IAAI,CAAA,gEAAA,CAAA,EAAoE,CAAA;AAAA,IAC3J;AAAA,EACF;AAIA,EAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,EAAG;AACvC,IAAA,MAAM,OAAA,GAAU,CAAC,GAAI,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA,IAAK,EAAG,CAAA,CAAE,IAAA,EAAK;AAC7D,IAAA,MAAM,IAAA,GAAO,CAAC,GAAI,QAAA,CAAS,IAAA,CAAK,GAAA,CAAI,IAAI,CAAA,IAAK,EAAG,CAAA,CAAE,IAAA,EAAK;AACvD,IAAA,MAAM,OAAA,GAAU,CAAC,GAAI,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA,IAAK,EAAG,CAAA,CAAE,IAAA,EAAK;AAC7D,IAAA,MAAM,MAAA,GAAS,OAAA,GAAU,OAAA,EAAS,OAAO,KAAK,EAAC;AAC/C,IAAA,OAAA,CAAQ,KAAK,EAAE,IAAA,EAAM,SAAS,IAAA,EAAM,OAAA,EAAS,QAAQ,CAAA;AAAA,EACvD;AAEA,EAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,EAAU,OAAA,EAAQ;AACrC","file":"index.cjs","sourcesContent":["// One wildcard rule, no more: `*` matches any run of characters, including\n// dots — `crm.*` matches `crm.deal.form`. No `**`, no braces, no regex. The\n// day a pattern cannot be expressed, the answer is a better id, not a\n// richer glob.\nconst escapeRegExp = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\nconst toRegExp = (pattern: string): RegExp => new RegExp(`^${pattern.split('*').map(escapeRegExp).join('.*')}$`);\n\nexport const matchGlob = (pattern: string, id: string): boolean => toRegExp(pattern).test(id);\n\n// Every id the pattern list selects out of `ids`.\nexport const matchAll = (patterns: readonly string[], ids: readonly string[]): Set<string> => {\n const out = new Set<string>();\n for (const pattern of patterns) {\n const re = toRegExp(pattern);\n for (const id of ids) if (re.test(id)) out.add(id);\n }\n return out;\n};\n","import type { Charter, RoleDef, Section, Selection } from './types';\nimport { matchAll } from './glob';\n\n// Resolution is a pure function from (charter, universe, section) to a\n// concrete id set per role — the algebra from DESIGN.md § The algebra,\n// verbatim, per section:\n//\n// resolved(role) = (∪ resolved(extends) ∪ match(allow))\n// − match(deny)\n// − ∪ resolved(without)\n//\n// The engine is UNIVERSE-BLIND: it resolves globs over opaque strings and\n// never learns what a string means. `actions` and `data` run the SAME code\n// against different universes. Order-independent (all subtraction is\n// set-minus); deny wins within a role; denies do NOT inherit (a child may\n// re-add what a parent denied — the verifier flags it); cycles and unknown\n// references are errors.\n\nexport class CharterError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'CharterError';\n }\n}\n\n// NOTE deliberately absent: the engine never MANUFACTURES a universe — it is\n// always handed one. The data universe's atoms are the governed target's own\n// dialect (vex exports `SCOPE_VERBS` and `scopeGrants(tables)`); the app\n// wiring derives it and passes it in. That keeps this module free of any\n// foreign import, in either direction.\n\nconst asSelection = (s: Selection | undefined): { allow: string[]; deny: string[] } =>\n s === undefined ? { allow: [], deny: [] } : Array.isArray(s) ? { allow: s, deny: [] } : { allow: s.allow ?? [], deny: s.deny ?? [] };\n\n// A role's atoms for ONE section, plus its role-level composition (shared\n// across sections). A bare array is an actions-only role; top-level\n// `allow`/`deny` are sugar for the `actions` section.\nexport const normalizeRole = (\n def: RoleDef,\n section: Section,\n): { allow: string[]; deny: string[]; extends: string[]; without: string[] } => {\n if (Array.isArray(def)) {\n return section === 'actions'\n ? { allow: def, deny: [], extends: [], without: [] }\n : { allow: [], deny: [], extends: [], without: [] };\n }\n const composition = { extends: def.extends ?? [], without: def.without ?? [] };\n // Actions: explicit `actions:` wins, else the top-level allow/deny sugar.\n const sel =\n section === 'actions' && def.actions === undefined\n ? { allow: def.allow ?? [], deny: def.deny ?? [] }\n : asSelection(def[section]);\n return { ...sel, ...composition };\n};\n\nexport const resolveRole = (\n charter: Charter,\n universe: readonly string[],\n role: string,\n section: Section,\n memo: Map<string, ReadonlySet<string>> = new Map(),\n visiting: Set<string> = new Set(),\n): ReadonlySet<string> => {\n const cached = memo.get(role);\n if (cached !== undefined) return cached;\n const def = charter[role];\n if (def === undefined) throw new CharterError(`Unknown role \"${role}\"`);\n if (visiting.has(role)) throw new CharterError(`Role cycle through \"${role}\"`);\n visiting.add(role);\n\n const { allow, extends: parents, deny, without } = normalizeRole(def, section);\n const resolved = new Set<string>();\n for (const parent of parents) for (const id of resolveRole(charter, universe, parent, section, memo, visiting)) resolved.add(id);\n for (const id of matchAll(allow, universe)) resolved.add(id);\n for (const id of matchAll(deny, universe)) resolved.delete(id);\n for (const sub of without) for (const id of resolveRole(charter, universe, sub, section, memo, visiting)) resolved.delete(id);\n\n visiting.delete(role);\n memo.set(role, resolved);\n return resolved;\n};\n\n// A principal wears roles; a section's grant is the union of their resolved\n// sets in that section's universe.\n// The reach a ROLE was given: the profile it names, or none.\n//\n// SINGULAR ON PURPOSE. This took a list of roles and refused when two of them\n// named different profiles — \"incoherence rather than a precedence puzzle,\n// refused in the same spirit as two granted layout variants for one action.\"\n// That analogy was wrong. Two layout variants for one action genuinely conflict,\n// because a screen renders one of them; two roles naming different reaches is\n// somebody who teaches at a studio AND trains there, which is a person, not a\n// contradiction.\n//\n// A caller who holds several roles resolves each one separately and merges the\n// results (vex: `mergeScopePolicies`). That is where \"holding two roles\" is\n// decided, and it belongs there — reach is a property of a role, so a function\n// handed several of them has no answer to give, only a choice to refuse.\nexport const resolveScoping = (charter: Charter, role: string): string | undefined => {\n const def = charter[role];\n return def === undefined || Array.isArray(def) ? undefined : def.scoping;\n};\n\nexport const resolvePrincipal = (\n charter: Charter,\n universe: readonly string[],\n roles: readonly string[],\n section: Section = 'actions',\n): Set<string> => {\n const memo = new Map<string, ReadonlySet<string>>();\n const out = new Set<string>();\n for (const role of roles) for (const id of resolveRole(charter, universe, role, section, memo)) out.add(id);\n return out;\n};\n","import type { Charter, Section } from './types';\nimport { matchAll } from './glob';\nimport { CharterError, normalizeRole, resolveRole } from './resolve';\n\n// ═══════════════════════════════════════════════════════════\n// The verifier — the other half of the charter (DESIGN.md § The verifier\n// is the other half). The grammar\n// stays small; the opinions live here. Boot/CI runs it and refuses an\n// incoherent charter: \"if it boots, it's coherent.\"\n//\n// Every check runs PER SECTION against that section's universe. Like the\n// resolver, the verifier is universe-blind: every universe is HANDED IN\n// (the atoms are each governed target's own dialect — nova action ids, vex\n// verb leaves), and the per-role closure audit is an injected hook (nova\n// exports one), so this module imports nothing. Severities are asymmetric\n// on purpose: a dead DENY is an error (a typo'd deny fails silent, and\n// silent means unprotected); a dead allow is a warning.\n// ═══════════════════════════════════════════════════════════\n\nexport type VerifyIssue = { level: 'error' | 'warning'; rule: string; detail: string };\n\nexport type RoleClosure = { role: string; actions: string[]; data: string[]; layouts: string[]; issues: string[] };\n\nexport type VerifyReport = { errors: VerifyIssue[]; warnings: VerifyIssue[]; perRole: RoleClosure[] };\n\n// The per-role closure audit: given a role's granted action ids (and, when\n// the app governs layouts, its granted layout-variant ids), report the\n// cross-action wiring problems inside that closure (targets that aren't in\n// it, channels nobody serves). The consumer that OWNS actions provides it —\n// moss builds one from nova's audit, substituting granted variants so the\n// closure sees each role's EFFECTIVE definitions.\nexport type ClosureAuditor = (grantedIds: readonly string[], layoutIds?: readonly string[]) => string[];\n\nexport const verifyCharter = (\n charter: Charter,\n universes: { actions: readonly string[]; data: readonly string[]; layouts?: readonly string[] },\n // THE ROLE COMBINATIONS A PRINCIPAL MAY WEAR — one entry per combination, not\n // one per person. The only rule below that reads it (`subtractive-assigned`)\n // wants the set of roles somebody actually holds, and a population is a very\n // expensive way to spell a set. A composer that still holds an assignment map\n // passes `Object.values(map)`; one that declares its combinations passes them.\n wearable: readonly (readonly string[])[] = [],\n closure?: ClosureAuditor,\n): VerifyReport => {\n const actionUniverse = universes.actions;\n // The layouts section is verified only when the composer governs layouts\n // (hands a universe in) — absent, a charter's `layouts` keys are inert\n // here exactly as they are in resolution against an empty universe.\n const sections: Section[] = universes.layouts === undefined ? ['actions', 'data'] : ['actions', 'data', 'layouts'];\n const universeOf: Record<Section, readonly string[]> = {\n actions: universes.actions,\n data: universes.data,\n layouts: universes.layouts ?? [],\n };\n\n const errors: VerifyIssue[] = [];\n const warnings: VerifyIssue[] = [];\n const perRole: RoleClosure[] = [];\n\n // Resolve every role in every section up front (also surfaces cycles /\n // unknown references, per section).\n const resolved: Record<Section, Map<string, ReadonlySet<string>>> = { actions: new Map(), data: new Map(), layouts: new Map() };\n for (const section of sections) {\n const memo = new Map<string, ReadonlySet<string>>();\n for (const role of Object.keys(charter)) {\n try {\n resolved[section].set(role, resolveRole(charter, universeOf[section], role, section, memo));\n } catch (e) {\n errors.push({ level: 'error', rule: 'resolution', detail: `${section}: ${e instanceof CharterError ? e.message : String(e)}` });\n }\n }\n }\n\n // ── ids are leaves; namespaces are never actions. Same rule inside the\n // layouts universe — a variant id is never a namespace of another ──\n const leavesOnly = (universe: readonly string[], kind: string): void => {\n for (const a of universe) {\n for (const b of universe) {\n if (b.startsWith(`${a}.`)) {\n errors.push({ level: 'error', rule: 'leaves-only', detail: `id \"${a}\" is a namespace of \"${b}\" — namespaces are never ${kind}` });\n break;\n }\n }\n }\n };\n leavesOnly(actionUniverse, 'actions');\n if (universes.layouts !== undefined) leavesOnly(universes.layouts, 'variants');\n\n // ── one selection per section: top-level allow/deny (the actions sugar)\n // AND an `actions` key on the same role means resolution silently drops\n // the sugar — silent means wrong, so boot refuses ──\n for (const [role, def] of Object.entries(charter)) {\n if (Array.isArray(def)) continue;\n if (def.actions !== undefined && (def.allow !== undefined || def.deny !== undefined)) {\n errors.push({ level: 'error', rule: 'ambiguous-selection', detail: `role \"${role}\" has both top-level allow/deny and an \"actions\" section — one selection per section` });\n }\n }\n\n // ── dead deny = error, dead allow = warning; per glob, per role, per section ──\n for (const section of sections) {\n for (const [role, def] of Object.entries(charter)) {\n const { allow, deny } = normalizeRole(def, section);\n for (const glob of deny) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n errors.push({ level: 'error', rule: 'dead-deny', detail: `role \"${role}\" denies \"${glob}\" (${section}) which matches nothing — silent means unprotected` });\n }\n }\n for (const glob of allow) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n warnings.push({ level: 'warning', rule: 'dead-allow', detail: `role \"${role}\" allows \"${glob}\" (${section}) which matches nothing` });\n }\n }\n }\n }\n\n // ── orphans: matched by no role at all. Actions and layout variants share\n // the rule — both are deployed-but-unreachable artifacts. An ungranted\n // data phase is simply denied, not a mistake ──\n const orphans = (section: Section, kind: string): void => {\n const reachable = new Set<string>();\n for (const set of resolved[section].values()) for (const id of set) reachable.add(id);\n for (const id of universeOf[section]) {\n if (!reachable.has(id)) warnings.push({ level: 'warning', rule: 'orphan', detail: `${kind} \"${id}\" is granted by no role — deployed but unreachable` });\n }\n };\n orphans('actions', 'action');\n if (universes.layouts !== undefined) orphans('layouts', 'layout variant');\n\n // ── re-allow of an ancestor's deny (F1), per section ──\n const ancestorDenied = (role: string, section: Section, seen: Set<string> = new Set()): Set<string> => {\n const out = new Set<string>();\n const def = charter[role];\n if (def === undefined || seen.has(role)) return out;\n seen.add(role);\n for (const parent of normalizeRole(def, section).extends) {\n const parentDef = charter[parent];\n if (parentDef === undefined) continue;\n for (const id of matchAll(normalizeRole(parentDef, section).deny, universeOf[section])) out.add(id);\n for (const id of ancestorDenied(parent, section, seen)) out.add(id);\n }\n return out;\n };\n for (const section of sections) {\n for (const [role, set] of resolved[section]) {\n for (const id of ancestorDenied(role, section)) {\n if (set.has(id)) {\n warnings.push({ level: 'warning', rule: 're-allow', detail: `role \"${role}\" re-allows \"${id}\" (${section}) which an ancestor denied` });\n }\n }\n }\n }\n\n // ── a role referenced in `without` that principals also wear (F2) ──\n const subtractive = new Set<string>();\n for (const def of Object.values(charter)) {\n if (Array.isArray(def)) continue;\n for (const sub of def.without ?? []) subtractive.add(sub);\n }\n const worn = new Set(wearable.flat());\n for (const role of subtractive) {\n if (worn.has(role)) {\n warnings.push({ level: 'warning', rule: 'subtractive-assigned', detail: `role \"${role}\" is referenced in \"without\" but is also assigned to a principal` });\n }\n }\n\n // ── per-role closure: the action-catalog audit (cross-action wiring),\n // fed the role's granted variants so it audits EFFECTIVE definitions ──\n for (const role of Object.keys(charter)) {\n const actions = [...(resolved.actions.get(role) ?? [])].sort();\n const data = [...(resolved.data.get(role) ?? [])].sort();\n const layouts = [...(resolved.layouts.get(role) ?? [])].sort();\n const issues = closure?.(actions, layouts) ?? [];\n perRole.push({ role, actions, data, layouts, issues });\n }\n\n return { errors, warnings, perRole };\n};\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/glob.ts","../src/resolve.ts","../src/verify.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["const escapeRegExp = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\nconst toRegExp = (pattern: string): RegExp => new RegExp(`^${pattern.split('*').map(escapeRegExp).join('.*')}$`);\n\nexport const matchGlob = (pattern: string, id: string): boolean => toRegExp(pattern).test(id);\n\nexport const matchAll = (patterns: readonly string[], ids: readonly string[]): Set<string> => {\n const out = new Set<string>();\n for (const pattern of patterns) {\n const re = toRegExp(pattern);\n for (const id of ids) if (re.test(id)) out.add(id);\n }\n return out;\n};\n","import type { Charter, RoleDef, Section, Selection } from './types';\nimport { matchAll } from './glob';\n\nexport class CharterError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'CharterError';\n }\n}\n\nconst asSelection = (s: Selection | undefined): { allow: string[]; deny: string[] } =>\n s === undefined ? { allow: [], deny: [] } : Array.isArray(s) ? { allow: s, deny: [] } : { allow: s.allow ?? [], deny: s.deny ?? [] };\n\nexport const normalizeRole = (\n def: RoleDef,\n section: Section,\n): { allow: string[]; deny: string[]; extends: string[]; without: string[] } => {\n if (Array.isArray(def)) {\n return section === 'actions'\n ? { allow: def, deny: [], extends: [], without: [] }\n : { allow: [], deny: [], extends: [], without: [] };\n }\n const composition = { extends: def.extends ?? [], without: def.without ?? [] };\n const sel =\n section === 'actions' && def.actions === undefined\n ? { allow: def.allow ?? [], deny: def.deny ?? [] }\n : asSelection(def[section]);\n return { ...sel, ...composition };\n};\n\nexport const resolveRole = (\n charter: Charter,\n universe: readonly string[],\n role: string,\n section: Section,\n memo: Map<string, ReadonlySet<string>> = new Map(),\n visiting: Set<string> = new Set(),\n): ReadonlySet<string> => {\n const cached = memo.get(role);\n if (cached !== undefined) return cached;\n const def = charter[role];\n if (def === undefined) throw new CharterError(`Unknown role \"${role}\"`);\n if (visiting.has(role)) throw new CharterError(`Role cycle through \"${role}\"`);\n visiting.add(role);\n\n const { allow, extends: parents, deny, without } = normalizeRole(def, section);\n const resolved = new Set<string>();\n for (const parent of parents) for (const id of resolveRole(charter, universe, parent, section, memo, visiting)) resolved.add(id);\n for (const id of matchAll(allow, universe)) resolved.add(id);\n for (const id of matchAll(deny, universe)) resolved.delete(id);\n for (const sub of without) for (const id of resolveRole(charter, universe, sub, section, memo, visiting)) resolved.delete(id);\n\n visiting.delete(role);\n memo.set(role, resolved);\n return resolved;\n};\n\n// One role, not a list: two roles naming different profiles are not a conflict\n// to refuse. A caller holding several resolves each and merges the results.\nexport const resolveScoping = (charter: Charter, role: string): string | undefined => {\n const def = charter[role];\n return def === undefined || Array.isArray(def) ? undefined : def.scoping;\n};\n\nexport const resolvePrincipal = (\n charter: Charter,\n universe: readonly string[],\n roles: readonly string[],\n section: Section = 'actions',\n): Set<string> => {\n const memo = new Map<string, ReadonlySet<string>>();\n const out = new Set<string>();\n for (const role of roles) for (const id of resolveRole(charter, universe, role, section, memo)) out.add(id);\n return out;\n};\n","import type { Charter, Section } from './types';\nimport { matchAll } from './glob';\nimport { CharterError, normalizeRole, resolveRole } from './resolve';\n\nexport type VerifyIssue = { level: 'error' | 'warning'; rule: string; detail: string };\n\nexport type RoleClosure = { role: string; actions: string[]; data: string[]; layouts: string[]; issues: string[] };\n\nexport type VerifyReport = { errors: VerifyIssue[]; warnings: VerifyIssue[]; perRole: RoleClosure[] };\n\nexport type ClosureAuditor = (grantedIds: readonly string[], layoutIds?: readonly string[]) => string[];\n\nexport const verifyCharter = (\n charter: Charter,\n // `layouts`, `functions`: verified where they are handed in.\n universes: { actions: readonly string[]; data: readonly string[]; layouts?: readonly string[]; functions?: readonly string[] },\n // One entry per combination of roles a principal may hold, not one per principal.\n wearable: readonly (readonly string[])[] = [],\n closure?: ClosureAuditor,\n): VerifyReport => {\n const actionUniverse = universes.actions;\n const sections: Section[] = [\n 'actions',\n 'data',\n ...(universes.layouts === undefined ? [] : (['layouts'] as const)),\n ...(universes.functions === undefined ? [] : (['functions'] as const)),\n ];\n const universeOf: Record<Section, readonly string[]> = {\n actions: universes.actions,\n data: universes.data,\n layouts: universes.layouts ?? [],\n functions: universes.functions ?? [],\n };\n\n const errors: VerifyIssue[] = [];\n const warnings: VerifyIssue[] = [];\n const perRole: RoleClosure[] = [];\n\n const resolved: Record<Section, Map<string, ReadonlySet<string>>> = { actions: new Map(), data: new Map(), layouts: new Map(), functions: new Map() };\n for (const section of sections) {\n const memo = new Map<string, ReadonlySet<string>>();\n for (const role of Object.keys(charter)) {\n try {\n resolved[section].set(role, resolveRole(charter, universeOf[section], role, section, memo));\n } catch (e) {\n errors.push({ level: 'error', rule: 'resolution', detail: `${section}: ${e instanceof CharterError ? e.message : String(e)}` });\n }\n }\n }\n\n const leavesOnly = (universe: readonly string[], kind: string): void => {\n for (const a of universe) {\n for (const b of universe) {\n if (b.startsWith(`${a}.`)) {\n errors.push({ level: 'error', rule: 'leaves-only', detail: `id \"${a}\" is a namespace of \"${b}\" — namespaces are never ${kind}` });\n break;\n }\n }\n }\n };\n leavesOnly(actionUniverse, 'actions');\n if (universes.layouts !== undefined) leavesOnly(universes.layouts, 'variants');\n\n for (const [role, def] of Object.entries(charter)) {\n if (Array.isArray(def)) continue;\n if (def.actions !== undefined && (def.allow !== undefined || def.deny !== undefined)) {\n errors.push({ level: 'error', rule: 'ambiguous-selection', detail: `role \"${role}\" has both top-level allow/deny and an \"actions\" section — one selection per section` });\n }\n }\n\n for (const section of sections) {\n for (const [role, def] of Object.entries(charter)) {\n const { allow, deny } = normalizeRole(def, section);\n for (const glob of deny) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n errors.push({ level: 'error', rule: 'dead-deny', detail: `role \"${role}\" denies \"${glob}\" (${section}) which matches nothing — silent means unprotected` });\n }\n }\n for (const glob of allow) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n warnings.push({ level: 'warning', rule: 'dead-allow', detail: `role \"${role}\" allows \"${glob}\" (${section}) which matches nothing` });\n }\n }\n }\n }\n\n // Not run for `data`: a data id no role grants is denied, which is not a mistake.\n const orphans = (section: Section, kind: string): void => {\n const reachable = new Set<string>();\n for (const set of resolved[section].values()) for (const id of set) reachable.add(id);\n for (const id of universeOf[section]) {\n if (!reachable.has(id)) warnings.push({ level: 'warning', rule: 'orphan', detail: `${kind} \"${id}\" is granted by no role — deployed but unreachable` });\n }\n };\n orphans('actions', 'action');\n if (universes.layouts !== undefined) orphans('layouts', 'layout variant');\n if (universes.functions !== undefined) orphans('functions', 'function');\n\n const ancestorDenied = (role: string, section: Section, seen: Set<string> = new Set()): Set<string> => {\n const out = new Set<string>();\n const def = charter[role];\n if (def === undefined || seen.has(role)) return out;\n seen.add(role);\n for (const parent of normalizeRole(def, section).extends) {\n const parentDef = charter[parent];\n if (parentDef === undefined) continue;\n for (const id of matchAll(normalizeRole(parentDef, section).deny, universeOf[section])) out.add(id);\n for (const id of ancestorDenied(parent, section, seen)) out.add(id);\n }\n return out;\n };\n for (const section of sections) {\n for (const [role, set] of resolved[section]) {\n for (const id of ancestorDenied(role, section)) {\n if (set.has(id)) {\n warnings.push({ level: 'warning', rule: 're-allow', detail: `role \"${role}\" re-allows \"${id}\" (${section}) which an ancestor denied` });\n }\n }\n }\n }\n\n const subtractive = new Set<string>();\n for (const def of Object.values(charter)) {\n if (Array.isArray(def)) continue;\n for (const sub of def.without ?? []) subtractive.add(sub);\n }\n const worn = new Set(wearable.flat());\n for (const role of subtractive) {\n if (worn.has(role)) {\n warnings.push({ level: 'warning', rule: 'subtractive-assigned', detail: `role \"${role}\" is referenced in \"without\" but is also assigned to a principal` });\n }\n }\n\n for (const role of Object.keys(charter)) {\n const actions = [...(resolved.actions.get(role) ?? [])].sort();\n const data = [...(resolved.data.get(role) ?? [])].sort();\n const layouts = [...(resolved.layouts.get(role) ?? [])].sort();\n const issues = closure?.(actions, layouts) ?? [];\n perRole.push({ role, actions, data, layouts, issues });\n }\n\n return { errors, warnings, perRole };\n};\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
type Section = 'actions' | 'data' | 'layouts';
|
|
1
|
+
type Section = 'actions' | 'data' | 'layouts' | 'functions';
|
|
2
2
|
type Selection = string[] | {
|
|
3
3
|
allow?: string[];
|
|
4
4
|
deny?: string[];
|
|
@@ -11,6 +11,7 @@ type RoleDef = string[] | {
|
|
|
11
11
|
actions?: Selection;
|
|
12
12
|
data?: Selection;
|
|
13
13
|
layouts?: Selection;
|
|
14
|
+
functions?: Selection;
|
|
14
15
|
scoping?: string;
|
|
15
16
|
};
|
|
16
17
|
type Charter = Record<string, RoleDef>;
|
|
@@ -53,6 +54,7 @@ declare const verifyCharter: (charter: Charter, universes: {
|
|
|
53
54
|
actions: readonly string[];
|
|
54
55
|
data: readonly string[];
|
|
55
56
|
layouts?: readonly string[];
|
|
57
|
+
functions?: readonly string[];
|
|
56
58
|
}, wearable?: readonly (readonly string[])[], closure?: ClosureAuditor) => VerifyReport;
|
|
57
59
|
|
|
58
60
|
export { type Charter, CharterError, type ClosureAuditor, type RoleClosure, type RoleDef, type Section, type Selection, type VerifyIssue, type VerifyReport, matchAll, matchGlob, normalizeRole, resolvePrincipal, resolveRole, resolveScoping, verifyCharter };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
type Section = 'actions' | 'data' | 'layouts';
|
|
1
|
+
type Section = 'actions' | 'data' | 'layouts' | 'functions';
|
|
2
2
|
type Selection = string[] | {
|
|
3
3
|
allow?: string[];
|
|
4
4
|
deny?: string[];
|
|
@@ -11,6 +11,7 @@ type RoleDef = string[] | {
|
|
|
11
11
|
actions?: Selection;
|
|
12
12
|
data?: Selection;
|
|
13
13
|
layouts?: Selection;
|
|
14
|
+
functions?: Selection;
|
|
14
15
|
scoping?: string;
|
|
15
16
|
};
|
|
16
17
|
type Charter = Record<string, RoleDef>;
|
|
@@ -53,6 +54,7 @@ declare const verifyCharter: (charter: Charter, universes: {
|
|
|
53
54
|
actions: readonly string[];
|
|
54
55
|
data: readonly string[];
|
|
55
56
|
layouts?: readonly string[];
|
|
57
|
+
functions?: readonly string[];
|
|
56
58
|
}, wearable?: readonly (readonly string[])[], closure?: ClosureAuditor) => VerifyReport;
|
|
57
59
|
|
|
58
60
|
export { type Charter, CharterError, type ClosureAuditor, type RoleClosure, type RoleDef, type Section, type Selection, type VerifyIssue, type VerifyReport, matchAll, matchGlob, normalizeRole, resolvePrincipal, resolveRole, resolveScoping, verifyCharter };
|
package/dist/index.js
CHANGED
|
@@ -58,16 +58,22 @@ var resolvePrincipal = (charter, universe, roles, section = "actions") => {
|
|
|
58
58
|
// src/verify.ts
|
|
59
59
|
var verifyCharter = (charter, universes, wearable = [], closure) => {
|
|
60
60
|
const actionUniverse = universes.actions;
|
|
61
|
-
const sections =
|
|
61
|
+
const sections = [
|
|
62
|
+
"actions",
|
|
63
|
+
"data",
|
|
64
|
+
...universes.layouts === void 0 ? [] : ["layouts"],
|
|
65
|
+
...universes.functions === void 0 ? [] : ["functions"]
|
|
66
|
+
];
|
|
62
67
|
const universeOf = {
|
|
63
68
|
actions: universes.actions,
|
|
64
69
|
data: universes.data,
|
|
65
|
-
layouts: universes.layouts ?? []
|
|
70
|
+
layouts: universes.layouts ?? [],
|
|
71
|
+
functions: universes.functions ?? []
|
|
66
72
|
};
|
|
67
73
|
const errors = [];
|
|
68
74
|
const warnings = [];
|
|
69
75
|
const perRole = [];
|
|
70
|
-
const resolved = { actions: /* @__PURE__ */ new Map(), data: /* @__PURE__ */ new Map(), layouts: /* @__PURE__ */ new Map() };
|
|
76
|
+
const resolved = { actions: /* @__PURE__ */ new Map(), data: /* @__PURE__ */ new Map(), layouts: /* @__PURE__ */ new Map(), functions: /* @__PURE__ */ new Map() };
|
|
71
77
|
for (const section of sections) {
|
|
72
78
|
const memo = /* @__PURE__ */ new Map();
|
|
73
79
|
for (const role of Object.keys(charter)) {
|
|
@@ -120,6 +126,7 @@ var verifyCharter = (charter, universes, wearable = [], closure) => {
|
|
|
120
126
|
};
|
|
121
127
|
orphans("actions", "action");
|
|
122
128
|
if (universes.layouts !== void 0) orphans("layouts", "layout variant");
|
|
129
|
+
if (universes.functions !== void 0) orphans("functions", "function");
|
|
123
130
|
const ancestorDenied = (role, section, seen = /* @__PURE__ */ new Set()) => {
|
|
124
131
|
const out = /* @__PURE__ */ new Set();
|
|
125
132
|
const def = charter[role];
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/glob.ts","../src/resolve.ts","../src/verify.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// One wildcard rule, no more: `*` matches any run of characters, including\n// dots — `crm.*` matches `crm.deal.form`. No `**`, no braces, no regex. The\n// day a pattern cannot be expressed, the answer is a better id, not a\n// richer glob.\nconst escapeRegExp = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\nconst toRegExp = (pattern: string): RegExp => new RegExp(`^${pattern.split('*').map(escapeRegExp).join('.*')}$`);\n\nexport const matchGlob = (pattern: string, id: string): boolean => toRegExp(pattern).test(id);\n\n// Every id the pattern list selects out of `ids`.\nexport const matchAll = (patterns: readonly string[], ids: readonly string[]): Set<string> => {\n const out = new Set<string>();\n for (const pattern of patterns) {\n const re = toRegExp(pattern);\n for (const id of ids) if (re.test(id)) out.add(id);\n }\n return out;\n};\n","import type { Charter, RoleDef, Section, Selection } from './types';\nimport { matchAll } from './glob';\n\n// Resolution is a pure function from (charter, universe, section) to a\n// concrete id set per role — the algebra from DESIGN.md § The algebra,\n// verbatim, per section:\n//\n// resolved(role) = (∪ resolved(extends) ∪ match(allow))\n// − match(deny)\n// − ∪ resolved(without)\n//\n// The engine is UNIVERSE-BLIND: it resolves globs over opaque strings and\n// never learns what a string means. `actions` and `data` run the SAME code\n// against different universes. Order-independent (all subtraction is\n// set-minus); deny wins within a role; denies do NOT inherit (a child may\n// re-add what a parent denied — the verifier flags it); cycles and unknown\n// references are errors.\n\nexport class CharterError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'CharterError';\n }\n}\n\n// NOTE deliberately absent: the engine never MANUFACTURES a universe — it is\n// always handed one. The data universe's atoms are the governed target's own\n// dialect (vex exports `SCOPE_VERBS` and `scopeGrants(tables)`); the app\n// wiring derives it and passes it in. That keeps this module free of any\n// foreign import, in either direction.\n\nconst asSelection = (s: Selection | undefined): { allow: string[]; deny: string[] } =>\n s === undefined ? { allow: [], deny: [] } : Array.isArray(s) ? { allow: s, deny: [] } : { allow: s.allow ?? [], deny: s.deny ?? [] };\n\n// A role's atoms for ONE section, plus its role-level composition (shared\n// across sections). A bare array is an actions-only role; top-level\n// `allow`/`deny` are sugar for the `actions` section.\nexport const normalizeRole = (\n def: RoleDef,\n section: Section,\n): { allow: string[]; deny: string[]; extends: string[]; without: string[] } => {\n if (Array.isArray(def)) {\n return section === 'actions'\n ? { allow: def, deny: [], extends: [], without: [] }\n : { allow: [], deny: [], extends: [], without: [] };\n }\n const composition = { extends: def.extends ?? [], without: def.without ?? [] };\n // Actions: explicit `actions:` wins, else the top-level allow/deny sugar.\n const sel =\n section === 'actions' && def.actions === undefined\n ? { allow: def.allow ?? [], deny: def.deny ?? [] }\n : asSelection(def[section]);\n return { ...sel, ...composition };\n};\n\nexport const resolveRole = (\n charter: Charter,\n universe: readonly string[],\n role: string,\n section: Section,\n memo: Map<string, ReadonlySet<string>> = new Map(),\n visiting: Set<string> = new Set(),\n): ReadonlySet<string> => {\n const cached = memo.get(role);\n if (cached !== undefined) return cached;\n const def = charter[role];\n if (def === undefined) throw new CharterError(`Unknown role \"${role}\"`);\n if (visiting.has(role)) throw new CharterError(`Role cycle through \"${role}\"`);\n visiting.add(role);\n\n const { allow, extends: parents, deny, without } = normalizeRole(def, section);\n const resolved = new Set<string>();\n for (const parent of parents) for (const id of resolveRole(charter, universe, parent, section, memo, visiting)) resolved.add(id);\n for (const id of matchAll(allow, universe)) resolved.add(id);\n for (const id of matchAll(deny, universe)) resolved.delete(id);\n for (const sub of without) for (const id of resolveRole(charter, universe, sub, section, memo, visiting)) resolved.delete(id);\n\n visiting.delete(role);\n memo.set(role, resolved);\n return resolved;\n};\n\n// A principal wears roles; a section's grant is the union of their resolved\n// sets in that section's universe.\n// The reach a ROLE was given: the profile it names, or none.\n//\n// SINGULAR ON PURPOSE. This took a list of roles and refused when two of them\n// named different profiles — \"incoherence rather than a precedence puzzle,\n// refused in the same spirit as two granted layout variants for one action.\"\n// That analogy was wrong. Two layout variants for one action genuinely conflict,\n// because a screen renders one of them; two roles naming different reaches is\n// somebody who teaches at a studio AND trains there, which is a person, not a\n// contradiction.\n//\n// A caller who holds several roles resolves each one separately and merges the\n// results (vex: `mergeScopePolicies`). That is where \"holding two roles\" is\n// decided, and it belongs there — reach is a property of a role, so a function\n// handed several of them has no answer to give, only a choice to refuse.\nexport const resolveScoping = (charter: Charter, role: string): string | undefined => {\n const def = charter[role];\n return def === undefined || Array.isArray(def) ? undefined : def.scoping;\n};\n\nexport const resolvePrincipal = (\n charter: Charter,\n universe: readonly string[],\n roles: readonly string[],\n section: Section = 'actions',\n): Set<string> => {\n const memo = new Map<string, ReadonlySet<string>>();\n const out = new Set<string>();\n for (const role of roles) for (const id of resolveRole(charter, universe, role, section, memo)) out.add(id);\n return out;\n};\n","import type { Charter, Section } from './types';\nimport { matchAll } from './glob';\nimport { CharterError, normalizeRole, resolveRole } from './resolve';\n\n// ═══════════════════════════════════════════════════════════\n// The verifier — the other half of the charter (DESIGN.md § The verifier\n// is the other half). The grammar\n// stays small; the opinions live here. Boot/CI runs it and refuses an\n// incoherent charter: \"if it boots, it's coherent.\"\n//\n// Every check runs PER SECTION against that section's universe. Like the\n// resolver, the verifier is universe-blind: every universe is HANDED IN\n// (the atoms are each governed target's own dialect — nova action ids, vex\n// verb leaves), and the per-role closure audit is an injected hook (nova\n// exports one), so this module imports nothing. Severities are asymmetric\n// on purpose: a dead DENY is an error (a typo'd deny fails silent, and\n// silent means unprotected); a dead allow is a warning.\n// ═══════════════════════════════════════════════════════════\n\nexport type VerifyIssue = { level: 'error' | 'warning'; rule: string; detail: string };\n\nexport type RoleClosure = { role: string; actions: string[]; data: string[]; layouts: string[]; issues: string[] };\n\nexport type VerifyReport = { errors: VerifyIssue[]; warnings: VerifyIssue[]; perRole: RoleClosure[] };\n\n// The per-role closure audit: given a role's granted action ids (and, when\n// the app governs layouts, its granted layout-variant ids), report the\n// cross-action wiring problems inside that closure (targets that aren't in\n// it, channels nobody serves). The consumer that OWNS actions provides it —\n// moss builds one from nova's audit, substituting granted variants so the\n// closure sees each role's EFFECTIVE definitions.\nexport type ClosureAuditor = (grantedIds: readonly string[], layoutIds?: readonly string[]) => string[];\n\nexport const verifyCharter = (\n charter: Charter,\n universes: { actions: readonly string[]; data: readonly string[]; layouts?: readonly string[] },\n // THE ROLE COMBINATIONS A PRINCIPAL MAY WEAR — one entry per combination, not\n // one per person. The only rule below that reads it (`subtractive-assigned`)\n // wants the set of roles somebody actually holds, and a population is a very\n // expensive way to spell a set. A composer that still holds an assignment map\n // passes `Object.values(map)`; one that declares its combinations passes them.\n wearable: readonly (readonly string[])[] = [],\n closure?: ClosureAuditor,\n): VerifyReport => {\n const actionUniverse = universes.actions;\n // The layouts section is verified only when the composer governs layouts\n // (hands a universe in) — absent, a charter's `layouts` keys are inert\n // here exactly as they are in resolution against an empty universe.\n const sections: Section[] = universes.layouts === undefined ? ['actions', 'data'] : ['actions', 'data', 'layouts'];\n const universeOf: Record<Section, readonly string[]> = {\n actions: universes.actions,\n data: universes.data,\n layouts: universes.layouts ?? [],\n };\n\n const errors: VerifyIssue[] = [];\n const warnings: VerifyIssue[] = [];\n const perRole: RoleClosure[] = [];\n\n // Resolve every role in every section up front (also surfaces cycles /\n // unknown references, per section).\n const resolved: Record<Section, Map<string, ReadonlySet<string>>> = { actions: new Map(), data: new Map(), layouts: new Map() };\n for (const section of sections) {\n const memo = new Map<string, ReadonlySet<string>>();\n for (const role of Object.keys(charter)) {\n try {\n resolved[section].set(role, resolveRole(charter, universeOf[section], role, section, memo));\n } catch (e) {\n errors.push({ level: 'error', rule: 'resolution', detail: `${section}: ${e instanceof CharterError ? e.message : String(e)}` });\n }\n }\n }\n\n // ── ids are leaves; namespaces are never actions. Same rule inside the\n // layouts universe — a variant id is never a namespace of another ──\n const leavesOnly = (universe: readonly string[], kind: string): void => {\n for (const a of universe) {\n for (const b of universe) {\n if (b.startsWith(`${a}.`)) {\n errors.push({ level: 'error', rule: 'leaves-only', detail: `id \"${a}\" is a namespace of \"${b}\" — namespaces are never ${kind}` });\n break;\n }\n }\n }\n };\n leavesOnly(actionUniverse, 'actions');\n if (universes.layouts !== undefined) leavesOnly(universes.layouts, 'variants');\n\n // ── one selection per section: top-level allow/deny (the actions sugar)\n // AND an `actions` key on the same role means resolution silently drops\n // the sugar — silent means wrong, so boot refuses ──\n for (const [role, def] of Object.entries(charter)) {\n if (Array.isArray(def)) continue;\n if (def.actions !== undefined && (def.allow !== undefined || def.deny !== undefined)) {\n errors.push({ level: 'error', rule: 'ambiguous-selection', detail: `role \"${role}\" has both top-level allow/deny and an \"actions\" section — one selection per section` });\n }\n }\n\n // ── dead deny = error, dead allow = warning; per glob, per role, per section ──\n for (const section of sections) {\n for (const [role, def] of Object.entries(charter)) {\n const { allow, deny } = normalizeRole(def, section);\n for (const glob of deny) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n errors.push({ level: 'error', rule: 'dead-deny', detail: `role \"${role}\" denies \"${glob}\" (${section}) which matches nothing — silent means unprotected` });\n }\n }\n for (const glob of allow) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n warnings.push({ level: 'warning', rule: 'dead-allow', detail: `role \"${role}\" allows \"${glob}\" (${section}) which matches nothing` });\n }\n }\n }\n }\n\n // ── orphans: matched by no role at all. Actions and layout variants share\n // the rule — both are deployed-but-unreachable artifacts. An ungranted\n // data phase is simply denied, not a mistake ──\n const orphans = (section: Section, kind: string): void => {\n const reachable = new Set<string>();\n for (const set of resolved[section].values()) for (const id of set) reachable.add(id);\n for (const id of universeOf[section]) {\n if (!reachable.has(id)) warnings.push({ level: 'warning', rule: 'orphan', detail: `${kind} \"${id}\" is granted by no role — deployed but unreachable` });\n }\n };\n orphans('actions', 'action');\n if (universes.layouts !== undefined) orphans('layouts', 'layout variant');\n\n // ── re-allow of an ancestor's deny (F1), per section ──\n const ancestorDenied = (role: string, section: Section, seen: Set<string> = new Set()): Set<string> => {\n const out = new Set<string>();\n const def = charter[role];\n if (def === undefined || seen.has(role)) return out;\n seen.add(role);\n for (const parent of normalizeRole(def, section).extends) {\n const parentDef = charter[parent];\n if (parentDef === undefined) continue;\n for (const id of matchAll(normalizeRole(parentDef, section).deny, universeOf[section])) out.add(id);\n for (const id of ancestorDenied(parent, section, seen)) out.add(id);\n }\n return out;\n };\n for (const section of sections) {\n for (const [role, set] of resolved[section]) {\n for (const id of ancestorDenied(role, section)) {\n if (set.has(id)) {\n warnings.push({ level: 'warning', rule: 're-allow', detail: `role \"${role}\" re-allows \"${id}\" (${section}) which an ancestor denied` });\n }\n }\n }\n }\n\n // ── a role referenced in `without` that principals also wear (F2) ──\n const subtractive = new Set<string>();\n for (const def of Object.values(charter)) {\n if (Array.isArray(def)) continue;\n for (const sub of def.without ?? []) subtractive.add(sub);\n }\n const worn = new Set(wearable.flat());\n for (const role of subtractive) {\n if (worn.has(role)) {\n warnings.push({ level: 'warning', rule: 'subtractive-assigned', detail: `role \"${role}\" is referenced in \"without\" but is also assigned to a principal` });\n }\n }\n\n // ── per-role closure: the action-catalog audit (cross-action wiring),\n // fed the role's granted variants so it audits EFFECTIVE definitions ──\n for (const role of Object.keys(charter)) {\n const actions = [...(resolved.actions.get(role) ?? [])].sort();\n const data = [...(resolved.data.get(role) ?? [])].sort();\n const layouts = [...(resolved.layouts.get(role) ?? [])].sort();\n const issues = closure?.(actions, layouts) ?? [];\n perRole.push({ role, actions, data, layouts, issues });\n }\n\n return { errors, warnings, perRole };\n};\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/glob.ts","../src/resolve.ts","../src/verify.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["const escapeRegExp = (s: string): string => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\nconst toRegExp = (pattern: string): RegExp => new RegExp(`^${pattern.split('*').map(escapeRegExp).join('.*')}$`);\n\nexport const matchGlob = (pattern: string, id: string): boolean => toRegExp(pattern).test(id);\n\nexport const matchAll = (patterns: readonly string[], ids: readonly string[]): Set<string> => {\n const out = new Set<string>();\n for (const pattern of patterns) {\n const re = toRegExp(pattern);\n for (const id of ids) if (re.test(id)) out.add(id);\n }\n return out;\n};\n","import type { Charter, RoleDef, Section, Selection } from './types';\nimport { matchAll } from './glob';\n\nexport class CharterError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'CharterError';\n }\n}\n\nconst asSelection = (s: Selection | undefined): { allow: string[]; deny: string[] } =>\n s === undefined ? { allow: [], deny: [] } : Array.isArray(s) ? { allow: s, deny: [] } : { allow: s.allow ?? [], deny: s.deny ?? [] };\n\nexport const normalizeRole = (\n def: RoleDef,\n section: Section,\n): { allow: string[]; deny: string[]; extends: string[]; without: string[] } => {\n if (Array.isArray(def)) {\n return section === 'actions'\n ? { allow: def, deny: [], extends: [], without: [] }\n : { allow: [], deny: [], extends: [], without: [] };\n }\n const composition = { extends: def.extends ?? [], without: def.without ?? [] };\n const sel =\n section === 'actions' && def.actions === undefined\n ? { allow: def.allow ?? [], deny: def.deny ?? [] }\n : asSelection(def[section]);\n return { ...sel, ...composition };\n};\n\nexport const resolveRole = (\n charter: Charter,\n universe: readonly string[],\n role: string,\n section: Section,\n memo: Map<string, ReadonlySet<string>> = new Map(),\n visiting: Set<string> = new Set(),\n): ReadonlySet<string> => {\n const cached = memo.get(role);\n if (cached !== undefined) return cached;\n const def = charter[role];\n if (def === undefined) throw new CharterError(`Unknown role \"${role}\"`);\n if (visiting.has(role)) throw new CharterError(`Role cycle through \"${role}\"`);\n visiting.add(role);\n\n const { allow, extends: parents, deny, without } = normalizeRole(def, section);\n const resolved = new Set<string>();\n for (const parent of parents) for (const id of resolveRole(charter, universe, parent, section, memo, visiting)) resolved.add(id);\n for (const id of matchAll(allow, universe)) resolved.add(id);\n for (const id of matchAll(deny, universe)) resolved.delete(id);\n for (const sub of without) for (const id of resolveRole(charter, universe, sub, section, memo, visiting)) resolved.delete(id);\n\n visiting.delete(role);\n memo.set(role, resolved);\n return resolved;\n};\n\n// One role, not a list: two roles naming different profiles are not a conflict\n// to refuse. A caller holding several resolves each and merges the results.\nexport const resolveScoping = (charter: Charter, role: string): string | undefined => {\n const def = charter[role];\n return def === undefined || Array.isArray(def) ? undefined : def.scoping;\n};\n\nexport const resolvePrincipal = (\n charter: Charter,\n universe: readonly string[],\n roles: readonly string[],\n section: Section = 'actions',\n): Set<string> => {\n const memo = new Map<string, ReadonlySet<string>>();\n const out = new Set<string>();\n for (const role of roles) for (const id of resolveRole(charter, universe, role, section, memo)) out.add(id);\n return out;\n};\n","import type { Charter, Section } from './types';\nimport { matchAll } from './glob';\nimport { CharterError, normalizeRole, resolveRole } from './resolve';\n\nexport type VerifyIssue = { level: 'error' | 'warning'; rule: string; detail: string };\n\nexport type RoleClosure = { role: string; actions: string[]; data: string[]; layouts: string[]; issues: string[] };\n\nexport type VerifyReport = { errors: VerifyIssue[]; warnings: VerifyIssue[]; perRole: RoleClosure[] };\n\nexport type ClosureAuditor = (grantedIds: readonly string[], layoutIds?: readonly string[]) => string[];\n\nexport const verifyCharter = (\n charter: Charter,\n // `layouts`, `functions`: verified where they are handed in.\n universes: { actions: readonly string[]; data: readonly string[]; layouts?: readonly string[]; functions?: readonly string[] },\n // One entry per combination of roles a principal may hold, not one per principal.\n wearable: readonly (readonly string[])[] = [],\n closure?: ClosureAuditor,\n): VerifyReport => {\n const actionUniverse = universes.actions;\n const sections: Section[] = [\n 'actions',\n 'data',\n ...(universes.layouts === undefined ? [] : (['layouts'] as const)),\n ...(universes.functions === undefined ? [] : (['functions'] as const)),\n ];\n const universeOf: Record<Section, readonly string[]> = {\n actions: universes.actions,\n data: universes.data,\n layouts: universes.layouts ?? [],\n functions: universes.functions ?? [],\n };\n\n const errors: VerifyIssue[] = [];\n const warnings: VerifyIssue[] = [];\n const perRole: RoleClosure[] = [];\n\n const resolved: Record<Section, Map<string, ReadonlySet<string>>> = { actions: new Map(), data: new Map(), layouts: new Map(), functions: new Map() };\n for (const section of sections) {\n const memo = new Map<string, ReadonlySet<string>>();\n for (const role of Object.keys(charter)) {\n try {\n resolved[section].set(role, resolveRole(charter, universeOf[section], role, section, memo));\n } catch (e) {\n errors.push({ level: 'error', rule: 'resolution', detail: `${section}: ${e instanceof CharterError ? e.message : String(e)}` });\n }\n }\n }\n\n const leavesOnly = (universe: readonly string[], kind: string): void => {\n for (const a of universe) {\n for (const b of universe) {\n if (b.startsWith(`${a}.`)) {\n errors.push({ level: 'error', rule: 'leaves-only', detail: `id \"${a}\" is a namespace of \"${b}\" — namespaces are never ${kind}` });\n break;\n }\n }\n }\n };\n leavesOnly(actionUniverse, 'actions');\n if (universes.layouts !== undefined) leavesOnly(universes.layouts, 'variants');\n\n for (const [role, def] of Object.entries(charter)) {\n if (Array.isArray(def)) continue;\n if (def.actions !== undefined && (def.allow !== undefined || def.deny !== undefined)) {\n errors.push({ level: 'error', rule: 'ambiguous-selection', detail: `role \"${role}\" has both top-level allow/deny and an \"actions\" section — one selection per section` });\n }\n }\n\n for (const section of sections) {\n for (const [role, def] of Object.entries(charter)) {\n const { allow, deny } = normalizeRole(def, section);\n for (const glob of deny) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n errors.push({ level: 'error', rule: 'dead-deny', detail: `role \"${role}\" denies \"${glob}\" (${section}) which matches nothing — silent means unprotected` });\n }\n }\n for (const glob of allow) {\n if (matchAll([glob], universeOf[section]).size === 0) {\n warnings.push({ level: 'warning', rule: 'dead-allow', detail: `role \"${role}\" allows \"${glob}\" (${section}) which matches nothing` });\n }\n }\n }\n }\n\n // Not run for `data`: a data id no role grants is denied, which is not a mistake.\n const orphans = (section: Section, kind: string): void => {\n const reachable = new Set<string>();\n for (const set of resolved[section].values()) for (const id of set) reachable.add(id);\n for (const id of universeOf[section]) {\n if (!reachable.has(id)) warnings.push({ level: 'warning', rule: 'orphan', detail: `${kind} \"${id}\" is granted by no role — deployed but unreachable` });\n }\n };\n orphans('actions', 'action');\n if (universes.layouts !== undefined) orphans('layouts', 'layout variant');\n if (universes.functions !== undefined) orphans('functions', 'function');\n\n const ancestorDenied = (role: string, section: Section, seen: Set<string> = new Set()): Set<string> => {\n const out = new Set<string>();\n const def = charter[role];\n if (def === undefined || seen.has(role)) return out;\n seen.add(role);\n for (const parent of normalizeRole(def, section).extends) {\n const parentDef = charter[parent];\n if (parentDef === undefined) continue;\n for (const id of matchAll(normalizeRole(parentDef, section).deny, universeOf[section])) out.add(id);\n for (const id of ancestorDenied(parent, section, seen)) out.add(id);\n }\n return out;\n };\n for (const section of sections) {\n for (const [role, set] of resolved[section]) {\n for (const id of ancestorDenied(role, section)) {\n if (set.has(id)) {\n warnings.push({ level: 'warning', rule: 're-allow', detail: `role \"${role}\" re-allows \"${id}\" (${section}) which an ancestor denied` });\n }\n }\n }\n }\n\n const subtractive = new Set<string>();\n for (const def of Object.values(charter)) {\n if (Array.isArray(def)) continue;\n for (const sub of def.without ?? []) subtractive.add(sub);\n }\n const worn = new Set(wearable.flat());\n for (const role of subtractive) {\n if (worn.has(role)) {\n warnings.push({ level: 'warning', rule: 'subtractive-assigned', detail: `role \"${role}\" is referenced in \"without\" but is also assigned to a principal` });\n }\n }\n\n for (const role of Object.keys(charter)) {\n const actions = [...(resolved.actions.get(role) ?? [])].sort();\n const data = [...(resolved.data.get(role) ?? [])].sort();\n const layouts = [...(resolved.layouts.get(role) ?? [])].sort();\n const issues = closure?.(actions, layouts) ?? [];\n perRole.push({ role, actions, data, layouts, issues });\n }\n\n return { errors, warnings, perRole };\n};\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@niscorp/charter",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "A universe-blind policy engine — roles resolve glob selections over opaque string universes; the verifier refuses incoherence. Zero dependencies.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|