@artu-ai/compliance-sdk 0.8.2 → 0.9.0

package/dist/resources/{reports.js → alerts.js}

@@ -1,33 +1,33 @@
 /**
- * Reports Resource
+ * Alerts Resource
  *
- * CRUD operations, report items management, validation, and generation.
+ * CRUD operations, alert items management, validation, and generation.
  *
  * This is the base (unscoped) resource. For jurisdiction-scoped SDKs, use:
- * - MexReportsResource - Mexico-scoped with flattened MX fields
- * - AVIReportsResource - Mexico AVI-scoped with flattened AVI fields
- * - JYSReportsResource - Mexico JYS-scoped with flattened JYS fields
- * - TSCReportsResource - Mexico TSC-scoped with flattened TSC fields
+ * - MexAlertsResource - Mexico-scoped with flattened MX fields
+ * - AVIAlertsResource - Mexico AVI-scoped with flattened AVI fields
+ * - JYSAlertsResource - Mexico JYS-scoped with flattened JYS fields
+ * - TSCAlertsResource - Mexico TSC-scoped with flattened TSC fields
  */
 import { z } from "zod";
-import { createReportInputSchema, updateReportInputSchema, upsertReportInputSchema, updateReportStatusInputSchema, createReportItemInputSchema, updateReportItemInputSchema, reportDefaultsInputSchema, submitReportInputSchema, } from "@artu-ai/shared";
+import { createAlertInputSchema, updateAlertInputSchema, upsertAlertInputSchema, updateReportStatusInputSchema, createAlertItemInputSchema, updateAlertItemInputSchema, alertDefaultsInputSchema, submitAlertInputSchema, } from "@artu-ai/shared";
 import { BaseResource } from "./base";
-import { Report, ReportItem, } from "../models";
+import { Alert, AlertItem, } from "../models";
 // ===========================
-// ReportsResource
+// AlertsResource
 // ===========================
 /**
- * Base resource manager for report operations.
+ * Base resource manager for alert operations.
  *
  * Provides:
  * - CRUD operations (create, retrieve, update, delete)
- * - Report items management (add, update, remove items)
+ * - Alert items management (add, update, remove items)
  * - Validation and generation
  *
  * @example
  * ```typescript
- * // Create a report with full nested format
- * const report = await sdk.reports.create({
+ * // Create a alert with full nested format
+ * const alert = await sdk.alerts.create({
  *   jurisdictions: {
  *     MX: {
  *       actividadVulnerable: {
@@ -37,105 +37,105 @@ import { Report, ReportItem, } from "../models";
  *   }
  * });
  *
- * // Add items to the report
- * await sdk.reports.addItem(report.id, {
+ * // Add items to the alert
+ * await sdk.alerts.addItem(alert.id, {
  *   transactionId: "txn_123",
  * });
  *
- * // Validate the report
- * const result = await sdk.reports.validate(report.id);
+ * // Validate the alert
+ * const result = await sdk.alerts.validate(alert.id);
  * if (result.valid) {
  *   // Generate XML
- *   const xml = await sdk.reports.generate(report.id);
+ *   const xml = await sdk.alerts.generate(alert.id);
  * }
  * ```
  */
