@artu-ai/compliance-sdk 0.0.6 → 0.3.0

package/dist/resources/mex/addresses.js

@@ -0,0 +1,328 @@
+/**
+ * Mexico Addresses Resource
+ *
+ * Extends AddressesResource with Mexico-specific behavior:
+ * - Accepts flattened CreateMexAddressInput (MX fields at root level)
+ * - Returns MexAddress models with Mexico-specific accessors
+ *
+ * Note: Mexican address format can be used for addresses in any country.
+ */
+import { z } from "zod";
+import { createMexAddressInputSchema, updateMexAddressInputSchema, replaceSyncItemSchema, transformSort, mexAddressFieldMapping, } from "@artu-ai/shared";
+import { AddressesResource } from "../addresses";
+import { MexAddress } from "../../models";
+// ===========================
+// MexAddressesResource
+// ===========================
+/**
+ * Mexico-scoped addresses resource.
+ *
+ * Provides the same operations as AddressesResource but with:
+ * - Flattened input types (MX fields like exteriorNumber, neighborhood at root level)
+ * - MexAddress model return type with Mexico-specific accessors
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * // Create with flattened input
+ * const address = await mexSdk.addresses.create({
+ *   clientId: "client_123",
+ *   street: "Paseo de la Reforma",
+ *   exteriorNumber: "222",
+ *   interiorNumber: "Piso 5",
+ *   neighborhood: "Juárez",
+ *   city: "Ciudad de México",
+ *   state: "CDMX",
+ *   postalCode: "06600",
+ *   country: "MX",
+ *   type: "home",
+ * });
+ *
+ * // Returns MexAddress
+ * console.log(address.exteriorNumber);
+ * console.log(address.formattedMexican);
+ * ```
+ */
+export class MexAddressesResource extends AddressesResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations (override with flattened input types)
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates a new address with Mexico-format fields.
+     */
+    async create(data) {
+        const validated = this.validate(createMexAddressInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.addresses.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves an address by ID.
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.addresses.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.addresses.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.addresses.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates an address with Mexico-format fields.
+     */
+    async update(id, data) {
+        const validated = this.validate(updateMexAddressInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.addresses.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists addresses with optional filtering.
+     *
+     * Accepts flattened MX filter (MX-specific fields at root level).
+     */
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const scopedSort = this.applyScopeToSort(options?.sort);
+        const response = await this.execute(() => this.trpc.addresses.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((a) => this.instantiate(a)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Lists all addresses for a specific client.
+     */
+    async listByClient(clientId, options) {
+        const response = await this.execute(() => this.trpc.addresses.listByClient.query({ clientId, ...options }));
+        return {
+            data: response.data.map((a) => this.instantiate(a)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Gets the primary address for a client.
+     */
+    async getPrimary(clientId, type) {
+        const response = await this.execute(() => this.trpc.addresses.getPrimary.query({ clientId, type }));
+        return response ? this.instantiate(response) : null;
+    }
+    /**
+     * Iterates over addresses.
+     *
+     * Accepts flattened MX filter (MX-specific fields at root level).
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    async createMany(addresses, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createMexAddressInputSchema), addresses);
+        const nestedItems = validated.map((a) => this.transformToNested(a));
+        const response = await this.execute(() => this.trpc.addresses.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((a) => this.instantiate(a)),
+            };
+        }
+        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: updateMexAddressInputSchema,
+        });
+        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.addresses.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((a) => this.instantiate(a)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    async sync(clientId, items, options) {
+        const validated = this.validate(z.array(replaceSyncItemSchema(createMexAddressInputSchema, updateMexAddressInputSchema)), items);
+        // Transform each item to nested format
+        const nestedItems = [];
+        for (const item of validated) {
+            if ("_delete" in item && item._delete) {
+                // Delete items pass through unchanged
+                nestedItems.push(item);
+            }
+            else if ("id" in item && item.id) {
+                // Update items - transform the data fields
+                const { id, ...data } = item;
+                const transformed = this.transformUpdateToNested(data);
+                nestedItems.push({
+                    id,
+                    ...transformed,
+                });
+            }
+            else {
+                // Create items - transform full item
+                const transformed = this.transformToNested(item);
+                nestedItems.push(transformed);
+            }
+        }
+        // Call parent sync with transformed items
+        // Parent already uses our overridden instantiate(), so result contains MexAddress
+        const result = await super.sync(clientId, nestedItems, options);
+        return result;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms flattened MX filter to nested API format.
+     *
+     * Mexico-specific filter fields (neighborhood, municipality) are stored
+     * in `jurisdictions.MX`. Base fields pass through unchanged.
+     */
+    applyScopeToFilter(filter) {
+        if (!filter)
+            return {};
+        const { neighborhood, municipality, ...baseFields } = filter;
+        const hasMexFields = neighborhood !== undefined || municipality !== undefined;
+        if (!hasMexFields) {
+            return baseFields;
+        }
+        const mexData = {};
+        if (neighborhood !== undefined)
+            mexData.neighborhood = neighborhood;
+        if (municipality !== undefined)
+            mexData.municipality = municipality;
+        return {
+            ...baseFields,
+            jurisdictions: { MX: mexData },
+        };
+    }
+    /**
+     * Transforms a flattened MexAddressSort to nested AddressSort 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, mexAddressFieldMapping);
+    }
+    /**
+     * Transforms flattened MX input to nested API format.
+     *
+     * Mexico-specific fields (exteriorNumber, interiorNumber, neighborhood, etc.)
+     * are stored in `jurisdictions.MX`. The base `street` field is passed through.
+     */
+    transformToNested(data) {
+        const { 
+        // Mexico-specific fields go into `jurisdictions.MX`
+        exteriorNumber, interiorNumber, neighborhood, municipality, betweenStreets, reference, 
+        // Base fields pass through
+        ...baseFields } = data;
+        // Build Mexico-specific data for the `jurisdictions.MX` column
+        // exteriorNumber and neighborhood are required by schema validation
+        const mexData = {
+            exteriorNumber,
+            neighborhood,
+        };
+        if (interiorNumber !== undefined)
+            mexData.interiorNumber = interiorNumber;
+        if (municipality !== undefined)
+            mexData.municipality = municipality;
+        if (betweenStreets !== undefined)
+            mexData.betweenStreets = betweenStreets;
+        if (reference !== undefined)
+            mexData.reference = reference;
+        return {
+            ...baseFields,
+            jurisdictions: { MX: mexData },
+        };
+    }
+    /**
+     * Transforms flattened MX update input to nested API format.
+     */
+    transformUpdateToNested(data) {
+        const { 
+        // Mexico-specific fields go into `jurisdictions.MX`
+        exteriorNumber, interiorNumber, neighborhood, municipality, betweenStreets, reference, 
+        // Base fields pass through
+        ...baseFields } = data;
+        const hasMexFields = exteriorNumber !== undefined ||
+            interiorNumber !== undefined ||
+            neighborhood !== undefined ||
+            municipality !== undefined ||
+            betweenStreets !== undefined ||
+            reference !== undefined;
+        if (!hasMexFields) {
+            return baseFields;
+        }
+        const mexData = {};
+        if (exteriorNumber !== undefined)
+            mexData.exteriorNumber = exteriorNumber;
+        if (interiorNumber !== undefined)
+            mexData.interiorNumber = interiorNumber;
+        if (neighborhood !== undefined)
+            mexData.neighborhood = neighborhood;
+        if (municipality !== undefined)
+            mexData.municipality = municipality;
+        if (betweenStreets !== undefined)
+            mexData.betweenStreets = betweenStreets;
+        if (reference !== undefined)
+            mexData.reference = reference;
+        return {
+            ...baseFields,
+            jurisdictions: { MX: mexData },
+        };
+    }
+    /**
+     * Instantiates a MexAddress model.
+     */
+    instantiate(data) {
+        return new MexAddress(data);
+    }
+}

package/dist/resources/mex/bank-accounts.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Mexico Bank Accounts Resource
+ *
+ * Extends BankAccountsResource to return MexBankAccount models
+ * with Mexico-specific helpers (CLABE formatting, etc.).
+ */
+import type { CreateBankAccountInput, UpdateBankAccountInput, BankAccountFilter, BankAccountSort, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, SyncItem, SyncResult, MexBankAccountFilter, MexBankAccountSort } from "@artu-ai/shared";
+import { BankAccountsResource } from "../bank-accounts";
+import { MexBankAccount, type BankAccountData } from "../../models";
+/**
+ * Mexico-scoped bank accounts resource.
+ *
+ * Identical to BankAccountsResource but returns MexBankAccount models
+ * with Mexico-specific helpers like CLABE formatting.
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * const account = await mexSdk.bankAccounts.create({
+ *   clientId: "client_123",
+ *   accountNumber: "1234567890",
+ *   bankName: "BBVA México",
+ *   type: "checking",
+ *   currency: "MXN",
+ *   country: "MX",
+ *   clabe: "012180001234567890",
+ * });
+ *
+ * // Returns MexBankAccount with helpers
+ * console.log(account.clabe);
+ * console.log(account.formattedClabe);  // "012 180 00123456789 0"
+ * console.log(account.maskedClabe);     // "**************7890"
+ * ```
+ */
+export declare class MexBankAccountsResource<TSort = MexBankAccountSort> extends BankAccountsResource<TSort> {
+    create(data: CreateBankAccountInput): Promise<MexBankAccount>;
+    retrieve(id: string): Promise<MexBankAccount>;
+    retrieveByMetadata(key: string, value: string): Promise<MexBankAccount>;
+    retrieveByExternalId(externalId: string): Promise<MexBankAccount>;
+    update(id: string, data: UpdateBankAccountInput): Promise<MexBankAccount>;
+    /**
+     * Lists bank accounts with optional filtering.
+     *
+     * Accepts flattened MX filter (MX-specific fields at root level).
+     */
+    list(options?: ListOptions<MexBankAccountFilter, TSort>): Promise<PaginatedResponse<MexBankAccount>>;
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<MexBankAccount>>;
+    /**
+     * Iterates over bank accounts.
+     *
+     * Accepts flattened MX filter (MX-specific fields at root level).
+     */
+    iterate(filter?: MexBankAccountFilter): AsyncGenerator<MexBankAccount, void, undefined>;
+    createMany(accounts: CreateBankAccountInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexBankAccount>>;
+    createMany(accounts: CreateBankAccountInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexBankAccount>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateBankAccountInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexBankAccount>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateBankAccountInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexBankAccount>>;
+    sync(clientId: string, items: SyncItem<CreateBankAccountInput>[], options: {
+        replaceMode: true;
+    }): Promise<SyncResult<MexBankAccount>>;
+    sync(clientId: string, items: SyncItem<UpdateBankAccountInput>[], options?: {
+        replaceMode?: boolean;
+    }): Promise<SyncResult<MexBankAccount>>;
+    setPrimary(id: string): Promise<MexBankAccount>;
+    activate(id: string): Promise<MexBankAccount>;
+    deactivate(id: string): Promise<MexBankAccount>;
+    getPrimary(clientId: string): Promise<MexBankAccount | null>;
+    /**
+     * Transforms flattened MX filter to nested API format.
+     *
+     * Mexico-specific filter fields (clabe, codigoBanco, codigoPlaza) are stored
+     * in `jurisdictions.MX`. Base fields pass through unchanged.
+     */
+    protected applyScopeToFilter(filter?: MexBankAccountFilter): BankAccountFilter;
+    /**
+     * Transforms a flattened MexBankAccountSort to nested BankAccountSort 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): BankAccountSort | undefined;
+    protected instantiate(data: BankAccountData): MexBankAccount;
+}
+//# sourceMappingURL=bank-accounts.d.ts.map

package/dist/resources/mex/bank-accounts.d.ts.map

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

package/dist/resources/mex/bank-accounts.js

@@ -0,0 +1,163 @@
+/**
+ * Mexico Bank Accounts Resource
+ *
+ * Extends BankAccountsResource to return MexBankAccount models
+ * with Mexico-specific helpers (CLABE formatting, etc.).
+ */
+import { transformSort, mexBankAccountFieldMapping, } from "@artu-ai/shared";
+import { BankAccountsResource } from "../bank-accounts";
+import { MexBankAccount } from "../../models";
+/**
+ * Mexico-scoped bank accounts resource.
+ *
+ * Identical to BankAccountsResource but returns MexBankAccount models
+ * with Mexico-specific helpers like CLABE formatting.
+ *
+ * @example
+ * ```typescript
+ * const mexSdk = new ComplianceSDK({
+ *   apiKey,
+ *   environment: "test",
+ *   jurisdiction: Jurisdiction.Mexico,
+ * });
+ *
+ * const account = await mexSdk.bankAccounts.create({
+ *   clientId: "client_123",
+ *   accountNumber: "1234567890",
+ *   bankName: "BBVA México",
+ *   type: "checking",
+ *   currency: "MXN",
+ *   country: "MX",
+ *   clabe: "012180001234567890",
+ * });
+ *
+ * // Returns MexBankAccount with helpers
+ * console.log(account.clabe);
+ * console.log(account.formattedClabe);  // "012 180 00123456789 0"
+ * console.log(account.maskedClabe);     // "**************7890"
+ * ```
+ */
+export class MexBankAccountsResource extends BankAccountsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations (override return types)
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        return super.create(data);
+    }
+    async retrieve(id) {
+        return super.retrieve(id);
+    }
+    async retrieveByMetadata(key, value) {
+        return super.retrieveByMetadata(key, value);
+    }
+    async retrieveByExternalId(externalId) {
+        return super.retrieveByExternalId(externalId);
+    }
+    async update(id, data) {
+        return super.update(id, data);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists bank accounts with optional filtering.
+     *
+     * Accepts flattened MX filter (MX-specific fields at root level).
+     */
+    async list(options) {
+        const scopedFilter = this.applyScopeToFilter(options?.filter);
+        const scopedSort = this.applyScopeToSort(options?.sort);
+        const response = await this.execute(() => this.trpc.bankAccounts.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((a) => this.instantiate(a)),
+            pagination: response.pagination,
+        };
+    }
+    async listByClient(clientId, options) {
+        return super.listByClient(clientId, options);
+    }
+    /**
+     * Iterates over bank accounts.
+     *
+     * Accepts flattened MX filter (MX-specific fields at root level).
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    async createMany(accounts, options = {}) {
+        return super.createMany(accounts, options);
+    }
+    async updateMany(updates, options = {}) {
+        return super.updateMany(updates, options);
+    }
+    async sync(clientId, items, options) {
+        return super.sync(clientId, items, options);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Convenience Methods (override return types)
+    // ─────────────────────────────────────────────────────────────────
+    async setPrimary(id) {
+        return super.setPrimary(id);
+    }
+    async activate(id) {
+        return super.activate(id);
+    }
+    async deactivate(id) {
+        return super.deactivate(id);
+    }
+    async getPrimary(clientId) {
+        return super.getPrimary(clientId);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms flattened MX filter to nested API format.
+     *
+     * Mexico-specific filter fields (clabe, codigoBanco, codigoPlaza) are stored
+     * in `jurisdictions.MX`. Base fields pass through unchanged.
+     */
+    applyScopeToFilter(filter) {
+        if (!filter)
+            return {};
+        const { clabe, codigoBanco, codigoPlaza, ...baseFields } = filter;
+        const hasMexFields = clabe !== undefined ||
+            codigoBanco !== undefined ||
+            codigoPlaza !== undefined;
+        if (!hasMexFields) {
+            return baseFields;
+        }
+        const mexData = {};
+        if (clabe !== undefined)
+            mexData.clabe = clabe;
+        if (codigoBanco !== undefined)
+            mexData.codigoBanco = codigoBanco;
+        if (codigoPlaza !== undefined)
+            mexData.codigoPlaza = codigoPlaza;
+        return {
+            ...baseFields,
+            jurisdictions: { MX: mexData },
+        };
+    }
+    /**
+     * Transforms a flattened MexBankAccountSort to nested BankAccountSort 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, mexBankAccountFieldMapping);
+    }
+    instantiate(data) {
+        return new MexBankAccount(data);
+    }
+}