@starci/hfs 5.0.7 → 5.1.0

package/sync/ci-commands.mjs

@@ -179,7 +179,7 @@ function ciJobSettings(declaration, source) {
     };
 }
 /** An omitted quality declaration preserves hosted Sonar, required OIDC Codecov, and the high production dependency audit. */
-export function ciWorkflowCommands(source, lcovReport = 'be/coverage/lcov.info', quality = undefined, { nodeMajor = '22', app } = {}) {
+export function ciWorkflowCommands(source, lcovReport = 'be/coverage/lcov.info', quality = undefined, { nodeMajor = '22', app, packages = false } = {}) {
     const configuredSonar = quality === undefined ? { token: 'SONAR_TOKEN', hostVar: 'SONAR_HOST_URL' } : quality.sonar;
     const sonar = configuredSonar?.wiring === 'not-used' || configuredSonar?.mode === 'disabled' ? null : configuredSonar;
     const codecov = quality?.codecov ?? { enabled: true, auth: 'oidc' };
@@ -195,8 +195,6 @@ export function ciWorkflowCommands(source, lcovReport = 'be/coverage/lcov.info',
         shardCoverageReport: lcovReport.split('/').slice(0, -1).concat('coverage-final.json').join('/'),
         ciBuildEnv: build.env,
         ciBuildSteps: build.steps,
-        ciLint: exampleCommand(source, 'npm run lint'),
-        ciLintSonar: exampleCommand(source, 'npm run lint -- --out reports/lint.sonar.json'),
         // The coverage judgement alone over the merged report: the fast and lint jobs already ran every other rule of the app check.
         ciCoverageProof: exampleCommand(source, 'npx starci app coverage verify ' + lcovReport),
         // An app with an entity list also checks its entities against the schema its migrations build, in the build job (a runner with Docker).
@@ -205,23 +203,24 @@ export function ciWorkflowCommands(source, lcovReport = 'be/coverage/lcov.info',
         sonarTokenSecret: sonar?.token ?? 'SONAR_TOKEN',
         sonarHostVar: sonar?.hostVar ?? 'SONAR_HOST_URL',
         // One lint job per side (the lint matrix): with Sonar each side writes its own report, uploaded as sonar-lint-<side> and merged by the sonar job.
-        ciLintSteps: (sonar ? [
-            '      - name: lint with Sonar import',
-            `        run: ${exampleCommand(source, 'npm run lint -- --side ' + side + ' --out reports/lint.' + side + '.sonar.json')}`,
-            '        env:',
-            `          NODE_OPTIONS: ${settings.nodeOptions}`,
-            `      - uses: ${UPLOAD_ARTIFACT}`,
-            // Inside an if: expression the matrix value is an argument of format(), never a nested ${{ }} (actionlint: a nested expression makes the condition always true).
-            "        if: always() && hashFiles(format('reports/lint.{0}.sonar.json', matrix.side)) != ''",
-            '        with:',
-            `          name: sonar-lint-${side}`,
-            `          path: reports/lint.${side}.sonar.json`,
-        ] : [
-            '      - name: lint',
-            `        run: ${exampleCommand(source, 'npm run lint -- --side ' + side)}`,
-            '        env:',
-            `          NODE_OPTIONS: ${settings.nodeOptions}`,
-        ]).join('\n'),
+        // The typed lint reads the generated code and the types the fe packages declare (their dist), so both are built first, the way the root lint script does.
+        ciLintSteps: ['      - name: build the lint inputs', `        run: ${exampleCommand(source, packages ? 'npm run codegen --silent && npx --no-install turbo run build --filter=./fe/packages/*' : 'npm run codegen --silent')}`, ...(sonar ? [
+                '      - name: lint with Sonar import',
+                `        run: ${exampleCommand(source, 'npx --no-install starci app check --gate lint --side ' + side + ' --out reports/lint.' + side + '.sonar.json')}`,
+                '        env:',
+                `          NODE_OPTIONS: ${settings.nodeOptions}`,
+                `      - uses: ${UPLOAD_ARTIFACT}`,
+                // Inside an if: expression the matrix value is an argument of format(), never a nested ${{ }} (actionlint: a nested expression makes the condition always true).
+                "        if: always() && hashFiles(format('reports/lint.{0}.sonar.json', matrix.side)) != ''",
+                '        with:',
+                `          name: sonar-lint-${side}`,
+                `          path: reports/lint.${side}.sonar.json`,
+            ] : [
+                '      - name: lint',
+                `        run: ${exampleCommand(source, 'npx --no-install starci app check --gate lint --side ' + side)}`,
+                '        env:',
+                `          NODE_OPTIONS: ${settings.nodeOptions}`,
+            ])].join('\n'),
         codecovSteps: codecovSteps(lcovReport, codecov),
         verdictSonarNeed: sonar ? ', sonar' : '',
         verdictSonarCheck: sonar ? `\n          if [[ "$FULL" == true && "$CHECKS" == true ]]; then expect sonar success; else expect sonar idle; fi` : '',

package/sync/index.mjs

@@ -404,7 +404,7 @@ export function variables(app, scope, presets, sonarKey, manifest = loadSlotMani
         buildFe: 'npm run codegen --silent && turbo run build --filter=./fe/apps/*',
         // The be side with its tsc; every fe workspace with its own typecheck script through turbo (the packages are built first: ^build).
         typecheck: 'npm run codegen --silent && tsc -p be/tsconfig.json && turbo run typecheck',
-        // The typed lint reads the types the fe packages declare (their dist, turbo.json: lint dependsOn ^build), so the packages are built first.
+        // The typed lint reads the types the fe packages declare (their dist), so the packages are built first.
         lintPrefix: packages ? 'npm run codegen --silent && turbo run build --filter=./fe/packages/* && ' : 'npm run codegen --silent && ',
         nodeMajor: String(NODE_MAJOR),
         // The deploy server's age identity the restore workflow writes (stack/server-key.mjs owns the path).
@@ -418,7 +418,7 @@ export function variables(app, scope, presets, sonarKey, manifest = loadSlotMani
         sonarSources: ['be/apps', 'be/src', 'fe/apps', ...(packages ? ['fe/packages'] : [])].join(','),
         lcovReport: LCOV_REPORT,
         cpdExclusions: SONAR_CPD_EXCLUSIONS.join(','),
-        ...ciWorkflowCommands(source, LCOV_REPORT, source.qualityDeclared === false ? undefined : source.quality, { app }),
+        ...ciWorkflowCommands(source, LCOV_REPORT, source.qualityDeclared === false ? undefined : source.quality, { app, packages }),
         // The coverage scope is the same in both editions: lite measures exactly what full measures (ruling:R212/case-1, amended by ruling:R212/case-4).
         jestCoverage: scope === 'be' ? jestCoverageSource(jestCoverage(manifest, providers)) : '',
         coverageExclusions: scope === APP_SCOPE ? sonarCoverageExclusions(manifest, providers).join(',') : '',

package/templates/app/package-scripts/core.json

@@ -3,7 +3,7 @@
     "codegen": "node scripts/codegen.mjs",
     "codegen:graphql": "node scripts/codegen.mjs --graphql",
     "typecheck": "{{typecheck}}",
-    "lint": "{{lintPrefix}}{{appBinary}} lint",
-    "lint:fix": "{{lintPrefix}}{{appBinary}} lint --fix",
+    "lint": "{{lintPrefix}}{{appBinary}} check --gate lint",
+    "lint:fix": "{{lintPrefix}}{{appBinary}} check --gate lint --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",

package/templates/app/task-graph/turbo.json

@@ -13,9 +13,6 @@
       "cache": false,
       "persistent": true
     },
-    "lint": {
-      "dependsOn": ["^build"]
-    },
     "typecheck": {
       "dependsOn": ["^build"]
     }

package/templates/be/inbox/delivery-recorded.event.ts.tpl

@@ -10,10 +10,10 @@ export interface @@Provider@@DeliveryRecordedPayload {
 
 /** Version 1 of `@@provider@@.delivery-recorded`, published once by the provider inbox intake. */
 export class @@Provider@@DeliveryRecordedEvent extends BaseEvent {
-    static readonly eventName = "@@provider@@.delivery-recorded"
+    static readonly eventName: string = "@@provider@@.delivery-recorded"
     static readonly version = 1
 
-    readonly eventName = @@Provider@@DeliveryRecordedEvent.eventName
+    readonly eventName: string = @@Provider@@DeliveryRecordedEvent.eventName
 
     private constructor(
         readonly eventId: string,

package/templates/be/inbox/entities.index.ts.tpl

@@ -1,4 +1,4 @@
 import { @@Provider@@InboxEntity } from "./@@provider@@-inbox.entity"
 
 /** The entities of the @@provider@@-inbox capability, named in PRIMARY_ENTITIES of platform/database/entities.ts. */
-export const @@providerCamel@@InboxEntities = [@@Provider@@InboxEntity]
+export const @@providerCamel@@InboxEntities: ReadonlyArray<typeof @@Provider@@InboxEntity> = [@@Provider@@InboxEntity]

package/templates/be/inbox/module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Provider@@InboxOptions } from "./@@provider@@-inbox.options"
 
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<@@Provider@@InboxOptions>()
+const built = new ConfigurableModuleBuilder<@@Provider@@InboxOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<@@Provider@@InboxOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module class the module extends. */
+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/inbox/platform/event-bus/event-bus.module-definition.ts.tpl

@@ -1,6 +1,14 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { EventBusOptions } from "./event-bus.options"
 
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = new ConfigurableModuleBuilder<EventBusOptions>()
+const built = new ConfigurableModuleBuilder<EventBusOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<EventBusOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module class the module extends. */
+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/inbox/platform/inbox/inbox.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { InboxOptions } from "./inbox.options"
 
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<InboxOptions>()
+const built = new ConfigurableModuleBuilder<InboxOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<InboxOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module class the module extends. */
+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/api/feature.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Feature@@ApiOptions } from "./@@feature@@.options"
 
+const built = new ConfigurableModuleBuilder<@@Feature@@ApiOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Feature@@ApiOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@feature@@ module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Feature@@ApiOptions>().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/api/graphql.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Feature@@GraphqlOptions } from "./@@feature@@-graphql.options"
 
+const built = new ConfigurableModuleBuilder<@@Feature@@GraphqlOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Feature@@GraphqlOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@feature@@-graphql module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Feature@@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/cli/group.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Group@@Options } from "./@@group@@.options"
 
+const built = new ConfigurableModuleBuilder<@@Group@@Options>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Group@@Options, "register", "create", {}>
+
 /** The configurable-module base of the @@group@@ module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Group@@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/event-bus/platform/event-bus.module-definition.ts.tpl

@@ -1,10 +1,15 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import { EVENT_BUS_OPTIONS } from "./event-bus.decorators"
 import type { EventBusOptions } from "./event-bus.options"
 
-/** The configurable-module base of the event bus; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<EventBusOptions>({
+const built = new ConfigurableModuleBuilder<EventBusOptions>({
     optionsInjectionToken: EVENT_BUS_OPTIONS,
 })
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<EventBusOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the event bus; `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/event-bus/platform/persistence/connection.ts.tpl

@@ -1,8 +1,9 @@
+import type { DatabaseConnectionOptions } from "@modules/platform/database"
 import { EventOutboxEntity } from "./entities/event-outbox.entity"
 import { CreateEventOutbox@@epochMs13@@ } from "./migrations/@@epochMs13@@-create-event-outbox"
 
 /** The entities of the event bus, for every connection that publishes events. */
-export const eventBusEntities = [EventOutboxEntity]
+export const eventBusEntities: DatabaseConnectionOptions["entities"] = [EventOutboxEntity]
 
 /** The migrations of the event bus, in the order they run. */
-export const eventBusMigrations = [CreateEventOutbox@@epochMs13@@]
+export const eventBusMigrations: DatabaseConnectionOptions["migrations"] = [CreateEventOutbox@@epochMs13@@]

package/templates/be/patterns/event-bus/platform/persistence/event-bus.sql.ts.tpl

@@ -1,12 +1,13 @@
 import { sql } from "@modules/platform/database"
+import type { SqlText } from "@modules/platform/database"
 
 /** Writes one event in the outbox ($1 event id, $2 event name, $3 topic, $4 key, $5 envelope, $6 instant, $7 correlation id). */
-export const INSERT_OUTBOX_ROW = sql`INSERT INTO event_outbox (event_id, event_name, topic, message_key, envelope, created_at, correlation_id)
+export const INSERT_OUTBOX_ROW: SqlText = sql`INSERT INTO event_outbox (event_id, event_name, topic, message_key, envelope, created_at, correlation_id)
     VALUES ($1, $2, $3, $4, $5, $6, $7)`
 
 /** 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, topic, message_key, envelope, correlation_id FROM event_outbox
+export const SELECT_WAITING_ROWS: SqlText = sql`SELECT id, topic, message_key, envelope, correlation_id FROM event_outbox
     WHERE sent_at IS NULL ORDER BY id LIMIT $1 FOR UPDATE SKIP LOCKED`
 
 /** Marks the rows as handed to the broker ($1 ids, $2 instant). */
-export const MARK_ROWS_SENT = sql`UPDATE event_outbox SET sent_at = $2 WHERE id = ANY($1::bigint[])`
+export const MARK_ROWS_SENT: SqlText = sql`UPDATE event_outbox SET sent_at = $2 WHERE id = ANY($1::bigint[])`

package/templates/be/patterns/idempotency/platform/inbox/inbox.module-definition.ts.tpl

@@ -1,7 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { InboxOptions } from "./inbox.options"
 
-/** The configurable-module base of the inbox capability; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<InboxOptions>()
+const built = new ConfigurableModuleBuilder<InboxOptions>()
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<InboxOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the inbox 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/patterns/idempotency/platform/inbox/persistence/connection.ts.tpl

@@ -1,9 +1,10 @@
+import type { DatabaseConnectionOptions } from "@modules/platform/database"
 import { InboxClaimEntity } from "./entities/inbox-claim.entity"
 import { CreateInboxClaims1789800005000 } from "./migrations/1789800005000-create-inbox-claims"
 import { ClientOperationOutcomes1792800000000 } from "./migrations/1792800000000-client-operation-outcomes"
 
 /** The entities of the inbox capability, for the connection that holds them. */
-export const inboxEntities = [InboxClaimEntity]
+export const inboxEntities: DatabaseConnectionOptions["entities"] = [InboxClaimEntity]
 
 /** The migrations of the inbox capability, in the order they run. */
-export const inboxMigrations = [CreateInboxClaims1789800005000, ClientOperationOutcomes1792800000000]
+export const inboxMigrations: DatabaseConnectionOptions["migrations"] = [CreateInboxClaims1789800005000, ClientOperationOutcomes1792800000000]

package/templates/be/patterns/idempotency/platform/inbox/persistence/inbox.sql.ts.tpl

@@ -1,20 +1,21 @@
 import { sql } from "@modules/platform/database"
+import type { SqlText } from "@modules/platform/database"
 
 /** Claims the event ($1 source, $2 event id, $3 instant); answers one row when this call won and none when it was claimed before. */
-export const CLAIM_EVENT = sql`INSERT INTO inbox_claims (source, event_id, claimed_at) VALUES ($1, $2, $3)
+export const CLAIM_EVENT: SqlText = sql`INSERT INTO inbox_claims (source, event_id, claimed_at) VALUES ($1, $2, $3)
     ON CONFLICT (source, event_id) DO NOTHING RETURNING event_id`
 
 /** Gives a delivery claim back; client outcomes can expire only through the retention API. */
-export const RELEASE_EVENT = sql`DELETE FROM inbox_claims WHERE source = $1 AND event_id = $2 AND request_fingerprint IS NULL`
+export const RELEASE_EVENT: SqlText = sql`DELETE FROM inbox_claims WHERE source = $1 AND event_id = $2 AND request_fingerprint IS NULL`
 
 /** A conflicting insert locks the existing row and returns its committed fingerprint and outcome after the winner commits. */
-export const CLAIM_CLIENT = sql`INSERT INTO inbox_claims (source, event_id, request_fingerprint, claimed_at)
+export const CLAIM_CLIENT: SqlText = sql`INSERT INTO inbox_claims (source, event_id, request_fingerprint, claimed_at)
 VALUES ($1, $2, $3, $4)
 ON CONFLICT (source, event_id) DO UPDATE SET outcome = COALESCE(inbox_claims.outcome, '{}'::jsonb)
 RETURNING request_fingerprint, outcome, (outcome IS NOT NULL AND (jsonb_typeof(outcome) <> 'object' OR NOT (outcome ? 'value'))) AS incomplete`
 
 /** The JSON envelope distinguishes a completed null result from an uncompleted claim in this transaction. */
-export const SAVE_CLIENT_OUTCOME = sql`WITH saved AS (
+export const SAVE_CLIENT_OUTCOME: SqlText = sql`WITH saved AS (
     UPDATE inbox_claims SET outcome = $3::jsonb
     WHERE source = $1 AND event_id = $2
     RETURNING outcome
@@ -22,7 +23,7 @@ export const SAVE_CLIENT_OUTCOME = sql`WITH saved AS (
 SELECT outcome FROM saved LIMIT 1`
 
 /** Retention never deletes delivery rows or an incomplete claim; its bounded batch skips rows held by active retries. */
-export const SWEEP_CLIENTS = sql`WITH expired AS (
+export const SWEEP_CLIENTS: SqlText = sql`WITH expired AS (
     SELECT source, event_id FROM inbox_claims
     WHERE source LIKE 'client:%' AND request_fingerprint IS NOT NULL AND outcome IS NOT NULL AND jsonb_typeof(outcome) = 'object' AND outcome ? 'value' AND claimed_at < $1
     ORDER BY claimed_at, source, event_id LIMIT $2 FOR UPDATE SKIP LOCKED
@@ -34,6 +35,6 @@ RETURNING claims.event_id
 SELECT count(*)::int AS deleted_count FROM deleted`
 
 /** Imports an already completed legacy operation without replacing a key another migration has already transferred. */
-export const BACKFILL_CLIENT_OUTCOME = sql`INSERT INTO inbox_claims (source, event_id, request_fingerprint, claimed_at, outcome)
+export const BACKFILL_CLIENT_OUTCOME: SqlText = sql`INSERT INTO inbox_claims (source, event_id, request_fingerprint, claimed_at, outcome)
 VALUES ($1, $2, $3, $4, $5::jsonb)
 ON CONFLICT (source, event_id) DO NOTHING`

package/templates/be/patterns/jobs/job.module-definition.ts.tpl

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Job@@Options } from "./@@job@@.options"
 
+const built = new ConfigurableModuleBuilder<@@Job@@Options>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Job@@Options, "register", "create", {}>
+
 /** The configurable-module base of the @@job@@ module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Job@@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/jobs/job.processor.ts.tpl

@@ -7,7 +7,7 @@ import { @@Step@@Step } from "../../steps/@@step@@.step"
 @Injectable()
 /** The processor of the @@job@@ job: the runner claims and settles, `process` runs the steps in order. */
 export class @@Job@@Processor extends FencedProcessor {
-    readonly queue = @@jobUpper@@_QUEUE
+    readonly queue: string = @@jobUpper@@_QUEUE
 
     constructor(private readonly @@stepCamel@@Step: @@Step@@Step) {
         super()

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

@@ -1,6 +1,12 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import type { @@Job@@QueueOptions } from "./@@job@@-queue.options"
 
+const built = new ConfigurableModuleBuilder<@@Job@@QueueOptions>().setClassMethodName("register").build()
+type Host = ConfigurableModuleHost<@@Job@@QueueOptions, "register", "create", {}>
+
 /** The configurable-module base of the @@job@@-queue module. */
-export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
-    new ConfigurableModuleBuilder<@@Job@@QueueOptions>().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/jobs/platform/jobs.module-definition.ts.tpl

@@ -1,10 +1,15 @@
-import { ConfigurableModuleBuilder } from "@nestjs/common"
+import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
 import { JOBS_OPTIONS } from "./jobs.decorators"
 import type { JobsOptions } from "./jobs.options"
 
-/** The configurable-module base of the jobs; `isGlobal` is decided by the app root. */
-export const { ConfigurableModuleClass, OPTIONS_TYPE } = new ConfigurableModuleBuilder<JobsOptions>({
+const built = new ConfigurableModuleBuilder<JobsOptions>({
     optionsInjectionToken: JOBS_OPTIONS,
 })
     .setExtras({ isGlobal: false }, (definition, extras) => ({ ...definition, global: extras.isGlobal }))
     .build()
+type Host = ConfigurableModuleHost<JobsOptions, "register", "create", { isGlobal: boolean }>
+
+/** The configurable-module base of the jobs; `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/jobs/platform/persistence.connection.ts.tpl

@@ -1,8 +1,9 @@
+import type { DatabaseConnectionOptions } from "@modules/platform/database"
 import { JobEntity } from "./entities/job.entity"
 import { CreateJobs@@epochMs13@@ } from "./migrations/@@epochMs13@@-create-jobs"
 
 /** The entities of the jobs, for every connection that runs jobs. */
-export const jobsEntities = [JobEntity]
+export const jobsEntities: DatabaseConnectionOptions["entities"] = [JobEntity]
 
 /** The migrations of the jobs, in the order they run. */
-export const jobsMigrations = [CreateJobs@@epochMs13@@]
+export const jobsMigrations: DatabaseConnectionOptions["migrations"] = [CreateJobs@@epochMs13@@]

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