@starci/hfs 5.2.0 → 5.4.0

package/templates/be/auth-lite/src/modules/domain/identity/sign-in.service.spec.ts

@@ -48,6 +48,23 @@ describe("IdentitySignInService", () => {
         expect(await subject.jwks()).toEqual({ keys: [] })
     })
 
+    it("signs the caller out of every other device, keeping the session of the token", async () => {
+        const { subject, sessions } = await build()
+        sessions.endOthers.mockResolvedValue()
+
+        await subject.endOthers({ id: "u-1", role: "authenticated", sessionId: "s-1" })
+
+        expect(sessions.endOthers).toHaveBeenCalledWith("u-1", "s-1")
+    })
+
+    it("refuses to sign out the other devices of a token that names no session", async () => {
+        const { subject, sessions } = await build()
+        sessions.endOthers.mockRejectedValue(new AuthError("IDENTITY_UNAUTHENTICATED"))
+
+        await expect(subject.endOthers({ id: "u-1", role: "authenticated" })).rejects.toMatchObject({ code: IdentityErrorCode.Unauthenticated })
+        expect(sessions.endOthers).toHaveBeenCalledWith("u-1", undefined)
+    })
+
     it("turns a refusal of the package into the error family that owns its code", async () => {
         const { subject, doors } = await build()
         doors.refresh.mockRejectedValue(new AuthError("IDENTITY_REFRESH_REUSED"))

package/templates/be/auth-lite/src/modules/domain/identity/sign-in.service.ts

@@ -1,6 +1,7 @@
 // Managed by starci app sync (slot be.identity.sign-in); do not edit: run "npx starci app sync --execute".
 import { Injectable } from "@nestjs/common"
 import { AuthError, PassportError, PassportErrorCode } from "@modules/integrations/passport"
+import type { Principal } from "@modules/platform/cqrs"
 import { IdentityError, IdentityErrorCode } from "./errors/identity.error"
 import { InjectAuthDoors, InjectAuthSessions } from "./identity.decorators"
 import type { AccessGrant, AuthDoors, AuthSessions, GoogleRedirect, HttpExchange, JwksDocument } from "@modules/integrations/passport"
@@ -71,6 +72,11 @@ export class IdentitySignInService {
         return this.refusing(() => this.doors.completeGoogle(exchange))
     }
 
+    /** Signs the person out of every other device; the session of the caller stays. */
+    endOthers(principal: Principal): Promise<void> {
+        return this.refusing(() => this.sessions.endOthers(principal.id, principal.sessionId))
+    }
+
     /** The public key document access tokens verify against. */
     jwks(): Promise<JwksDocument> {
         return this.refusing(() => this.sessions.jwks())

package/templates/be/auth-lite/src/tests/fixtures/builders/identity.builder.ts

@@ -1,44 +1,40 @@
 // Managed by starci app sync (slot be.identity.sign-in); do not edit: run "npx starci app sync --execute".
 const BEFORE = new Date("2026-02-03T04:00:00.000Z")
-const AFTER = new Date("2026-02-03T05:00:00.000Z")
 
-/** The kinds of account a sign-in spec needs. */
-export type AuthUserVariant = "live" | "banned" | "ban-ended" | "deleted" | "unconfirmed" | "addressless" | "passwordless" | "created"
+/** The kinds of account the sign-in reads by address. */
+export type AccountByEmailVariant = "live" | "disabled" | "unconfirmed" | "passwordless" | "invited"
 
-/** A row of auth.users as the sign-in reads it (the shape of AuthUserEntity). */
-export interface AuthUserRow {
+/** The kinds of account the sign-in reads by id. */
+export type AccountByIdVariant = "live" | "disabled" | "addressless"
+
+/** A row of the by-address door: `disabled` is what the database decided at its own now(). */
+export interface AccountByEmailRow {
     id: string
-    aud: string | null
-    role: string | null
-    email: string | null
-    encryptedPassword: string | null
-    emailConfirmedAt: Date | null
-    lastSignInAt: Date | null
-    bannedUntil: Date | null
-    deletedAt: Date | null
-    isAnonymous: boolean
-    createdAt: Date | null
-    updatedAt: Date | null
+    email: string
+    encrypted_password: string | null
+    email_confirmed_at: Date | null
+    disabled: boolean
 }
 
-/** Until when an account of this variant is banned, or null. */
-const bannedUntilOf = (variant: AuthUserVariant): Date | null => {
-    if (variant === "banned") return AFTER
-    return variant === "ban-ended" ? BEFORE : null
+/** A row of the by-id door. */
+export interface AccountByIdRow {
+    id: string
+    email: string | null
+    disabled: boolean
 }
 
-/** A confirmed, live password account of the given variant; \`created\` is the account the first Google sign-in makes (the first id the fake ids hand out). */
-export const authUserRow = (variant: AuthUserVariant = "live"): AuthUserRow => ({
-    id: variant === "created" ? "00000000-0000-4000-8000-000000000001" : "u-1",
-    aud: "authenticated",
-    role: "authenticated",
+/** The row the by-address door answers for a confirmed password account of the given variant. */
+export const accountByEmailRow = (variant: AccountByEmailVariant = "live"): AccountByEmailRow => ({
+    id: "u-1",
+    email: "a@example.test",
+    encrypted_password: variant === "passwordless" || variant === "invited" ? null : "hash",
+    email_confirmed_at: variant === "unconfirmed" || variant === "invited" ? null : BEFORE,
+    disabled: variant === "disabled",
+})
+
+/** The row the by-id door answers for the account of the given variant; `id` is the account the spec stands for. */
+export const accountByIdRow = (variant: AccountByIdVariant = "live", id = "u-1"): AccountByIdRow => ({
+    id,
     email: variant === "addressless" ? null : "a@example.test",
-    encryptedPassword: variant === "passwordless" || variant === "created" ? null : "hash",
-    emailConfirmedAt: variant === "unconfirmed" ? null : BEFORE,
-    lastSignInAt: null,
-    bannedUntil: bannedUntilOf(variant),
-    deletedAt: variant === "deleted" ? BEFORE : null,
-    isAnonymous: false,
-    createdAt: BEFORE,
-    updatedAt: BEFORE,
+    disabled: variant === "disabled",
 })

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import type { @@Provider@@InboxOptions } from "./@@provider@@-inbox.options"
 
-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
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<@@Provider@@InboxOptions>()

package/templates/be/inbox/platform/event-bus/event-bus.module-definition.ts.tpl

@@ -1,14 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import type { EventBusOptions } from "./event-bus.options"
 
-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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineCapabilityModule<EventBusOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import type { InboxOptions } from "./inbox.options"
 
-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
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<InboxOptions>()

package/templates/be/patterns/api/feature.module-definition.ts.tpl

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Feature@@ApiOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Feature@@GraphqlOptions>()

package/templates/be/patterns/cli/group.module-definition.ts.tpl

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<@@Group@@Options>()

package/templates/be/patterns/event-bus/platform/event-bus.module-definition.ts.tpl

@@ -1,15 +1,8 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import { EVENT_BUS_OPTIONS } from "./event-bus.decorators"
 import type { EventBusOptions } from "./event-bus.options"
 
-const built = new ConfigurableModuleBuilder<EventBusOptions>({
+/** The configurable-module base of the event bus; `isGlobal` is decided by the app root. */
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<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/idempotency/platform/inbox/inbox.module-definition.ts.tpl

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import type { InboxOptions } from "./inbox.options"
 
-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
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<InboxOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<@@Job@@Options>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Job@@QueueOptions>()

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

@@ -1,15 +1,8 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import { JOBS_OPTIONS } from "./jobs.decorators"
 import type { JobsOptions } from "./jobs.options"
 
-const built = new ConfigurableModuleBuilder<JobsOptions>({
+/** The configurable-module base of the jobs; `isGlobal` is decided by the app root. */
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<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/projections/projection.module-definition.ts.tpl

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import type { @@Name@@Options } from "./@@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
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<@@Name@@Options>()

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

@@ -1,15 +1,8 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import { QUEUE_OPTIONS } from "./queue.decorators"
 import type { QueueRegistrationOptions } from "./queue.options"
 
-const built = new ConfigurableModuleBuilder<QueueRegistrationOptions>({
+/** The configurable-module base of the queues; `isGlobal` is decided by the app root. */
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<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,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<@@Queue@@Options>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Reactor@@MessageOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<@@Reactor@@Options>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Channel@@GraphqlOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Channel@@SseOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Channel@@WebsocketOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Saga@@MessageOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<@@Saga@@Options>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<@@Provider@@HttpOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineCapabilityModule } from "@starci/nest-kit"
 import type { GraphqlOptions } from "./graphql.options"
 
-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
+export const { ConfigurableModuleClass, OPTIONS_TYPE } = defineCapabilityModule<GraphqlOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<SystemHealthOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<SystemHealthHttpOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<CliOptions>()

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

@@ -1,12 +1,6 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } =
+    defineConfigurableModule<MigrateOptions>()

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

@@ -1,12 +1,5 @@
-import { ConfigurableModuleBuilder, type ConfigurableModuleHost } from "@nestjs/common"
+import { defineConfigurableModule } from "@starci/nest-kit"
 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: 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
+export const { ConfigurableModuleClass, MODULE_OPTIONS_TOKEN, OPTIONS_TYPE } = defineConfigurableModule<SeedOptions>()