ddd-ts-kit 0.0.0-stage → 0.1.0

package/dist/docs/read-context.js

@@ -0,0 +1,100 @@
+import { parseGlossary } from '../check/language/parse-glossary.js';
+import { toName } from '../naming/index.js';
+import { readDeclarations } from './read-declarations.js';
+import { readJobs } from './read-jobs.js';
+import { withoutComments } from './without-comments.js';
+/** What the config and the files say about one context. */
+export function readContext(ws, config, name) {
+    const directory = `${config.contextsDir}/${name}`;
+    const declared = config.contexts[name];
+    const doc = ws.read(`${directory}/CONTEXT.md`) ?? '';
+    const declarations = config.stack.style === 'declared' ? readDeclarations(ws, directory) : undefined;
+    return {
+        name,
+        classification: declared?.classification ?? 'undeclared',
+        declared: declared !== undefined,
+        onDisk: ws.directories(config.contextsDir).includes(name),
+        purpose: firstSentence(sectionOf(doc, '## Purpose')),
+        glossaryTerms: parseGlossary(doc).terms,
+        upstreams: declared?.upstreams ?? [],
+        downstreams: downstreamsOf(config, name),
+        ...treeFacts(ws, directory, name),
+        ...(declarations === undefined ? namesByConvention(ws, directory) : namesByDeclaration(declarations)),
+        deployable: declared?.deployable === true,
+        ...(declarations === undefined ? {} : { declarations }),
+    };
+}
+/** What the folders of the context hold, whatever the style of the project. */
+function treeFacts(ws, directory, name) {
+    return {
+        aggregates: namesBySuffix(ws, `${directory}/domain/aggregates`, '.aggregate.ts'),
+        domainEvents: namesBySuffix(ws, `${directory}/domain/events`, '.event.ts'),
+        publishedEvents: publishedEventsOf(ws, `${directory}/published-language`),
+        builders: namesBySuffix(ws, `${directory}/test/builders`, '.builder.ts'),
+        permissions: permissionsOf(ws.read(`${directory}/application/authorization/${name}.permissions.ts`) ?? ''),
+        jobs: readJobs(ws, directory, name),
+    };
+}
+/** The explicit style names nothing in its classes: the folders and the file names are what can be read. */
+function namesByConvention(ws, directory) {
+    return {
+        commands: ws.directories(`${directory}/application/commands`).map((folder) => toName(folder).pascal),
+        queries: ws.directories(`${directory}/application/queries`).map((folder) => toName(folder).pascal),
+        policies: namesBySuffix(ws, `${directory}/application/authorization`, '.policy.ts'),
+        gateways: namesBySuffix(ws, `${directory}/application/ports`, '-gateway.port.ts'),
+        integrationEventHandlers: namesBySuffix(ws, `${directory}/application/integration/handlers`, '.integration-handler.ts'),
+    };
+}
+function namesByDeclaration(declarations) {
+    const useCases = (kind) => declarations.useCases.filter((useCase) => useCase.kind === kind).map((useCase) => useCase.name);
+    return {
+        commands: useCases('command'),
+        queries: useCases('query'),
+        policies: declarations.policies.map((policy) => policy.name),
+        gateways: declarations.gateways.map((gateway) => gateway.name),
+        integrationEventHandlers: declarations.integrationEventHandlers.map((handler) => handler.name),
+    };
+}
+function permissionsOf(source) {
+    return [...source.matchAll(/^\s*'([a-z0-9.-]+)':\s*\{/gm)].map((match) => match[1] ?? '');
+}
+function sectionOf(doc, heading) {
+    const lines = doc.split('\n');
+    const start = lines.findIndex((line) => line.trim().toLowerCase() === heading.toLowerCase());
+    if (start === -1) {
+        return '';
+    }
+    const end = lines.findIndex((line, index) => index > start && line.startsWith('## '));
+    return lines
+        .slice(start + 1, end === -1 ? undefined : end)
+        .join('\n')
+        .trim();
+}
+/** The purpose shown in the context map; empty while the section still holds its placeholder. */
+function firstSentence(section) {
+    const text = withoutComments(section).replace(/\s+/g, ' ').trim();
+    if (text === '' || text.includes('TODO(domain)')) {
+        return '';
+    }
+    return /^.*?[.!?](?=\s|$)/.exec(text)?.[0] ?? text;
+}
+function downstreamsOf(config, name) {
+    return Object.entries(config.contexts).flatMap(([other, context]) => context.upstreams
+        .filter((upstream) => upstream.context === name)
+        .map((upstream) => ({ context: other, relationship: upstream.relationship })));
+}
+function namesBySuffix(ws, directory, suffix) {
+    return ws
+        .list(directory)
+        .filter((file) => file.endsWith(suffix))
+        .map((file) => toName(file.slice(0, -suffix.length)).pascal);
+}
+const DECLARED_EVENT = /\btype:\s*'([a-z0-9-]+\.[a-z0-9-]+\.[a-z0-9-]+)',\s*version:\s*(\d+)/g;
+function publishedEventsOf(ws, directory) {
+    const events = ws.list(directory).flatMap((file) => {
+        const content = (ws.read(`${directory}/${file}`) ?? '').replace(/\s+/g, ' ');
+        return [...content.matchAll(DECLARED_EVENT)].map((match) => ({ type: match[1] ?? '', version: Number(match[2]) }));
+    });
+    return events.sort((left, right) => left.type.localeCompare(right.type) || left.version - right.version);
+}
+//# sourceMappingURL=read-context.js.map

package/dist/docs/read-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-context.js","sourceRoot":"","sources":["../../src/docs/read-context.ts"],"names":[],"mappings":"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"}

package/dist/docs/read-contexts.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from '../config/index.js';
+import type { Workspace } from '../workspace/index.js';
+import type { ContextFacts } from './context-facts.js';
+/** Every context of the config or of the disk, by name. */
+export declare function readContexts(ws: Workspace, config: Config): ContextFacts[];
+//# sourceMappingURL=read-contexts.d.ts.map

package/dist/docs/read-contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-contexts.d.ts","sourceRoot":"","sources":["../../src/docs/read-contexts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAI1E"}

package/dist/docs/read-contexts.js

@@ -0,0 +1,7 @@
+import { readContext } from './read-context.js';
+/** Every context of the config or of the disk, by name. */
+export function readContexts(ws, config) {
+    const names = [...new Set([...Object.keys(config.contexts), ...ws.directories(config.contextsDir)])].sort();
+    return names.map((name) => readContext(ws, config, name));
+}
+//# sourceMappingURL=read-contexts.js.map

package/dist/docs/read-contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-contexts.js","sourceRoot":"","sources":["../../src/docs/read-contexts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,EAAa,EAAE,MAAc;IACxD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE5G,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/docs/read-declarations.d.ts

@@ -0,0 +1,5 @@
+import type { Workspace } from '../workspace/index.js';
+import type { DeclaredFacts } from './declared-facts.js';
+/** What the decorators of the role files of a context say. */
+export declare function readDeclarations(ws: Workspace, directory: string): DeclaredFacts;
+//# sourceMappingURL=read-declarations.d.ts.map

package/dist/docs/read-declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-declarations.d.ts","sourceRoot":"","sources":["../../src/docs/read-declarations.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAmB,aAAa,EAAmB,MAAM,qBAAqB,CAAC;AAY3F,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAsBhF"}

package/dist/docs/read-declarations.js

@@ -0,0 +1,66 @@
+import { argumentsOf } from '../check/declarations/arguments-of.js';
+import { declaredAs } from '../check/declarations/declared-as.js';
+import { literalIn } from '../check/declarations/literal-in.js';
+import { optionOf } from '../check/declarations/option-of.js';
+import { scan } from '../check/scan/scan.js';
+import { declaredRoleOf } from '../declared/index.js';
+import { filesUnder } from '../generate/files-under.js';
+/** What the decorators of the role files of a context say. */
+export function readDeclarations(ws, directory) {
+    const declared = declaredClasses(ws, directory);
+    const carrying = (...decorators) => declared.filter(({ decoration }) => decorators.includes(decoration.name));
+    const binding = (found) => ({ name: found.className, token: argument(found, 0) });
+    return {
+        useCases: carrying('Requires', 'Public').map(useCase),
+        integrationEventHandlers: carrying('IntegrationEventHandler').map((found) => ({
+            name: found.className,
+            consumer: option(found, 'consumer'),
+            event: argument(found, 0),
+        })),
+        policies: carrying('Policy').map((found) => ({
+            name: option(found, 'name') || found.className,
+            permission: permission(found),
+        })),
+        gateways: carrying('Gateway').map(binding),
+        adapters: carrying('Repository', 'Adapter').map(binding),
+    };
+}
+/** The classes the role files of a context export with the decorator of their role, in the order of their paths. */
+function declaredClasses(ws, directory) {
+    return filesUnder(ws, directory).flatMap((file) => {
+        const role = declaredRoleOf(file);
+        const text = role === undefined ? undefined : ws.read(`${directory}/${file}`);
+        if (role === undefined || text === undefined) {
+            return [];
+        }
+        const source = scan(text);
+        return declaredAs(source, role.decorators).map(({ declared, decoration }) => ({
+            suffix: role.suffix,
+            className: declared.name,
+            decoration,
+            source,
+            text,
+        }));
+    });
+}
+function useCase(found) {
+    return {
+        kind: found.suffix === 'query' ? 'query' : 'command',
+        name: found.className.replace(/(?:Command|Query)$/, ''),
+        requires: found.decoration.name === 'Public' ? 'public' : permission(found),
+    };
+}
+/** The permission a declaration names: the literal inside its first argument (`permissions['invoice.issue']`), else the argument as written. */
+function permission(found) {
+    const first = argumentsOf(found.source, found.decoration)[0];
+    return (first === undefined ? undefined : literalIn(found.source, first)) ?? argument(found, 0);
+}
+/** An argument of the declaration as it is written in the source. */
+function argument({ source, decoration, text }, index) {
+    const found = argumentsOf(source, decoration)[index];
+    return found === undefined ? '' : text.slice(found.start, found.start + found.code.length);
+}
+function option({ source, decoration }, key) {
+    return optionOf(source, decoration, key)?.literal ?? '';
+}
+//# sourceMappingURL=read-declarations.js.map

package/dist/docs/read-declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-declarations.js","sourceRoot":"","sources":["../../src/docs/read-declarations.ts"],"names":[],"mappings":"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"}

package/dist/docs/read-jobs.d.ts

@@ -0,0 +1,9 @@
+import type { Workspace } from '../workspace/index.js';
+import type { JobFacts } from './context-facts.js';
+/**
+ * The jobs of a context: one per `*.job.ts` file, with the name and the schedule its
+ * registration writes, on the class (`@Scheduled`) or in the module file of the context
+ * (`builder.job(...)`, `platform.jobs.register(...)`), and the command it sends.
+ */
+export declare function readJobs(ws: Workspace, directory: string, context: string): JobFacts[];
+//# sourceMappingURL=read-jobs.d.ts.map

package/dist/docs/read-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-jobs.d.ts","sourceRoot":"","sources":["../../src/docs/read-jobs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMnD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAqBtF"}

package/dist/docs/read-jobs.js

@@ -0,0 +1,48 @@
+import { toName } from '../naming/index.js';
+const FOLDER = 'application/scheduling';
+const SUFFIX = '.job.ts';
+const SCHEDULE = String.raw `(\{[^}]*\})`;
+/**
+ * The jobs of a context: one per `*.job.ts` file, with the name and the schedule its
+ * registration writes, on the class (`@Scheduled`) or in the module file of the context
+ * (`builder.job(...)`, `platform.jobs.register(...)`), and the command it sends.
+ */
+export function readJobs(ws, directory, context) {
+    const module = ws.read(`${directory}/${context}.module.ts`) ?? '';
+    return ws
+        .list(`${directory}/${FOLDER}`)
+        .filter((file) => file.endsWith(SUFFIX) && !file.endsWith('.spec.ts'))
+        .map((file) => {
+        const source = ws.read(`${directory}/${FOLDER}/${file}`) ?? '';
+        const job = toName(file.slice(0, -SUFFIX.length));
+        const [, name, schedule] = registrationOf(job.pascal, job.camel)
+            .map((pattern) => pattern.exec(`${source}\n${module}`))
+            .find((match) => match !== null) ?? [];
+        return {
+            name: name ?? `${job.pascal}Job`,
+            schedule: scheduleText(schedule ?? ''),
+            command: /\bnew (\w+?)Command\(/.exec(source)?.[1] ?? '',
+        };
+    });
+}
+/** How each wiring family writes the registration of the job of a class. */
+function registrationOf(pascal, camel) {
+    return [
+        new RegExp(String.raw `@Scheduled\(\s*'([^']+)',\s*${SCHEDULE}`),
+        new RegExp(String.raw `\.job\(\s*'([^']+)',\s*${SCHEDULE}\s*\)\s*\.handledBy\(\s*${pascal}Job\b`),
+        new RegExp(String.raw `\.register\(\{\s*name:\s*'([^']+)',\s*schedule:\s*${SCHEDULE},\s*run:[^\n]*\b${camel}Job\b`),
+    ];
+}
+/** The text a diagnostic of the kernel gives a schedule: `every 15m`, `cron 0 7 * * 1-5 (UTC)`. */
+function scheduleText(written) {
+    const cron = /\bcron:\s*'([^']+)'/.exec(written)?.[1];
+    const every = /\bevery:\s*(?:'([^']+)'|([\d_]+))/.exec(written);
+    if (cron !== undefined) {
+        return `cron ${cron} (${/\btimeZone:\s*'([^']+)'/.exec(written)?.[1] ?? 'UTC'})`;
+    }
+    if (every === null) {
+        return '';
+    }
+    return `every ${every[1] ?? `${Number((every[2] ?? '').replaceAll('_', ''))}ms`}`;
+}
+//# sourceMappingURL=read-jobs.js.map

