@aurorajs.dev/catalyst-cli 1.0.0

package/dist/generator/packages/front-package-installer.d.ts

@@ -0,0 +1,54 @@
+import type { Project, SourceFile } from 'ts-morph';
+import type { CodeWriter } from '../engine/code-writer/code-writer.js';
+/**
+ * Context passed to each frontend package install script.
+ *
+ * Mirrors `PackageInstallerContext` (backend) but surfaces `codeWriterFor`
+ * instead of `install`, because frontend wiring is driven by the three
+ * idempotent `CodeWriter` methods rather than by raw ts-morph source-file
+ * access (design D3).
+ */
+export interface FrontPackageInstallerContext {
+    /**
+     * Factory: build a `CodeWriter` bound to the given member bounded context.
+     *
+     * The three reuse methods (`declareFrontBoundedContext`,
+     * `registerFrontNavigation`, `registerBcAggregatorInNavMain`) read only
+     * `boundedContextName` and `srcDirectory` from the CodeWriter; the factory
+     * supplies inert placeholders for the schema-derived fields those methods
+     * never touch.
+     */
+    codeWriterFor: (boundedContextName: string) => CodeWriter;
+    /**
+     * Resolved absolute path to the frontend workspace root (<root>/frontend).
+     * Use this for file-system operations on non-`src/` files and as the
+     * Prettier cwd.
+     */
+    cwd: string;
+    /**
+     * Execute a shell command in the frontend workspace directory.
+     * Used for the consumer-Prettier format pass.
+     */
+    exec: (cmd: string, args: string[]) => Promise<void>;
+    /**
+     * ts-morph Project pre-configured with the frontend tsconfig.
+     * Used by `swapCurrentAccountAdapter` and other one-off source-file ops.
+     */
+    project: Project;
+    /**
+     * Open a source file under `<frontendDir>/src/<...segments>`.
+     * Throws if the file does not exist (same contract as the backend equivalent).
+     */
+    sourceFile: (...segments: string[]) => SourceFile;
+    /**
+     * The srcDirectory token the CodeWriter expects (e.g. `'frontend/src'`).
+     * Stored here so installer helpers can pass it to `registerBcAggregatorInNavMain`.
+     */
+    srcDirectory: string;
+}
+/**
+ * Default export signature every frontend package `install.ts` must implement.
+ * Returns an optional post-install message surfaced by the `add` command after
+ * `spinner.succeed()`.
+ */
+export type FrontPackageInstaller = (ctx: FrontPackageInstallerContext) => Promise<string | undefined>;

package/dist/generator/packages/front-package-installer.js

@@ -0,0 +1 @@
+export {};

package/dist/generator/packages/installers/auditing.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/auditing.js

@@ -0,0 +1,18 @@
+import { DecoratorDriver } from '../../engine/code-writer/drivers/decorator.driver.js';
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { addScheduleModule, addToSharedModule, changeSharedModuleAdapter, declareBackPackageModule, runGraphqlTypes, } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['@nestjs/axios', '@nestjs/schedule']);
+    await ctx.install(['@types/cron'], { dev: true });
+    declareBackPackageModule(ctx, 'AuditingModule', '@app/modules/auditing/auditing.module');
+    addScheduleModule(ctx);
+    const sharedModule = ctx.sourceFile('app', 'shared.module.ts');
+    ImportDriver.createImportItems(sharedModule, '@nestjs/axios', ['HttpModule']);
+    addToSharedModule(sharedModule, 'imports', 'HttpModule');
+    addToSharedModule(sharedModule, 'exports', 'HttpModule');
+    ImportDriver.createImportItems(sharedModule, '@app/modules/auditing/interceptors/auditing-axios-interceptor.service', ['AuditingAxiosInterceptorService']);
+    DecoratorDriver.addModuleDecoratorProperty(sharedModule, 'SharedModule', 'Module', 'providers', 'AuditingAxiosInterceptorService');
+    changeSharedModuleAdapter(sharedModule, 'providers', 'AuditingRunner', 'AuditingAxiosRunner', '@app/modules/auditing/runners/auditing-axios.runner', ['AuditingAxiosRunner']);
+    sharedModule.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/authorization-code.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/authorization-code.js

