@mbc-cqrs-serverless/master 1.3.5 → 1.5.0

package/README.md

@@ -44,7 +44,7 @@ import { AppTaskQueueEventFactory } from './task/app-task-queue-event.factory';
     }),
     MasterModule.register({
       enableController: true, // Optional: enable REST endpoints
-      prismaService: PrismaService, // Required when enableController is true
+      prismaService: PrismaService, // Required (MasterDataService/MasterSettingService inject it)
       dataSyncHandlers: [MasterDataSyncHandler], // Optional: custom sync handlers
     }),
   ],
@@ -294,6 +294,50 @@ Full documentation available at [https://mbc-cqrs-serverless.mbc-net.com/](https
 
 - [Master Service Guide](https://mbc-cqrs-serverless.mbc-net.com/docs/master-service)
 
+## Configurable table name
+
+`MasterModule` uses the `master` DynamoDB table by default. Pass `tableName` to
+override it (backward compatible — omitting it keeps `master`). Both
+`register` and `registerAsync` accept it:
+
+> **⚠️ Renaming the master table is not fully supported.** The `master` table is a
+> framework-wide **central config store** — `TtlService` (TTL config) and the
+> `@mbc-cqrs-serverless/sequence` package (numbering formats) read a fixed
+> `master-data` table name. If you override the master `tableName`, those readers
+> keep looking at `master-data`, so TTLs are not applied and sequence formats
+> silently fall back to defaults. `MasterModule.register`/`registerAsync` logs a
+> warning when a custom `tableName` is set. Prefer keeping the default `master`;
+> only override it if you have separately addressed those readers. (Customizing
+> the directory / survey-template / ui-setting table names has no such caveat.)
+
+```ts
+MasterModule.register({
+  enableController: true,
+  prismaService: PrismaService,
+  tableName: 'catalog', // default: 'master' — see the caveat above
+})
+
+MasterModule.registerAsync({
+  tableName: 'catalog',
+  imports: [PrismaModule],
+  inject: [PrismaService], // resolve and return the PrismaService INSTANCE
+  useFactory: (prisma) => ({ prismaService: prisma }),
+})
+```
+
+> **Provisioning:** Add **only the raw base name** (e.g. `"catalog"`) to
+> `prisma/dynamodbs/cqrs.json`; the CLI creates the `-command` / `-data` /
+> `-history` physical tables, and your IaC must define the same three. Note that
+> `@mbc-cqrs-serverless/master`'s postinstall auto-adds only the default `master`
+> name — a custom name must be added manually.
+>
+> **Shared table:** If you also use `@mbc-cqrs-serverless/ui-setting`
+> (`SettingModule`), both modules must use the **same** `tableName`, because they
+> share the same physical table. `MasterModule` should own the data-sync
+> pipeline — register `SettingModule` with `registerEventHandlerAlias: false`.
+> If both modules own the `<tableName>_CommandEventHandler` alias, the app boots
+> but logs a warning and the effective owner becomes import-order dependent.
+
 ## License
 
 Copyright © 2024-2025, Murakami Business Consulting, Inc. [https://www.mbc-net.com/](https://www.mbc-net.com/)

package/dist/master.module-definition.d.ts

@@ -1,9 +1,29 @@
 import { IDataSyncHandler } from '@mbc-cqrs-serverless/core';
-import { Type } from '@nestjs/common';
+import { ModuleMetadata, Type } from '@nestjs/common';
 export declare const PRISMA_SERVICE = "PrismaServiceInjectToken";
 export interface MasterModuleOptions {
     enableController?: boolean;
     dataSyncHandlers?: Type<IDataSyncHandler>[];
     prismaService?: Type<any>;
+    /** DynamoDB base table name. Default: 'master'. */
+    tableName?: string;
+}
+export interface MasterModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    enableController?: boolean;
+    dataSyncHandlers?: Type<IDataSyncHandler>[];
+    tableName?: string;
+    inject?: any[];
+    /**
+     * Resolves the runtime module options. Must return the resolved PrismaService
+     * **instance** under `prismaService` (typically by injecting it), so the master
+     * services (which inject PRISMA_SERVICE) can be constructed. Optional only to
+     * stay assignment-compatible with the inherited `registerAsync` signature;
+     * omitting it makes PRISMA_SERVICE fail fast.
+     */
+    useFactory?: (...args: any[]) => Promise<{
+        prismaService?: any;
+    }> | {
+        prismaService?: any;
+    };
 }
 export declare const ConfigurableModuleClass: import("@nestjs/common").ConfigurableModuleCls<MasterModuleOptions, "register", "create", {}>, MODULE_OPTIONS_TOKEN: string | symbol, OPTIONS_TYPE: MasterModuleOptions & Partial<{}>;

package/dist/master.module-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"master.module-definition.js","sourceRoot":"","sources":["../src/master.module-definition.ts"],"names":[],"mappings":";;;;AACA,2CAA0D;AAG7C,QAAA,cAAc,GAAG,0BAA0B,CAAA;AAQ3C,KACX,IAAI,kCAAyB,EAAuB,CAAC,KAAK,EAAE,EAD/C,+BAAuB,+BAAE,4BAAoB,4BAAE,oBAAY,mBACZ"}
+{"version":3,"file":"master.module-definition.js","sourceRoot":"","sources":["../src/master.module-definition.ts"],"names":[],"mappings":";;;;AACA,2CAAgF;AAEnE,QAAA,cAAc,GAAG,0BAA0B,CAAA;AA4B3C,KACX,IAAI,kCAAyB,EAAuB,CAAC,KAAK,EAAE,EAD/C,+BAAuB,+BAAE,4BAAoB,4BAAE,oBAAY,mBACZ"}

package/dist/master.module.d.ts

@@ -1,5 +1,13 @@
 import { DynamicModule } from '@nestjs/common';
-import { ConfigurableModuleClass, OPTIONS_TYPE } from './master.module-definition';
+import { ConfigurableModuleClass, MasterModuleAsyncOptions, OPTIONS_TYPE } from './master.module-definition';
 export declare class MasterModule extends ConfigurableModuleClass {
+    private static readonly logger;
+    /**
+     * The `master` table is a framework-wide central config store: `TtlService`
+     * (TTL config) and the sequence package (numbering formats) read the fixed
+     * `master-data` table. Renaming it silently breaks those readers, so warn.
+     */
+    private static warnIfCustomTable;
     static register(options: typeof OPTIONS_TYPE): DynamicModule;
+    static registerAsync(options: MasterModuleAsyncOptions): DynamicModule;
 }

package/dist/master.module.js

@@ -5,6 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var MasterModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MasterModule = void 0;
 const core_1 = require("@mbc-cqrs-serverless/core");
@@ -16,46 +17,82 @@ const custom_task_module_1 = require("./custom-task/custom-task.module");
 const master_sfn_task_handler_1 = require("./handler/master-sfn-task.handler");
 const master_module_definition_1 = require("./master.module-definition");
 const services_1 = require("./services");
-let MasterModule = class MasterModule extends master_module_definition_1.ConfigurableModuleClass {
+let MasterModule = MasterModule_1 = class MasterModule extends master_module_definition_1.ConfigurableModuleClass {
+    /**
+     * The `master` table is a framework-wide central config store: `TtlService`
+     * (TTL config) and the sequence package (numbering formats) read the fixed
+     * `master-data` table. Renaming it silently breaks those readers, so warn.
+     */
+    static warnIfCustomTable(tableName) {
+        if (tableName && tableName !== constants_1.TABLE_NAME) {
+            MasterModule_1.logger.warn(`tableName '${tableName}' overrides the 'master' table, which is also read ` +
+                `at a fixed 'master-data' name by TtlService (TTL config) and the sequence ` +
+                `package (numbering formats). Renaming the master table is not fully ` +
+                `supported — TTL and sequence formats will silently fall back. Also, if you ` +
+                `use ui-setting's SettingModule, set its tableName to '${tableName}' too ` +
+                `(they share this table). Keep the default 'master' unless you have ` +
+                `addressed those readers.`);
+        }
+    }
     static register(options) {
-        const module = super.register(options);
+        MasterModule_1.warnIfCustomTable(options.tableName);
+        const base = super.register(options);
+        const providers = [...(base.providers ?? [])];
+        const controllers = [...(base.controllers ?? [])];
+        const imports = [...(base.imports ?? [])];
+        // The master services inject PRISMA_SERVICE unconditionally.
+        providers.push((0, core_1.buildPrismaProviderSync)(options.prismaService, master_module_definition_1.PRISMA_SERVICE));
+        // Data-sync handlers are registered here (not inside CommandModule) so they
+        // can resolve PRISMA_SERVICE from this module's scope.
+        const handlers = options.dataSyncHandlers ?? [];
+        providers.push(...handlers);
+        if (options.enableController) {
+            controllers.push(controllers_1.MasterBulkController, controllers_1.MasterDataController, controllers_1.MasterSettingController);
+            providers.push(master_sfn_task_handler_1.MasterSfnTaskEventHandler);
+            imports.push(custom_task_module_1.CustomTaskModule, sequence_1.SequencesModule);
+        }
+        imports.push((0, core_1.buildDomainCommandModule)(constants_1.TABLE_NAME, {
+            tableName: options.tableName,
+            dataSyncHandlers: handlers,
+        }));
+        return { ...base, providers, controllers, imports };
+    }
+    static registerAsync(options) {
+        MasterModule_1.warnIfCustomTable(options.tableName);
+        const base = super.registerAsync({
+            imports: options.imports,
+            inject: options.inject ?? [],
+            useFactory: async (...args) => {
+                const resolved = (await options.useFactory?.(...args)) ?? {};
+                return {
+                    ...resolved,
+                    enableController: options.enableController,
+                    dataSyncHandlers: options.dataSyncHandlers,
+                    tableName: options.tableName ?? constants_1.TABLE_NAME,
+                };
+            },
+        });
+        const providers = [...(base.providers ?? [])];
+        const controllers = [...(base.controllers ?? [])];
+        const imports = [...(base.imports ?? [])];
+        providers.push((0, core_1.buildPrismaProviderAsync)(master_module_definition_1.MODULE_OPTIONS_TOKEN, master_module_definition_1.PRISMA_SERVICE));
+        const handlers = options.dataSyncHandlers ?? [];
+        providers.push(...handlers);
         if (options.enableController) {
-            if (!options.prismaService) {
-                throw new Error('PrismaService must be provided when enableController is true.');
-            }
-            if (!module.controllers) {
-                module.controllers = [];
-            }
-            module.controllers.push(controllers_1.MasterBulkController);
-            module.controllers.push(controllers_1.MasterDataController);
-            module.controllers.push(controllers_1.MasterSettingController);
-            if (!module.providers) {
-                module.providers = [];
-            }
-            module.providers.push({
-                provide: master_module_definition_1.PRISMA_SERVICE,
-                useExisting: options.prismaService,
-            });
-            module.providers.push(master_sfn_task_handler_1.MasterSfnTaskEventHandler);
-            if (!module.imports) {
-                module.imports = [];
-            }
-            module.imports.push(custom_task_module_1.CustomTaskModule);
-            module.imports.push(sequence_1.SequencesModule);
+            controllers.push(controllers_1.MasterBulkController, controllers_1.MasterDataController, controllers_1.MasterSettingController);
+            providers.push(master_sfn_task_handler_1.MasterSfnTaskEventHandler);
+            imports.push(custom_task_module_1.CustomTaskModule, sequence_1.SequencesModule);
         }
-        const imports = [...(module.imports ?? [])];
-        imports.push(core_1.CommandModule.register({
-            tableName: constants_1.TABLE_NAME,
-            dataSyncHandlers: options?.dataSyncHandlers,
+        imports.push((0, core_1.buildDomainCommandModule)(constants_1.TABLE_NAME, {
+            tableName: options.tableName,
+            dataSyncHandlers: handlers,
         }));
-        return {
-            ...module,
-            imports,
-        };
+        return { ...base, providers, controllers, imports };
     }
 };
 exports.MasterModule = MasterModule;
-exports.MasterModule = MasterModule = __decorate([
+MasterModule.logger = new common_1.Logger(MasterModule_1.name);
+exports.MasterModule = MasterModule = MasterModule_1 = __decorate([
     (0, common_1.Module)({
         imports: [core_1.DataStoreModule, core_1.QueueModule],
         providers: [services_1.MasterDataService, services_1.MasterSettingService],

package/dist/master.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"master.module.js","sourceRoot":"","sources":["../src/master.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAIkC;AAClC,4DAA+D;AAC/D,2CAAsD;AAEtD,2CAAwC;AACxC,+CAIsB;AACtB,yEAAmE;AACnE,+EAA6E;AAC7E,yEAImC;AACnC,yCAAoE;AAO7D,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,kDAAuB;IACvD,MAAM,CAAC,QAAQ,CAAC,OAA4B;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAEtC,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAA;YACH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBACxB,MAAM,CAAC,WAAW,GAAG,EAAE,CAAA;YACzB,CAAC;YACD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,kCAAoB,CAAC,CAAA;YAC7C,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,kCAAoB,CAAC,CAAA;YAC7C,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,qCAAuB,CAAC,CAAA;YAEhD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,CAAC,SAAS,GAAG,EAAE,CAAA;YACvB,CAAC;YAED,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;gBACpB,OAAO,EAAE,yCAAc;gBACvB,WAAW,EAAE,OAAO,CAAC,aAAa;aACnC,CAAC,CAAA;YACF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,mDAAyB,CAAC,CAAA;YAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,OAAO,GAAG,EAAE,CAAA;YACrB,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,qCAAgB,CAAC,CAAA;YACrC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,0BAAe,CAAC,CAAA;QACtC,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAA;QAE3C,OAAO,CAAC,IAAI,CACV,oBAAa,CAAC,QAAQ,CAAC;YACrB,SAAS,EAAE,sBAAU;YACrB,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;SAC5C,CAAC,CACH,CAAA;QAED,OAAO;YACL,GAAG,MAAM;YACT,OAAO;SACR,CAAA;IACH,CAAC;CACF,CAAA;AA/CY,oCAAY;uBAAZ,YAAY;IALxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,EAAE,kBAAW,CAAC;QACvC,SAAS,EAAE,CAAC,4BAAiB,EAAE,+BAAoB,CAAC;QACpD,OAAO,EAAE,CAAC,4BAAiB,EAAE,+BAAoB,CAAC;KACnD,CAAC;GACW,YAAY,CA+CxB"}
+{"version":3,"file":"master.module.js","sourceRoot":"","sources":["../src/master.module.ts"],"names":[],"mappings":"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"}

package/dist/master.module.spec.d.ts

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

package/dist/master.module.spec.js

@@ -0,0 +1,136 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@mbc-cqrs-serverless/core");
+const task_1 = require("@mbc-cqrs-serverless/task");
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const testing_1 = require("@nestjs/testing");
+const master_module_1 = require("./master.module");
+const services_1 = require("./services");
+class MockPrismaService {
+    constructor() {
+        this.kind = 'instance';
+    }
+}
+/**
+ * Provides the globally-scoped dependencies a real app supplies. PrismaService
+ * is provided via an ASYNC factory (mirroring PrismaModule.forRootAsync) so the
+ * registerAsync path is exercised against the realistic ordering where the
+ * Prisma instance is not available synchronously.
+ */
+let SupportModule = class SupportModule {
+};
+SupportModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [
+            config_1.ConfigModule.forRoot({
+                isGlobal: true,
+                ignoreEnvFile: true,
+                load: [() => ({ NODE_ENV: 'local', APP_NAME: 'app' })],
+            }),
+        ],
+        providers: [
+            core_1.StepFunctionService,
+            { provide: task_1.TaskService, useValue: {} },
+            {
+                provide: MockPrismaService,
+                useFactory: async () => {
+                    await new Promise((r) => setTimeout(r, 5));
+                    return new MockPrismaService();
+                },
+            },
+        ],
+        exports: [core_1.StepFunctionService, task_1.TaskService, MockPrismaService],
+    })
+], SupportModule);
+describe('MasterModule', () => {
+    afterEach(() => jest.restoreAllMocks());
+    describe('register (sync)', () => {
+        it('forwards the default table name to CommandModule', () => {
+            const spy = jest.spyOn(core_1.CommandModule, 'register');
+            master_module_1.MasterModule.register({ prismaService: MockPrismaService });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({ tableName: 'master' }));
+        });
+        it('forwards a custom table name to CommandModule', () => {
+            const spy = jest.spyOn(core_1.CommandModule, 'register');
+            master_module_1.MasterModule.register({
+                prismaService: MockPrismaService,
+                tableName: 'custom-master',
+            });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({ tableName: 'custom-master' }));
+        });
+        it('throws fast when prismaService is missing', () => {
+            expect(() => master_module_1.MasterModule.register({})).toThrow(/prismaService/);
+        });
+        it('warns that renaming the central master table breaks TTL/sequence config', () => {
+            const warnSpy = jest.spyOn(common_1.Logger.prototype, 'warn');
+            master_module_1.MasterModule.register({
+                prismaService: MockPrismaService,
+                tableName: 'catalog',
+            });
+            expect(warnSpy).toHaveBeenCalledWith(expect.stringMatching(/central config|master-data|not fully supported/));
+        });
+        it('does not warn for the default master table', () => {
+            const warnSpy = jest.spyOn(common_1.Logger.prototype, 'warn');
+            master_module_1.MasterModule.register({ prismaService: MockPrismaService });
+            expect(warnSpy).not.toHaveBeenCalledWith(expect.stringMatching(/not fully supported/));
+        });
+    });
+    describe('registerAsync', () => {
+        it('resolves an async-provided PrismaService instance (not null)', async () => {
+            const moduleRef = await testing_1.Test.createTestingModule({
+                imports: [
+                    SupportModule,
+                    master_module_1.MasterModule.registerAsync({
+                        inject: [MockPrismaService],
+                        useFactory: (prisma) => ({
+                            prismaService: prisma,
+                        }),
+                    }),
+                ],
+            }).compile();
+            await moduleRef.init();
+            const svc = moduleRef.get(services_1.MasterDataService);
+            expect(svc).toBeDefined();
+            // Regression: the injected PRISMA_SERVICE must be the resolved instance,
+            // not null (async Prisma) and not the class reference.
+            expect(svc.prismaService).toBeInstanceOf(MockPrismaService);
+            expect(svc.prismaService.kind).toBe('instance');
+            await moduleRef.close();
+        });
+        it('forwards a custom table name via registerAsync', () => {
+            const spy = jest.spyOn(core_1.CommandModule, 'register');
+            master_module_1.MasterModule.registerAsync({
+                inject: [],
+                useFactory: () => ({ prismaService: new MockPrismaService() }),
+                tableName: 'custom-master',
+            });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({ tableName: 'custom-master' }));
+        });
+        it('rejects a useFactory that returns the PrismaService class instead of an instance', async () => {
+            await expect(testing_1.Test.createTestingModule({
+                imports: [
+                    SupportModule,
+                    master_module_1.MasterModule.registerAsync({
+                        inject: [],
+                        // wrong: returns the class, not an instance
+                        useFactory: () => ({ prismaService: MockPrismaService }),
+                    }),
+                ],
+            }).compile()).rejects.toThrow(/CLASS, not an instance/);
+        });
+    });
+    describe('CommandModule.registerAsync guard', () => {
+        it('throws a clear error (not supported)', () => {
+            expect(() => core_1.CommandModule.registerAsync({})).toThrow(/not supported/);
+        });
+    });
+});
+//# sourceMappingURL=master.module.spec.js.map

package/dist/master.module.spec.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mbc-cqrs-serverless/master",
-  "version": "1.3.5",
+  "version": "1.5.0",
   "description": " Master data management such as setting, sequence, etc.",
   "keywords": [
     "mbc",
@@ -43,10 +43,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@mbc-cqrs-serverless/core": "1.3.5",
-    "@mbc-cqrs-serverless/sequence": "1.3.5",
-    "@mbc-cqrs-serverless/task": "1.3.5",
+    "@mbc-cqrs-serverless/core": "1.5.0",
+    "@mbc-cqrs-serverless/sequence": "1.5.0",
+    "@mbc-cqrs-serverless/task": "1.5.0",
     "ulid": "^2.3.0"
   },
-  "gitHead": "ec9f5438d64b3bcc7c62feb1327acc652e4c1aad"
+  "gitHead": "eafabfd2770916ea4e9f954f614f8dc5ac4e10b2"
 }

package/src/templates/master/master.module.ts

@@ -1,4 +1,3 @@
-import { CommandModule } from '@mbc-cqrs-serverless/core'
 import { MasterModule as CoreMasterModule } from '@mbc-cqrs-serverless/master'
 import { Module } from '@nestjs/common'
 import { PrismaService } from 'src/prisma'
@@ -7,10 +6,6 @@ import { MasterDataSyncRdsHandler } from './handler/master-rds.handler'
 
 @Module({
   imports: [
-    CommandModule.register({
-      tableName: 'master',
-      dataSyncHandlers: [MasterDataSyncRdsHandler],
-    }),
     CoreMasterModule.register({
       enableController: true,
       prismaService: PrismaService,