package/dist/docs/read-jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-jobs.js","sourceRoot":"","sources":["../../src/docs/read-jobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI5C,MAAM,MAAM,GAAG,wBAAwB,CAAC;AACxC,MAAM,MAAM,GAAG,SAAS,CAAC;AACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAA,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAa,EAAE,SAAiB,EAAE,OAAe;IACxE,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,SAAS,IAAI,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC;IAElE,OAAO,EAAE;SACN,IAAI,CAAC,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;SAC9B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,SAAS,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAElD,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GACtB,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC;aAClC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;aACtD,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,KAAK;YAChC,QAAQ,EAAE,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC;YACtC,OAAO,EAAE,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;SACzD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,4EAA4E;AAC5E,SAAS,cAAc,CAAC,MAAc,EAAE,KAAa;IACnD,OAAO;QACL,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,+BAA+B,QAAQ,EAAE,CAAC;QAC/D,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,0BAA0B,QAAQ,2BAA2B,MAAM,OAAO,CAAC;QAChG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,qDAAqD,QAAQ,mBAAmB,KAAK,OAAO,CAAC;KACnH,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEhE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,QAAQ,IAAI,KAAK,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;IACnF,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpF,CAAC"}

package/dist/docs/refresh-context-doc.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from '../config/index.js';
+import type { Workspace } from '../workspace/index.js';
+/**
+ * Rewrites the generated lists of a CONTEXT.md (aggregates, published events, permissions,
+ * scheduled jobs, relationships) and its reference (use cases, routes, events, ports, policies,
+ * gateways) from what is on disk and in the config. The generator and
+ * `docs` both go through here, so `docs --check` is clean right after a `generate`.
+ */
+export declare function refreshContextDoc(ws: Workspace, config: Config, context: string): void;
+//# sourceMappingURL=refresh-context-doc.d.ts.map

