ddd-ts-kit 0.0.0-stage → 0.1.1

package/dist/generate/kinds/integration-event-kind.js

@@ -0,0 +1,70 @@
+import { refreshContextDoc } from '../../docs/refresh-context-doc.js';
+import { CliError } from '../../cli-error.js';
+import { toName } from '../../naming/index.js';
+import { renderTemplate } from '../../templating/index.js';
+import { applyWiring } from '../apply-wiring.js';
+import { emit } from '../emit.js';
+import { learnTerms } from '../learn-terms.js';
+import { named } from '../named.js';
+import { openScope } from '../open-scope.js';
+import { vars } from '../vars.js';
+import { wire } from '../wire.js';
+import { ensureDomainEvent } from './ensure-domain-event.js';
+import { publishInIndex } from './publish-in-index.js';
+export const integrationEventKind = {
+    name: 'integration-event',
+    aliases: [],
+    usage: 'integration-event <context> <Aggregate> <Fact> [--version <n>] [--term "<Term>=<meaning>"]...',
+    summary: 'A versioned declaration in the published language, its publisher, its spec and its registration.',
+    positionals: ['context', 'Aggregate', 'Fact'],
+    writesShared: true,
+    run: (request) => {
+        const scope = openScope(request);
+        learnTerms(scope);
+        const version = parseVersion(request.flags.version);
+        const names = ensureDomainEvent(scope, request.args[1] ?? '', request.args[2] ?? '');
+        const publisher = toName(version === 1 ? names.event.words : `${names.event.words} v${version}`);
+        const event = { ...named(names.event), name: names.eventName, version };
+        const context = vars(scope, { aggregate: named(names.aggregate), event, publisher: named(publisher) });
+        const published = publishedFiles(scope, `${names.event.kebab}.v${version}`);
+        emit(scope, context, [
+            ...published.map(({ template, file }) => [template, `published-language/${file}.ts`]),
+            ['integration-event/publisher.ts.tpl', `application/integration/publishers/${publisher.kebab}.publisher.ts`],
+            ['integration-event/publisher.spec.ts.tpl', `test/unit/${publisher.kebab}.publisher.spec.ts`],
+        ]);
+        publish(scope, published.map(({ file }) => file), context);
+    },
+};
+/** The declaration of the event, and its payload in a file of its own where the schema library has it written as a class or an interface. */
+function publishedFiles(scope, event) {
+    const flavour = schemaFlavour(scope);
+    const payload = flavour === 'zod' ? [] : [{ template: `integration-event/payload.${flavour}.ts.tpl`, file: `${event}.payload` }];
+    return [
+        ...payload,
+        { template: `integration-event/integration-event.${flavour}.ts.tpl`, file: `${event}.integration-event` },
+    ];
+}
+/** The declaration joins the published language, the lists of the context and, with the audit trail on, the events whose occurrence is recorded (never their payload). */
+function publish(scope, files, context) {
+    const registry = `${scope.config.platformDir}/audit/audited-events.ts`;
+    for (const file of files) {
+        publishInIndex(scope, `${scope.dir}/published-language`, file);
+    }
+    refreshContextDoc(scope.ws, scope.config, scope.context.kebab);
+    wire(scope, 'integration-event', context);
+    if (scope.ws.exists(registry)) {
+        applyWiring(scope.ws, registry, renderTemplate('integration-event/audited.tpl', context));
+    }
+}
+function parseVersion(input) {
+    const version = Number(input ?? '1');
+    if (Number.isInteger(version) && version >= 1) {
+        return version;
+    }
+    throw new CliError(`"${input}" is not a valid version.`, 'Pass --version with a positive integer; bump it only for a breaking change of the payload.');
+}
+function schemaFlavour(scope) {
+    const { validation } = scope.config.stack;
+    return validation === 'zod' || validation === 'class-validator' ? validation : 'custom';
+}
+//# sourceMappingURL=integration-event-kind.js.map

package/dist/generate/kinds/integration-event-kind.js.map

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

package/dist/generate/kinds/integration-handler-kind.d.ts

@@ -0,0 +1,3 @@
+import type { Kind } from '../kind.js';
+export declare const integrationHandlerKind: Kind;
+//# sourceMappingURL=integration-handler-kind.d.ts.map

package/dist/generate/kinds/integration-handler-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-handler-kind.d.ts","sourceRoot":"","sources":["../../../src/generate/kinds/integration-handler-kind.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AASvC,eAAO,MAAM,sBAAsB,EAAE,IAyCpC,CAAC"}

