ddd-ts-kit 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,56 @@
+import { CliError } from '../../cli-error.js';
+import { renderTemplate } from '../../templating/index.js';
+import { applyWiring } from '../apply-wiring.js';
+import { concept } from '../concept.js';
+import { emit } from '../emit.js';
+import { learnTerms } from '../learn-terms.js';
+import { named } from '../named.js';
+import { openScope } from '../open-scope.js';
+import { specVars } from '../spec-vars.js';
+import { vars } from '../vars.js';
+import { wire } from '../wire.js';
+import { jobVars } from './job/job-vars.js';
+import { readSentCommand } from './job/read-sent-command.js';
+import { requestedSchedule } from './job/requested-schedule.js';
+import { writtenSchedule } from './job/written-schedule.js';
+export const jobKind = {
+    name: 'job',
+    aliases: [],
+    usage: 'job <context> <Name> (--every <duration> | --cron "<expression>" [--time-zone <zone>]) --command <UseCaseName> [--term "<Term>=<meaning>"]...',
+    summary: 'A job run by time that sends one command as its own system actor, its spec, its registration, its switch in the job settings of the platform and, where the authorization model makes it one line, the grant of that actor.',
+    positionals: ['context', 'Name'],
+    writesShared: true,
+    textFlags: ['command'],
+    run: (request) => {
+        const scope = openScope(request);
+        const schedule = writtenSchedule(requestedSchedule(request.flags));
+        learnTerms(scope);
+        const name = concept(scope, request.args[1] ?? '', { what: 'job', strip: ['job'] });
+        const command = readSentCommand(scope, commandNamed(scope, name));
+        const context = vars(scope, {
+            name: named(name),
+            spec: specVars(scope, { protected: false }),
+            job: jobVars(scope, { name, schedule, command }),
+        });
+        writeJob(scope, name, context);
+    },
+};
+function commandNamed(scope, name) {
+    const { commandName } = scope.flags;
+    if (commandName !== undefined && commandName.trim() !== '') {
+        return commandName;
+    }
+    throw new CliError('A job needs --command.', `A job only triggers a use case: pass the command it sends, for example \`ddd-ts-kit generate job ${scope.context.kebab} ${name.pascal} --every 15m --command <UseCaseName>\`.`);
+}
+function writeJob(scope, name, context) {
+    emit(scope, context, [
+        ['job/job.ts.tpl', `application/scheduling/${name.kebab}.job.ts`],
+        [
+            `job/job.spec.${scope.config.stack.di === 'tsyringe' ? 'tsyringe' : 'buses'}.ts.tpl`,
+            `test/unit/${name.kebab}.job.spec.ts`,
+        ],
+    ]);
+    wire(scope, 'job', context);
+    applyWiring(scope.ws, `${scope.config.platformDir}/job-settings.ts`, renderTemplate('job/settings.tpl', context));
+}
+//# sourceMappingURL=job-kind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-kind.js","sourceRoot":"","sources":["../../../src/generate/kinds/job-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,EAAE;IACX,KAAK,EACH,+IAA+I;IACjJ,OAAO,EACL,6NAA6N;IAC/N,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,CAAC,SAAS,CAAC;IACtB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,eAAe,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAEnE,UAAU,CAAC,KAAK,CAAC,CAAC;QAElB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAElE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAC3C,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;SACjD,CAAC,CAAC;QAEH,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,KAAY,EAAE,IAAU;IAC5C,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;IAEpC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,wBAAwB,EACxB,oGAAoG,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,yCAAyC,CAChL,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAY,EAAE,IAAU,EAAE,OAAsB;IAChE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE;QACnB,CAAC,gBAAgB,EAAE,0BAA0B,IAAI,CAAC,KAAK,SAAS,CAAC;QACjE;YACE,gBAAgB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,SAAS;YACpF,aAAa,IAAI,CAAC,KAAK,cAAc;SACtC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5B,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,kBAAkB,EAAE,cAAc,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC;AACpH,CAAC"}

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

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

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

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

package/dist/generate/kinds/policy-kind.js