@@ -0,0 +1,35 @@
+import { CallExpressionDriver } from '../../engine/code-writer/drivers/call-expression.driver.js';
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { addToSharedModule, declareBackPackageModule, runGraphqlTypes, } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install([
+        '@nestjs/axios',
+        '@nestjs/jwt',
+        '@nestjs/passport',
+        'axios',
+        'jwks-rsa',
+        'passport',
+        'passport-jwt',
+    ]);
+    await ctx.install(['@types/passport-jwt'], { dev: true });
+    declareBackPackageModule(ctx, 'AuthorizationCodeModule', '@api/authorization-code/authorization-code.module');
+    const sharedModule = ctx.sourceFile('@aurora', 'shared.module.ts');
+    ImportDriver.createImportItems(sharedModule, '@nestjs/axios', ['HttpModule']);
+    addToSharedModule(sharedModule, 'imports', 'HttpModule');
+    addToSharedModule(sharedModule, 'exports', 'HttpModule');
+    sharedModule.saveSync();
+    // Replace `UseGuards` arg in auth.decorator with the new guards.
+    const authDecorator = ctx.sourceFile('@aurora', 'decorators', 'auth.decorator.ts');
+    ImportDriver.createImportItems(authDecorator, '@app/authorization-code', [
+        'AuthenticationJwtGuard',
+        'AuthorizationPermissionsGuard',
+    ]);
+    const callExpr = CallExpressionDriver.findCallExpression(authDecorator, 'UseGuards');
+    if (callExpr) {
+        CallExpressionDriver.removeAllArguments(callExpr);
+        CallExpressionDriver.addArgument(callExpr, 'AuthenticationJwtGuard');
+        CallExpressionDriver.addArgument(callExpr, 'AuthorizationPermissionsGuard');
+    }
+    authDecorator.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/common.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/common.js

