@artu-ai/compliance-sdk 0.0.6 → 0.3.0

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

@@ -0,0 +1,226 @@
+/**
+ * Mexico Reports Resource
+ *
+ * Extends ReportsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexReportInput (MX fields at root level)
+ * - Filters list/iterate to Mexico reports only
+ * - Returns MexReport models
+ */
+import type { CreateReportInput, UpdateReportInput, CreateReportItemInput, UpdateReportItemInput, CreateMexReportInput, UpdateMexReportInput, CreateMexReportItemInput, UpdateMexReportItemInput, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, MexSubmitReportInput, ValidationResult, GenerateResult, SubmissionResult, MexReportDefaultsInput, ReportDefaultsInput } from "@artu-ai/shared";
+import type { ReportFilter, ReportSort, MexReportFilter, MexReportSort } from "@artu-ai/shared";
+import { ReportsResource, type ReportItemFilter, type ReportItemSort } from "../reports";
+import { MexReport, type ReportData, type ReportItemData } from "../../models";
+import { MexReportItem } from "../../models/mex";
+/**
+ * Mexico-scoped reports resource.
+ *
+ * Provides the same operations as ReportsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexReport model return type
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const report = await mexSdk.reports.create({
+ *   actividadVulnerable: {
+ *     AVI: { mesReportado: "202401" },
+ *   },
+ * });
+ *
+ * // List returns only Mexico reports
+ * const { data } = await mexSdk.reports.list();
+ * // data is MexReport[]
+ * ```
+ */
+export declare class MexReportsResource<TSort = MexReportSort, TDefaults = MexReportDefaultsInput> extends ReportsResource<TSort, TDefaults> {
+    /**
+     * Creates a new Mexico report with flattened input.
+     */
+    create(data: CreateMexReportInput): Promise<MexReport>;
+    /**
+     * Retrieves a report by ID.
+     */
+    retrieve(id: string): Promise<MexReport>;
+    retrieveByMetadata(key: string, value: string): Promise<MexReport>;
+    retrieveByExternalId(externalId: string): Promise<MexReport>;
+    /**
+     * Updates a Mexico report with flattened input.
+     */
+    update(id: string, data: UpdateMexReportInput): Promise<MexReport>;
+    /**
+     * Lists Mexico reports with optional filtering.
+     *
+     * Accepts flattened MX filter (future MX-specific report fields at root level).
+     * Automatically filters to reports with Mexico jurisdiction data.
+     */
+    list(options?: ListOptions<MexReportFilter, TSort>): Promise<PaginatedResponse<MexReport>>;
+    /**
+     * Iterates over Mexico reports.
+     *
+     * Accepts flattened MX filter (future MX-specific report fields at root level).
+     * Automatically filters to reports with Mexico jurisdiction data.
+     */
+    iterate(filter?: MexReportFilter): AsyncGenerator<MexReport, void, undefined>;
+    createMany(reports: CreateMexReportInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexReport>>;
+    createMany(reports: CreateMexReportInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexReport>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexReportInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexReport>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateMexReportInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexReport>>;
+    /**
+     * Adds an item to a report with flattened Mexico input.
+     */
+    addItem(reportId: string, data: CreateMexReportItemInput): Promise<MexReportItem>;
+    /**
+     * Gets a specific report item.
+     */
+    getItem(reportId: string, itemId: string): Promise<MexReportItem>;
+    /**
+     * Updates a report item with flattened Mexico input.
+     */
+    updateItem(reportId: string, itemId: string, data: UpdateMexReportItemInput): Promise<MexReportItem>;
+    /**
+     * Lists items in a report with filtering, sorting, and pagination.
+     */
+    listItems(reportId: string, options?: ListOptions<ReportItemFilter, ReportItemSort>): Promise<PaginatedResponse<MexReportItem>>;
+    /**
+     * Adds multiple items to a report with flattened Mexico input.
+     */
+    addItems(reportId: string, items: CreateMexReportItemInput[]): Promise<{
+        added: number;
+        items: MexReportItem[];
+    }>;
+    /**
+     * Validates a Mexico report.
+     *
+     * Uses Mexico-scoped validation input (jurisdiction is implicit).
+     *
+     * @param reportId - The report ID to validate
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.reports.validateReport(report.id, {
+     *   actividadVulnerable: {
+     *     rfc: "ABC200101XXX",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    validateReport(reportId: string, defaults: TDefaults): Promise<ValidationResult>;
+    /**
+     * Generates XML for a Mexico report.
+     *
+     * Uses the same input as validateReport since generation requires
+     * the same transformation and defaults.
+     *
+     * @param reportId - The report ID to generate XML for
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.reports.generateReport(report.id, {
+     *   actividadVulnerable: {
+     *     rfc: "ABC200101XXX",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
+     *   },
+     * });
+     * console.log(result.xml);
+     * ```
+     */
+    generateReport(reportId: string, defaults: TDefaults): Promise<GenerateResult>;
+    /**
+     * Submits a validated Mexico report.
+     *
+     * The report must be in "valid" status. After submission, the report
+     * is locked and cannot be edited (except rejected reports which can
+     * be edited and resubmitted).
+     *
+     * @param reportId - The report ID
+     * @param actividadVulnerable - The activity type (AVI, JYS, or TSC)
+     * @param data - Optional submission data (acuseRecibo, notes)
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.reports.submitReport(
+     *   report.id,
+     *   "AVI",
+     *   { acuseRecibo: "SAT-12345", notes: "Submitted via portal" }
+     * );
+     * ```
+     */
+    submit(input: MexSubmitReportInput): Promise<SubmissionResult>;
+    /**
+     * Applies Mexico jurisdiction filter.
+     *
+     * Currently MexReportFilter has the same fields as the base filter,
+     * but this method ensures the jurisdiction scope is applied.
+     * Uses `availableJurisdictions` to find any report that includes Mexico.
+     */
+    protected applyScopeToFilter(filter?: MexReportFilter): ReportFilter;
+    /**
+     * Transforms a flattened MexReportSort to nested ReportSort 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): ReportSort | undefined;
+    /**
+     * Transforms flattened MX input to nested API format.
+     */
+    protected transformToNested(data: CreateMexReportInput): CreateReportInput;
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    protected transformUpdateToNested(data: UpdateMexReportInput): UpdateReportInput;
+    /**
+     * Instantiates a MexReport model.
+     */
+    protected instantiate(data: ReportData): MexReport;
+    /**
+     * Instantiates a MexReportItem model.
+     */
+    protected instantiateItem(data: ReportItemData): MexReportItem;
+    /**
+     * Transforms flattened MX report item input to nested API format.
+     */
+    protected transformItemToNested(data: CreateMexReportItemInput): CreateReportItemInput;
+    /**
+     * Transforms flattened MX report item update input to nested API format.
+     */
+    protected transformItemUpdateToNested(data: UpdateMexReportItemInput): UpdateReportItemInput;
+    /**
+     * Transforms flattened MX validate/generate input to nested API format.
+     */
+    protected transformValidateToNested(reportId: string, defaults: MexReportDefaultsInput): {
+        reportId: string;
+    } & ReportDefaultsInput;
+}
+//# sourceMappingURL=reports.d.ts.map

package/dist/resources/mex/reports.d.ts.map

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

package/dist/resources/mex/reports.js

@@ -0,0 +1,440 @@
+/**
+ * Mexico Reports Resource
+ *
+ * Extends ReportsResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexReportInput (MX fields at root level)
+ * - Filters list/iterate to Mexico reports only
+ * - Returns MexReport models
+ */
+import { z } from "zod";
+import { Jurisdiction, createMexReportInputSchema, updateMexReportInputSchema, createMexReportItemInputSchema, updateMexReportItemInputSchema, mexSubmitReportInputSchema, transformSort, mexReportFieldMapping, mexReportDefaultsInputSchema, } from "@artu-ai/shared";
+import { ReportsResource, } from "../reports";
+import { MexReport } from "../../models";
+import { MexReportItem } from "../../models/mex";
+// ===========================
+// MexReportsResource
+// ===========================
+/**
+ * Mexico-scoped reports resource.
+ *
+ * Provides the same operations as ReportsResource but with:
+ * - Flattened input types (MX fields at root level)
+ * - Automatic jurisdiction scoping
+ * - MexReport model return type
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const report = await mexSdk.reports.create({
+ *   actividadVulnerable: {
+ *     AVI: { mesReportado: "202401" },
+ *   },
+ * });
+ *
+ * // List returns only Mexico reports
+ * const { data } = await mexSdk.reports.list();
+ * // data is MexReport[]
+ * ```
+ */
+export class MexReportsResource extends ReportsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // Report CRUD (override with flattened input types)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new Mexico report with flattened input.
+     */
+    async create(data) {
+        const validated = this.validate(createMexReportInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves a report by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.reports.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.reports.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates a Mexico report with flattened input.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateMexReportInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination (scoped to Mexico)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists Mexico reports with optional filtering.
+     *
+     * Accepts flattened MX filter (future MX-specific report fields at root level).
+     * Automatically filters to reports with Mexico jurisdiction data.
+     */
+    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({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((r) => this.instantiate(r)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over Mexico reports.
+     *
+     * Accepts flattened MX filter (future MX-specific report fields at root level).
+     * Automatically filters to reports with Mexico jurisdiction data.
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    async createMany(reports, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createMexReportInputSchema), reports);
+        const nestedItems = validated.map((r) => this.transformToNested(r));
+        const response = await this.execute(() => this.trpc.reports.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((r) => this.instantiate(r)),
+            };
+        }
+        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: updateMexReportInputSchema,
+        });
+        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 }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((r) => this.instantiate(r)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Report Items
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Adds an item to a report with flattened Mexico input.
+     */
+    async addItem(reportId, data) {
+        const validated = this.validate(createMexReportItemInputSchema, data);
+        const nestedData = this.transformItemToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.addItem.mutate({ reportId, data: nestedData }));
+        return this.instantiateItem(response);
+    }
+    /**
+     * Gets a specific report item.
+     */
+    async getItem(reportId, itemId) {
+        const response = await this.execute(() => this.trpc.reports.getItem.query({ reportId, itemId }));
+        return this.instantiateItem(response);
+    }
+    /**
+     * Updates a report item with flattened Mexico input.
+     */
+    async updateItem(reportId, itemId, data) {
+        const validated = this.validate(updateMexReportItemInputSchema, data);
+        const nestedData = this.transformItemUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.reports.updateItem.mutate({
+            reportId,
+            itemId,
+            data: nestedData,
+        }));
+        return this.instantiateItem(response);
+    }
+    /**
+     * Lists items in a report with filtering, sorting, and pagination.
+     */
+    async listItems(reportId, options) {
+        const response = await this.execute(() => this.trpc.reports.listItems.query({
+            reportId,
+            ...options,
+        }));
+        return {
+            data: response.data.map((i) => this.instantiateItem(i)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Adds multiple items to a report with flattened Mexico input.
+     */
+    async addItems(reportId, items) {
+        const validated = this.validate(z.array(createMexReportItemInputSchema), items);
+        const nestedItems = validated.map((i) => this.transformItemToNested(i));
+        const response = await this.execute(() => this.trpc.reports.addItems.mutate({ reportId, items: nestedItems }));
+        return {
+            added: response.added,
+            items: response.items.map((i) => this.instantiateItem(i)),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Validation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Validates a Mexico report.
+     *
+     * Uses Mexico-scoped validation input (jurisdiction is implicit).
+     *
+     * @param reportId - The report ID to validate
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.reports.validateReport(report.id, {
+     *   actividadVulnerable: {
+     *     rfc: "ABC200101XXX",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    async validateReport(reportId, defaults) {
+        const validated = this.validate(mexReportDefaultsInputSchema, defaults);
+        const nestedInput = this.transformValidateToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.validate.mutate(nestedInput));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Generation
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Generates XML for a Mexico report.
+     *
+     * Uses the same input as validateReport since generation requires
+     * the same transformation and defaults.
+     *
+     * @param reportId - The report ID to generate XML for
+     * @param defaults - Mexico report defaults including activity-specific settings
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.reports.generateReport(report.id, {
+     *   actividadVulnerable: {
+     *     rfc: "ABC200101XXX",
+     *     AVI: {
+     *       platformDomain: "https://example.com",
+     *       alertType: "100",
+     *     },
+     *   },
+     * });
+     * console.log(result.xml);
+     * ```
+     */
+    async generateReport(reportId, defaults) {
+        const validated = this.validate(mexReportDefaultsInputSchema, defaults);
+        const nestedInput = this.transformValidateToNested(reportId, validated);
+        return this.execute(() => this.trpc.reports.generate.mutate(nestedInput));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Submission
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Submits a validated Mexico report.
+     *
+     * The report must be in "valid" status. After submission, the report
+     * is locked and cannot be edited (except rejected reports which can
+     * be edited and resubmitted).
+     *
+     * @param reportId - The report ID
+     * @param actividadVulnerable - The activity type (AVI, JYS, or TSC)
+     * @param data - Optional submission data (acuseRecibo, notes)
+     *
+     * @example
+     * ```typescript
+     * const result = await mexSdk.reports.submitReport(
+     *   report.id,
+     *   "AVI",
+     *   { acuseRecibo: "SAT-12345", notes: "Submitted via portal" }
+     * );
+     * ```
+     */
+    async submit(input) {
+        const validated = this.validate(mexSubmitReportInputSchema, input);
+        const jurisdictions = {
+            MX: {
+                actividadVulnerable: validated.actividadVulnerable,
+            },
+        };
+        return this.execute(() => this.trpc.reports.submit.mutate({
+            reportId: validated.reportId,
+            jurisdictions,
+        }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Applies Mexico jurisdiction filter.
+     *
+     * Currently MexReportFilter has the same fields as the base filter,
+     * but this method ensures the jurisdiction scope is applied.
+     * Uses `availableJurisdictions` to find any report that includes Mexico.
+     */
+    applyScopeToFilter(filter) {
+        if (!filter) {
+            return {
+                availableJurisdictions: Jurisdiction.Mexico,
+            };
+        }
+        // Currently no MX-specific report filter fields to nest
+        // Just pass through and add jurisdiction scope
+        return {
+            ...filter,
+            availableJurisdictions: Jurisdiction.Mexico,
+        };
+    }
+    /**
+     * Transforms a flattened MexReportSort to nested ReportSort 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.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || !Array.isArray(sort) || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, mexReportFieldMapping);
+    }
+    /**
+     * Transforms flattened MX input to nested API format.
+     */
+    transformToNested(data) {
+        const { actividadVulnerable, ...baseFields } = data;
+        // Build MX jurisdiction data
+        const mexData = {};
+        if (actividadVulnerable !== undefined) {
+            mexData.actividadVulnerable = actividadVulnerable;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: Object.keys(mexData).length > 0
+                ? {
+                    MX: mexData,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    transformUpdateToNested(data) {
+        const { actividadVulnerable, ...baseFields } = data;
+        if (actividadVulnerable === undefined) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: { actividadVulnerable },
+            },
+        };
+    }
+    /**
+     * Instantiates a MexReport model.
+     */
+    instantiate(data) {
+        return new MexReport(data);
+    }
+    /**
+     * Instantiates a MexReportItem model.
+     */
+    instantiateItem(data) {
+        return new MexReportItem(data);
+    }
+    /**
+     * Transforms flattened MX report item input to nested API format.
+     */
+    transformItemToNested(data) {
+        const { actividadVulnerable, ...baseFields } = data;
+        if (actividadVulnerable === undefined) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: { actividadVulnerable },
+            },
+        };
+    }
+    /**
+     * Transforms flattened MX report item update input to nested API format.
+     */
+    transformItemUpdateToNested(data) {
+        const { actividadVulnerable, ...baseFields } = data;
+        if (actividadVulnerable === undefined) {
+            return baseFields;
+        }
+        return {
+            ...baseFields,
+            jurisdictions: {
+                MX: { actividadVulnerable },
+            },
+        };
+    }
+    /**
+     * Transforms flattened MX validate/generate input to nested API format.
+     */
+    transformValidateToNested(reportId, defaults) {
+        return {
+            reportId,
+            jurisdictions: {
+                MX: defaults,
+            },
+        };
+    }
+}