@@ -0,0 +1,38 @@
+import { CliError } from '../../cli-error.js';
+import { renderTemplate } from '../../templating/index.js';
+import { applyWiring } from '../apply-wiring.js';
+import { declarePermission } from '../declare-permission.js';
+import { emit } from '../emit.js';
+import { isDeclared } from '../is-declared.js';
+import { label } from '../label.js';
+import { named } from '../named.js';
+import { openScope } from '../open-scope.js';
+import { permissionNamed } from '../permission-named.js';
+import { vars } from '../vars.js';
+export const policyKind = {
+    name: 'policy',
+    aliases: [],
+    usage: 'policy <context> <Name> --permission <aggregate>.<action>',
+    summary: 'A rule about one element (only the author, not after closing), its spec and its registration with the policies Access asks.',
+    positionals: ['context', 'Name'],
+    writesShared: true,
+    run: (request) => {
+        const scope = openScope(request);
+        const name = label(scope, request.args[1] ?? '', { what: 'policy', strip: ['policy'] });
+        const { permission } = scope.flags;
+        if (permission === undefined) {
+            throw new CliError('A policy needs --permission.', 'A policy refines one permission: pass --permission <aggregate>.<action>, for example --permission invoice.void.');
+        }
+        declarePermission(scope, permissionNamed(scope, permission), name);
+        const context = vars(scope, { name: named(name), access: { permission } });
+        emit(scope, context, [
+            ['policy/policy.ts.tpl', `application/authorization/${name.kebab}.policy.ts`],
+            ['policy/policy.spec.ts.tpl', `test/unit/${name.kebab}.policy.spec.ts`],
+        ]);
+        // A declared policy is found through its decorator: only a policy written as a value is listed for `Access`.
+        if (!isDeclared(scope.config)) {
+            applyWiring(scope.ws, `${scope.config.platformDir}/auth/access-policies.ts`, renderTemplate('policy/registration.tpl', context));
+        }
+    },
+};
+//# sourceMappingURL=policy-kind.js.map

package/dist/generate/kinds/policy-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-kind.js","sourceRoot":"","sources":["../../../src/generate/kinds/policy-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,2DAA2D;IAClE,OAAO,EACL,6HAA6H;IAC/H,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,IAAI;IAClB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxF,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;QAEnC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,QAAQ,CAChB,8BAA8B,EAC9B,iHAAiH,CAClH,CAAC;QACJ,CAAC;QAED,iBAAiB,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QAEnE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QAE3E,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE;YACnB,CAAC,sBAAsB,EAAE,6BAA6B,IAAI,CAAC,KAAK,YAAY,CAAC;YAC7E,CAAC,2BAA2B,EAAE,aAAa,IAAI,CAAC,KAAK,iBAAiB,CAAC;SACxE,CAAC,CAAC;QAEH,6GAA6G;QAC7G,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,WAAW,CACT,KAAK,CAAC,EAAE,EACR,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,0BAA0B,EACrD,cAAc,CAAC,yBAAyB,EAAE,OAAO,CAAC,CACnD,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

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

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

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

package/dist/generate/kinds/port-kind.js

@@ -0,0 +1,27 @@
+import { emit } from '../emit.js';
+import { isDeclared } from '../is-declared.js';
+import { label } from '../label.js';
+import { named } from '../named.js';
+import { openScope } from '../open-scope.js';
+import { vars } from '../vars.js';
+export const portKind = {
+    name: 'port',
+    aliases: [],
+    usage: 'port <context> <Name>',
+    summary: 'A port of the application layer, an abstract class that is also its injection token, and its fake.',
+    positionals: ['context', 'Name'],
+    writesShared: false,
+    run: (request) => {
+        const scope = openScope(request);
+        const name = label(scope, request.args[1] ?? '', { what: 'port', strip: ['port'] });
+        const adapter = `\`ddd-ts-kit generate adapter ${scope.context.kebab} ${name.pascal}\``;
+        emit(scope, vars(scope, { name: named(name) }), [
+            ['port/port.ts.tpl', `application/ports/${name.kebab}.port.ts`],
+            ['port/fake.ts.tpl', `test/fakes/${name.kebab}.fake.ts`],
+        ]);
+        scope.ws.note(isDeclared(scope.config)
+            ? `${name.pascal} has no adapter yet: ${adapter} writes one that declares itself in infrastructure/external.`
+            : `${name.pascal} has no adapter yet: ${adapter} writes one in infrastructure/external and binds it in ${scope.context.kebab}.module.ts.`);
+    },
+};
+//# sourceMappingURL=port-kind.js.map

