@starci/hfs 5.0.8 → 5.1.0

package/templates/be/patterns/jobs/platform/persistence.jobs.sql.ts.tpl

@@ -1,11 +1,12 @@
 import { sql } from "@modules/platform/database"
+import type { SqlText } from "@modules/platform/database"
 
 /**
  * Claims a delivery in one statement ($1 kind, $2 job key, $3 worker, $4 lease end, $5 payload, $6 instant). A new key inserts the row
  * with token 1; an existing key is claimed again only when the job failed or its lease expired, and then the token is bumped by the
  * store. A done job and a live claim match nothing, so no row comes back.
  */
-export const CLAIM_JOB = sql`INSERT INTO jobs (kind, job_key, status, fencing_token, claimed_by, lease_expires_at, payload, created_at, updated_at)
+export const CLAIM_JOB: SqlText = sql`INSERT INTO jobs (kind, job_key, status, fencing_token, claimed_by, lease_expires_at, payload, created_at, updated_at)
     VALUES ($1, $2, 'running', 1, $3, $4, $5::jsonb, $6, $6)
     ON CONFLICT (job_key) DO UPDATE
        SET fencing_token = jobs.fencing_token + 1, claimed_by = $3, lease_expires_at = $4, status = 'running', error = NULL, updated_at = $6
