@artu-ai/compliance-sdk 0.8.2 → 0.9.1

package/dist/resources/mex/actividad-vulnerable/tsc/{reports.js → alerts.js}

@@ -1,19 +1,19 @@
 /**
- * TSC (Tarjetas de Servicio y Crédito) Reports Resource
+ * TSC (Tarjetas de Servicio y Crédito) Alerts Resource
  *
- * Extends MexReportsResource with TSC-specific behavior:
- * - Accepts flattened CreateTSCReportInput (TSC fields at root level)
- * - Returns MexTSCReport models
+ * Extends MexAlertsResource with TSC-specific behavior:
+ * - Accepts flattened CreateTSCAlertInput (TSC fields at root level)
+ * - Returns MexTSCAlert models
  */
 import { z } from "zod";
-import { CodigoActividad, createTSCReportInputSchema, updateTSCReportInputSchema, upsertTSCReportInputSchema, createTSCReportItemInputSchema, updateTSCReportItemInputSchema, tscDefaultsInputSchema, submitTSCSubmissionInputSchema, transformSort, tscReportFieldMapping, } from "@artu-ai/shared";
-import { MexReportsResource } from "../../reports";
-import { MexTSCReport, MexTSCReportItem, } from "../../../../models";
+import { CodigoActividad, createTSCAlertInputSchema, updateTSCAlertInputSchema, upsertTSCAlertInputSchema, createTSCAlertItemInputSchema, updateTSCAlertItemInputSchema, tscDefaultsInputSchema, submitTSCSubmissionInputSchema, transformSort, tscAlertFieldMapping, } from "@artu-ai/shared";
+import { MexAlertsResource } from "../../alerts";
+import { MexTSCAlert, MexTSCAlertItem, } from "../../../../models";
 // ===========================
-// TSCReportsResource
+// TSCAlertsResource
 // ===========================
 /**
- * TSC (Tarjetas de Servicio y Crédito) scoped reports resource.
+ * TSC (Tarjetas de Servicio y Crédito) scoped alerts resource.
  *
  * @example
  * ```typescript
@@ -24,54 +24,54 @@ import { MexTSCReport, MexTSCReportItem, } from "../../../../models";
  * });
  *
  * // Create with fully flattened input
- * const report = await tscSdk.reports.create({
+ * const alert = await tscSdk.alerts.create({
  *   mesReportado: "202401",
  * });
  *
- * // Returns MexTSCReport
- * console.log(report.mesReportado);
+ * // Returns MexTSCAlert
+ * console.log(alert.mesReportado);
  * ```
  */