package/dist/generate/kinds/port-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-kind.js","sourceRoot":"","sources":["../../../src/generate/kinds/port-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,uBAAuB;IAC9B,OAAO,EAAE,oGAAoG;IAC7G,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,KAAK;IACnB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,iCAAiC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;QAExF,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAC9C,CAAC,kBAAkB,EAAE,qBAAqB,IAAI,CAAC,KAAK,UAAU,CAAC;YAC/D,CAAC,kBAAkB,EAAE,cAAc,IAAI,CAAC,KAAK,UAAU,CAAC;SACzD,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,IAAI,CACX,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;YACtB,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,wBAAwB,OAAO,8DAA8D;YAC7G,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,wBAAwB,OAAO,0DAA0D,KAAK,CAAC,OAAO,CAAC,KAAK,aAAa,CAC5I,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/generate/kinds/publish-in-index.d.ts

@@ -0,0 +1,4 @@
+import type { Scope } from '../scope.js';
+/** Exports a file of a published language from its index, once. */
+export declare function publishInIndex({ ws, config }: Pick<Scope, 'ws' | 'config'>, directory: string, file: string): void;
+//# sourceMappingURL=publish-in-index.d.ts.map

package/dist/generate/kinds/publish-in-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-in-index.d.ts","sourceRoot":"","sources":["../../../src/generate/kinds/publish-in-index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBlH"}

package/dist/generate/kinds/publish-in-index.js

@@ -0,0 +1,20 @@
+import { aliasRoots, directoryAlias } from '../../alias/index.js';
+/** Exports a file of a published language from its index, once. */
+export function publishInIndex({ ws, config }, directory, file) {
+    const index = `${directory}/index.ts`;
+    const line = `export * from '${directoryAlias(aliasRoots(config), directory)}/${file}.js';`;
+    const lines = (ws.read(index) ?? '')
+        .split('\n')
+        .filter((existing) => existing.trim() !== '' && existing.trim() !== 'export {};');
+    if (lines.includes(line)) {
+        return;
+    }
+    const content = `${[...lines, line].join('\n')}\n`;
+    if (ws.exists(index)) {
+        ws.update(index, content);
+    }
+    else {
+        ws.create(index, content);
+    }
+}
+//# sourceMappingURL=publish-in-index.js.map

package/dist/generate/kinds/publish-in-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-in-index.js","sourceRoot":"","sources":["../../../src/generate/kinds/publish-in-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGlE,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,EAAE,EAAE,EAAE,MAAM,EAAgC,EAAE,SAAiB,EAAE,IAAY;IAC1G,MAAM,KAAK,GAAG,GAAG,SAAS,WAAW,CAAC;IACtC,MAAM,IAAI,GAAG,kBAAkB,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC;IAE5F,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACjC,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC,CAAC;IAEpF,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAEnD,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

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

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

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

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

package/dist/generate/kinds/query-kind.js