package/dist/docs/refresh-context-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-context-doc.d.ts","sourceRoot":"","sources":["../../src/docs/refresh-context-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQvD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA0BtF"}

package/dist/docs/refresh-context-doc.js

@@ -0,0 +1,62 @@
+import { describeContext } from '../describe/describe-context.js';
+import { referenceLines } from '../describe/reference-lines.js';
+import { replaceRegion } from '../markers/index.js';
+import { ensureReferenceRegion } from './ensure-reference-region.js';
+import { readContext } from './read-context.js';
+/** The regions a CONTEXT.md written before the kit knew them may lack without being told: they are refreshed when present. */
+const LATER_REGIONS = ['jobs'];
+/**
+ * Rewrites the generated lists of a CONTEXT.md (aggregates, published events, permissions,
+ * scheduled jobs, relationships) and its reference (use cases, routes, events, ports, policies,
+ * gateways) from what is on disk and in the config. The generator and
+ * `docs` both go through here, so `docs --check` is clean right after a `generate`.
+ */
+export function refreshContextDoc(ws, config, context) {
+    const file = `${config.contextsDir}/${context}/CONTEXT.md`;
+    const original = ws.read(file);
+    if (original === undefined) {
+        return;
+    }
+    const facts = readContext(ws, config, context);
+    let content = original;
+    for (const [region, lines] of Object.entries(generatedLists(facts))) {
+        const next = replaceRegion(content, region, lines);
+        if (next !== undefined) {
+            content = next;
+        }
+        else if (!LATER_REGIONS.includes(region) || facts.jobs.length > 0) {
+            ws.note(`${file} has no "ddd-ts-kit:${region}" region: its generated list is not kept up to date.`);
+        }
+    }
+    ws.update(file, replaceRegion(ensureReferenceRegion(content), 'reference', referenceLines(describeContext(ws, config, facts))) ??
+        content);
+}
+function generatedLists(facts) {
+    return {
+        aggregates: facts.aggregates.map((name) => `- \`${name}\``),
+        events: facts.publishedEvents.map((event) => `- \`${event.type}\` (version ${event.version})`),
+        permissions: facts.permissions.length > 0
+            ? facts.permissions.map((name) => `- \`${facts.name}:${name}\``)
+            : ['No permission declared.'],
+        jobs: jobLines(facts),
+        relationships: relationshipLines(facts),
+    };
+}
+function jobLines(facts) {
+    if (facts.jobs.length === 0) {
+        return ['No scheduled job.'];
+    }
+    return [
+        '| Job | Schedule | Command |',
+        '|---|---|---|',
+        ...facts.jobs.map((job) => `| \`${job.name}\` | \`${job.schedule}\` | \`${job.command}\` |`),
+    ];
+}
+function relationshipLines(facts) {
+    const lines = [
+        ...facts.upstreams.map((upstream) => `- Downstream of \`${upstream.context}\` (${upstream.relationship}).`),
+        ...facts.downstreams.map((downstream) => `- Upstream of \`${downstream.context}\` (${downstream.relationship}).`),
+    ];
+    return lines.length > 0 ? lines : ['No relationship declared.'];
+}
+//# sourceMappingURL=refresh-context-doc.js.map

