@crombolo/backoffice-host 0.60.0 → 0.62.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/package.json +3 -3
- package/plugin/app-preview/umbraco-package.json +1 -1
- package/plugin/branding/localization-en.js +1 -2
- package/plugin/bundles-activity-words.js +72 -0
- package/plugin/bundles-activity.js +171 -0
- package/plugin/bundles-client.js +30 -6
- package/plugin/bundles-installed.js +179 -69
- package/plugin/bundles-level-words.js +79 -0
- package/plugin/bundles-level.js +91 -0
- package/plugin/bundles-marketplace.js +64 -84
- package/plugin/content-strip-items.js +5 -13
- package/plugin/extension-screen-model.js +124 -0
- package/plugin/extension-screen.js +551 -0
- package/plugin/forms-client.js +7 -0
- package/plugin/forms-overview.js +79 -0
- package/plugin/forms-workflows.js +18 -0
- package/plugin/localizations/umbraco-package.json +1 -1
- package/plugin/seo/umbraco-package.json +1 -1
- package/plugin/settings-section.js +1 -31
- package/plugin/sign-in/umbraco-package.json +1 -1
- package/plugin/template-picker.js +3 -3
- package/plugin/umbraco-package.json +4 -34
- package/src/bundle-package.ts +105 -13
- package/src/bundle-permissions.ts +152 -6
- package/src/extension-roots.ts +128 -0
- package/src/extensions.ts +24 -1
- package/src/index.ts +1 -0
- package/src/manifests.ts +12 -1
- package/src/registry.ts +1 -0
- package/plugin/bundles-backoffice-code-words.js +0 -34
- package/plugin/bundles-backoffice-code.js +0 -51
|
@@ -6,7 +6,6 @@
|
|
|
6
6
|
* manifest.
|
|
7
7
|
*/
|
|
8
8
|
|
|
9
|
-
import { UMB_CURRENT_USER_CONTEXT } from '@umbraco-cms/backoffice/current-user'
|
|
10
9
|
import {
|
|
11
10
|
createExtensionApi,
|
|
12
11
|
createExtensionElement,
|
|
@@ -70,12 +69,6 @@ const savePosition = (event) => {
|
|
|
70
69
|
|
|
71
70
|
const menuOf = (manifest, menu) => manifest.meta?.menus?.includes(menu) === true
|
|
72
71
|
|
|
73
|
-
/** Each tree, and the part of Settings that opens it. */
|
|
74
|
-
const TREE_SECTIONS = [
|
|
75
|
-
['structure', 'Crombolo.Section.Structure'],
|
|
76
|
-
['code', 'Crombolo.Section.Components'],
|
|
77
|
-
]
|
|
78
|
-
|
|
79
72
|
export class CromboloSettingsSectionElement extends UmbLitElement {
|
|
80
73
|
static properties = {
|
|
81
74
|
_routes: { state: true },
|
|
@@ -87,8 +80,6 @@ export class CromboloSettingsSectionElement extends UmbLitElement {
|
|
|
87
80
|
}
|
|
88
81
|
|
|
89
82
|
#dashboards = []
|
|
90
|
-
/** The sections the current user holds, which say how much of Settings they have. */
|
|
91
|
-
#held
|
|
92
83
|
#menuItems = []
|
|
93
84
|
#sectionRoutes = []
|
|
94
85
|
#landing
|
|
@@ -97,12 +88,6 @@ export class CromboloSettingsSectionElement extends UmbLitElement {
|
|
|
97
88
|
|
|
98
89
|
constructor() {
|
|
99
90
|
super()
|
|
100
|
-
this.consumeContext(UMB_CURRENT_USER_CONTEXT, (user) => {
|
|
101
|
-
this.observe(user?.currentUser, (current) => {
|
|
102
|
-
this.#held = current?.allowedSections ?? []
|
|
103
|
-
this.#createRoutes()
|
|
104
|
-
})
|
|
105
|
-
})
|
|
106
91
|
// An explanation, not a control: a failure leaves it out.
|
|
107
92
|
fetch(`${base()}/crombolo/api/site-files`, { credentials: 'include' })
|
|
108
93
|
.then((response) => (response.ok ? response.json() : { writable: true }))
|
|
@@ -240,20 +225,9 @@ export class CromboloSettingsSectionElement extends UmbLitElement {
|
|
|
240
225
|
}
|
|
241
226
|
|
|
242
227
|
#createRoutes() {
|
|
243
|
-
// Someone with a part of Settings has its tree, and not the cards or the tools.
|
|
244
|
-
const whole = this.#held?.includes('Crombolo.Section.AllSettings') ?? false
|
|
245
|
-
const mine = TREE_SECTIONS.filter(([, section]) => this.#held?.includes(section)).map(
|
|
246
|
-
([tree]) => tree,
|
|
247
|
-
)
|
|
248
|
-
const toTree = (name) =>
|
|
249
|
-
history.replaceState(null, '', new URL(`section/settings/${name}`, document.baseURI).pathname)
|
|
250
228
|
const landing = {
|
|
251
229
|
component: () => document.createElement('crombolo-settings-landing'),
|
|
252
230
|
setup: (element) => {
|
|
253
|
-
if (this.#held && !whole && mine[0]) {
|
|
254
|
-
toTree(mine[0])
|
|
255
|
-
return
|
|
256
|
-
}
|
|
257
231
|
this.#landing = element
|
|
258
232
|
this.#refreshLanding()
|
|
259
233
|
this.#showing(undefined)
|
|
@@ -263,10 +237,6 @@ export class CromboloSettingsSectionElement extends UmbLitElement {
|
|
|
263
237
|
path: name,
|
|
264
238
|
component: () => document.createElement('crombolo-settings-tree-start'),
|
|
265
239
|
setup: (element) => {
|
|
266
|
-
if (this.#held && !mine.includes(name) && mine[0]) {
|
|
267
|
-
toTree(mine[0])
|
|
268
|
-
return
|
|
269
|
-
}
|
|
270
240
|
element.tree = name
|
|
271
241
|
this.#showing(name)
|
|
272
242
|
},
|
|
@@ -331,7 +301,7 @@ export class CromboloSettingsSectionElement extends UmbLitElement {
|
|
|
331
301
|
)
|
|
332
302
|
},
|
|
333
303
|
},
|
|
334
|
-
...
|
|
304
|
+
...dashboards,
|
|
335
305
|
...this.#sectionRoutes,
|
|
336
306
|
{ path: '', pathMatch: 'full', ...landing },
|
|
337
307
|
{ path: '**', component: UmbRouteNotFoundElement },
|
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
import { UMB_CURRENT_USER_CONTEXT } from '@umbraco-cms/backoffice/current-user'
|
|
8
8
|
|
|
9
9
|
export const TEMPLATE_PICKER_MODAL = 'Crombolo.Modal.TemplatePicker'
|
|
10
|
-
const
|
|
10
|
+
const SETTINGS = 'Umb.Section.Settings'
|
|
11
11
|
|
|
12
|
-
/** Whether the reader may change a content type:
|
|
12
|
+
/** Whether the reader may change a content type: Settings. */
|
|
13
13
|
async function mayChangeTypes(host) {
|
|
14
14
|
const context = await host.getContext?.(UMB_CURRENT_USER_CONTEXT).catch(() => undefined)
|
|
15
15
|
if (!context) return false
|
|
@@ -19,7 +19,7 @@ async function mayChangeTypes(host) {
|
|
|
19
19
|
queueMicrotask(() => subscription.unsubscribe())
|
|
20
20
|
})
|
|
21
21
|
})
|
|
22
|
-
return user?.isAdmin === true || (user?.allowedSections ?? []).includes(
|
|
22
|
+
return user?.isAdmin === true || (user?.allowedSections ?? []).includes(SETTINGS)
|
|
23
23
|
}
|
|
24
24
|
|
|
25
25
|
export const onInit = async (_host, extensionRegistry) => {
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"$schema": "../../backoffice-dist/dist/umbraco-package-schema.json",
|
|
3
3
|
"name": "Crombolo",
|
|
4
4
|
"id": "Crombolo.Core",
|
|
5
|
-
"version": "0.
|
|
5
|
+
"version": "0.62.0",
|
|
6
6
|
"allowPublicAccess": false,
|
|
7
7
|
"extensions": [
|
|
8
8
|
{
|
|
@@ -531,7 +531,7 @@
|
|
|
531
531
|
"conditions": [
|
|
532
532
|
{
|
|
533
533
|
"alias": "Umb.Condition.SectionUserPermission",
|
|
534
|
-
"match": "
|
|
534
|
+
"match": "Umb.Section.Settings"
|
|
535
535
|
}
|
|
536
536
|
]
|
|
537
537
|
},
|
|
@@ -663,7 +663,7 @@
|
|
|
663
663
|
"conditions": [
|
|
664
664
|
{
|
|
665
665
|
"alias": "Umb.Condition.SectionUserPermission",
|
|
666
|
-
"match": "
|
|
666
|
+
"match": "Umb.Section.Settings"
|
|
667
667
|
}
|
|
668
668
|
]
|
|
669
669
|
},
|
|
@@ -787,36 +787,6 @@
|
|
|
787
787
|
"name": "Crombolo Approvals Active Condition",
|
|
788
788
|
"api": "/crombolo-plugin/approvals-active.js"
|
|
789
789
|
},
|
|
790
|
-
{
|
|
791
|
-
"type": "section",
|
|
792
|
-
"alias": "Crombolo.Section.Structure",
|
|
793
|
-
"name": "Crombolo Structure Section",
|
|
794
|
-
"weight": 30,
|
|
795
|
-
"meta": {
|
|
796
|
-
"label": "Structure",
|
|
797
|
-
"pathname": "structure"
|
|
798
|
-
}
|
|
799
|
-
},
|
|
800
|
-
{
|
|
801
|
-
"type": "section",
|
|
802
|
-
"alias": "Crombolo.Section.Components",
|
|
803
|
-
"name": "Crombolo Code Section",
|
|
804
|
-
"weight": 29,
|
|
805
|
-
"meta": {
|
|
806
|
-
"label": "Code",
|
|
807
|
-
"pathname": "components"
|
|
808
|
-
}
|
|
809
|
-
},
|
|
810
|
-
{
|
|
811
|
-
"type": "section",
|
|
812
|
-
"alias": "Crombolo.Section.WorkflowSetup",
|
|
813
|
-
"name": "Crombolo Workflow setup Section",
|
|
814
|
-
"weight": 28,
|
|
815
|
-
"meta": {
|
|
816
|
-
"label": "Workflow setup",
|
|
817
|
-
"pathname": "workflow-setup"
|
|
818
|
-
}
|
|
819
|
-
},
|
|
820
790
|
{
|
|
821
791
|
"type": "section",
|
|
822
792
|
"alias": "Crombolo.Section.Workflow",
|
|
@@ -879,7 +849,7 @@
|
|
|
879
849
|
},
|
|
880
850
|
{
|
|
881
851
|
"alias": "Umb.Condition.SectionUserPermission",
|
|
882
|
-
"match": "
|
|
852
|
+
"match": "Umb.Section.Settings"
|
|
883
853
|
}
|
|
884
854
|
]
|
|
885
855
|
},
|
package/src/bundle-package.ts
CHANGED
|
@@ -6,9 +6,10 @@
|
|
|
6
6
|
* marketplace, the server half and the installer cannot disagree about what a
|
|
7
7
|
* bundle is.
|
|
8
8
|
*/
|
|
9
|
-
import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
|
|
9
|
+
import { existsSync, lstatSync, readdirSync, readFileSync, realpathSync, statSync } from 'node:fs'
|
|
10
10
|
import { dirname, join, normalize } from 'node:path'
|
|
11
11
|
import { BACKOFFICE_CODE, permissionsProblem, readSettings } from './bundle-permissions.ts'
|
|
12
|
+
import { packageInRoot, readRecord, rootOf } from './extension-roots.ts'
|
|
12
13
|
import type { PackageManifestImportmap } from './manifests.ts'
|
|
13
14
|
|
|
14
15
|
/** The package a bundle declares its peer range on. */
|
|
@@ -83,15 +84,54 @@ export interface CromboloField {
|
|
|
83
84
|
}
|
|
84
85
|
|
|
85
86
|
/**
|
|
86
|
-
* The bundle schema
|
|
87
|
-
* half
|
|
88
|
-
*
|
|
89
|
-
*
|
|
87
|
+
* The bundle schema this release writes: 6 lets a manifest entry name a screen
|
|
88
|
+
* its server half describes (story 323); 5 put its server half in `src/server/`
|
|
89
|
+
* and its back-office code in `src/backoffice/` (story 320); 4 gave each
|
|
90
|
+
* permission a reason (308); 3 declared them (222); 2 made its routes route
|
|
91
|
+
* handlers (211).
|
|
90
92
|
*/
|
|
91
|
-
export const BUNDLE_SCHEMA_VERSION =
|
|
93
|
+
export const BUNDLE_SCHEMA_VERSION = 6
|
|
92
94
|
|
|
93
|
-
/** The
|
|
94
|
-
export const
|
|
95
|
+
/** The schema whose manifest entries may name a described screen (story 323). */
|
|
96
|
+
export const SCREEN_SCHEMA_VERSION = 6
|
|
97
|
+
|
|
98
|
+
const SCREEN_ID = /^[a-z][a-z0-9-]{0,39}$/
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Why its manifest's entries cannot name the screens they do (story 323): a
|
|
102
|
+
* screen needs schema 6 and a server half to describe it, and an entry names a
|
|
103
|
+
* screen or a module, never both. Pure.
|
|
104
|
+
*/
|
|
105
|
+
export function screenEntryProblems(f: Record<string, unknown>, schema: number): string[] {
|
|
106
|
+
if (!Array.isArray(f.extensions)) return []
|
|
107
|
+
const problems: string[] = []
|
|
108
|
+
for (const entry of f.extensions) {
|
|
109
|
+
if (!isPlainObject(entry) || entry.screen === undefined) continue
|
|
110
|
+
const alias = typeof entry.alias === 'string' ? entry.alias : 'an entry'
|
|
111
|
+
if (typeof entry.screen !== 'string' || !SCREEN_ID.test(entry.screen))
|
|
112
|
+
problems.push(
|
|
113
|
+
`${alias} names the screen ${JSON.stringify(entry.screen)}, which is not a screen id`,
|
|
114
|
+
)
|
|
115
|
+
else if (schema < SCREEN_SCHEMA_VERSION)
|
|
116
|
+
problems.push(
|
|
117
|
+
`${alias} names a screen, which needs "crombolo.schemaVersion": ${SCREEN_SCHEMA_VERSION}`,
|
|
118
|
+
)
|
|
119
|
+
if (entry.element !== undefined || entry.js !== undefined)
|
|
120
|
+
problems.push(`${alias} names a screen and a module: it is drawn from one or the other`)
|
|
121
|
+
if (f.server === undefined)
|
|
122
|
+
problems.push(`${alias} names a screen, and the package has no server half to describe it`)
|
|
123
|
+
}
|
|
124
|
+
return problems
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* The oldest schema read: an extension at 5 or before is refused until it is
|
|
129
|
+
* migrated (stories 320, 329).
|
|
130
|
+
*/
|
|
131
|
+
export const OLDEST_BUNDLE_SCHEMA_VERSION = 6
|
|
132
|
+
|
|
133
|
+
/** The schema that put an extension's code in `src/server/` and `src/backoffice/` (story 320). */
|
|
134
|
+
export const LAYOUT_SCHEMA_VERSION = 5
|
|
95
135
|
|
|
96
136
|
/**
|
|
97
137
|
* The oldest server half the site's config may still wire in itself: its own
|
|
@@ -175,6 +215,18 @@ export interface BundlePackage {
|
|
|
175
215
|
/** The package's directory, when it carries content: the payload is the package. */
|
|
176
216
|
contentDir: string | undefined
|
|
177
217
|
carries: { extensions: boolean; content: boolean; server: boolean }
|
|
218
|
+
/** Its root, `extensions/<id>/`, when it was installed into one (story 326). */
|
|
219
|
+
root?: string
|
|
220
|
+
/**
|
|
221
|
+
* An extension the site lists as a dependency, the way before story 326: run
|
|
222
|
+
* only when the site's config wires it, as the site's own code.
|
|
223
|
+
*/
|
|
224
|
+
dependency?: true
|
|
225
|
+
/**
|
|
226
|
+
* A dependency that is a link to a package on this machine, a workspace's or
|
|
227
|
+
* one `bun link` made: a developer's, allowed outside production (story 326).
|
|
228
|
+
*/
|
|
229
|
+
linked?: true
|
|
178
230
|
}
|
|
179
231
|
|
|
180
232
|
export interface PackageJson {
|
|
@@ -217,12 +269,14 @@ export function schemaProblem(schema: number, options: { wired?: boolean } = {})
|
|
|
217
269
|
? 'it declares the permissions it needs in "crombolo.permissions" (docs/bundles.md, "Permissions")'
|
|
218
270
|
: '',
|
|
219
271
|
schema < 4 && !options.wired ? 'each permission gives its reason' : '',
|
|
220
|
-
options.wired
|
|
272
|
+
options.wired || schema >= LAYOUT_SCHEMA_VERSION
|
|
221
273
|
? ''
|
|
222
|
-
: `its server code moves to ${SERVER_DIR}/ and its back-office code to ${BACKOFFICE_DIR}
|
|
274
|
+
: `its server code moves to ${SERVER_DIR}/ and its back-office code to ${BACKOFFICE_DIR}/`,
|
|
275
|
+
options.wired ? '' : '"actAs" becomes "user.delegate" (story 325)',
|
|
223
276
|
].filter(Boolean)
|
|
277
|
+
const migrate = options.wired ? '' : ', which `crombolo extension migrate <dir>` does'
|
|
224
278
|
const reads = options.wired ? OLDEST_WIRED_SCHEMA_VERSION : BUNDLE_SCHEMA_VERSION
|
|
225
|
-
return `it is written for bundle schema ${schema}, and this release reads ${reads}${options.wired ? ` to ${BUNDLE_SCHEMA_VERSION}` : ''}: ${changes.join(', and ')}, with "crombolo.schemaVersion": ${BUNDLE_SCHEMA_VERSION}${options.wired ? '' : '; then publish it again'}`
|
|
279
|
+
return `it is written for bundle schema ${schema}, and this release reads ${reads}${options.wired ? ` to ${BUNDLE_SCHEMA_VERSION}` : ''}: ${changes.join(', and ')}, with "crombolo.schemaVersion": ${BUNDLE_SCHEMA_VERSION}${migrate}${options.wired ? '' : '; then publish it again'}`
|
|
226
280
|
}
|
|
227
281
|
|
|
228
282
|
/**
|
|
@@ -351,7 +405,7 @@ export function validateBundlePackage(json: PackageJson, directory?: string): st
|
|
|
351
405
|
else if (f.permissions !== undefined) {
|
|
352
406
|
const problem = permissionsProblem(f.permissions, schema)
|
|
353
407
|
if (problem) problems.push(problem)
|
|
354
|
-
else if (schema >=
|
|
408
|
+
else if (schema >= OLDEST_BUNDLE_SCHEMA_VERSION) {
|
|
355
409
|
const asksForCode = Object.hasOwn(f.permissions as object, BACKOFFICE_CODE)
|
|
356
410
|
if (modules.length > 0 && !asksForCode)
|
|
357
411
|
problems.push(
|
|
@@ -384,6 +438,8 @@ export function validateBundlePackage(json: PackageJson, directory?: string): st
|
|
|
384
438
|
)
|
|
385
439
|
}
|
|
386
440
|
|
|
441
|
+
problems.push(...screenEntryProblems(f, schema))
|
|
442
|
+
|
|
387
443
|
const hasExtensions = Array.isArray(f.extensions) && f.extensions.length > 0
|
|
388
444
|
if (!hasExtensions && f.content === undefined && f.server === undefined)
|
|
389
445
|
problems.push(
|
|
@@ -507,6 +563,25 @@ export interface DiscoveredBundles {
|
|
|
507
563
|
export function discoverBundles(siteDir: string): DiscoveredBundles {
|
|
508
564
|
const json = readPackageJson(join(siteDir, 'package.json'))
|
|
509
565
|
const found: DiscoveredBundles = { bundles: [], problems: [] }
|
|
566
|
+
// Story 326: what the record names, each from its own root.
|
|
567
|
+
const seen = new Set<string>()
|
|
568
|
+
for (const [id, line] of Object.entries(readRecord(siteDir)).sort(([a], [b]) =>
|
|
569
|
+
a.localeCompare(b),
|
|
570
|
+
)) {
|
|
571
|
+
const directory = packageInRoot(siteDir, id, line.name)
|
|
572
|
+
if (!existsSync(join(directory, 'package.json'))) continue
|
|
573
|
+
const read = readBundlePackage(directory)
|
|
574
|
+
seen.add(line.name)
|
|
575
|
+
if (read.bundle?.bundleType === 'site')
|
|
576
|
+
found.problems.push({ packageName: line.name, problems: [SITE_PACKAGE_NOT_INSTALLED] })
|
|
577
|
+
else if (read.bundle) found.bundles.push({ ...read.bundle, root: rootOf(siteDir, id) })
|
|
578
|
+
else if (read.problems.length > 0)
|
|
579
|
+
found.problems.push({
|
|
580
|
+
packageName: line.name,
|
|
581
|
+
problems: read.problems,
|
|
582
|
+
...(read.untyped ? { untyped: read.untyped } : {}),
|
|
583
|
+
})
|
|
584
|
+
}
|
|
510
585
|
// A peer is declared too: a site whose host provides `@crombolo/*` lists
|
|
511
586
|
// them there (story 192).
|
|
512
587
|
const names = new Set([
|
|
@@ -514,12 +589,20 @@ export function discoverBundles(siteDir: string): DiscoveredBundles {
|
|
|
514
589
|
...Object.keys(json?.peerDependencies ?? {}),
|
|
515
590
|
])
|
|
516
591
|
for (const name of [...names].sort()) {
|
|
592
|
+
if (seen.has(name)) continue
|
|
517
593
|
const directory = resolvePackageDir(siteDir, name)
|
|
518
594
|
if (!directory) continue
|
|
519
595
|
const read = readBundlePackage(directory)
|
|
520
596
|
if (read.bundle?.bundleType === 'site')
|
|
521
597
|
found.problems.push({ packageName: name, problems: [SITE_PACKAGE_NOT_INSTALLED] })
|
|
522
|
-
else if (read.bundle)
|
|
598
|
+
else if (read.bundle)
|
|
599
|
+
found.bundles.push(
|
|
600
|
+
read.bundle.bundleType !== 'extension'
|
|
601
|
+
? read.bundle
|
|
602
|
+
: isLinked(directory)
|
|
603
|
+
? { ...read.bundle, linked: true }
|
|
604
|
+
: { ...read.bundle, dependency: true },
|
|
605
|
+
)
|
|
523
606
|
else if (read.problems.length > 0)
|
|
524
607
|
found.problems.push({
|
|
525
608
|
packageName: name,
|
|
@@ -530,6 +613,15 @@ export function discoverBundles(siteDir: string): DiscoveredBundles {
|
|
|
530
613
|
return found
|
|
531
614
|
}
|
|
532
615
|
|
|
616
|
+
/** Whether a package directory is a link to one elsewhere on this machine, as a workspace's is. */
|
|
617
|
+
function isLinked(directory: string): boolean {
|
|
618
|
+
try {
|
|
619
|
+
return lstatSync(directory).isSymbolicLink() || realpathSync(directory) !== directory
|
|
620
|
+
} catch {
|
|
621
|
+
return false
|
|
622
|
+
}
|
|
623
|
+
}
|
|
624
|
+
|
|
533
625
|
/** Whether a path is a directory, for telling a package path from a package name. */
|
|
534
626
|
export function isDirectory(path: string): boolean {
|
|
535
627
|
try {
|
|
@@ -38,7 +38,9 @@ export const BUNDLE_PERMISSIONS = {
|
|
|
38
38
|
'identityProviders.write': "Change administrators' settings for those sign-in providers",
|
|
39
39
|
'member.delegate':
|
|
40
40
|
'Act for a signed-in member who uses it: what it adds is theirs, and it sees only what they may see',
|
|
41
|
-
|
|
41
|
+
// Story 325: as wide as the person using it, and recorded against them.
|
|
42
|
+
'user.delegate':
|
|
43
|
+
'Act for the person using it in the back office: it can do anything they can do here, and everything it does is recorded against them',
|
|
42
44
|
'events.content': 'Be told when pages are saved, published, moved or deleted',
|
|
43
45
|
'http.outbound':
|
|
44
46
|
'Send requests from the server, and from its screens in your browser, to the addresses it names',
|
|
@@ -72,10 +74,139 @@ export const BACKOFFICE_CODE = 'backoffice.code'
|
|
|
72
74
|
* what its signature shows.
|
|
73
75
|
*/
|
|
74
76
|
export const BACKOFFICE_CODE_WARNING =
|
|
75
|
-
"
|
|
77
|
+
"Runs its own code inside your back office, with the same access as the site's own code. Nothing it does there can be watched or limited. Only install this from a publisher you trust as you trust your own developers."
|
|
76
78
|
|
|
77
|
-
/**
|
|
78
|
-
export const
|
|
79
|
+
/** The permission to act for the person using it (story 325). */
|
|
80
|
+
export const USER_DELEGATE = 'user.delegate'
|
|
81
|
+
|
|
82
|
+
/** What the install says beside `user.delegate`. */
|
|
83
|
+
export const USER_DELEGATE_DETAIL =
|
|
84
|
+
'When nobody is using it, for a scheduled job or an event, it acts for whoever granted it instead. It may never install or grant extensions, or change users and groups, for anyone.'
|
|
85
|
+
|
|
86
|
+
/** Each area's read and write, which `user.delegate` already covers. */
|
|
87
|
+
export const AREA_PERMISSIONS: readonly string[] = Object.keys(BUNDLE_PERMISSIONS).filter(
|
|
88
|
+
(permission) => /^[a-zA-Z]+\.(read|write)$/.test(permission),
|
|
89
|
+
)
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Never offered, whatever an extension asks: writing users could make anyone an
|
|
93
|
+
* administrator, and no extension brings in another or widens a grant (story 324).
|
|
94
|
+
*/
|
|
95
|
+
export const NEVER_OFFERED: ReadonlySet<string> = new Set([
|
|
96
|
+
'users.write',
|
|
97
|
+
'extensions.install',
|
|
98
|
+
'extensions.grant',
|
|
99
|
+
])
|
|
100
|
+
|
|
101
|
+
/** Why each never-offered permission is refused, said where it is asked for. */
|
|
102
|
+
const NEVER_OFFERED_WHY: Readonly<Record<string, string>> = {
|
|
103
|
+
'users.write': 'only an administrator changes users',
|
|
104
|
+
'extensions.install': 'no extension brings in another',
|
|
105
|
+
'extensions.grant': 'no extension widens what it, or another, was granted',
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* How far an extension reaches, computed from what it asks for and never
|
|
110
|
+
* declared (story 324): `backoffice.code` runs unconfined in the back office,
|
|
111
|
+
* `user.delegate` acts as the person using it, and anything else is limited.
|
|
112
|
+
*/
|
|
113
|
+
export type AccessLevel = 'limited' | 'acts-as-you' | 'unrestricted'
|
|
114
|
+
|
|
115
|
+
/** The level a list of permissions adds up to: the highest thing in it. Pure. */
|
|
116
|
+
export function levelOf(permissions: readonly string[]): AccessLevel {
|
|
117
|
+
if (permissions.includes(BACKOFFICE_CODE)) return 'unrestricted'
|
|
118
|
+
if (permissions.includes(USER_DELEGATE)) return 'acts-as-you'
|
|
119
|
+
return 'limited'
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** Whether a level is one of the two only an administrator grants. */
|
|
123
|
+
export const isUpperLevel = (level: AccessLevel) => level !== 'limited'
|
|
124
|
+
|
|
125
|
+
/** The badge and the sentence under it, per level (the maintainer's words). */
|
|
126
|
+
export const LEVEL_WORDS: Readonly<Record<AccessLevel, { label: string; sentence: string }>> = {
|
|
127
|
+
limited: {
|
|
128
|
+
label: 'Limited',
|
|
129
|
+
sentence:
|
|
130
|
+
'Works through the site with only the access below. You can see everything it does and undo it.',
|
|
131
|
+
},
|
|
132
|
+
'acts-as-you': {
|
|
133
|
+
label: 'Acts as you',
|
|
134
|
+
sentence:
|
|
135
|
+
'Can do anything on this site that the person using it can do. Everything it does is recorded against them.',
|
|
136
|
+
},
|
|
137
|
+
unrestricted: {
|
|
138
|
+
label: 'Unrestricted',
|
|
139
|
+
sentence:
|
|
140
|
+
"Runs its own code inside your back office, with the same access as the site's own code. Nothing it does there can be watched or limited. Only install this from a publisher you trust as you trust your own developers.",
|
|
141
|
+
},
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/** What each area is called in the four groups. */
|
|
145
|
+
const AREA_WORDS: Readonly<Record<string, string>> = {
|
|
146
|
+
content: 'pages',
|
|
147
|
+
media: 'media',
|
|
148
|
+
members: 'members',
|
|
149
|
+
users: 'back-office users',
|
|
150
|
+
forms: 'forms',
|
|
151
|
+
formEntries: 'form entries',
|
|
152
|
+
dictionary: 'dictionary words',
|
|
153
|
+
contentTypes: 'content types',
|
|
154
|
+
webhooks: 'webhooks',
|
|
155
|
+
workflows: 'approval workflows',
|
|
156
|
+
redirects: 'redirects',
|
|
157
|
+
identityProviders: 'sign-in providers',
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
/** What an extension adds, by the permission that says so. */
|
|
161
|
+
const ADDS_WORDS: Readonly<Record<string, string>> = {
|
|
162
|
+
'routes.public': 'addresses on the site anyone may visit',
|
|
163
|
+
'events.content': 'something that runs when pages change',
|
|
164
|
+
'data.tables': 'its own data',
|
|
165
|
+
templates: 'page templates',
|
|
166
|
+
[BACKOFFICE_CODE]: 'its own code in your back office',
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** The four groups the install panel shows, and who it acts as when it asks to. */
|
|
170
|
+
export interface PermissionGroups {
|
|
171
|
+
sees: string[]
|
|
172
|
+
changes: string[]
|
|
173
|
+
sendsTo: string[]
|
|
174
|
+
adds: string[]
|
|
175
|
+
actsAs: string[]
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* The catalogue folded into what an administrator reads at a glance (story
|
|
180
|
+
* 324): Sees, Changes, Sends to and Adds, with Acts as when it asks to. Each
|
|
181
|
+
* permission lands in exactly one place. Pure.
|
|
182
|
+
*/
|
|
183
|
+
export function groupsOf(
|
|
184
|
+
declared: readonly (string | DeclaredPermission)[],
|
|
185
|
+
options: { screens?: number } = {},
|
|
186
|
+
): PermissionGroups {
|
|
187
|
+
const groups: PermissionGroups = { sees: [], changes: [], sendsTo: [], adds: [], actsAs: [] }
|
|
188
|
+
const entries = declared.map((entry) =>
|
|
189
|
+
typeof entry === 'string' ? { permission: entry, reason: null } : entry,
|
|
190
|
+
)
|
|
191
|
+
for (const { permission, origins } of entries) {
|
|
192
|
+
const [area, verb] = permission.split('.')
|
|
193
|
+
if (permission === USER_DELEGATE) {
|
|
194
|
+
groups.sees.push('everything you can see')
|
|
195
|
+
groups.changes.push('everything you can change')
|
|
196
|
+
groups.actsAs.push('you, or whoever uses it')
|
|
197
|
+
} else if (permission === 'member.delegate') groups.actsAs.push('members who use it')
|
|
198
|
+
else if (permission === 'http.outbound')
|
|
199
|
+
groups.sendsTo.push(...(origins ?? []).map((origin) => origin.replace(/^https?:\/\//, '')))
|
|
200
|
+
else if (ADDS_WORDS[permission]) groups.adds.push(ADDS_WORDS[permission] as string)
|
|
201
|
+
else if (area && AREA_WORDS[area] && verb === 'read')
|
|
202
|
+
groups.sees.push(AREA_WORDS[area] as string)
|
|
203
|
+
else if (area && AREA_WORDS[area] && verb === 'write')
|
|
204
|
+
groups.changes.push(AREA_WORDS[area] as string)
|
|
205
|
+
}
|
|
206
|
+
if (options.screens)
|
|
207
|
+
groups.adds.push(options.screens === 1 ? 'a screen' : `${options.screens} screens`)
|
|
208
|
+
return groups
|
|
209
|
+
}
|
|
79
210
|
|
|
80
211
|
export const isBundlePermission = (value: unknown): value is BundlePermission =>
|
|
81
212
|
typeof value === 'string' && Object.hasOwn(BUNDLE_PERMISSIONS, value)
|
|
@@ -114,8 +245,14 @@ export function readPermissions(
|
|
|
114
245
|
const declared: DeclaredPermission[] = []
|
|
115
246
|
const problems: string[] = []
|
|
116
247
|
for (const [permission, given] of Object.entries(value as Record<string, unknown>)) {
|
|
248
|
+
if (permission === 'actAs') {
|
|
249
|
+
problems.push(
|
|
250
|
+
`"actAs" is retired: ask for "${USER_DELEGATE}", which acts for the person using it across every area (\`crombolo extension migrate\` rewrites it)`,
|
|
251
|
+
)
|
|
252
|
+
continue
|
|
253
|
+
}
|
|
117
254
|
if (NEVER_OFFERED.has(permission)) {
|
|
118
|
-
problems.push(`"${permission}" is never offered:
|
|
255
|
+
problems.push(`"${permission}" is never offered: ${NEVER_OFFERED_WHY[permission]}`)
|
|
119
256
|
continue
|
|
120
257
|
}
|
|
121
258
|
if (!isBundlePermission(permission)) {
|
|
@@ -141,6 +278,14 @@ export function readPermissions(
|
|
|
141
278
|
declared.push({ permission, reason, origins: origins.filter(isOrigin) })
|
|
142
279
|
} else declared.push({ permission, reason })
|
|
143
280
|
}
|
|
281
|
+
const names = new Set(declared.map((entry) => entry.permission))
|
|
282
|
+
if (names.has(USER_DELEGATE)) {
|
|
283
|
+
const areas = AREA_PERMISSIONS.filter((permission) => names.has(permission))
|
|
284
|
+
if (areas.length > 0)
|
|
285
|
+
problems.push(
|
|
286
|
+
`"${USER_DELEGATE}" already reaches every area the person using it may: drop ${areas.map((p) => `"${p}"`).join(', ')}`,
|
|
287
|
+
)
|
|
288
|
+
}
|
|
144
289
|
return problems.length > 0 ? { problem: problems.join('; ') } : { declared }
|
|
145
290
|
}
|
|
146
291
|
|
|
@@ -150,7 +295,7 @@ export function describePermissions(permissions: readonly (string | DeclaredPerm
|
|
|
150
295
|
allows: string
|
|
151
296
|
reason: string | null
|
|
152
297
|
origins?: string[]
|
|
153
|
-
/** What the install says before it is granted:
|
|
298
|
+
/** What the install says before it is granted: `backoffice.code` (story 320) and `user.delegate` (325). */
|
|
154
299
|
warning?: string
|
|
155
300
|
}[] {
|
|
156
301
|
return permissions.map((entry) => {
|
|
@@ -161,6 +306,7 @@ export function describePermissions(permissions: readonly (string | DeclaredPerm
|
|
|
161
306
|
reason: declared.reason,
|
|
162
307
|
...(declared.origins ? { origins: declared.origins } : {}),
|
|
163
308
|
...(declared.permission === BACKOFFICE_CODE ? { warning: BACKOFFICE_CODE_WARNING } : {}),
|
|
309
|
+
...(declared.permission === USER_DELEGATE ? { warning: USER_DELEGATE_DETAIL } : {}),
|
|
164
310
|
}
|
|
165
311
|
})
|
|
166
312
|
}
|