@@ -0,0 +1,79 @@
+import { CliError } from '../../cli-error.js';
+import { accessVars } from '../access-vars.js';
+import { concept } from '../concept.js';
+import { emit } from '../emit.js';
+import { isDeclared } from '../is-declared.js';
+import { learnTerms } from '../learn-terms.js';
+import { named } from '../named.js';
+import { openScope } from '../open-scope.js';
+import { specVars } from '../spec-vars.js';
+import { vars } from '../vars.js';
+import { wire } from '../wire.js';
+export const queryKind = {
+    name: 'query',
+    aliases: [],
+    usage: 'query <context> <UseCaseName> (--permission <aggregate>.<action> | --public) [--search] [--term "<Term>=<meaning>"]...',
+    summary: 'A query, its result, its handler, its read port with an in-memory adapter and a fake, its spec and its registration on the query bus; with --search, one page of a search filtered by the access scope of the actor.',
+    positionals: ['context', 'UseCaseName'],
+    writesShared: false,
+    run: (request) => {
+        const scope = openScope(request);
+        learnTerms(scope);
+        const name = concept(scope, request.args[1] ?? '', { what: 'use case', strip: ['query', 'handler'] });
+        const access = accessVars(scope, { name, kind: 'Query' });
+        const variant = queryVariant(scope, access);
+        const reader = { file: readerFile(scope, name) };
+        const context = vars(scope, {
+            name: named(name),
+            access,
+            spec: specVars(scope, access),
+            search: { resource: searchedResource(access) },
+            reader,
+        });
+        writeQuery(scope, { name, variant, reader: reader.file }, context);
+    },
+};
+/**
+ * The in-memory adapter of the read port. Declared, it is a role file bound by its own
+ * decorator, so it carries the repository suffix.
+ */
+function readerFile(scope, name) {
+    return isDeclared(scope.config) ? `in-memory-${name.kebab}-reader.repository` : `in-memory-${name.kebab}.reader`;
+}
+/** `--search`: the templates of a paginated search. A search is narrowed by what its actor may see, so it names a permission. */
+function queryVariant(scope, access) {
+    if (!scope.flags.search) {
+        return '';
+    }
+    if (access['protected'] === true) {
+        return 'search.';
+    }
+    throw new CliError('--search cannot be combined with --public.', 'A generated search is filtered by the access scope the authorizer computes for its actor: give it --permission <aggregate>.<action>, or generate a plain public query and page it yourself.');
+}
+/** The element a search answers, as the authorization model names it: the aggregate of its permission, to start with. */
+function searchedResource(access) {
+    const permission = access['permission'];
+    return typeof permission === 'string' ? (permission.split('.')[0] ?? '') : '';
+}
+function writeQuery(scope, { name, variant, reader }, context) {
+    const folder = `application/queries/${name.kebab}`;
+    emit(scope, context, [
+        [`query/${variant}query.ts.tpl`, `${folder}/${name.kebab}.query.ts`],
+        [`query/${variant}result.ts.tpl`, `${folder}/${name.kebab}.result.ts`],
+        [`query/${variant}handler.ts.tpl`, `${folder}/${name.kebab}.handler.ts`],
+        [`query/${variant}reader.port.ts.tpl`, `application/ports/${name.kebab}-reader.port.ts`],
+        [`query/${variant}reader.in-memory.ts.tpl`, `infrastructure/persistence/${reader}.ts`],
+        [`query/${variant}reader.fake.ts.tpl`, `test/fakes/${name.kebab}-reader.fake.ts`],
+        [
+            `query/${variant}handler.spec.${scope.config.stack.di === 'tsyringe' ? 'tsyringe' : 'buses'}.ts.tpl`,
+            `test/unit/${name.kebab}.handler.spec.ts`,
+        ],
+        ...readerSpec(variant, reader),
+    ]);
+    wire(scope, variant === '' ? 'query' : 'query/search', context);
+}
+/** The canned reader of a search pages, sorts and filters by the access scope: an adapter, held by a spec of its own. */
+function readerSpec(variant, reader) {
+    return variant === '' ? [] : [['query/search.reader.spec.ts.tpl', `test/integration/${reader}.spec.ts`]];
+}
+//# sourceMappingURL=query-kind.js.map

package/dist/generate/kinds/query-kind.js.map

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

package/dist/generate/kinds/repository-adapter.d.ts

@@ -0,0 +1,10 @@
+import type { OrmStack } from '../../config/index.js';
+import type { Name } from '../../naming/index.js';
+import type { Output } from '../emit.js';
+/** The adapter each ORM of the stack gets: its class prefix and the files written next to the port. */
+export interface RepositoryAdapter {
+    readonly prefix: string;
+    readonly files: (aggregate: Name) => Output[];
+}
+export declare const REPOSITORY_ADAPTERS: Readonly<Record<OrmStack, RepositoryAdapter>>;
+//# sourceMappingURL=repository-adapter.d.ts.map

package/dist/generate/kinds/repository-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-adapter.d.ts","sourceRoot":"","sources":["../../../src/generate/kinds/repository-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,uGAAuG;AACvG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;CAC/C;AAED,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAO7E,CAAC"}

package/dist/generate/kinds/repository-adapter.js