-export class ReportsResource extends BaseResource {
+export class AlertsResource extends BaseResource {
     // ─────────────────────────────────────────────────────────────────
-    // Report CRUD
+    // Alert CRUD
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Creates a new report.
+     * Creates a new alert.
      *
-     * @param data - Report creation data in nested format
-     * @returns The created report model
+     * @param data - Alert creation data in nested format
+     * @returns The created alert model
      */
     async create(data) {
-        const validated = this.validate(createReportInputSchema, data);
-        const response = await this.execute(() => this.trpc.reports.create.mutate(validated));
+        const validated = this.validate(createAlertInputSchema, data);
+        const response = await this.execute(() => this.trpc.alerts.create.mutate(validated));
         return this.instantiate(response);
     }
     /**
-     * Retrieves a report by ID.
+     * Retrieves a alert by ID.
      */
     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);
     }
     /**
-     * Retrieves a report by metadata key/value.
+     * Retrieves a alert by metadata key/value.
      */
     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);
     }
     /**
-     * Retrieves a report by externalId.
+     * Retrieves a alert by externalId.
      */
     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);
     }
     /**
-     * Updates a report.
+     * Updates a alert.
      */
     async update(id, data) {
-        const validated = this.validate(updateReportInputSchema, data);
-        const response = await this.execute(() => this.trpc.reports.update.mutate({ id, data: validated }));
+        const validated = this.validate(updateAlertInputSchema, data);
+        const response = await this.execute(() => this.trpc.alerts.update.mutate({ id, data: validated }));
         return this.instantiate(response);
     }
     /**
-     * Updates a report's status.
+     * Updates a alert's status.
      *
      * Restrictions:
      * - Can only manually set to: Draft
      * - Cannot change from: Accepted (terminal), Submitted (awaiting response)
      *
-     * Use this to reset a report back to Draft status for re-editing.
+     * Use this to reset a alert back to Draft status for re-editing.
      */
     async updateStatus(id, data) {
         const validated = this.validate(updateReportStatusInputSchema, data);
-        const response = await this.execute(() => this.trpc.reports.updateStatus.mutate({ id, data: validated }));
+        const response = await this.execute(() => this.trpc.alerts.updateStatus.mutate({ id, data: validated }));
         return this.instantiate(response);
     }
     /**
-     * Deletes a report.
+     * Deletes a alert.
      */
     async delete(id) {
-        await this.execute(() => this.trpc.reports.delete.mutate({ id }));
+        await this.execute(() => this.trpc.alerts.delete.mutate({ id }));
     }
     /**
-     * Lists reports with optional filtering and pagination.
+     * Lists alerts with optional filtering and pagination.
      */
     async list(options) {
-        const response = await this.execute(() => this.trpc.reports.list.query(options));
+        const response = await this.execute(() => this.trpc.alerts.list.query(options));
         return {
             data: response.data.map((r) => this.instantiate(r)),
             pagination: response.pagination,
         };
     }
     /**
-     * Counts reports matching the given filter.
+     * Counts alerts matching the given filter.
      *
      * @param filter - Optional filter criteria
-     * @returns The count of matching reports
+     * @returns The count of matching alerts
      */
     async count(filter) {
-        const response = await this.execute(() => this.trpc.reports.count.query({ filter }));
+        const response = await this.execute(() => this.trpc.alerts.count.query({ filter }));
         return response.count;
     }
     /**
-     * Returns an async iterator over all reports matching the filter.
+     * Returns an async iterator over all alerts matching the filter.
      */
     iterate(options) {
         return this.createIterator({
@@ -145,47 +145,47 @@ export class ReportsResource extends BaseResource {
         });
     }
     // ─────────────────────────────────────────────────────────────────
-    // Report Items
+    // Alert Items
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Adds an item to a report.
+     * Adds an item to a alert.
      */
-    async addItem(reportId, data) {
-        const validated = this.validate(createReportItemInputSchema, data);
-        const response = await this.execute(() => this.trpc.reports.addItem.mutate({ reportId, data: validated }));
+    async addItem(alertId, data) {
+        const validated = this.validate(createAlertItemInputSchema, data);
+        const response = await this.execute(() => this.trpc.alerts.addItem.mutate({ alertId, data: validated }));
         return this.instantiateItem(response);
     }
     /**
-     * Gets a specific report item.
+     * Gets a specific alert item.
      */
-    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);
     }
     /**
-     * Updates a report item.
+     * Updates a alert item.
      */