package/dist/generate/kinds/integration-handler-kind.js

@@ -0,0 +1,94 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { CliError } from '../../cli-error.js';
+import { parseContextName, toName } from '../../naming/index.js';
+import { emit } from '../emit.js';
+import { isDeclared } from '../is-declared.js';
+import { named } from '../named.js';
+import { openScope } from '../open-scope.js';
+import { vars } from '../vars.js';
+import { wire } from '../wire.js';
+import { findEventDeclaration } from './find-event-declaration.js';
+export const integrationHandlerKind = {
+    name: 'integration-handler',
+    aliases: ['consumer'],
+    usage: 'integration-handler <context> <upstreamContext> <eventType>',
+    summary: 'An idempotent handler of an integration event of a declared upstream, its spec and its subscription under a consumer name.',
+    positionals: ['context', 'upstreamContext', 'eventType'],
+    writesShared: false,
+    run: (request) => {
+        const scope = openScope(request);
+        const upstream = declaredUpstream(scope, request.args[1] ?? '');
+        const eventType = eventTypeOf(upstream, request.args[2] ?? '');
+        const name = toName(eventType.split('.').join(' '));
+        const declaration = findEventDeclaration(scope, upstream.kebab, eventType);
+        if (declaration === undefined && isDeclared(scope.config)) {
+            throw undeclaredEvent(upstream, eventType);
+        }
+        const context = vars(scope, {
+            name: named(name),
+            upstream: upstreamVars(upstream, eventType, declaration),
+            consumer: subscriptionVars(scope, declaration !== undefined),
+        });
+        emit(scope, context, [
+            [
+                'integration-handler/integration-handler.ts.tpl',
+                `application/integration/handlers/${name.kebab}.integration-handler.ts`,
+            ],
+            ['integration-handler/integration-handler.spec.ts.tpl', `test/unit/${name.kebab}.integration-handler.spec.ts`],
+        ]);
+        wire(scope, 'integration-handler', context);
+        if (declaration === undefined) {
+            scope.ws.note(`No declaration of ${eventType} was found in ${upstream.kebab}/published-language: the handler receives an untyped payload.`);
+        }
+    },
+};
+/** A handler declares itself against the declaration of its event: without one there is nothing to handle. */
+function undeclaredEvent(upstream, eventType) {
+    const [, aggregate = '', fact = ''] = eventType.split('.');
+    return new CliError(`${upstream.kebab} declares no ${eventType} in its published language.`, `An integration event handler declares itself with @IntegrationEventHandler(<definition>, ...), which needs the declaration of the event: create it first with \`ddd-ts-kit generate integration-event ${upstream.kebab} ${toName(aggregate).pascal} ${toName(fact).pascal}\`, then run the command again.`);
+}
+/**
+ * How a hand-wired handler subscribes. In the process, the subscription deduplicates; behind a
+ * broker, each context listens under its own name and the mark commits with the work of the handler.
+ */
+function subscriptionVars(scope, isTyped) {
+    const external = scope.config.stack.broker !== 'none';
+    return {
+        declarative: isTyped && !external,
+        transactional: isTyped && external,
+        untyped: !isTyped,
+        subscriber: external ? `platform.subscriberFor('${scope.context.kebab}')` : 'platform.subscriber',
+    };
+}
+function declaredUpstream(scope, input) {
+    const upstream = parseContextName(input);
+    const declared = scope.config.contexts[scope.context.kebab]?.upstreams.some((candidate) => candidate.context === upstream.kebab) ===
+        true;
+    if (declared) {
+        return upstream;
+    }
+    throw new CliError(`"${scope.context.kebab}" does not declare "${upstream.kebab}" as an upstream.`, `If ${scope.context.kebab} really depends on ${upstream.kebab}, add { "context": "${upstream.kebab}", "relationship": "published-language" } to contexts.${scope.context.kebab}.upstreams in ${CONFIG_FILE}, then run the command again.`);
+}
+function eventTypeOf(upstream, input) {
+    const parts = input.split('.');
+    const wellFormed = parts.length === 3 && parts.every((part) => /^[a-z0-9]+(-[a-z0-9]+)*$/.test(part)) && parts[0] === upstream.kebab;
+    if (wellFormed) {
+        return input;
+    }
+    throw new CliError(`"${input}" is not an event type of "${upstream.kebab}".`, `Pass the type as published, <context>.<aggregate>.<fact> in kebab-case, for example ${upstream.kebab}.invoice.issued.`);
+}
+function upstreamVars(upstream, eventType, declaration) {
+    const [, aggregate = ''] = eventType.split('.');
+    return {
+        ...named(upstream),
+        eventName: eventType,
+        // The one field a generated declaration starts with: the spec builds its sample event from it.
+        payloadKey: `${toName(aggregate).camel}Id`,
+        payloadSample: `${aggregate}-1`,
+        known: declaration !== undefined,
+        eventType: declaration?.typeName ?? '',
+        definition: declaration?.definition ?? '',
+        version: declaration?.version ?? 1,
+    };
+}
+//# sourceMappingURL=integration-handler-kind.js.map