@@ -0,0 +1,13 @@
+import { DecoratorDriver } from '../../engine/code-writer/drivers/decorator.driver.js';
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { changeSharedModuleAdapter, declareBackPackageModule, runGraphqlTypes, } from '../package-helpers.js';
+export default async function install(ctx) {
+    declareBackPackageModule(ctx, 'CommonModule', '@app/modules/common/common.module');
+    const sharedModule = ctx.sourceFile('app', 'shared.module.ts');
+    changeSharedModuleAdapter(sharedModule, 'providers', 'CoreGetLangsService', 'CommonGetLangsService', '@app/modules/common/lang/application/get/common-get-langs.service', ['CommonGetLangsService']);
+    ImportDriver.createImportItems(sharedModule, '@app/modules/common/attachment/application/common-attachments.service', ['CommonAttachmentsService']);
+    DecoratorDriver.addModuleDecoratorProperty(sharedModule, 'SharedModule', 'Module', 'providers', 'CommonAttachmentsService');
+    DecoratorDriver.addModuleDecoratorProperty(sharedModule, 'SharedModule', 'Module', 'exports', 'CommonAttachmentsService');
+    sharedModule.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/front/identity.d.ts

@@ -0,0 +1,25 @@
+import type { FrontPackageInstallerContext } from '../../front-package-installer.js';
+/**
+ * Identity (IAM + OAuth) FRONTEND package installer.
+ *
+ * Runs after both the `iam` and `o-auth` template trees have been copied by
+ * the meta-package dispatch in `addFrontPackage`. Responsible for wiring the
+ * four shared composition-root files via the three idempotent CodeWriter
+ * methods and the new `swapCurrentAccountAdapter` op.
+ *
+ * Execution order (design D4):
+ * 1. For each member BC (`iam`, `o-auth`):
+ *    a. `declareFrontBoundedContext()` — wire lazy route in `routes.ts`.
+ *    b. `registerFrontNavigation()` — add nav import + spread in `navigation-data.ts`.
+ *    c. `registerBcAggregatorInNavMain(srcDirectory, bc)` — add icons spread in `nav-main.ts`.
+ * 2. Once (iam-specific): `swapCurrentAccountAdapter(ctx)` — swap provider in `aurora.provider.ts`.
+ * 3. Consumer-Prettier format pass on all four touched files (cosmetic, non-fatal).
+ *
+ * MUST NOT:
+ * - Add npm dependencies.
+ * - Touch `domains/auth/` or `public/i18n/navigation/`.
+ *
+ * Returns a concise post-install banner surfaced by the `add` command after
+ * `spinner.succeed()`.
+ */
+export default function install(ctx: FrontPackageInstallerContext): Promise<string>;

package/dist/generator/packages/installers/front/identity.js

@@ -0,0 +1,55 @@
+import { formatFrontWorkspaceFiles, swapCurrentAccountAdapter, } from '../../front-package-helpers.js';
+/**
+ * Log a warning and continue when a CodeWriter method fails, matching the
+ * behavior of the `generate front` path (design D4 / safeRun contract).
+ */
+function safeRun(label, fn) {
+    try {
+        fn();
+    }
+    catch (error) {
+        console.warn(`[aurora-catalyst:front-installer] ${label} skipped: ${error.message}`);
+    }
+}
+/**
+ * Identity (IAM + OAuth) FRONTEND package installer.
+ *
+ * Runs after both the `iam` and `o-auth` template trees have been copied by
+ * the meta-package dispatch in `addFrontPackage`. Responsible for wiring the
+ * four shared composition-root files via the three idempotent CodeWriter
+ * methods and the new `swapCurrentAccountAdapter` op.
+ *
+ * Execution order (design D4):
+ * 1. For each member BC (`iam`, `o-auth`):
+ *    a. `declareFrontBoundedContext()` — wire lazy route in `routes.ts`.
+ *    b. `registerFrontNavigation()` — add nav import + spread in `navigation-data.ts`.
+ *    c. `registerBcAggregatorInNavMain(srcDirectory, bc)` — add icons spread in `nav-main.ts`.
+ * 2. Once (iam-specific): `swapCurrentAccountAdapter(ctx)` — swap provider in `aurora.provider.ts`.
+ * 3. Consumer-Prettier format pass on all four touched files (cosmetic, non-fatal).
+ *
+ * MUST NOT:
+ * - Add npm dependencies.
+ * - Touch `domains/auth/` or `public/i18n/navigation/`.
+ *
+ * Returns a concise post-install banner surfaced by the `add` command after
+ * `spinner.succeed()`.
+ */
+export default async function install(ctx) {
+    // 1. Wire routes / nav / icons for each member BC (both idempotent)
+    for (const bc of ['iam', 'o-auth']) {
+        const cw = ctx.codeWriterFor(bc);
+        safeRun(`declareFrontBoundedContext(${bc})`, () => cw.declareFrontBoundedContext());
+        safeRun(`registerFrontNavigation(${bc})`, () => cw.registerFrontNavigation());
+        safeRun(`registerBcAggregatorInNavMain(${bc})`, () => cw.registerBcAggregatorInNavMain(ctx.srcDirectory, bc));
+    }
+    // 2. Swap the CurrentAccountService provider to use the IAM adapter (iam-specific, idempotent)
+    safeRun('swapCurrentAccountAdapter', () => swapCurrentAccountAdapter(ctx));
+    // 3. Consumer-Prettier format pass on the four touched shared files (non-fatal)
+    await formatFrontWorkspaceFiles(ctx, [
+        'src/app/domains/admin/routes.ts',
+        'src/app/domains/admin/navigation-data.ts',
+        'src/app/domains/admin/layout/sidebar/nav-main.ts',
+        'src/app/aurora.provider.ts',
+    ]);
+    return 'Identity (IAM + OAuth) frontend installed — iam + o-auth routed, in the sidebar, and the IAM current-account adapter is active.';
+}

package/dist/generator/packages/installers/identity.d.ts

@@ -0,0 +1,23 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+/**
+ * Identity (IAM + OAuth) package installer.
+ *
+ * Runs after both the `iam` and `o-auth` template trees have been copied by
+ * the meta-package dispatch in `addBackPackage`. Responsible for:
+ *
+ * 1. Installing the union of runtime dependencies.
+ * 2. Wiring `@bridges/bridges.module.ts` to the golden-reference shape.
+ * 3. Authoring `@bridges/providers/index.ts` barrel.
+ * 4. Formatting both touched files with the consumer's own Prettier (so
+ *    eslint-plugin-prettier/recommended passes without further changes).
+ * 5. Setting `OAUTH_STRATEGY=local-provider` in `.env`.
+ * 6. Running GraphQL typings regeneration last (D6).
+ *
+ * MUST NOT:
+ * - Edit `@aurora/decorators/auth.decorator.ts`.
+ * - Auto-run `catalyst keys` or any seeder.
+ *
+ * Returns the "Next steps" banner as a string so the `add` command can print
+ * it AFTER `spinner.succeed()`, keeping spinner output clean.
+ */
+export default function install(ctx: PackageInstallerContext): Promise<string>;

package/dist/generator/packages/installers/identity.js

@@ -0,0 +1,67 @@
+import { authBridgesProvidersBarrel, formatWorkspaceFiles, runGraphqlTypes, setEnvValue, wireBridgesModule, } from '../package-helpers.js';
+/**
+ * Identity (IAM + OAuth) package installer.
+ *
+ * Runs after both the `iam` and `o-auth` template trees have been copied by
+ * the meta-package dispatch in `addBackPackage`. Responsible for:
+ *
+ * 1. Installing the union of runtime dependencies.
+ * 2. Wiring `@bridges/bridges.module.ts` to the golden-reference shape.
+ * 3. Authoring `@bridges/providers/index.ts` barrel.
+ * 4. Formatting both touched files with the consumer's own Prettier (so
+ *    eslint-plugin-prettier/recommended passes without further changes).
+ * 5. Setting `OAUTH_STRATEGY=local-provider` in `.env`.
+ * 6. Running GraphQL typings regeneration last (D6).
+ *
+ * MUST NOT:
+ * - Edit `@aurora/decorators/auth.decorator.ts`.
+ * - Auto-run `catalyst keys` or any seeder.
+ *
+ * Returns the "Next steps" banner as a string so the `add` command can print
+ * it AFTER `spinner.succeed()`, keeping spinner output clean.
+ */
+export default async function install(ctx) {
+    // 1. Install union of runtime deps (iam + o-auth combined).
+    await ctx.install([
+        'nestjs-i18n',
+        '@nestjs/jwt',
+        '@nestjs/passport',
+        'passport',
+        'passport-jwt',
+    ]);
+    // 2. Wire @bridges/bridges.module.ts to the golden-reference shape
+    //    (idempotent: skip-if-present for each import / array element).
+    const bridgesModule = ctx.sourceFile('@bridges', 'bridges.module.ts');
+    wireBridgesModule(bridgesModule);
+    // 3. Author @bridges/providers/index.ts barrel (five re-exports).
+    authBridgesProvidersBarrel(ctx.cwd);
+    // 4. Format both touched files with the consumer's Prettier so that
+    //    eslint-plugin-prettier/recommended + prettier-plugin-organize-imports
+    //    pass without further changes (fixes #1 from the adversarial review).
+    await formatWorkspaceFiles(ctx, [
+        'src/@bridges/bridges.module.ts',
+        'src/@bridges/providers/index.ts',
+    ]);
+    // 5. Set OAUTH_STRATEGY=local-provider in .env (idempotent line rewrite).
+    setEnvValue(ctx.cwd, 'OAUTH_STRATEGY', 'local-provider');
+    // 6. GraphQL typings regen runs LAST (D6): both @api/iam and @api/o-auth
+    //    schemas must be on disk before the generator resolves cross-BC adapter
+    //    imports from @api/graphql.
+    await runGraphqlTypes(ctx);
+    // Return the post-install banner so the caller can print it after
+    // spinner.succeed() — avoids mixing banner lines with the spinner chrome.
+    return `
+╔══════════════════════════════════════════════════════════════════════════╗
+║  Identity (IAM + OAuth) installed — next steps required:                 ║
+║                                                                          ║
+║  1. Generate RSA keypair (run from the backend workspace):               ║
+║       catalyst keys                                                      ║
+║                                                                          ║
+║  2. Set key paths in .env:                                               ║
+║       OAUTH_PRIVATE_KEY_PATH = <path>/oauth-private.key                  ║
+║       OAUTH_PUBLIC_KEY_PATH  = <path>/oauth-public.key                   ║
+║                                                                          ║
+║  3. Restart the backend (or run pnpm dev).                               ║
+╚══════════════════════════════════════════════════════════════════════════╝
+`;
+}

package/dist/generator/packages/installers/mcp.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/mcp.js

@@ -0,0 +1,5 @@
+import { declareBackPackageModule } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['@modelcontextprotocol/sdk', 'zod']);
+    declareBackPackageModule(ctx, 'McpModule', '@app/modules/mcp/mcp.module');
+}