@@ -0,0 +1,23 @@
+export const REPOSITORY_ADAPTERS = {
+    none: { prefix: 'InMemory', files: inMemoryAdapter },
+    custom: { prefix: 'InMemory', files: inMemoryAdapter },
+    drizzle: { prefix: 'Drizzle', files: ormAdapter('drizzle', 'drizzle') },
+    knex: { prefix: 'Knex', files: ormAdapter('knex', 'knex', ['row']) },
+    prisma: { prefix: 'Prisma', files: ormAdapter('prisma', 'prisma') },
+    typeorm: { prefix: 'TypeOrm', files: ormAdapter('typeorm', 'type-orm', ['row']) },
+};
+function inMemoryAdapter(aggregate) {
+    return [['repository/none/repository.ts.tpl', persistence(`in-memory-${aggregate.kebab}.repository`)]];
+}
+/** The mapper and the adapter every ORM writes, then the files of its own. */
+function ormAdapter(orm, prefix, extra = []) {
+    return (aggregate) => [
+        [`repository/${orm}/mapper.ts.tpl`, persistence(`${aggregate.kebab}.mapper`)],
+        ...extra.map((file) => [`repository/${orm}/${file}.ts.tpl`, persistence(`${aggregate.kebab}-${file}.schema`)]),
+        [`repository/${orm}/repository.ts.tpl`, persistence(`${prefix}-${aggregate.kebab}.repository`)],
+    ];
+}
+function persistence(file) {
+    return `infrastructure/persistence/${file}.ts`;
+}
+//# sourceMappingURL=repository-adapter.js.map

package/dist/generate/kinds/repository-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-adapter.js","sourceRoot":"","sources":["../../../src/generate/kinds/repository-adapter.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,mBAAmB,GAAkD;IAChF,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE;IACpD,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE;IACtD,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE;IACvE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE;IACpE,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;IACnE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE;CAClF,CAAC;AAEF,SAAS,eAAe,CAAC,SAAe;IACtC,OAAO,CAAC,CAAC,mCAAmC,EAAE,WAAW,CAAC,aAAa,SAAS,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CAAC,GAAW,EAAE,MAAc,EAAE,KAAK,GAAsB,EAAE;IAC5E,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACpB,CAAC,cAAc,GAAG,gBAAgB,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,KAAK,SAAS,CAAC,CAAC;QAC7E,GAAG,KAAK,CAAC,GAAG,CACV,CAAC,IAAI,EAAU,EAAE,CAAC,CAAC,cAAc,GAAG,IAAI,IAAI,SAAS,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,KAAK,IAAI,IAAI,SAAS,CAAC,CAAC,CACzG;QACD,CAAC,cAAc,GAAG,oBAAoB,EAAE,WAAW,CAAC,GAAG,MAAM,IAAI,SAAS,CAAC,KAAK,aAAa,CAAC,CAAC;KAChG,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,8BAA8B,IAAI,KAAK,CAAC;AACjD,CAAC"}

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

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

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

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

package/dist/generate/kinds/repository-kind.js

@@ -0,0 +1,16 @@
+import { openScope } from '../open-scope.js';
+import { existingAggregate } from './existing-aggregate.js';
+import { generateRepository } from './generate-repository.js';
+export const repositoryKind = {
+    name: 'repository',
+    aliases: [],
+    usage: 'repository <context> <Aggregate> [--tenant-scoped]',
+    summary: "A repository port (an abstract class of the domain), its in-memory fake, the adapter of the project's ORM with its mapper, the contract suite both pass, and its registration.",
+    positionals: ['context', 'Aggregate'],
+    writesShared: true,
+    run: (request) => {
+        const scope = openScope(request);
+        generateRepository(scope, existingAggregate(scope, request.args[1] ?? ''));
+    },
+};
+//# sourceMappingURL=repository-kind.js.map

package/dist/generate/kinds/repository-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-kind.js","sourceRoot":"","sources":["../../../src/generate/kinds/repository-kind.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,oDAAoD;IAC3D,OAAO,EACL,gLAAgL;IAClL,WAAW,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IACrC,YAAY,EAAE,IAAI;IAClB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjC,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;CACF,CAAC"}

package/dist/generate/kinds/route/dto-classes.d.ts