package/dist/generate/kinds/integration-handler-kind.js.map

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

package/dist/generate/kinds/job/constructor-parameters.d.ts

@@ -0,0 +1,3 @@
+/** The parameters a class declares in its constructor, each as written; none when it has no constructor. */
+export declare function constructorParameters(source: string): string[];
+//# sourceMappingURL=constructor-parameters.d.ts.map

package/dist/generate/kinds/job/constructor-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-parameters.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/constructor-parameters.ts"],"names":[],"mappings":"AAGA,4GAA4G;AAC5G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B9D"}

package/dist/generate/kinds/job/constructor-parameters.js

@@ -0,0 +1,33 @@
+const OPENING = '([{<';
+const CLOSING = ')]}>';
+/** The parameters a class declares in its constructor, each as written; none when it has no constructor. */
+export function constructorParameters(source) {
+    const start = /\bconstructor\s*\(/.exec(source);
+    if (start === null) {
+        return [];
+    }
+    const parameters = [];
+    let depth = 0;
+    let current = '';
+    for (const character of source.slice(start.index + start[0].length)) {
+        if (character === ')' && depth === 0) {
+            break;
+        }
+        depth += nesting(character);
+        if (character === ',' && depth === 0) {
+            parameters.push(current);
+            current = '';
+        }
+        else {
+            current += character;
+        }
+    }
+    return [...parameters, current].map((parameter) => parameter.trim()).filter((parameter) => parameter !== '');
+}
+function nesting(character) {
+    if (OPENING.includes(character)) {
+        return 1;
+    }
+    return CLOSING.includes(character) ? -1 : 0;
+}
+//# sourceMappingURL=constructor-parameters.js.map

package/dist/generate/kinds/job/constructor-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-parameters.js","sourceRoot":"","sources":["../../../../src/generate/kinds/job/constructor-parameters.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,MAAM,CAAC;AACvB,MAAM,OAAO,GAAG,MAAM,CAAC;AAEvB,4GAA4G;AAC5G,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,IAAI,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM;QACR,CAAC;QAED,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;QAE5B,IAAI,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,SAAS,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,SAAS,OAAO,CAAC,SAAiB;IAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/generate/kinds/job/grant-system-actor.d.ts

@@ -0,0 +1,17 @@
+import type { Scope } from '../../scope.js';
+import type { SentCommand } from './sent-command.js';
+export interface SystemGrant {
+    /** The generator wrote the grant in the authorization model of the platform. */
+    readonly isWritten: boolean;
+    /** What the team has to do, said in the job file, when nothing was written. */
+    readonly todo: string;
+}
+/**
+ * Gives the system actor of a job the permission its command requires, where the authorization
+ * model of the project makes that one line: a grant of the role of system actors (roles), a rule
+ * about this actor (attribute policies), a relationship to its context (relationships). A model
+ * of your own, a file whose region was removed or a permission written where the generator
+ * cannot read it leave the grant to the team, as a `TODO(domain)` in the job.
+ */
+export declare function grantSystemActor(scope: Scope, job: string, command: SentCommand): SystemGrant;
+//# sourceMappingURL=grant-system-actor.d.ts.map

package/dist/generate/kinds/job/grant-system-actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grant-system-actor.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/grant-system-actor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAWD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,CAU7F"}

package/dist/generate/kinds/job/grant-system-actor.js

@@ -0,0 +1,67 @@
+import { insertInRegion } from '../../../markers/index.js';
+const REGION = 'system-grants';
+const SYSTEM_OPERATES = /operator:\s*\[[^\]]*'system'/;
+/**
+ * Gives the system actor of a job the permission its command requires, where the authorization
+ * model of the project makes that one line: a grant of the role of system actors (roles), a rule
+ * about this actor (attribute policies), a relationship to its context (relationships). A model
+ * of your own, a file whose region was removed or a permission written where the generator
+ * cannot read it leave the grant to the team, as a `TODO(domain)` in the job.
+ */
+export function grantSystemActor(scope, job, command) {
+    const required = command.permission === undefined
+        ? `the permission ${command.name.pascal}Command requires`
+        : `the permission \`${command.permission}\``;
+    const todo = `grant the system actor \`system:${job}\` ${required} in the authorization model of the platform; until then the command refuses the job with FORBIDDEN.`;
+    const placement = command.permission === undefined ? undefined : placementOf(scope, job, command.permission);
+    return { isWritten: placement !== undefined && written(scope, placement), todo };
+}
+function placementOf(scope, job, permission) {
+    const auth = `${scope.config.platformDir}/auth`;
+    const actor = `system:${job}`;
+    switch (scope.config.stack.authz) {
+        case 'rbac':
+            return {
+                file: `${auth}/roles.ts`,
+                line: `'${permission}',`,
+                anchor: `'${permission}',`,
+                check: `check this grant: the role \`system\`, which every system actor holds, now gives \`${actor}\` the permission \`${permission}\` its command requires.`,
+            };
+        case 'abac':
+            return {
+                file: `${auth}/attribute-policies.ts`,
+                line: `permit('system-${job}', ['${permission}'], ({ actor }) => actor.id === '${actor}'),`,
+                anchor: `'system-${job}',`,
+                check: `check this rule: it permits \`${actor}\`, and nobody else, the permission \`${permission}\` its command requires.`,
+            };
+        case 'rebac':
+            return operatorOfContext(scope, actor, permission);
+        default:
+            return undefined;
+    }
+}
+/** The starting schema maps every permission of a context to `operate`; once the team has remodelled it, the relationship is theirs to write. */
+function operatorOfContext(scope, actor, permission) {
+    const auth = `${scope.config.platformDir}/auth`;
+    const context = scope.context.kebab;
+    if (!SYSTEM_OPERATES.test(scope.ws.read(`${auth}/relationship-schema.ts`) ?? '')) {
+        return undefined;
+    }
+    return {
+        file: `${auth}/relate-system-actors.ts`,
+        line: `{ object: 'context:${context}', relation: 'operator', subject: 'system:${actor}' },`,
+        anchor: `subject: 'system:${actor}'`,
+        check: `check this relationship: \`${actor}\` now operates the context \`${context}\`, which gives it \`${permission}\` and every other permission mapped to \`operate\`.`,
+    };
+}
+function written(scope, { file, line, anchor, check }) {
+    const content = scope.ws.read(file);
+    const next = content === undefined ? undefined : insertInRegion(content, REGION, line);
+    if (next === undefined) {
+        return false;
+    }
+    scope.ws.update(file, next);
+    scope.ws.step({ file, anchor, text: check });
+    return true;
+}
+//# sourceMappingURL=grant-system-actor.js.map

package/dist/generate/kinds/job/grant-system-actor.js.map

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

package/dist/generate/kinds/job/job-vars.d.ts

@@ -0,0 +1,13 @@
+import type { Name } from '../../../naming/index.js';
+import type { RenderContext } from '../../../templating/index.js';
+import type { Scope } from '../../scope.js';
+import type { SentCommand } from './sent-command.js';
+export interface JobParts {
+    readonly name: Name;
+    /** The schedule as the source writes it. */
+    readonly schedule: string;
+    readonly command: SentCommand;
+}
+/** What the templates of a job read; the grant of its system actor is written on the way, where the model allows. */
+export declare function jobVars(scope: Scope, { name, schedule, command }: JobParts): RenderContext;
+//# sourceMappingURL=job-vars.d.ts.map

package/dist/generate/kinds/job/job-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-vars.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/job-vars.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,qHAAqH;AACrH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,GAAG,aAAa,CAsB1F"}

package/dist/generate/kinds/job/job-vars.js

@@ -0,0 +1,49 @@
+import { contextAlias } from '../../../alias/index.js';
+import { permissionsFile } from '../../permissions-file.js';
+import { grantSystemActor } from './grant-system-actor.js';
+const PERIOD = 'which period the work is for is said by `execution.scheduledAt`, never by the clock: an occurrence may run late, or twice';
+/** What the templates of a job read; the grant of its system actor is written on the way, where the model allows. */
+export function jobVars(scope, { name, schedule, command }) {
+    const jobName = `${scope.context.kebab}.${name.kebab}`;
+    const actor = command.isProtected ? [`systemActor('${jobName}')`] : [];
+    const grant = command.isProtected ? grantSystemActor(scope, jobName, command) : undefined;
+    return {
+        name: jobName,
+        schedule,
+        switch: `JOB_${scope.context.constant}_${name.constant}_ENABLED`,
+        command: command.name.pascal,
+        commandKebab: command.name.kebab,
+        commandWords: command.name.words,
+        protected: command.isProtected,
+        asActor: command.isProtected ? ' as the system actor of the job' : '',
+        systemActorImport: command.isProtected ? ', systemActor' : '',
+        systemActorValueImport: command.isProtected ? 'systemActor, ' : '',
+        arguments: [...actor, ...(command.takesInstant ? ['execution.scheduledAt'] : [])].join(', '),
+        todo: todoOf(command),
+        ...grantedInSpec(scope, command),
+        ungranted: grant?.isWritten === false,
+        grant: grant?.todo ?? '',
+    };
+}
+function todoOf(command) {
+    const message = `${command.name.pascal}Command`;
+    return command.takesInstant
+        ? `hand ${message} the other data it needs once its constructor declares them; ${PERIOD}.`
+        : `give ${message} a constructor parameter for the instant the work is for and pass it \`execution.scheduledAt\`; ${PERIOD}.`;
+}
+/** What the spec gives the system actor of the job, so that the guard lets its command through: the permission of the command, read where it is written. */
+function grantedInSpec(scope, command) {
+    const key = command.permission?.slice(scope.context.kebab.length + 1);
+    const set = `${scope.context.camel}Permissions`;
+    if (!command.isProtected) {
+        return { granted: '', permissionsImport: '' };
+    }
+    if (key === undefined) {
+        return { granted: "'*'", permissionsImport: '' };
+    }
+    return {
+        granted: `${set}['${key}']`,
+        permissionsImport: `import { ${set} } from '${contextAlias(scope.config, scope.context.kebab)}/${permissionsFile(scope.context).replace(/\.ts$/, '.js')}';`,
+    };
+}
+//# sourceMappingURL=job-vars.js.map

package/dist/generate/kinds/job/job-vars.js.map

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

package/dist/generate/kinds/job/read-sent-command.d.ts

@@ -0,0 +1,5 @@
+import type { Scope } from '../../scope.js';
+import type { SentCommand } from './sent-command.js';
+/** The command `--command` names: it has to exist, and a job has to be able to build it from what it knows. */
+export declare function readSentCommand(scope: Scope, input: string): SentCommand;
+//# sourceMappingURL=read-sent-command.d.ts.map

package/dist/generate/kinds/job/read-sent-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sent-command.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/read-sent-command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,+GAA+G;AAC/G,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA2BxE"}

package/dist/generate/kinds/job/read-sent-command.js

@@ -0,0 +1,62 @@
+import { CliError } from '../../../cli-error.js';
+import { concept } from '../../concept.js';
+import { requireFile } from '../../require-file.js';
+import { constructorParameters } from './constructor-parameters.js';
+const OPTIONAL = /^[^:=]*\?\s*:|=/;
+const INSTANT = /:\s*Date\b/;
+/** The command `--command` names: it has to exist, and a job has to be able to build it from what it knows. */
+export function readSentCommand(scope, input) {
+    const name = concept({ ...scope, flags: { ...scope.flags, allowName: true } }, input, {
+        what: 'use case',
+        strip: ['command', 'handler'],
+    });
+    const file = `application/commands/${name.kebab}/${name.kebab}.command.ts`;
+    requireFile(scope, {
+        file,
+        what: `The command ${name.pascal}`,
+        createdBy: `ddd-ts-kit generate command ${scope.context.kebab} ${name.pascal} --permission <aggregate>.<action>`,
+    });
+    const source = withoutComments(scope.ws.read(`${scope.dir}/${file}`) ?? '');
+    const isProtected = /extends\s+AuthorizedCommand\b/.test(source);
+    const [first = '', ...others] = constructorParameters(source).slice(isProtected ? 1 : 0);
+    const takesInstant = INSTANT.test(first);
+    refuseUnknownInput(scope, name, [...(takesInstant ? [] : [first]), ...others]);
+    return {
+        name,
+        isProtected,
+        permission: isProtected ? requiredPermission(scope, name, source) : undefined,
+        takesInstant,
+    };
+}
+/** A generated command describes its constructor in a `TODO(domain)` comment before it has one. */
+function withoutComments(source) {
+    return source
+        .split('\n')
+        .filter((line) => !line.trim().startsWith('//'))
+        .join('\n');
+}
+/** A job knows its actor and the instant it was due, nothing else: a command that needs more cannot be built by it. */
+function refuseUnknownInput(scope, name, parameters) {
+    const unknown = parameters.filter((parameter) => parameter !== '' && !OPTIONAL.test(parameter)).map(nameOf);
+    if (unknown.length === 0) {
+        return;
+    }
+    throw new CliError(`The constructor of ${name.pascal}Command needs ${unknown.map((parameter) => `\`${parameter}\``).join(', ')}, which a job cannot know.`, `A job only says that the time has come: it sends a command that takes its actor and, at most, the instant the work is for (\`readonly dueBefore: Date\`), and the handler finds what to act on. Create that use case with \`ddd-ts-kit generate command ${scope.context.kebab} <UseCaseName>\` and pass it to --command, or make ${unknown.length === 1 ? 'this parameter' : 'these parameters'} optional.`);
+}
+function nameOf(parameter) {
+    return /([A-Za-z_$][\w$]*)\s*\??\s*(?::|$)/.exec(parameter)?.[1] ?? parameter;
+}
+/**
+ * Read where the style of the project writes it: on the command itself, or next to its
+ * registration in the module file, on the same line or on the next link of the chain.
+ */
+function requiredPermission(scope, name, source) {
+    const module = scope.ws.read(`${scope.dir}/${scope.context.kebab}.module.ts`) ?? '';
+    const between = String.raw `(?:\s*\)\s*\.requires\(\s*|\s*,\s*|[^;\n]*?)`;
+    const registration = new RegExp(String.raw `\b${name.pascal}Command\b${between}\w*Permissions\['([^']+)'\]`);
+    const registered = registration.exec(module)?.[1];
+    const declared = /@Requires\(\s*\w+Permissions\['([^']+)'\]/.exec(source)?.[1];
+    const permission = declared ?? registered;
+    return permission === undefined ? undefined : `${scope.context.kebab}:${permission}`;
+}
+//# sourceMappingURL=read-sent-command.js.map