package/dist/generator/packages/installers/message.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/message.js

@@ -0,0 +1,5 @@
+import { declareBackPackageModule, runGraphqlTypes } from '../package-helpers.js';
+export default async function install(ctx) {
+    declareBackPackageModule(ctx, 'MessageModule', '@app/modules/message/message.module');
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/ms-email.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/ms-email.js

@@ -0,0 +1,12 @@
+import { DecoratorDriver } from '../../engine/code-writer/drivers/decorator.driver.js';
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { runGraphqlTypes } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['@microsoft/microsoft-graph-client']);
+    // Swap MailerTransportService adapter to MsGraphMailerTransportService
+    const mailerModule = ctx.sourceFile('app', 'mailer-transport.module.ts');
+    ImportDriver.createImportItems(mailerModule, '@app/modules/ms-email/application/ms-graph-mailer-transport.service', ['MsGraphMailerTransportService']);
+    DecoratorDriver.changeModuleDecoratorPropertyAdapter(mailerModule, 'MailerTransportModule', 'Module', 'providers', 'MailerTransportService', 'MsGraphMailerTransportService');
+    mailerModule.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/ms-entra-id.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/ms-entra-id.js

@@ -0,0 +1,24 @@
+import { CallExpressionDriver } from '../../engine/code-writer/drivers/call-expression.driver.js';
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { declareBackPackageModule, runGraphqlTypes } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install([
+        '@nestjs/passport',
+        'passport',
+        'passport-azure-ad',
+        'passport-http-bearer',
+    ]);
+    declareBackPackageModule(ctx, 'MsEntraIdModule', '@app/modules/ms-entra-id/ms-entra-id.module');
+    // Replace UseGuards arg with the two new guards
+    const authDecorator = ctx.sourceFile('app', 'shared', 'decorators', 'auth.decorator.ts');
+    ImportDriver.createImportItems(authDecorator, '@app/modules/ms-entra-id/shared/guards/azure-ad-bearer-auth.guard', ['AzureAdBearerAuthGuard']);
+    ImportDriver.createImportItems(authDecorator, '@app/modules/ms-entra-id/shared/guards/authorization-permissions.guard', ['AuthorizationPermissionsGuard']);
+    const callExpr = CallExpressionDriver.findCallExpression(authDecorator, 'UseGuards');
+    if (callExpr) {
+        CallExpressionDriver.removeAllArguments(callExpr);
+        CallExpressionDriver.addArgument(callExpr, 'AzureAdBearerAuthGuard');
+        CallExpressionDriver.addArgument(callExpr, 'AuthorizationPermissionsGuard');
+    }
+    authDecorator.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/queue-manager.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/queue-manager.js

