@artu-ai/compliance-sdk 0.6.8 → 0.7.0

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

@@ -0,0 +1,128 @@
+/**
+ * MJR (Metales y Joyas - Precious Metals and Jewelry) Transactions Resource
+ *
+ * Extends MexTransactionsResource with MJR-specific behavior:
+ * - Accepts flattened CreateMJRTransactionInput (MJR fields at root level)
+ * - Returns MexMJRTransaction models
+ * - Handles nested goods[] and payments[] arrays
+ */
+import type { CreateTransactionInput, UpdateTransactionInput, ListOptions, PaginatedResponse, CreateMJRTransactionInput, UpdateMJRTransactionInput, UpsertMJRTransactionInput, AtomicBatchResult, PartialBatchResult, RelatedClient, MJRTransactionFilter, MJRTransactionSort, UpsertResult } from "@artu-ai/shared";
+import { ClientRole } from "@artu-ai/shared";
+import type { TransactionSort } from "@artu-ai/shared";
+import { MexTransactionsResource } from "../../transactions";
+import { MexMJRTransaction, type TransactionData } from "../../../../models";
+/**
+ * MJR (Metales y Joyas) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const mjrSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.MJR,
+ * });
+ *
+ * // Create with fully flattened input
+ * const txn = await mjrSdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "601", // Sale
+ *   operationPostalCode: "06600",
+ *   goods: [
+ *     { goodType: "1", unit: "1", quantity: 1 }
+ *   ],
+ *   payments: [
+ *     { paymentDate: new Date(), paymentForm: "1", monetaryInstrument: "1", currency: "2", amount: 50000 }
+ *   ],
+ * });
+ *
+ * // Returns MexMJRTransaction
+ * console.log(txn.goods);
+ * console.log(txn.payments);
+ * ```
+ */
+export declare class MJRTransactionsResource extends MexTransactionsResource<MJRTransactionSort> {
+    create(data: CreateMJRTransactionInput): Promise<MexMJRTransaction>;
+    retrieve(id: string): Promise<MexMJRTransaction>;
+    retrieveByMetadata(key: string, value: string): Promise<MexMJRTransaction>;
+    update(id: string, data: UpdateMJRTransactionInput): Promise<MexMJRTransaction>;
+    /**
+     * Lists MJR transactions with optional filtering.
+     *
+     * Accepts flattened MJR filter (future MJR-specific transaction fields at root level).
+     */
+    list(options?: ListOptions<MJRTransactionFilter, MJRTransactionSort>): Promise<PaginatedResponse<MexMJRTransaction>>;
+    /**
+     * Iterates over MJR transactions.
+     *
+     * Accepts flattened MJR filter (future MJR-specific transaction fields at root level).
+     */
+    iterate(options?: {
+        filter?: MJRTransactionFilter;
+        sort?: MJRTransactionSort;
+        pageSize?: number;
+    }): AsyncGenerator<MexMJRTransaction, void, undefined>;
+    /**
+     * Counts MJR transactions matching the given filter.
+     *
+     * @param filter - Optional filter criteria (with MJR fields at root level)
+     * @returns The count of matching transactions
+     */
+    count(filter?: MJRTransactionFilter): Promise<number>;
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<MexMJRTransaction>>;
+    linkClient(transactionId: string, clientId: string, role?: ClientRole): Promise<MexMJRTransaction>;
+    unlinkClient(transactionId: string, clientId: string): Promise<MexMJRTransaction>;
+    setClients(transactionId: string, clients: RelatedClient[]): Promise<MexMJRTransaction>;
+    createMany(transactions: CreateMJRTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexMJRTransaction>>;
+    createMany(transactions: CreateMJRTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexMJRTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMJRTransactionInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexMJRTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMJRTransactionInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexMJRTransaction>>;
+    /**
+     * Creates or updates a MJR transaction by externalId.
+     *
+     * @param data - Transaction upsert data with MJR fields at root level (must include externalId)
+     * @returns The created or updated transaction with action indicator
+     */
+    upsertByExternalId(data: UpsertMJRTransactionInput): Promise<UpsertResult<MexMJRTransaction>>;
+    /**
+     * Creates or updates multiple MJR transactions by externalId.
+     *
+     * @param transactions - Array of transaction 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(transactions: UpsertMJRTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<UpsertResult<MexMJRTransaction>>>;
+    upsertManyByExternalId(transactions: UpsertMJRTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<UpsertResult<MexMJRTransaction>>>;
+    protected transformToNested(data: CreateMJRTransactionInput): CreateTransactionInput;
+    protected transformUpdateToNested(data: UpdateMJRTransactionInput): UpdateTransactionInput;
+    protected instantiate(data: TransactionData): MexMJRTransaction;
+    /**
+     * Transforms a flattened MJRTransactionSort to nested TransactionSort format.
+     *
+     * Maps flattened field names to their full API paths using MJR-specific field mapping.
+     */
+    protected applyScopeToSort(sort?: MJRTransactionSort): TransactionSort | undefined;
+}
+//# sourceMappingURL=transactions.d.ts.map

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

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

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

@@ -0,0 +1,343 @@
+/**
+ * MJR (Metales y Joyas - Precious Metals and Jewelry) Transactions Resource
+ *
+ * Extends MexTransactionsResource with MJR-specific behavior:
+ * - Accepts flattened CreateMJRTransactionInput (MJR fields at root level)
+ * - Returns MexMJRTransaction models
+ * - Handles nested goods[] and payments[] arrays
+ */
+import { z } from "zod";
+import { Jurisdiction, CodigoActividad, createMJRTransactionInputSchema, updateMJRTransactionInputSchema, upsertMJRTransactionInputSchema, transformSort, mjrTransactionFieldMapping, } from "@artu-ai/shared";
+import { MexTransactionsResource } from "../../transactions";
+import { MexMJRTransaction } from "../../../../models";
+// ===========================
+// MJRTransactionsResource
+// ===========================
+/**
+ * MJR (Metales y Joyas) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const mjrSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.MJR,
+ * });
+ *
+ * // Create with fully flattened input
+ * const txn = await mjrSdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "601", // Sale
+ *   operationPostalCode: "06600",
+ *   goods: [
+ *     { goodType: "1", unit: "1", quantity: 1 }
+ *   ],
+ *   payments: [
+ *     { paymentDate: new Date(), paymentForm: "1", monetaryInstrument: "1", currency: "2", amount: 50000 }
+ *   ],
+ * });
+ *
+ * // Returns MexMJRTransaction
+ * console.log(txn.goods);
+ * console.log(txn.payments);
+ * ```
+ */
+export class MJRTransactionsResource extends MexTransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createMJRTransactionInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateMJRTransactionInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists MJR transactions with optional filtering.
+     *
+     * Accepts flattened MJR filter (future MJR-specific transaction 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.transactions.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over MJR transactions.
+     *
+     * Accepts flattened MJR filter (future MJR-specific transaction 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 transactions matching the given filter.
+     *
+     * @param filter - Optional filter criteria (with MJR fields at root level)
+     * @returns The count of matching transactions
+     */
+    async count(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
+        return response.count;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationship Management (scoped returns)
+    // ─────────────────────────────────────────────────────────────────
+    async listByClient(clientId, options) {
+        const response = await this.execute(() => this.trpc.transactions.listByClient.query({ clientId, ...options }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    async linkClient(transactionId, clientId, role) {
+        const response = await this.execute(() => this.trpc.transactions.linkClient.mutate({
+            transactionId,
+            clientId,
+            role,
+        }));
+        return this.instantiate(response);
+    }
+    async unlinkClient(transactionId, clientId) {
+        const response = await this.execute(() => this.trpc.transactions.unlinkClient.mutate({
+            transactionId,
+            clientId,
+        }));
+        return this.instantiate(response);
+    }
+    async setClients(transactionId, clients) {
+        const response = await this.execute(() => this.trpc.transactions.setClients.mutate({
+            transactionId,
+            clients,
+        }));
+        return this.instantiate(response);
+    }
+    async createMany(transactions, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createMJRTransactionInputSchema), transactions);
+        const nestedItems = validated.map((t) => this.transformToNested(t));
+        const response = await this.execute(() => this.trpc.transactions.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((t) => this.instantiate(t)),
+            };
+        }
+        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: updateMJRTransactionInputSchema,
+        });
+        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.transactions.updateMany.mutate({
+            items: nestedUpdates,
+            atomic,
+        }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((t) => this.instantiate(t)),
+            };
+        }
+        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 transaction by externalId.
+     *
+     * @param data - Transaction upsert data with MJR fields at root level (must include externalId)
+     * @returns The created or updated transaction with action indicator
+     */
+    async upsertByExternalId(data) {
+        const validated = this.validate(upsertMJRTransactionInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.upsertByExternalId.mutate(nestedData));
+        return {
+            data: this.instantiate(response.data),
+            action: response.action,
+        };
+    }
+    async upsertManyByExternalId(transactions, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(upsertMJRTransactionInputSchema), transactions);
+        const nestedItems = validated.map((t) => this.transformToNested(t));
+        const response = await this.execute(() => this.trpc.transactions.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,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    transformToNested(data) {
+        const { amount, currency, timestamp, relatedClientIds, description, externalId, metadata, operationType, operationPostalCode, goods, payments, } = data;
+        // Build base fields (relatedClientIds is required)
+        const baseFields = {
+            amount,
+            currency,
+            timestamp,
+            relatedClientIds,
+        };
+        if (description !== undefined)
+            baseFields.description = description;
+        if (externalId !== undefined)
+            baseFields.externalId = externalId;
+        if (metadata !== undefined)
+            baseFields.metadata = metadata;
+        // MJR-specific fields
+        const mjrFields = {
+            operationType,
+            operationPostalCode,
+            goods,
+            payments,
+        };
+        return {
+            ...baseFields,
+            primaryJurisdiction: Jurisdiction.Mexico,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.MJR]: mjrFields,
+                    },
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        // Cast to access fields - Zod validation ensures correctness
+        const input = data;
+        const { status, description, externalId, metadata, primaryJurisdiction, operationType, operationPostalCode, goods, payments, } = input;
+        // Build base update fields
+        const result = {};
+        if (status !== undefined)
+            result.status = status;
+        if (description !== undefined)
+            result.description = description;
+        if (externalId !== undefined)
+            result.externalId = externalId;
+        if (metadata !== undefined)
+            result.metadata = metadata;
+        if (primaryJurisdiction !== undefined)
+            result.primaryJurisdiction =
+                primaryJurisdiction;
+        // Build MJR fields object (even if empty, to ensure filterability)
+        const mjrData = {};
+        if (operationType !== undefined)
+            mjrData.operationType = operationType;
+        if (operationPostalCode !== undefined)
+            mjrData.operationPostalCode = operationPostalCode;
+        if (goods !== undefined)
+            mjrData.goods = goods;
+        if (payments !== undefined)
+            mjrData.payments = payments;
+        // Always include MJR activity marker to ensure filterability
+        // 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"] }`.
+        result.jurisdictions = {
+            MX: {
+                actividadVulnerable: {
+                    [CodigoActividad.MJR]: mjrData,
+                },
+            },
+        };
+        return result;
+    }
+    instantiate(data) {
+        return new MexMJRTransaction(data);
+    }
+    /**
+     * Transforms a flattened MJRTransactionSort to nested TransactionSort 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, mjrTransactionFieldMapping);
+    }
+}

package/dist/sdk/mex/actividad-vulnerable/index.d.ts

@@ -5,6 +5,7 @@
  */
 export { type AVISDKOptions, type AVIScopedSDKOptions, type AVIComplianceSDK, registerAVIScope, AVIComplianceSDKScoped, } from "./avi";
 export { type JYSSDKOptions, type JYSScopedSDKOptions, type JYSComplianceSDK, registerJYSScope, JYSComplianceSDKScoped, } from "./jys";
+export { type MJRSDKOptions, type MJRScopedSDKOptions, type MJRComplianceSDK, registerMJRScope, MJRComplianceSDKScoped, } from "./mjr";
 export { type TSCSDKOptions, type TSCScopedSDKOptions, type TSCComplianceSDK, registerTSCScope, TSCComplianceSDKScoped, } from "./tsc";
 /**
  * Registers all Actividad Vulnerable activity scopes

package/dist/sdk/mex/actividad-vulnerable/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/mex/actividad-vulnerable/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAMf,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAMf,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAUf;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAIxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/mex/actividad-vulnerable/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAMf,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAMf,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAMf,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AAWf;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAKxD"}

package/dist/sdk/mex/actividad-vulnerable/index.js

@@ -12,6 +12,10 @@ export { registerAVIScope, AVIComplianceSDKScoped, } from "./avi";
 // ===========================
 export { registerJYSScope, JYSComplianceSDKScoped, } from "./jys";
 // ===========================
+// MJR
+// ===========================
+export { registerMJRScope, MJRComplianceSDKScoped, } from "./mjr";
+// ===========================
 // TSC
 // ===========================
 export { registerTSCScope, TSCComplianceSDKScoped, } from "./tsc";
@@ -20,6 +24,7 @@ export { registerTSCScope, TSCComplianceSDKScoped, } from "./tsc";
 // ===========================
 import { registerAVIScope } from "./avi";
 import { registerJYSScope } from "./jys";
+import { registerMJRScope } from "./mjr";
 import { registerTSCScope } from "./tsc";
 /**
  * Registers all Actividad Vulnerable activity scopes
@@ -27,5 +32,6 @@ import { registerTSCScope } from "./tsc";
 export function registerActividadVulnerableScopes() {
     registerAVIScope();
     registerJYSScope();
+    registerMJRScope();
     registerTSCScope();
 }

package/dist/sdk/mex/actividad-vulnerable/mjr/ComplianceSDK.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MJR-scoped ComplianceSDK
+ *
+ * Pre-configured SDK for Mexico jurisdiction and Metales y Joyas (MJR) activity.
+ * Extends MexicoComplianceSDKScoped to inherit Mexico-specific resources like EBR.
+ */
+import { MexicoComplianceSDKScoped } from "../../ComplianceSDK";
+import type { MJRScopedSDKOptions } from "./types";
+import type { MJRClientsResource } from "../../../../resources/mex/actividad-vulnerable/mjr/clients";
+import type { MJRTransactionsResource } from "../../../../resources/mex/actividad-vulnerable/mjr/transactions";
+import type { MJRReportsResource } from "../../../../resources/mex/actividad-vulnerable/mjr/reports";
+/**
+ * MJR-scoped ComplianceSDK.
+ * Pre-configured for Mexico jurisdiction and Metales y Joyas (MJR) activity.
+ *
+ * Inherits Mexico-specific resources:
+ * - `ebr` - EBR (Evaluación Basada en Riesgos) for AML/KYC risk evaluation
+ *
+ * @example
+ * ```typescript
+ * import { ComplianceSDK } from "@artu/compliance-sdk/mexico/actividad-vulnerable/mjr";
+ *
+ * const sdk = new ComplianceSDK({
+ *   apiKey: process.env.API_KEY!,
+ *   environment: "test",
+ * });
+ *
+ * // Already scoped - no need to specify jurisdiction/activity
+ * const client = await sdk.clients.create({
+ *   type: ClientType.Person,
+ *   name: "Juan García",
+ * });
+ *
+ * // Create transactions with nested goods and payments
+ * const txn = await sdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "601",
+ *   operationPostalCode: "06600",
+ *   goods: [{ goodType: "1", unit: "1", quantity: 1 }],
+ *   payments: [{ paymentDate: new Date(), paymentForm: "1", monetaryInstrument: "1", currency: "2", amount: 50000 }],
+ *   relatedClientIds: [client.id],
+ * });
+ *
+ * // Access inherited EBR resource
+ * const weights = sdk.ebr.presets.suggested();
+ * ```
+ */
+export declare class MJRComplianceSDKScoped extends MexicoComplianceSDKScoped {
+    readonly clients: MJRClientsResource;
+    readonly transactions: MJRTransactionsResource;
+    readonly reports: MJRReportsResource;
+    constructor(options: MJRScopedSDKOptions);
+}
+//# sourceMappingURL=ComplianceSDK.d.ts.map

package/dist/sdk/mex/actividad-vulnerable/mjr/ComplianceSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComplianceSDK.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/mex/actividad-vulnerable/mjr/ComplianceSDK.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AACrG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4DAA4D,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,sBAAuB,SAAQ,yBAAyB;IAInE,SAAwB,OAAO,EAAE,kBAAkB,CAAC;IAEpD,SAAwB,YAAY,EAAE,uBAAuB,CAAC;IAE9D,SAAwB,OAAO,EAAE,kBAAkB,CAAC;gBAGxC,OAAO,EAAE,mBAAmB;CAGzC"}

package/dist/sdk/mex/actividad-vulnerable/mjr/ComplianceSDK.js

@@ -0,0 +1,51 @@
+/**
+ * MJR-scoped ComplianceSDK
+ *
+ * Pre-configured SDK for Mexico jurisdiction and Metales y Joyas (MJR) activity.
+ * Extends MexicoComplianceSDKScoped to inherit Mexico-specific resources like EBR.
+ */
+import { MexicoComplianceSDKScoped } from "../../ComplianceSDK";
+/**
+ * MJR-scoped ComplianceSDK.
+ * Pre-configured for Mexico jurisdiction and Metales y Joyas (MJR) activity.
+ *
+ * Inherits Mexico-specific resources:
+ * - `ebr` - EBR (Evaluación Basada en Riesgos) for AML/KYC risk evaluation
+ *
+ * @example
+ * ```typescript
+ * import { ComplianceSDK } from "@artu/compliance-sdk/mexico/actividad-vulnerable/mjr";
+ *
+ * const sdk = new ComplianceSDK({
+ *   apiKey: process.env.API_KEY!,
+ *   environment: "test",
+ * });
+ *
+ * // Already scoped - no need to specify jurisdiction/activity
+ * const client = await sdk.clients.create({
+ *   type: ClientType.Person,
+ *   name: "Juan García",
+ * });
+ *
+ * // Create transactions with nested goods and payments
+ * const txn = await sdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "601",
+ *   operationPostalCode: "06600",
+ *   goods: [{ goodType: "1", unit: "1", quantity: 1 }],
+ *   payments: [{ paymentDate: new Date(), paymentForm: "1", monetaryInstrument: "1", currency: "2", amount: 50000 }],
+ *   relatedClientIds: [client.id],
+ * });
+ *
+ * // Access inherited EBR resource
+ * const weights = sdk.ebr.presets.suggested();
+ * ```
+ */
+export class MJRComplianceSDKScoped extends MexicoComplianceSDKScoped {
+    // addresses and bankAccounts inherited from MexicoComplianceSDKImpl (MexAddressesResource, MexBankAccountsResource)
+    constructor(options) {
+        super({ ...options, actividadVulnerable: "MJR" });
+    }
+}

package/dist/sdk/mex/actividad-vulnerable/mjr/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MJR SDK Module
+ *
+ * Exports types, registration, and scoped SDK for Metales y Joyas.
+ */
+export { type MJRSDKOptions, type MJRScopedSDKOptions, type MJRComplianceSDK, registerMJRScope, } from "./types";
+export { MJRComplianceSDKScoped } from "./ComplianceSDK";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/mex/actividad-vulnerable/mjr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/mex/actividad-vulnerable/mjr/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/sdk/mex/actividad-vulnerable/mjr/index.js

@@ -0,0 +1,9 @@
+/**
+ * MJR SDK Module
+ *
+ * Exports types, registration, and scoped SDK for Metales y Joyas.
+ */
+// Types and registration
+export { registerMJRScope, } from "./types";
+// Scoped SDK class
+export { MJRComplianceSDKScoped } from "./ComplianceSDK";