package/dist/generate/kinds/job/read-sent-command.js.map

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

package/dist/generate/kinds/job/requested-schedule.d.ts

@@ -0,0 +1,5 @@
+import type { KindFlags } from '../../kind.js';
+import type { JobSchedule } from '../../schedule/job-schedule.js';
+/** The schedule `--every`, or `--cron` and `--time-zone`, ask for: exactly one of the two, and one the scheduler can read. */
+export declare function requestedSchedule({ every, cron, timeZone }: KindFlags): JobSchedule;
+//# sourceMappingURL=requested-schedule.d.ts.map

package/dist/generate/kinds/job/requested-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requested-schedule.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/requested-schedule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAKlE,8HAA8H;AAC9H,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,WAAW,CA2BnF"}

package/dist/generate/kinds/job/requested-schedule.js

@@ -0,0 +1,21 @@
+import { CliError } from '../../../cli-error.js';
+import { jobScheduleProblem } from '../../schedule/job-schedule-problem.js';
+const SAMPLE = '--every 15m, or --cron "0 7 * * 1-5" --time-zone Europe/Paris';
+/** The schedule `--every`, or `--cron` and `--time-zone`, ask for: exactly one of the two, and one the scheduler can read. */
+export function requestedSchedule({ every, cron, timeZone }) {
+    if ((every === undefined) === (cron === undefined)) {
+        throw new CliError(every === undefined ? 'A job needs a schedule.' : '--every and --cron exclude each other.', `Pass exactly one of the two: ${SAMPLE}.`);
+    }
+    if (cron === undefined && timeZone !== undefined) {
+        throw new CliError('--time-zone needs --cron.', 'An interval is aligned on the Unix epoch and reads no clock: drop --time-zone, or give the schedule as a cron expression.');
+    }
+    const schedule = every === undefined
+        ? { ...(cron === undefined ? {} : { cron }), ...(timeZone === undefined ? {} : { timeZone }) }
+        : { every };
+    const problem = jobScheduleProblem(schedule);
+    if (problem !== undefined) {
+        throw new CliError(problem, `Pass a schedule the scheduler can read: ${SAMPLE}.`);
+    }
+    return schedule;
+}
+//# sourceMappingURL=requested-schedule.js.map

