@artu-ai/compliance-sdk 0.9.0 → 0.9.2

package/dist/resources/mex/cnbv/transmisor/addresses.js

@@ -0,0 +1,232 @@
+/**
+ * Transmisor (CNBV Money Transmitters) Addresses Resource
+ *
+ * Extends MexAddressesResource with Transmisor-specific behavior:
+ * - Accepts flattened CreateTransmisorAddressInput (localidad at root level)
+ * - Nests localidad into jurisdictions.MX.cnbv.TRANSMISOR
+ */
+import { createTransmisorAddressInputSchema, replaceSyncItemSchema, updateTransmisorAddressInputSchema, upsertTransmisorAddressInputSchema, } from "@artu-ai/shared";
+import { z } from "zod";
+import { MexAddressesResource } from "../../addresses";
+// ===========================
+// TransmisorAddressesResource
+// ===========================
+/**
+ * Transmisor (CNBV Money Transmitters) scoped addresses resource.
+ *
+ * Extends MexAddressesResource with Transmisor-specific address fields
+ * (localidad) that are nested into jurisdictions.MX.cnbv.TRANSMISOR.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: "MX",
+ *   cnbv: "TRANSMISOR",
+ * });
+ *
+ * const address = await sdk.addresses.create({
+ *   clientId: "client_123",
+ *   street: "Paseo de la Reforma",
+ *   exteriorNumber: "222",
+ *   neighborhood: "Juárez",
+ *   city: "Ciudad de México",
+ *   state: "CDMX",
+ *   postalCode: "06600",
+ *   country: "MX",
+ *   localidad: "00901003",
+ *   type: "home",
+ * });
+ * ```
+ */
+export class TransmisorAddressesResource extends MexAddressesResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createTransmisorAddressInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.addresses.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateTransmisorAddressInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.addresses.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    async createMany(addresses, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createTransmisorAddressInputSchema), addresses);
+        const nestedItems = validated.map((a) => this.transformToNested(a));
+        const response = await this.execute(() => this.trpc.addresses.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((a) => this.instantiate(a)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async updateMany(updates, options = {}) {
+        const atomic = options.atomic ?? true;
+        const updateItemSchema = z.object({
+            id: z.uuid(),
+            data: updateTransmisorAddressInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const nestedUpdates = validated.map((u) => ({
+            id: u.id,
+            data: this.transformUpdateToNested(u.data),
+        }));
+        const response = await this.execute(() => this.trpc.addresses.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((a) => this.instantiate(a)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Upsert Operations
+    // ─────────────────────────────────────────────────────────────────
+    async upsertByExternalId(data) {
+        const validated = this.validate(upsertTransmisorAddressInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.addresses.upsertByExternalId.mutate(nestedData));
+        return {
+            data: this.instantiate(response.data),
+            action: response.action,
+        };
+    }
+    async upsertManyByExternalId(addresses, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(upsertTransmisorAddressInputSchema), addresses);
+        const nestedItems = validated.map((a) => this.transformToNested(a));
+        const response = await this.execute(() => this.trpc.addresses.upsertManyByExternalId.mutate({
+            items: nestedItems,
+            atomic,
+        }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((item) => ({
+                    data: this.instantiate(item.data),
+                    action: item.action,
+                })),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: {
+                        data: this.instantiate(item.data.data),
+                        action: item.data.action,
+                    },
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async sync(clientId, items, options) {
+        const itemsWithClientId = items.map((item) => {
+            if (!("id" in item) || !item.id) {
+                return { ...item, clientId };
+            }
+            return item;
+        });
+        const validated = this.validate(z.array(replaceSyncItemSchema(createTransmisorAddressInputSchema, updateTransmisorAddressInputSchema)), itemsWithClientId);
+        const nestedItems = [];
+        for (const item of validated) {
+            if ("_delete" in item && item._delete) {
+                nestedItems.push(item);
+            }
+            else if ("id" in item && item.id) {
+                const { id, ...data } = item;
+                const transformed = this.transformUpdateToNested(data);
+                nestedItems.push({
+                    id,
+                    ...transformed,
+                });
+            }
+            else {
+                const transformed = this.transformToNested(item);
+                nestedItems.push(transformed);
+            }
+        }
+        const result = await super.sync(clientId, nestedItems, options);
+        return result;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms flattened Transmisor input to nested API format.
+     *
+     * Extracts localidad and nests it into jurisdictions.MX.cnbv.TRANSMISOR.
+     * Delegates base + MX fields to parent.
+     */
+    transformToNested(data) {
+        const { localidad, ...mexData } = data;
+        const nested = super.transformToNested(mexData);
+        const mexJurisdiction = (nested.jurisdictions?.MX ?? {});
+        return {
+            ...nested,
+            jurisdictions: {
+                MX: {
+                    ...mexJurisdiction,
+                    cnbv: {
+                        TRANSMISOR: { localidad },
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Transforms flattened Transmisor update input to nested API format.
+     *
+     * Always includes cnbv.TRANSMISOR marker for filterability.
+     */
+    transformUpdateToNested(data) {
+        const { localidad, ...mexData } = data;
+        const nested = super.transformUpdateToNested(mexData);
+        const mexJurisdiction = (nested.jurisdictions?.MX ?? {});
+        const transmisorData = {};
+        if (localidad !== undefined)
+            transmisorData.localidad = localidad;
+        return {
+            ...nested,
+            jurisdictions: {
+                MX: {
+                    ...mexJurisdiction,
+                    cnbv: {
+                        ...mexJurisdiction.cnbv,
+                        TRANSMISOR: transmisorData,
+                    },
+                },
+            },
+        };
+    }
+}

package/dist/resources/mex/cnbv/transmisor/alerts.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Transmisor (CNBV Money Transmitters) Alerts Resource
+ *
+ * Extends MexAlertsResource with Transmisor-specific behavior:
+ * - Accepts flattened CreateTransmisorAlertInput
+ * - Returns MexTransmisorAlert models
+ * - Nests Transmisor fields under jurisdictions.MX.cnbv.TRANSMISOR
+ */
+import type { CreateAlertInput, UpdateAlertInput, CreateAlertItemInput, UpdateAlertItemInput, CreateTransmisorAlertInput, UpdateTransmisorAlertInput, UpsertTransmisorAlertInput, CreateTransmisorAlertItemInput, UpdateTransmisorAlertItemInput, SubmitTransmisorAlertInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ValidationResult, GenerateResult, SubmissionResult, TransmisorAlertDefaultsInput, UpsertResult } from "@artu-ai/shared";
+import type { TransmisorAlertFilter, TransmisorAlertSort, TransmisorAlertItemFilter, AlertSort, AlertItemFilter, AlertItemSort } from "@artu-ai/shared";
+import { MexAlertsResource } from "../../alerts";
+import { MexTransmisorAlert, MexTransmisorAlertItem, type AlertData, type AlertItemData } from "../../../../models";
+export declare class TransmisorAlertsResource extends MexAlertsResource<TransmisorAlertSort, TransmisorAlertDefaultsInput> {
+    create(data: CreateTransmisorAlertInput): Promise<MexTransmisorAlert>;
+    retrieve(id: string): Promise<MexTransmisorAlert>;
+    retrieveByMetadata(key: string, value: string): Promise<MexTransmisorAlert>;
+    retrieveByExternalId(externalId: string): Promise<MexTransmisorAlert>;
+    update(id: string, data: UpdateTransmisorAlertInput): Promise<MexTransmisorAlert>;
+    list(options?: ListOptions<TransmisorAlertFilter, TransmisorAlertSort>): Promise<PaginatedResponse<MexTransmisorAlert>>;
+    iterate(options?: {
+        filter?: TransmisorAlertFilter;
+        sort?: TransmisorAlertSort;
+        pageSize?: number;
+    }): AsyncGenerator<MexTransmisorAlert, void, undefined>;
+    count(filter?: TransmisorAlertFilter): Promise<number>;
+    createMany(alerts: CreateTransmisorAlertInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexTransmisorAlert>>;
+    createMany(alerts: CreateTransmisorAlertInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexTransmisorAlert>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateTransmisorAlertInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexTransmisorAlert>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateTransmisorAlertInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexTransmisorAlert>>;
+    upsertByExternalId(data: UpsertTransmisorAlertInput): Promise<UpsertResult<MexTransmisorAlert>>;
+    addItem(alertId: string, data: CreateTransmisorAlertItemInput): Promise<MexTransmisorAlertItem>;
+    getItem(alertId: string, itemId: string): Promise<MexTransmisorAlertItem>;
+    updateItem(alertId: string, itemId: string, data: UpdateTransmisorAlertItemInput): Promise<MexTransmisorAlertItem>;
+    listItems(alertId: string, options?: ListOptions<TransmisorAlertItemFilter, AlertItemSort>): Promise<PaginatedResponse<MexTransmisorAlertItem>>;
+    protected applyScopeToItemFilter(filter?: TransmisorAlertItemFilter): AlertItemFilter | undefined;
+    addItems(alertId: string, items: CreateTransmisorAlertItemInput[]): Promise<{
+        added: number;
+        items: MexTransmisorAlertItem[];
+    }>;
+    validateAlert(alertId: string, defaults: TransmisorAlertDefaultsInput): Promise<ValidationResult>;
+    generateAlert(alertId: string, defaults: TransmisorAlertDefaultsInput): Promise<GenerateResult>;
+    submit(input: SubmitTransmisorAlertInput): Promise<SubmissionResult>;
+    protected applyScopeToSort(sort?: TransmisorAlertSort): AlertSort | undefined;
+    protected transformToNested(data: CreateTransmisorAlertInput): CreateAlertInput;
+    protected transformUpdateToNested(data: UpdateTransmisorAlertInput): UpdateAlertInput;
+    protected instantiate(data: AlertData): MexTransmisorAlert;
+    protected instantiateItem(data: AlertItemData): MexTransmisorAlertItem;
+    protected transformItemToNested(data: CreateTransmisorAlertItemInput): CreateAlertItemInput;
+    protected transformItemUpdateToNested(data: UpdateTransmisorAlertItemInput): UpdateAlertItemInput;
+    /**
+     * Transforms Transmisor defaults to nested API format for validate/generate.
+     */
+    protected transformDefaultsToNested(alertId: string, defaults: TransmisorAlertDefaultsInput): {
+        alertId: string;
+        jurisdictions: unknown;
+    };
+}
+//# sourceMappingURL=alerts.d.ts.map

package/dist/resources/mex/cnbv/transmisor/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../../../src/resources/mex/cnbv/transmisor/alerts.ts"],"names":[],"mappings":"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"}

package/dist/resources/mex/cnbv/transmisor/alerts.js

@@ -0,0 +1,364 @@
+/**
+ * Transmisor (CNBV Money Transmitters) Alerts Resource
+ *
+ * Extends MexAlertsResource with Transmisor-specific behavior:
+ * - Accepts flattened CreateTransmisorAlertInput
+ * - Returns MexTransmisorAlert models
+ * - Nests Transmisor fields under jurisdictions.MX.cnbv.TRANSMISOR
+ */
+import { z } from "zod";
+import { createTransmisorAlertInputSchema, updateTransmisorAlertInputSchema, upsertTransmisorAlertInputSchema, createTransmisorAlertItemInputSchema, updateTransmisorAlertItemInputSchema, submitTransmisorAlertInputSchema, transmisorDefaultsInputSchema, transformSort, transmisorAlertFieldMapping, } from "@artu-ai/shared";
+import { MexAlertsResource } from "../../alerts";
+import { MexTransmisorAlert, MexTransmisorAlertItem, } from "../../../../models";
+// ===========================
+// TransmisorAlertsResource
+// ===========================
+export class TransmisorAlertsResource extends MexAlertsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // Alert CRUD
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createTransmisorAlertInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.alerts.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.alerts.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.alerts.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.alerts.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateTransmisorAlertInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.alerts.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const scopedSort = this.applyScopeToSort(options?.sort);
+        const response = await this.execute(() => this.trpc.alerts.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((r) => this.instantiate(r)),
+            pagination: response.pagination,
+        };
+    }
+    iterate(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        return this.createIterator({
+            filter: scopedFilter,
+            sort: options?.sort,
+            pageSize: options?.pageSize,
+        });
+    }
+    async count(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        const response = await this.execute(() => this.trpc.alerts.count.query({ filter: scopedFilter }));
+        return response.count;
+    }
+    async createMany(alerts, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createTransmisorAlertInputSchema), alerts);
+        const nestedItems = validated.map((r) => this.transformToNested(r));
+        const response = await this.execute(() => this.trpc.alerts.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((r) => this.instantiate(r)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async updateMany(updates, options = {}) {
+        const atomic = options.atomic ?? true;
+        const updateItemSchema = z.object({
+            id: z.uuid(),
+            data: updateTransmisorAlertInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const nestedUpdates = validated.map((u) => ({
+            id: u.id,
+            data: this.transformUpdateToNested(u.data),
+        }));
+        const response = await this.execute(() => this.trpc.alerts.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((r) => this.instantiate(r)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Upsert Operations
+    // ─────────────────────────────────────────────────────────────────
+    async upsertByExternalId(data) {
+        const validated = this.validate(upsertTransmisorAlertInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.alerts.upsertByExternalId.mutate(nestedData));
+        return {
+            data: this.instantiate(response.data),
+            action: response.action,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Alert Items
+    // ─────────────────────────────────────────────────────────────────
+    async addItem(alertId, data) {
+        const validated = this.validate(createTransmisorAlertItemInputSchema, data);
+        const nestedData = this.transformItemToNested(validated);
+        const response = await this.execute(() => this.trpc.alerts.addItem.mutate({ alertId, data: nestedData }));
+        return this.instantiateItem(response);
+    }
+    async getItem(alertId, itemId) {
+        const response = await this.execute(() => this.trpc.alerts.getItem.query({ alertId, itemId }));
+        return this.instantiateItem(response);
+    }
+    async updateItem(alertId, itemId, data) {
+        const validated = this.validate(updateTransmisorAlertItemInputSchema, data);
+        const nestedData = this.transformItemUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.alerts.updateItem.mutate({
+            alertId,
+            itemId,
+            data: nestedData,
+        }));
+        return this.instantiateItem(response);
+    }
+    async listItems(alertId, options) {
+        const scopedFilter = this.applyScopeToItemFilter(options?.filter);
+        const response = await this.execute(() => this.trpc.alerts.listItems.query({
+            alertId,
+            ...options,
+            filter: scopedFilter,
+        }));
+        return {
+            data: response.data.map((i) => this.instantiateItem(i)),
+            pagination: response.pagination,
+        };
+    }
+    applyScopeToItemFilter(filter) {
+        if (!filter)
+            return undefined;
+        const { isPrimary, ...baseFields } = filter;
+        if (isPrimary === undefined) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    cnbv: {
+                        TRANSMISOR: { isPrimary },
+                    },
+                },
+            },
+        };
+    }
+    async addItems(alertId, items) {
+        const validated = this.validate(z.array(createTransmisorAlertItemInputSchema), items);
+        const nestedItems = validated.map((i) => this.transformItemToNested(i));
+        const response = await this.execute(() => this.trpc.alerts.addItems.mutate({ alertId, items: nestedItems }));
+        return {
+            added: response.added,
+            items: response.items.map((i) => this.instantiateItem(i)),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Validation
+    // ─────────────────────────────────────────────────────────────────
+    async validateAlert(alertId, defaults) {
+        const validated = this.validate(transmisorDefaultsInputSchema, defaults);
+        const nestedInput = this.transformDefaultsToNested(alertId, validated);
+        return this.execute(() => this.trpc.alerts.validate.mutate(nestedInput));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Generation
+    // ─────────────────────────────────────────────────────────────────
+    async generateAlert(alertId, defaults) {
+        const validated = this.validate(transmisorDefaultsInputSchema, defaults);
+        const nestedInput = this.transformDefaultsToNested(alertId, validated);
+        return this.execute(() => this.trpc.alerts.generate.mutate(nestedInput));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Submission
+    // ─────────────────────────────────────────────────────────────────
+    async submit(input) {
+        const validated = this.validate(submitTransmisorAlertInputSchema, input);
+        const jurisdictions = {
+            MX: {
+                cnbv: {
+                    TRANSMISOR: {
+                        acuseRecibo: validated.acuseRecibo,
+                        notes: validated.notes,
+                    },
+                },
+            },
+        };
+        return this.execute(() => this.trpc.alerts.submit.mutate({
+            alertId: validated.alertId,
+            jurisdictions,
+        }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, transmisorAlertFieldMapping);
+    }
+    transformToNested(data) {
+        const { tipoReporte, periodoReporte, organoSupervisor, claveSujetoObligado, agenteNombre, agenteApellidoPaterno, agenteApellidoMaterno, agenteRfc, ...baseFields } = data;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    cnbv: {
+                        TRANSMISOR: {
+                            tipoReporte,
+                            periodoReporte,
+                            organoSupervisor,
+                            claveSujetoObligado,
+                            agenteNombre,
+                            agenteApellidoPaterno,
+                            agenteApellidoMaterno,
+                            agenteRfc,
+                        },
+                    },
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        const { tipoReporte, periodoReporte, organoSupervisor, claveSujetoObligado, agenteNombre, agenteApellidoPaterno, agenteApellidoMaterno, agenteRfc, ...baseFields } = data;
+        const transmisorData = {};
+        if (tipoReporte !== undefined)
+            transmisorData.tipoReporte = tipoReporte;
+        if (periodoReporte !== undefined)
+            transmisorData.periodoReporte = periodoReporte;
+        if (organoSupervisor !== undefined)
+            transmisorData.organoSupervisor = organoSupervisor;
+        if (claveSujetoObligado !== undefined)
+            transmisorData.claveSujetoObligado = claveSujetoObligado;
+        if (agenteNombre !== undefined)
+            transmisorData.agenteNombre = agenteNombre;
+        if (agenteApellidoPaterno !== undefined)
+            transmisorData.agenteApellidoPaterno = agenteApellidoPaterno;
+        if (agenteApellidoMaterno !== undefined)
+            transmisorData.agenteApellidoMaterno = agenteApellidoMaterno;
+        if (agenteRfc !== undefined)
+            transmisorData.agenteRfc = agenteRfc;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    cnbv: {
+                        TRANSMISOR: transmisorData,
+                    },
+                },
+            },
+        };
+    }
+    instantiate(data) {
+        return new MexTransmisorAlert(data);
+    }
+    instantiateItem(data) {
+        return new MexTransmisorAlertItem(data);
+    }
+    transformItemToNested(data) {
+        const { isPrimary, fechaDeteccion, descripcionOperacion, razones, ...baseFields } = data;
+        const transmisorData = {};
+        if (isPrimary !== undefined)
+            transmisorData.isPrimary = isPrimary;
+        if (fechaDeteccion !== undefined)
+            transmisorData.fechaDeteccion = fechaDeteccion;
+        if (descripcionOperacion !== undefined)
+            transmisorData.descripcionOperacion = descripcionOperacion;
+        if (razones !== undefined)
+            transmisorData.razones = razones;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    cnbv: {
+                        TRANSMISOR: transmisorData,
+                    },
+                },
+            },
+        };
+    }
+    transformItemUpdateToNested(data) {
+        const { isPrimary, fechaDeteccion, descripcionOperacion, razones, ...baseFields } = data;
+        const transmisorData = {};
+        if (isPrimary !== undefined)
+            transmisorData.isPrimary = isPrimary;
+        if (fechaDeteccion !== undefined)
+            transmisorData.fechaDeteccion = fechaDeteccion;
+        if (descripcionOperacion !== undefined)
+            transmisorData.descripcionOperacion = descripcionOperacion;
+        if (razones !== undefined)
+            transmisorData.razones = razones;
+        if (Object.keys(transmisorData).length === 0) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    cnbv: {
+                        TRANSMISOR: transmisorData,
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Transforms Transmisor defaults to nested API format for validate/generate.
+     */
+    transformDefaultsToNested(alertId, defaults) {
+        return {
+            alertId,
+            jurisdictions: {
+                MX: {
+                    cnbv: {
+                        ...defaults,
+                        TRANSMISOR: defaults,
+                    },
+                },
+            },
+        };
+    }
+}