ddd-ts-kit 0.1.0 → 0.2.0

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

@@ -1,11 +1,11 @@
 {{#if command.hasAggregate}}
-import { Clock, IdGenerator } from '@ddd-ts-kit/kernel';
+import type { Clock, IdGenerator } from '@ddd-ts-kit/kernel';
 import { CommandHandler } from '@ddd-ts-kit/kernel/declarations';
-import { {{aggregate.pascal}} } from '{{alias.context}}/domain/aggregates/{{aggregate.kebab}}.aggregate.js';
-import { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository.js';
-import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
+import { {{aggregate.pascal}} } from '{{alias.context}}/domain/aggregates/{{aggregate.kebab}}.aggregate{{alias.ext}}';
+import type { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
+import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
-@CommandHandler({{name.pascal}}Command, [{{aggregate.pascal}}Repository, IdGenerator, Clock])
+@CommandHandler({{name.pascal}}Command)
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
   constructor(
     private readonly {{aggregate.camel}}Repository: {{aggregate.pascal}}Repository,
@@ -25,12 +25,12 @@ export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Com
 {{/if}}
 {{#unless command.hasAggregate}}
 import { CommandHandler } from '@ddd-ts-kit/kernel/declarations';
-import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
+import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 @CommandHandler({{name.pascal}}Command)
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
   async execute(command: {{name.pascal}}Command): Promise<void> {
-    // TODO(domain): name the repository of the aggregate "{{name.words}}" acts on in the dependency list and receive it in the constructor (rerun with --aggregate <Name> --force to get it declared), load or create the aggregate from `command`, call its intention method and save it (its events leave with the save); the unit of work is opened by the command bus.
+    // TODO(domain): receive the repository of the aggregate "{{name.words}}" acts on in the constructor, typed by its port (rerun with --aggregate <Name> --force to get it declared), load or create the aggregate from `command`, call its intention method and save it (its events leave with the save); the unit of work is opened by the command bus.
   }
 }
 {{/unless}}

package/templates/command/handler.spec.buses.ts.tpl

@@ -5,12 +5,12 @@ import { anActor } from '@ddd-ts-kit/auth/testing';
 {{/if}}
 import { createTestBuses } from '@ddd-ts-kit/testing';
 {{#if access.protected}}
-import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions.js';
+import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions{{alias.ext}}';
 {{/if}}
-import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
-import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler.js';
+import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
+import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler{{alias.ext}}';
 {{#if command.hasAggregate}}
-import { Fake{{aggregate.pascal}}Repository } from '{{alias.context}}/test/fakes/{{aggregate.kebab}}.repository.fake.js';
+import { Fake{{aggregate.pascal}}Repository } from '{{alias.context}}/test/fakes/{{aggregate.kebab}}.repository.fake{{alias.ext}}';
 {{/if}}
 {{#if access.protected}}
 

package/templates/command/handler.spec.tsyringe.ts.tpl

@@ -11,14 +11,14 @@ import { anActor } from '@ddd-ts-kit/auth/testing';
 {{spec.diPlain}}
 {{/unless}}
 {{spec.contextImports}}
-import { platformTestModule } from '{{alias.platform}}/platform-test.module.js';
+import { platformTestModule } from '{{alias.platform}}/platform-test.module{{alias.ext}}';
 {{#if access.protected}}
-import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions.js';
+import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions{{alias.ext}}';
 {{/if}}
-import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
+import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 {{#if command.hasAggregate}}
-import { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository.js';
-import { Fake{{aggregate.pascal}}Repository } from '{{alias.context}}/test/fakes/{{aggregate.kebab}}.repository.fake.js';
+import { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
+import { Fake{{aggregate.pascal}}Repository } from '{{alias.context}}/test/fakes/{{aggregate.kebab}}.repository.fake{{alias.ext}}';
 {{/if}}
 {{#if access.protected}}
 

package/templates/command/handler.ts.tpl

@@ -1,8 +1,8 @@
 {{#if command.hasAggregate}}
 import type { Clock, CommandHandler, IdGenerator } from '@ddd-ts-kit/kernel';
-import { {{aggregate.pascal}} } from '{{alias.context}}/domain/aggregates/{{aggregate.kebab}}.aggregate.js';
-import type { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository.js';
-import type { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
+import { {{aggregate.pascal}} } from '{{alias.context}}/domain/aggregates/{{aggregate.kebab}}.aggregate{{alias.ext}}';
+import type { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
+import type { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
   constructor(
@@ -23,7 +23,7 @@ export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Com
 {{/if}}
 {{#unless command.hasAggregate}}
 import type { CommandHandler } from '@ddd-ts-kit/kernel';
-import type { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
+import type { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
 
 export class {{name.pascal}}Handler implements CommandHandler<{{name.pascal}}Command> {
   async execute(command: {{name.pascal}}Command): Promise<void> {

package/templates/command/wiring.manual.tpl

@@ -1,8 +1,8 @@
 @@imports
 {{access.manualImport}}
 {{access.permissionsImport}}
-import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
-import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler.js';
+import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
+import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler{{alias.ext}}';
 @@registrations
 {{#if command.hasAggregate}}
 platform.commands.register({{name.pascal}}Command, new {{name.pascal}}Handler({{aggregate.camel}}Repository, platform.ids, platform.clock), { context: '{{context.kebab}}' });

package/templates/command/wiring.tsyringe.tpl

@@ -1,11 +1,11 @@
 @@imports
 {{#if command.hasAggregate}}
 import { Clock, IdGenerator } from '@ddd-ts-kit/kernel';
-import { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository.js';
+import { {{aggregate.pascal}}Repository } from '{{alias.context}}/domain/repositories/{{aggregate.kebab}}.repository{{alias.ext}}';
 {{/if}}
 {{access.permissionsImport}}
-import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command.js';
-import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler.js';
+import { {{name.pascal}}Command } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.command{{alias.ext}}';
+import { {{name.pascal}}Handler } from '{{alias.context}}/application/commands/{{name.kebab}}/{{name.kebab}}.handler{{alias.ext}}';
 @@registrations
 {{#if command.hasAggregate}}
 builder.command({{name.pascal}}Command){{access.declaration}}.handledBy({{name.pascal}}Handler, [{{aggregate.pascal}}Repository, IdGenerator, Clock]);

package/templates/context/module.manual.ts.tpl

@@ -2,7 +2,7 @@ import type { UseCaseDeclaration } from '@ddd-ts-kit/auth';
 {{#if http.any}}
 import type { Route } from '@ddd-ts-kit/http';
 {{/if}}
-import type { Platform } from '{{alias.platform}}/platform.js';
+import type { Platform } from '{{alias.platform}}/platform{{alias.ext}}';
 // ddd-ts-kit:imports
 // /ddd-ts-kit:imports
 

package/templates/context/permission-set.tpl

@@ -1,4 +1,4 @@
 @@imports
-import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions.js';
+import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions{{alias.ext}}';
 @@permission-sets
 {{context.camel}}Permissions,

package/templates/context/permissions.spec.ts.tpl

@@ -1,6 +1,6 @@
 import { describe, expect, it } from '{{tests.module}}';
 import type { Permission } from '@ddd-ts-kit/auth';
-import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions.js';
+import { {{context.camel}}Permissions } from '{{alias.context}}/application/authorization/{{context.kebab}}.permissions{{alias.ext}}';
 
 describe('The permissions of {{context.kebab}}', () => {
   it('belong to {{context.kebab}}, each under an identifier of its own and with a description', () => {

package/templates/context/routes.spec.ts.tpl

@@ -1,6 +1,6 @@
 import { describe, expect, it } from '{{tests.module}}';
 import { InMemoryCommandBus, InMemoryQueryBus } from '@ddd-ts-kit/kernel';
-import { {{context.camel}}Routes } from '{{alias.context}}/presentation/http/{{context.kebab}}.routes.js';
+import { {{context.camel}}Routes } from '{{alias.context}}/presentation/http/{{context.kebab}}.routes{{alias.ext}}';
 
 describe('The routes of {{context.kebab}}', () => {
   it('answer each method and path once, each under an operation of its own', () => {

package/templates/context/wiring.declared.tpl

@@ -1,9 +1,9 @@
 @@imports
 {{#if assembly.barrel}}
-import * as {{context.camel}}Declarations from '{{alias.context}}/{{context.kebab}}.declarations.js';
+import * as {{context.camel}}Declarations from '{{alias.context}}/{{context.kebab}}.declarations{{alias.ext}}';
 {{/if}}
 {{#if http.any}}
-import { {{context.camel}}Routes } from '{{alias.context}}/presentation/http/{{context.kebab}}.routes.js';
+import { {{context.camel}}Routes } from '{{alias.context}}/presentation/http/{{context.kebab}}.routes{{alias.ext}}';
 {{/if}}
 @@contexts
 {{assembled.module}},

package/templates/context/wiring.manual.tpl

@@ -1,4 +1,4 @@
 @@imports
-import { {{context.camel}}Module } from '{{alias.context}}/{{context.kebab}}.module.js';
+import { {{context.camel}}Module } from '{{alias.context}}/{{context.kebab}}.module{{alias.ext}}';
 @@contexts
 {{context.camel}}Module,

package/templates/context/wiring.tsyringe.tpl

@@ -1,7 +1,7 @@
 @@imports
-import { {{context.camel}}Module } from '{{alias.context}}/{{context.kebab}}.module.js';
+import { {{context.camel}}Module } from '{{alias.context}}/{{context.kebab}}.module{{alias.ext}}';
 {{#if http.any}}
-import { {{context.camel}}Routes } from '{{alias.context}}/presentation/http/{{context.kebab}}.routes.js';
+import { {{context.camel}}Routes } from '{{alias.context}}/presentation/http/{{context.kebab}}.routes{{alias.ext}}';
 {{/if}}
 @@contexts
 {{context.camel}}Module,

package/templates/docs/asyncapi.json.tpl

@@ -0,0 +1,12 @@
+{
+  "asyncapi": "3.0.0",
+  "info": {
+    "title": {{document.title}},
+    "version": {{document.version}}
+  },
+  "channels": {},
+  "operations": {},
+  "components": {
+    "messages": {}
+  }
+}

package/templates/docs/event-catalog.md

@@ -0,0 +1,3 @@
+# Event catalog
+
+Generated from the integration event declarations. Do not edit by hand: regenerate.

package/templates/docs/openapi.json.tpl

@@ -0,0 +1,354 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": {{document.title}},
+    "version": {{document.version}}
+  },
+{{#if audit.route}}
+  "tags": [
+    {
+      "name": "audit"
+    }
+  ],
+  "paths": {
+    "/audit/entries": {
+      "get": {
+        "operationId": "searchAuditEntries",
+        "summary": "Search the entries of the audit trail",
+        "tags": [
+          "audit"
+        ],
+        "security": [
+          {
+            "{{authn.scheme}}": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "Size of the page.",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 20,
+              "description": "Size of the page."
+            }
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "description": "Items to skip. Not with `cursor`.",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Items to skip. Not with `cursor`."
+            }
+          },
+          {
+            "name": "cursor",
+            "in": "query",
+            "description": "The `nextCursor` of the previous page. Not with `offset`.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "description": "The `nextCursor` of the previous page. Not with `offset`."
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "description": "Comma-separated fields, a leading \"-\" for descending. Sortable: occurredAt, sequence.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "description": "Comma-separated fields, a leading \"-\" for descending. Sortable: occurredAt, sequence."
+            }
+          },
+          {
+            "name": "actorId",
+            "in": "query",
+            "description": "Entries about what this actor did.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "description": "Entries about what this actor did."
+            }
+          },
+          {
+            "name": "action",
+            "in": "query",
+            "description": "A permission id, a command name or an event type.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "description": "A permission id, a command name or an event type."
+            }
+          },
+          {
+            "name": "outcome",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "allowed",
+                "denied",
+                "succeeded",
+                "failed"
+              ]
+            }
+          },
+          {
+            "name": "correlationId",
+            "in": "query",
+            "description": "Everything one request or event caused.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "description": "Everything one request or event caused."
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A page of entries.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "items"
+                  ],
+                  "properties": {
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "chain",
+                          "sequence",
+                          "occurredAt",
+                          "category",
+                          "action",
+                          "outcome",
+                          "actorId",
+                          "actorType",
+                          "correlationId",
+                          "origin",
+                          "previousHash",
+                          "hash"
+                        ],
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "chain": {
+                            "type": "string"
+                          },
+                          "sequence": {
+                            "type": "integer",
+                            "minimum": 1
+                          },
+                          "occurredAt": {
+                            "type": "string",
+                            "format": "date-time"
+                          },
+                          "category": {
+                            "type": "string"
+                          },
+                          "action": {
+                            "type": "string"
+                          },
+                          "outcome": {
+                            "type": "string",
+                            "enum": [
+                              "allowed",
+                              "denied",
+                              "succeeded",
+                              "failed"
+                            ]
+                          },
+                          "reason": {
+                            "type": "string"
+                          },
+                          "actorId": {
+                            "type": "string"
+                          },
+                          "actorType": {
+                            "type": "string"
+                          },
+                          "tenantId": {
+                            "type": "string"
+                          },
+                          "resourceType": {
+                            "type": "string"
+                          },
+                          "resourceId": {
+                            "type": "string"
+                          },
+                          "context": {
+                            "type": "string"
+                          },
+                          "correlationId": {
+                            "type": "string"
+                          },
+                          "causationId": {
+                            "type": "string"
+                          },
+                          "origin": {
+                            "type": "string"
+                          },
+                          "previousHash": {
+                            "type": "string"
+                          },
+                          "hash": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    },
+                    "total": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Present when it is cheap to count."
+                    },
+                    "nextCursor": {
+                      "type": "string",
+                      "description": "Present when more items follow."
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized. Error codes: UNAUTHORIZED.",
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Problem"
+                }
+              }
+            },
+            "x-error-codes": [
+              "UNAUTHORIZED"
+            ]
+          },
+          "403": {
+            "description": "Forbidden. Error codes: FORBIDDEN.",
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Problem"
+                }
+              }
+            },
+            "x-error-codes": [
+              "FORBIDDEN"
+            ]
+          },
+          "422": {
+            "description": "Unprocessable Content. Error codes: VALIDATION_FAILED.",
+            "content": {
+              "application/problem+json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Problem"
+                }
+              }
+            },
+            "x-error-codes": [
+              "VALIDATION_FAILED"
+            ]
+          }
+        }
+      }
+    }
+  },
+{{/if}}
+{{#unless audit.route}}
+  "paths": {},
+{{/unless}}
+  "components": {
+    "schemas": {
+      "Problem": {
+        "type": "object",
+        "description": "Problem details (RFC 9457) with a stable machine-readable code.",
+        "required": [
+          "type",
+          "title",
+          "status",
+          "code",
+          "requestId"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "URI identifying the kind of problem."
+          },
+          "title": {
+            "type": "string"
+          },
+          "status": {
+            "type": "integer"
+          },
+          "code": {
+            "type": "string",
+            "description": "Stable error code; branch on this, not on the title."
+          },
+          "detail": {
+            "type": "string"
+          },
+          "issues": {
+            "type": "array",
+            "description": "Present when the request failed validation.",
+            "items": {
+              "type": "object",
+              "required": [
+                "path",
+                "code",
+                "message"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "description": "Dotted path, for example body.items.0.sku."
+                },
+                "code": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "requestId": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+{{#if authn.tokens}}
+      "bearer": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "JWT"
+      }
+{{/if}}
+{{#unless authn.tokens}}
+      "developmentActor": {
+        "type": "apiKey",
+        "in": "header",
+        "name": "x-development-actor"
+      }
+{{/unless}}
+    }
+  }
+}

package/templates/domain-error/domain-error.spec.ts.tpl

@@ -1,6 +1,6 @@
 import { describe, expect, it } from '{{tests.module}}';
 import { DomainError } from '@ddd-ts-kit/kernel';
-import { {{name.pascal}}Error } from '{{alias.context}}/domain/errors/{{name.kebab}}.error.js';
+import { {{name.pascal}}Error } from '{{alias.context}}/domain/errors/{{name.kebab}}.error{{alias.ext}}';
 
 describe('{{name.pascal}}Error', () => {
   it('carries its stable code', () => {

package/templates/domain-event/domain-event.spec.ts.tpl

@@ -1,5 +1,5 @@
 import { describe, expect, it } from '{{tests.module}}';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 
 describe('{{event.pascal}}', () => {
   it('is named after the context, the aggregate and the fact', () => {

package/templates/domain-service/domain-service.spec.ts.tpl

@@ -1,5 +1,5 @@
 import { describe, expect, it } from '{{tests.module}}';
-import { {{name.pascal}}Service } from '{{alias.context}}/domain/services/{{name.kebab}}.service.js';
+import { {{name.pascal}}Service } from '{{alias.context}}/domain/services/{{name.kebab}}.service{{alias.ext}}';
 
 describe('{{name.pascal}}Service', () => {
   it('holds no state of its own', () => {

package/templates/e2e/e2e.spec.ts.tpl

@@ -11,9 +11,9 @@ import { reportSeedOnFailure } from '@ddd-ts-kit/testing/faker';
 {{#if e2e.traced}}
 import { expectSpanTree, installTestTracing } from '@ddd-ts-kit/tracing/testing';
 {{/if}}
-import { startApplication, type RunningApplication } from '{{alias.test}}/e2e/support/start-application.js';
+import { startApplication, type RunningApplication } from '{{alias.test}}/e2e/support/start-application{{alias.ext}}';
 {{#if e2e.traced}}
-import { storyOf } from '{{alias.test}}/e2e/support/story-of.js';
+import { storyOf } from '{{alias.test}}/e2e/support/story-of{{alias.ext}}';
 {{/if}}
 
 describe('{{name.title}}, end to end', () => {

package/templates/entity/entity.spec.ts.tpl

@@ -1,5 +1,5 @@
 import { describe, expect, it } from '{{tests.module}}';
-import { {{name.pascal}} } from '{{alias.context}}/domain/entities/{{name.kebab}}.entity.js';
+import { {{name.pascal}} } from '{{alias.context}}/domain/entities/{{name.kebab}}.entity{{alias.ext}}';
 
 describe('{{name.pascal}}', () => {
   it('is identified by its id, not by its attributes', () => {

package/templates/event-handler/event-handler.declared.ts.tpl

@@ -1,14 +1,14 @@
 import { DomainEventHandler } from '@ddd-ts-kit/kernel/declarations';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 
 @DomainEventHandler({{event.pascal}}, { name: '{{event.name}}'{{#if handler.afterCommit}}, phase: 'after-commit'{{/if}} })
 export class {{event.pascal}}EventHandler implements DomainEventHandler<{{event.pascal}}> {
   async handle(event: {{event.pascal}}): Promise<void> {
 {{#unless handler.afterCommit}}
-    // TODO(domain): state the policy "when {{event.words}}, then ..." and carry it out by executing a command of this context (name `CommandBus` of the kernel in the dependency list and receive it in the constructor). It runs at the end of the unit of work, before the commit: depend only on what the transaction covers; an effect outside the database belongs in the after-commit phase or, when it must not be lost, behind an integration event, where a reaction in another context goes too.
+    // TODO(domain): state the policy "when {{event.words}}, then ..." and carry it out by executing a command of this context (receive `CommandBus` of the kernel in the constructor). It runs at the end of the unit of work, before the commit: depend only on what the transaction covers; an effect outside the database belongs in the after-commit phase or, when it must not be lost, behind an integration event, where a reaction in another context goes too.
 {{/unless}}
 {{#if handler.afterCommit}}
-    // TODO(domain): state the effect "once {{event.words}} is committed, then ..." and carry it out through its port (name the port in the dependency list and receive it in the constructor). It runs after the commit, at most once: a failure is reported and never fails the command, and a crash loses it, so what must not be lost goes through an integration event instead. It never saves an aggregate: a state change is a command sent through `CommandBus`.
+    // TODO(domain): state the effect "once {{event.words}} is committed, then ..." and carry it out through its port (receive the port in the constructor). It runs after the commit, at most once: a failure is reported and never fails the command, and a crash loses it, so what must not be lost goes through an integration event instead. It never saves an aggregate: a state change is a command sent through `CommandBus`.
 {{/if}}
   }
 }

package/templates/event-handler/event-handler.spec.ts.tpl

@@ -5,8 +5,8 @@ import {
   announceDomainEvents,
   unitOfWorkStage,
 } from '@ddd-ts-kit/kernel';
-import { {{event.pascal}}EventHandler } from '{{alias.context}}/application/event-handlers/{{event.kebab}}.event-handler.js';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import { {{event.pascal}}EventHandler } from '{{alias.context}}/application/event-handlers/{{event.kebab}}.event-handler{{alias.ext}}';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 
 describe('When {{event.words}}', () => {
 {{#unless handler.afterCommit}}