ddd-ts-kit 0.0.0-stage → 0.1.0

package/dist/workspace/workspace.d.ts

@@ -0,0 +1,33 @@
+import type { NextStep } from './next-step.js';
+import type { WorkspaceReport } from './workspace-report.js';
+/**
+ * Every generator writes through this overlay, so a command either lands as a whole
+ * plan or (with --dry-run) not at all, and later steps see the files of earlier ones.
+ */
+export declare class Workspace {
+    readonly root: string;
+    private readonly force;
+    readonly notes: string[];
+    private readonly pending;
+    private readonly skipped;
+    private readonly steps;
+    constructor(root: string, force: boolean);
+    exists(file: string): boolean;
+    read(file: string): string | undefined;
+    /** Names of the files directly inside `directory`, on disk or planned. */
+    list(directory: string): string[];
+    /** Names of the directories directly inside `directory`, on disk or planned. */
+    directories(directory: string): string[];
+    /** Never replaces a file the user may have edited, unless asked to with --force. */
+    create(file: string, content: string): boolean;
+    update(file: string, content: string): void;
+    note(message: string): void;
+    /** Points the team at a line of a file this command changed, the way a `TODO(domain)` of a created file does. */
+    step(step: NextStep): void;
+    commit(dryRun: boolean): WorkspaceReport;
+    private located;
+    private onDisk;
+    private write;
+    private absolute;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D;;;GAGG;AACH,qBAAa,SAAS;IAUlB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVxB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAExC,YACW,IAAI,EAAE,MAAM,EACJ,KAAK,EAAE,OAAO,EAC7B;IAEJ,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5B;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYrC;IAED,0EAA0E;IAC1E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAMhC;IAED,gFAAgF;IAChF,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvC;IAED,oFAAoF;IACpF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAc7C;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAc1C;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1B;IAED,iHAAiH;IACjH,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAIzB;IAED,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAwBvC;IAED,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/workspace/workspace.js

@@ -0,0 +1,131 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { todosIn } from './todos-in.js';
+/**
+ * Every generator writes through this overlay, so a command either lands as a whole
+ * plan or (with --dry-run) not at all, and later steps see the files of earlier ones.
+ */
+export class Workspace {
+    root;
+    force;
+    notes = [];
+    pending = new Map();
+    skipped = new Set();
+    steps = [];
+    constructor(root, force) {
+        this.root = root;
+        this.force = force;
+    }
+    exists(file) {
+        return this.pending.has(file) || fs.existsSync(this.absolute(file));
+    }
+    read(file) {
+        const pending = this.pending.get(file);
+        if (pending !== undefined) {
+            return pending.content;
+        }
+        try {
+            return fs.readFileSync(this.absolute(file), 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Names of the files directly inside `directory`, on disk or planned. */
+    list(directory) {
+        const planned = [...this.pending.keys()]
+            .filter((file) => path.posix.dirname(file) === directory)
+            .map((file) => path.posix.basename(file));
+        return [...new Set([...this.onDisk(directory, (entry) => entry.isFile()), ...planned])].sort();
+    }
+    /** Names of the directories directly inside `directory`, on disk or planned. */
+    directories(directory) {
+        const prefix = `${directory}/`;
+        const planned = [...this.pending.keys()].flatMap((file) => {
+            const [child, ...rest] = file.startsWith(prefix) ? file.slice(prefix.length).split('/') : [];
+            return child !== undefined && rest.length > 0 ? [child] : [];
+        });
+        return [...new Set([...this.onDisk(directory, (entry) => entry.isDirectory()), ...planned])].sort();
+    }
+    /** Never replaces a file the user may have edited, unless asked to with --force. */
+    create(file, content) {
+        const onDisk = fs.existsSync(this.absolute(file));
+        if ((onDisk || this.pending.has(file)) && !this.force) {
+            if (onDisk) {
+                this.skipped.add(file);
+            }
+            return false;
+        }
+        this.pending.set(file, { content, existed: onDisk });
+        return true;
+    }
+    update(file, content) {
+        const pending = this.pending.get(file);
+        if (pending !== undefined) {
+            pending.content = content;
+            return;
+        }
+        if (this.read(file) === content) {
+            return;
+        }
+        this.pending.set(file, { content, existed: true });
+    }
+    note(message) {
+        if (!this.notes.includes(message)) {
+            this.notes.push(message);
+        }
+    }
+    /** Points the team at a line of a file this command changed, the way a `TODO(domain)` of a created file does. */
+    step(step) {
+        if (!this.steps.some((known) => known.file === step.file && known.text === step.text)) {
+            this.steps.push(step);
+        }
+    }
+    commit(dryRun) {
+        const written = [...this.pending].map(([file, { content, existed }]) => ({ file, content, existed }));
+        const left = written
+            .filter(({ existed }) => !existed || this.force)
+            .flatMap(({ file, content }) => todosIn(file, content));
+        const todos = [...left, ...this.steps.map((step) => this.located(step))];
+        if (!dryRun) {
+            written.forEach(({ file, content }) => this.write(file, content));
+        }
+        // The language comes before the code: its definition is the first thing to do.
+        todos.sort((left, right) => Number(isLanguageStep(right)) - Number(isLanguageStep(left)));
+        return {
+            created: written.filter(({ existed }) => !existed).map(({ file }) => file),
+            updated: written.filter(({ existed }) => existed).map(({ file }) => file),
+            skipped: [...this.skipped].sort(),
+            next: todos.map((todo) => `${todo.file}:${todo.line}`),
+            todos,
+            notes: this.notes,
+        };
+    }
+    located({ file, anchor, text }) {
+        const at = (this.read(file) ?? '').split('\n').findIndex((line) => line.includes(anchor));
+        return { file, line: Math.max(at, 0) + 1, text };
+    }
+    onDisk(directory, wanted) {
+        try {
+            return fs
+                .readdirSync(this.absolute(directory), { withFileTypes: true })
+                .filter(wanted)
+                .map((entry) => entry.name);
+        }
+        catch {
+            // A directory that does not exist yet simply holds nothing on disk.
+            return [];
+        }
+    }
+    write(file, content) {
+        fs.mkdirSync(path.dirname(this.absolute(file)), { recursive: true });
+        fs.writeFileSync(this.absolute(file), content);
+    }
+    absolute(file) {
+        return path.join(this.root, file);
+    }
+}
+function isLanguageStep(todo) {
+    return todo.text.startsWith('define the ubiquitous language first');
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/workspace/workspace.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "ddd-ts-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Bootstrap, scaffold and verify DDD and Clean Architecture TypeScript projects.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/cli#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "bin": {
+    "ddd-ts-kit": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean:self": "node dist/bin.js check --clean-only src test",
+    "clean:packages": "node dist/bin.js check --clean-only ../kernel/src ../validation/src ../http/src ../tracing/src ../di/src ../events/src ../testing/src ../drizzle/src ../knex/src ../prisma/src ../typeorm/src ../aspects/src ../rabbitmq/src ../auth/src ../audit/src ../redis/src ../scheduling/src ../pino/src ../winston/src ../sentry/src ../kafka/src ../nats/src ../eslint-plugin/src"
+  },
+  "devDependencies": {
+    "@ddd-ts-kit/kernel": "^0.1.0"
+  }
+}

package/templates/acl/translator.spec.ts.tpl

@@ -0,0 +1,12 @@
+import { describe, expect, it } from '{{tests.module}}';
+import { {{name.pascal}}Translator } from '{{alias.context}}/infrastructure/anti-corruption/{{name.kebab}}.translator.js';
+
+describe('Translating the model of {{name.title}}', () => {
+  it('produces a record of {{context.kebab}}', () => {
+    expect(new {{name.pascal}}Translator().translate({})).toBeDefined();
+  });
+
+  // TODO(domain): replace each entry below by a test with a real sample received from {{name.title}}.
+  it.todo('maps every field to the vocabulary of {{context.kebab}}');
+  it.todo('refuses a record the model of {{context.kebab}} cannot express');
+});

package/templates/acl/translator.ts.tpl

@@ -0,0 +1,14 @@
+export interface {{name.pascal}}Record {
+  // TODO(domain): declare the fields received from {{name.title}}, exactly as they arrive (its names, its formats).
+}
+
+export interface Translated{{name.pascal}}Record {
+  // TODO(domain): replace this type by the value object, command or read model of {{context.kebab}} the record becomes; nothing of the vocabulary of {{name.title}} may appear in it.
+}
+
+export class {{name.pascal}}Translator {
+  translate(record: {{name.pascal}}Record): Translated{{name.pascal}}Record {
+    // TODO(domain): map each field to the model of {{context.kebab}}, convert units and codes, and throw when {{name.title}} sends something this model cannot express.
+    return {};
+  }
+}

package/templates/adapter/adapter.declared.ts.tpl

@@ -0,0 +1,46 @@
+{{#unless adapter.decorated}}
+import { retry, timeout } from '@ddd-ts-kit/aspects';
+{{/unless}}
+{{#if adapter.decorated}}
+import { Retry, Timeout } from '@ddd-ts-kit/aspects/decorators';
+{{/if}}
+import { {{adapter.decorator}} } from '@ddd-ts-kit/kernel/declarations';
+import { {{name.pascal}} } from '{{alias.context}}/application/ports/{{name.kebab}}.port.js';
+import { ownPolicy } from '{{alias.platform}}/resilience/own-policy.js';
+
+interface OutboundCall {
+  readonly operation: string;
+  readonly payload: unknown;
+}
+
+{{#if adapter.decorated}}
+@{{adapter.decorator}}({{name.pascal}}, { {{adapter.kindOption}}aspects: [ownPolicy()] })
+{{/if}}
+{{#unless adapter.decorated}}
+@{{adapter.decorator}}({{name.pascal}}, {
+  {{#if adapter.hasKind}}
+  kind: '{{adapter.kind}}',
+  {{/if}}
+  aspects: [ownPolicy(retry({ attempts: 3, backoff: { baseMs: 100 } }), timeout(2000))],
+})
+{{/unless}}
+export class Remote{{name.pascal}} implements {{name.pascal}} {
+  {{#if adapter.decorated}}
+  // TODO(domain): implement each operation of {{name.pascal}} by sending one call through `this.send` and translating the answer into the types of {{context.kebab}}; the policy of this adapter is part of its definition and is carried by `send` alone.
+  @Retry({ attempts: 3, backoff: { baseMs: 100 } })
+  @Timeout(2000, { signal: true })
+  async send(call: OutboundCall, signal?: AbortSignal): Promise<unknown> {
+    return this.transport(call, signal);
+  }
+  {{/if}}
+  {{#unless adapter.decorated}}
+  // TODO(domain): implement each operation of {{name.pascal}} by sending one call through `this.transport` and translating the answer into the types of {{context.kebab}}; declare each one `async`, so that the policy stated in the declaration applies from its first call.
+  {{/unless}}
+
+  // TODO(platform): replace the body by the real client of the outside system (fetch on a base URL of the validated config, an SDK): type what it needs by an abstract class of application/ports (its settings), bind that class in the platform module and name it in the dependency list of the declaration.
+  protected async transport(call: OutboundCall, signal?: AbortSignal): Promise<unknown> {
+    signal?.throwIfAborted();
+
+    throw new Error(`Remote{{name.pascal}} has no transport yet: "${call.operation}" was not sent`);
+  }
+}

package/templates/adapter/adapter.spec.ts.tpl

@@ -0,0 +1,58 @@
+import { describe, expect, it } from '{{tests.module}}';
+{{#if adapter.decorated}}
+import { createAspectFakes, withAspectRuntime } from '@ddd-ts-kit/aspects/testing';
+{{/if}}
+import { Remote{{name.pascal}} } from '{{alias.context}}/infrastructure/external/{{adapter.file}}.js';
+{{#if adapter.decorated}}
+
+class Flaky{{name.pascal}} extends Remote{{name.pascal}} {
+  calls = 0;
+
+  protected override async transport(): Promise<unknown> {
+    this.calls += 1;
+
+    if (this.calls === 1) {
+      throw new Error('unreachable');
+    }
+
+    return 'answered';
+  }
+}
+{{/if}}
+
+class Unwired{{name.pascal}} extends Remote{{name.pascal}} {
+  async sendUnwired(operation: string): Promise<unknown> {
+    return this.transport({ operation, payload: {} });
+  }
+}
+
+describe('Remote{{name.pascal}}', () => {
+  {{#if adapter.decorated}}
+  it('sends again a call the outside system failed, and answers once it succeeds', async () => {
+    const fakes = createAspectFakes();
+    const adapter = new Flaky{{name.pascal}}();
+    const pending = withAspectRuntime(fakes, () => adapter.send({ operation: 'ping', payload: {} }));
+
+    await new Promise((resolve) => setImmediate(resolve));
+    fakes.scheduler.advance(30_000);
+
+    expect(await pending).toBe('answered');
+    expect(adapter.calls).toBe(2);
+  });
+  {{/if}}
+  {{#unless adapter.decorated}}
+  it('is an adapter of the port, built without argument until its transport is written', () => {
+    expect(new Remote{{name.pascal}}()).toBeInstanceOf(Remote{{name.pascal}});
+  });
+  {{/unless}}
+
+  it('refuses to send a call as long as its transport is not written, and names the operation', async () => {
+    const adapter = new Unwired{{name.pascal}}();
+
+    await expect(adapter.sendUnwired('ping')).rejects.toThrow('"ping" was not sent');
+  });
+
+  // TODO(domain): replace each entry below by a behaviour of {{name.pascal}} against the real outside system or its sandbox; hold this adapter and the fake of test/fakes to the same expectations.
+  it.todo('answers what the outside system answers, in the types of {{context.kebab}}');
+  it.todo('fails with a business error when the outside system refuses');
+});

package/templates/adapter/adapter.ts.tpl

@@ -0,0 +1,30 @@
+{{#if adapter.decorated}}
+import { Retry, Timeout } from '@ddd-ts-kit/aspects/decorators';
+{{/if}}
+import type { {{name.pascal}} } from '{{alias.context}}/application/ports/{{name.kebab}}.port.js';
+
+interface OutboundCall {
+  readonly operation: string;
+  readonly payload: unknown;
+}
+
+export class Remote{{name.pascal}} implements {{name.pascal}} {
+  {{#if adapter.decorated}}
+  // TODO(domain): implement each operation of {{name.pascal}} by sending one call through `this.send` and translating the answer into the types of {{context.kebab}}; the policy of this adapter is part of its definition and is carried by `send` alone.
+  @Retry({ attempts: 3, backoff: { baseMs: 100 } })
+  @Timeout(2000, { signal: true })
+  async send(call: OutboundCall, signal?: AbortSignal): Promise<unknown> {
+    return this.transport(call, signal);
+  }
+  {{/if}}
+  {{#unless adapter.decorated}}
+  // TODO(domain): implement each operation of {{name.pascal}} by sending one call through `this.transport` and translating the answer into the types of {{context.kebab}}; declare each one `async`, so that the policy attached in {{context.kebab}}.module.ts applies from its first call.
+  {{/unless}}
+
+  // TODO(platform): replace the body by the real client of the outside system (fetch on a base URL of the validated config, an SDK), built from what the constructor receives in {{context.kebab}}.module.ts.
+  protected async transport(call: OutboundCall, signal?: AbortSignal): Promise<unknown> {
+    signal?.throwIfAborted();
+
+    throw new Error(`Remote{{name.pascal}} has no transport yet: "${call.operation}" was not sent`);
+  }
+}

package/templates/adapter/wiring.tsyringe.tpl

@@ -0,0 +1,18 @@
+@@imports
+{{#unless adapter.decorated}}
+import { retry, timeout } from '@ddd-ts-kit/aspects';
+{{/unless}}
+import { ownPolicy } from '{{alias.platform}}/resilience/own-policy.js';
+import { {{name.pascal}} } from '{{alias.context}}/application/ports/{{name.kebab}}.port.js';
+import { Remote{{name.pascal}} } from '{{alias.context}}/infrastructure/external/remote-{{name.kebab}}.adapter.js';
+@@registrations
+{{#if adapter.decorated}}
+builder.bind({{name.pascal}}).toClass(Remote{{name.pascal}}).as('{{adapter.kind}}').with(ownPolicy());
+{{/if}}
+{{#unless adapter.decorated}}
+builder
+  .bind({{name.pascal}})
+  .toClass(Remote{{name.pascal}})
+  .as('{{adapter.kind}}')
+  .with(ownPolicy(retry({ attempts: 3, backoff: { baseMs: 100 } }), timeout(2000)));
+{{/unless}}

package/templates/adr/adr.md.tpl

@@ -0,0 +1,37 @@
+# ADR-{{adr.number}}: {{adr.title}}
+
+- Status: proposed
+- Date: {{adr.date}}
+{{#if adr.deviation}}
+- Deviates from: `{{adr.what}}`
+{{/if}}
+
+## Context
+
+{{#if adr.deviation}}
+{{adr.reason}}
+
+{{/if}}
+TODO(domain): describe the forces at play: what is needed, what the architecture reference says, and why they are in tension here.
+
+## Decision
+
+TODO(domain): state the decision in one or two sentences, in the active voice.
+
+## Consequences
+
+TODO(domain): say what becomes easier, what becomes harder, and what has to be watched from now on.
+
+## Alternatives considered
+
+TODO(domain): list the options that were weighed, the supported one first, and why each was not chosen.
+{{#if adr.deviation}}
+
+## Scope
+
+TODO(domain): name exactly what the deviation covers (which files, which context, which rule) so that it does not spread.
+
+## Removal condition
+
+TODO(domain): say what has to be true for this deviation to be removed, and who checks it.
+{{/if}}

package/templates/aggregate/aggregate.spec.ts.tpl

@@ -0,0 +1,36 @@
+import { describe, expect, it } from '{{tests.module}}';
+import { given } from '@ddd-ts-kit/testing';
+import { {{name.pascal}} } from '{{alias.context}}/domain/aggregates/{{name.kebab}}.aggregate.js';
+import { {{name.article}}{{name.pascal}} } from '{{alias.context}}/test/builders/{{name.kebab}}.builder.js';
+
+describe('{{name.pascal}}', () => {
+  it('is born with its identity', () => {
+    const bornAt = new Date('2026-03-01T00:00:00.000Z');
+
+    const born = {{name.article}}{{name.pascal}}().identifiedBy('{{name.kebab}}-7').bornAt(bornAt).build();
+
+    expect(born.id).toBe('{{name.kebab}}-7');
+    expect(born.registeredAt).toEqual(bornAt);
+  });
+
+  it('is rehydrated in its stored state without recording a new fact', () => {
+    const stored = {{name.article}}{{name.pascal}}().build();
+
+    const loaded = {{name.pascal}}.rehydrate(stored.id, stored.toState());
+
+    expect(loaded.toState()).toEqual(stored.toState());
+    expect(loaded.pullEvents()).toEqual([]);
+  });
+
+  it('records nothing as long as no business intention is expressed', () => {
+    // TODO(domain): replace `toState` by a business method of {{name.pascal}} and `[]` by the facts it records, for example `[{ name: '{{context.kebab}}.{{name.kebab}}.issued' }]`.
+    given({{name.article}}{{name.pascal}}())
+      .when((subject) => subject.toState())
+      .thenEvents([]);
+  });
+
+  // TODO(domain): replace each entry below by a given / when / then test named after the business rule it proves: a built state, one intention, then the recorded facts (`thenEvents`) or the raised error (`thenError`).
+  it.todo('records the fact of its birth');
+  it.todo('refuses to be born when a birth invariant is violated');
+  it.todo('changes state and records a fact for each business intention');
+});

package/templates/aggregate/aggregate.ts.tpl

@@ -0,0 +1,37 @@
+import { AggregateRoot } from '@ddd-ts-kit/kernel';
+
+export interface {{name.pascal}}State {
+  readonly registeredAt: Date;
+  // TODO(domain): declare the rest of the state of {{name.pascal}} with value objects (a Money, a Period), not primitives.
+}
+
+export class {{name.pascal}} extends AggregateRoot<string> {
+  private constructor(
+    id: string,
+    private state: {{name.pascal}}State,
+  ) {
+    super(id);
+  }
+
+  static create(id: string, now: Date): {{name.pascal}} {
+    // TODO(domain): take the facts known at birth as parameters, check each birth invariant and throw a DomainError of ../errors when one is violated.
+    const created = new {{name.pascal}}(id, { registeredAt: now });
+
+    // TODO(domain): record the birth fact with `created.record(new {{name.pascal}}Created(id, now))` after `ddd-ts-kit generate domain-event {{context.kebab}} {{name.pascal}} Created`.
+    return created;
+  }
+
+  static rehydrate(id: string, state: {{name.pascal}}State): {{name.pascal}} {
+    return new {{name.pascal}}(id, state);
+  }
+
+  // TODO(domain): add one method per business intention (issue, cancel, ...): each guards its invariants, replaces `this.state` and records the event of what happened.
+
+  get registeredAt(): Date {
+    return this.state.registeredAt;
+  }
+
+  toState(): {{name.pascal}}State {
+    return { ...this.state };
+  }
+}

package/templates/architecture/extractable.declared.spec.ts.tpl

@@ -0,0 +1,44 @@
+import { describe, expect, it } from '{{tests.module}}';
+import { authorizationModule } from '@ddd-ts-kit/auth/di';
+import { AllowAll } from '@ddd-ts-kit/auth/testing';
+{{#if assembly.barrel}}
+import { contextModule, createTestApplication, type ContextModule } from '@ddd-ts-kit/di';
+{{/if}}
+{{#if assembly.discovery}}
+import { createTestApplication, type ContextModule } from '@ddd-ts-kit/di';
+import { discoverContext } from '@ddd-ts-kit/di/discovery';
+{{/if}}
+import { platformTestModule } from '{{alias.platform}}/platform-test.module.js';
+// ddd-ts-kit:imports
+// /ddd-ts-kit:imports
+
+/** The authorization of the platform, with a model that grants everything: this proof is about wiring, not about rights. */
+const authorization = authorizationModule({ authorizer: new AllowAll() });
+
+const contexts: readonly (readonly [string, ContextModule])[] = [
+  // ddd-ts-kit:contexts
+  // /ddd-ts-kit:contexts
+];
+
+describe('A bounded context is a deployable unit in waiting', () => {
+  it.each(contexts)(
+    '%s wires alone from its declarations, on the kernel and the platform, with no other context',
+    (_name, module) => {
+      expect(() =>
+        createTestApplication({ modules: [platformTestModule, authorization, module], authorization: 'optional' }),
+      ).not.toThrow();
+    },
+  );
+
+  it.each(contexts)('%s takes its scheduled jobs with it, and no job of another context', (name, module) => {
+    const application = createTestApplication({
+      modules: [platformTestModule, authorization, module],
+      authorization: 'optional',
+    });
+
+    const jobs = application.describe().jobs.map((job) => job.name);
+
+    expect(jobs.filter((job) => !job.startsWith(name + '.'))).toEqual([]);
+    expect(application.jobs.scheduler.describe().map((job) => job.name)).toEqual(jobs);
+  });
+});

package/templates/architecture/extractable.manual.spec.ts.tpl

@@ -0,0 +1,28 @@
+import { describe, expect, it } from '{{tests.module}}';
+import { createPlatform } from '{{alias.platform}}/create-platform.js';
+import { inertPersistence } from '{{alias.platform}}/database/inert-persistence.js';
+import { inProcessEvents } from '{{alias.platform}}/events/in-process-events.js';
+import type { Platform } from '{{alias.platform}}/platform.js';
+// ddd-ts-kit:imports
+// /ddd-ts-kit:imports
+
+const contexts: readonly (readonly [string, (platform: Platform) => { readonly name: string }])[] = [
+  // ddd-ts-kit:contexts
+  // /ddd-ts-kit:contexts
+];
+
+describe('A bounded context is a deployable unit in waiting', () => {
+  it.each(contexts)('%s wires alone, on the platform, with no other context', (name, module) => {
+    const platform = createPlatform(inertPersistence(), { events: inProcessEvents() });
+
+    expect(module(platform).name).toBe(name);
+  });
+
+  it.each(contexts)('%s takes its scheduled jobs with it, and no job of another context', (name, module) => {
+    const platform = createPlatform(inertPersistence(), { events: inProcessEvents() });
+
+    module(platform);
+
+    expect(platform.jobs.describe().filter((job) => !job.name.startsWith(name + '.'))).toEqual([]);
+  });
+});

package/templates/architecture/extractable.tsyringe.spec.ts.tpl

@@ -0,0 +1,35 @@
+import { describe, expect, it } from '{{tests.module}}';
+import { authorizationModule } from '@ddd-ts-kit/auth/di';
+import { AllowAll } from '@ddd-ts-kit/auth/testing';
+import { createTestApplication, type ContextModule } from '@ddd-ts-kit/di';
+import { platformTestModule } from '{{alias.platform}}/platform-test.module.js';
+// ddd-ts-kit:imports
+// /ddd-ts-kit:imports
+
+/** The authorization of the platform, with a model that grants everything: this proof is about wiring, not about rights. */
+const authorization = authorizationModule({ authorizer: new AllowAll() });
+
+const contexts: readonly (readonly [string, ContextModule])[] = [
+  // ddd-ts-kit:contexts
+  // /ddd-ts-kit:contexts
+];
+
+describe('A bounded context is a deployable unit in waiting', () => {
+  it.each(contexts)('%s wires alone, on the kernel and the platform, with no other context', (_name, module) => {
+    expect(() =>
+      createTestApplication({ modules: [platformTestModule, authorization, module], authorization: 'optional' }),
+    ).not.toThrow();
+  });
+
+  it.each(contexts)('%s takes its scheduled jobs with it, and no job of another context', (name, module) => {
+    const application = createTestApplication({
+      modules: [platformTestModule, authorization, module],
+      authorization: 'optional',
+    });
+
+    const jobs = application.describe().jobs.map((job) => job.name);
+
+    expect(jobs.filter((job) => !job.startsWith(name + '.'))).toEqual([]);
+    expect(application.jobs.scheduler.describe().map((job) => job.name)).toEqual(jobs);
+  });
+});

package/templates/architecture/wiring.declared.tpl

@@ -0,0 +1,6 @@
+@@imports
+{{#if assembly.barrel}}
+import * as {{context.camel}}Declarations from '{{alias.context}}/{{context.kebab}}.declarations.js';
+{{/if}}
+@@contexts
+['{{context.kebab}}', {{assembled.proofModule}}],

package/templates/architecture/wiring.manual.tpl

@@ -0,0 +1,4 @@
+@@imports
+import { {{context.camel}}Module } from '{{alias.context}}/{{context.kebab}}.module.js';
+@@contexts
+['{{context.kebab}}', {{context.camel}}Module],

package/templates/architecture/wiring.tsyringe.tpl

@@ -0,0 +1,4 @@
+@@imports
+import { {{context.camel}}Module } from '{{alias.context}}/{{context.kebab}}.module.js';
+@@contexts
+['{{context.kebab}}', {{context.camel}}Module],