package/dist/docs/refresh-context-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-context-doc.js","sourceRoot":"","sources":["../../src/docs/refresh-context-doc.ts"],"names":[],"mappings":"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"}

package/dist/docs/without-comments.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `text` without its HTML comments. A comment left open runs to the end, and the search starts
+ * again after each removal, so the result never holds `<!--`.
+ */
+export declare function withoutComments(text: string): string;
+//# sourceMappingURL=without-comments.d.ts.map

package/dist/docs/without-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"without-comments.d.ts","sourceRoot":"","sources":["../../src/docs/without-comments.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpD"}

package/dist/docs/without-comments.js

@@ -0,0 +1,17 @@
+const OPEN = '<!--';
+const CLOSE = '-->';
+/**
+ * `text` without its HTML comments. A comment left open runs to the end, and the search starts
+ * again after each removal, so the result never holds `<!--`.
+ */
+export function withoutComments(text) {
+    let rest = text;
+    let open = rest.indexOf(OPEN);
+    while (open !== -1) {
+        const close = rest.indexOf(CLOSE, open + OPEN.length);
+        rest = rest.slice(0, open) + (close === -1 ? '' : rest.slice(close + CLOSE.length));
+        open = rest.indexOf(OPEN, Math.max(0, open - OPEN.length));
+    }
+    return rest;
+}
+//# sourceMappingURL=without-comments.js.map