@@ -0,0 +1,5 @@
+import type { Endpoint } from './endpoint.js';
+import type { UseCase } from './use-case.js';
+/** The class-validator classes a route reads and answers with, by the role each plays: one class per file. */
+export declare function dtoClasses(endpoint: Endpoint, useCase: UseCase): string[];
+//# sourceMappingURL=dto-classes.d.ts.map

package/dist/generate/kinds/route/dto-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-classes.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/route/dto-classes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,8GAA8G;AAC9G,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAWzE"}

package/dist/generate/kinds/route/dto-classes.js

@@ -0,0 +1,14 @@
+const WITH_BODY = ['POST', 'PUT', 'PATCH'];
+/** The class-validator classes a route reads and answers with, by the role each plays: one class per file. */
+export function dtoClasses(endpoint, useCase) {
+    if (useCase.isSearch) {
+        return ['line'];
+    }
+    return [
+        ...(endpoint.parameters.length > 0 ? ['params'] : []),
+        ...(WITH_BODY.includes(endpoint.method) ? ['body'] : []),
+        ...(useCase.returnsId ? ['accepted'] : []),
+        ...(useCase.isQuery ? ['answer'] : []),
+    ];
+}
+//# sourceMappingURL=dto-classes.js.map

package/dist/generate/kinds/route/dto-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-classes.js","sourceRoot":"","sources":["../../../../src/generate/kinds/route/dto-classes.ts"],"names":[],"mappings":"AAGA,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAE3C,8GAA8G;AAC9G,MAAM,UAAU,UAAU,CAAC,QAAkB,EAAE,OAAgB;IAC7D,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/generate/kinds/route/endpoint.d.ts

@@ -0,0 +1,7 @@
+/** Where a route answers, as `--method` and `--path` say it. */
+export interface Endpoint {
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    readonly path: string;
+    readonly parameters: readonly string[];
+}
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/generate/kinds/route/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/route/endpoint.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC"}

package/dist/generate/kinds/route/endpoint.js

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

package/dist/generate/kinds/route/endpoint.js.map

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

package/dist/generate/kinds/route/find-use-case.d.ts

@@ -0,0 +1,7 @@
+import type { Name } from '../../../naming/index.js';
+import type { KindFlags } from '../../kind.js';
+import type { Scope } from '../../scope.js';
+import type { UseCase } from './use-case.js';
+/** The command or the query of the name, whichever exists, unless `--command` or `--query` says which. */
+export declare function findUseCase(scope: Scope, name: Name, flags: KindFlags): UseCase;
+//# sourceMappingURL=find-use-case.d.ts.map

package/dist/generate/kinds/route/find-use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-use-case.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/route/find-use-case.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAwB/E"}

package/dist/generate/kinds/route/find-use-case.js

@@ -0,0 +1,33 @@
+import { CliError } from '../../../cli-error.js';
+import { requireFile } from '../../require-file.js';
+/** The command or the query of the name, whichever exists, unless `--command` or `--query` says which. */
+export function findUseCase(scope, name, flags) {
+    if (flags.command && flags.query) {
+        throw new CliError('--command and --query exclude each other.', 'Keep the one matching the use case.');
+    }
+    const file = (kind) => `application/${kind === 'query' ? 'queries' : 'commands'}/${name.kebab}/${name.kebab}.${kind}`;
+    const has = (kind) => scope.ws.exists(`${scope.dir}/${file(kind)}.ts`);
+    const isQuery = flags.query || (!flags.command && !has('command') && has('query'));
+    const kind = isQuery ? 'query' : 'command';
+    requireFile(scope, {
+        file: `${file(kind)}.ts`,
+        what: `The ${kind} ${name.pascal}`,
+        createdBy: `ddd-ts-kit generate ${kind} ${scope.context.kebab} ${name.pascal}`,
+    });
+    return {
+        isQuery,
+        message: `${name.pascal}${isQuery ? 'Query' : 'Command'}`,
+        messageFile: file(kind),
+        ...shapeOf(scope.ws.read(`${scope.dir}/${file(kind)}.ts`) ?? '', isQuery),
+    };
+}
+/** What the source of the message says about it, read from its declaration. */
+function shapeOf(source, isQuery) {
+    return {
+        // A command that answers an identifier is declared `extends Command<string>` or `extends AuthorizedCommand<string>`.
+        returnsId: !isQuery && /extends\s+(?:Authorized)?Command<\s*string\s*>/.test(source),
+        isProtected: /extends\s+Authorized(?:Command|Query)\b/.test(source),
+        isSearch: isQuery && /\breadonly page: PageRequest</.test(source),
+    };
+}
+//# sourceMappingURL=find-use-case.js.map

