ddd-ts-kit 0.1.0 → 0.2.0

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

@@ -7,6 +7,7 @@ The rules are in `CLAUDE.md` and `.claude/rules/`; `npx ddd-ts-kit explain <rule
 
 ```bash
 npm install
+npm run verify          # every gate of the pipeline: green before the first line of business code
 cp .env.example .env
 {{#if database.server}}
 npm run infra:up        # the database, in Docker; add --profile observability for Jaeger
@@ -57,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);
@@ -213,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/docker/Dockerfile.tpl

@@ -2,14 +2,21 @@
 
 FROM node:24-slim AS build
 WORKDIR /app
-COPY package.json package-lock.json ./
+{{#if pm.corepack}}
+# corepack provides the release of the package manager that package.json pins.
+RUN corepack enable
+{{/if}}
+COPY package.json package-lock.json{{#if pm.pnpm}} pnpm-workspace.yaml{{/if}} ./
 RUN npm ci
 COPY . .
 RUN npm run build
 
 FROM node:24-slim AS dependencies
 WORKDIR /app
-COPY package.json package-lock.json ./
+{{#if pm.corepack}}
+RUN corepack enable
+{{/if}}
+COPY package.json package-lock.json{{#if pm.pnpm}} pnpm-workspace.yaml{{/if}} ./
 RUN npm ci --omit=dev
 
 FROM node:24-slim

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}}
 

package/templates/init/e2e/test-environment.ts.tpl

@@ -1,4 +1,4 @@
-import { authEnvironment } from '{{alias.test}}/e2e/support/auth-environment.js';
+import { authEnvironment } from '{{alias.test}}/e2e/support/auth-environment{{alias.ext}}';
 {{#if broker.addressed}}
 
 /** Without {{broker.variable}} (`npm run infra:up` gives one) the events stay in the process: the same ports, no broker. */

package/templates/init/jest.config.js.tpl

@@ -1,4 +1,4 @@
-import { governedJestCoverage } from '@ddd-ts-kit/testing/coverage';
+import { governedJestCoverage, unaffectedContexts } from '@ddd-ts-kit/testing/coverage';
 
 export default {
   testEnvironment: 'node',
@@ -7,6 +7,8 @@ export default {
     {{alias.jestMapper}}
   },
   testMatch: ['<rootDir>/{{config.sourceRoot}}/**/*.spec.ts', '<rootDir>/test/architecture/**/*.spec.ts'],
+  // A pull request names the contexts its change reaches (DDD_TS_KIT_AFFECTED, from `ddd-ts-kit affected`): the specs of the others are left to the default branch.
+  testPathIgnorePatterns: ['/node_modules/', ...unaffectedContexts().map((directory) => `/${directory}`)],
   extensionsToTreatAsEsm: ['.ts'],
   transform: {
     '^.+\\.ts$': [

package/templates/init/main.ts.tpl

@@ -1,25 +1,25 @@
 // Imported first on purpose: instrumentation has to be installed before any module it patches is loaded.
-import { tracing } from '{{alias.platform}}/tracing.js';
+import { tracing } from '{{alias.platform}}/tracing{{alias.ext}}';
 {{#if errors.sentry}}
 // Imported second on purpose: a failure while the rest of the application loads is already reported.
-import { errors } from '{{alias.platform}}/errors.js';
+import { errors } from '{{alias.platform}}/errors{{alias.ext}}';
 {{/if}}
 {{#if http.any}}
-import { createAuthenticator } from '{{alias.platform}}/auth/create-authenticator.js';
+import { createAuthenticator } from '{{alias.platform}}/auth/create-authenticator{{alias.ext}}';
 {{/if}}
-import { composeApplication } from '{{alias.platform}}/compose-application.js';
-import { loadConfig } from '{{alias.platform}}/config/load-config.js';
-import { openPersistence } from '{{alias.platform}}/database/open-persistence.js';
-import { {{events.providerName}} } from '{{alias.platform}}/events/{{events.providerFile}}.js';
+import { composeApplication } from '{{alias.platform}}/compose-application{{alias.ext}}';
+import { loadConfig } from '{{alias.platform}}/config/load-config{{alias.ext}}';
+import { openPersistence } from '{{alias.platform}}/database/open-persistence{{alias.ext}}';
+import { {{events.providerName}} } from '{{alias.platform}}/events/{{events.providerFile}}{{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}}
 {{#if http.any}}
-import { startHttpServer } from '{{alias.platform}}/http/start-http-server.js';
+import { startHttpServer } from '{{alias.platform}}/http/start-http-server{{alias.ext}}';
 {{/if}}
-import { jobSettings } from '{{alias.platform}}/job-settings.js';
+import { jobSettings } from '{{alias.platform}}/job-settings{{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}}
 
 const config = loadConfig(process.env);

package/templates/init/platform/audit/audit.module.manual.ts.tpl

@@ -1,10 +1,10 @@
 import { requires, type UseCaseDeclaration } from '@ddd-ts-kit/auth';
 import type { Route } from '@ddd-ts-kit/http';
-import type { Platform } from '{{alias.platform}}/platform.js';
-import { auditPermissions } from '{{alias.platform}}/audit/audit.permissions.js';
-import { SearchAuditEntriesHandler } from '{{alias.platform}}/audit/search-audit-entries.handler.js';
-import { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query.js';
-import { searchAuditEntriesRoute } from '{{alias.platform}}/audit/search-audit-entries.route.js';
+import type { Platform } from '{{alias.platform}}/platform{{alias.ext}}';
+import { auditPermissions } from '{{alias.platform}}/audit/audit.permissions{{alias.ext}}';
+import { SearchAuditEntriesHandler } from '{{alias.platform}}/audit/search-audit-entries.handler{{alias.ext}}';
+import { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query{{alias.ext}}';
+import { searchAuditEntriesRoute } from '{{alias.platform}}/audit/search-audit-entries.route{{alias.ext}}';
 
 interface AuditWiring {
   readonly name: string;

package/templates/init/platform/audit/audit.module.tsyringe.ts.tpl

@@ -3,12 +3,12 @@ import { defineContextModule, type ContextModule } from '@ddd-ts-kit/di';
 import { subscribeAll } from '@ddd-ts-kit/events';
 import { EventSubscribers } from '@ddd-ts-kit/kernel';
 {{#if audit.route}}
-import { auditPermissions } from '{{alias.platform}}/audit/audit.permissions.js';
+import { auditPermissions } from '{{alias.platform}}/audit/audit.permissions{{alias.ext}}';
 {{/if}}
-import type { Audit } from '{{alias.platform}}/audit/create-audit.js';
+import type { Audit } from '{{alias.platform}}/audit/create-audit{{alias.ext}}';
 {{#if audit.route}}
-import { SearchAuditEntriesHandler } from '{{alias.platform}}/audit/search-audit-entries.handler.js';
-import { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query.js';
+import { SearchAuditEntriesHandler } from '{{alias.platform}}/audit/search-audit-entries.handler{{alias.ext}}';
+import { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query{{alias.ext}}';
 {{/if}}
 
 /**

package/templates/init/platform/audit/create-audit.ts.tpl

@@ -28,16 +28,16 @@ import { DrizzleAuditTrail } from '@ddd-ts-kit/audit/drizzle';
 import type { OnDecision } from '@ddd-ts-kit/auth';
 import type { EventSubscription } from '@ddd-ts-kit/events';
 import type { BusMiddleware } from '@ddd-ts-kit/kernel';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 {{#if audit.sql}}
-import { AUDIT_SCHEMA } from '{{alias.platform}}/database/schema.js';
+import { AUDIT_SCHEMA } from '{{alias.platform}}/database/schema{{alias.ext}}';
 {{/if}}
 {{#if audit.route}}
-import { auditPermissions } from '{{alias.platform}}/audit/audit.permissions.js';
+import { auditPermissions } from '{{alias.platform}}/audit/audit.permissions{{alias.ext}}';
 {{/if}}
-import { auditedEvents } from '{{alias.platform}}/audit/audited-events.js';
+import { auditedEvents } from '{{alias.platform}}/audit/audited-events{{alias.ext}}';
 {{#if audit.route}}
-import { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query.js';
+import { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query{{alias.ext}}';
 {{/if}}
 
 /** The name the audit trail consumes integration events under: its idempotency scope, and its queues behind a broker. */

package/templates/init/platform/audit/search-audit-entries.handler.ts.tpl

@@ -1,6 +1,6 @@
 import type { AuditEntry, AuditReader } from '@ddd-ts-kit/audit';
 import type { Page, QueryHandler } from '@ddd-ts-kit/kernel';
-import type { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query.js';
+import type { SearchAuditEntriesQuery } from '{{alias.platform}}/audit/search-audit-entries.query{{alias.ext}}';
 
 export class SearchAuditEntriesHandler implements QueryHandler<SearchAuditEntriesQuery> {
   constructor(private readonly reader: AuditReader) {}

package/templates/init/platform/audit/search-audit-entries.route.ts.tpl

@@ -10,7 +10,7 @@ import {
 } from '@ddd-ts-kit/http';
 import { err, ok, type QueryBus } from '@ddd-ts-kit/kernel';
 import { customSchema, type JsonSchema } from '@ddd-ts-kit/validation';
-import { SearchAuditEntriesQuery, type AuditEntriesFilter } from '{{alias.platform}}/audit/search-audit-entries.query.js';
+import { SearchAuditEntriesQuery, type AuditEntriesFilter } from '{{alias.platform}}/audit/search-audit-entries.query{{alias.ext}}';
 
 /** Newest first unless asked otherwise, by cursor: the trail only grows, an offset would shift under the reader. */
 const pageLimits = { sortable: ['occurredAt', 'sequence'], maxSize: 100, kind: 'cursor' } as const;

package/templates/init/platform/auth/authorization.tsyringe.ts.tpl

@@ -6,8 +6,8 @@ import type { OnDecision } from '@ddd-ts-kit/auth';
 {{/unless}}
 import { authorizationModule } from '@ddd-ts-kit/auth/di';
 import type { ContextModule } from '@ddd-ts-kit/di';
-import { accessPolicies } from '{{alias.platform}}/auth/access-policies.js';
-import { createAuthorizer } from '{{alias.platform}}/auth/create-authorizer.js';
+import { accessPolicies } from '{{alias.platform}}/auth/access-policies{{alias.ext}}';
+import { createAuthorizer } from '{{alias.platform}}/auth/create-authorizer{{alias.ext}}';
 
 /**
  * Binds `Authorizer`, the guard both buses ask before any handler, the `Access` of the policies{{#if http.any}} and

package/templates/init/platform/auth/create-authenticator.jwt.ts.tpl

@@ -1,6 +1,6 @@
 import type { Authenticator } from '@ddd-ts-kit/auth';
 import { JwtAuthenticator } from '@ddd-ts-kit/auth/jwt';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
 
 /** Verifies the bearer token against the keys the issuer publishes. The session keeps nothing of the token. */
 export function createAuthenticator(config: AppConfig): Authenticator {

package/templates/init/platform/auth/create-authenticator.keycloak.ts.tpl

@@ -1,6 +1,6 @@
 import type { Authenticator } from '@ddd-ts-kit/auth';
 import { keycloakAuthenticator } from '@ddd-ts-kit/auth/jwt';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
 
 /**
  * Verifies the access tokens of the Keycloak realm against the keys it publishes. The actor takes

package/templates/init/platform/auth/create-authenticator.none.ts.tpl

@@ -1,6 +1,6 @@
 import type { Authenticator } from '@ddd-ts-kit/auth';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import { DevelopmentHeaderAuthenticator } from '{{alias.platform}}/auth/development-header-authenticator.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import { DevelopmentHeaderAuthenticator } from '{{alias.platform}}/auth/development-header-authenticator{{alias.ext}}';
 
 // TODO(platform): replace the development authenticator by a real adapter of Authenticator (a JWT verifier, your identity provider) before the first deployment.
 export function createAuthenticator(config: AppConfig): Authenticator {

package/templates/init/platform/auth/create-authorizer.abac.ts.tpl

@@ -1,6 +1,6 @@
 import { PolicyBasedAuthorizer, type Authorizer } from '@ddd-ts-kit/auth';
 import { SystemClock } from '@ddd-ts-kit/kernel';
-import { attributePolicies } from '{{alias.platform}}/auth/attribute-policies.js';
+import { attributePolicies } from '{{alias.platform}}/auth/attribute-policies{{alias.ext}}';
 
 /** Attribute policies: do the attributes of the actor, the resource and the moment satisfy a rule? */
 export function createAuthorizer(): Authorizer {

package/templates/init/platform/auth/create-authorizer.custom.ts.tpl

@@ -1,6 +1,6 @@
 import type { Authorizer } from '@ddd-ts-kit/auth';
-import { CustomAuthorizer } from '{{alias.platform}}/auth/custom-authorizer.js';
-import { permissions } from '{{alias.platform}}/auth/permissions.js';
+import { CustomAuthorizer } from '{{alias.platform}}/auth/custom-authorizer{{alias.ext}}';
+import { permissions } from '{{alias.platform}}/auth/permissions{{alias.ext}}';
 
 // TODO(platform): give the adapter what your model needs (a client of the service that decides, its mapping) instead of this table granting everything to the role "admin".
 export function createAuthorizer(): Authorizer {

package/templates/init/platform/auth/create-authorizer.rbac.ts.tpl

@@ -1,5 +1,5 @@
 import { RoleBasedAuthorizer, type Authorizer } from '@ddd-ts-kit/auth';
-import { roles } from '{{alias.platform}}/auth/roles.js';
+import { roles } from '{{alias.platform}}/auth/roles{{alias.ext}}';
 
 /** Roles: does one of the actor's roles grant this action? Another model is another adapter of the same port. */
 export function createAuthorizer(): Authorizer {

package/templates/init/platform/auth/create-authorizer.rebac.ts.tpl

@@ -1,8 +1,8 @@
 import type { Authorizer } from '@ddd-ts-kit/auth';
 import { RelationBasedAuthorizer } from '@ddd-ts-kit/auth/rebac';
-import { permissionMapping } from '{{alias.platform}}/auth/permission-mapping.js';
-import { relationTuples } from '{{alias.platform}}/auth/relation-tuples.js';
-import { relationshipSchema } from '{{alias.platform}}/auth/relationship-schema.js';
+import { permissionMapping } from '{{alias.platform}}/auth/permission-mapping{{alias.ext}}';
+import { relationTuples } from '{{alias.platform}}/auth/relation-tuples{{alias.ext}}';
+import { relationshipSchema } from '{{alias.platform}}/auth/relationship-schema{{alias.ext}}';
 
 /** Relationships: is there a path of stored tuples from this element to the actor? */
 export function createAuthorizer(): Authorizer {

package/templates/init/platform/auth/create-tuple-store.contract.spec.ts.tpl

@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, it } from '{{tests.module}}';
 import { relationTupleStoreContract } from '@ddd-ts-kit/auth/testing';
-import { createTupleStore } from '{{alias.platform}}/auth/create-tuple-store.js';
+import { createTupleStore } from '{{alias.platform}}/auth/create-tuple-store{{alias.ext}}';
 
 relationTupleStoreContract(
   { describe, it, expect, beforeEach },

package/templates/init/platform/auth/custom-authorizer.contract.spec.ts.tpl

@@ -1,7 +1,7 @@
 import { beforeEach, describe, expect, it } from '{{tests.module}}';
 import { definePermissions } from '@ddd-ts-kit/auth';
 import { anActor, authorizerContract } from '@ddd-ts-kit/auth/testing';
-import { CustomAuthorizer } from '{{alias.platform}}/auth/custom-authorizer.js';
+import { CustomAuthorizer } from '{{alias.platform}}/auth/custom-authorizer{{alias.ext}}';
 
 const permissions = definePermissions('contract', {
   'element.read': { description: 'Read an element' },

package/templates/init/platform/auth/http-boundary.ts.tpl

@@ -8,7 +8,7 @@ import { reportHttpErrors, type ErrorContext, type ErrorMapper, type RouteAround
 import type { Clock, ErrorReporter, ExecutionScope, Logger, Session } from '@ddd-ts-kit/kernel';
 {{/if}}
 import { tracedRoutes } from '@ddd-ts-kit/tracing';
-import { principalOf } from '{{alias.platform}}/auth/principal-of.js';
+import { principalOf } from '{{alias.platform}}/auth/principal-of{{alias.ext}}';
 
 /** What the HTTP adapter needs at the edge of the application: spread into its mount options, for every route. */
 export interface HttpBoundary {