@artu-ai/compliance-sdk 0.0.5 → 0.2.0

package/dist/resources/mex/actividad-vulnerable/avi/clients.js

@@ -0,0 +1,304 @@
+/**
+ * AVI (Activos Virtuales) Clients Resource
+ *
+ * Extends MexClientsResource with AVI-specific behavior:
+ * - Accepts flattened CreateAVIClientInput (AVI fields at root level)
+ * - Returns MexAVIClient models
+ */
+import { z } from "zod";
+import { CodigoActividad, createAVIClientInputSchema, updateAVIClientInputSchema, linkedClientSchema, } from "@artu-ai/shared";
+import { MexClientsResource } from "../../clients";
+import { MexAVIClient, } from "../../../../models";
+// ===========================
+// AVIClientsResource
+// ===========================
+/**
+ * AVI (Activos Virtuales) scoped clients resource.
+ *
+ * Provides the same operations as MexClientsResource but with:
+ * - Flattened input types (AVI fields at root level)
+ * - MexAVIClient model return type
+ *
+ * @example
+ * ```typescript
+ * const aviSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.AVI,
+ * });
+ *
+ * // Create with fully flattened input
+ * const client = await aviSdk.clients.create({
+ *   type: ClientType.Person,
+ *   name: "Juan García",
+ *   rfc: "GAJL850101ABC",   // MX field
+ *   username: "JGARCIA",     // AVI field at root!
+ * });
+ *
+ * // Returns MexAVIClient
+ * console.log(client.username);
+ * ```
+ */
+export class AVIClientsResource extends MexClientsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new AVI client with fully flattened input.
+     */
+    async create(data) {
+        const validated = this.validate(createAVIClientInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.clients.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a client by ID.
+     */
+    async retrieve(id, include) {
+        const response = await this.execute(() => this.trpc.clients.retrieve.query({ id, include }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves an AVI client by externalId.
+     */
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.clients.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates an AVI client with flattened input.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateAVIClientInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.clients.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists AVI clients with optional filtering.
+     *
+     * Accepts fully flattened AVI filter (MX and AVI fields at root level)
+     * and automatically transforms to nested format before calling the API.
+     *
+     * @example
+     * ```typescript
+     * const { data } = await aviSdk.clients.list({
+     *   filter: {
+     *     name: { contains: "García" },
+     *     rfc: { startsWith: "GAJL" },  // MX field at root
+     *     username: { contains: "jgarcia" },  // AVI field at root!
+     *   },
+     * });
+     * ```
+     */
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const response = await this.execute(() => this.trpc.clients.list.query({
+            ...options,
+            filter: scopedFilter,
+        }));
+        return {
+            data: response.data.map((c) => this.instantiate(c)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over AVI clients.
+     *
+     * Accepts fully flattened AVI filter (MX and AVI fields at root level)
+     * and automatically transforms to nested format before calling the API.
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    async createMany(clients, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createAVIClientInputSchema), clients);
+        const nestedClients = validated.map((c) => this.transformToNested(c));
+        const response = await this.execute(() => this.trpc.clients.createMany.mutate({ items: nestedClients, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((c) => this.instantiate(c)),
+            };
+        }
+        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: updateAVIClientInputSchema,
+        });
+        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.clients.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((c) => this.instantiate(c)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client-to-Client Relationship Management (scoped returns)
+    // ─────────────────────────────────────────────────────────────────
+    async linkClient(parentClientId, childClientId, relationshipType, metadata) {
+        const response = await this.execute(() => this.trpc.clients.linkClient.mutate({
+            parentClientId,
+            childClientId,
+            relationshipType,
+            metadata,
+        }));
+        return this.instantiate(response);
+    }
+    async unlinkClient(parentClientId, childClientId, relationshipType) {
+        const response = await this.execute(() => this.trpc.clients.unlinkClient.mutate({
+            parentClientId,
+            childClientId,
+            relationshipType,
+        }));
+        return this.instantiate(response);
+    }
+    async listLinkedClients(parentClientId, relationshipType) {
+        return super.listLinkedClients(parentClientId, relationshipType);
+    }
+    async setLinkedClients(parentClientId, linkedClients) {
+        const validated = this.validate(z.array(linkedClientSchema), linkedClients);
+        const response = await this.execute(() => this.trpc.clients.setLinkedClients.mutate({
+            parentClientId,
+            linkedClients: validated,
+        }));
+        return this.instantiate(response);
+    }
+    async syncAll(clientId, data, options) {
+        // Transform client input using AVI-specific transform
+        const transformedClient = data.client
+            ? this.transformUpdateToNested(data.client)
+            : undefined;
+        // Call parent syncAll with transformed client data
+        const result = await super.syncAll(clientId, {
+            ...data,
+            client: transformedClient,
+        }, options);
+        // Re-instantiate client with AVI-specific model
+        return {
+            ...result,
+            client: this.instantiate(result.client),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms a flattened AVIClientFilter to nested ClientFilter format
+     * and applies Mexico jurisdiction scoping.
+     *
+     * Extracts AVI-specific fields (username) from root level and nests them
+     * under jurisdictions.MX.actividadVulnerable.AVI.
+     */
+    applyScopeToFilter(filter) {
+        if (!filter) {
+            return super.applyScopeToFilter(undefined);
+        }
+        // Extract AVI-specific filter fields
+        const { username, ...mexFilter } = filter;
+        // Let parent handle MX fields
+        const nestedFilter = super.applyScopeToFilter(mexFilter);
+        // Only add AVI activity filter if username is provided
+        if (username !== undefined) {
+            const mexJurisdiction = (nestedFilter.jurisdictions?.MX ?? {});
+            return {
+                ...nestedFilter,
+                jurisdictions: {
+                    ...nestedFilter.jurisdictions,
+                    MX: {
+                        ...mexJurisdiction,
+                        actividadVulnerable: {
+                            [CodigoActividad.AVI]: { username },
+                        },
+                    },
+                },
+            };
+        }
+        return nestedFilter;
+    }
+    /**
+     * Transforms flattened AVI input to nested API format.
+     */
+    transformToNested(data) {
+        // Extract AVI-specific field first
+        const { username, ...restData } = data;
+        // Use parent for base + MX fields
+        const nested = super.transformToNested(restData);
+        // Add AVI activity data (parent always provides jurisdictions.MX)
+        const mexData = nested.jurisdictions?.MX;
+        return {
+            ...nested,
+            jurisdictions: {
+                MX: {
+                    ...mexData,
+                    actividadVulnerable: {
+                        [CodigoActividad.AVI]: { username },
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Transforms flattened AVI update input to nested API format.
+     */
+    transformUpdateToNested(data) {
+        // Extract AVI-specific field first
+        const { username, ...restData } = data;
+        // Use parent for base + MX fields
+        const nested = super.transformUpdateToNested(restData);
+        // Only add AVI data if username is provided
+        if (username !== undefined) {
+            const mexData = (nested.jurisdictions?.MX ??
+                {});
+            mexData.actividadVulnerable = {
+                [CodigoActividad.AVI]: { username },
+            };
+            return {
+                ...nested,
+                jurisdictions: { MX: mexData },
+            };
+        }
+        return nested;
+    }
+    /**
+     * Instantiates a MexAVIClient model.
+     */
+    instantiate(data) {
+        return new MexAVIClient(data);
+    }
+}

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

@@ -0,0 +1,7 @@
+/**
+ * AVI (Activos Virtuales) Scoped Resources
+ */
+export { AVIClientsResource } from "./clients";
+export { AVITransactionsResource } from "./transactions";
+export { AVIReportsResource } from "./reports";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * AVI (Activos Virtuales) Scoped Resources
+ */
+export { AVIClientsResource } from "./clients";
+export { AVITransactionsResource } from "./transactions";
+export { AVIReportsResource } from "./reports";

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

@@ -0,0 +1,134 @@
+/**
+ * AVI (Activos Virtuales) Reports Resource
+ *
+ * Extends MexReportsResource with AVI-specific behavior:
+ * - Accepts flattened CreateAVIReportInput (AVI fields at root level)
+ * - Returns MexAVIReport models
+ */
+import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateAVIReportInput, UpdateAVIReportInput, CreateAVIReportItemInput, UpdateAVIReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, ValidationResult, GenerateResult, SubmissionResult, MexAVIValidateInput, SubmitAVIReportInput } from "@artu-ai/shared";
+import type { AVIReportFilter } from "@artu-ai/shared";
+import { MexReportsResource } from "../../reports";
+import { type ReportItemFilter } from "../../../reports";
+import { MexAVIReport, MexAVIReportItem, type ReportData, type ReportItemData } from "../../../../models";
+/**
+ * AVI (Activos Virtuales) scoped reports resource.
+ *
+ * @example
+ * ```typescript
+ * const aviSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.AVI,
+ * });
+ *
+ * // Create with fully flattened input
+ * const report = await aviSdk.reports.create({
+ *   mesReportado: "202401",
+ * });
+ *
+ * // Returns MexAVIReport
+ * console.log(report.mesReportado);
+ * ```
+ */
+export declare class AVIReportsResource extends MexReportsResource {
+    create(data: CreateAVIReportInput): Promise<MexAVIReport>;
+    retrieve(id: string): Promise<MexAVIReport>;
+    retrieveByMetadata(key: string, value: string): Promise<MexAVIReport>;
+    retrieveByExternalId(externalId: string): Promise<MexAVIReport>;
+    update(id: string, data: UpdateAVIReportInput): Promise<MexAVIReport>;
+    /**
+     * Lists AVI reports with optional filtering.
+     *
+     * Accepts flattened AVI filter (future AVI-specific report fields at root level).
+     */
+    list(options?: ListOptions<AVIReportFilter>): Promise<PaginatedResponse<MexAVIReport>>;
+    /**
+     * Iterates over AVI reports.
+     *
+     * Accepts flattened AVI filter (future AVI-specific report fields at root level).
+     */
+    iterate(filter?: AVIReportFilter): AsyncGenerator<MexAVIReport, void, undefined>;
+    createMany(reports: CreateAVIReportInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAVIReport>>;
+    createMany(reports: CreateAVIReportInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAVIReport>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateAVIReportInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexAVIReport>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateAVIReportInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexAVIReport>>;
+    addItem(reportId: string, data: CreateAVIReportItemInput): Promise<MexAVIReportItem>;
+    getItem(reportId: string, itemId: string): Promise<MexAVIReportItem>;
+    updateItem(reportId: string, itemId: string, data: UpdateAVIReportItemInput): Promise<MexAVIReportItem>;
+    listItems(reportId: string, options?: ListOptions<ReportItemFilter>): Promise<PaginatedResponse<MexAVIReportItem>>;
+    addItems(reportId: string, items: CreateAVIReportItemInput[]): Promise<{
+        added: number;
+        items: MexAVIReportItem[];
+    }>;
+    /**
+     * Validates an AVI report.
+     *
+     * Uses AVI-scoped validation input (jurisdiction and activity default automatically).
+     *
+     * @example
+     * ```typescript
+     * const result = await aviSdk.reports.validateReport({
+     *   reportId: report.id,
+     *   defaults: {
+     *     rfc: "ABC200101XXX",
+     *     platformDomain: "https://example.com",
+     *   },
+     * });
+     * ```
+     */
+    validateReport(input: MexAVIValidateInput): Promise<ValidationResult>;
+    /**
+     * Generates XML for an AVI report.
+     *
+     * Uses the same input as validateReport.
+     *
+     * @example
+     * ```typescript
+     * const result = await aviSdk.reports.generateReport({
+     *   reportId: report.id,
+     *   defaults: {
+     *     rfc: "ABC200101XXX",
+     *     platformDomain: "https://example.com",
+     *   },
+     * });
+     * console.log(result.xml);
+     * ```
+     */
+    generateReport(input: MexAVIValidateInput): Promise<GenerateResult>;
+    /**
+     * Submits a validated AVI report.
+     *
+     * Uses AVI-scoped submission input (activity is implicit).
+     *
+     * @example
+     * ```typescript
+     * const result = await aviSdk.reports.submit({
+     *   reportId: report.id,
+     *   acuseRecibo: "SAT-12345",
+     *   notes: "Submitted via portal",
+     * });
+     * ```
+     */
+    submit(input: SubmitAVIReportInput): Promise<SubmissionResult>;
+    protected transformToNested(data: CreateAVIReportInput): CreateReportInput;
+    protected transformUpdateToNested(data: UpdateAVIReportInput): UpdateReportInput;
+    protected instantiate(data: ReportData): MexAVIReport;
+    protected instantiateItem(data: ReportItemData): MexAVIReportItem;
+    protected transformItemToNested(data: CreateAVIReportItemInput): CreateReportItemInput;
+    protected transformItemUpdateToNested(data: UpdateAVIReportItemInput): UpdateReportItemInput;
+}
+//# sourceMappingURL=reports.d.ts.map

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

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