ddd-ts-kit 0.1.0 → 0.2.0

package/templates/init/platform/http/create-app-module.ts.tpl

@@ -1,7 +1,7 @@
 import { Module, type DynamicModule } from '@nestjs/common';
 import type { Route } from '@ddd-ts-kit/http';
 import { createRoutesModule } from '@ddd-ts-kit/http/nest';
-import type { HttpBoundary } from '{{alias.platform}}/auth/http-boundary.js';
+import type { HttpBoundary } from '{{alias.platform}}/auth/http-boundary{{alias.ext}}';
 
 @Module({})
 class AppModule {}

package/templates/init/platform/http/start-http-server.express.ts.tpl

@@ -2,13 +2,13 @@ import type { Server } from 'node:http';
 import type { AddressInfo } from 'node:net';
 import express from 'express';
 import { mountExpress } from '@ddd-ts-kit/http/express';
-import type { Application } from '{{alias.platform}}/compose-application.js';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
+import type { Application } from '{{alias.platform}}/compose-application{{alias.ext}}';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
 {{#if cache.rateLimit}}
-import { refusalFor } from '{{alias.platform}}/http/refusal-for.js';
+import { refusalFor } from '{{alias.platform}}/http/refusal-for{{alias.ext}}';
 {{/if}}
 {{#if docs.any}}
-import { withDocumentation } from '{{alias.platform}}/http/with-documentation.js';
+import { withDocumentation } from '{{alias.platform}}/http/with-documentation{{alias.ext}}';
 {{/if}}
 
 export interface HttpServer {

package/templates/init/platform/http/start-http-server.fastify.ts.tpl

@@ -1,12 +1,12 @@
 import Fastify{{#if cache.rateLimit}}, { type FastifyInstance }{{/if}} from 'fastify';
 import { mountFastify } from '@ddd-ts-kit/http/fastify';
-import type { Application } from '{{alias.platform}}/compose-application.js';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
+import type { Application } from '{{alias.platform}}/compose-application{{alias.ext}}';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
 {{#if cache.rateLimit}}
-import { refusalFor } from '{{alias.platform}}/http/refusal-for.js';
+import { refusalFor } from '{{alias.platform}}/http/refusal-for{{alias.ext}}';
 {{/if}}
 {{#if docs.any}}
-import { withDocumentation } from '{{alias.platform}}/http/with-documentation.js';
+import { withDocumentation } from '{{alias.platform}}/http/with-documentation{{alias.ext}}';
 {{/if}}
 
 export interface HttpServer {

package/templates/init/platform/http/start-http-server.nest.ts.tpl

@@ -1,14 +1,14 @@
 import 'reflect-metadata';
 import { Server } from 'node:http';
 import { NestFactory } from '@nestjs/core';
-import type { Application } from '{{alias.platform}}/compose-application.js';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import { createAppModule } from '{{alias.platform}}/http/create-app-module.js';
+import type { Application } from '{{alias.platform}}/compose-application{{alias.ext}}';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import { createAppModule } from '{{alias.platform}}/http/create-app-module{{alias.ext}}';
 {{#if cache.rateLimit}}
-import { refusalFor } from '{{alias.platform}}/http/refusal-for.js';
+import { refusalFor } from '{{alias.platform}}/http/refusal-for{{alias.ext}}';
 {{/if}}
 {{#if docs.any}}
-import { withDocumentation } from '{{alias.platform}}/http/with-documentation.js';
+import { withDocumentation } from '{{alias.platform}}/http/with-documentation{{alias.ext}}';
 {{/if}}
 
 export interface HttpServer {

package/templates/init/platform/http/with-documentation.ts.tpl

@@ -1,8 +1,8 @@
 import type { Route } from '@ddd-ts-kit/http';
 import { openApiDocsRoutes } from '@ddd-ts-kit/http/docs';
 import { generateOpenApi } from '@ddd-ts-kit/http/openapi';
-import { securitySchemes } from '{{alias.platform}}/auth/security-schemes.js';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
+import { securitySchemes } from '{{alias.platform}}/auth/security-schemes{{alias.ext}}';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
 
 /** Adds the contract and its interactive page next to the routes, unless documentation is switched off (API_DOCS, off in production by default). */
 export function withDocumentation(routes: readonly Route[], config: AppConfig): readonly Route[] {

package/templates/init/platform/lay-foundations.tsyringe.ts.tpl

@@ -13,14 +13,14 @@ import {
 } from '@ddd-ts-kit/kernel';
 import { traceApplication, type ConsumerTrace, type TracedApplication } from '@ddd-ts-kit/tracing';
 {{#if audit.on}}
-import { createAudit, type Audit } from '{{alias.platform}}/audit/create-audit.js';
+import { createAudit, type Audit } from '{{alias.platform}}/audit/create-audit{{alias.ext}}';
 {{/if}}
 {{#unless audit.on}}
-import { logDecisions } from '{{alias.platform}}/auth/log-decisions.js';
+import { logDecisions } from '{{alias.platform}}/auth/log-decisions{{alias.ext}}';
 {{/unless}}
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
-import { createLogger, type LogSettings } from '{{alias.platform}}/observability/create-logger.js';
-import { createMetrics } from '{{alias.platform}}/observability/create-metrics.js';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
+import { createLogger, type LogSettings } from '{{alias.platform}}/observability/create-logger{{alias.ext}}';
+import { createMetrics } from '{{alias.platform}}/observability/create-metrics{{alias.ext}}';
 
 /**
  * What exists before any module: built once and handed to the kernel module, so that the buses,

package/templates/init/platform/platform-test.module.tsyringe.ts.tpl

@@ -3,7 +3,7 @@ import { defineContextModule } from '@ddd-ts-kit/di';
 import { {{persistence.token}} } from '{{persistence.tokenPackage}}';
 {{/if}}
 {{#if persistence.ownDatabase}}
-import { Database } from '{{alias.platform}}/database/database.js';
+import { Database } from '{{alias.platform}}/database/database{{alias.ext}}';
 {{/if}}
 // ddd-ts-kit:imports
 // /ddd-ts-kit:imports

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

@@ -22,10 +22,10 @@ import type {
   {{/if}}
 } from '@ddd-ts-kit/kernel';
 {{#if audit.on}}
-import type { Audit } from '{{alias.platform}}/audit/create-audit.js';
+import type { Audit } from '{{alias.platform}}/audit/create-audit{{alias.ext}}';
 {{/if}}
-import type { UseCaseProtection } from '{{alias.platform}}/auth/use-case-protection.js';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import type { UseCaseProtection } from '{{alias.platform}}/auth/use-case-protection{{alias.ext}}';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 
 /** Wraps an adapter from outside: a span for its kind and, for what leaves the process, the default policy unless it states its own. */
 type Adapt = <T extends object>(instance: T, info: AspectInfo) => T;

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

@@ -52,18 +52,18 @@ import { {{#if broker.external}}EventSubscribers, {{/if}}ProcessedEventStore, Un
 import { {{persistence.token}} } from '{{persistence.tokenPackage}}';
 {{/if}}
 {{#if persistence.ownDatabase}}
-import { Database } from '{{alias.platform}}/database/database.js';
+import { Database } from '{{alias.platform}}/database/database{{alias.ext}}';
 {{/if}}
 import type { ConsumerTrace } from '@ddd-ts-kit/tracing';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
-import type { LogSettings } from '{{alias.platform}}/observability/create-logger.js';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
+import type { LogSettings } from '{{alias.platform}}/observability/create-logger{{alias.ext}}';
 {{#if cache.redis}}
-import type { RedisServices } from '{{alias.platform}}/redis/open-redis.js';
+import type { RedisServices } from '{{alias.platform}}/redis/open-redis{{alias.ext}}';
 {{/if}}
-import { adapterAspects } from '{{alias.platform}}/resilience/adapter-aspects.js';
-import { defaultResilience } from '{{alias.platform}}/resilience/default-resilience.js';
-import type { ResilienceSettings } from '{{alias.platform}}/resilience/resilience-settings.js';
+import { adapterAspects } from '{{alias.platform}}/resilience/adapter-aspects{{alias.ext}}';
+import { defaultResilience } from '{{alias.platform}}/resilience/default-resilience{{alias.ext}}';
+import type { ResilienceSettings } from '{{alias.platform}}/resilience/resilience-settings{{alias.ext}}';
 {{#if style.declared}}
 // ddd-ts-kit:imports
 // /ddd-ts-kit:imports

package/templates/init/platform/resilience/adapter-aspects.ts.tpl

@@ -1,6 +1,6 @@
 import { forKinds, retry, timeout, when, type Aspect } from '@ddd-ts-kit/aspects';
-import type { ResilienceSettings } from '{{alias.platform}}/resilience/resilience-settings.js';
-import { selfGoverned } from '{{alias.platform}}/resilience/self-governed.js';
+import type { ResilienceSettings } from '{{alias.platform}}/resilience/resilience-settings{{alias.ext}}';
+import { selfGoverned } from '{{alias.platform}}/resilience/self-governed{{alias.ext}}';
 
 /**
  * What goes around every adapter that leaves the process (`external`, `gateway`) and states no

package/templates/init/platform/resilience/default-resilience.ts.tpl

@@ -1,4 +1,4 @@
-import type { ResilienceSettings } from '{{alias.platform}}/resilience/resilience-settings.js';
+import type { ResilienceSettings } from '{{alias.platform}}/resilience/resilience-settings{{alias.ext}}';
 
 /** What the tools and the tests run with; `main.ts` gives the validated values of the configuration. */
 export const defaultResilience: ResilienceSettings = { retryAttempts: 3, retryBaseDelayMs: 100, timeoutMs: 2000 };

package/templates/init/platform/resilience/own-policy.ts.tpl

@@ -1,5 +1,5 @@
 import { compose, type Aspect } from '@ddd-ts-kit/aspects';
-import { selfGoverned } from '{{alias.platform}}/resilience/self-governed.js';
+import { selfGoverned } from '{{alias.platform}}/resilience/self-governed{{alias.ext}}';
 
 /**
  * The policy one adapter states for itself, in place of the default one:

package/templates/init/platform/tracing.ts.tpl

@@ -1,6 +1,6 @@
 import { initTracing } from '@ddd-ts-kit/tracing/node';
-import { ConfigError } from '{{alias.platform}}/config/config-error.js';
-import { readTracing } from '{{alias.platform}}/config/read-tracing.js';
+import { ConfigError } from '{{alias.platform}}/config/config-error{{alias.ext}}';
+import { readTracing } from '{{alias.platform}}/config/read-tracing{{alias.ext}}';
 
 // Evaluated before the rest of the application (see main.ts): it validates the variables of its
 // own and reads the two names directly, so that no module an instrumentation patches is loaded

package/templates/init/pnpm-workspace.yaml

@@ -0,0 +1,8 @@
+# No dependency runs a build script at install, as under npm: one whose script the
+# project needs (a native client, for instance) is allowed by name, once its script was read:
+#
+#   allowBuilds:
+#     '<package>': true
+#
+# Without this line pnpm refuses to install as long as one script is neither allowed nor refused.
+strictDepBuilds: false

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

@@ -10,14 +10,20 @@ paths:
 - Events leave with the save: never `pullEvents()`, never a `DomainEventDispatcher` here (`domain-events/dispatched-on-save`). A reaction is a class of `event-handlers/` or a publisher of `integration/publishers/`. It runs at the end of the unit of work, before the commit, and depends only on what the transaction covers (`domain-events/transactional-before-commit`): repositories, the integration event publisher, the command bus. An effect outside the database is a handler of the `after-commit` phase (`generate event-handler ... --phase after-commit`: at most once, never saves, sends a command) or, when it must not be lost, the handler of an integration event.
 {{#if style.declared}}
 - Every command and query carries `@Requires(permission)` or `@Public()` (`authz/declared`), and the actor is in the message (`authz/actor-explicit`). Permissions live in `authorization/<context>.permissions.ts`, rules that need loaded state in `authorization/*.policy.ts`.
-- The decorator is the registration (`declarations/role-declared`): `@CommandHandler(Message, [Ports])`, `@QueryHandler`, `@DomainEventHandler(Event, { name }, [Ports])`, `@IntegrationEventHandler(definition, { consumer }, [Ports])`, `@Scheduled('<context>.<job>', schedule, [CommandBus])`, `@Policy(permission, { name })`. Names are string literals.
+- The decorator is the registration (`declarations/role-declared`): `@CommandHandler(Message)`, `@QueryHandler(Message)`, `@DomainEventHandler(Event, { name })`, `@IntegrationEventHandler(definition, { consumer })`, `@Scheduled('<context>.<job>', schedule)`, `@Projection('<context>.<name>')`, `@Policy(permission, { name })`. Names are string literals.
+- The constructor is the one statement of what a class depends on (`declarations/constructor-injection`): each parameter is typed by one port class, with no `?`, default value, rest or destructuring, and no list repeats it in the decorator. To add a dependency, add the parameter: `npx ddd-ts-kit docs` reads the signature into the generated file of the context (`npm run dev` does it on every change), never edit that file.
 {{/if}}
 {{#if style.explicit}}
 - Every command and query is registered in `<context>.module.ts` with the permission it requires, or as public (`authz/declared`), and the actor is in the message (`authz/actor-explicit`). Permissions live in `authorization/<context>.permissions.ts`, rules that need loaded state in `authorization/*.policy.ts`.
-- A class here carries no registration of its own: `<context>.module.ts` binds it. A job is registered as `@Scheduled('<context>.<job>', schedule, [CommandBus])` would say: one name, one schedule, the command bus.
+- A class here carries no registration of its own: `<context>.module.ts` binds it and lists what its constructor receives. A job is registered as `@Scheduled('<context>.<job>', schedule)` would say: one name, one schedule, and the command bus as its only dependency.
 {{/if}}
 - A port is an abstract class in `ports/<name>.port.ts` and its own injection token (`ports/abstract-class`, `ports/no-token-constant`), named for the need (`PaymentGateway`), with a fake in `test/fakes/`.
+{{#if style.declared}}
+- A constructor parameter is typed by a port, never by an adapter or a fake (`ports/no-concrete-dependency`); a port that only types a parameter is imported with `import type`.
+{{/if}}
+{{#if style.explicit}}
 - A dependency list names port classes, imported as values, in the order of the constructor: never an adapter or a fake (`ports/value-import`, `ports/no-concrete-dependency`).
+{{/if}}
 - A job (`scheduling/*.job.ts`) and an integration event handler (`integration/handlers/`) only build one command and send it as a system actor; both are safe to repeat (`scheduling/job-triggers-use-case`, `events/consumer-idempotent`).
 - A query never saves, deletes or publishes (`application/command-query-separation`); it hands the access scope of the actor to its read port and never filters after loading.
 - A read that takes criteria, a scope or a page is a search, never a list (`naming/search-not-list`): `Search<Things>Query` in `queries/search-<things>/` (`generate query ... --search`), `search...` on the port, its adapters and its fakes; one element or none stays `findById` or `findBy...`.

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

@@ -11,12 +11,12 @@ paths:
 - Own tables, in the schema of the context: no join, foreign key or transaction across contexts (`context/extractable`).
 - Audit columns and the tenant column are stamped from the execution scope with the kernel helpers (`stampCreation`, `stampUpdate`, `tenantScopeOf`), never handed over by a use case.
 {{#if style.declared}}
-- An adapter declares itself on its class, one per file (`declarations/role-declared`): `@Repository(InvoiceRepository, [{{persistence.tokenOrNone}}, ExecutionScope, Clock])`, `@Gateway(Port, [Ports])` or `@Adapter(Port, { kind }, [Ports])`.
-- Retry, timeout and cache go on the declaration (`aspects: [ownPolicy(retry(...), timeout(...))]`) or, when the policy is part of what the adapter is, as decorators of `@ddd-ts-kit/aspects/decorators` (`aspects/outside-in`). Kinds `external` and `gateway` get the default policy of the platform otherwise.
+- An adapter declares itself on its class, one per file (`declarations/role-declared`): `@Repository(InvoiceRepository)`, `@Gateway(Port)` or `@Adapter(Port, { kind })`. What it is given is what its constructor takes, each parameter typed by one class (`{{persistence.tokenOrNone}}`, `ExecutionScope`, `Clock`, a port, an abstract class the platform binds to a value) and nothing listed in the decorator (`declarations/constructor-injection`); an adapter that extends a class of a package writes its own constructor.
+- Retry, timeout and cache go on the declaration (`aspects: [ownPolicy(retry(...), timeout(...))]`) or, when the policy is part of what the adapter is, as decorators of `@ddd-ts-kit/aspects/decorators` (`aspects/outside-in`). Kinds `external` and `gateway` get the default policy of the platform otherwise. `ownPolicy` is the helper of `{{alias.platform}}/resilience/own-policy{{alias.ext}}`, which `generate adapter` writes when the platform does not have it yet.
 {{/if}}
 {{#if style.explicit}}
 - An adapter is bound to its port in `<context>.module.ts` only (`composition/only-in-module`), with its kind (`repository`, `gateway`, `external`).
-- Retry, timeout and cache go on the binding (`ownPolicy(retry(...), timeout(...))`) or, when the policy is part of what the adapter is, as decorators of `@ddd-ts-kit/aspects/decorators` (`aspects/outside-in`). Kinds `external` and `gateway` get the default policy of the platform otherwise.
+- Retry, timeout and cache go on the binding (`ownPolicy(retry(...), timeout(...))`) or, when the policy is part of what the adapter is, as decorators of `@ddd-ts-kit/aspects/decorators` (`aspects/outside-in`). Kinds `external` and `gateway` get the default policy of the platform otherwise. `ownPolicy` is the helper of `{{alias.platform}}/resilience/own-policy{{alias.ext}}`, which `generate adapter` writes when the platform does not have it yet.
 {{/if}}
 - A repository only persists: no `pullEvents()`, no dispatcher (`domain-events/dispatched-on-save`). A removal that announces an event takes the aggregate, not its id.
 - Infrastructure faults are plain errors (a 5xx, reported from outside); business refusals are `DomainError`s raised by the domain.

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

@@ -39,7 +39,7 @@ function reportStale(): void {
     const committed = fs.existsSync(path.join(target, file)) ? fs.readFileSync(path.join(target, file), 'utf8') : '';
 
     if (committed.replaceAll('\r\n', '\n') !== content) {
-      console.error('docs/integration/' + file + ' is out of date: run `npm run docs:generate` and commit the result.');
+      console.error('docs/integration/' + file + ' is out of date: run the script `docs:generate` and commit it.');
       process.exitCode = 1;
     }
   }

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

@@ -1,11 +1,11 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { checkOpenApiDrift, generateOpenApi, stringifyOpenApi } from '@ddd-ts-kit/http/openapi';
-import { offlineAuthenticator } from '{{alias.platform}}/auth/offline-authenticator.js';
-import { securitySchemes } from '{{alias.platform}}/auth/security-schemes.js';
-import { composeApplication } from '{{alias.platform}}/compose-application.js';
-import { inertPersistence } from '{{alias.platform}}/database/inert-persistence.js';
-import { inProcessEvents } from '{{alias.platform}}/events/in-process-events.js';
+import { offlineAuthenticator } from '{{alias.platform}}/auth/offline-authenticator{{alias.ext}}';
+import { securitySchemes } from '{{alias.platform}}/auth/security-schemes{{alias.ext}}';
+import { composeApplication } from '{{alias.platform}}/compose-application{{alias.ext}}';
+import { inertPersistence } from '{{alias.platform}}/database/inert-persistence{{alias.ext}}';
+import { inProcessEvents } from '{{alias.platform}}/events/in-process-events{{alias.ext}}';
 
 // Generates openapi/openapi.json from the route definitions; with --check, fails when the
 // committed file differs. The file is a build product: never edit it by hand.
@@ -40,7 +40,7 @@ function reportDrift(): void {
     return;
   }
 
-  console.error('openapi/openapi.json is out of date: run `npm run docs:generate` and commit the result.');
+  console.error('openapi/openapi.json is out of date: run the script `docs:generate` and commit it.');
   process.exitCode = 1;
 }
 

package/templates/integration-event/audited.tpl

@@ -1,4 +1,4 @@
 @@imports
-import { {{event.camel}}V{{event.version}} } from '{{alias.context}}/published-language/index.js';
+import { {{event.camel}}V{{event.version}} } from '{{alias.context}}/published-language/index{{alias.ext}}';
 @@events
 {{event.camel}}V{{event.version}},

package/templates/integration-event/integration-event.class-validator.ts.tpl

@@ -1,7 +1,7 @@
 import { defineIntegrationEvent } from '@ddd-ts-kit/events';
 import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
 import { classSchema } from '@ddd-ts-kit/validation/class-validator';
-import { {{event.pascal}}V{{event.version}}Payload } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.payload.js';
+import { {{event.pascal}}V{{event.version}}Payload } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.payload{{alias.ext}}';
 
 export const {{event.camel}}V{{event.version}} = defineIntegrationEvent({
   type: '{{event.name}}',

package/templates/integration-event/integration-event.custom.ts.tpl

@@ -1,7 +1,7 @@
 import { defineIntegrationEvent } from '@ddd-ts-kit/events';
 import { err, ok, type IntegrationEvent } from '@ddd-ts-kit/kernel';
 import { customSchema } from '@ddd-ts-kit/validation';
-import type { {{event.pascal}}V{{event.version}}Payload } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.payload.js';
+import type { {{event.pascal}}V{{event.version}}Payload } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.payload{{alias.ext}}';
 
 export const {{event.camel}}V{{event.version}} = defineIntegrationEvent({
   type: '{{event.name}}',

package/templates/integration-event/publisher.declared.ts.tpl

@@ -1,9 +1,9 @@
-import { IdGenerator, IntegrationEventPublisher } from '@ddd-ts-kit/kernel';
+import type { IdGenerator, IntegrationEventPublisher } from '@ddd-ts-kit/kernel';
 import { DomainEventHandler } from '@ddd-ts-kit/kernel/declarations';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
-import { {{event.camel}}V{{event.version}} } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.integration-event.js';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
+import { {{event.camel}}V{{event.version}} } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.integration-event{{alias.ext}}';
 
-@DomainEventHandler({{event.pascal}}, { name: '{{event.name}}' }, [IntegrationEventPublisher, IdGenerator])
+@DomainEventHandler({{event.pascal}}, { name: '{{event.name}}' })
 export class {{publisher.pascal}}Publisher implements DomainEventHandler<{{event.pascal}}> {
   constructor(
     private readonly publisher: IntegrationEventPublisher,

package/templates/integration-event/publisher.spec.ts.tpl

@@ -1,7 +1,7 @@
 import { describe, expect, it } from '{{tests.module}}';
 import { InMemoryEventBus, SequentialIdGenerator } from '@ddd-ts-kit/kernel';
-import { {{publisher.pascal}}Publisher } from '{{alias.context}}/application/integration/publishers/{{publisher.kebab}}.publisher.js';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import { {{publisher.pascal}}Publisher } from '{{alias.context}}/application/integration/publishers/{{publisher.kebab}}.publisher{{alias.ext}}';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 
 describe('Publishing "{{event.words}}" to other contexts', () => {
   it('publishes version {{event.version}} of {{event.name}}', async () => {

package/templates/integration-event/publisher.ts.tpl

@@ -1,6 +1,6 @@
 import type { IdGenerator, IntegrationEventPublisher } from '@ddd-ts-kit/kernel';
-import type { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
-import { {{event.camel}}V{{event.version}} } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.integration-event.js';
+import type { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
+import { {{event.camel}}V{{event.version}} } from '{{alias.context}}/published-language/{{event.kebab}}.v{{event.version}}.integration-event{{alias.ext}}';
 
 export class {{publisher.pascal}}Publisher {
   constructor(

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

@@ -1,6 +1,6 @@
 @@imports
-import { {{publisher.pascal}}Publisher } from '{{alias.context}}/application/integration/publishers/{{publisher.kebab}}.publisher.js';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import { {{publisher.pascal}}Publisher } from '{{alias.context}}/application/integration/publishers/{{publisher.kebab}}.publisher{{alias.ext}}';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 @@registrations
 const {{publisher.camel}}Publisher = platform.adapter(new {{publisher.pascal}}Publisher(platform.publisher, platform.ids), { kind: 'domain-event-handler', context: '{{context.kebab}}' });
 

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

@@ -1,7 +1,7 @@
 @@imports
 import { DomainEventDispatcher, IdGenerator, IntegrationEventPublisher } from '@ddd-ts-kit/kernel';
-import { {{publisher.pascal}}Publisher } from '{{alias.context}}/application/integration/publishers/{{publisher.kebab}}.publisher.js';
-import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event.js';
+import { {{publisher.pascal}}Publisher } from '{{alias.context}}/application/integration/publishers/{{publisher.kebab}}.publisher{{alias.ext}}';
+import { {{event.pascal}} } from '{{alias.context}}/domain/events/{{event.kebab}}.event{{alias.ext}}';
 @@registrations
 builder.bind({{publisher.pascal}}Publisher).toClass({{publisher.pascal}}Publisher, [IntegrationEventPublisher, IdGenerator]).as('domain-event-handler');
 @@start

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

@@ -1,8 +1,8 @@
-import { CommandBus, systemActor } from '@ddd-ts-kit/kernel';
+import { systemActor, type CommandBus } from '@ddd-ts-kit/kernel';
 import { IntegrationEventHandler } from '@ddd-ts-kit/kernel/declarations';
-import { {{upstream.definition}}, type {{upstream.eventType}} } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{upstream.definition}}, type {{upstream.eventType}} } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 
-@IntegrationEventHandler({{upstream.definition}}, { consumer: '{{context.kebab}}.{{name.kebab}}' }, [CommandBus])
+@IntegrationEventHandler({{upstream.definition}}, { consumer: '{{context.kebab}}.{{name.kebab}}' })
 export class {{name.pascal}}IntegrationHandler {
   static readonly eventType = '{{upstream.eventName}}';
 

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

@@ -1,9 +1,9 @@
 import { describe, expect, it } from '{{tests.module}}';
 import { InMemoryCommandBus } from '@ddd-ts-kit/kernel';
 {{#if upstream.known}}
-import { {{upstream.definition}} } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{upstream.definition}} } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 {{/if}}
-import { {{name.pascal}}IntegrationHandler } from '{{alias.context}}/application/integration/handlers/{{name.kebab}}.integration-handler.js';
+import { {{name.pascal}}IntegrationHandler } from '{{alias.context}}/application/integration/handlers/{{name.kebab}}.integration-handler{{alias.ext}}';
 
 describe('When {{upstream.kebab}} publishes {{upstream.eventName}}', () => {
   it('listens to the type {{upstream.kebab}} publishes', () => {

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

@@ -1,6 +1,6 @@
 {{#if upstream.known}}
 import { systemActor, type CommandBus } from '@ddd-ts-kit/kernel';
-import type { {{upstream.eventType}} } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import type { {{upstream.eventType}} } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 {{/if}}
 {{#unless upstream.known}}
 import { systemActor, type CommandBus, type IntegrationEvent } from '@ddd-ts-kit/kernel';

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

@@ -1,16 +1,16 @@
 @@imports
 {{#if consumer.declarative}}
 import { on, subscribeAll } from '@ddd-ts-kit/events';
-import { {{upstream.definition}} as {{name.camel}}Definition } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{upstream.definition}} as {{name.camel}}Definition } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 {{/if}}
 {{#if consumer.transactional}}
 import { consume, subscribeAll } from '@ddd-ts-kit/events';
-import { {{upstream.definition}} as {{name.camel}}Definition } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{upstream.definition}} as {{name.camel}}Definition } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 {{/if}}
 {{#if consumer.untyped}}
 import { idempotent, inEventScope } from '@ddd-ts-kit/kernel';
 {{/if}}
-import { {{name.pascal}}IntegrationHandler } from '{{alias.context}}/application/integration/handlers/{{name.kebab}}.integration-handler.js';
+import { {{name.pascal}}IntegrationHandler } from '{{alias.context}}/application/integration/handlers/{{name.kebab}}.integration-handler{{alias.ext}}';
 @@registrations
 const {{name.camel}}IntegrationHandler = new {{name.pascal}}IntegrationHandler(platform.commands);
 

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

@@ -1,12 +1,12 @@
 @@imports
 {{#if upstream.known}}
 import { CommandBus } from '@ddd-ts-kit/kernel';
-import { {{upstream.definition}} as {{name.camel}}Definition } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index.js';
+import { {{upstream.definition}} as {{name.camel}}Definition } from '{{alias.contexts}}/{{upstream.kebab}}/published-language/index{{alias.ext}}';
 {{/if}}
 {{#unless upstream.known}}
 import { CommandBus, EventSubscribers, ExecutionScope, ProcessedEventStore, idempotent, inEventScope } from '@ddd-ts-kit/kernel';
 {{/unless}}
-import { {{name.pascal}}IntegrationHandler } from '{{alias.context}}/application/integration/handlers/{{name.kebab}}.integration-handler.js';
+import { {{name.pascal}}IntegrationHandler } from '{{alias.context}}/application/integration/handlers/{{name.kebab}}.integration-handler{{alias.ext}}';
 @@registrations
 {{#if upstream.known}}
 builder.on({{name.camel}}Definition, { consumer: '{{context.kebab}}.{{name.kebab}}' }).handledBy({{name.pascal}}IntegrationHandler, [CommandBus]);

package/templates/job/job.declared.ts.tpl

@@ -1,8 +1,8 @@
-import { CommandBus{{job.systemActorImport}} } from '@ddd-ts-kit/kernel';
+{{job.kernelImport}}
 import { Scheduled, type JobExecution, type ScheduledJob } from '@ddd-ts-kit/kernel/declarations';
-import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command.js';
+import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command{{alias.ext}}';
 
-@Scheduled('{{job.name}}', {{job.schedule}}, [CommandBus])
+@Scheduled('{{job.name}}', {{job.schedule}})
 export class {{name.pascal}}Job implements ScheduledJob {
   constructor(private readonly commands: CommandBus) {}
 

package/templates/job/job.spec.buses.ts.tpl

@@ -1,8 +1,8 @@
 import { describe, expect, it } from '{{tests.module}}';
 import type { Message } from '@ddd-ts-kit/kernel';
 import { createTestBuses } from '@ddd-ts-kit/testing';
-import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command.js';
-import { {{name.pascal}}Job } from '{{alias.context}}/application/scheduling/{{name.kebab}}.job.js';
+import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command{{alias.ext}}';
+import { {{name.pascal}}Job } from '{{alias.context}}/application/scheduling/{{name.kebab}}.job{{alias.ext}}';
 
 const occurrence = {
   scheduledAt: new Date('2026-01-01T07:00:00.000Z'),

package/templates/job/job.spec.tsyringe.ts.tpl

@@ -4,9 +4,9 @@ import { authorizationModule } from '@ddd-ts-kit/auth/di';
 {{spec.diPlain}}
 {{spec.contextImports}}
 import type { Message } from '@ddd-ts-kit/kernel';
-import { platformTestModule } from '{{alias.platform}}/platform-test.module.js';
+import { platformTestModule } from '{{alias.platform}}/platform-test.module{{alias.ext}}';
 {{job.permissionsImport}}
-import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command.js';
+import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command{{alias.ext}}';
 
 const authorization = authorizationModule({
   authorizer: new RoleBasedAuthorizer({

package/templates/job/job.ts.tpl

@@ -1,5 +1,5 @@
 import { {{job.systemActorValueImport}}type CommandBus, type JobExecution, type ScheduledJob } from '@ddd-ts-kit/kernel';
-import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command.js';
+import { {{job.command}}Command } from '{{alias.context}}/application/commands/{{job.commandKebab}}/{{job.commandKebab}}.command{{alias.ext}}';
 
 export class {{name.pascal}}Job implements ScheduledJob {
   constructor(private readonly commands: CommandBus) {}

package/templates/job/wiring.manual.tpl

@@ -1,5 +1,5 @@
 @@imports
-import { {{name.pascal}}Job } from '{{alias.context}}/application/scheduling/{{name.kebab}}.job.js';
+import { {{name.pascal}}Job } from '{{alias.context}}/application/scheduling/{{name.kebab}}.job{{alias.ext}}';
 @@registrations
 const {{name.camel}}Job = new {{name.pascal}}Job(platform.commands);
 

package/templates/job/wiring.tsyringe.tpl

@@ -1,5 +1,5 @@
 @@imports
 import { CommandBus } from '@ddd-ts-kit/kernel';
-import { {{name.pascal}}Job } from '{{alias.context}}/application/scheduling/{{name.kebab}}.job.js';
+import { {{name.pascal}}Job } from '{{alias.context}}/application/scheduling/{{name.kebab}}.job{{alias.ext}}';
 @@registrations
 builder.job('{{job.name}}', {{job.schedule}}).handledBy({{name.pascal}}Job, [CommandBus]);

package/templates/pipeline/biome.json.tpl

@@ -17,7 +17,8 @@
       "!**/package-lock.json",
       "!**/.dependency-cruiser.cjs",
       "!**/openapi/*.json",
-      "!**/asyncapi.json"
+      "!**/asyncapi.json",
+      "!**/migrations/meta"
     ]
   },
   "formatter": {

package/templates/pipeline/github/actions/setup/action.yml.tpl

@@ -0,0 +1,37 @@
+name: Setup
+description: Node, then the dependencies of the lockfile, restored from the cache when a run already installed them.
+
+inputs:
+  node-version:
+    description: The Node.js release line the pipeline runs on.
+    default: '24'
+
+runs:
+  using: composite
+  steps:
+    - uses: actions/setup-node@v7
+      with:
+        node-version: ${{ inputs.node-version }}
+{{#if pm.corepack}}
+    - name: The package manager package.json pins
+      shell: bash
+      run: corepack enable
+{{/if}}
+    # One install per lockfile, shared by every job and every run. The key holds the lockfile and
+    # package.json: a hit is what a fresh install of that lockfile gives, and a manifest that left
+    # its lockfile behind is installed again, which refuses it.
+    - name: Dependencies, as a run already installed them for this lockfile
+      id: modules
+      uses: actions/cache@v6
+      with:
+        path: node_modules
+        key: modules-${{ runner.os }}-${{ runner.arch }}-node${{ inputs.node-version }}-${{ hashFiles('package-lock.json', 'package.json') }}
+    - name: Install (no run installed this lockfile yet, or the cache was evicted)
+      if: steps.modules.outputs.cache-hit != 'true'
+      shell: bash
+      run: npm ci
+{{#if orm.prisma}}
+    - name: The Prisma client and the schema of the tests, build products of prisma/schema.prisma
+      shell: bash
+      run: npm run db:client
+{{/if}}