ddd-ts-kit 0.16.0 → 0.17.0

package/dist/generate/searched-elements.js

@@ -0,0 +1,63 @@
+import { plural, singular, toName } from '../naming/index.js';
+/** Names the templates of a search already give to something else, and the reserved words of the language. */
+const TAKEN = new Set([
+    'page',
+    'scope',
+    'visible',
+    'start',
+    'last',
+    'id',
+    'cursor',
+    'left',
+    'right',
+    'toward',
+    'field',
+    'value',
+    'reader',
+    'query',
+    'queries',
+    'request',
+    'input',
+    'line',
+    'new',
+    'delete',
+    'class',
+    'function',
+    'default',
+    'case',
+    'in',
+    'of',
+    'this',
+    'void',
+    'with',
+    'do',
+    'if',
+    'for',
+    'return',
+    'switch',
+    'interface',
+    'package',
+    'static',
+    'let',
+    'yield',
+    'await',
+]);
+/**
+ * The business words of a search, for the bindings that hold its lines: `invoice` and `invoices`
+ * for `SearchInvoices`, never `item` and `items`. A name the template already uses is prefixed:
+ * `foundPage`, `foundPages`.
+ */
+export function searchedElements(name) {
+    const words = name.words.split(' ');
+    const things = words[0] === 'search' && words.length > 1 ? words.slice(1) : words;
+    const last = things.at(-1) ?? '';
+    const one = singular(last);
+    const lead = things.slice(0, -1);
+    const element = toName([...lead, one ?? last].join(' ')).camel;
+    const elements = toName([...lead, one === undefined ? plural(last) : last].join(' ')).camel;
+    if (TAKEN.has(element) || TAKEN.has(elements)) {
+        return { element: `found${toName(element).pascal}`, elements: `found${toName(elements).pascal}` };
+    }
+    return { element, elements };
+}
+//# sourceMappingURL=searched-elements.js.map

package/dist/generate/searched-elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searched-elements.js","sourceRoot":"","sources":["../../src/generate/searched-elements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAa,MAAM,oBAAoB,CAAC;AAQzE,8GAA8G;AAC9G,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;IACpB,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,MAAM;IACN,KAAK;IACL,QAAQ;IACR,OAAO;IACP,UAAU;IACV,SAAS;IACT,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,SAAS;IACT,QAAQ;IACR,KAAK;IACL,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClF,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IAE5F,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,QAAQ,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACpG,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/init/manifest/versions.js