@@ -0,0 +1,7 @@
+import { addScheduleModule, declareBackPackageModule, runGraphqlTypes, } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['@nestjs/bullmq', 'bullmq', 'ioredis']);
+    declareBackPackageModule(ctx, 'QueueManagerModule', '@app/modules/queue-manager/queue-manager.module');
+    addScheduleModule(ctx);
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/storage-account-azure.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/storage-account-azure.js

@@ -0,0 +1,9 @@
+import { changeSharedModuleAdapter, runGraphqlTypes } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['@azure/storage-blob']);
+    const sharedModule = ctx.sourceFile('app', 'shared.module.ts');
+    changeSharedModuleAdapter(sharedModule, 'providers', 'FileManagerService', 'AzureBlobFileManagerService', '@app/modules/storage-account-azure/file-manager/application/azure-blob-file-manager.service', ['AzureBlobFileManagerService']);
+    changeSharedModuleAdapter(sharedModule, 'providers', 'SasService', 'AzureBlobSasService', '@app/modules/storage-account-azure/sas/application/azure-blob-sas.service', ['AzureBlobSasService']);
+    sharedModule.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/storage-account.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/storage-account.js

@@ -0,0 +1,16 @@
+import { DecoratorDriver } from '../../engine/code-writer/drivers/decorator.driver.js';
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { addProviderToModule, declareBackPackageModule, runGraphqlTypes, } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['sharp', 'form-data']);
+    await ctx.install(['@types/multer'], { dev: true });
+    declareBackPackageModule(ctx, 'StorageAccountModule', '@app/modules/storage-account/storage-account.module');
+    const sharedModule = ctx.sourceFile('app', 'shared.module.ts');
+    addProviderToModule(sharedModule, 'SharedModule', 'Module', 'providers', 'FileManagerService', 'StorageAccountFileManagerService', '@app/modules/storage-account/file-manager/application/storage-account-file-manager.service', ['FileManagerService', 'StorageAccountFileManagerService']);
+    DecoratorDriver.addModuleDecoratorProperty(sharedModule, 'SharedModule', 'Module', 'exports', 'FileManagerService');
+    ImportDriver.createImportItems(sharedModule, '@app/modules/storage-account/sas/application/storage-account-sas.service', ['SasService', 'StorageAccountSasService']);
+    addProviderToModule(sharedModule, 'SharedModule', 'Module', 'providers', 'SasService', 'StorageAccountSasService', '@app/modules/storage-account/sas/application/storage-account-sas.service', ['SasService', 'StorageAccountSasService']);
+    DecoratorDriver.addModuleDecoratorProperty(sharedModule, 'SharedModule', 'Module', 'exports', 'SasService');
+    sharedModule.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/support.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/support.js