package/dist/generate/kinds/route/find-use-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-use-case.js","sourceRoot":"","sources":["../../../../src/generate/kinds/route/find-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD,0GAA0G;AAC1G,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,IAAU,EAAE,KAAgB;IACpE,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAAC,2CAA2C,EAAE,qCAAqC,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,IAAiB,EAAU,EAAE,CACzC,eAAe,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IAEjG,MAAM,GAAG,GAAG,CAAC,IAAiB,EAAW,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3C,WAAW,CAAC,KAAK,EAAE;QACjB,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK;QACxB,IAAI,EAAE,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE;QAClC,SAAS,EAAE,uBAAuB,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE;KAC/E,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE;QACzD,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;QACvB,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,OAAO,CAAC,MAAc,EAAE,OAAgB;IAC/C,OAAO;QACL,qHAAqH;QACrH,SAAS,EAAE,CAAC,OAAO,IAAI,gDAAgD,CAAC,IAAI,CAAC,MAAM,CAAC;QACpF,WAAW,EAAE,yCAAyC,CAAC,IAAI,CAAC,MAAM,CAAC;QACnE,QAAQ,EAAE,OAAO,IAAI,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/generate/kinds/route/parse-endpoint.d.ts

@@ -0,0 +1,4 @@
+import type { KindFlags } from '../../kind.js';
+import type { Endpoint } from './endpoint.js';
+export declare function parseEndpoint(flags: KindFlags): Endpoint;
+//# sourceMappingURL=parse-endpoint.d.ts.map

package/dist/generate/kinds/route/parse-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-endpoint.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/route/parse-endpoint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAoBxD"}

package/dist/generate/kinds/route/parse-endpoint.js

@@ -0,0 +1,16 @@
+import { isOneOf } from '../../../config/index.js';
+import { CliError } from '../../../cli-error.js';
+const METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
+const ROUTE_PATH = /^\/$|^(\/(:[A-Za-z_][A-Za-z0-9_]*|[A-Za-z0-9._~-]+))+$/;
+export function parseEndpoint(flags) {
+    const method = flags.method?.toUpperCase();
+    if (!isOneOf(METHODS, method)) {
+        throw new CliError(flags.method === undefined ? 'A route needs --method.' : `Unknown method "${flags.method}".`, `Pass --method with one of: ${METHODS.join(', ')}.`);
+    }
+    const { path } = flags;
+    if (path === undefined || !ROUTE_PATH.test(path)) {
+        throw new CliError(path === undefined ? 'A route needs --path.' : `"${path}" is not a valid route path.`, 'Pass --path made of literal segments and ":name" parameters, for example /invoices/:invoiceId.');
+    }
+    return { method, path, parameters: [...path.matchAll(/:([A-Za-z_][A-Za-z0-9_]*)/g)].map((match) => match[1] ?? '') };
+}
+//# sourceMappingURL=parse-endpoint.js.map

package/dist/generate/kinds/route/parse-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-endpoint.js","sourceRoot":"","sources":["../../../../src/generate/kinds/route/parse-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AACnE,MAAM,UAAU,GAAG,wDAAwD,CAAC;AAE5E,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAE3C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAChB,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,MAAM,IAAI,EAC5F,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpD,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAEvB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,QAAQ,CAChB,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,IAAI,8BAA8B,EACrF,gGAAgG,CACjG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;AACvH,CAAC"}

package/dist/generate/kinds/route/route-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 { Endpoint } from './endpoint.js';
+import type { UseCase } from './use-case.js';
+export interface RouteParts {
+    readonly name: Name;
+    readonly endpoint: Endpoint;
+    readonly useCase: UseCase;
+}
+/** What the templates of a route read: its endpoint, the use case it calls and how the stack validates. */
+export declare function routeVars(scope: Scope, { name, endpoint, useCase }: RouteParts): RenderContext;
+//# sourceMappingURL=route-vars.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route-vars.d.ts","sourceRoot":"","sources":["../../../../src/generate/kinds/route/route-vars.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,aAAa,CA2B9F"}

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

