Master

The Master Service provides functionality for managing master data and settings in a multi-tenant environment

Overview

The Master Service consists of two main components:

Master Setting Service

Implements hierarchical settings management
Supports creation of settings at all levels
Provides update and delete operations for tenant settings
Implements cascading settings retrieval

Master Data Service

Implements CRUD operations for master data entities
Provides list and retrieval functionality
Includes code validation capabilities
Ensures data integrity across tenant boundaries

Architecture

Installation

npm install @mbc-cqrs-serverless/master

Basic Usage

The solution for customizing the behavior of the MasterModule is to pass it an options object in the static register() method.

Module Options

Option	Type	Description
`enableController`	`boolean`	Enable or disable default master controller
`dataSyncHandlers`	`Type<IDataSyncHandler>[]`	Optional handlers to sync master data to external systems (e.g., RDS)
`prismaService`	`Type<any>`	Prisma service for RDS-backed queries. Required when `enableController: true`

prismaService Requirement

When enableController: true, the prismaService parameter is required. The module will throw an error at startup if prismaService is not provided when the controller is enabled.

import { MasterModule } from '@mbc-cqrs-serverless/master'

@Module({
  imports: [ MasterModule.register({
      enableController: true,
      dataSyncHandlers: [MasterDataRdsSyncHandler],
      prismaService: PrismaService,
    })],
  controllers: [],
  exports: [],
})

API Reference

MasterSettingService

The MasterSettingService interface manages settings at various levels user, group, tenant, common. It allows retrieving, updating, creating, and deleting settings.

`getSetting(dto: GetSettingDto, context: { invokeContext: IInvoke }): Promise<MasterSettingEntity>`

Retrieves a specific setting based on the provided setting code.

const masterSetting = await this.masterSettingService.getSetting(
  {
    code: "service",
  },
  { invokeContext }
);

