@artu-ai/compliance-sdk 0.6.9 → 0.7.0

package/dist/resources/mex/actividad-vulnerable/mjr/reports.d.ts

@@ -0,0 +1,170 @@
+/**
+ * MJR (Metales y Joyas - Precious Metals and Jewelry) Reports Resource
+ *
+ * Extends MexReportsResource with MJR-specific behavior:
+ * - Accepts flattened CreateMJRReportInput (MJR fields at root level)
+ * - Returns MexMJRReport models
+ */
+import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateMJRReportInput, UpdateMJRReportInput, UpsertMJRReportInput, CreateMJRReportItemInput, UpdateMJRReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, MjrReportDefaultsInput, ValidationResult, GenerateResult, SubmissionResult, SubmitMJRSubmissionInput, UpsertResult } from "@artu-ai/shared";
+import type { MJRReportFilter, MJRReportSort, MJRReportItemFilter, ReportSort, ReportItemFilter, ReportItemSort } from "@artu-ai/shared";
+import { MexReportsResource } from "../../reports";
+import { MexMJRReport, MexMJRReportItem, type ReportData, type ReportItemData } from "../../../../models";
+/**
+ * MJR (Metales y Joyas) scoped reports resource.
+ *
+ * @example
+ * ```typescript
+ * const mjrSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.MJR,
+ * });
+ *
+ * // Create with fully flattened input
+ * const report = await mjrSdk.reports.create({
+ *   mesReportado: "202401",
+ * });
+ *
+ * // Returns MexMJRReport
+ * console.log(report.mesReportado);
+ * ```
+ */
+export declare class MJRReportsResource extends MexReportsResource<MJRReportSort, MjrReportDefaultsInput> {
+    create(data: CreateMJRReportInput): Promise<MexMJRReport>;
+    retrieve(id: string): Promise<MexMJRReport>;
+    retrieveByMetadata(key: string, value: string): Promise<MexMJRReport>;
+    retrieveByExternalId(externalId: string): Promise<MexMJRReport>;
+    update(id: string, data: UpdateMJRReportInput): Promise<MexMJRReport>;
+    /**
+     * Lists MJR reports with optional filtering.
+     *
+     * Accepts flattened MJR filter (future MJR-specific report fields at root level).
+     */
+    list(options?: ListOptions<MJRReportFilter, MJRReportSort>): Promise<PaginatedResponse<MexMJRReport>>;
+    /**
+     * Iterates over MJR reports.
+     *
+     * Accepts flattened MJR filter (future MJR-specific report fields at root level).
+     */
+    iterate(options?: {
+        filter?: MJRReportFilter;
+        sort?: MJRReportSort;
+        pageSize?: number;
+    }): AsyncGenerator<MexMJRReport, void, undefined>;
+    /**
+     * Counts MJR reports matching the given filter.
+     *
+     * @param filter - Optional filter criteria (with MJR fields at root level)
+     * @returns The count of matching reports
+     */
+    count(filter?: MJRReportFilter): Promise<number>;
+    createMany(reports: CreateMJRReportInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexMJRReport>>;
+    createMany(reports: CreateMJRReportInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexMJRReport>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMJRReportInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexMJRReport>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMJRReportInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexMJRReport>>;
+    /**
+     * Creates or updates a MJR report by externalId.
+     *
+     * @param data - Report upsert data with MJR fields at root level (must include externalId)
+     * @returns The created or updated report with action indicator
+     */
+    upsertByExternalId(data: UpsertMJRReportInput): Promise<UpsertResult<MexMJRReport>>;
+    /**
+     * Creates or updates multiple MJR reports by externalId.
+     *
+     * @param reports - Array of report upsert data (each must include externalId)
+     * @param options - Batch options (atomic: true by default)
+     * @returns Atomic result with data array, or partial result with succeeded/failed
+     */
+    upsertManyByExternalId(reports: UpsertMJRReportInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<UpsertResult<MexMJRReport>>>;
+    upsertManyByExternalId(reports: UpsertMJRReportInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<UpsertResult<MexMJRReport>>>;
+    addItem(reportId: string, data: CreateMJRReportItemInput): Promise<MexMJRReportItem>;
+    getItem(reportId: string, itemId: string): Promise<MexMJRReportItem>;
+    updateItem(reportId: string, itemId: string, data: UpdateMJRReportItemInput): Promise<MexMJRReportItem>;
+    listItems(reportId: string, options?: ListOptions<MJRReportItemFilter, ReportItemSort>): Promise<PaginatedResponse<MexMJRReportItem>>;
+    /**
+     * Transforms a flattened MJRReportItemFilter to nested ReportItemFilter format.
+     */
+    protected applyScopeToItemFilter(filter?: MJRReportItemFilter): ReportItemFilter | undefined;
+    addItems(reportId: string, items: CreateMJRReportItemInput[]): Promise<{
+        added: number;
+        items: MexMJRReportItem[];
+    }>;
+    /**
+     * Validates a MJR report.
+     *
+     * Uses MJR-scoped validation input (jurisdiction and activity are implicit).
+     *
+     * @param reportId - The report ID to validate
+     * @param defaults - MJR report defaults including rfc, alertType, etc.
+     *
+     * @example
+     * ```typescript
+     * const result = await mjrSdk.reports.validateReport(report.id, {
+     *   rfc: "ABC200101XXX",
+     *   alertType: "100",
+     * });
+     * ```
+     */
+    validateReport(reportId: string, defaults: MjrReportDefaultsInput): Promise<ValidationResult>;
+    /**
+     * Generates XML for a MJR report.
+     *
+     * Uses the same input as validateReport.
+     *
+     * @param reportId - The report ID to generate XML for
+     * @param defaults - MJR report defaults including rfc, alertType, etc.
+     */
+    generateReport(reportId: string, defaults: MjrReportDefaultsInput): Promise<GenerateResult>;
+    /**
+     * Submits a validated MJR report.
+     *
+     * Uses MJR-scoped submission input (activity is implicit).
+     */
+    submit(input: SubmitMJRSubmissionInput): Promise<SubmissionResult>;
+    protected transformToNested(data: CreateMJRReportInput): CreateReportInput;
+    /**
+     * Transforms flattened MJR report update to nested API format.
+     *
+     * NOTE: Always includes `actividadVulnerable: { MJR: {} }` even if no
+     * MJR-specific fields are provided. This ensures that records touched via
+     * the MJR SDK can be filtered by `activityCodes: { in: ["MJR"] }`.
+     */
+    protected transformUpdateToNested(data: UpdateMJRReportInput): UpdateReportInput;
+    protected instantiate(data: ReportData): MexMJRReport;
+    protected instantiateItem(data: ReportItemData): MexMJRReportItem;
+    protected transformItemToNested(data: CreateMJRReportItemInput): CreateReportItemInput;
+    protected transformItemUpdateToNested(data: UpdateMJRReportItemInput): UpdateReportItemInput;
+    /**
+     * Transforms a flattened MJRReportSort to nested ReportSort format.
+     *
+     * Maps flattened field names to their full API paths using MJR-specific field mapping.
+     */
+    protected applyScopeToSort(sort?: MJRReportSort): ReportSort | undefined;
+    /**
+     * Transforms MJR defaults to nested API format for validate/generate.
+     */
+    protected transformMjrDefaultsToNested(reportId: string, defaults: MjrReportDefaultsInput): {
+        reportId: string;
+        jurisdictions: unknown;
+    };
+}
+//# sourceMappingURL=reports.d.ts.map

package/dist/resources/mex/actividad-vulnerable/mjr/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../../../src/resources/mex/actividad-vulnerable/mjr/reports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,EACb,MAAM,iBAAiB,CAAC;AAazB,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB,CACxD,aAAa,EACb,sBAAsB,CACvB;IAKO,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAWzD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAO3C,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrE,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAO/D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;IAc3E;;;;OAIG;IACG,IAAI,CACR,OAAO,CAAC,EAAE,WAAW,CAAC,eAAe,EAAE,aAAa,CAAC,GACpD,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAkB3C;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC;IAUjD;;;;;OAKG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAYhD,UAAU,CACd,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACrC,UAAU,CACd,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAmCtC,UAAU,CACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,oBAAoB,CAAA;KAAE,EAAE,EACrD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACrC,UAAU,CACd,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,oBAAoB,CAAA;KAAE,EAAE,EACrD,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;IA4C5C;;;;;OAKG;IACG,kBAAkB,CACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IActC;;;;;;OAMG;IACG,sBAAsB,CAC1B,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,GAC1B,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,sBAAsB,CAC1B,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GACzB,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;IAmDpD,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IAWtB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOpE,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IActB,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,CAAC,mBAAmB,EAAE,cAAc,CAAC,GACzD,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAkB/C;;OAEG;IACH,SAAS,CAAC,sBAAsB,CAC9B,MAAM,CAAC,EAAE,mBAAmB,GAC3B,gBAAgB,GAAG,SAAS;IA4BzB,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,wBAAwB,EAAE,GAChC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAqBxD;;;;;;;;;;;;;;;OAeG;IACY,cAAc,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAc5B;;;;;;;OAOG;IACY,cAAc,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,cAAc,CAAC;IAc1B;;;;OAIG;IACY,MAAM,CACnB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;cA0BT,iBAAiB,CAClC,IAAI,EAAE,oBAAoB,GACzB,iBAAiB;IAepB;;;;;;OAMG;cACgB,uBAAuB,CACxC,IAAI,EAAE,oBAAoB,GACzB,iBAAiB;cAcD,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY;cAI3C,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB;IAI1E,SAAS,CAAC,qBAAqB,CAC7B,IAAI,EAAE,wBAAwB,GAC7B,qBAAqB;IAqBxB,SAAS,CAAC,2BAA2B,CACnC,IAAI,EAAE,wBAAwB,GAC7B,qBAAqB;IAyBxB;;;;OAIG;cACgB,gBAAgB,CACjC,IAAI,CAAC,EAAE,aAAa,GACnB,UAAU,GAAG,SAAS;IAOzB;;OAEG;IACH,SAAS,CAAC,4BAA4B,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,sBAAsB,GAC/B;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE;CAmBhD"}

package/dist/resources/mex/actividad-vulnerable/mjr/reports.js

@@ -0,0 +1,463 @@
+/**
+ * MJR (Metales y Joyas - Precious Metals and Jewelry) Reports Resource
+ *
+ * Extends MexReportsResource with MJR-specific behavior:
+ * - Accepts flattened CreateMJRReportInput (MJR fields at root level)
+ * - Returns MexMJRReport models
+ */
+import { z } from "zod";
+import { CodigoActividad, createMJRReportInputSchema, updateMJRReportInputSchema, upsertMJRReportInputSchema, createMJRReportItemInputSchema, updateMJRReportItemInputSchema, mjrDefaultsInputSchema, submitMJRSubmissionInputSchema, transformSort, mjrReportFieldMapping, } from "@artu-ai/shared";
+import { MexReportsResource } from "../../reports";
+import { MexMJRReport, MexMJRReportItem, } from "../../../../models";
+// ===========================
+// MJRReportsResource
+// ===========================
+/**
+ * MJR (Metales y Joyas) scoped reports resource.
+ *
+ * @example
+ * ```typescript
+ * const mjrSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.MJR,
+ * });
+ *
+ * // Create with fully flattened input
+ * const report = await mjrSdk.reports.create({
+ *   mesReportado: "202401",
+ * });
+ *
+ * // Returns MexMJRReport
+ * console.log(report.mesReportado);
+ * ```
+ */
+export class MJRReportsResource extends MexReportsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // Report CRUD
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createMJRReportInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.reports.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateMJRReportInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists MJR reports with optional filtering.
+     *
+     * Accepts flattened MJR filter (future MJR-specific report fields at root level).
+     */
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const scopedSort = this.applyScopeToSort(options?.sort);
+        const response = await this.execute(() => this.trpc.reports.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((r) => this.instantiate(r)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over MJR reports.
+     *
+     * Accepts flattened MJR filter (future MJR-specific report fields at root level).
+     */
+    iterate(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        // Note: sort is passed through - createIterator calls list() which handles transformation
+        return this.createIterator({
+            filter: scopedFilter,
+            sort: options?.sort,
+            pageSize: options?.pageSize,
+        });
+    }
+    /**
+     * Counts MJR reports matching the given filter.
+     *
+     * @param filter - Optional filter criteria (with MJR fields at root level)
+     * @returns The count of matching reports
+     */
+    async count(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        const response = await this.execute(() => this.trpc.reports.count.query({ filter: scopedFilter }));
+        return response.count;
+    }
+    async createMany(reports, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createMJRReportInputSchema), reports);
+        const nestedItems = validated.map((r) => this.transformToNested(r));
+        const response = await this.execute(() => this.trpc.reports.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: updateMJRReportInputSchema,
+        });
+        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.reports.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
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates or updates a MJR report by externalId.
+     *
+     * @param data - Report upsert data with MJR fields at root level (must include externalId)
+     * @returns The created or updated report with action indicator
+     */
+    async upsertByExternalId(data) {
+        const validated = this.validate(upsertMJRReportInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.upsertByExternalId.mutate(nestedData));
+        return {
+            data: this.instantiate(response.data),
+            action: response.action,
+        };
+    }
+    async upsertManyByExternalId(reports, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(upsertMJRReportInputSchema), reports);
+        const nestedItems = validated.map((r) => this.transformToNested(r));
+        const response = await this.execute(() => this.trpc.reports.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,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Report Items
+    // ─────────────────────────────────────────────────────────────────
+    async addItem(reportId, data) {
+        const validated = this.validate(createMJRReportItemInputSchema, data);
+        const nestedData = this.transformItemToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.addItem.mutate({ reportId, data: nestedData }));
+        return this.instantiateItem(response);
+    }
+    async getItem(reportId, itemId) {
+        const response = await this.execute(() => this.trpc.reports.getItem.query({ reportId, itemId }));
+        return this.instantiateItem(response);
+    }
+    async updateItem(reportId, itemId, data) {
+        const validated = this.validate(updateMJRReportItemInputSchema, data);
+        const nestedData = this.transformItemUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.updateItem.mutate({
+            reportId,
+            itemId,
+            data: nestedData,
+        }));
+        return this.instantiateItem(response);
+    }
+    async listItems(reportId, options) {
+        // Transform flattened MJR filter to nested format
+        const scopedFilter = this.applyScopeToItemFilter(options?.filter);
+        const response = await this.execute(() => this.trpc.reports.listItems.query({
+            reportId,
+            ...options,
+            filter: scopedFilter,
+        }));
+        return {
+            data: response.data.map((i) => this.instantiateItem(i)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Transforms a flattened MJRReportItemFilter to nested ReportItemFilter format.
+     */
+    applyScopeToItemFilter(filter) {
+        if (!filter)
+            return undefined;
+        const { alertType, alertDescription, ...baseFields } = filter;
+        // If no MJR-specific fields, return base filter as-is
+        if (alertType === undefined && alertDescription === undefined) {
+            return baseFields;
+        }
+        // Build nested filter structure
+        const mjrFilter = {};
+        if (alertType !== undefined)
+            mjrFilter.alertType = alertType;
+        if (alertDescription !== undefined)
+            mjrFilter.alertDescription = alertDescription;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        MJR: mjrFilter,
+                    },
+                },
+            },
+        };
+    }
+    async addItems(reportId, items) {
+        const validated = this.validate(z.array(createMJRReportItemInputSchema), items);
+        const nestedItems = validated.map((i) => this.transformItemToNested(i));
+        const response = await this.execute(() => this.trpc.reports.addItems.mutate({ reportId, items: nestedItems }));
+        return {
+            added: response.added,
+            items: response.items.map((i) => this.instantiateItem(i)),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Validation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Validates a MJR report.
+     *
+     * Uses MJR-scoped validation input (jurisdiction and activity are implicit).
+     *
+     * @param reportId - The report ID to validate
+     * @param defaults - MJR report defaults including rfc, alertType, etc.
+     *
+     * @example
+     * ```typescript
+     * const result = await mjrSdk.reports.validateReport(report.id, {
+     *   rfc: "ABC200101XXX",
+     *   alertType: "100",
+     * });
+     * ```
+     */
+    async validateReport(reportId, defaults) {
+        const validated = this.validate(mjrDefaultsInputSchema, defaults);
+        const nestedInput = this.transformMjrDefaultsToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.validate.mutate(nestedInput));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Generation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Generates XML for a MJR report.
+     *
+     * Uses the same input as validateReport.
+     *
+     * @param reportId - The report ID to generate XML for
+     * @param defaults - MJR report defaults including rfc, alertType, etc.
+     */
+    async generateReport(reportId, defaults) {
+        const validated = this.validate(mjrDefaultsInputSchema, defaults);
+        const nestedInput = this.transformMjrDefaultsToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.generate.mutate(nestedInput));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Submission
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Submits a validated MJR report.
+     *
+     * Uses MJR-scoped submission input (activity is implicit).
+     */
+    async submit(input) {
+        const validated = this.validate(submitMJRSubmissionInputSchema, input);
+        const jurisdictions = {
+            MX: {
+                actividadVulnerable: {
+                    [CodigoActividad.MJR]: {
+                        acuseRecibo: validated.acuseRecibo,
+                        notes: validated.notes,
+                    },
+                },
+            },
+        };
+        return this.execute(() => this.trpc.reports.submit.mutate({
+            reportId: validated.reportId,
+            jurisdictions,
+        }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    transformToNested(data) {
+        const { mesReportado, ...baseFields } = data;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.MJR]: { mesReportado },
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Transforms flattened MJR report update to nested API format.
+     *
+     * NOTE: Always includes `actividadVulnerable: { MJR: {} }` even if no
+     * MJR-specific fields are provided. This ensures that records touched via
+     * the MJR SDK can be filtered by `activityCodes: { in: ["MJR"] }`.
+     */
+    transformUpdateToNested(data) {
+        // Always include MJR activity marker to ensure filterability
+        return {
+            ...data,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.MJR]: {},
+                    },
+                },
+            },
+        };
+    }
+    instantiate(data) {
+        return new MexMJRReport(data);
+    }
+    instantiateItem(data) {
+        return new MexMJRReportItem(data);
+    }
+    transformItemToNested(data) {
+        const { alertType, alertDescription, amendment, ...baseFields } = data;
+        const mjrData = {};
+        if (alertType !== undefined)
+            mjrData.alertType = alertType;
+        if (alertDescription !== undefined)
+            mjrData.alertDescription = alertDescription;
+        if (amendment !== undefined)
+            mjrData.amendment = amendment;
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.MJR]: mjrData,
+                    },
+                },
+            },
+        };
+    }
+    transformItemUpdateToNested(data) {
+        const { alertType, alertDescription, amendment, ...baseFields } = data;
+        const mjrData = {};
+        if (alertType !== undefined)
+            mjrData.alertType = alertType;
+        if (alertDescription !== undefined)
+            mjrData.alertDescription = alertDescription;
+        if (amendment !== undefined)
+            mjrData.amendment = amendment;
+        if (Object.keys(mjrData).length === 0) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.MJR]: mjrData,
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Transforms a flattened MJRReportSort to nested ReportSort format.
+     *
+     * Maps flattened field names to their full API paths using MJR-specific field mapping.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mjrReportFieldMapping);
+    }
+    /**
+     * Transforms MJR defaults to nested API format for validate/generate.
+     */
+    transformMjrDefaultsToNested(reportId, defaults) {
+        const { rfc, collegiateEntityCode, exempt, priority, ...mjrFields } = defaults;
+        return {
+            reportId,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        rfc,
+                        collegiateEntityCode,
+                        exempt,
+                        priority,
+                        [CodigoActividad.MJR]: mjrFields,
+                    },
+                },
+            },
+        };
+    }
+}