@@ -15,19 +16,19 @@ export const CLAIM_JOB = sql`INSERT INTO jobs (kind, job_key, status, fencing_to
 /** The guarded writes wrap their UPDATE in a CTE: TypeORM returns a bare `UPDATE ... RETURNING` as `[rows, count]`, a SELECT as rows. */
 
 /** Records a step ($1 job id, $2 expected token, $3 step, $4 instant); no row comes back when the token is stale. */
-export const ADVANCE_JOB = sql`WITH changed AS (UPDATE jobs SET current_step = $3, updated_at = $4
+export const ADVANCE_JOB: SqlText = sql`WITH changed AS (UPDATE jobs SET current_step = $3, updated_at = $4
     WHERE id = $1 AND fencing_token = $2 AND status = 'running'
        RETURNING id)
     SELECT id FROM changed`
 
 /** Completes the job ($1 job id, $2 expected token, $3 instant). */
-export const COMPLETE_JOB = sql`WITH changed AS (UPDATE jobs SET status = 'done', lease_expires_at = NULL, updated_at = $3
+export const COMPLETE_JOB: SqlText = sql`WITH changed AS (UPDATE jobs SET status = 'done', lease_expires_at = NULL, updated_at = $3
     WHERE id = $1 AND fencing_token = $2 AND status = 'running'
        RETURNING id)
     SELECT id FROM changed`
 
 /** Fails the job ($1 job id, $2 expected token, $3 reason, $4 instant). */
-export const FAIL_JOB = sql`WITH changed AS (UPDATE jobs SET status = 'failed', error = $3, lease_expires_at = NULL, updated_at = $4
+export const FAIL_JOB: SqlText = sql`WITH changed AS (UPDATE jobs SET status = 'failed', error = $3, lease_expires_at = NULL, updated_at = $4
     WHERE id = $1 AND fencing_token = $2 AND status = 'running'
        RETURNING id)
     SELECT id FROM changed`

package/templates/be/patterns/projections/persistence.connection.ts.tpl

@@ -1,8 +1,9 @@
+import type { DatabaseConnectionOptions } from "@modules/platform/database"
 import { @@Name@@ProjectionEntity } from "../@@name@@.projection-entity"
 import { Create@@Name@@Projection@@epochMs13@@ } from "./migrations/@@epochMs13@@-create-@@name@@"
 
 /** The entities of the @@name@@ read model, for the connection that holds them. */
-export const @@nameCamel@@Entities = [@@Name@@ProjectionEntity]
+export const @@nameCamel@@Entities: DatabaseConnectionOptions["entities"] = [@@Name@@ProjectionEntity]
 
 /** The migrations of the @@name@@ read model, in the order they run. */
-export const @@nameCamel@@Migrations = [Create@@Name@@Projection@@epochMs13@@]
+export const @@nameCamel@@Migrations: DatabaseConnectionOptions["migrations"] = [Create@@Name@@Projection@@epochMs13@@]

package/templates/be/patterns/projections/projection.module-definition.ts.tpl

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Name@@Options } from "./@@name@@.options"
 
-/** The configurable-module base of the @@name@@ projection; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<@@Name@@Options>()
+const built = new ConfigurableModuleBuilder<@@Name@@Options>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<@@Name@@Options, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the @@name@@ projection; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/queues/platform/persistence.connection.ts.tpl

@@ -1,8 +1,9 @@
+import type { DatabaseConnectionOptions } from "@modules/platform/database"
 import { QueueOutboxEntity } from "./entities/queue-outbox.entity"
 import { CreateQueueOutbox@@epochMs13@@ } from "./migrations/@@epochMs13@@-create-queue-outbox"
 
 /** The entities of the queues, for every connection that enqueues jobs. */
-export const queueEntities = [QueueOutboxEntity]
+export const queueEntities: DatabaseConnectionOptions["entities"] = [QueueOutboxEntity]
 
 /** The migrations of the queues, in the order they run. */
-export const queueMigrations = [CreateQueueOutbox@@epochMs13@@]
+export const queueMigrations: DatabaseConnectionOptions["migrations"] = [CreateQueueOutbox@@epochMs13@@]

package/templates/be/patterns/queues/platform/persistence.queue.sql.ts.tpl

@@ -1,12 +1,13 @@
 import { sql } from "@modules/platform/database"
+import type { SqlText } from "@modules/platform/database"
 
 /** Writes one job in the outbox ($1 queue, $2 payload, $3 instant, $4 correlation id). */
-export const INSERT_QUEUE_ROW = sql`INSERT INTO queue_outbox (queue, payload, created_at, correlation_id)
+export const INSERT_QUEUE_ROW: SqlText = sql`INSERT INTO queue_outbox (queue, payload, created_at, correlation_id)
     VALUES ($1, $2, $3, $4)`
 
 /** Locks and reads the oldest rows that wait ($1 batch size); a second relay skips the rows this one holds. */
-export const SELECT_WAITING_ROWS = sql`SELECT id, queue, payload, correlation_id AS "correlationId" FROM queue_outbox
+export const SELECT_WAITING_ROWS: SqlText = sql`SELECT id, queue, payload, correlation_id AS "correlationId" FROM queue_outbox
     WHERE sent_at IS NULL ORDER BY created_at, id LIMIT $1 FOR UPDATE SKIP LOCKED`
 
 /** Marks the rows as handed to BullMQ ($1 ids, $2 instant). */
-export const MARK_ROWS_SENT = sql`UPDATE queue_outbox SET sent_at = $2 WHERE id = ANY($1::uuid[])`
+export const MARK_ROWS_SENT: SqlText = sql`UPDATE queue_outbox SET sent_at = $2 WHERE id = ANY($1::uuid[])`

package/templates/be/patterns/queues/platform/queue.module-definition.ts.tpl

@@ -1,10 +1,15 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import { QUEUE_OPTIONS } from "./queue.decorators"
 import type { QueueRegistrationOptions } from "./queue.options"
 
-/** The configurable-module base of the queues; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<QueueRegistrationOptions>({
+const built = new ConfigurableModuleBuilder<QueueRegistrationOptions>({
     optionsInjectionToken: QUEUE_OPTIONS,
 })
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<QueueRegistrationOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the queues; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/queues/queue.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Queue@@Options } from "./@@queue@@.options"
 
+const built = new ConfigurableModuleBuilder<@@Queue@@Options>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Queue@@Options, "register", "create", {}>
+
 /** The configurable-module base of the @@queue@@ module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Queue@@Options>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/reactors/consumer.ts.tpl

@@ -8,7 +8,7 @@ import { @@Action@@Command } from "../../application/@@action@@.command"
 @Injectable()
 /** The consumer door of the @@event@@ event in the @@reactor@@ reactor: it dispatches one command and forwards the event id. */
 export class @@Event@@Consumer implements EventConsumer<@@Event@@Event> {
-    readonly event = @@Event@@Event
+    readonly event: typeof @@Event@@Event = @@Event@@Event
 
     constructor(@InjectCommandBus() private readonly commandBus: CommandBus) {}
 

package/templates/be/patterns/reactors/message.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Reactor@@MessageOptions } from "./@@reactor@@-message.options"
 
+const built = new ConfigurableModuleBuilder<@@Reactor@@MessageOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Reactor@@MessageOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@reactor@@-message module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Reactor@@MessageOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/reactors/reactor.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Reactor@@Options } from "./@@reactor@@.options"
 
