ddd-ts-kit 0.1.1 → 0.2.0

package/templates/init/platform/database/open-test-database.drizzle.ts.tpl

@@ -2,13 +2,13 @@ import { PGlite } from '@electric-sql/pglite';
 import { is, sql, SQL } from 'drizzle-orm';
 import { getTableConfig, PgDialect, PgTable } from 'drizzle-orm/pg-core';
 import { drizzle } from 'drizzle-orm/pglite';
-import { connectToDatabase } from '{{alias.platform}}/database/connect-to-database.js';
-import { persistenceOver } from '{{alias.platform}}/database/persistence-over.js';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import { connectToDatabase } from '{{alias.platform}}/database/connect-to-database{{alias.ext}}';
+import { persistenceOver } from '{{alias.platform}}/database/persistence-over{{alias.ext}}';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 {{#if audit.on}}
 import { auditGuardStatements } from '@ddd-ts-kit/audit/drizzle';
 {{/if}}
-import * as schema from '{{alias.platform}}/database/schema.js';
+import * as schema from '{{alias.platform}}/database/schema{{alias.ext}}';
 
 export interface TestDatabase {
   readonly persistence: Persistence;

package/templates/init/platform/database/open-test-database.knex.ts.tpl

@@ -1,14 +1,14 @@
 import { PGlite } from '@electric-sql/pglite';
 import { PGLiteSocketServer } from '@electric-sql/pglite-socket';
 import type { Knex } from 'knex';
-import { connectToDatabase } from '{{alias.platform}}/database/connect-to-database.js';
-import { persistenceOver } from '{{alias.platform}}/database/persistence-over.js';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import { connectToDatabase } from '{{alias.platform}}/database/connect-to-database{{alias.ext}}';
+import { persistenceOver } from '{{alias.platform}}/database/persistence-over{{alias.ext}}';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 {{#if audit.on}}
-import { AUDIT_SCHEMA, createTables } from '{{alias.platform}}/database/schema.js';
+import { AUDIT_SCHEMA, createTables } from '{{alias.platform}}/database/schema{{alias.ext}}';
 {{/if}}
 {{#unless audit.on}}
-import { createTables } from '{{alias.platform}}/database/schema.js';
+import { createTables } from '{{alias.platform}}/database/schema{{alias.ext}}';
 {{/unless}}
 
 export interface TestDatabase {

package/templates/init/platform/database/open-test-database.prisma.ts.tpl

@@ -2,10 +2,10 @@ import { readFile } from 'node:fs/promises';
 import { PGlite } from '@electric-sql/pglite';
 import { PGLiteSocketServer } from '@electric-sql/pglite-socket';
 import pg from 'pg';
-import type { PrismaClient } from '{{alias.generated}}/prisma/client.js';
-import { createClient } from '{{alias.platform}}/database/create-client.js';
-import { persistenceOver } from '{{alias.platform}}/database/persistence-over.js';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import type { PrismaClient } from '{{alias.generated}}/prisma/client{{alias.ext}}';
+import { createClient } from '{{alias.platform}}/database/create-client{{alias.ext}}';
+import { persistenceOver } from '{{alias.platform}}/database/persistence-over{{alias.ext}}';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 
 export interface TestDatabase {
   readonly persistence: Persistence;

package/templates/init/platform/database/open-test-database.typeorm.ts.tpl

@@ -1,9 +1,9 @@
 import { PGlite } from '@electric-sql/pglite';
 import { PGLiteSocketServer } from '@electric-sql/pglite-socket';
 import type { DataSource } from 'typeorm';
-import { createDataSource } from '{{alias.platform}}/database/create-data-source.js';
-import { persistenceOver } from '{{alias.platform}}/database/persistence-over.js';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import { createDataSource } from '{{alias.platform}}/database/create-data-source{{alias.ext}}';
+import { persistenceOver } from '{{alias.platform}}/database/persistence-over{{alias.ext}}';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 
 export interface TestDatabase {
   readonly persistence: Persistence;

package/templates/init/platform/database/persistence-over.drizzle.ts.tpl

@@ -1,7 +1,7 @@
 import type { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import { createDrizzleUnitOfWork, DrizzleOutboxStore, DrizzleProcessedEventStore } from '@ddd-ts-kit/drizzle/postgres';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
-import { outbox, processedEvents } from '{{alias.platform}}/database/schema.js';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
+import { outbox, processedEvents } from '{{alias.platform}}/database/schema{{alias.ext}}';
 
 /** One object is the unit of work and what repositories query through; the stores write in its transaction. */
 export function persistenceOver(db: PgDatabase<PgQueryResultHKT>, close: () => Promise<void>): Persistence {

package/templates/init/platform/database/persistence-over.knex.ts.tpl

@@ -1,7 +1,7 @@
 import type { Knex } from 'knex';
 import { createKnexUnitOfWork, KnexOutboxStore, KnexProcessedEventStore } from '@ddd-ts-kit/knex';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
-import { MESSAGING } from '{{alias.platform}}/database/schema.js';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
+import { MESSAGING } from '{{alias.platform}}/database/schema{{alias.ext}}';
 
 /** One object is the unit of work and what repositories query through; the stores write in its transaction. */
 export function persistenceOver(db: Knex, close: () => Promise<void>): Persistence {

package/templates/init/platform/database/persistence-over.prisma.ts.tpl

@@ -1,6 +1,6 @@
 import { createPrismaUnitOfWork, PrismaOutboxStore, PrismaProcessedEventStore } from '@ddd-ts-kit/prisma';
-import type { PrismaClient } from '{{alias.generated}}/prisma/client.js';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
+import type { PrismaClient } from '{{alias.generated}}/prisma/client{{alias.ext}}';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
 
 /** One object is the unit of work and what repositories query through; the stores are told how to reach their model. */
 export function persistenceOver(client: PrismaClient): Persistence {

package/templates/init/platform/database/persistence-over.typeorm.ts.tpl

@@ -1,7 +1,7 @@
 import type { DataSource } from 'typeorm';
 import { createTypeOrmUnitOfWork, TypeOrmOutboxStore, TypeOrmProcessedEventStore } from '@ddd-ts-kit/typeorm';
-import type { Persistence } from '{{alias.platform}}/database/persistence.js';
-import { outbox, processedEvents } from '{{alias.platform}}/database/schema.js';
+import type { Persistence } from '{{alias.platform}}/database/persistence{{alias.ext}}';
+import { outbox, processedEvents } from '{{alias.platform}}/database/schema{{alias.ext}}';
 
 /** One object is the unit of work and what repositories query through; the stores write through its manager. */
 export function persistenceOver(dataSource: DataSource): Persistence {

package/templates/init/platform/database/persistence.orm.ts.tpl

@@ -4,7 +4,7 @@ import type { ProcessedEventStore, UnitOfWork } from '@ddd-ts-kit/kernel';
 import type { {{persistence.token}} } from '{{persistence.tokenPackage}}';
 {{/if}}
 {{#if persistence.ownDatabase}}
-import type { Database } from '{{alias.platform}}/database/database.js';
+import type { Database } from '{{alias.platform}}/database/database{{alias.ext}}';
 {{/if}}
 
 /** Where state lives and how a command is made atomic. The platform module binds each member to its port. */

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

@@ -1,6 +1,6 @@
 import { reportProcessFailures } from '@ddd-ts-kit/kernel';
 import { initSentry } from '@ddd-ts-kit/sentry';
-import { loadConfig } from '{{alias.platform}}/config/load-config.js';
+import { loadConfig } from '{{alias.platform}}/config/load-config{{alias.ext}}';
 
 // Evaluated second, right after tracing.ts (see main.ts). The DSN, the environment and the release
 // come from the validated configuration: Sentry and GlitchTip speak the same protocol, only the

package/templates/init/platform/events/create-event-provider.custom.ts.tpl

@@ -1,5 +1,5 @@
-import { CustomEventBus } from '{{alias.platform}}/events/custom-event-bus.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import { CustomEventBus } from '{{alias.platform}}/events/custom-event-bus{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 
 // TODO(platform): give the adapter its connection settings from the validated config, name one subscriber per consuming context, and open and close the connection in start and close.
 export function createEventProvider(): EventProvider {

package/templates/init/platform/events/create-event-provider.kafka.ts.tpl

@@ -2,9 +2,9 @@ import { KafkaEventBus } from '@ddd-ts-kit/kafka';
 {{#if errors.broker}}
 import { DeadLetterReports, NoopErrorReporter, type ErrorReporter } from '@ddd-ts-kit/kernel';
 {{/if}}
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import { aggregateKeyOf } from '{{alias.platform}}/events/aggregate-key-of.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import { aggregateKeyOf } from '{{alias.platform}}/events/aggregate-key-of{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 
 /**
  * Kafka: the relay of the outbox produces to one topic per event type and marks a record

package/templates/init/platform/events/create-event-provider.nats.ts.tpl

@@ -2,8 +2,8 @@
 import { DeadLetterReports, NoopErrorReporter, type ErrorReporter } from '@ddd-ts-kit/kernel';
 {{/if}}
 import { NatsEventBus } from '@ddd-ts-kit/nats';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 
 /**
  * NATS JetStream: the relay of the outbox publishes to one stream and marks a record published

package/templates/init/platform/events/create-event-provider.rabbitmq.ts.tpl

@@ -2,8 +2,8 @@
 import { DeadLetterReports, NoopErrorReporter, type ErrorReporter } from '@ddd-ts-kit/kernel';
 {{/if}}
 import { RabbitMqEventBus } from '@ddd-ts-kit/rabbitmq';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 
 /**
  * RabbitMQ: the relay of the outbox publishes with publisher confirms, each consuming context

package/templates/init/platform/events/create-event-provider.redis.ts.tpl

@@ -2,8 +2,8 @@
 import { DeadLetterReports, NoopErrorReporter, type ErrorReporter } from '@ddd-ts-kit/kernel';
 {{/if}}
 import { RedisStreamsEventBus } from '@ddd-ts-kit/redis/event-bus';
-import type { AppConfig } from '{{alias.platform}}/config/app-config.js';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import type { AppConfig } from '{{alias.platform}}/config/app-config{{alias.ext}}';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 
 /**
  * Redis Streams, on Redis, Dragonfly or Valkey: the relay of the outbox appends to one stream per

package/templates/init/platform/events/custom-event-bus.contract.spec.ts.tpl

@@ -1,6 +1,6 @@
 import { beforeEach, describe, expect, it } from '{{tests.module}}';
 import { eventBusContract } from '@ddd-ts-kit/testing/contracts';
-import { CustomEventBus } from '{{alias.platform}}/events/custom-event-bus.js';
+import { CustomEventBus } from '{{alias.platform}}/events/custom-event-bus{{alias.ext}}';
 
 eventBusContract(
   { describe, it, expect, beforeEach },

package/templates/init/platform/events/in-process-events.ts.tpl

@@ -1,5 +1,5 @@
 import { InMemoryEventBus } from '@ddd-ts-kit/kernel';
-import type { EventProvider } from '{{alias.platform}}/events/event-provider.js';
+import type { EventProvider } from '{{alias.platform}}/events/event-provider{{alias.ext}}';
 
 {{#if broker.none}}
 /** Same process, no broker: {{#if events.outbox}}the relay of the outbox publishes to this bus, which runs the consumers{{/if}}{{#unless events.outbox}}use cases publish to this bus, which runs the consumers{{/unless}}. */

package/templates/init/platform/events/start-outbox-relay.ts.tpl

@@ -13,7 +13,7 @@ import {
 } from '@ddd-ts-kit/kernel';
 {{/if}}
 {{#if broker.kafka}}
-import { aggregateKeyOf } from '{{alias.platform}}/events/aggregate-key-of.js';
+import { aggregateKeyOf } from '{{alias.platform}}/events/aggregate-key-of{{alias.ext}}';
 {{/if}}
 
 export interface OutboxRelayOptions {

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/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. `ownPolicy` is the helper of `{{alias.platform}}/resilience/own-policy.js`, which `generate adapter` writes when the platform does not have it yet.
+- 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. `ownPolicy` is the helper of `{{alias.platform}}/resilience/own-policy.js`, which `generate adapter` writes when the platform does not have it yet.
+- 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/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.

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