-export class TSCReportsResource extends MexReportsResource {
+export class TSCAlertsResource extends MexAlertsResource {
     // ─────────────────────────────────────────────────────────────────
-    // Report CRUD
+    // Alert CRUD
     // ─────────────────────────────────────────────────────────────────
     async create(data) {
-        const validated = this.validate(createTSCReportInputSchema, data);
+        const validated = this.validate(createTSCAlertInputSchema, data);
         const nestedData = this.transformToNested(validated);
-        const response = await this.execute(() => this.trpc.reports.create.mutate(nestedData));
+        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.reports.retrieve.query({ 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.reports.retrieveByMetadata.query({ 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.reports.retrieveByExternalId.query({ externalId }));
+        const response = await this.execute(() => this.trpc.alerts.retrieveByExternalId.query({ externalId }));
         return this.instantiate(response);
     }
     async update(id, data) {
-        const validated = this.validate(updateTSCReportInputSchema, data);
+        const validated = this.validate(updateTSCAlertInputSchema, data);
         const nestedData = this.transformUpdateToNested(validated);
-        const response = await this.execute(() => this.trpc.reports.update.mutate({ id, data: nestedData }));
+        const response = await this.execute(() => this.trpc.alerts.update.mutate({ id, data: nestedData }));
         return this.instantiate(response);
     }
     // ─────────────────────────────────────────────────────────────────
     // List & Pagination
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Lists TSC reports with optional filtering.
+     * Lists TSC alerts with optional filtering.
      *
-     * Accepts flattened TSC filter (future TSC-specific report fields at root level).
+     * Accepts flattened TSC filter (future TSC-specific alert 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({
+        const response = await this.execute(() => this.trpc.alerts.list.query({
             ...options,
             filter: scopedFilter,
             sort: scopedSort,
@@ -82,9 +82,9 @@ export class TSCReportsResource extends MexReportsResource {
         };
     }
     /**
-     * Iterates over TSC reports.
+     * Iterates over TSC alerts.
      *
-     * Accepts flattened TSC filter (future TSC-specific report fields at root level).
+     * Accepts flattened TSC filter (future TSC-specific alert fields at root level).
      */
     iterate(options) {
         const scopedFilter = this.applyScopeToFilter(options?.filter);
@@ -96,21 +96,21 @@ export class TSCReportsResource extends MexReportsResource {
         });
     }
     /**
-     * Counts TSC reports matching the given filter.
+     * Counts TSC alerts matching the given filter.
      *
      * @param filter - Optional filter criteria (with TSC fields at root level)
-     * @returns The count of matching reports
+     * @returns The count of matching alerts
      */
     async count(filter) {
         const scopedFilter = this.applyScopeToFilter(filter);
-        const response = await this.execute(() => this.trpc.reports.count.query({ filter: scopedFilter }));
+        const response = await this.execute(() => this.trpc.alerts.count.query({ filter: scopedFilter }));
         return response.count;
     }
-    async createMany(reports, options = {}) {
+    async createMany(alerts, options = {}) {
         const atomic = options.atomic ?? true;
-        const validated = this.validate(z.array(createTSCReportInputSchema), reports);
+        const validated = this.validate(z.array(createTSCAlertInputSchema), alerts);
         const nestedItems = validated.map((r) => this.transformToNested(r));
-        const response = await this.execute(() => this.trpc.reports.createMany.mutate({ items: nestedItems, atomic }));
+        const response = await this.execute(() => this.trpc.alerts.createMany.mutate({ items: nestedItems, atomic }));
         if (response.atomic) {
             return {
                 atomic: true,
@@ -132,14 +132,14 @@ export class TSCReportsResource extends MexReportsResource {
         const atomic = options.atomic ?? true;
         const updateItemSchema = z.object({
             id: z.uuid(),
-            data: updateTSCReportInputSchema,
+            data: updateTSCAlertInputSchema,
         });
         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 }));
+        const response = await this.execute(() => this.trpc.alerts.updateMany.mutate({ items: nestedUpdates, atomic }));
         if (response.atomic) {
             return {
                 atomic: true,
@@ -161,25 +161,25 @@ export class TSCReportsResource extends MexReportsResource {
     // Upsert Operations
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Creates or updates a TSC report by externalId.
+     * Creates or updates a TSC alert by externalId.
      *
-     * @param data - Report upsert data with TSC fields at root level (must include externalId)
-     * @returns The created or updated report with action indicator
+     * @param data - Alert upsert data with TSC fields at root level (must include externalId)
+     * @returns The created or updated alert with action indicator
      */
     async upsertByExternalId(data) {
-        const validated = this.validate(upsertTSCReportInputSchema, data);
+        const validated = this.validate(upsertTSCAlertInputSchema, data);
         const nestedData = this.transformToNested(validated);
-        const response = await this.execute(() => this.trpc.reports.upsertByExternalId.mutate(nestedData));
+        const response = await this.execute(() => this.trpc.alerts.upsertByExternalId.mutate(nestedData));
         return {
             data: this.instantiate(response.data),
             action: response.action,
         };
     }
-    async upsertManyByExternalId(reports, options = {}) {
+    async upsertManyByExternalId(alerts, options = {}) {
         const atomic = options.atomic ?? true;
-        const validated = this.validate(z.array(upsertTSCReportInputSchema), reports);
+        const validated = this.validate(z.array(upsertTSCAlertInputSchema), alerts);
         const nestedItems = validated.map((r) => this.transformToNested(r));
-        const response = await this.execute(() => this.trpc.reports.upsertManyByExternalId.mutate({
+        const response = await this.execute(() => this.trpc.alerts.upsertManyByExternalId.mutate({
             items: nestedItems,
             atomic,
         }));
@@ -207,33 +207,33 @@ export class TSCReportsResource extends MexReportsResource {
         }
     }
     // ─────────────────────────────────────────────────────────────────
-    // Report Items
+    // Alert Items
     // ─────────────────────────────────────────────────────────────────
-    async addItem(reportId, data) {
-        const validated = this.validate(createTSCReportItemInputSchema, data);
+    async addItem(alertId, data) {
+        const validated = this.validate(createTSCAlertItemInputSchema, data);
         const nestedData = this.transformItemToNested(validated);
-        const response = await this.execute(() => this.trpc.reports.addItem.mutate({ reportId, data: nestedData }));
+        const response = await this.execute(() => this.trpc.alerts.addItem.mutate({ alertId, data: nestedData }));
         return this.instantiateItem(response);
     }
-    async getItem(reportId, itemId) {
-        const response = await this.execute(() => this.trpc.reports.getItem.query({ reportId, itemId }));
+    async getItem(alertId, itemId) {
+        const response = await this.execute(() => this.trpc.alerts.getItem.query({ alertId, itemId }));
         return this.instantiateItem(response);
     }
-    async updateItem(reportId, itemId, data) {
-        const validated = this.validate(updateTSCReportItemInputSchema, data);
+    async updateItem(alertId, itemId, data) {
+        const validated = this.validate(updateTSCAlertItemInputSchema, data);
         const nestedData = this.transformItemUpdateToNested(validated);
-        const response = await this.execute(() => this.trpc.reports.updateItem.mutate({
-            reportId,
+        const response = await this.execute(() => this.trpc.alerts.updateItem.mutate({
+            alertId,
             itemId,
             data: nestedData,
         }));
         return this.instantiateItem(response);
     }
-    async listItems(reportId, options) {
+    async listItems(alertId, options) {
         // Transform flattened TSC filter to nested format
         const scopedFilter = this.applyScopeToItemFilter(options?.filter);
-        const response = await this.execute(() => this.trpc.reports.listItems.query({
-            reportId,
+        const response = await this.execute(() => this.trpc.alerts.listItems.query({
+            alertId,
             ...options,
             filter: scopedFilter,
         }));
@@ -243,7 +243,7 @@ export class TSCReportsResource extends MexReportsResource {
         };
     }
     /**
-     * Transforms a flattened TSCReportItemFilter to nested ReportItemFilter format.
+     * Transforms a flattened TSCAlertItemFilter to nested AlertItemFilter format.
      */
     applyScopeToItemFilter(filter) {
         if (!filter)
@@ -270,10 +270,10 @@ export class TSCReportsResource extends MexReportsResource {
             },
         };
     }
-    async addItems(reportId, items) {
-        const validated = this.validate(z.array(createTSCReportItemInputSchema), items);
+    async addItems(alertId, items) {
+        const validated = this.validate(z.array(createTSCAlertItemInputSchema), items);
         const nestedItems = validated.map((i) => this.transformItemToNested(i));
-        const response = await this.execute(() => this.trpc.reports.addItems.mutate({ reportId, items: nestedItems }));
+        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)),
@@ -283,47 +283,47 @@ export class TSCReportsResource extends MexReportsResource {
     // Validation
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Validates a TSC report.
+     * Validates a TSC alert.
      *
      * Uses TSC-scoped validation input (jurisdiction and activity are implicit).
      *
-     * @param reportId - The report ID to validate
-     * @param defaults - TSC report defaults including rfc, alertType, etc.
+     * @param alertId - The alert ID to validate
+     * @param defaults - TSC alert defaults including rfc, alertType, etc.
      *
      * @example
      * ```typescript
-     * const result = await tscSdk.reports.validateReport(report.id, {
+     * const result = await tscSdk.alerts.validateAlert(alert.id, {
      *   rfc: "ABC200101XXX",
      *   alertType: "100",
      * });
      * ```
      */
-    async validateReport(reportId, defaults) {
+    async validateAlert(alertId, defaults) {
         const validated = this.validate(tscDefaultsInputSchema, defaults);
-        const nestedInput = this.transformTscDefaultsToNested(reportId, validated);
-        return this.execute(() => this.trpc.reports.validate.mutate(nestedInput));
+        const nestedInput = this.transformTscDefaultsToNested(alertId, validated);
+        return this.execute(() => this.trpc.alerts.validate.mutate(nestedInput));
     }
     // ─────────────────────────────────────────────────────────────────
     // Generation
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Generates XML for a TSC report.
+     * Generates XML for a TSC alert.
      *
-     * Uses the same input as validateReport.
+     * Uses the same input as validateAlert.
      *
-     * @param reportId - The report ID to generate XML for
-     * @param defaults - TSC report defaults including rfc, alertType, etc.
+     * @param alertId - The alert ID to generate XML for
+     * @param defaults - TSC alert defaults including rfc, alertType, etc.
      */
-    async generateReport(reportId, defaults) {
+    async generateAlert(alertId, defaults) {
         const validated = this.validate(tscDefaultsInputSchema, defaults);
-        const nestedInput = this.transformTscDefaultsToNested(reportId, validated);
-        return this.execute(() => this.trpc.reports.generate.mutate(nestedInput));
+        const nestedInput = this.transformTscDefaultsToNested(alertId, validated);
+        return this.execute(() => this.trpc.alerts.generate.mutate(nestedInput));
     }
     // ─────────────────────────────────────────────────────────────────
     // Submission
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Submits a validated TSC report.
+     * Submits a validated TSC alert.
      *
      * Uses TSC-scoped submission input (activity is implicit).
      */
@@ -339,8 +339,8 @@ export class TSCReportsResource extends MexReportsResource {
                 },
             },
         };
-        return this.execute(() => this.trpc.reports.submit.mutate({
-            reportId: validated.reportId,
+        return this.execute(() => this.trpc.alerts.submit.mutate({
+            alertId: validated.alertId,
             jurisdictions,
         }));
     }
@@ -381,10 +381,10 @@ export class TSCReportsResource extends MexReportsResource {
         };
     }
     instantiate(data) {
-        return new MexTSCReport(data);
+        return new MexTSCAlert(data);
     }
     instantiateItem(data) {
-        return new MexTSCReportItem(data);
+        return new MexTSCAlertItem(data);
     }
     transformItemToNested(data) {
         const { alertType, alertDescription, amendment, ...baseFields } = data;
@@ -430,7 +430,7 @@ export class TSCReportsResource extends MexReportsResource {
         };
     }
     /**
-     * Transforms a flattened TSCReportSort to nested ReportSort format.
+     * Transforms a flattened TSCAlertSort to nested AlertSort format.
      *
      * Maps flattened field names to their full API paths using TSC-specific field mapping.
      */
@@ -438,15 +438,15 @@ export class TSCReportsResource extends MexReportsResource {
         if (!sort || sort.length === 0) {
             return undefined;
         }
-        return transformSort(sort, tscReportFieldMapping);
+        return transformSort(sort, tscAlertFieldMapping);
     }
     /**
      * Transforms TSC defaults to nested API format for validate/generate.
      */
-    transformTscDefaultsToNested(reportId, defaults) {
+    transformTscDefaultsToNested(alertId, defaults) {
         const { rfc, collegiateEntityCode, exempt, priority, ...tscFields } = defaults;
         return {
-            reportId,
+            alertId,
             jurisdictions: {
                 MX: {
                     actividadVulnerable: {

package/dist/resources/mex/actividad-vulnerable/tsc/index.d.ts

@@ -3,5 +3,5 @@
  */
 export { TSCClientsResource } from "./clients";
 export { TSCTransactionsResource } from "./transactions";
-export { TSCReportsResource } from "./reports";
+export { TSCAlertsResource } from "./alerts";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/resources/mex/actividad-vulnerable/tsc/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/resources/mex/actividad-vulnerable/tsc/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/resources/mex/actividad-vulnerable/tsc/index.js

@@ -3,4 +3,4 @@
  */
 export { TSCClientsResource } from "./clients";
 export { TSCTransactionsResource } from "./transactions";
-export { TSCReportsResource } from "./reports";
+export { TSCAlertsResource } from "./alerts";

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

@@ -0,0 +1,266 @@
+/**
+ * Mexico Alerts Resource
+ *
+ * Extends AlertsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexAlertInput (MX fields at root level)
+ * - Transforms flattened filters to nested format
+ * - Returns MexAlert models
+ */
+import type { CreateAlertInput, UpdateAlertInput, CreateAlertItemInput, UpdateAlertItemInput, CreateMexAlertInput, UpdateMexAlertInput, UpsertMexAlertInput, CreateMexAlertItemInput, UpdateMexAlertItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, MexSubmitAlertInput, ValidationResult, GenerateResult, SubmissionResult, MexAlertDefaultsInput, AlertDefaultsInput, UpsertResult } from "@artu-ai/shared";
+import type { AlertFilter, AlertSort, MexAlertFilter, MexAlertSort } from "@artu-ai/shared";
+import { AlertsResource, type AlertItemFilter, type AlertItemSort } from "../alerts";
+import { MexAlert, type AlertData, type AlertItemData } from "../../models";
+import { MexAlertItem } from "../../models/mex";
+/**
+ * Mexico-scoped alerts resource.
+ *
+ * Provides the same operations as AlertsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexAlert model return type
+ *
+ * @example
+ * ```typescript
+ * // Using the Mexico SDK entry point
+ * import { ComplianceSDK } from "@artu-ai/compliance-sdk/mexico";
+ *
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ * });
+ *
+ * // Create with flattened input
+ * const alert = await mexSdk.alerts.create({
+ *   actividadVulnerable: {
+ *     AVI: { mesReportado: "202401" },
+ *   },
+ * });
+ *
+ * // List alerts
+ * const { data } = await mexSdk.alerts.list();
+ * // data is MexAlert[]
+ * ```
+ */
+export declare class MexAlertsResource<TSort = MexAlertSort, TDefaults = MexAlertDefaultsInput> extends AlertsResource<TSort, TDefaults> {
+    /**
+     * Creates a new Mexico alert with flattened input.
+     */
+    create(data: CreateMexAlertInput): Promise<MexAlert>;
+    /**
+     * Retrieves a alert by ID.
+     */
+    retrieve(id: string): Promise<MexAlert>;
+    retrieveByMetadata(key: string, value: string): Promise<MexAlert>;
+    retrieveByExternalId(externalId: string): Promise<MexAlert>;
+    /**
+     * Updates a Mexico alert with flattened input.
+     */
+    update(id: string, data: UpdateMexAlertInput): Promise<MexAlert>;
+    /**
+     * Lists Mexico alerts with optional filtering.
+     *
+     * Accepts flattened MX filter (future MX-specific alert fields at root level).
+     */
+    list(options?: ListOptions<MexAlertFilter, TSort>): Promise<PaginatedResponse<MexAlert>>;
+    /**
+     * Counts Mexico alerts matching the given filter.
+     *
+     * @param filter - Optional filter criteria (with MX fields at root level)
+     * @returns The count of matching alerts
+     */
+    count(filter?: MexAlertFilter): Promise<number>;
+    /**
+     * Iterates over Mexico alerts.
+     *
+     * Accepts flattened MX filter (future MX-specific alert fields at root level).
+     */
+    iterate(options?: {
+        filter?: MexAlertFilter;
+        sort?: TSort;
+        pageSize?: number;
+    }): AsyncGenerator<MexAlert, void, undefined>;
+    createMany(alerts: CreateMexAlertInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAlert>>;
+    createMany(alerts: CreateMexAlertInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAlert>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexAlertInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAlert>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexAlertInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAlert>>;
+    /**
+     * Creates or updates a Mexico alert by externalId.
+     *
+     * @param data - Alert upsert data with MX fields at root level (must include externalId)
+     * @returns The created or updated alert with action indicator
+     */
+    upsertByExternalId(data: UpsertMexAlertInput): Promise<UpsertResult<MexAlert>>;
+    /**
+     * Creates or updates multiple Mexico alerts by externalId.
+     *
+     * @param alerts - Array of alert 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(alerts: UpsertMexAlertInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<UpsertResult<MexAlert>>>;
+    upsertManyByExternalId(alerts: UpsertMexAlertInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<UpsertResult<MexAlert>>>;
+    /**
+     * Adds an item to a alert with flattened Mexico input.
+     */
+    addItem(alertId: string, data: CreateMexAlertItemInput): Promise<MexAlertItem>;
+    /**
+     * Gets a specific alert item.
+     */
+    getItem(alertId: string, itemId: string): Promise<MexAlertItem>;
+    /**
+     * Updates a alert item with flattened Mexico input.
+     */
+    updateItem(alertId: string, itemId: string, data: UpdateMexAlertItemInput): Promise<MexAlertItem>;
+    /**
+     * Lists items in a alert with filtering, sorting, and pagination.
+     */
+    listItems(alertId: string, options?: ListOptions<AlertItemFilter, AlertItemSort>): Promise<PaginatedResponse<MexAlertItem>>;
+    /**
+     * Adds multiple items to a alert with flattened Mexico input.
+     */
+    addItems(alertId: string, items: CreateMexAlertItemInput[]): Promise<{
+        added: number;
+        items: MexAlertItem[];
+    }>;
+    /**
+     * Validates a Mexico alert.
+     *
+     * Uses Mexico-scoped validation input (jurisdiction is implicit).
+     *
+     * @param alertId - The alert ID to validate
+     * @param defaults - Mexico alert defaults including activity-specific settings
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.alerts.validateAlert(alert.id, {
+     *   actividadVulnerable: {
+     *     rfc: "ABC200101XXX",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    validateAlert(alertId: string, defaults: TDefaults): Promise<ValidationResult>;
+    /**
+     * Generates XML for a Mexico alert.
+     *
+     * Uses the same input as validateAlert since generation requires
+     * the same transformation and defaults.
+     *
+     * @param alertId - The alert ID to generate XML for
+     * @param defaults - Mexico alert defaults including activity-specific settings
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.alerts.generateAlert(alert.id, {
+     *   actividadVulnerable: {
+     *     rfc: "ABC200101XXX",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
+     *   },
+     * });
+     * console.log(result.xml);
+     * ```
+     */
+    generateAlert(alertId: string, defaults: TDefaults): Promise<GenerateResult>;
+    /**
+     * Submits a validated Mexico alert.
+     *
+     * The alert must be in "valid" status. After submission, the alert
+     * is locked and cannot be edited (except rejected alerts which can
+     * be edited and resubmitted).
+     *
+     * @param alertId - The alert ID
+     * @param actividadVulnerable - The activity type (AVI, JYS, or TSC)
+     * @param data - Optional submission data (acuseRecibo, notes)
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.alerts.submitAlert(
+     *   alert.id,
+     *   "AVI",
+     *   { acuseRecibo: "SAT-12345", notes: "Submitted via portal" }
+     * );
+     * ```
+     */
+    submit(input: MexSubmitAlertInput): Promise<SubmissionResult>;
+    /**
+     * Transforms a flattened MexAlertFilter to nested AlertFilter format.
+     *
+     * Currently MexAlertFilter has the same fields as the base filter.
+     *
+     * Note: This method only transforms filters, it does not automatically add
+     * jurisdiction scoping. Use explicit filters if you need to scope by jurisdiction.
+     */
+    protected applyScopeToFilter(filter?: MexAlertFilter): AlertFilter | undefined;
+    /**
+     * Transforms a flattened MexAlertSort to nested AlertSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     *
+     * Note: Uses unknown parameter to allow derived classes to override with their own sort types.
+     */
+    protected applyScopeToSort(sort?: TSort): AlertSort | undefined;
+    /**
+     * Transforms flattened MX input to nested API format.
+     *
+     * NOTE: Always includes `jurisdictions: { MX: {} }` even if no MX-specific
+     * fields are provided. This ensures that records created via the Mexico SDK
+     * can be filtered by `availableJurisdictions: { in: ["MX"] }`.
+     */
+    protected transformToNested(data: CreateMexAlertInput): CreateAlertInput;
+    /**
+     * Transforms flattened MX update input to nested API format.
+     *
+     * NOTE: Always includes `jurisdictions: { MX: {} }` even if no MX-specific
+     * fields are provided. This ensures that records touched via the Mexico SDK
+     * can be filtered by `availableJurisdictions: { in: ["MX"] }`.
+     */
+    protected transformUpdateToNested(data: UpdateMexAlertInput): UpdateAlertInput;
+    /**
+     * Instantiates a MexAlert model.
+     */
+    protected instantiate(data: AlertData): MexAlert;
+    /**
+     * Instantiates a MexAlertItem model.
+     */
+    protected instantiateItem(data: AlertItemData): MexAlertItem;
+    /**
+     * Transforms flattened MX alert item input to nested API format.
+     */
+    protected transformItemToNested(data: CreateMexAlertItemInput): CreateAlertItemInput;
+    /**
+     * Transforms flattened MX alert item update input to nested API format.
+     */
+    protected transformItemUpdateToNested(data: UpdateMexAlertItemInput): UpdateAlertItemInput;
+    /**
+     * Transforms flattened MX validate/generate input to nested API format.
+     */
+    protected transformValidateToNested(alertId: string, defaults: MexAlertDefaultsInput): {
+        alertId: string;
+    } & AlertDefaultsInput;
+}
+//# sourceMappingURL=alerts.d.ts.map