@aurorajs.dev/catalyst-cli 1.1.3 → 2.0.0

package/dist/templates/backend/application/src/@config/drizzle/aurora-field-schemas.spec.ts

@@ -12,13 +12,13 @@
  * `scripts/contracts/masked-property-guard.test.ts` (task 9) owns the general completeness check
  * against the repositories on disk; this spec pins the CONCRETE inventory for this repository.
  */
-import { IamUserFieldSchema } from '@app/iam/user';
-import { OAuthAccessTokenFieldSchema } from '@app/o-auth/access-token';
-import { OAuthApplicationFieldSchema } from '@app/o-auth/application';
-import { OAuthRefreshTokenFieldSchema } from '@app/o-auth/refresh-token';
+import { IamUserFieldSchema } from '@app/iam/user/index.js';
+import { OAuthAccessTokenFieldSchema } from '@app/o-auth/access-token/index.js';
+import { OAuthApplicationFieldSchema } from '@app/o-auth/application/index.js';
+import { OAuthRefreshTokenFieldSchema } from '@app/o-auth/refresh-token/index.js';
 import { FieldSchema, isMaskedPropertyType } from '@aurorajs.dev/core-back';
 
-import { auroraFieldSchemas } from './aurora-field-schemas';
+import { auroraFieldSchemas } from './aurora-field-schemas.js';
 
 /** Scalar (non-relation) entries whose declared type is masked, by declaration order. */
 function maskedNames(schema: FieldSchema[]): string[] {
@@ -30,13 +30,11 @@ function maskedNames(schema: FieldSchema[]): string[] {
 
 describe('auroraFieldSchemas', () => {
   it('registers every aggregate the application exposes, not only the ones declaring a masked property', () => {
-    // 73 field-schema files, one per aggregate (66 + the 7 new biller/billing-run-pipeline
-    // aggregates: BillerBillingRun, BillerBillingRunStage, BillerBillingRunError,
-    // BillerBillingPeriod, BillerInvoice, BillerInvoiceLine, BillerRemittance).
+    // 60 field-schema files, one per aggregate.
     // `CommonCountryI18n` is the only repository with no field schema of its own (the CLI folds
     // i18n columns into the parent's schema), so it cannot be registered — the contract test
     // pins it as the single reviewed exception.
-    expect(Object.keys(auroraFieldSchemas)).toHaveLength(73);
+    expect(Object.keys(auroraFieldSchemas)).toHaveLength(60);
   });
 
   it('registers aggregates that declare NO masked property but are parents on a path to one', () => {

package/dist/templates/backend/application/src/@config/drizzle/aurora-field-schemas.ts

@@ -17,89 +17,78 @@
  * declaring aggregates was therefore not a saving of dead lines — it was the hole.
  *
  * Each entry is keyed by the exact `this.aggregateName` its generated repository assigns, because
- * that is the key the guard resolves. Imports go through each module's BARREL
- * (`@app/<bc>/<module>` — HR-BARRELS-003), which is also what the generated `*.field-schema.ts`
- * files use for their own relation targets: importing the narrower `domain` sub-barrel buys no
- * isolation, because the field schema behind it imports its relation targets by module barrel
- * anyway (measured: `iam-user.field-schema.ts` imports `@app/iam/account`).
+ * that is the key the guard resolves. Imports go through each module's public `domain` sub-barrel
+ * (`@app/<bc>/<module>/domain` — HR-BARRELS-004 case 2), which is also what the generated
+ * `*.field-schema.ts` files use for their own relation targets: this file is loaded from
+ * `app.module.ts` at boot and names EVERY aggregate in the application, so a root-barrel
+ * specifier here would reach every module's services, handlers and repository from a single
+ * `@config` file before any NestJS module is constructed — the bounded surface is what
+ * `HR-MODGRAPH-001` exists to protect.
  *
  * A missing or stale entry fails `pnpm test:contracts`
  * (`scripts/contracts/masked-property-guard.test.ts`), which reads every repository's
  * `aggregateName` and every `*.field-schema.ts` from disk and demands set equality.
  */
-import { BillerBillingPeriodFieldSchema } from '@app/biller/billing-period';
-import { BillerBillingRunFieldSchema } from '@app/biller/billing-run';
-import { BillerBillingRunErrorFieldSchema } from '@app/biller/billing-run-error';
-import { BillerBillingRunStageFieldSchema } from '@app/biller/billing-run-stage';
-import { BillerChargeFieldSchema } from '@app/biller/charge';
-import { BillerCustomerFieldSchema } from '@app/biller/customer';
-import { BillerDeviceFieldSchema } from '@app/biller/device';
-import { BillerInvoiceFieldSchema } from '@app/biller/invoice';
-import { BillerInvoiceLineFieldSchema } from '@app/biller/invoice-line';
-import { BillerRemittanceFieldSchema } from '@app/biller/remittance';
-import { BillerServiceFieldSchema } from '@app/biller/service';
-import { BillerTariffFieldSchema } from '@app/biller/tariff';
-import { BillerTransitFieldSchema } from '@app/biller/transit';
-import { BusinessPartnerPortalBusinessPartnerFieldSchema } from '@app/business-partner-portal/business-partner';
-import { BusinessPartnerPortalPartnerContactFieldSchema } from '@app/business-partner-portal/partner-contact';
-import { BusinessPartnerPortalPaymentCollectionModeFieldSchema } from '@app/business-partner-portal/payment-collection-mode';
-import { BusinessPartnerPortalPaymentModeFieldSchema } from '@app/business-partner-portal/payment-mode';
-import { BusinessPartnerPortalPurchaseInvoiceHeaderFieldSchema } from '@app/business-partner-portal/purchase-invoice-header';
-import { BusinessPartnerPortalPurchaseInvoicePositionFieldSchema } from '@app/business-partner-portal/purchase-invoice-position';
-import { BusinessPartnerPortalSalesInvoiceHeaderFieldSchema } from '@app/business-partner-portal/sales-invoice-header';
-import { BusinessPartnerPortalSalesInvoicePositionFieldSchema } from '@app/business-partner-portal/sales-invoice-position';
-import { BusinessPartnerPortalSupplierDocumentFieldSchema } from '@app/business-partner-portal/supplier-document';
-import { CommonCountryFieldSchema } from '@app/common/country';
-import { CommonLangFieldSchema } from '@app/common/lang';
-import { DashboardLayoutFieldSchema } from '@app/dashboard/layout';
-import { DashboardLayoutItemFieldSchema } from '@app/dashboard/layout-item';
-import { HubAppFieldSchema } from '@app/hub/app';
-import { HubAppAccountFieldSchema } from '@app/hub/app-account';
-import { IamAccountFieldSchema } from '@app/iam/account';
-import { IamBoundedContextFieldSchema } from '@app/iam/bounded-context';
-import { IamPermissionFieldSchema } from '@app/iam/permission';
-import { IamPermissionRoleFieldSchema } from '@app/iam/permission-role';
-import { IamRoleFieldSchema } from '@app/iam/role';
-import { IamRoleAccountFieldSchema } from '@app/iam/role-account';
-import { IamTagFieldSchema } from '@app/iam/tag';
-import { IamTenantFieldSchema } from '@app/iam/tenant';
-import { IamTenantAccountFieldSchema } from '@app/iam/tenant-account';
-import { IamUserFieldSchema } from '@app/iam/user';
-import { LacremShipmentFieldSchema } from '@app/lacrem/shipment';
-import { OAuthAccessTokenFieldSchema } from '@app/o-auth/access-token';
-import { OAuthApplicationFieldSchema } from '@app/o-auth/application';
-import { OAuthApplicationClientFieldSchema } from '@app/o-auth/application-client';
-import { OAuthAuthorizationCodeFieldSchema } from '@app/o-auth/authorization-code';
-import { OAuthClientFieldSchema } from '@app/o-auth/client';
-import { OAuthCredentialFieldSchema } from '@app/o-auth/credential';
-import { OAuthRefreshTokenFieldSchema } from '@app/o-auth/refresh-token';
-import { OAuthScopeFieldSchema } from '@app/o-auth/scope';
-import { PartnerPartnerReplicaFieldSchema } from '@app/partner/partner-replica';
-import { ProductionPlanningAccountProductionOrderPositionFieldSchema } from '@app/production-planning/account-production-order-position';
-import { ProductionPlanningEquipmentFieldSchema } from '@app/production-planning/equipment';
-import { ProductionPlanningEquipmentFormatFieldSchema } from '@app/production-planning/equipment-format';
-import { ProductionPlanningEquipmentProcessFieldSchema } from '@app/production-planning/equipment-process';
-import { ProductionPlanningIssueTypeFieldSchema } from '@app/production-planning/issue-type';
-import { ProductionPlanningProcessFieldSchema } from '@app/production-planning/process';
-import { ProductionPlanningProductFieldSchema } from '@app/production-planning/product';
-import { ProductionPlanningProductionCenterFieldSchema } from '@app/production-planning/production-center';
-import { ProductionPlanningProductionOrderHeaderFieldSchema } from '@app/production-planning/production-order-header';
-import { ProductionPlanningProductionOrderPositionFieldSchema } from '@app/production-planning/production-order-position';
-import { ProductionPlanningProductionOrderPositionEventFieldSchema } from '@app/production-planning/production-order-position-event';
-import { ProductionPlanningRoomFieldSchema } from '@app/production-planning/room';
-import { ReportingReportFieldSchema } from '@app/reporting/report';
-import { ReportingReportCategoryFieldSchema } from '@app/reporting/report-category';
-import { ReportingReportFavoriteFieldSchema } from '@app/reporting/report-favorite';
-import { SapIntegrationSapEventLogFieldSchema } from '@app/sap-integration/sap-event-log';
-import { SapIntegrationSapSyncErrorFieldSchema } from '@app/sap-integration/sap-sync-error';
-import { SapIntegrationSapSyncStateFieldSchema } from '@app/sap-integration/sap-sync-state';
-import { ToolsCustomFieldDefinitionFieldSchema } from '@app/tools/custom-field-definition';
-import { ToolsCustomFieldEntityFieldSchema } from '@app/tools/custom-field-entity';
-import { ToolsCustomFieldGroupFieldSchema } from '@app/tools/custom-field-group';
-import { ToolsCustomFieldOptionFieldSchema } from '@app/tools/custom-field-option';
-import { ToolsKeyValueFieldSchema } from '@app/tools/key-value';
-import { ToolsMigrationFieldSchema } from '@app/tools/migration';
-import { ToolsProcedureFieldSchema } from '@app/tools/procedure';
+import { BusinessPartnerPortalBusinessPartnerFieldSchema } from '@app/business-partner-portal/business-partner/domain/index.js';
+import { BusinessPartnerPortalPartnerContactFieldSchema } from '@app/business-partner-portal/partner-contact/domain/index.js';
+import { BusinessPartnerPortalPaymentCollectionModeFieldSchema } from '@app/business-partner-portal/payment-collection-mode/domain/index.js';
+import { BusinessPartnerPortalPaymentModeFieldSchema } from '@app/business-partner-portal/payment-mode/domain/index.js';
+import { BusinessPartnerPortalPurchaseInvoiceHeaderFieldSchema } from '@app/business-partner-portal/purchase-invoice-header/domain/index.js';
+import { BusinessPartnerPortalPurchaseInvoicePositionFieldSchema } from '@app/business-partner-portal/purchase-invoice-position/domain/index.js';
+import { BusinessPartnerPortalSalesInvoiceHeaderFieldSchema } from '@app/business-partner-portal/sales-invoice-header/domain/index.js';
+import { BusinessPartnerPortalSalesInvoicePositionFieldSchema } from '@app/business-partner-portal/sales-invoice-position/domain/index.js';
+import { BusinessPartnerPortalSupplierDocumentFieldSchema } from '@app/business-partner-portal/supplier-document/domain/index.js';
+import { CommonCountryFieldSchema } from '@app/common/country/domain/index.js';
+import { CommonLangFieldSchema } from '@app/common/lang/domain/index.js';
+import { DashboardLayoutItemFieldSchema } from '@app/dashboard/layout-item/domain/index.js';
+import { DashboardLayoutFieldSchema } from '@app/dashboard/layout/domain/index.js';
+import { HubAppAccountFieldSchema } from '@app/hub/app-account/domain/index.js';
+import { HubAppFieldSchema } from '@app/hub/app/domain/index.js';
+import { IamAccountFieldSchema } from '@app/iam/account/domain/index.js';
+import { IamBoundedContextFieldSchema } from '@app/iam/bounded-context/domain/index.js';
+import { IamPermissionRoleFieldSchema } from '@app/iam/permission-role/domain/index.js';
+import { IamPermissionFieldSchema } from '@app/iam/permission/domain/index.js';
+import { IamRoleAccountFieldSchema } from '@app/iam/role-account/domain/index.js';
+import { IamRoleFieldSchema } from '@app/iam/role/domain/index.js';
+import { IamTagFieldSchema } from '@app/iam/tag/domain/index.js';
+import { IamTenantAccountFieldSchema } from '@app/iam/tenant-account/domain/index.js';
+import { IamTenantFieldSchema } from '@app/iam/tenant/domain/index.js';
+import { IamUserFieldSchema } from '@app/iam/user/domain/index.js';
+import { LacremShipmentFieldSchema } from '@app/lacrem/shipment/domain/index.js';
+import { OAuthAccessTokenFieldSchema } from '@app/o-auth/access-token/domain/index.js';
+import { OAuthApplicationClientFieldSchema } from '@app/o-auth/application-client/domain/index.js';
+import { OAuthApplicationFieldSchema } from '@app/o-auth/application/domain/index.js';
+import { OAuthAuthorizationCodeFieldSchema } from '@app/o-auth/authorization-code/domain/index.js';
+import { OAuthClientFieldSchema } from '@app/o-auth/client/domain/index.js';
+import { OAuthCredentialFieldSchema } from '@app/o-auth/credential/domain/index.js';
+import { OAuthRefreshTokenFieldSchema } from '@app/o-auth/refresh-token/domain/index.js';
+import { OAuthScopeFieldSchema } from '@app/o-auth/scope/domain/index.js';
+import { PartnerPartnerReplicaFieldSchema } from '@app/partner/partner-replica/domain/index.js';
+import { ProductionPlanningAccountProductionOrderPositionFieldSchema } from '@app/production-planning/account-production-order-position/domain/index.js';
+import { ProductionPlanningEquipmentFormatFieldSchema } from '@app/production-planning/equipment-format/domain/index.js';
+import { ProductionPlanningEquipmentProcessFieldSchema } from '@app/production-planning/equipment-process/domain/index.js';
+import { ProductionPlanningEquipmentFieldSchema } from '@app/production-planning/equipment/domain/index.js';
+import { ProductionPlanningIssueTypeFieldSchema } from '@app/production-planning/issue-type/domain/index.js';
+import { ProductionPlanningProcessFieldSchema } from '@app/production-planning/process/domain/index.js';
+import { ProductionPlanningProductFieldSchema } from '@app/production-planning/product/domain/index.js';
+import { ProductionPlanningProductionCenterFieldSchema } from '@app/production-planning/production-center/domain/index.js';
+import { ProductionPlanningProductionOrderHeaderFieldSchema } from '@app/production-planning/production-order-header/domain/index.js';
+import { ProductionPlanningProductionOrderPositionEventFieldSchema } from '@app/production-planning/production-order-position-event/domain/index.js';
+import { ProductionPlanningProductionOrderPositionFieldSchema } from '@app/production-planning/production-order-position/domain/index.js';
+import { ProductionPlanningRoomFieldSchema } from '@app/production-planning/room/domain/index.js';
+import { ReportingReportCategoryFieldSchema } from '@app/reporting/report-category/domain/index.js';
+import { ReportingReportFavoriteFieldSchema } from '@app/reporting/report-favorite/domain/index.js';
+import { ReportingReportFieldSchema } from '@app/reporting/report/domain/index.js';
+import { SapIntegrationSapEventLogFieldSchema } from '@app/sap-integration/sap-event-log/domain/index.js';
+import { SapIntegrationSapSyncErrorFieldSchema } from '@app/sap-integration/sap-sync-error/domain/index.js';
+import { SapIntegrationSapSyncStateFieldSchema } from '@app/sap-integration/sap-sync-state/domain/index.js';
+import { ToolsCustomFieldDefinitionFieldSchema } from '@app/tools/custom-field-definition/domain/index.js';
+import { ToolsCustomFieldEntityFieldSchema } from '@app/tools/custom-field-entity/domain/index.js';
+import { ToolsCustomFieldGroupFieldSchema } from '@app/tools/custom-field-group/domain/index.js';
+import { ToolsCustomFieldOptionFieldSchema } from '@app/tools/custom-field-option/domain/index.js';
+import { ToolsKeyValueFieldSchema } from '@app/tools/key-value/domain/index.js';
+import { ToolsMigrationFieldSchema } from '@app/tools/migration/domain/index.js';
+import { ToolsProcedureFieldSchema } from '@app/tools/procedure/domain/index.js';
 import { FieldSchema } from '@aurorajs.dev/core-back';
 
 export const auroraFieldSchemas: Record<string, FieldSchema[]> = {
@@ -166,17 +155,4 @@ export const auroraFieldSchemas: Record<string, FieldSchema[]> = {
   ToolsKeyValue: ToolsKeyValueFieldSchema,
   ToolsMigration: ToolsMigrationFieldSchema,
   ToolsProcedure: ToolsProcedureFieldSchema,
-  BillerCustomer: BillerCustomerFieldSchema,
-  BillerTariff: BillerTariffFieldSchema,
-  BillerDevice: BillerDeviceFieldSchema,
-  BillerTransit: BillerTransitFieldSchema,
-  BillerService: BillerServiceFieldSchema,
-  BillerCharge: BillerChargeFieldSchema,
-  BillerBillingRun: BillerBillingRunFieldSchema,
-  BillerBillingRunStage: BillerBillingRunStageFieldSchema,
-  BillerBillingRunError: BillerBillingRunErrorFieldSchema,
-  BillerBillingPeriod: BillerBillingPeriodFieldSchema,
-  BillerInvoice: BillerInvoiceFieldSchema,
-  BillerInvoiceLine: BillerInvoiceLineFieldSchema,
-  BillerRemittance: BillerRemittanceFieldSchema,
 };

package/dist/templates/backend/application/src/@config/drizzle/drizzle-migrations.module.spec.ts

@@ -1,24 +1,25 @@
 // TDD (harden-drizzle-migration-workflow, D4): DATABASE_MIGRATE_ON_BOOT gates
 // `DrizzleMigrationsRunner.onModuleInit()`. `migrate()` is mocked so no real
 // DB connection is exercised.
-jest.mock('drizzle-orm/node-postgres/migrator', () => ({
-  migrate: jest.fn().mockResolvedValue(undefined),
+vi.mock('drizzle-orm/node-postgres/migrator', () => ({
+  migrate: vi.fn().mockResolvedValue(undefined),
 }));
 
+import type { Mock } from 'vitest';
 import { DRIZZLE_CONNECTION } from '@aurorajs.dev/core-back';
 import { Logger } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { Test } from '@nestjs/testing';
 import { migrate } from 'drizzle-orm/node-postgres/migrator';
-import { DrizzleMigrationsRunner } from './drizzle-migrations.module';
+import { DrizzleMigrationsRunner } from './drizzle-migrations.module.js';
 
-const migrateMock = migrate as jest.Mock;
+const migrateMock = migrate as Mock;
 
 describe('DrizzleMigrationsRunner', () => {
   const fakeDb = {};
   let configValues: Record<string, string | undefined>;
   const configService = {
-    get: jest.fn((key: string) => configValues[key]),
+    get: vi.fn((key: string) => configValues[key]),
   };
 
   const buildRunner = async (): Promise<DrizzleMigrationsRunner> => {
@@ -34,7 +35,7 @@ describe('DrizzleMigrationsRunner', () => {
   };
 
   beforeEach(() => {
-    jest.clearAllMocks();
+    vi.clearAllMocks();
     configValues = {};
   });
 
@@ -48,7 +49,7 @@ describe('DrizzleMigrationsRunner', () => {
 
   it('does NOT call migrate() and logs the skip when DATABASE_MIGRATE_ON_BOOT=false', async () => {
     configValues.DATABASE_MIGRATE_ON_BOOT = 'false';
-    const logSpy = jest.spyOn(Logger.prototype, 'log');
+    const logSpy = vi.spyOn(Logger.prototype, 'log');
     const runner = await buildRunner();
 
     await runner.onModuleInit();
@@ -68,7 +69,7 @@ describe('DrizzleMigrationsRunner', () => {
 
   it('does NOT call migrate() when DATABASE_MIGRATE_ON_BOOT=FALSE (case-insensitive)', async () => {
     configValues.DATABASE_MIGRATE_ON_BOOT = 'FALSE';
-    const logSpy = jest.spyOn(Logger.prototype, 'log');
+    const logSpy = vi.spyOn(Logger.prototype, 'log');
     const runner = await buildRunner();
 
     await runner.onModuleInit();
@@ -79,7 +80,7 @@ describe('DrizzleMigrationsRunner', () => {
 
   it('does NOT call migrate() when DATABASE_MIGRATE_ON_BOOT=" false " (surrounding whitespace)', async () => {
     configValues.DATABASE_MIGRATE_ON_BOOT = ' false ';
-    const logSpy = jest.spyOn(Logger.prototype, 'log');
+    const logSpy = vi.spyOn(Logger.prototype, 'log');
     const runner = await buildRunner();
 
     await runner.onModuleInit();
@@ -108,7 +109,7 @@ describe('DrizzleMigrationsRunner', () => {
 
   it('does NOT call migrate() and logs the skip when DATABASE_MIGRATE_ON_BOOT="0"', async () => {
     configValues.DATABASE_MIGRATE_ON_BOOT = '0';
-    const logSpy = jest.spyOn(Logger.prototype, 'log');
+    const logSpy = vi.spyOn(Logger.prototype, 'log');
     const runner = await buildRunner();
 
     await runner.onModuleInit();
@@ -119,7 +120,7 @@ describe('DrizzleMigrationsRunner', () => {
 
   it('does NOT call migrate() and logs the raw value when DATABASE_MIGRATE_ON_BOOT holds an unrecognized value (typo)', async () => {
     configValues.DATABASE_MIGRATE_ON_BOOT = 'yes';
-    const logSpy = jest.spyOn(Logger.prototype, 'log');
+    const logSpy = vi.spyOn(Logger.prototype, 'log');
     const runner = await buildRunner();
 
     await runner.onModuleInit();

package/dist/templates/backend/application/src/@config/drizzle/drizzle-migrations.module.ts

@@ -4,7 +4,7 @@ import { ConfigService } from '@nestjs/config';
 import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
 import { migrate } from 'drizzle-orm/node-postgres/migrator';
 import * as path from 'node:path';
-import { resolveDrizzleMigrationsJournalConfig } from './drizzle-migrations-journal.config';
+import { resolveDrizzleMigrationsJournalConfig } from './drizzle-migrations-journal.config.js';
 
 /**
  * Boot-time runner for the drizzle-kit schema migrations
@@ -32,11 +32,18 @@ import { resolveDrizzleMigrationsJournalConfig } from './drizzle-migrations-jour
  * `src/database/migrations/drizzle/README.md`.
  *
  * Path resolution (misma técnica que ToolsLoadMigrationsService):
- *   - Dev  (`nest start`): __dirname = src/@config/drizzle → 2 × `..` → src/
- *   - Prod (`nest build`): __dirname = dist/src/@config/drizzle → dist/src/
+ *   - Dev  (`nest start`): import.meta.dirname = src/@config/drizzle → 2 × `..` → src/
+ *   - Prod (`nest build`): import.meta.dirname = dist/src/@config/drizzle → dist/src/
  *     (nest-cli.json copia `database/**` a dist como asset)
  */
-const MIGRATIONS_FOLDER = path.join(__dirname, '..', '..', 'database', 'migrations', 'drizzle');
+const MIGRATIONS_FOLDER = path.join(
+  import.meta.dirname,
+  '..',
+  '..',
+  'database',
+  'migrations',
+  'drizzle',
+);
 
 @Injectable()
 export class DrizzleMigrationsRunner implements OnModuleInit {

package/dist/templates/backend/application/src/@config/drizzle/index.ts

@@ -1,3 +1,3 @@
-export { auroraDrizzleRelations, auroraDrizzleSchema } from './aurora-drizzle-schema';
-export { auroraFieldSchemas } from './aurora-field-schemas';
-export { DrizzleMigrationsModule } from './drizzle-migrations.module';
+export { auroraDrizzleRelations, auroraDrizzleSchema } from './aurora-drizzle-schema.js';
+export { auroraFieldSchemas } from './aurora-field-schemas.js';
+export { DrizzleMigrationsModule } from './drizzle-migrations.module.js';

package/dist/templates/backend/application/src/@config/index.ts

@@ -1,5 +1,6 @@
-export * from './bullmq';
-export * from './drizzle';
-export * from './lang';
-export * from './mailer';
-export * from './storage-account';
+export * from './bullmq/index.js';
+export * from './drizzle/index.js';
+export * from './lang/index.js';
+export * from './mailer/index.js';
+export * from './pdf/index.js';
+export * from './storage-account/index.js';

package/dist/templates/backend/application/src/@config/lang/index.ts

@@ -1 +1 @@
-export { langProviderBindings } from './lang.providers';
+export { langProviderBindings } from './lang.providers.js';

package/dist/templates/backend/application/src/@config/lang/lang.providers.ts

@@ -1,5 +1,5 @@
 import { CoreGetFallbackLangService, CoreGetLangsService } from '@aurorajs.dev/core-back';
-import { CoreGetFallbackLangFromJsonService, CoreGetLangsFromJsonService } from '@aurora/modules/lang';
+import { CoreGetFallbackLangFromJsonService, CoreGetLangsFromJsonService } from '@aurora/modules/lang/index.js';
 import { Provider } from '@nestjs/common';
 
 // Composition point (D1): the ONLY file that wires each abstract contract

package/dist/templates/backend/application/src/@config/mailer/index.ts

@@ -1 +1 @@
-export * from './mailer-transport.module';
+export * from './mailer-transport.module.js';

package/dist/templates/backend/application/src/@config/mailer/mailer-transport.module.ts

@@ -2,7 +2,7 @@
 // dependency: the barrel re-exports MailerCLientModule, which imports this very module
 // (@config/mailer) — going through the barrel would read MailerSMTPTransportService off a
 // half-initialized module and bake `useClass: undefined` into the provider, crashing bootstrap.
-import { MailerSMTPTransportService } from '@aurora/modules/mailer/mailer-smtp-transport.service';
+import { MailerSMTPTransportService } from '@aurora/modules/mailer/mailer-smtp-transport.service.js';
 import { MailerTransportService } from '@aurorajs.dev/core-back';
 import { HttpModule } from '@nestjs/axios';
 import { Module } from '@nestjs/common';

package/dist/templates/backend/application/src/@config/pdf/index.ts

@@ -0,0 +1 @@
+export * from './pdf-renderer.module.js';

package/dist/templates/backend/application/src/@config/pdf/pdf-renderer.module.spec.ts

@@ -0,0 +1,53 @@
+import { ClassProvider, Provider } from '@nestjs/common';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+import { PdfRendererService } from '@aurora/modules/pdf/index.js';
+import { PdfmakeRendererService } from '@aurora/modules/pdf/pdfmake/index.js';
+
+import { pdfRendererProviderBindings } from './pdf-renderer.module.js';
+
+function findClassBinding(bindings: Provider[], token: unknown): ClassProvider {
+  const binding = bindings.find(
+    (candidate): candidate is ClassProvider =>
+      typeof candidate === 'object' &&
+      candidate !== null &&
+      (candidate as ClassProvider).provide === token,
+  );
+  if (!binding) {
+    throw new Error('No binding found for the requested token');
+  }
+  return binding;
+}
+
+describe('pdfRendererProviderBindings', () => {
+  it('binds PdfRendererService to PdfmakeRendererService by useClass', () => {
+    expect(findClassBinding(pdfRendererProviderBindings, PdfRendererService).useClass).toBe(
+      PdfmakeRendererService,
+    );
+  });
+
+  it('the bound class actually satisfies the PdfRendererService port', () => {
+    // `new binding.useClass()` never throwing proves nothing on its own — ANY zero-arg class would
+    // pass that. What matters is that the bound class extends the abstract port (so DI callers
+    // typed against `PdfRendererService` really get a working `render()`), which a class that
+    // merely shares the name would fail.
+    const binding = findClassBinding(pdfRendererProviderBindings, PdfRendererService);
+    const instance = new binding.useClass();
+
+    expect(instance).toBeInstanceOf(PdfRendererService);
+    expect(typeof instance.render).toBe('function');
+  });
+
+  // Requirement "Exactly one implementation is bound per project, and binding it is a code
+  // decision" (backend-pdf-rendering spec): the choice is a fixed useClass a reviewer reads in a
+  // diff, never a runtime switch. Source-scanned rather than behaviorally tested because "no
+  // environment read, no ternary" is a property of the FILE TEXT, not of any runtime value it
+  // could produce.
+  it('reads no environment variable and branches on nothing to pick the implementation', () => {
+    const source = readFileSync(join(import.meta.dirname, 'pdf-renderer.module.ts'), 'utf8');
+
+    expect(source).not.toMatch(/process\.env/);
+    expect(source).not.toMatch(/\?\s*[A-Za-z]/); // no ternary selecting a class
+  });
+});

package/dist/templates/backend/application/src/@config/pdf/pdf-renderer.module.ts

@@ -0,0 +1,17 @@
+import { PdfRendererService } from '@aurora/modules/pdf/index.js';
+import { PdfmakeRendererService } from '@aurora/modules/pdf/pdfmake/index.js';
+import { Module, Provider } from '@nestjs/common';
+
+// Composition point (D2): the ONLY file that wires the abstract PdfRendererService port to a
+// concrete implementation. Provider selection is a PROJECT decision made HERE, in code, not by an
+// env var — this repo wires pdfmake (D1). A consuming bounded context keeps NO concrete-renderer
+// knowledge; it only imports `PdfRendererModule` below. No module consumes it today.
+export const pdfRendererProviderBindings: Provider[] = [
+  { provide: PdfRendererService, useClass: PdfmakeRendererService },
+];
+
+@Module({
+  providers: [...pdfRendererProviderBindings],
+  exports: [PdfRendererService],
+})
+export class PdfRendererModule {}

package/dist/templates/backend/application/src/@config/storage-account/index.ts

@@ -1 +1 @@
-export { storageAccountProviderBindings } from './storage-account.providers';
+export { storageAccountProviderBindings } from './storage-account.providers.js';

package/dist/templates/backend/application/src/@config/storage-account/storage-account.providers.spec.ts

@@ -1,9 +1,9 @@
 import { ClassProvider, Provider } from '@nestjs/common';
 
-import { StorageAccountFileManagerService } from '@app/storage-account/file-manager';
-import { StorageAccountSharedAccessSignatureService } from '@app/storage-account/shared-access-signature';
+import { StorageAccountFileManagerService } from '@app/storage-account/file-manager/index.js';
+import { StorageAccountSharedAccessSignatureService } from '@app/storage-account/shared-access-signature/index.js';
 
-import { storageAccountProviderBindings } from './storage-account.providers';
+import { storageAccountProviderBindings } from './storage-account.providers.js';
 
 function findClassBinding(bindings: Provider[], token: unknown): ClassProvider {
   const binding = bindings.find(

package/dist/templates/backend/application/src/@config/storage-account/storage-account.providers.ts

@@ -1,11 +1,11 @@
 import {
   StorageAccountFileManagerService,
   StorageAccountLocalFileManagerService,
-} from '@app/storage-account/file-manager';
+} from '@app/storage-account/file-manager/index.js';
 import {
   StorageAccountLocalSharedAccessSignatureService,
   StorageAccountSharedAccessSignatureService,
-} from '@app/storage-account/shared-access-signature';
+} from '@app/storage-account/shared-access-signature/index.js';
 import { Provider } from '@nestjs/common';
 
 // Composition point (D2): the ONLY file that wires each abstract contract

package/dist/templates/backend/application/src/app.controller.spec.ts

@@ -1,6 +1,6 @@
 import { Test, TestingModule } from '@nestjs/testing';
-import { AppController } from './app.controller';
-import { AppService } from './app.service';
+import { AppController } from './app.controller.js';
+import { AppService } from './app.service.js';
 
 describe('AppController', () => {
   let appController: AppController;

package/dist/templates/backend/application/src/app.controller.ts

@@ -1,5 +1,5 @@
 import { Controller, Get } from '@nestjs/common';
-import { AppService } from './app.service';
+import { AppService } from './app.service.js';
 
 @Controller()
 export class AppController {

package/dist/templates/backend/application/src/app.module.ts

@@ -1,20 +1,20 @@
-import { BusinessPartnerPortalModule } from '@api/business-partner-portal/business-partner-portal.module';
-import { CommonModule } from '@api/common/common.module';
-import { ProductionPlanningModule } from '@api/production-planning/production-planning.module';
-import { ReportingModule } from '@api/reporting/reporting.module';
-import { StorageAccountModule } from '@api/storage-account/storage-account.module';
-import { CoreModule } from '@aurora/core.module';
-import { AuthenticationModule, HandlerRegistryModule, HealthModule } from '@aurora/modules';
-import { BridgesModule } from '@bridges/bridges.module';
+import { BusinessPartnerPortalModule } from '@api/business-partner-portal/business-partner-portal.module.js';
+import { CommonModule } from '@api/common/common.module.js';
+import { ProductionPlanningModule } from '@api/production-planning/production-planning.module.js';
+import { ReportingModule } from '@api/reporting/reporting.module.js';
+import { StorageAccountModule } from '@api/storage-account/storage-account.module.js';
+import { CoreModule } from '@aurora/core.module.js';
+import { AuthenticationModule, HandlerRegistryModule, HealthModule } from '@aurora/modules/index.js';
+import { BridgesModule } from '@bridges/bridges.module.js';
 import {
   auroraDrizzleRelations,
   auroraDrizzleSchema,
   auroraFieldSchemas,
   DrizzleMigrationsModule,
-} from '@config/drizzle';
+} from '@config/drizzle/index.js';
 import { Module } from '@nestjs/common';
-import { AppController } from './app.controller';
-import { AppService } from './app.service';
+import { AppController } from './app.controller.js';
+import { AppService } from './app.service.js';
 
 @Module({
   imports: [
@@ -41,7 +41,7 @@ import { AppService } from './app.service';
     BusinessPartnerPortalModule,
     StorageAccountModule,
     ProductionPlanningModule,
-    CommonModule
+    CommonModule,
   ],
   controllers: [AppController],
   providers: [AppService],

package/dist/templates/backend/application/src/database/migrations/0004_remove_null_elements_from_array_columns.sql

@@ -0,0 +1,37 @@
+-- @up
+-- T-33 (evidence: T-29 / PR #122, measured 2026-09-08 on the shared dev
+-- database — iam_account.d_tenants had one row whose 15-element array held
+-- 12 null elements). A stored null element inside an array column breaks its
+-- own GraphQL read: a non-null list type (e.g. `[ID!]!`) nullifies the whole
+-- object the moment one element is null, returning HTTP 200 with the failure
+-- only visible in `errors`. T-29 closed the entry point (ArrayTypeHandler
+-- now rejects a null element on write) but deliberately left already-stored
+-- rows untouched — this migration is the follow-up that cleans them.
+--
+-- Re-measured on 2026-09-12 (pnpm db:query) across every ARRAY column in
+-- `information_schema.columns` (13 columns, 13 tables): only `iam_account.
+-- d_tenants` has a documented incident. No other array column has ever
+-- measured a null element, so only this column is touched here — see
+-- catalyst-tools's migrations guidance against "future-proofing" a migration
+-- over columns with no evidence of the problem.
+--
+-- `d_tenants` is `.notNull()` in the Drizzle schema with no `.default(...)`,
+-- and the Aurora YAML (cliter/iam/account.aurora.yaml) documents the column
+-- as "Required field - empty array indicates no tenant access." An empty
+-- array is therefore an explicit, legal domain state, not an
+-- ambiguous NULL-vs-empty case: `array_remove(d_tenants, NULL)` leaving `{}`
+-- when every element was null is correct and needs no extra branching.
+--
+-- Idempotent by construction: once the null elements are gone,
+-- array_position(d_tenants, NULL) returns NULL and the WHERE clause matches
+-- zero rows on any later run.
+UPDATE iam_account
+SET d_tenants = array_remove(d_tenants, NULL)
+WHERE array_position(d_tenants, NULL) IS NOT NULL;
+
+-- @down
+-- Not reversible: array_remove discards the null elements and their original
+-- positions permanently, so there is no source to restore them from. This is
+-- a documented no-op down-script (the tools migration API requires a
+-- non-empty downScript), not a true rollback.
+SELECT 1;