@@ -0,0 +1,77 @@
+import { contextAlias } from '../../../alias/index.js';
+import { toName } from '../../../naming/index.js';
+import { dtoClasses } from './dto-classes.js';
+/** What the templates of a route read: its endpoint, the use case it calls and how the stack validates. */
+export function routeVars(scope, { name, endpoint, useCase }) {
+    const hasBody = ['POST', 'PUT', 'PATCH'].includes(endpoint.method);
+    const alias = contextAlias(scope.config, scope.context.kebab);
+    return {
+        method: endpoint.method,
+        path: endpoint.path,
+        status: successStatus(endpoint, useCase),
+        isQuery: useCase.isQuery,
+        isPlainQuery: useCase.isQuery && !useCase.isSearch,
+        isSearch: useCase.isSearch,
+        returnsId: useCase.returnsId,
+        returnsNothing: !useCase.isQuery && !useCase.returnsId,
+        hasBody,
+        usesAnyObject: hasBody || useCase.isQuery,
+        usesSchema: hasBody || useCase.isQuery || useCase.returnsId,
+        dtoImports: dtoClasses(endpoint, useCase)
+            .map((role) => `import { ${name.pascal}${toName(role).pascal} } from '${alias}/presentation/http/${name.kebab}-${role}.dto.js';`)
+            .join('\n'),
+        ...requestVars(scope, endpoint, hasBody),
+        ...busVars(useCase, alias),
+        ...securityVars(scope, useCase),
+        ...parameterVars(endpoint.parameters),
+    };
+}
+function requestVars(scope, { parameters }, hasBody) {
+    const { validation } = scope.config.stack;
+    // Only the zod and class-validator variants declare a schema for path parameters.
+    const typedParameters = parameters.length > 0 && (validation === 'zod' || validation === 'class-validator');
+    return {
+        hasParams: parameters.length > 0,
+        hasRequest: typedParameters || hasBody,
+        requestParts: [...(typedParameters ? ['params'] : []), ...(hasBody ? ['body'] : [])].join(', '),
+    };
+}
+function successStatus(endpoint, useCase) {
+    if (useCase.isQuery) {
+        return 200;
+    }
+    if (!useCase.returnsId) {
+        return 204;
+    }
+    return endpoint.method === 'POST' ? 201 : 200;
+}
+function busVars(useCase, alias) {
+    const message = `import { ${useCase.message} } from '${alias}/${useCase.messageFile}.js';`;
+    return {
+        input: useCase.message,
+        bus: useCase.isQuery ? 'queries' : 'commands',
+        busType: useCase.isQuery ? 'QueryBus' : 'CommandBus',
+        busClass: useCase.isQuery ? 'InMemoryQueryBus' : 'InMemoryCommandBus',
+        useCaseImport: message,
+        messageImport: message,
+    };
+}
+/** A protected use case is reached with a credential; the bus decides, the route only says who is calling. */
+function securityVars(scope, useCase) {
+    const scheme = scope.config.stack.authn === 'none' ? 'developmentActor' : 'bearer';
+    return {
+        protected: useCase.isProtected,
+        security: useCase.isProtected ? `['${scheme}']` : 'false',
+        actor: useCase.isProtected ? 'actorOf(input.context.principal)' : '',
+        errorCodes: useCase.isProtected ? "'UNAUTHORIZED', 'FORBIDDEN'" : '',
+    };
+}
+function parameterVars(parameters) {
+    const sample = parameters.map((parameter) => `${parameter}: '${toName(parameter).kebab}-1'`).join(', ');
+    return {
+        zodParams: parameters.map((parameter) => `${parameter}: z.string().min(1)`).join(', '),
+        dtoParams: parameters.map((parameter) => `@IsString()\n  ${parameter} = '';`).join('\n\n  '),
+        sampleParams: parameters.length > 0 ? `{ ${sample} }` : '{}',
+    };
+}
+//# sourceMappingURL=route-vars.js.map