`createCommonTenantSetting(dto: CommonSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

Creates a common tenant setting that is shared across the system.

const masterSetting = await this.masterSettingService.createCommonTenantSetting(
  {
    name: "common setting",
    code: "service",
    settingValue: {
      region: "US",
      plan: "common"
    }
  },
  { invokeContext }
);

`createTenantSetting(dto: TenantSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

Creates a tenant-specific setting.

const masterSetting = await this.masterSettingService.createTenantSetting(
  {
    name: "tenant setting",
    code: "service",
    tenantCode: "mbc",
    settingValue: {
      region: "US",
      plan: "tenant"
    }
  },
  { invokeContext }
);

`createGroupSetting(dto: GroupSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

Creates a group-specific setting within a tenant.

const masterSetting = await this.masterSettingService.createGroupSetting(
  {
    name: "group setting",
    code: "service",
    tenantCode: "mbc",
    groupId: "12",
    settingValue: {
      region: "US",
      plan: "USER"
    }
  },
  { invokeContext }
);

`createUserSetting(dto: UserSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

Creates a user-specific setting within a tenant.

const masterSetting = await this.masterSettingService.createUserSetting(
  {
    name: "user setting",
    code: "service",
    tenantCode: "mbc",
    userId: "92ca4f68-9ac6-4080-9ae2-2f02a86206a4",
    settingValue: {
      region: "US",
      plan: "USER"
    }
  },
  { invokeContext }
);

`updateSetting(params: DetailKey, dto: UpdateSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

Updates an existing setting.

const masterSetting = await this.masterSettingService.updateSetting(
  {
    pk: "MASTER#abc",
    sk: "MASTER_SETTING#service"
  },
  {
    name: 'Example Master Setting',
    settingValue: {
      homepage: "url",
      desc: "string"
    }
  },
  { invokeContext }
);

`deleteSetting(key: DetailKey, context: { invokeContext: IInvoke }): Promise<CommandModel>`

Deletes a specific setting based on the provided key.

const masterSetting = await this.masterSettingService.deleteSetting(
  {
    pk: "MASTER#abc",
    sk: "MASTER_SETTING#service"
  },
  { invokeContext }
);

`list(searchDto: MasterSettingSearchDto, invokeContext: IInvoke): Promise<MasterRdsListEntity>`

Lists master settings with pagination and filtering. Requires RDS (Prisma) configuration.

const result = await this.masterSettingService.list(
  {
    name: "service",           // Partial match for name
    code: "SVC",               // Partial match for code
    keyword: "description",    // Search in attributes.description
    page: 1,
    pageSize: 10,
    orderBys: ["-createdAt"],
  },
  invokeContext
);

`getDetail(key: DetailDto): Promise<MasterRdsEntity>`

Retrieves detailed master setting. Throws NotFoundException if not found.

const masterSetting = await this.masterSettingService.getDetail({
  pk: "MASTER#mbc",
  sk: "MASTER_SETTING#service"
});

`create(createDto: CommonSettingDto, invokeContext: IInvoke): Promise<CommandModel>`

Creates a new tenant setting. Wrapper for createTenantSetting with automatic tenant code extraction from context.

const masterSetting = await this.masterSettingService.create(
  {
    code: "service",
    name: "Service Setting",
    settingValue: { key: "value" }
  },
  invokeContext
);

`createBulk(createDto: CommonSettingBulkDto, invokeContext: IInvoke): Promise<CommandModel[]>`

Creates multiple settings at once.

Create-only Operation

createBulk internally calls create for each item, which throws a BadRequestException if the setting already exists (e.g., "Setting already exists: {code}"). This method cannot be used to update existing settings. If you need upsert behavior (create or update), see the Upsert Pattern section below.

const settings = await this.masterSettingService.createBulk(
  {
    items: [
      { code: "setting1", name: "Setting 1", settingValue: {} },
      { code: "setting2", name: "Setting 2", settingValue: {} }
    ]
  },
  invokeContext
);

`update(key: DetailDto, updateDto: MasterSettingUpdateDto, invokeContext: IInvoke): Promise<CommandModel>`

Updates a master setting.

const result = await this.masterSettingService.update(
  { pk: "MASTER#mbc", sk: "MASTER_SETTING#service" },
  {
    name: "Updated Setting",
    attributes: { newKey: "newValue" }
  },
  invokeContext
);

`delete(key: DetailDto, invokeContext: IInvoke): Promise<CommandModel>`

Deletes a master setting. Wrapper for deleteSetting.

await this.masterSettingService.delete(
  { pk: "MASTER#mbc", sk: "MASTER_SETTING#service" },
  invokeContext
);

`checkExistCode(code: string, invokeContext: IInvoke): Promise<boolean>`

Checks if a setting code already exists for the current tenant.

const exists = await this.masterSettingService.checkExistCode("service", invokeContext);
if (exists) {
  // Handle duplicate code
}

`copy(masterCopyDto: MasterCopyDto, opts: { invokeContext: IInvoke }): Promise<any>`

Copies master settings and data to other tenants asynchronously using Step Functions. This is useful for initializing new tenants with existing master data.

const task = await this.masterSettingService.copy(
  {
    masterSettingId: "MASTER#mbc#MASTER_SETTING#service",
    targetTenants: ["tenant1", "tenant2"],
    copyType: CopyType.BOTH,   // CopyType.SETTING_ONLY, CopyType.DATA_ONLY, or CopyType.BOTH
    dataCopyOption: {
      mode: DataCopyMode.ALL,  // or DataCopyMode.PARTIAL
      // id: ["id1", "id2"]    // Required when mode is PARTIAL
    }
  },
  { invokeContext }
);
// Returns a task entity - the copy operation runs asynchronously

Copy types:

CopyType.SETTING_ONLY: Copies only the setting
CopyType.DATA_ONLY: Copies only the data
CopyType.BOTH: Copies both setting and data

Data copy modes (used when copyType is DATA_ONLY or BOTH):

DataCopyMode.ALL: Copies all master data under the setting
DataCopyMode.PARTIAL: Copies only specified IDs

MasterDataService

The MasterDataService service provides methods to manage master data and operations. This includes listing, retrieving, creating, updating, and deleting data, as well as checking for the existence of specific codes.

`list(searchDto: MasterDataSearchDto): Promise<MasterDataListEntity>`

Lists master data based on the provided search criteria. Note: This method does not require an invoke context.

const masterData = await this.masterDataService.list({
  tenantCode: "mbc",
  settingCode: "service"
});

`get(key: DetailDto): Promise<MasterDataEntity>`

Get a master data by pk and sk.

const masterData = await this.masterDataService.get(
  {
    pk:"MASTER#abc", 
    sk:"MASTER_DATA#service#01"
  }
);

`create(data: CreateMasterDataDto, context: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

Creates a new master data entity

const masterData = await this.masterDataService.create(
  {
    code: 'MASTER001',
    name: 'Example Master Data',
    settingCode: "service",
    tenantCode: "common",
    attributes: {
      homepage: "http://mbc.com",
      desc: "description for mbc"
    }
  },
  { invokeContext }
);

`update(key: DetailDto, updateDto: UpdateDataSettingDto, context: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

Updates existing master data.

const masterData = await this.masterDataService.update(
  {
    pk: "MASTER#abc",
    sk: "MASTER_DATA#service#01"
  },
  {
    name: 'Example Master Data',
    attributes: {
      homepage: "http://mbc.com",
      desc: "description for mbc"
    }
  },
  { invokeContext }
);

`delete(key: DetailDto, opts: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

Deletes specific master data based on the provided key.

const masterData = await this.masterDataService.delete(
  {
    pk: "MASTER#abc",
    sk: "MASTER_DATA#service#01"
  },
  { invokeContext }
);

`checkExistCode(tenantCode: string, type: string, code: string): Promise<boolean>`

Checks if a specific code exists within the given tenant and type.

const exists = await this.masterDataService.checkExistCode("mbc", "service", "01");
if (exists) {
  // Handle existing code
}

`getDetail(key: DetailDto): Promise<MasterRdsEntity>`

Retrieves detailed master data including related information. Throws NotFoundException if not found.

const masterData = await this.masterDataService.getDetail({
  pk: "MASTER#mbc",
  sk: "MASTER_DATA#service#01"
});

`createSetting(createDto: MasterDataCreateDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

Creates a new master data entity with automatic sequence generation if not provided.

Create-only Operation

createSetting throws a BadRequestException if the master data already exists (e.g., "Master data already exists: {code}"). If you need upsert behavior (create or update), see the Upsert Pattern section below.

const masterData = await this.masterDataService.createSetting(
  {
    code: 'MASTER001',
    name: 'Example Master Data',
    settingCode: "service",
    tenantCode: "mbc",
    attributes: {
      homepage: "http://mbc.com",
      desc: "description for mbc"
    }
  },
  invokeContext
);

`createBulk(createDto: MasterDataCreateBulkDto, invokeContext: IInvoke): Promise<MasterDataEntity[]>`

Creates multiple master data entities in bulk.

Create-only Operation

createBulk internally calls createSetting for each item. It throws a BadRequestException if any item already exists. If you need upsert behavior, see the Upsert Pattern section below.

const masterDataList = await this.masterDataService.createBulk(
  {
    items: [
      {
        code: 'MASTER001',
        name: 'First Master Data',
        settingCode: "service",
        tenantCode: "mbc",
        attributes: {}
      },
      {
        code: 'MASTER002',
        name: 'Second Master Data',
        settingCode: "service",
        tenantCode: "mbc",
        attributes: {}
      }
    ]
  },
  invokeContext
);

`updateSetting(key: DetailDto, updateDto: MasterDataUpdateDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

Updates an existing master data entity.

const masterData = await this.masterDataService.updateSetting(
  {
    pk: "MASTER#mbc",
    sk: "MASTER_DATA#service#01"
  },
  {
    name: 'Updated Master Data',
    attributes: {
      homepage: "http://updated-mbc.com"
    }
  },
  invokeContext
);

`deleteSetting(key: DetailDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

Deletes a master data entity by key.

const result = await this.masterDataService.deleteSetting(
  {
    pk: "MASTER#mbc",
    sk: "MASTER_DATA#service#01"
  },
  invokeContext
);

`listByRds(searchDto: CustomMasterDataSearchDto, context: { invokeContext: IInvoke }): Promise<MasterRdsListEntity>`

Searches master data in RDS with filtering and pagination. This method is used when Prisma service is configured.

const result = await this.masterDataService.listByRds(
  {
    settingCode: "service",    // Exact match for master type code
    keyword: "example",        // Partial match (case-insensitive) for name
    code: "001",               // Partial match (case-insensitive) for master code
    page: 1,
    pageSize: 10,
    orderBys: ["seq", "masterCode"],
  },
  { invokeContext }
);

Search Parameters

Parameter	Type	Required	Match Type	Description
`settingCode`	`string`	No	Exact match	Filter by master type code (masterTypeCode)
`keyword`	`string`	No	Partial match (case-insensitive)	Filter by name field
`code`	`string`	No	Partial match (case-insensitive)	Filter by master code
`page`	`number`	No	-	Page number (default: 1)
`pageSize`	`number`	No	-	Items per page (default: 10)
`orderBys`	`string[]`	No	-	Sort order (default: ["seq", "masterCode"])
`isDeleted`	`boolean`	No	Exact match	Filter by deletion status

Known Issue (Fixed in v1.0.17)

In versions prior to v1.0.17, the settingCode parameter incorrectly used partial matching (contains) instead of exact matching. This caused unintended search results - for example, searching for "PRODUCT" would also return "PRODUCT_TYPE" and "MY_PRODUCT".

If you are using v1.0.16 or earlier and need exact matching for settingCode, upgrade to v1.0.17 or later.

Built-in Upsert API

The framework provides built-in upsert methods that automatically handle both creating new records and updating existing ones. These methods check DynamoDB for existing data and decide whether to create or update, skipping unchanged records for efficiency.

Version Note

Built-in upsert methods (upsert, upsertBulk, upsertSetting, upsertTenantSetting) were added in version 1.1.2. In earlier versions, you need to implement custom upsert logic (see Legacy Upsert Pattern below).

MasterSettingService Upsert Methods

`upsertTenantSetting(dto: TenantSettingDto, options: { invokeContext: IInvoke }): Promise<CommandModel>`

Creates or updates a tenant setting. If the setting exists and has changes, it updates. If the setting exists but is unchanged, it returns the existing data without creating a new command. If the setting is deleted, it recreates it.

const result = await this.masterSettingService.upsertTenantSetting(
  {
    tenantCode: "mbc",
    code: "service",
    name: "Service Setting",
    settingValue: { region: "US", plan: "Premium" },
  },
  { invokeContext }
);

`upsertSetting(createDto: CommonSettingDto, invokeContext: IInvoke): Promise<CommandModel>`

Wrapper for upsertTenantSetting with automatic tenant code extraction from context.

const result = await this.masterSettingService.upsertSetting(
  {
    code: "service",
    name: "Service Setting",
    settingValue: { region: "US", plan: "Premium" },
  },
  invokeContext
);

`upsertBulk(createDto: CommonSettingBulkDto, invokeContext: IInvoke): Promise<CommandModel[]>`

Upserts multiple settings sequentially. Items are processed one by one to avoid race conditions.

const results = await this.masterSettingService.upsertBulk(
  {
    items: [
      { code: "setting1", name: "Setting 1", settingValue: { key: "value1" } },
      { code: "setting2", name: "Setting 2", settingValue: { key: "value2" } },
    ]
  },
  invokeContext
);

MasterDataService Upsert Methods

`upsert(createDto: CreateMasterDataDto, opts: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

Creates or updates a master data entity. Behaves the same as create but does not throw when the record already exists.

const result = await this.masterDataService.upsert(
  {
    code: 'MASTER001',
    name: 'Example Master Data',
    settingCode: "service",
    tenantCode: "mbc",
    attributes: { homepage: "http://mbc.com" },
  },
  { invokeContext }
);

`upsertSetting(createDto: MasterDataCreateDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

Wrapper for upsert with automatic sequence generation and tenant code extraction.

const result = await this.masterDataService.upsertSetting(
  {
    code: 'MASTER001',
    name: 'Example Master Data',
    settingCode: "service",
    attributes: { homepage: "http://mbc.com" },
  },
  invokeContext
);

`upsertBulk(createDto: MasterDataCreateBulkDto, invokeContext: IInvoke): Promise<MasterDataEntity[]>`

Upserts multiple master data entities sequentially. Items are processed one by one to avoid seq race conditions.

const results = await this.masterDataService.upsertBulk(
  {
    items: [
      { code: 'DATA001', name: 'First Data', settingCode: "service", attributes: {} },
      { code: 'DATA002', name: 'Second Data', settingCode: "service", attributes: {} },
    ]
  },
  invokeContext
);

Unified Bulk Upsert API (MasterBulkController)

When the controller is enabled (enableController: true), the framework provides a unified /api/master-bulk/ endpoint that can handle both settings and data in a single request. Items are routed based on the presence of settingCode:

With settingCode: Routed to MasterDataService.upsertBulk
Without settingCode: Routed to MasterSettingService.upsertBulk

// POST /api/master-bulk/
const requestBody = {
  items: [
    // This item has settingCode → treated as master data
    {
      name: "Data Item",
      code: "DATA001",
      settingCode: "UserList",
      seq: 1,
      attributes: { field: "value" },
    },
    // This item has no settingCode → treated as master setting
    {
      name: "Setting Item",
      code: "SettingA",
      attributes: { description: "A setting" },
    },
  ]
};

The response preserves the original input order. Tenant code validation is enforced: if tenantCode is specified in an item, it must match the authenticated user's tenant.

Request Body

Field	Type	Required	Description
`items`	`MasterBulkItemDto[]`	Yes	Array of items to upsert (max 100)

MasterBulkItemDto

Field	Type	Required	Description
`name`	`string`	Yes	Name of the setting or data
`code`	`string`	Yes	Code of the setting or data
`tenantCode`	`string`	No	Tenant code (must match authenticated user's tenant if specified)
`settingCode`	`string`	No	If present, item is treated as master data; otherwise as master setting
`seq`	`number`	No	Sort order (used for master data)
`attributes`	`object`	Yes	Attributes object. For settings, this is used as settingValue

Upsert Behavior Details

The upsert methods follow these rules:

New record: If no existing record is found, creates a new one (version starts at 0)
Existing record with changes: If the record exists and the input differs, updates it using the existing version number
Existing record unchanged: If the record exists and the input is identical, skips the update and returns the existing data
Deleted record: If the record exists but is marked as deleted (isDeleted: true), recreates it using the existing version number

Legacy Upsert Pattern

Deprecated Pattern

The custom upsert pattern below was required in versions prior to 1.1.2. For new projects, use the built-in upsert methods instead.

For versions prior to 1.1.2, implement a custom upsert service that checks for existing records before deciding whether to call create or update. See the v1.1.1 documentation for the full legacy pattern.

Overview​

Master Setting Service​

Master Data Service​

Architecture​

Installation​

Basic Usage​

Module Options​

API Reference​

MasterSettingService​

getSetting(dto: GetSettingDto, context: { invokeContext: IInvoke }): Promise<MasterSettingEntity>​

createCommonTenantSetting(dto: CommonSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>​

createTenantSetting(dto: TenantSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>​

createGroupSetting(dto: GroupSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>​

createUserSetting(dto: UserSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>​

updateSetting(params: DetailKey, dto: UpdateSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>​

deleteSetting(key: DetailKey, context: { invokeContext: IInvoke }): Promise<CommandModel>​

list(searchDto: MasterSettingSearchDto, invokeContext: IInvoke): Promise<MasterRdsListEntity>​

getDetail(key: DetailDto): Promise<MasterRdsEntity>​

create(createDto: CommonSettingDto, invokeContext: IInvoke): Promise<CommandModel>​

createBulk(createDto: CommonSettingBulkDto, invokeContext: IInvoke): Promise<CommandModel[]>​

update(key: DetailDto, updateDto: MasterSettingUpdateDto, invokeContext: IInvoke): Promise<CommandModel>​

delete(key: DetailDto, invokeContext: IInvoke): Promise<CommandModel>​

checkExistCode(code: string, invokeContext: IInvoke): Promise<boolean>​

copy(masterCopyDto: MasterCopyDto, opts: { invokeContext: IInvoke }): Promise<any>​

MasterDataService​

list(searchDto: MasterDataSearchDto): Promise<MasterDataListEntity>​

get(key: DetailDto): Promise<MasterDataEntity>​

create(data: CreateMasterDataDto, context: { invokeContext: IInvoke }): Promise<MasterDataEntity>​

update(key: DetailDto, updateDto: UpdateDataSettingDto, context: { invokeContext: IInvoke }): Promise<MasterDataEntity>​

delete(key: DetailDto, opts: { invokeContext: IInvoke }): Promise<MasterDataEntity>​

checkExistCode(tenantCode: string, type: string, code: string): Promise<boolean>​

getDetail(key: DetailDto): Promise<MasterRdsEntity>​

createSetting(createDto: MasterDataCreateDto, invokeContext: IInvoke): Promise<MasterDataEntity>​

createBulk(createDto: MasterDataCreateBulkDto, invokeContext: IInvoke): Promise<MasterDataEntity[]>​

updateSetting(key: DetailDto, updateDto: MasterDataUpdateDto, invokeContext: IInvoke): Promise<MasterDataEntity>​

deleteSetting(key: DetailDto, invokeContext: IInvoke): Promise<MasterDataEntity>​

listByRds(searchDto: CustomMasterDataSearchDto, context: { invokeContext: IInvoke }): Promise<MasterRdsListEntity>​

Search Parameters​

Built-in Upsert API​

MasterSettingService Upsert Methods​

upsertTenantSetting(dto: TenantSettingDto, options: { invokeContext: IInvoke }): Promise<CommandModel>​

upsertSetting(createDto: CommonSettingDto, invokeContext: IInvoke): Promise<CommandModel>​

upsertBulk(createDto: CommonSettingBulkDto, invokeContext: IInvoke): Promise<CommandModel[]>​

MasterDataService Upsert Methods​

upsert(createDto: CreateMasterDataDto, opts: { invokeContext: IInvoke }): Promise<MasterDataEntity>​

upsertSetting(createDto: MasterDataCreateDto, invokeContext: IInvoke): Promise<MasterDataEntity>​

upsertBulk(createDto: MasterDataCreateBulkDto, invokeContext: IInvoke): Promise<MasterDataEntity[]>​

Unified Bulk Upsert API (MasterBulkController)​

Request Body​

MasterBulkItemDto​

Upsert Behavior Details​

Legacy Upsert Pattern​

Overview

Master Setting Service

Master Data Service

Architecture

Installation

Basic Usage

Module Options

API Reference

MasterSettingService

`getSetting(dto: GetSettingDto, context: { invokeContext: IInvoke }): Promise<MasterSettingEntity>`

`createCommonTenantSetting(dto: CommonSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

`createTenantSetting(dto: TenantSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

`createGroupSetting(dto: GroupSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

`createUserSetting(dto: UserSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

`updateSetting(params: DetailKey, dto: UpdateSettingDto, context: { invokeContext: IInvoke }): Promise<CommandModel>`

`deleteSetting(key: DetailKey, context: { invokeContext: IInvoke }): Promise<CommandModel>`

`list(searchDto: MasterSettingSearchDto, invokeContext: IInvoke): Promise<MasterRdsListEntity>`

`getDetail(key: DetailDto): Promise<MasterRdsEntity>`

`create(createDto: CommonSettingDto, invokeContext: IInvoke): Promise<CommandModel>`

`createBulk(createDto: CommonSettingBulkDto, invokeContext: IInvoke): Promise<CommandModel[]>`

`update(key: DetailDto, updateDto: MasterSettingUpdateDto, invokeContext: IInvoke): Promise<CommandModel>`

`delete(key: DetailDto, invokeContext: IInvoke): Promise<CommandModel>`

`checkExistCode(code: string, invokeContext: IInvoke): Promise<boolean>`

`copy(masterCopyDto: MasterCopyDto, opts: { invokeContext: IInvoke }): Promise<any>`

MasterDataService

`list(searchDto: MasterDataSearchDto): Promise<MasterDataListEntity>`

`get(key: DetailDto): Promise<MasterDataEntity>`

`create(data: CreateMasterDataDto, context: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

`update(key: DetailDto, updateDto: UpdateDataSettingDto, context: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

`delete(key: DetailDto, opts: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

`checkExistCode(tenantCode: string, type: string, code: string): Promise<boolean>`

`getDetail(key: DetailDto): Promise<MasterRdsEntity>`

`createSetting(createDto: MasterDataCreateDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

`createBulk(createDto: MasterDataCreateBulkDto, invokeContext: IInvoke): Promise<MasterDataEntity[]>`

`updateSetting(key: DetailDto, updateDto: MasterDataUpdateDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

`deleteSetting(key: DetailDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

`listByRds(searchDto: CustomMasterDataSearchDto, context: { invokeContext: IInvoke }): Promise<MasterRdsListEntity>`

Search Parameters

Built-in Upsert API

MasterSettingService Upsert Methods

`upsertTenantSetting(dto: TenantSettingDto, options: { invokeContext: IInvoke }): Promise<CommandModel>`

`upsertSetting(createDto: CommonSettingDto, invokeContext: IInvoke): Promise<CommandModel>`

`upsertBulk(createDto: CommonSettingBulkDto, invokeContext: IInvoke): Promise<CommandModel[]>`

MasterDataService Upsert Methods

`upsert(createDto: CreateMasterDataDto, opts: { invokeContext: IInvoke }): Promise<MasterDataEntity>`

`upsertSetting(createDto: MasterDataCreateDto, invokeContext: IInvoke): Promise<MasterDataEntity>`

`upsertBulk(createDto: MasterDataCreateBulkDto, invokeContext: IInvoke): Promise<MasterDataEntity[]>`

Unified Bulk Upsert API (MasterBulkController)

Request Body

MasterBulkItemDto

Upsert Behavior Details

Legacy Upsert Pattern