+const built = new ConfigurableModuleBuilder<@@Reactor@@Options>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Reactor@@Options, "register", "create", {}>
+
 /** The configurable-module base of the @@reactor@@ module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Reactor@@Options>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/realtime/channel.graphql.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Channel@@GraphqlOptions } from "./@@channel@@-graphql.options"
 
+const built = new ConfigurableModuleBuilder<@@Channel@@GraphqlOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Channel@@GraphqlOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@channel@@-graphql module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Channel@@GraphqlOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/realtime/channel.sse.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Channel@@SseOptions } from "./@@channel@@-sse.options"
 
+const built = new ConfigurableModuleBuilder<@@Channel@@SseOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Channel@@SseOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@channel@@-sse module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Channel@@SseOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/realtime/channel.websocket.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Channel@@WebsocketOptions } from "./@@channel@@-websocket.options"
 
+const built = new ConfigurableModuleBuilder<@@Channel@@WebsocketOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Channel@@WebsocketOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@channel@@-websocket module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Channel@@WebsocketOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/saga/saga.done.consumer.ts.tpl

@@ -8,7 +8,7 @@ import { Complete@@Saga@@Command } from "../../application/complete-@@saga@@.com
 @Injectable()
 /** Consumer of `@@from@@.@@done@@`, the last event of the @@saga@@ saga: hands each delivery to the complete command. */
 export class @@Done@@Consumer implements EventConsumer<@@Done@@Event> {
-    readonly event = @@Done@@Event
+    readonly event: typeof @@Done@@Event = @@Done@@Event
 
     constructor(@InjectCommandBus() private readonly commandBus: CommandBus) {}
 

package/templates/be/patterns/saga/saga.failed.consumer.ts.tpl

@@ -8,7 +8,7 @@ import { Compensate@@Saga@@Command } from "../../application/compensate-@@saga@@
 @Injectable()
 /** Consumer of `@@from@@.@@failed@@`, the failure event of the @@saga@@ saga: hands each delivery to the compensate command. */
 export class @@Failed@@Consumer implements EventConsumer<@@Failed@@Event> {
-    readonly event = @@Failed@@Event
+    readonly event: typeof @@Failed@@Event = @@Failed@@Event
 
     constructor(@InjectCommandBus() private readonly commandBus: CommandBus) {}
 

package/templates/be/patterns/saga/saga.message.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Saga@@MessageOptions } from "./@@saga@@-message.options"
 
+const built = new ConfigurableModuleBuilder<@@Saga@@MessageOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Saga@@MessageOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@saga@@-message module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Saga@@MessageOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/saga/saga.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Saga@@Options } from "./@@saga@@.options"
 
+const built = new ConfigurableModuleBuilder<@@Saga@@Options>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Saga@@Options, "register", "create", {}>
+
 /** The configurable-module base of the @@saga@@ module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Saga@@Options>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/patterns/webhooks/webhook.http.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Provider@@HttpOptions } from "./@@provider@@-http.options"
 
+const built = new ConfigurableModuleBuilder<@@Provider@@HttpOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Provider@@HttpOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@provider@@-http module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Provider@@HttpOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/platform/graphql/graphql.module-definition.ts

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { GraphqlOptions } from "./graphql.options"
 
-/** The configurable-module base of the graphql capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<GraphqlOptions>()
+const built = new ConfigurableModuleBuilder<GraphqlOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<GraphqlOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the graphql capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/features/api/system-health/system-health.module-definition.ts

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { SystemHealthOptions } from "./system-health.options"
 
+const built = new ConfigurableModuleBuilder<SystemHealthOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<SystemHealthOptions, "register", "create", {}>
+
 /** The configurable-module base of the system-health module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<SystemHealthOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/features/api/system-health/transport/http/system-health-http.module-definition.ts

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { SystemHealthHttpOptions } from "./system-health-http.options"
 
+const built = new ConfigurableModuleBuilder<SystemHealthHttpOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<SystemHealthHttpOptions, "register", "create", {}>
+
 /** The configurable-module base of the system-health-http module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<SystemHealthHttpOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/features/cli/cli.module-definition.ts

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { CliOptions } from "./cli.options"
 
+const built = new ConfigurableModuleBuilder<CliOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<CliOptions, "register", "create", {}>
+
 /** The configurable-module base of the cli module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<CliOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/features/cli/migrate/migrate.module-definition.ts

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { MigrateOptions } from "./migrate.options"
 
+const built = new ConfigurableModuleBuilder<MigrateOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<MigrateOptions, "register", "create", {}>
+
 /** The configurable-module base of the migrate module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<MigrateOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/features/cli/seed/seed.module-definition.ts

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { SeedOptions } from "./seed.options"
 
+const built = new ConfigurableModuleBuilder<SeedOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<SeedOptions, "register", "create", {}>
+
 /** The configurable-module base of the seed module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<SeedOptions>().setClassMethodName("register").build()
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/domain/identity/identity.module-definition.ts

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { IdentityOptions } from "./identity.options"
 
-/** The configurable-module base of the identity capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<IdentityOptions>()
+const built = new ConfigurableModuleBuilder<IdentityOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<IdentityOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the identity capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/domain/liveness/liveness.module-definition.ts

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { LivenessOptions } from "./liveness.options"
 
-/** The configurable-module base of the liveness capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<LivenessOptions>()
+const built = new ConfigurableModuleBuilder<LivenessOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<LivenessOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the liveness capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/domain/note/note.module-definition.ts

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { NoteOptions } from "./note.options"
 
-/** The configurable-module base of the note capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<NoteOptions>()
+const built = new ConfigurableModuleBuilder<NoteOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<NoteOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the note capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/domain/note/persistence/connection.ts

@@ -1,8 +1,9 @@
+import type { DatabaseConnectionOptions } from "@modules/platform/database"
 import { NoteEntity } from "./entities/note.entity"
 import { InitNote1790000000000 } from "./migrations/1790000000000-init-note"
 
 /** The entities of the note capability, for the connection that holds them. */