@@ -1,35 +1,35 @@
 /** Ranges written to the generated package.json; bumped together with the kit. */
 export const VERSIONS = {
-    '@ddd-ts-kit/kernel': '^0.16.0',
-    '@ddd-ts-kit/validation': '^0.16.0',
-    '@ddd-ts-kit/http': '^0.16.0',
-    '@ddd-ts-kit/tracing': '^0.16.0',
-    '@ddd-ts-kit/di': '^0.16.0',
-    '@ddd-ts-kit/events': '^0.16.0',
-    '@ddd-ts-kit/testing': '^0.16.0',
-    '@ddd-ts-kit/drizzle': '^0.16.0',
-    '@ddd-ts-kit/knex': '^0.16.0',
-    '@ddd-ts-kit/prisma': '^0.16.0',
-    '@ddd-ts-kit/typeorm': '^0.16.0',
-    '@ddd-ts-kit/auth': '^0.16.0',
-    '@ddd-ts-kit/rabbitmq': '^0.16.0',
-    '@ddd-ts-kit/aspects': '^0.16.0',
-    '@ddd-ts-kit/audit': '^0.16.0',
-    '@ddd-ts-kit/redis': '^0.16.0',
-    '@ddd-ts-kit/kafka': '^0.16.0',
-    '@ddd-ts-kit/nats': '^0.16.0',
-    '@ddd-ts-kit/scheduling': '^0.16.0',
-    '@ddd-ts-kit/sentry': '^0.16.0',
-    '@ddd-ts-kit/s3': '^0.16.0',
+    '@ddd-ts-kit/kernel': '^0.17.0',
+    '@ddd-ts-kit/validation': '^0.17.0',
+    '@ddd-ts-kit/http': '^0.17.0',
+    '@ddd-ts-kit/tracing': '^0.17.0',
+    '@ddd-ts-kit/di': '^0.17.0',
+    '@ddd-ts-kit/events': '^0.17.0',
+    '@ddd-ts-kit/testing': '^0.17.0',
+    '@ddd-ts-kit/drizzle': '^0.17.0',
+    '@ddd-ts-kit/knex': '^0.17.0',
+    '@ddd-ts-kit/prisma': '^0.17.0',
+    '@ddd-ts-kit/typeorm': '^0.17.0',
+    '@ddd-ts-kit/auth': '^0.17.0',
+    '@ddd-ts-kit/rabbitmq': '^0.17.0',
+    '@ddd-ts-kit/aspects': '^0.17.0',
+    '@ddd-ts-kit/audit': '^0.17.0',
+    '@ddd-ts-kit/redis': '^0.17.0',
+    '@ddd-ts-kit/kafka': '^0.17.0',
+    '@ddd-ts-kit/nats': '^0.17.0',
+    '@ddd-ts-kit/scheduling': '^0.17.0',
+    '@ddd-ts-kit/sentry': '^0.17.0',
+    '@ddd-ts-kit/s3': '^0.17.0',
     '@aws-sdk/client-s3': '^3.1150.0',
     '@aws-sdk/lib-storage': '^3.1150.0',
     '@aws-sdk/s3-request-presigner': '^3.1150.0',
     busboy: '^1.6.0',
     '@sentry/node': '^11.6.0',
-    '@ddd-ts-kit/pino': '^0.16.0',
+    '@ddd-ts-kit/pino': '^0.17.0',
     pino: '^10.4.0',
     'pino-pretty': '^13.2.0',
-    '@ddd-ts-kit/winston': '^0.16.0',
+    '@ddd-ts-kit/winston': '^0.17.0',
     winston: '^3.19.0',
     '@confluentinc/kafka-javascript': '^1.11.0',
     '@nats-io/jetstream': '^3.4.0',
@@ -37,7 +37,7 @@ export const VERSIONS = {
     ioredis: '^6.0.0',
     jose: '^6.0.0',
     amqplib: '^2.2.0',
-    'ddd-ts-kit': '^0.16.0',
+    'ddd-ts-kit': '^0.17.0',
     tsx: '^4.23.15',
     vitest: '^5.0.3',
     zod: '^4.6.5',

package/dist/naming/index.d.ts

@@ -6,6 +6,8 @@ export { looksLikePastFact } from './looks-like-past-fact.js';
 export type { Name } from './name.js';
 export { parseConceptName } from './parse-concept-name.js';
 export { parseContextName } from './parse-context-name.js';
+export { plural } from './plural.js';
+export { singular } from './singular.js';
 export { splitWords } from './split-words.js';
 export { toName } from './to-name.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/naming/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/naming/index.js

@@ -5,6 +5,8 @@ export { eventName } from './event-name.js';
 export { looksLikePastFact } from './looks-like-past-fact.js';
 export { parseConceptName } from './parse-concept-name.js';
 export { parseContextName } from './parse-context-name.js';
+export { plural } from './plural.js';
+export { singular } from './singular.js';
 export { splitWords } from './split-words.js';
 export { toName } from './to-name.js';
 //# sourceMappingURL=index.js.map

package/dist/naming/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/naming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/naming/plural.d.ts

@@ -0,0 +1,3 @@
+/** The plural of an English word, as the generator writes table names: `purchase_orders`, `deliveries`. */
+export declare function plural(word: string): string;
+//# sourceMappingURL=plural.d.ts.map

package/dist/naming/plural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural.d.ts","sourceRoot":"","sources":["../../src/naming/plural.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3C"}

package/dist/naming/plural.js

@@ -0,0 +1,8 @@
+/** The plural of an English word, as the generator writes table names: `purchase_orders`, `deliveries`. */
+export function plural(word) {
+    if (/[^aeiou]y$/.test(word)) {
+        return `${word.slice(0, -1)}ies`;
+    }
+    return /(?:s|x|z|ch|sh)$/.test(word) ? `${word}es` : `${word}s`;
+}
+//# sourceMappingURL=plural.js.map

package/dist/naming/plural.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural.js","sourceRoot":"","sources":["../../src/naming/plural.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AAClE,CAAC"}

package/dist/naming/singular.d.ts

@@ -0,0 +1,3 @@
+/** The singular of a plural English word (`reminders`, `deliveries`, `boxes`), or undefined when it does not read as one. */
+export declare function singular(word: string): string | undefined;
+//# sourceMappingURL=singular.d.ts.map

package/dist/naming/singular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singular.d.ts","sourceRoot":"","sources":["../../src/naming/singular.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUzD"}

package/dist/naming/singular.js

@@ -0,0 +1,11 @@
+/** The singular of a plural English word (`reminders`, `deliveries`, `boxes`), or undefined when it does not read as one. */
+export function singular(word) {
+    if (/[^aeiou]ies$/.test(word)) {
+        return `${word.slice(0, -3)}y`;
+    }
+    if (/(?:ss|x|z|ch|sh)es$/.test(word)) {
+        return word.slice(0, -2);
+    }
+    return /[^su]s$/.test(word) ? word.slice(0, -1) : undefined;
+}
+//# sourceMappingURL=singular.js.map

package/dist/naming/singular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singular.js","sourceRoot":"","sources":["../../src/naming/singular.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC;IAED,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9D,CAAC"}

package/dist/naming/to-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-name.d.ts","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAgB1C"}
+{"version":3,"file":"to-name.d.ts","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAItC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAgB1C"}

package/dist/naming/to-name.js

@@ -1,4 +1,5 @@
 import { capitalize } from './capitalize.js';
+import { plural as pluralize } from './plural.js';
 import { splitWords } from './split-words.js';
 export function toName(input) {
     const words = splitWords(input);
@@ -16,10 +17,4 @@ export function toName(input) {
         tableCamel: plural.map((word, index) => (index === 0 ? word : capitalize(word))).join(''),
     };
 }
-function pluralize(word) {
-    if (/[^aeiou]y$/.test(word)) {
-        return `${word.slice(0, -1)}ies`;
-    }
-    return /(?:s|x|z|ch|sh)$/.test(word) ? `${word}es` : `${word}s`;
-}
 //# sourceMappingURL=to-name.js.map

package/dist/naming/to-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-name.js","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QACvC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC1F,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AAClE,CAAC"}
+{"version":3,"file":"to-name.js","sourceRoot":"","sources":["../../src/naming/to-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QACvC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACtB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;QACrD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;KAC1F,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.16.0";
+export declare const VERSION = "0.17.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.16.0';
+export const VERSION = '0.17.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ddd-ts-kit",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Bootstrap, scaffold and verify DDD and Clean Architecture TypeScript projects.",
   "license": "MIT",
   "repository": {
@@ -29,6 +29,6 @@
     "clean:packages": "node dist/bin.js check --clean-only ../kernel/src ../validation/src ../http/src ../tracing/src ../di/src ../events/src ../testing/src ../s3/src ../drizzle/src ../knex/src ../prisma/src ../typeorm/src ../aspects/src ../rabbitmq/src ../auth/src ../audit/src ../redis/src ../scheduling/src ../pino/src ../winston/src ../sentry/src ../kafka/src ../nats/src ../eslint-plugin/src"
   },
   "devDependencies": {
-    "@ddd-ts-kit/kernel": "^0.16.0"
+    "@ddd-ts-kit/kernel": "^0.17.0"
   }
 }

package/templates/command/handler.declared.ts.tpl

@@ -20,11 +20,11 @@ export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Com
 {{#if refusals.classes}}
     // TODO(domain): decide what "{{name.words}}" does to a {{aggregate.pascal}}: either it gives birth to one (keep `create`, pass the facts of `command` as value objects), or it changes an existing one (load it with `findById`, throw a not-found DomainError, call ONE intention method). The events it records leave with the save: nothing else to do here.
 {{/if}}
-    const target = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
+    const {{aggregate.camel}} = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
 
-    await this.{{aggregate.camel}}Repository.save(target);
+    await this.{{aggregate.camel}}Repository.save({{aggregate.camel}});
 
-    return target.id;
+    return {{aggregate.camel}}.id;
   }
 }
 {{/if}}

package/templates/command/handler.ts.tpl

@@ -18,11 +18,11 @@ export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Com
 {{#if refusals.classes}}
     // TODO(domain): decide what "{{name.words}}" does to a {{aggregate.pascal}}: either it gives birth to one (keep `create`, pass the facts of `command` as value objects), or it changes an existing one (load it with `findById`, throw a not-found DomainError, call ONE intention method). The events it records leave with the save: nothing else to do here.
 {{/if}}
-    const target = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
+    const {{aggregate.camel}} = {{aggregate.pascal}}.create(this.ids.next(), this.clock.now());
 
-    await this.{{aggregate.camel}}Repository.save(target);
+    await this.{{aggregate.camel}}Repository.save({{aggregate.camel}});
 
-    return target.id;
+    return {{aggregate.camel}}.id;
   }
 }
 {{/if}}

package/templates/controller/controller.search.ts.tpl

@@ -90,7 +90,7 @@ export class {{name.pascal}}Controller {
     // TODO(domain): hand the criteria of the query over too, once the query schema declares them next to the page (a request mapper is their place); map each line to its public fields.
     const page = await this.queries.execute(new {{route.input}}(request.actor, request.query));
 
-    return pageResponse(page, (item) => ({ id: item.id }));
+    return pageResponse(page, ({{search.element}}) => ({ id: {{search.element}}.id }));
   }
 }
 {{#if search.customSchema}}

package/templates/init/rules/application.md.tpl

@@ -6,7 +6,7 @@ paths:
 # Application layer
 
 - Imports `domain/`, `application/`, published languages, `@ddd-ts-kit/kernel` and `@ddd-ts-kit/auth` only (`layer/application-inward`): never `infrastructure/`, `presentation/`, a framework or a driver.
-- One use case per folder, `commands/<use-case>/` or `queries/<use-case>/`: the message, its handler, a `*.result.ts` when the answer has a shape of its own. The handler has one public method, `execute` (`application/handler-shape`): it loads or builds, calls ONE intention method, `await repository.save(aggregate)`, and returns at most an identifier.
+- One use case per folder, `commands/<use-case>/` or `queries/<use-case>/`: the message, its handler, a `*.result.ts` when the answer has a shape of its own. The handler has one public method, `execute` (`application/handler-shape`): it loads or builds, calls ONE intention method, `await repository.save(aggregate)`, and returns at most an identifier. Each binding is named after the concept it holds, `const invoice = await this.invoiceRepository.findById(command.invoiceId)`, `for (const reminder of dueReminders)`, never `target`, `data` or `item` (`naming/business-name`).
 - Events leave with the save: never `pullEvents()`, never a `DomainEventDispatcher` here (`domain-events/dispatched-on-save`). A reaction is a class of `event-handlers/` or a publisher of `integration/publishers/`. It runs at the end of the unit of work, before the commit, and depends only on what the transaction covers (`domain-events/transactional-before-commit`): repositories, the integration event publisher, the command bus. An effect outside the database is a handler of the `after-commit` phase (`generate event-handler ... --phase after-commit`: at most once, never saves, sends a command) or, when it must not be lost, the handler of an integration event.
 - Nothing here reads the event store: an event-sourced aggregate is loaded and saved through its repository port like any other (`event-sourcing/store-behind-repository`). A projection writes its read model and never a stream (`event-sourcing/projection-never-appends`); one fed by the store is declared `@Projection(name, { feed: 'event-store' })`.
 {{#if style.declared}}

package/templates/init/rules/domain.md.tpl

@@ -7,7 +7,7 @@ paths:
 # Domain layer
 
 - Imports only its own `domain/`, the shared kernel and `@ddd-ts-kit/kernel` (`layer/domain-purity`): no framework, no decorator, no validation library, no `node:` module.
-- Names come from the glossary of `CONTEXT.md`, written first (`language/glossary-term`); no `Manager`, `Helper`, `Data`, `Info`, `Model` (`language/no-technical-name`).
+- Names come from the glossary of `CONTEXT.md`, written first (`language/glossary-term`); no `Manager`, `Helper`, `Data`, `Info`, `Model` (`language/no-technical-name`). A variable, a parameter or a property is named after the concept it holds, `appointment`, `calendar`, never `target`, `data`, `item` (`naming/business-name`).
 - Aggregate: private constructor, `create` for birth, `rehydrate` for loading, state changed by methods named after the business intention, no setter, no public mutable property (`domain/aggregate-encapsulation`). One aggregate per transaction; another one is referenced by its id.
 - A status that moves through a lifecycle is declared once as a state machine, `state-machines/<aggregate>.state-machine.ts` (`generate state-machine <context> <Aggregate> --value .. --transition ..`): the aggregate writes its status only from `machine.next(..)` or `machine.start(..)` (`lifecycle/status-through-machine`), and a forbidden transition is refused by a static factory of its error class (`refused`).
 - A value object is a class extending `ValueObject` of the kernel, one per `value-objects/*.vo.ts` (`npx ddd-ts-kit generate value-object <context> <Name>`): a private constructor, static factories that check its rules (`create`, or named after what they build: `of`, `between`), its operations as methods that return a new instance. It is immutable and compared with `equals` (`domain/value-object-immutability`). An email, an amount, a period are types, not strings.{{#if values.classes}} A value is never a function that builds a plain object, nor an exported object literal (`domain/value-object-class`): the class compares by value, checks its invariants once and is recognised with `instanceof` by a mapper. A function of `domain/` or of the shared kernel that answers a record of data, `({ amount, currency })`, is reported; one that answers value objects it builds (`Money.of(..)`), derives a record with a spread, or answers functions (a specification) is not, and a decision is a refusal thrown by a factory or a value object.{{/if}}

package/templates/init/scripts/events.ts.tpl

@@ -9,7 +9,7 @@ import { contractFormat, stringifyContract } from 'ddd-ts-kit/dist/contracts.js'
 // published language; with --check, fails when a committed file differs. Both files are build
 // products: never edit them by hand.
 const contextsDirectory = '{{config.contextsDir}}';
-const target = path.resolve('docs/integration');
+const catalog = path.resolve('docs/integration');
 const format = contractFormat();
 const other = format === 'yaml' ? 'asyncapi.json' : 'asyncapi.yaml';
 
@@ -34,17 +34,17 @@ const generated: Readonly<Record<string, string>> = {
 if (process.argv.includes('--check')) {
   reportStale();
 } else {
-  fs.mkdirSync(target, { recursive: true });
-  fs.rmSync(path.join(target, other), { force: true });
+  fs.mkdirSync(catalog, { recursive: true });
+  fs.rmSync(path.join(catalog, other), { force: true });
 
   for (const [file, content] of Object.entries(generated)) {
-    fs.writeFileSync(path.join(target, file), content);
+    fs.writeFileSync(path.join(catalog, file), content);
   }
 }
 
 function reportStale(): void {
   for (const [file, content] of Object.entries(generated)) {
-    const committed = fs.existsSync(path.join(target, file)) ? fs.readFileSync(path.join(target, file), 'utf8') : '';
+    const committed = fs.existsSync(path.join(catalog, file)) ? fs.readFileSync(path.join(catalog, file), 'utf8') : '';
 
     if (committed.replaceAll('\r\n', '\n') !== content) {
       console.error('docs/integration/' + file + ' is out of date: run the script `docs:generate` and commit it.');
@@ -52,7 +52,7 @@ function reportStale(): void {
     }
   }
 
-  if (fs.existsSync(path.join(target, other))) {
+  if (fs.existsSync(path.join(catalog, other))) {
     console.error('docs/integration/' + other + ' is in the other format: run the script `docs:generate`.');
     process.exitCode = 1;
   }

package/templates/init/scripts/openapi.ts.tpl

@@ -65,8 +65,8 @@ if (process.argv.includes('--check')) {
 
 function reportDrift(): void {
   for (const [file, content] of generated) {
-    const target = path.join(directory, file);
-    const committed = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : '';
+    const contract = path.join(directory, file);
+    const committed = fs.existsSync(contract) ? fs.readFileSync(contract, 'utf8') : '';
 
     if (committed.replaceAll('\r\n', '\n') !== content) {
       console.error(`openapi/${file} is out of date: run the script \`docs:generate\` and commit it.`);

package/templates/pipeline/package-scripts.json

@@ -23,7 +23,7 @@
     "@biomejs/biome": "2.5.15",
     "@commitlint/cli": "^21.2.3",
     "@commitlint/config-conventional": "^21.2.3",
-    "@ddd-ts-kit/eslint-plugin": "^0.16.0",
+    "@ddd-ts-kit/eslint-plugin": "^0.17.0",
     "@eslint/js": "^10.0.1",
     "@typescript/native": "npm:typescript@~7.0.2",
     "@vitest/coverage-v8": "5.0.3",

package/templates/policy/policy.declared.ts.tpl

@@ -2,7 +2,7 @@ import { isAuthenticated, type Actor } from '@ddd-ts-kit/kernel';
 import { Policy } from '@ddd-ts-kit/kernel/declarations';
 import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions{{alias.ext}}';
 
-// TODO(domain): give `allows` the aggregate "{{name.words}}" reads as its second parameter, add `appliesTo(subject: unknown): boolean { return subject instanceof <Aggregate>; }`, and decide from the actor, the loaded element and `now`; the handler asks it through `Access.authorize(command.actor, permission, element)`.
+// TODO(domain): give `allows` the aggregate "{{name.words}}" reads as its second parameter, add `appliesTo(subject: unknown): boolean { return subject instanceof <Aggregate>; }`, and decide from the actor, the loaded element and `now`; the handler asks it through `Access.authorize(command.actor, permission, <aggregate>)`, the loaded aggregate named after its concept (`invoice`, never `element`).
 @Policy({{context.camel}}Permissions['{{access.permission}}'], { name: '{{context.kebab}}.{{name.kebab}}' })
 export class {{name.pascal}}Policy {
   allows(actor: Actor): boolean {

package/templates/policy/policy.ts.tpl

@@ -2,7 +2,7 @@ import { definePolicy } from '@ddd-ts-kit/auth';
 import { isAuthenticated } from '@ddd-ts-kit/kernel';
 import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions{{alias.ext}}';
 
-// TODO(domain): replace `unknown` by the aggregate "{{name.words}}" reads, add `appliesTo: (subject): subject is <Aggregate> => subject instanceof <Aggregate>`, and decide from the actor, the loaded element and `now`; the handler asks it through `Access.authorize(command.actor, permission, element)`.
+// TODO(domain): replace `unknown` by the aggregate "{{name.words}}" reads, add `appliesTo: (subject): subject is <Aggregate> => subject instanceof <Aggregate>`, and decide from the actor, the loaded element and `now`; the handler asks it through `Access.authorize(command.actor, permission, <aggregate>)`, the loaded aggregate named after its concept (`invoice`, never `element`).
 export const {{name.camel}} = definePolicy<unknown>({
   name: '{{name.kebab}}',
   permission: {{context.camel}}Permissions['{{access.permission}}'],

package/templates/presets/identity/context/infrastructure/persistence/drizzle-search-members-reader.repository.drizzle.ts.tpl

@@ -22,7 +22,7 @@ export class DrizzleSearchMembersReader implements SearchMembersReader {
     const order = page.sort[0]?.direction === 'desc' ? desc : asc;
     const current = and(eq(members.organisationId, organisationId), isNull(members.removedAt));
 
-    const items = await executorOf(this.database)
+    const currentMembers = await executorOf(this.database)
       .select({
         memberId: members.id,
         accountId: members.accountId,
@@ -40,7 +40,7 @@ export class DrizzleSearchMembersReader implements SearchMembersReader {
 
     const [counted] = await executorOf(this.database).select({ total: count() }).from(members).where(current);
 
-    return pageOf(items, { total: counted?.total ?? 0 });
+    return pageOf(currentMembers, { total: counted?.total ?? 0 });
   }
 }
 

package/templates/presets/identity/context/presentation/http/organisations/search-members/search-members.controller.ts.tpl

@@ -81,6 +81,6 @@ export class SearchMembersController {
   }
 }
 
-function toLine(item: SearchMembersItem): SearchMembersLine {
-  return { ...item, joinedAt: item.joinedAt.toISOString() };
+function toLine(member: SearchMembersItem): SearchMembersLine {
+  return { ...member, joinedAt: member.joinedAt.toISOString() };
 }

package/templates/presets/identity/context/test/integration/search-members-reader.spec.ts.tpl

@@ -76,7 +76,7 @@ describe('{{#if orm.knex}}Knex{{/if}}{{#if orm.drizzle}}Drizzle{{/if}}SearchMemb
 
     const page = await reader.search('acme', offsetPage({ limit: 1, offset: 1, sort: [{ field: 'joinedAt', direction: 'desc' }] }));
 
-    expect(page.items.map((item) => item.memberId)).toEqual(['member-1']);
+    expect(page.items.map((member) => member.memberId)).toEqual(['member-1']);
     expect(page.total).toBe(2);
   });
 });

package/templates/query/search.reader.fake.ts.tpl

@@ -2,7 +2,7 @@ import type { {{name.pascal}}Item } from '{{alias.context}}/application/queries/
 import { InMemory{{name.pascal}}Reader } from '{{alias.context}}/infrastructure/persistence/{{reader.file}}{{alias.ext}}';
 
 export class Fake{{name.pascal}}Reader extends InMemory{{name.pascal}}Reader {
-  constructor(protected override readonly items: readonly {{name.pascal}}Item[]) {
+  constructor(protected override readonly {{search.elements}}: readonly {{name.pascal}}Item[]) {
     super();
   }
 }

package/templates/query/search.reader.in-memory.ts.tpl

@@ -17,38 +17,40 @@ import type {
 @Repository({{name.pascal}}Reader)
 {{/if}}
 export class InMemory{{name.pascal}}Reader implements {{name.pascal}}Reader {
-  protected readonly items: readonly {{name.pascal}}Item[] = [];
+  protected readonly {{search.elements}}: readonly {{name.pascal}}Item[] = [];
 
   async search(scope: AccessScope, page: PageRequest<{{name.pascal}}Sort>): Promise<{{name.pascal}}Result> {
     // TODO(domain): replace these canned lines by a real read of the projection; a production adapter (SQL view, search index) implements the same port next to this file, turns the scope into a condition of its statement, and orders by the sort field then by `id` in the same direction, so that a cursor resumes on a total order.
-    const visible = this.items.filter((item) => isVisible(item, scope)).sort(inOrder(page));
+    const visible = this.{{search.elements}}.filter(isVisibleTo(scope)).sort(inOrder(page));
     const start = page.kind === 'offset' ? page.offset : positionAfter(visible, page.cursor);
-    const items = visible.slice(start, start + page.limit);
+    const {{search.elements}} = visible.slice(start, start + page.limit);
 
     if (page.kind === 'offset') {
-      return pageOf(items, { total: visible.length });
+      return pageOf({{search.elements}}, { total: visible.length });
     }
 
-    const last = items.at(-1);
+    const last = {{search.elements}}.at(-1);
 
     return pageOf(
-      items,
+      {{search.elements}},
       last !== undefined && start + page.limit < visible.length ? { nextCursor: encodeCursor({ id: last.id }) } : {},
     );
   }
 }
 
-function isVisible(item: {{name.pascal}}Item, scope: AccessScope): boolean {
-  switch (scope.kind) {
-    case 'all':
-      return true;
-    case 'none':
-      return false;
-    case 'ids':
-      return scope.ids.includes(item.id);
-    case 'filter':
-      return Object.entries(scope.filter).every(([field, value]) => Reflect.get(item, field) === value);
-  }
+function isVisibleTo(scope: AccessScope): ({{search.element}}: {{name.pascal}}Item) => boolean {
+  return ({{search.element}}) => {
+    switch (scope.kind) {
+      case 'all':
+        return true;
+      case 'none':
+        return false;
+      case 'ids':
+        return scope.ids.includes({{search.element}}.id);
+      case 'filter':
+        return Object.entries(scope.filter).every(([field, value]) => Reflect.get({{search.element}}, field) === value);
+    }
+  };
 }
 
 function inOrder(page: PageRequest<{{name.pascal}}Sort>): (left: {{name.pascal}}Item, right: {{name.pascal}}Item) => number {
@@ -68,5 +70,5 @@ function positionAfter(visible: readonly {{name.pascal}}Item[], cursor: string |
     throw new InvalidPageRequestError('The cursor of a page is the nextCursor of a previous page');
   }
 
-  return visible.findIndex((item) => item.id === id) + 1;
+  return visible.findIndex(({{search.element}}) => {{search.element}}.id === id) + 1;
 }

package/templates/route/route.search.ts.tpl

@@ -84,7 +84,7 @@ export function {{name.camel}}Route(queries: QueryBus): Route {
       // TODO(domain): hand the criteria of the query over too, once the query schema declares them next to the page; map each line to its public fields.
       const page = await queries.execute(new {{route.input}}(actorOf(input.context.principal), input.query));
 
-      return { status: 200, body: pageResponse(page, (item) => ({ id: item.id })) };
+      return { status: 200, body: pageResponse(page, ({{search.element}}) => ({ id: {{search.element}}.id })) };
     },
   );
 }