-    async updateItem(reportId, itemId, data) {
-        const validated = this.validate(updateReportItemInputSchema, data);
-        const response = await this.execute(() => this.trpc.reports.updateItem.mutate({
-            reportId,
+    async updateItem(alertId, itemId, data) {
+        const validated = this.validate(updateAlertItemInputSchema, data);
+        const response = await this.execute(() => this.trpc.alerts.updateItem.mutate({
+            alertId,
             itemId,
             data: validated,
         }));
         return this.instantiateItem(response);
     }
     /**
-     * Removes an item from a report.
+     * Removes an item from a alert.
      */
-    async removeItem(reportId, itemId) {
-        await this.execute(() => this.trpc.reports.removeItem.mutate({ reportId, itemId }));
+    async removeItem(alertId, itemId) {
+        await this.execute(() => this.trpc.alerts.removeItem.mutate({ alertId, itemId }));
     }
     /**
-     * Lists items in a report with filtering, sorting, and pagination.
+     * Lists items in a alert with filtering, sorting, and pagination.
      */
-    async listItems(reportId, options) {
-        const response = await this.execute(() => this.trpc.reports.listItems.query({
-            reportId,
+    async listItems(alertId, options) {
+        const response = await this.execute(() => this.trpc.alerts.listItems.query({
+            alertId,
             ...options,
         }));
         return {
@@ -194,96 +194,96 @@ export class ReportsResource extends BaseResource {
         };
     }
     /**
-     * Adds multiple items to a report.
+     * Adds multiple items to a alert.
      * Validates all items upfront - fails fast if any item is invalid.
      */
-    async addItems(reportId, items) {
-        const validated = this.validate(z.array(createReportItemInputSchema), items);
-        const response = await this.execute(() => this.trpc.reports.addItems.mutate({ reportId, items: validated }));
+    async addItems(alertId, items) {
+        const validated = this.validate(z.array(createAlertItemInputSchema), items);
+        const response = await this.execute(() => this.trpc.alerts.addItems.mutate({ alertId, items: validated }));
         return {
             added: response.added,
             items: response.items.map((i) => this.instantiateItem(i)),
         };
     }
     /**
-     * Removes multiple items from a report.
+     * Removes multiple items from a alert.
      */
-    async removeItems(reportId, itemIds) {
-        return this.execute(() => this.trpc.reports.removeItems.mutate({ reportId, itemIds }));
+    async removeItems(alertId, itemIds) {
+        return this.execute(() => this.trpc.alerts.removeItems.mutate({ alertId, itemIds }));
     }
     // ─────────────────────────────────────────────────────────────────
     // Validation & Generation
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Validates a report and its items.
+     * Validates a alert and its items.
      *
      * Requires jurisdiction-specific defaults.
      * For scoped SDKs, use the scoped resource which provides a simpler API.
      *
-     * @param reportId - The report ID to validate
+     * @param alertId - The alert ID to validate
      * @param defaults - Jurisdiction-specific defaults for validation
      */
-    async validateReport(reportId, defaults) {
-        const validated = this.validate(reportDefaultsInputSchema, defaults);
-        return this.execute(() => this.trpc.reports.validate.mutate({ reportId, ...validated }));
+    async validateAlert(alertId, defaults) {
+        const validated = this.validate(alertDefaultsInputSchema, defaults);
+        return this.execute(() => this.trpc.alerts.validate.mutate({ alertId, ...validated }));
     }
     /**
-     * Validates and generates the report output (e.g., XML for Mexico reports).
+     * Validates and generates the alert output (e.g., XML for Mexico alerts).
      *
      * Performs validation first:
      * - If validation fails, returns `{ status: "validation_failed", validation: {...} }`
      * - If validation passes, returns `{ status: "success", xml: "...", ... }`
      *
-     * Use `validateReport` for dry-run/preview validation without generating XML.
+     * Use `validateAlert` for dry-run/preview validation without generating XML.
      *
-     * @param reportId - The report ID to generate
+     * @param alertId - The alert ID to generate
      * @param defaults - Jurisdiction-specific defaults for generation
      * @returns GenerateResult with status "success" or "validation_failed"
      */
-    async generateReport(reportId, defaults) {
-        const validated = this.validate(reportDefaultsInputSchema, defaults);
-        return this.execute(() => this.trpc.reports.generate.mutate({ reportId, ...validated }));
+    async generateAlert(alertId, defaults) {
+        const validated = this.validate(alertDefaultsInputSchema, defaults);
+        return this.execute(() => this.trpc.alerts.generate.mutate({ alertId, ...validated }));
     }
     // ─────────────────────────────────────────────────────────────────
     // Submission
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Submits a validated report.
+     * Submits a validated alert.
      *
-     * The report must be in "valid" status. After submission, the report
+     * The alert must be in "valid" status. After submission, the alert
      * is locked and cannot be edited.
      *
-     * @param reportId - The report ID
+     * @param alertId - The alert ID
      * @param input - Submission data with jurisdiction-specific structure
      */
     async submit(input) {
-        const validated = this.validate(submitReportInputSchema, input);
-        return this.execute(() => this.trpc.reports.submit.mutate(validated));
+        const validated = this.validate(submitAlertInputSchema, input);
+        return this.execute(() => this.trpc.alerts.submit.mutate(validated));
     }
     // ─────────────────────────────────────────────────────────────────
     // Upsert Operations
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Creates or updates a report by externalId.
+     * Creates or updates a alert by externalId.
      *
-     * If a report with the given externalId exists, it will be updated.
-     * Otherwise, a new report will be created.
+     * If a alert with the given externalId exists, it will be updated.
+     * Otherwise, a new alert will be created.
      *
-     * @param data - Report upsert data (must include externalId)
-     * @returns The created or updated report with action indicator
+     * @param data - Alert upsert data (must include externalId)
+     * @returns The created or updated alert with action indicator
      */
     async upsertByExternalId(data) {
-        const validated = this.validate(upsertReportInputSchema, data);
-        const response = await this.execute(() => this.trpc.reports.upsertByExternalId.mutate(validated));
+        const validated = this.validate(upsertAlertInputSchema, data);
+        const response = await this.execute(() => this.trpc.alerts.upsertByExternalId.mutate(validated));
         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(upsertReportInputSchema), reports);
-        const response = await this.execute(() => this.trpc.reports.upsertManyByExternalId.mutate({
+        const validated = this.validate(z.array(upsertAlertInputSchema), alerts);
+        const response = await this.execute(() => this.trpc.alerts.upsertManyByExternalId.mutate({
             items: validated,
             atomic,
         }));
@@ -310,10 +310,10 @@ export class ReportsResource extends BaseResource {
             };
         }
     }
-    async createMany(reports, options = {}) {
+    async createMany(alerts, options = {}) {
         const atomic = options.atomic ?? true;
-        const validated = this.validate(z.array(createReportInputSchema), reports);
-        const response = await this.execute(() => this.trpc.reports.createMany.mutate({ items: validated, atomic }));
+        const validated = this.validate(z.array(createAlertInputSchema), alerts);
+        const response = await this.execute(() => this.trpc.alerts.createMany.mutate({ items: validated, atomic }));
         if (response.atomic) {
             return {
                 atomic: true,
@@ -335,10 +335,10 @@ export class ReportsResource extends BaseResource {
         const atomic = options.atomic ?? true;
         const updateItemSchema = z.object({
             id: z.uuid(),
-            data: updateReportInputSchema,
+            data: updateAlertInputSchema,
         });
         const validated = this.validate(z.array(updateItemSchema), updates);
-        const response = await this.execute(() => this.trpc.reports.updateMany.mutate({ items: validated, atomic }));
+        const response = await this.execute(() => this.trpc.alerts.updateMany.mutate({ items: validated, atomic }));
         if (response.atomic) {
             return {
                 atomic: true,
@@ -360,17 +360,17 @@ export class ReportsResource extends BaseResource {
     // Instantiation (protected for subclasses to override)
     // ─────────────────────────────────────────────────────────────────
     /**
-     * Instantiates a Report model from API response data.
+     * Instantiates a Alert model from API response data.
      * Subclasses override this to return their specific model type.
      */
     instantiate(data) {
-        return new Report(data);
+        return new Alert(data);
     }
     /**
-     * Instantiates a ReportItem model from API response data.
+     * Instantiates a AlertItem model from API response data.
      * Subclasses override this to return their specific model type.
      */
     instantiateItem(data) {
-        return new ReportItem(data);
+        return new AlertItem(data);
     }
 }

package/dist/resources/index.d.ts

@@ -14,7 +14,7 @@ export { BaseResource, ReadOnlyResource, type ResourceConfig } from "./base";
 export { ClientsResource, type BatchOptions } from "./clients";
 export { TransactionsResource } from "./transactions";
 export type { RelatedClient, LinkedClient } from "@artu-ai/shared";
-export { ReportsResource, type ReportFilter, type ReportItemFilter, type AddItemsResult, } from "./reports";
+export { AlertsResource, type AlertFilter, type AlertItemFilter, type AddItemsResult, } from "./alerts";
 export { AddressesResource } from "./addresses";
 export { ContactMethodsResource } from "./contact-methods";
 export { BankAccountsResource } from "./bank-accounts";

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,cAAc,OAAO,CAAC"}

package/dist/resources/index.js

@@ -15,7 +15,7 @@ export { BaseResource, ReadOnlyResource } from "./base";
 // Base resource implementations (unscoped)
 export { ClientsResource } from "./clients";
 export { TransactionsResource } from "./transactions";
-export { ReportsResource, } from "./reports";
+export { AlertsResource, } from "./alerts";
 // Supporting resources
 export { AddressesResource } from "./addresses";
 export { ContactMethodsResource } from "./contact-methods";

package/dist/resources/mex/actividad-vulnerable/avi/alerts.d.ts

@@ -0,0 +1,190 @@
+/**
+ * AVI (Activos Virtuales) Alerts Resource
+ *
+ * Extends MexAlertsResource with AVI-specific behavior:
+ * - Accepts flattened CreateAVIAlertInput (AVI fields at root level)
+ * - Returns MexAVIAlert models
+ */
+import type { CreateAlertInput, UpdateAlertInput, CreateAlertItemInput, UpdateAlertItemInput, CreateAVIAlertInput, UpdateAVIAlertInput, UpsertAVIAlertInput, CreateAVIAlertItemInput, UpdateAVIAlertItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ValidationResult, GenerateResult, SubmissionResult, AviAlertDefaultsInput, SubmitAVIAlertInput, UpsertResult } from "@artu-ai/shared";
+import type { AVIAlertFilter, AVIAlertSort, AVIAlertItemFilter, AlertSort, AlertItemFilter, AlertItemSort } from "@artu-ai/shared";
+import { MexAlertsResource } from "../../alerts";
+import { MexAVIAlert, MexAVIAlertItem, type AlertData, type AlertItemData } from "../../../../models";
+/**
+ * AVI (Activos Virtuales) scoped alerts resource.
+ *
+ * @example
+ * ```typescript
+ * const aviSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.AVI,
+ * });
+ *
+ * // Create with fully flattened input
+ * const alert = await aviSdk.alerts.create({
+ *   mesReportado: "202401",
+ * });
+ *
+ * // Returns MexAVIAlert
+ * console.log(alert.mesReportado);
+ * ```
+ */
+export declare class AVIAlertsResource extends MexAlertsResource<AVIAlertSort, AviAlertDefaultsInput> {
+    create(data: CreateAVIAlertInput): Promise<MexAVIAlert>;
+    retrieve(id: string): Promise<MexAVIAlert>;
+    retrieveByMetadata(key: string, value: string): Promise<MexAVIAlert>;
+    retrieveByExternalId(externalId: string): Promise<MexAVIAlert>;
+    update(id: string, data: UpdateAVIAlertInput): Promise<MexAVIAlert>;
+    /**
+     * Lists AVI alerts with optional filtering.
+     *
+     * Accepts flattened AVI filter (future AVI-specific alert fields at root level).
+     */
+    list(options?: ListOptions<AVIAlertFilter, AVIAlertSort>): Promise<PaginatedResponse<MexAVIAlert>>;
+    /**
+     * Iterates over AVI alerts.
+     *
+     * Accepts flattened AVI filter (future AVI-specific alert fields at root level).
+     */
+    iterate(options?: {
+        filter?: AVIAlertFilter;
+        sort?: AVIAlertSort;
+        pageSize?: number;
+    }): AsyncGenerator<MexAVIAlert, void, undefined>;
+    /**
+     * Counts AVI alerts matching the given filter.
+     *
+     * @param filter - Optional filter criteria (with AVI fields at root level)
+     * @returns The count of matching alerts
+     */
+    count(filter?: AVIAlertFilter): Promise<number>;
+    createMany(alerts: CreateAVIAlertInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAVIAlert>>;
+    createMany(alerts: CreateAVIAlertInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAVIAlert>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateAVIAlertInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAVIAlert>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateAVIAlertInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAVIAlert>>;
+    /**
+     * Creates or updates an AVI alert by externalId.
+     *
+     * @param data - Alert upsert data with AVI fields at root level (must include externalId)
+     * @returns The created or updated alert with action indicator
+     */
+    upsertByExternalId(data: UpsertAVIAlertInput): Promise<UpsertResult<MexAVIAlert>>;
+    /**
+     * Creates or updates multiple AVI 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: UpsertAVIAlertInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<UpsertResult<MexAVIAlert>>>;
+    upsertManyByExternalId(alerts: UpsertAVIAlertInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<UpsertResult<MexAVIAlert>>>;
+    addItem(alertId: string, data: CreateAVIAlertItemInput): Promise<MexAVIAlertItem>;
+    getItem(alertId: string, itemId: string): Promise<MexAVIAlertItem>;
+    updateItem(alertId: string, itemId: string, data: UpdateAVIAlertItemInput): Promise<MexAVIAlertItem>;
+    listItems(alertId: string, options?: ListOptions<AVIAlertItemFilter, AlertItemSort>): Promise<PaginatedResponse<MexAVIAlertItem>>;
+    /**
+     * Transforms a flattened AVIAlertItemFilter to nested AlertItemFilter format.
+     */
+    protected applyScopeToItemFilter(filter?: AVIAlertItemFilter): AlertItemFilter | undefined;
+    addItems(alertId: string, items: CreateAVIAlertItemInput[]): Promise<{
+        added: number;
+        items: MexAVIAlertItem[];
+    }>;
+    /**
+     * Validates an AVI alert.
+     *
+     * Uses AVI-scoped validation input (jurisdiction and activity are implicit).
+     *
+     * @param alertId - The alert ID to validate
+     * @param defaults - AVI alert defaults including rfc, platformDomain, alertType, etc.
+     *
+     * @example
+     * ```typescript
+     * const result = await aviSdk.alerts.validateAlert(alert.id, {
+     *   rfc: "ABC200101XXX",
+     *   platformDomain: "https://example.com",
+     *   alertType: "100",
+     * });
+     * ```
+     */
+    validateAlert(alertId: string, defaults: AviAlertDefaultsInput): Promise<ValidationResult>;
+    /**
+     * Generates XML for an AVI alert.
+     *
+     * Uses the same input as validateAlert.
+     *
+     * @param alertId - The alert ID to generate XML for
+     * @param defaults - AVI alert defaults including rfc, platformDomain, alertType, etc.
+     *
+     * @example
+     * ```typescript
+     * const result = await aviSdk.alerts.generateAlert(alert.id, {
+     *   rfc: "ABC200101XXX",
+     *   platformDomain: "https://example.com",
+     *   alertType: "100",
+     * });
+     * console.log(result.xml);
+     * ```
+     */
+    generateAlert(alertId: string, defaults: AviAlertDefaultsInput): Promise<GenerateResult>;
+    /**
+     * Submits a validated AVI alert.
+     *
+     * Uses AVI-scoped submission input (activity is implicit).
+     *
+     * @example
+     * ```typescript
+     * const result = await aviSdk.alerts.submit({
+     *   alertId: alert.id,
+     *   acuseRecibo: "SAT-12345",
+     *   notes: "Submitted via portal",
+     * });
+     * ```
+     */
+    submit(input: SubmitAVIAlertInput): Promise<SubmissionResult>;
+    /**
+     * Transforms a flattened AVIAlertSort to nested AlertSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    protected applyScopeToSort(sort?: AVIAlertSort): AlertSort | undefined;
+    protected transformToNested(data: CreateAVIAlertInput): CreateAlertInput;
+    /**
+     * Transforms AVI update input to nested API format.
+     *
+     * NOTE: Always includes `actividadVulnerable: { AVI: {} }` even if no
+     * AVI-specific fields are provided. This ensures that records touched via
+     * the AVI SDK can be filtered by `activityCodes: { in: ["AVI"] }`.
+     */
+    protected transformUpdateToNested(data: UpdateAVIAlertInput): UpdateAlertInput;
+    protected instantiate(data: AlertData): MexAVIAlert;
+    protected instantiateItem(data: AlertItemData): MexAVIAlertItem;
+    protected transformItemToNested(data: CreateAVIAlertItemInput): CreateAlertItemInput;
+    protected transformItemUpdateToNested(data: UpdateAVIAlertItemInput): UpdateAlertItemInput;
+    /**
+     * Transforms AVI defaults to nested API format for validate/generate.
+     */
+    protected transformAviDefaultsToNested(alertId: string, defaults: AviAlertDefaultsInput): {
+        alertId: string;
+        jurisdictions: unknown;
+    };
+}
+//# sourceMappingURL=alerts.d.ts.map