package/dist/docs/without-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"without-comments.js","sourceRoot":"","sources":["../../src/docs/without-comments.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,MAAM,CAAC;AACpB,MAAM,KAAK,GAAG,KAAK,CAAC;AAEpB;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/docs/write-docs.d.ts

@@ -0,0 +1,9 @@
+import type { Config } from '../config/index.js';
+import type { Workspace } from '../workspace/index.js';
+/**
+ * Plans every generated part of the documentation: the lists of each CONTEXT.md, the block
+ * of the context map, the barrel of each declared context, and, once, the skeleton of what only
+ * people can write. The caller commits the workspace, or reads what it would change to detect drift.
+ */
+export declare function writeDocs(ws: Workspace, config: Config): void;
+//# sourceMappingURL=write-docs.d.ts.map

package/dist/docs/write-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-docs.d.ts","sourceRoot":"","sources":["../../src/docs/write-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAKjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AASvD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAmB7D"}

package/dist/docs/write-docs.js

@@ -0,0 +1,43 @@
+import { CliError } from '../cli-error.js';
+import { refreshBarrels } from '../generate/refresh-barrels.js';
+import { replaceRegion } from '../markers/index.js';
+import { readTemplate, renderTemplate } from '../templating/index.js';
+import { brokerStrategy } from './broker-strategy.js';
+import { CONTEXT_MAP } from './context-map-file.js';
+import { contextMapLines } from './context-map-lines.js';
+import { readContexts } from './read-contexts.js';
+import { refreshContextDoc } from './refresh-context-doc.js';
+const INTEGRATION_README = 'docs/integration/README.md';
+/**
+ * Plans every generated part of the documentation: the lists of each CONTEXT.md, the block
+ * of the context map, the barrel of each declared context, and, once, the skeleton of what only
+ * people can write. The caller commits the workspace, or reads what it would change to detect drift.
+ */
+export function writeDocs(ws, config) {
+    const contexts = readContexts(ws, config);
+    for (const context of contexts) {
+        if (context.declared && context.onDisk) {
+            refreshContextDoc(ws, config, context.name);
+        }
+    }
+    writeContextMap(ws, contextMapLines(contexts));
+    refreshBarrels(ws, config);
+    // Written by people from here on: never replaced, not even with --force.
+    if (!ws.exists(INTEGRATION_README)) {
+        ws.create(INTEGRATION_README, renderTemplate('docs/integration-readme.md.tpl', { integration: { strategy: brokerStrategy(config) } }));
+    }
+}
+function writeContextMap(ws, lines) {
+    const existing = ws.read(CONTEXT_MAP);
+    const next = replaceRegion(existing ?? readTemplate('docs/context-map.md.tpl'), 'context-map', lines);
+    if (next === undefined) {
+        throw new CliError(`${CONTEXT_MAP} has no "ddd-ts-kit:context-map" markers.`, 'Put back `<!-- ddd-ts-kit:context-map -->` and `<!-- /ddd-ts-kit:context-map -->` where the generated diagram and table belong; the text around them is yours.');
+    }
+    if (existing === undefined) {
+        ws.create(CONTEXT_MAP, next);
+    }
+    else {
+        ws.update(CONTEXT_MAP, next);
+    }
+}
+//# sourceMappingURL=write-docs.js.map

package/dist/docs/write-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-docs.js","sourceRoot":"","sources":["../../src/docs/write-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,EAAa,EAAE,MAAc;IACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACvC,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,eAAe,CAAC,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE3B,yEAAyE;IACzE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnC,EAAE,CAAC,MAAM,CACP,kBAAkB,EAClB,cAAc,CAAC,gCAAgC,EAAE,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CACxG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,EAAa,EAAE,KAAwB;IAC9D,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,IAAI,YAAY,CAAC,yBAAyB,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAEtG,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,GAAG,WAAW,2CAA2C,EACzD,gKAAgK,CACjK,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/generate/access-vars.d.ts

@@ -0,0 +1,10 @@
+import type { RenderContext } from '../templating/index.js';
+import type { Scope } from './scope.js';
+import type { UseCaseMessage } from './use-case-message.js';
+/**
+ * What `--permission` or `--public` says about a use case, as template variables. Deny by
+ * default: a use case that declares neither is not generated. A new permission joins the
+ * permissions of the context.
+ */
+export declare function accessVars(scope: Scope, useCase: UseCaseMessage): RenderContext;
+//# sourceMappingURL=access-vars.d.ts.map

package/dist/generate/access-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-vars.d.ts","sourceRoot":"","sources":["../../src/generate/access-vars.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAU/E"}

package/dist/generate/access-vars.js

@@ -0,0 +1,81 @@
+import { contextAlias } from '../alias/index.js';
+import { CliError } from '../cli-error.js';
+import { fitStatement } from '../layout/index.js';
+import { declarePermission } from './declare-permission.js';
+import { permissionNamed } from './permission-named.js';
+import { permissionsFile } from './permissions-file.js';
+/**
+ * What `--permission` or `--public` says about a use case, as template variables. Deny by
+ * default: a use case that declares neither is not generated. A new permission joins the
+ * permissions of the context.
+ */
+export function accessVars(scope, useCase) {
+    const permission = requestedPermission(scope, useCase);
+    if (permission === undefined) {
+        return publicAccess(useCase);
+    }
+    declarePermission(scope, permission, useCase.name);
+    return protectedAccess(scope, useCase, permission);
+}
+function requestedPermission(scope, useCase) {
+    const { permission, public: isPublic } = scope.flags;
+    if (permission !== undefined && isPublic) {
+        throw new CliError('--permission and --public exclude each other.', 'Keep --permission for a use case with a right to hold, or --public for one anybody may reach.');
+    }
+    if (permission === undefined && !isPublic) {
+        throw undeclared(scope, useCase);
+    }
+    return permission === undefined ? undefined : permissionNamed(scope, permission);
+}
+function undeclared(scope, useCase) {
+    const sample = `ddd-ts-kit generate ${useCase.kind.toLowerCase()} ${scope.context.kebab} ${useCase.name.pascal}`;
+    return new CliError(`${useCase.name.pascal} declares neither a permission nor that it is public.`, `Nothing is reachable by default (rule authz/declared): run \`${sample} --permission <aggregate>.<action>\`, or \`${sample} --public\` when anybody may call it.`);
+}
+function publicAccess(useCase) {
+    return {
+        protected: false,
+        public: true,
+        permission: '',
+        declaration: '.public()',
+        manualImport: "import { publicUseCase } from '@ddd-ts-kit/auth';",
+        manualDeclaration: `publicUseCase(${useCase.name.pascal}${useCase.kind}),`,
+        permissionsImport: '',
+        holder: '',
+        requirement: '',
+        useCasePermissionsImport: '',
+        decorator: 'Public',
+        decoration: 'Public()',
+        queryBase: 'Query',
+        constructorSample: 'constructor(readonly customerId: string) { super(); }',
+    };
+}
+function protectedAccess(scope, useCase, permission) {
+    const set = `${scope.context.camel}Permissions`;
+    const file = permissionsFile(scope.context).replace(/\.ts$/, '.js');
+    const permissions = `import { ${set} } from '${contextAlias(scope.config, scope.context.kebab)}/${file}';`;
+    const requirement = `${set}['${permission}']${resourceOption(scope)}`;
+    return {
+        protected: true,
+        public: false,
+        permission,
+        declaration: `.requires(${requirement})`,
+        manualImport: "import { requires } from '@ddd-ts-kit/auth';",
+        manualDeclaration: `requires(${useCase.name.pascal}${useCase.kind}, ${requirement}),`,
+        permissionsImport: permissions,
+        holder: 'holder',
+        requirement,
+        useCasePermissionsImport: permissions,
+        decorator: 'Requires',
+        decoration: fitStatement(`@Requires(${requirement})`, '').join('\n').slice(1),
+        queryBase: 'AuthorizedQuery',
+        constructorSample: 'constructor(actor: Actor, readonly customerId: string) { super(actor); }',
+    };
+}
+/** A relationship is always to something: until the elements are modelled, a use case names its context. */
+function resourceOption(scope) {
+    if (scope.config.stack.authz !== 'rebac') {
+        return '';
+    }
+    return `, { resource: () => ({ type: 'context', id: '${scope.context.kebab}' }) }`;
+}
+//# sourceMappingURL=access-vars.js.map

package/dist/generate/access-vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-vars.js","sourceRoot":"","sources":["../../src/generate/access-vars.ts"],"names":[],"mappings":"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"}

package/dist/generate/apply-wiring.d.ts

@@ -0,0 +1,4 @@
+import type { Workspace } from '../workspace/index.js';
+/** Applies a rendered wiring template to a file with marker regions. */
+export declare function applyWiring(ws: Workspace, file: string, wiring: string): void;
+//# sourceMappingURL=apply-wiring.d.ts.map

package/dist/generate/apply-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-wiring.d.ts","sourceRoot":"","sources":["../../src/generate/apply-wiring.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA0B7E"}

package/dist/generate/apply-wiring.js

@@ -0,0 +1,24 @@
+import { insertInRegion, parseWiring } from '../markers/index.js';
+/** Applies a rendered wiring template to a file with marker regions. */
+export function applyWiring(ws, file, wiring) {
+    const original = ws.read(file);
+    if (original === undefined) {
+        ws.note(`${file} does not exist: wire the new element by hand.`);
+        return;
+    }
+    let content = original;
+    for (const [region, block] of parseWiring(wiring)) {
+        if (block.trim() === '') {
+            continue;
+        }
+        const next = insertInRegion(content, region, block);
+        if (next === undefined) {
+            ws.note(`${file} has no "ddd-ts-kit:${region}" region: add this by hand:\n${block.trimEnd()}`);
+        }
+        else {
+            content = next;
+        }
+    }
+    ws.update(file, content);
+}
+//# sourceMappingURL=apply-wiring.js.map