@@ -0,0 +1,12 @@
+import { ImportDriver } from '../../engine/code-writer/drivers/import.driver.js';
+import { addToSharedModule, declareBackPackageModule, runGraphqlTypes, } from '../package-helpers.js';
+export default async function install(ctx) {
+    await ctx.install(['@nestjs/axios', 'axios']);
+    declareBackPackageModule(ctx, 'SupportModule', '@app/modules/support/support.module');
+    const sharedModule = ctx.sourceFile('app', 'shared.module.ts');
+    ImportDriver.createImportItems(sharedModule, '@nestjs/axios', ['HttpModule']);
+    addToSharedModule(sharedModule, 'imports', 'HttpModule');
+    addToSharedModule(sharedModule, 'exports', 'HttpModule');
+    sharedModule.saveSync();
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/tools.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/tools.js

@@ -0,0 +1,5 @@
+import { declareBackPackageModule, runGraphqlTypes } from '../package-helpers.js';
+export default async function install(ctx) {
+    declareBackPackageModule(ctx, 'ToolsModule', '@app/modules/tools/tools.module');
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/installers/whatsapp.d.ts

@@ -0,0 +1,2 @@
+import type { PackageInstallerContext } from '../package-installer.js';
+export default function install(ctx: PackageInstallerContext): Promise<void>;

package/dist/generator/packages/installers/whatsapp.js

@@ -0,0 +1,5 @@
+import { declareBackPackageModule, runGraphqlTypes } from '../package-helpers.js';
+export default async function install(ctx) {
+    declareBackPackageModule(ctx, 'WhatsappModule', '@app/modules/whatsapp/whatsapp.module');
+    await runGraphqlTypes(ctx);
+}

package/dist/generator/packages/package-helpers.d.ts

@@ -0,0 +1,54 @@
+/** Shared helpers used by multiple package install scripts. */
+import type { SourceFile } from 'ts-morph';
+import type { PackageInstallerContext } from './package-installer.js';
+/** Declare a package module in `app.module.ts`: adds the import and registers it in `@Module({ imports })`. */
+export declare function declareBackPackageModule(ctx: PackageInstallerContext, moduleName: string, importPath: string): void;
+/** Add `ScheduleModule.forRoot()` to `app.module.ts` imports if not already present. */
+export declare function addScheduleModule(ctx: PackageInstallerContext): void;
+/** Regenerate GraphQL type definitions via `npx ts-node generate-typings`. */
+export declare function runGraphqlTypes(ctx: PackageInstallerContext): Promise<void>;
+/**
+ * Run the consumer's own Prettier over a list of workspace-relative file paths.
+ *
+ * Using the consumer's Prettier binary (via `npx prettier --write`) ensures
+ * that the consumer's `.prettierrc`, `prettier-plugin-organize-imports`, and
+ * trailing-comma settings are honoured. ts-morph emits files with
+ * `useTrailingCommas: false` which typically violates `eslint-plugin-prettier/
+ * recommended` on the consumer side — a single format pass after `saveSync()`
+ * closes the gap without us having to replicate the consumer's Prettier config.
+ */
+export declare function formatWorkspaceFiles(ctx: PackageInstallerContext, relativePaths: string[]): Promise<void>;
+/** Add an import and an element to a decorator-array property in `shared.module.ts`. */
+export declare function addToSharedModule(sourceFile: SourceFile, propertyName: string, itemText: string, importPath?: string, importNames?: string[]): void;
+/** Change the `useClass` of a provider inside a decorator-array property. */
+export declare function changeSharedModuleAdapter(sourceFile: SourceFile, propertyName: string, provide: string, adapter: string, importPath: string, importNames: string[]): void;
+/** Add a `{ provide, useClass }` provider to a decorator array, registering imports first. */
+export declare function addProviderToModule(sourceFile: SourceFile, moduleName: string, decoratorName: string, propertyName: string, provide: string, useClass: string, importPath: string, importNames: string[]): void;
+/**
+ * Idempotently wire `@bridges/bridges.module.ts` to the golden-reference shape.
+ *
+ * Adds the required imports and populates the three `@Module` arrays
+ * (`imports`, `providers`, `exports`) without duplicating existing entries.
+ * Preserves the `@Global()` decorator that the scaffold already ships.
+ *
+ * Design D3: idempotency is enforced by `DecoratorDriver.addModuleDecoratorProperty`
+ * (skip-if-present by `element.getText()` compare) and by `ImportDriver.createImportItems`
+ * (additive, deduped by named-import tracking).
+ */
+export declare function wireBridgesModule(sourceFile: SourceFile): void;
+/**
+ * Author `src/@bridges/providers/index.ts` as a complete barrel re-exporting
+ * all five bridge provider consts. Called after both iam and o-auth trees are
+ * copied (design D2: the installer owns this file to avoid two partial barrels
+ * clobbering on copy). Idempotent: overwrites the file every time (the content
+ * is fixed and known).
+ */
+export declare function authBridgesProvidersBarrel(workspaceDir: string): void;
+/**
+ * Idempotently set a `KEY = value` line in `<workspaceDir>/.env`.
+ *
+ * - If the key line exists → replace its value, preserve any inline `# comment`.
+ * - If absent → append `KEY = value` at EOF.
+ * - Idempotent: re-running yields the same file (design D4).
+ */
+export declare function setEnvValue(workspaceDir: string, key: string, value: string): void;