@artu-ai/compliance-sdk 0.13.4 → 0.17.0

package/dist/resources/mx/av/inm/transactions.d.ts

@@ -0,0 +1,107 @@
+/**
+ * INM (Inmuebles - Real Estate Sale/Purchase) Transactions Resource
+ *
+ * Extends MexTransactionsResource with INM-specific behavior:
+ * - Accepts flattened CreateINMTransactionInput (INM fields at root level)
+ * - Returns MexINMTransaction models
+ * - Handles inmuebles[] array, figuraCliente, figuraSO, contract, payments
+ */
+import type { AtomicBatchResult, CreateINMTransactionInput, CreateTransactionInput, INMTransactionFilter, INMTransactionSort, ListOptions, PaginatedResponse, PartialBatchResult, RelatedClient, TransactionSort, UpdateINMTransactionInput, UpdateTransactionInput, UpsertINMTransactionInput, UpsertResult } from "@artu-ai/shared";
+import { MexINMTransaction, type TransactionData } from "../../../../models";
+import { AVTransactionsResource } from "../transactions";
+/**
+ * INM (Inmuebles - Real Estate Sale/Purchase) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const inmSdk = new ComplianceSDK({
+ *   apiKey,
+ *   scope: "MX:AV:INM",
+ * });
+ *
+ * const txn = await inmSdk.transactions.create({
+ *   amount: 5000000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "501",
+ *   figuraCliente: "1",
+ *   figuraSO: "1",
+ *   inmuebles: [
+ *     {
+ *       type: "1",
+ *       value: "5000000",
+ *       colonia: "Roma Norte",
+ *       calle: "Álvaro Obregón",
+ *       numeroExterior: "100",
+ *       postalCode: "06700",
+ *     },
+ *   ],
+ *   contract: { type: "1", notaryNumber: "42", notaryState: "09" },
+ *   payments: [
+ *     { paymentDate: "2024-01-01", paymentForm: "1", monetaryInstrument: "1", currency: "MXN", amount: 5000000 }
+ *   ],
+ *   relatedClientIds: [client.id],
+ * });
+ * ```
+ */
+export declare class INMTransactionsResource extends AVTransactionsResource {
+    protected static readonly SCOPE_PATH: string[];
+    create(data: CreateINMTransactionInput): Promise<MexINMTransaction>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexINMTransaction>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexINMTransaction>;
+    update(id: string, data: UpdateINMTransactionInput): Promise<MexINMTransaction>;
+    list(options?: ListOptions<INMTransactionFilter, INMTransactionSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexINMTransaction>>;
+    iterate(options?: {
+        filter?: INMTransactionFilter;
+        sort?: INMTransactionSort;
+        pageSize?: number;
+        crossScope?: boolean;
+    }): AsyncGenerator<MexINMTransaction, void, undefined>;
+    count(filter?: INMTransactionFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<MexINMTransaction>>;
+    linkClient(transactionId: string, clientId: string, role?: import("@artu-ai/shared").ClientRole): Promise<MexINMTransaction>;
+    unlinkClient(transactionId: string, clientId: string): Promise<MexINMTransaction>;
+    setClients(transactionId: string, clients: RelatedClient[]): Promise<MexINMTransaction>;
+    createMany(transactions: CreateINMTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexINMTransaction>>;
+    createMany(transactions: CreateINMTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexINMTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateINMTransactionInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexINMTransaction>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateINMTransactionInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexINMTransaction>>;
+    upsertByExternalId(data: UpsertINMTransactionInput): Promise<UpsertResult<MexINMTransaction>>;
+    upsertManyByExternalId(transactions: UpsertINMTransactionInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<UpsertResult<MexINMTransaction>>>;
+    upsertManyByExternalId(transactions: UpsertINMTransactionInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<UpsertResult<MexINMTransaction>>>;
+    protected transformToNested(data: CreateINMTransactionInput): CreateTransactionInput;
+    protected transformUpdateToNested(data: UpdateINMTransactionInput): UpdateTransactionInput;
+    protected instantiate(data: TransactionData): MexINMTransaction;
+    /** Materializes a raw payload into a {@link MexINMTransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data: TransactionData): MexINMTransaction;
+    protected applyScopeToSort(sort?: INMTransactionSort): TransactionSort | undefined;
+}

package/dist/resources/mx/av/inm/transactions.js

@@ -0,0 +1,291 @@
+/**
+ * INM (Inmuebles - Real Estate Sale/Purchase) Transactions Resource
+ *
+ * Extends MexTransactionsResource with INM-specific behavior:
+ * - Accepts flattened CreateINMTransactionInput (INM fields at root level)
+ * - Returns MexINMTransaction models
+ * - Handles inmuebles[] array, figuraCliente, figuraSO, contract, payments
+ */
+import { CodigoActividad, createINMTransactionInputSchema, inmTransactionSortingFieldMapping, transformSort, updateINMTransactionInputSchema, upsertINMTransactionInputSchema, } from "@artu-ai/shared";
+import { z } from "zod";
+import { MexINMTransaction } from "../../../../models";
+import { splitTransactionCreateFields, splitTransactionUpdateFields, } from "../../update-split";
+import { AVTransactionsResource } from "../transactions";
+// ===========================
+// INMTransactionsResource
+// ===========================
+/**
+ * INM (Inmuebles - Real Estate Sale/Purchase) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const inmSdk = new ComplianceSDK({
+ *   apiKey,
+ *   scope: "MX:AV:INM",
+ * });
+ *
+ * const txn = await inmSdk.transactions.create({
+ *   amount: 5000000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "501",
+ *   figuraCliente: "1",
+ *   figuraSO: "1",
+ *   inmuebles: [
+ *     {
+ *       type: "1",
+ *       value: "5000000",
+ *       colonia: "Roma Norte",
+ *       calle: "Álvaro Obregón",
+ *       numeroExterior: "100",
+ *       postalCode: "06700",
+ *     },
+ *   ],
+ *   contract: { type: "1", notaryNumber: "42", notaryState: "09" },
+ *   payments: [
+ *     { paymentDate: "2024-01-01", paymentForm: "1", monetaryInstrument: "1", currency: "MXN", amount: 5000000 }
+ *   ],
+ *   relatedClientIds: [client.id],
+ * });
+ * ```
+ */
+export class INMTransactionsResource extends AVTransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    static SCOPE_PATH = [
+        "MX",
+        "actividadVulnerable",
+        CodigoActividad.INM,
+    ];
+    async create(data) {
+        const merged = await this.mergeProductDataFlat(data, INMTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(createINMTransactionInputSchema, merged);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({
+            id,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value, opts) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({
+            key,
+            value,
+            requireScope: this.buildRequireScope(opts?.crossScope),
+        }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const merged = await this.mergeProductDataFlat(data, INMTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(updateINMTransactionInputSchema, merged);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    async list(options) {
+        const { crossScope, ...rest } = options ?? {};
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(rest.filter), crossScope);
+        const scopedSort = this.applyScopeToSort(rest.sort);
+        const response = await this.execute(() => this.trpc.transactions.list.query({
+            ...rest,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    iterate(options) {
+        // Do NOT apply scope here — createIterator calls this.list(), which
+        // applies the flatten transform AND auto-scope exactly once.
+        return this.createIterator({
+            filter: options?.filter,
+            sort: options?.sort,
+            pageSize: options?.pageSize,
+            crossScope: options?.crossScope,
+        });
+    }
+    async count(filter, options) {
+        const scopedFilter = this.applyAutoScope(this.applyScopeToFilter(filter), options?.crossScope);
+        const response = await this.execute(() => this.trpc.transactions.count.query({ filter: scopedFilter }));
+        return response.count;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationship Management
+    // ─────────────────────────────────────────────────────────────────
+    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 merged = await this.mergeProductDataFlatBatch(transactions, INMTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(z.array(createINMTransactionInputSchema), merged);
+        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: updateINMTransactionInputSchema,
+        });
+        const mergedData = await this.mergeProductDataFlatBatch(updates.map((u) => u.data), INMTransactionsResource.SCOPE_PATH);
+        const mergedUpdates = updates.map((u, i) => ({
+            id: u.id,
+            data: mergedData[i],
+        }));
+        const validated = this.validate(z.array(updateItemSchema), mergedUpdates);
+        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
+    // ─────────────────────────────────────────────────────────────────
+    async upsertByExternalId(data) {
+        const merged = await this.mergeProductDataFlat(data, INMTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(upsertINMTransactionInputSchema, merged);
+        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 merged = await this.mergeProductDataFlatBatch(transactions, INMTransactionsResource.SCOPE_PATH);
+        const validated = this.validate(z.array(upsertINMTransactionInputSchema), merged);
+        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 { base, scopeData } = splitTransactionCreateFields(data, INMTransactionsResource.SCOPE_PATH);
+        return {
+            ...base,
+            scopes: ["MX", "MX:AV", "MX:AV:INM"],
+            scopeData,
+        };
+    }
+    transformUpdateToNested(data) {
+        const { base, scopeData } = splitTransactionUpdateFields(data, INMTransactionsResource.SCOPE_PATH);
+        return {
+            ...base,
+            scopes: ["MX", "MX:AV", "MX:AV:INM"],
+            scopeData,
+        };
+    }
+    instantiate(data) {
+        return new MexINMTransaction(data);
+    }
+    /** Materializes a raw payload into a {@link MexINMTransaction} (return type narrowed via the `instantiate` override). */
+    materialize(data) {
+        return this.instantiate(data);
+    }
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, inmTransactionSortingFieldMapping);
+    }
+}

package/dist/resources/mx/av/jys/alerts.d.ts

@@ -17,7 +17,7 @@ import { AVAlertsResource } from "../alerts";
  * ```typescript
  * const jysSdk = new ComplianceSDK({
  *   apiKey,
- *   jurisdiction: Jurisdiction.Mexico,
+ *   scope: "MX",
  *   actividadVulnerable: CodigoActividad.JYS,
  * });
  *
@@ -32,16 +32,24 @@ import { AVAlertsResource } from "../alerts";
  */
 export declare class JYSAlertsResource extends AVAlertsResource {
     create(data: CreateJYSAlertInput): Promise<MexJYSAlert>;
-    retrieve(id: string): Promise<MexJYSAlert>;
-    retrieveByMetadata(key: string, value: string): Promise<MexJYSAlert>;
-    retrieveByExternalId(externalId: string): Promise<MexJYSAlert>;
+    retrieve(id: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexJYSAlert>;
+    retrieveByMetadata(key: string, value: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexJYSAlert>;
+    retrieveByExternalId(externalId: string, opts?: {
+        crossScope?: boolean;
+    }): Promise<MexJYSAlert>;
     update(id: string, data: UpdateJYSAlertInput): Promise<MexJYSAlert>;
     /**
      * Lists JYS alerts with optional filtering.
      *
      * Accepts flattened JYS filter (future JYS-specific alert fields at root level).
      */
-    list(options?: ListOptions<JYSAlertFilter, JYSAlertSort>): Promise<PaginatedResponse<MexJYSAlert>>;
+    list(options?: ListOptions<JYSAlertFilter, JYSAlertSort> & {
+        crossScope?: boolean;
+    }): Promise<PaginatedResponse<MexJYSAlert>>;
     /**
      * Iterates over JYS alerts.
      *
@@ -51,6 +59,7 @@ export declare class JYSAlertsResource extends AVAlertsResource {
         filter?: JYSAlertFilter;
         sort?: JYSAlertSort;
         pageSize?: number;
+        crossScope?: boolean;
     }): AsyncGenerator<MexJYSAlert, void, undefined>;
     /**
      * Counts JYS alerts matching the given filter.
@@ -58,7 +67,9 @@ export declare class JYSAlertsResource extends AVAlertsResource {
      * @param filter - Optional filter criteria (with JYS fields at root level)
      * @returns The count of matching alerts
      */
-    count(filter?: JYSAlertFilter): Promise<number>;
+    count(filter?: JYSAlertFilter, options?: {
+        crossScope?: boolean;
+    }): Promise<number>;
     createMany(alerts: CreateJYSAlertInput[], options?: {
         atomic?: true;
     }): Promise<AtomicBatchResult<MexJYSAlert>>;
@@ -204,6 +215,13 @@ export declare class JYSAlertsResource extends AVAlertsResource {
                     nin?: ("100" | "9999" | "4101" | "4102" | "4103" | "4104" | "4105" | "4106" | "4107" | "4108" | "4109" | "4110" | "4111" | "4112" | "4113" | "4114" | "4115" | "4116" | "4117" | "4118" | "4119" | "4120" | "4121" | "4122")[] | undefined;
                 } | undefined;
             } | undefined;
+            INM?: {
+                alertType?: "100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120" | {
+                    eq?: "100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120" | undefined;
+                    in?: ("100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120")[] | undefined;
+                    nin?: ("100" | "9999" | "3101" | "3102" | "3103" | "3104" | "3105" | "3106" | "3107" | "3108" | "3109" | "3110" | "3111" | "3112" | "3113" | "3114" | "3115" | "3116" | "3117" | "3118" | "3119" | "3120")[] | undefined;
+                } | undefined;
+            } | undefined;
             JYS?: {
                 alertType?: "100" | "9999" | "2101" | "2102" | "2103" | "2104" | "2105" | "2106" | "2107" | "2108" | "2109" | "2110" | "2111" | "2112" | "2113" | "2114" | "2115" | "2116" | "2117" | "2118" | "2119" | "2120" | "2121" | "2122" | "2123" | "2124" | "2125" | "2126" | "2127" | {
                     eq?: "100" | "9999" | "2101" | "2102" | "2103" | "2104" | "2105" | "2106" | "2107" | "2108" | "2109" | "2110" | "2111" | "2112" | "2113" | "2114" | "2115" | "2116" | "2117" | "2118" | "2119" | "2120" | "2121" | "2122" | "2123" | "2124" | "2125" | "2126" | "2127" | undefined;
@@ -218,6 +236,13 @@ export declare class JYSAlertsResource extends AVAlertsResource {
                     nin?: ("100" | "9999" | "2901" | "2902" | "2903" | "2904" | "2905" | "2906" | "2907" | "2908" | "2909" | "2910" | "2911" | "2912" | "2913" | "2914" | "2915" | "2916" | "2917" | "2918" | "2919" | "2920" | "2921" | "2922" | "2923" | "2924" | "2925")[] | undefined;
                 } | undefined;
             } | undefined;
+            MPC?: {
+                alertType?: "100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814" | {
+                    eq?: "100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814" | undefined;
+                    in?: ("100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814")[] | undefined;
+                    nin?: ("100" | "9999" | "2801" | "2802" | "2803" | "2804" | "2805" | "2806" | "2807" | "2808" | "2809" | "2810" | "2811" | "2812" | "2813" | "2814")[] | undefined;
+                } | undefined;
+            } | undefined;
             TSC?: {
                 alertType?: "100" | "9999" | "2201" | "2202" | "2203" | "2204" | "2205" | "2206" | "2207" | "2208" | "2209" | "2210" | "2211" | "2212" | "2213" | "2214" | "2215" | "2216" | {
                     eq?: "100" | "9999" | "2201" | "2202" | "2203" | "2204" | "2205" | "2206" | "2207" | "2208" | "2209" | "2210" | "2211" | "2212" | "2213" | "2214" | "2215" | "2216" | undefined;
@@ -225,6 +250,13 @@ export declare class JYSAlertsResource extends AVAlertsResource {
                     nin?: ("100" | "9999" | "2201" | "2202" | "2203" | "2204" | "2205" | "2206" | "2207" | "2208" | "2209" | "2210" | "2211" | "2212" | "2213" | "2214" | "2215" | "2216")[] | undefined;
                 } | undefined;
             } | undefined;
+            VEH?: {
+                alertType?: "100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521" | {
+                    eq?: "100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521" | undefined;
+                    in?: ("100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521")[] | undefined;
+                    nin?: ("100" | "9999" | "2501" | "2502" | "2503" | "2504" | "2505" | "2506" | "2507" | "2508" | "2509" | "2510" | "2511" | "2512" | "2513" | "2514" | "2515" | "2516" | "2517" | "2518" | "2519" | "2520" | "2521")[] | undefined;
+                } | undefined;
+            } | undefined;
             alertDescription?: string | {
                 eq?: string | undefined;
                 contains?: string | undefined;
@@ -254,7 +286,7 @@ export declare class JYSAlertsResource extends AVAlertsResource {
     /**
      * Validates a JYS alert.
      *
-     * Uses JYS-scoped validation input (jurisdiction and activity are implicit).
+     * Uses JYS-scoped validation input (scope and activity are implicit).
      *
      * @param alertId - The alert ID to validate
      * @param defaults - JYS alert defaults including rfc, alertType, etc.
@@ -301,6 +333,8 @@ export declare class JYSAlertsResource extends AVAlertsResource {
      */
     protected transformUpdateToNested(data: UpdateJYSAlertInput): UpdateAlertInput;
     protected instantiate(data: AlertData): MexJYSAlert;
+    /** Materializes a raw payload into a {@link MexJYSAlert} (return type narrowed via the `instantiate` override). */
+    materialize(data: AlertData): MexJYSAlert;
     protected instantiateItem(data: AlertItemData): MexJYSAlertItem;
     protected instantiateTransactionItem(data: AlertTransactionItemData): MexJYSAlertTransactionItem;
     protected instantiateClientItem(data: AlertClientItemData): MexJYSAlertClientItem;
@@ -315,4 +349,3 @@ export declare class JYSAlertsResource extends AVAlertsResource {
         defaults?: unknown;
     };
 }
-//# sourceMappingURL=alerts.d.ts.map