package/dist/generate/kinds/job/requested-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requested-schedule.js","sourceRoot":"","sources":["../../../../src/generate/kinds/job/requested-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE5E,MAAM,MAAM,GAAG,+DAA+D,CAAC;AAE/E,8HAA8H;AAC9H,MAAM,UAAU,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAa;IACpE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,QAAQ,CAChB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,wCAAwC,EAC1F,gCAAgC,MAAM,GAAG,CAC1C,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjD,MAAM,IAAI,QAAQ,CAChB,2BAA2B,EAC3B,2HAA2H,CAC5H,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC9F,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IAEhB,MAAM,OAAO,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,2CAA2C,MAAM,GAAG,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/generate/kinds/job/sent-command.d.ts

@@ -0,0 +1,12 @@
+import type { Name } from '../../../naming/index.js';
+/** The command a job sends, as its file and the wiring of its context say it. */
+export interface SentCommand {
+    readonly name: Name;
+    /** The command carries its actor: the job sends it as its own system actor, which has to hold the permission. */
+    readonly isProtected: boolean;
+    /** The permission the command requires, as `<context>:<aggregate>.<action>`; undefined when it is not written where the generator reads it. */
+    readonly permission: string | undefined;
+    /** The constructor of the command takes the instant the work is for, right after the actor. */
+    readonly takesInstant: boolean;
+}
+//# sourceMappingURL=sent-command.d.ts.map

