ddd-ts-kit 0.1.1 → 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/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}}

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

@@ -1,4 +1,4 @@
-import type { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import type { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 
 export class {{event.pascal}}EventHandler {
   async handle(event: {{event.pascal}}): Promise<void> {

package/templates/event-handler/wiring.manual.tpl

@@ -1,6 +1,6 @@
 @@imports
-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}}';
 @@registrations
 const {{event.camel}}EventHandler = platform.adapter(new {{event.pascal}}EventHandler(), { kind: 'domain-event-handler', context: '{{context.kebab}}' });
 

package/templates/event-handler/wiring.tsyringe.tpl

@@ -1,7 +1,7 @@
 @@imports
 import { DomainEventDispatcher } 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}}';
 @@registrations
 builder.bind({{event.pascal}}EventHandler).toClass({{event.pascal}}EventHandler).as('domain-event-handler');
 @@start

package/templates/gateway/adapter.declared.ts.tpl

@@ -1,9 +1,9 @@
 import { Gateway } from '@ddd-ts-kit/kernel/declarations';
-import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
-import { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port.js';
+import type { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
+import { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port{{alias.ext}}';
 
 // TODO(platform): when {{upstream.kebab}} runs as its own service, turn this class into the remote adapter of {{name.pascal}}Gateway (an HTTP or RPC client with a timeout, retries and a fallback): the declaration stays, nothing else changes.
-@Gateway({{name.pascal}}Gateway, [{{name.pascal}}Contract])
+@Gateway({{name.pascal}}Gateway)
 export class InProcess{{name.pascal}}Gateway implements {{name.pascal}}Gateway {
   constructor(readonly upstream: {{name.pascal}}Contract) {}
 

package/templates/gateway/adapter.ts.tpl

@@ -1,5 +1,5 @@
-import type { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
-import type { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port.js';
+import type { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
+import type { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port{{alias.ext}}';
 
 // TODO(platform): when {{upstream.kebab}} runs as its own service, write the remote adapter of {{name.pascal}}Gateway next to this one (an HTTP or RPC client with a timeout, retries and a fallback) and bind it instead; nothing else changes.
 export class InProcess{{name.pascal}}Gateway implements {{name.pascal}}Gateway {

package/templates/gateway/contract.spec.ts.tpl

@@ -1,7 +1,7 @@
 import { describe, expect, it } from '{{tests.module}}';
-import type { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port.js';
-import { InProcess{{name.pascal}}Gateway } from '{{alias.context}}/infrastructure/external/in-process-{{name.kebab}}.gateway.js';
-import { Fake{{name.pascal}}Gateway } from '{{alias.context}}/test/fakes/{{name.kebab}}-gateway.fake.js';
+import type { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port{{alias.ext}}';
+import { InProcess{{name.pascal}}Gateway } from '{{alias.context}}/infrastructure/external/in-process-{{name.kebab}}.gateway{{alias.ext}}';
+import { Fake{{name.pascal}}Gateway } from '{{alias.context}}/test/fakes/{{name.kebab}}-gateway.fake{{alias.ext}}';
 
 const ADAPTERS: readonly (readonly [string, () => {{name.pascal}}Gateway])[] = [
   ['the fake', () => new Fake{{name.pascal}}Gateway()],

package/templates/gateway/fake.ts.tpl

@@ -1,4 +1,4 @@
-import type { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port.js';
+import type { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port{{alias.ext}}';
 
 export class Fake{{name.pascal}}Gateway implements {{name.pascal}}Gateway {
   // TODO(domain): implement each operation of {{name.pascal}}Gateway in memory, with what {{upstream.kebab}} would answer given by the test.

package/templates/gateway/platform-test.declared.tpl

@@ -1,4 +1,4 @@
 @@imports
-import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 @@test-bindings
 builder.bind({{name.pascal}}Contract).toValue({});

package/templates/gateway/platform.declared.tpl

@@ -1,4 +1,4 @@
 @@imports
-import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 @@bindings
 builder.bind({{name.pascal}}Contract).toValue({});

package/templates/gateway/wiring.tsyringe.tpl

@@ -1,7 +1,7 @@
 @@imports
-import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
-import { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port.js';
-import { InProcess{{name.pascal}}Gateway } from '{{alias.context}}/infrastructure/external/in-process-{{name.kebab}}.gateway.js';
+import { {{name.pascal}}Contract } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
+import { {{name.pascal}}Gateway } from '{{alias.context}}/application/ports/{{name.kebab}}-gateway.port{{alias.ext}}';
+import { InProcess{{name.pascal}}Gateway } from '{{alias.context}}/infrastructure/external/in-process-{{name.kebab}}.gateway{{alias.ext}}';
 @@registrations
 builder.bind({{name.pascal}}Contract).toValue({});
 builder.bind({{name.pascal}}Gateway).toClass(InProcess{{name.pascal}}Gateway, [{{name.pascal}}Contract]).as('gateway');

package/templates/init/CLAUDE.md.tpl

@@ -24,10 +24,13 @@ Loaded with the files they apply to, from `.claude/rules/`: `domain.md` (`domain
 
 Create every file of a role with `npx ddd-ts-kit generate <kind> ... --json`, then fill the `TODO(domain)` places it lists; never write one by hand, never restructure what a generator wrote.
 {{#if assembly.barrel}}
-Never edit `<context>.declarations.ts`: `generate` and `docs` rewrite it.
+Never edit `<context>.declarations.ts`: `generate`, `docs` and `npm run dev` rewrite it, from the role files and from the constructor signatures (it registers what each constructor is injected). After changing a constructor by hand, `npx ddd-ts-kit docs`.
+{{/if}}
+{{#if assembly.discovery}}
+Never edit `<context>.dependencies.ts`: `generate`, `docs` and `npm run dev` rewrite it from the constructor signatures (it registers what each constructor is injected). After changing a constructor by hand, `npx ddd-ts-kit docs`.
 {{/if}}
 Never edit `openapi/openapi.json`, `docs/integration/asyncapi.json`, `docs/integration/event-catalog.md`, `.dependency-cruiser.cjs` or the generated sections of a `CONTEXT.md`: change the code or the config, then `npm run docs:generate`, `npx ddd-ts-kit docs` and `npx ddd-ts-kit depcruise-config --write`.
-Imports: a file of the project is imported by its alias from the project root, never by a relative path, the same directory included: `{{alias.source}}/...` for `{{config.sourceRoot}}/`, `{{alias.test}}/...` for `test/`, `{{alias.scripts}}/...` for `scripts/`, always ending in `.js` (`imports/alias-only`; `npm run lint:fix` rewrites a relative import). The alias is declared once, under `paths` in `tsconfig.json`, from `importAlias` of `ddd-ts-kit.config.json`: never add a second entry or mapping, and never compile without `npm run build`, which rewrites the aliases of `dist/` into relative paths for Node (`imports/alias-declared`).
+Imports: a file of the project is imported by its alias from the project root, never by a relative path, the same directory included: `{{alias.source}}/...` for `{{config.sourceRoot}}/`, `{{alias.test}}/...` for `test/`, `{{alias.scripts}}/...` for `scripts/`, {{#if alias.extensionless}}never ending in `.js` or `.ts`, and naming a file, never a directory{{/if}}{{#unless alias.extensionless}}always ending in `.js`{{/unless}} (`imports/alias-only`, `imports/extension`; `npm run lint:fix` rewrites a relative import and a wrong ending). The alias is declared once, under `paths` in `tsconfig.json`, from `importAlias` of `ddd-ts-kit.config.json`, and the ending follows `importExtension`: never add a second entry or mapping, never change `module` or `moduleResolution` in `tsconfig.json`, and never compile without `npm run build`, which rewrites the aliases of `dist/` into relative paths ending in `.js` for Node (`imports/alias-declared`).
 Everywhere: one exported class, interface or function per file, named after it in kebab-case; at most 350 lines a file, 30 lines and 3 parameters a function; `private` members, never `#name`; a blank line before a `return` and around `if`, `for`, `try` (`npm run lint:fix`); braces around the body of every `if`, `else`, `for`, `while` and `do`, on its own lines: a branch is visible at a glance, and a statement added to it later cannot silently fall outside it. `npm run format` (Biome, line width 120) lays out every file: do not spend tokens on line breaks.
 
 ## TypeScript

package/templates/init/README.md.tpl

@@ -58,9 +58,10 @@ configuration, the storage, and `composeApplication` of `{{config.platformDir}}/
 
 - **A port is an abstract class, and the class is what is injected.** A repository port lives in
   `domain/repositories/`, any other port in `application/ports/`, one per file; an adapter
-  `implements` its port. There is no token constant and no token file anywhere: a dependency list
-  names port classes (`[InvoiceRepository, Clock]`), the ports of the kernel included (`Clock`,
-  `IdGenerator`, `CommandBus`, `UnitOfWork`... of `@ddd-ts-kit/kernel`).
+  `implements` its port. There is no token constant and no token file anywhere: a constructor
+  parameter typed by a port class names what is injected (`private readonly clock: Clock`), the
+  ports of the kernel included (`Clock`, `IdGenerator`, `CommandBus`, `UnitOfWork`... of
+  `@ddd-ts-kit/kernel`).
 {{#if di.tsyringe}}
 - **Three modules, then the contexts.** `kernelModule({...})` binds the ports of the kernel to what
   this platform chose (one execution scope, one clock, the two buses with their middlewares);
@@ -214,15 +215,19 @@ to it because ESLint and dependency-cruiser read sources through the compiler AP
 native version does not ship: do not use `npx tsc`, it would run version 6.
 
 Every file of the project is imported by an alias from the project root, never by a relative
-path: `{{alias.platform}}/config/load-config.js` for `{{config.platformDir}}/config/load-config.ts`,
-`{{alias.test}}/...` for `test/`, `{{alias.scripts}}/...` for `scripts/`. The alias is declared
+path: `{{alias.platform}}/config/load-config{{alias.ext}}` for `{{config.platformDir}}/config/load-config.ts`,
+`{{alias.test}}/...` for `test/`, `{{alias.scripts}}/...` for `scripts/`.{{#if alias.extensionless}} An import names its
+file without an extension (`"importExtension": "none"` in `ddd-ts-kit.config.json`), and never a
+directory: `.../published-language/index`.{{/if}}{{#unless alias.extensionless}} An import ends with the `.js` of the file the
+compiler emits (`"importExtension": "js"` in `ddd-ts-kit.config.json`).{{/unless}} The alias is declared
 once, under `paths` in `tsconfig.json`, which the compiler, `npm run dev`, the tests, knip and
-the import graph read. Node reads no alias: `npm run build` compiles, then
-`ddd-ts-kit build-aliases` rewrites each alias of `dist/` into a relative path, so `npm start`
-is plain `node`. `npm run lint:fix` turns a relative import into its alias, and
-`npm run check:arch` reports a declaration that no longer follows `importAlias` of
+the import graph read. Node reads no alias and needs the extension: `npm run build` compiles,
+then `ddd-ts-kit build-aliases` rewrites each alias of `dist/` into a relative path ending in
+`.js`, so `npm start` is plain `node`. `npm run lint:fix` turns a relative import into its alias
+and gives an import the ending the config asks for, and `npm run check:arch` reports a
+declaration that no longer follows `importAlias` and `importExtension` of
 `ddd-ts-kit.config.json`, or a build that skips the rewrite (`imports/alias-only`,
-`imports/alias-declared`).
+`imports/extension`, `imports/alias-declared`).
 
 | Gate | Script | Tool |
 |---|---|---|

package/templates/init/e2e/create-credentials.jwt.ts.tpl

@@ -2,7 +2,7 @@ import type { Authenticator } from '@ddd-ts-kit/auth';
 import { JwtAuthenticator } from '@ddd-ts-kit/auth/jwt';
 import type { HttpHeaders } from '@ddd-ts-kit/testing/e2e';
 import { SignJWT, generateKeyPair, type CryptoKey } from 'jose';
-import { authEnvironment } from '{{alias.test}}/e2e/support/auth-environment.js';
+import { authEnvironment } from '{{alias.test}}/e2e/support/auth-environment{{alias.ext}}';
 
 const issuer = authEnvironment.AUTH_ISSUER;
 const audience = authEnvironment.AUTH_AUDIENCE;

package/templates/init/e2e/create-credentials.keycloak.ts.tpl

@@ -4,7 +4,7 @@ import type { Authenticator } from '@ddd-ts-kit/auth';
 import { keycloakAuthenticator } from '@ddd-ts-kit/auth/jwt';
 import type { HttpHeaders } from '@ddd-ts-kit/testing/e2e';
 import { SignJWT, exportJWK, generateKeyPair, type CryptoKey, type JWK } from 'jose';
-import { authEnvironment } from '{{alias.test}}/e2e/support/auth-environment.js';
+import { authEnvironment } from '{{alias.test}}/e2e/support/auth-environment{{alias.ext}}';
 
 const realm = authEnvironment.KEYCLOAK_REALM;
 const audience = authEnvironment.KEYCLOAK_AUDIENCE;

package/templates/init/e2e/create-credentials.none.ts.tpl

@@ -1,7 +1,7 @@
 import type { Authenticator } from '@ddd-ts-kit/auth';
 import type { HttpHeaders } from '@ddd-ts-kit/testing/e2e';
-import { developmentActorHeader } from '{{alias.platform}}/auth/development-actor-header.js';
-import { DevelopmentHeaderAuthenticator } from '{{alias.platform}}/auth/development-header-authenticator.js';
+import { developmentActorHeader } from '{{alias.platform}}/auth/development-actor-header{{alias.ext}}';
+import { DevelopmentHeaderAuthenticator } from '{{alias.platform}}/auth/development-header-authenticator{{alias.ext}}';
 
 /** Who a test calls as: the identity, the roles and the tenant the development header carries. */
 export interface TestActor {

package/templates/init/e2e/start-application.database.ts.tpl

@@ -4,39 +4,39 @@ import type { RelationTuple } from '@ddd-ts-kit/auth/rebac';
 import type { IntegrationEventSubscriber } from '@ddd-ts-kit/kernel';
 import { createHttpClient, type HttpClient } from '@ddd-ts-kit/testing/e2e';
 {{#if authz.rebac}}
-import { relationTuples } from '{{alias.platform}}/auth/relation-tuples.js';
+import { relationTuples } from '{{alias.platform}}/auth/relation-tuples{{alias.ext}}';
 {{/if}}
-import { composeApplication } from '{{alias.platform}}/compose-application.js';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import { loadConfig } from '{{alias.platform}}/config/load-config.js';
-import { openTestDatabase, type TestDatabase } from '{{alias.platform}}/database/open-test-database.js';
+import { composeApplication } from '{{alias.platform}}/compose-application{{alias.ext}}';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import { loadConfig } from '{{alias.platform}}/config/load-config{{alias.ext}}';
+import { openTestDatabase, type TestDatabase } from '{{alias.platform}}/database/open-test-database{{alias.ext}}';
 {{#if broker.provided}}
-import { createEventProvider } from '{{alias.platform}}/events/create-event-provider.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import { createEventProvider } from '{{alias.platform}}/events/create-event-provider{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 {{/if}}
-import { inProcessEvents } from '{{alias.platform}}/events/in-process-events.js';
+import { inProcessEvents } from '{{alias.platform}}/events/in-process-events{{alias.ext}}';
 {{#if events.outbox}}
-import { startOutboxRelay } from '{{alias.platform}}/events/start-outbox-relay.js';
+import { startOutboxRelay } from '{{alias.platform}}/events/start-outbox-relay{{alias.ext}}';
 {{/if}}
-import { startHttpServer } from '{{alias.platform}}/http/start-http-server.js';
+import { startHttpServer } from '{{alias.platform}}/http/start-http-server{{alias.ext}}';
 {{#if cache.redis}}
-import { openRedis } from '{{alias.platform}}/redis/open-redis.js';
+import { openRedis } from '{{alias.platform}}/redis/open-redis{{alias.ext}}';
 {{/if}}
-import { createCredentials, type Credentials, type TestActor } from '{{alias.test}}/e2e/support/create-credentials.js';
+import { createCredentials, type Credentials, type TestActor } from '{{alias.test}}/e2e/support/create-credentials{{alias.ext}}';
 {{#if broker.addressed}}
 {{#if redis.server}}
-import { noBroker, noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { noBroker, noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/if}}
 {{#unless redis.server}}
-import { noBroker, testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { noBroker, testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/unless}}
 {{/if}}
 {{#unless broker.addressed}}
 {{#if redis.server}}
-import { noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/if}}
 {{#unless redis.server}}
-import { testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/unless}}
 {{/unless}}
 

package/templates/init/e2e/start-application.memory.ts.tpl

@@ -4,41 +4,41 @@ import type { RelationTuple } from '@ddd-ts-kit/auth/rebac';
 import type { IntegrationEventSubscriber } from '@ddd-ts-kit/kernel';
 import { createHttpClient, type HttpClient } from '@ddd-ts-kit/testing/e2e';
 {{#if authz.rebac}}
-import { relationTuples } from '{{alias.platform}}/auth/relation-tuples.js';
+import { relationTuples } from '{{alias.platform}}/auth/relation-tuples{{alias.ext}}';
 {{/if}}
-import { composeApplication } from '{{alias.platform}}/compose-application.js';
+import { composeApplication } from '{{alias.platform}}/compose-application{{alias.ext}}';
 {{#if broker.provided}}
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
 {{/if}}
-import { loadConfig } from '{{alias.platform}}/config/load-config.js';
-import { openPersistence } from '{{alias.platform}}/database/open-persistence.js';
+import { loadConfig } from '{{alias.platform}}/config/load-config{{alias.ext}}';
+import { openPersistence } from '{{alias.platform}}/database/open-persistence{{alias.ext}}';
 {{#if broker.provided}}
-import { createEventProvider } from '{{alias.platform}}/events/create-event-provider.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import { createEventProvider } from '{{alias.platform}}/events/create-event-provider{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 {{/if}}
-import { inProcessEvents } from '{{alias.platform}}/events/in-process-events.js';
+import { inProcessEvents } from '{{alias.platform}}/events/in-process-events{{alias.ext}}';
 {{#if events.outbox}}
-import { startOutboxRelay } from '{{alias.platform}}/events/start-outbox-relay.js';
+import { startOutboxRelay } from '{{alias.platform}}/events/start-outbox-relay{{alias.ext}}';
 {{/if}}
-import { startHttpServer } from '{{alias.platform}}/http/start-http-server.js';
+import { startHttpServer } from '{{alias.platform}}/http/start-http-server{{alias.ext}}';
 {{#if cache.redis}}
-import { openRedis } from '{{alias.platform}}/redis/open-redis.js';
+import { openRedis } from '{{alias.platform}}/redis/open-redis{{alias.ext}}';
 {{/if}}
-import { createCredentials, type Credentials, type TestActor } from '{{alias.test}}/e2e/support/create-credentials.js';
+import { createCredentials, type Credentials, type TestActor } from '{{alias.test}}/e2e/support/create-credentials{{alias.ext}}';
 {{#if broker.addressed}}
 {{#if redis.server}}
-import { noBroker, noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { noBroker, noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/if}}
 {{#unless redis.server}}
-import { noBroker, testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { noBroker, testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/unless}}
 {{/if}}
 {{#unless broker.addressed}}
 {{#if redis.server}}
-import { noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { noRedis, testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/if}}
 {{#unless redis.server}}
-import { testEnvironment } from '{{alias.test}}/e2e/support/test-environment.js';
+import { testEnvironment } from '{{alias.test}}/e2e/support/test-environment{{alias.ext}}';
 {{/unless}}
 {{/unless}}