-export const noteEntities = [NoteEntity]
+export const noteEntities: DatabaseConnectionOptions["entities"] = [NoteEntity]
 
 /** The migrations of the note capability, in the order they run. */
-export const noteMigrations = [InitNote1790000000000]
+export const noteMigrations: DatabaseConnectionOptions["migrations"] = [InitNote1790000000000]

package/templates/be/skeleton/src/modules/domain/note/persistence/note.sql.ts

@@ -1,4 +1,5 @@
 import { sql } from "@modules/platform/database"
+import type { SqlText } from "@modules/platform/database"
 
 /** Writes one note ($1 body, $2 written at) and answers the stored row. */
-export const INSERT_NOTE = sql`INSERT INTO notes (body, created_at) VALUES ($1, $2) RETURNING id, body, created_at`
+export const INSERT_NOTE: SqlText = sql`INSERT INTO notes (body, created_at) VALUES ($1, $2) RETURNING id, body, created_at`

package/templates/be/skeleton/src/modules/platform/clock/clock.module-definition.ts

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { ClockOptions } from "./clock.options"
 
-/** The configurable-module base of the clock capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<ClockOptions>()
+const built = new ConfigurableModuleBuilder<ClockOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<ClockOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the clock capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/platform/cqrs/cqrs.module-definition.ts

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { CqrsOptions } from "./cqrs.options"
 
-/** The configurable-module base of the cqrs capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<CqrsOptions>()
+const built = new ConfigurableModuleBuilder<CqrsOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<CqrsOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the cqrs capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/platform/database/database.module-definition.ts

@@ -1,9 +1,8 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import { DATABASE_OPTIONS } from "./database.port"
 import type { DatabaseOptions } from "./database.options"
 
-/** The configurable-module base of the database capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<DatabaseOptions>({
+const built = new ConfigurableModuleBuilder<DatabaseOptions>({
     optionsInjectionToken: DATABASE_OPTIONS,
 })
     .setExtras({ isGlobal: false }, (definition, extras) => ({
@@ -11,3 +10,9 @@ export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleB
         global: extras.isGlobal,
     }))
     .build()
+type Host = ConfigurableModuleHost<DatabaseOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the database capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/platform/database/index.ts

@@ -6,6 +6,7 @@ export { DEFAULT_SEED_ENV } from "./seed-connections.client"
 export { SeedRunnerService } from "./seed-runner.service"
 export type { DatabaseConnectionConfig, DatabaseConnectionOptions } from "./database.options"
 export { LIST_ROWS_MAX, sql } from "./database.sql"
+export type { SqlText } from "./database.sql"
 export { DATABASE_ERROR_KINDS } from "./errors/database.error"
 export { returnedRows, rowShape } from "./returned-rows.policy"
 export { parsePrimaryDatabaseConfig } from "./primary.config"

package/templates/be/skeleton/src/modules/platform/errors/errors.module-definition.ts

@@ -1,9 +1,15 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import { ERRORS_OPTIONS } from "./errors.decorators"
 import type { ErrorsOptions } from "./errors.options"
 
-/** The configurable-module base of the errors capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<ErrorsOptions>({ optionsInjectionToken: ERRORS_OPTIONS })
+const built = new ConfigurableModuleBuilder<ErrorsOptions>({ optionsInjectionToken: ERRORS_OPTIONS })
         .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
         .build()
+type Host = ConfigurableModuleHost<ErrorsOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the errors capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The injection token of the registered options. */
+export const MODULE_OPTIONS_TOKEN: Host["MODULE_OPTIONS_TOKEN"] = built.MODULE_OPTIONS_TOKEN
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE

package/templates/be/skeleton/src/modules/platform/http/http.module-definition.ts

@@ -1,9 +1,13 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import { HTTP_OPTIONS } from "./http.decorators"
 import type { HttpOptions } from "./http.options"
 
-/** The configurable-module base of the http capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<HttpOptions>({ optionsInjectionToken: HTTP_OPTIONS })
+const built = new ConfigurableModuleBuilder<HttpOptions>({ optionsInjectionToken: HTTP_OPTIONS })
         .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
         .build()
+type Host = ConfigurableModuleHost<HttpOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the http capability; `isGlobal` is decided by the app root. */
+export const ConfigurableModuleClass: Host["ConfigurableModuleClass"] = built.ConfigurableModuleClass
+/** The options of a synchronous registration, for the register signature. */
+export const OPTIONS_TYPE: Host["OPTIONS_TYPE"] = built.OPTIONS_TYPE