package/dist/generate/kinds/job/sent-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sent-command.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/sent-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,iHAAiH;IACjH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,+IAA+I;IAC/I,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC"}

package/dist/generate/kinds/job/sent-command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sent-command.js.map

package/dist/generate/kinds/job/sent-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sent-command.js","sourceRoot":"","sources":["../../../../src/generate/kinds/job/sent-command.ts"],"names":[],"mappings":""}

package/dist/generate/kinds/job/written-schedule.d.ts

@@ -0,0 +1,4 @@
+import type { JobSchedule } from '../../schedule/job-schedule.js';
+/** The schedule as the source of a job writes it: `{ every: '15m' }`, `{ every: 900000 }`, `{ cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' }`. */
+export declare function writtenSchedule({ every, cron, timeZone }: JobSchedule): string;
+//# sourceMappingURL=written-schedule.d.ts.map

package/dist/generate/kinds/job/written-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"written-schedule.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/job/written-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,mJAAmJ;AACnJ,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,MAAM,CAM9E"}

package/dist/generate/kinds/job/written-schedule.js

@@ -0,0 +1,8 @@
+/** The schedule as the source of a job writes it: `{ every: '15m' }`, `{ every: 900000 }`, `{ cron: '0 7 * * 1-5', timeZone: 'Europe/Paris' }`. */
+export function writtenSchedule({ every, cron, timeZone }) {
+    if (every !== undefined) {
+        return `{ every: ${/^\d+$/.test(every.trim()) ? Number(every) : `'${every.trim()}'`} }`;
+    }
+    return `{ cron: '${(cron ?? '').trim().split(/\s+/).join(' ')}'${timeZone === undefined ? '' : `, timeZone: '${timeZone}'`} }`;
+}
+//# sourceMappingURL=written-schedule.js.map

package/dist/generate/kinds/job/written-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"written-schedule.js","sourceRoot":"","sources":["../../../../src/generate/kinds/job/written-schedule.ts"],"names":[],"mappings":"AAEA,mJAAmJ;AACnJ,MAAM,UAAU,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAe;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,YAAY,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;IAC1F,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,QAAQ,GAAG,IAAI,CAAC;AACjI,CAAC"}

package/dist/generate/kinds/job-kind.d.ts

@@ -0,0 +1,3 @@
+import type { Kind } from '../kind.js';
+export declare const jobKind: Kind;
+//# sourceMappingURL=job-kind.d.ts.map

package/dist/generate/kinds/job-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-kind.d.ts","sourceRoot":"","sources":["../../../src/generate/kinds/job-kind.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAavC,eAAO,MAAM,OAAO,EAAE,IA2BrB,CAAC"}