@artu-ai/compliance-sdk 0.0.5 → 0.2.0

package/dist/namespaces/mexico/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/namespaces/mexico/index.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWT,CAAC;AAEX,eAAe,MAAM,CAAC"}

package/dist/namespaces/mexico/index.js

@@ -0,0 +1,140 @@
+/**
+ * Mexico namespace
+ *
+ * All Mexico-specific functionality organized in one place:
+ * - Enums (ActividadEconomica, GiroMercantil, DocumentType)
+ * - Validators (RFC, CURP, CLABE)
+ * - Models (MexClient, MexTransaction, etc.)
+ * - Resources (MexClientsResource, etc.)
+ * - TypeGuards (isMexClient, etc.)
+ * - Types (MexJurisdictionData, etc.)
+ * - ActividadVulnerable (AVI, JYS, TSC subnamespaces)
+ *
+ * @example
+ * ```ts
+ * import { Mexico } from "@artu/compliance-sdk";
+ *
+ * // General enums
+ * Mexico.Enums.ActividadEconomica.Comercio
+ * Mexico.Enums.DocumentType.INE
+ *
+ * // Validators
+ * Mexico.Validators.Rfc.validate("GOAP820528H00")
+ *
+ * // Models
+ * Mexico.Models.Client  // MexClient
+ *
+ * // Actividad Vulnerable (nested)
+ * Mexico.ActividadVulnerable.Enums.CodigoActividad.AVI
+ * Mexico.ActividadVulnerable.AVI.Enums.TipoOperacion.Buy
+ * Mexico.ActividadVulnerable.AVI.Models.Client  // MexAVIClient
+ * ```
+ */
+import { ActividadEconomica, ActividadesEconomicas, GiroMercantil, GirosMercantiles, MexDocumentType, MexDocumentTypes, AddressProofServiceType, AddressProofServiceTypes, MexEntityType, MexEntityTypes, PoderType, PoderTypes, Rfc, Curp, Clabe, } from "@artu-ai/shared";
+import { MexClient, MexTransaction, MexBankAccount, MexAddress, MexReport, MexReportItem, 
+// Document models
+MexDocument, MexIneFrontDocument, MexIneBackDocument, MexPassportDocument, MexCurpDocument, MexRfcConstanciaDocument, MexAddressProofDocument, MexActaConstitutivaDocument, MexPoderNotarialDocument, 
+// Type guards
+isMexClient, isMexTransaction, isMexBankAccount, isMexAddress, isMexReport, isMexReportItem, isMexDocument, isMexIneFront, isMexIneBack, isMexPassport, isMexCurp, isMexRfcConstancia, isMexAddressProof, isMexActaConstitutiva, isMexPoderNotarial, } from "../../models";
+import { MexClientsResource, MexTransactionsResource, MexBankAccountsResource, MexReportsResource, } from "../../resources";
+// Actividad Vulnerable namespace
+import { ActividadVulnerable, AVI, JYS, TSC } from "./actividad-vulnerable";
+// Re-export for convenience
+export { ActividadVulnerable, AVI, JYS, TSC } from "./actividad-vulnerable";
+// ===========================
+// Enums
+// ===========================
+export const Enums = {
+    // Enum values
+    ActividadEconomica,
+    GiroMercantil,
+    DocumentType: MexDocumentType,
+    AddressProofServiceType,
+    EntityType: MexEntityType,
+    PoderType,
+    // Enum utilities (with .enum, .map, .codes, .options, .schema())
+    ActividadesEconomicas,
+    GirosMercantiles,
+    DocumentTypes: MexDocumentTypes,
+    AddressProofServiceTypes,
+    EntityTypes: MexEntityTypes,
+    PoderTypes,
+};
+// ===========================
+// Validators
+// ===========================
+export const Validators = {
+    Rfc,
+    Curp,
+    Clabe,
+};
+// ===========================
+// Models
+// ===========================
+export const Models = {
+    Client: MexClient,
+    Transaction: MexTransaction,
+    BankAccount: MexBankAccount,
+    Address: MexAddress,
+    Report: MexReport,
+    ReportItem: MexReportItem,
+    // Document models
+    Document: MexDocument,
+    IneFrontDocument: MexIneFrontDocument,
+    IneBackDocument: MexIneBackDocument,
+    PassportDocument: MexPassportDocument,
+    CurpDocument: MexCurpDocument,
+    RfcConstanciaDocument: MexRfcConstanciaDocument,
+    AddressProofDocument: MexAddressProofDocument,
+    ActaConstitutivaDocument: MexActaConstitutivaDocument,
+    PoderNotarialDocument: MexPoderNotarialDocument,
+};
+// ===========================
+// Resources
+// ===========================
+export const Resources = {
+    Clients: MexClientsResource,
+    Transactions: MexTransactionsResource,
+    BankAccounts: MexBankAccountsResource,
+    Reports: MexReportsResource,
+};
+// ===========================
+// TypeGuards
+// ===========================
+export const TypeGuards = {
+    isClient: isMexClient,
+    isTransaction: isMexTransaction,
+    isBankAccount: isMexBankAccount,
+    isAddress: isMexAddress,
+    isReport: isMexReport,
+    isReportItem: isMexReportItem,
+    // Document guards
+    isDocument: isMexDocument,
+    isIneFront: isMexIneFront,
+    isIneBack: isMexIneBack,
+    isPassport: isMexPassport,
+    isCurp: isMexCurp,
+    isRfcConstancia: isMexRfcConstancia,
+    isAddressProof: isMexAddressProof,
+    isActaConstitutiva: isMexActaConstitutiva,
+    isPoderNotarial: isMexPoderNotarial,
+};
+// ===========================
+// Main Mexico Namespace
+// ===========================
+/**
+ * Mexico namespace - all Mexico-specific SDK functionality
+ */
+export const Mexico = {
+    Enums,
+    Validators,
+    Models,
+    Resources,
+    TypeGuards,
+    ActividadVulnerable,
+    // Shortcuts to activity namespaces
+    AVI,
+    JYS,
+    TSC,
+};
+export default Mexico;

package/dist/resources/addresses.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Addresses Resource
+ *
+ * Manages physical and mailing addresses for clients.
+ */
+import type { CreateAddressInput, UpdateAddressInput, AddressFilter, AddressType, ListOptions, PaginatedResponse, AtomicBatchResult, PartialBatchResult, SyncItem, SyncResult } from "@artu-ai/shared";
+import { BaseResource } from "./base";
+import { Address, type AddressData } from "../models/Address";
+/**
+ * Resource for managing client addresses.
+ *
+ * @example
+ * ```typescript
+ * // Create an address for a client
+ * const address = await sdk.addresses.create({
+ *   clientId: "client_123",
+ *   type: "home",
+ *   street1: "Avenida Reforma 123",
+ *   city: "Ciudad de México",
+ *   state: "CDMX",
+ *   postalCode: "06600",
+ *   country: "MX",
+ *   isPrimary: true,
+ * });
+ *
+ * // List all addresses for a client
+ * const addresses = await sdk.addresses.listByClient("client_123");
+ * ```
+ */
+export declare class AddressesResource extends BaseResource<Address, CreateAddressInput, UpdateAddressInput, AddressFilter> {
+    /**
+     * Creates an address for a client
+     *
+     * @param data - Address data including clientId
+     * @returns The created Address
+     */
+    create(data: CreateAddressInput): Promise<Address>;
+    /**
+     * Retrieves an address by ID
+     *
+     * @param id - The address ID
+     * @returns The Address
+     */
+    retrieve(id: string): Promise<Address>;
+    /**
+     * Retrieves an address by metadata key/value.
+     */
+    retrieveByMetadata(key: string, value: string): Promise<Address>;
+    /**
+     * Retrieves an address by externalId
+     */
+    retrieveByExternalId(externalId: string): Promise<Address>;
+    /**
+     * Updates an address
+     *
+     * @param id - The address ID
+     * @param data - Fields to update
+     * @returns The updated Address
+     */
+    update(id: string, data: UpdateAddressInput): Promise<Address>;
+    /**
+     * Deletes an address
+     *
+     * @param id - The address ID
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Lists addresses with optional filtering
+     *
+     * @param options - Filtering and pagination options
+     * @returns Paginated list of Addresses
+     */
+    list(options?: ListOptions<AddressFilter>): Promise<PaginatedResponse<Address>>;
+    /**
+     * Lists all addresses for a specific client
+     *
+     * @param clientId - The client ID
+     * @param options - Optional pagination options
+     * @returns Paginated list of Addresses
+     */
+    listByClient(clientId: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<PaginatedResponse<Address>>;
+    /**
+     * Returns an async iterator over all addresses matching the filter.
+     */
+    iterate(filter?: AddressFilter): AsyncGenerator<Address, void, undefined>;
+    /**
+     * Creates multiple addresses in a single request.
+     *
+     * @param addresses - Array of address creation data (each includes clientId)
+     * @param options - Batch options (atomic: true by default)
+     * @returns Atomic result with data array, or partial result with succeeded/failed
+     */
+    createMany(addresses: CreateAddressInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<Address>>;
+    createMany(addresses: CreateAddressInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<Address>>;
+    /**
+     * Updates multiple addresses in a single request.
+     *
+     * @param updates - Array of { id, data } updates
+     * @param options - Batch options (atomic: true by default)
+     * @returns Atomic result with data array, or partial result with succeeded/failed
+     */
+    updateMany(updates: {
+        id: string;
+        data: UpdateAddressInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<Address>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateAddressInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<Address>>;
+    /**
+     * Syncs addresses for a client - handles create, update, and delete in bulk.
+     *
+     * This is the most efficient way to reconcile a set of addresses for a client.
+     *
+     * @param clientId - The client ID
+     * @param items - Array of sync items:
+     *   - Without `id`: create new address
+     *   - With `id` and `_delete: true`: delete existing address
+     *   - With `id` (no `_delete`): update existing address
+     * @param options - Sync options
+     * @param options.replaceMode - When true, items not in the array are deleted (default: false)
+     * @returns Sync result with created, updated, and deleted arrays
+     *
+     * @example
+     * ```typescript
+     * // Patch mode (default) - only mentioned items are affected
+     * const result = await sdk.addresses.sync("client_123", [
+     *   // Create new address (no id)
+     *   { street: "123 New St", city: "Mexico City", country: "MX" },
+     *   // Update existing address (has id)
+     *   { id: "addr_456", street: "456 Updated Ave" },
+     *   // Delete address (has id and _delete: true)
+     *   { id: "addr_789", _delete: true },
+     * ]);
+     *
+     * // Replace mode - provided array becomes the complete set
+     * const result = await sdk.addresses.sync("client_123", addresses, { replaceMode: true });
+     *
+     * console.log(result.created);  // newly created addresses
+     * console.log(result.updated);  // updated addresses
+     * console.log(result.deleted);  // array of deleted address IDs
+     * ```
+     */
+    sync(clientId: string, items: SyncItem<CreateAddressInput>[], options?: {
+        replaceMode: true;
+    }): Promise<SyncResult<Address>>;
+    sync(clientId: string, items: SyncItem<UpdateAddressInput>[], options?: {
+        replaceMode?: boolean;
+    }): Promise<SyncResult<Address>>;
+    /**
+     * Gets the primary address for a client
+     *
+     * @param clientId - The client ID
+     * @param type - Optional address type filter
+     * @returns The primary Address or null
+     */
+    getPrimary(clientId: string, type?: AddressType): Promise<Address | null>;
+    protected instantiate(data: AddressData): Address;
+}
+//# sourceMappingURL=addresses.d.ts.map

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

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

package/dist/resources/addresses.js

@@ -0,0 +1,208 @@
+/**
+ * Addresses Resource
+ *
+ * Manages physical and mailing addresses for clients.
+ */
+import { z } from "zod";
+import { createAddressInputSchema, updateAddressInputSchema, replaceSyncItemSchema, } from "@artu-ai/shared";
+import { BaseResource } from "./base";
+import { Address } from "../models/Address";
+// ===========================
+// AddressesResource
+// ===========================
+/**
+ * Resource for managing client addresses.
+ *
+ * @example
+ * ```typescript
+ * // Create an address for a client
+ * const address = await sdk.addresses.create({
+ *   clientId: "client_123",
+ *   type: "home",
+ *   street1: "Avenida Reforma 123",
+ *   city: "Ciudad de México",
+ *   state: "CDMX",
+ *   postalCode: "06600",
+ *   country: "MX",
+ *   isPrimary: true,
+ * });
+ *
+ * // List all addresses for a client
+ * const addresses = await sdk.addresses.listByClient("client_123");
+ * ```
+ */
+export class AddressesResource extends BaseResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Creates an address for a client
+     *
+     * @param data - Address data including clientId
+     * @returns The created Address
+     */
+    async create(data) {
+        const validated = this.validate(createAddressInputSchema, data);
+        const response = await this.execute(() => this.trpc.addresses.create.mutate(validated));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves an address by ID
+     *
+     * @param id - The address ID
+     * @returns The Address
+     */
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.addresses.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves an address by metadata key/value.
+     */
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.addresses.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    /**
+     * Retrieves an address by externalId
+     */
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.addresses.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    /**
+     * Updates an address
+     *
+     * @param id - The address ID
+     * @param data - Fields to update
+     * @returns The updated Address
+     */
+    async update(id, data) {
+        const validated = this.validate(updateAddressInputSchema, data);
+        const response = await this.execute(() => this.trpc.addresses.update.mutate({ id, data: validated }));
+        return this.instantiate(response);
+    }
+    /**
+     * Deletes an address
+     *
+     * @param id - The address ID
+     */
+    async delete(id) {
+        await this.execute(() => this.trpc.addresses.delete.mutate({ id }));
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List Operations
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists addresses with optional filtering
+     *
+     * @param options - Filtering and pagination options
+     * @returns Paginated list of Addresses
+     */
+    async list(options) {
+        const response = await this.execute(() => this.trpc.addresses.list.query(options));
+        return {
+            data: response.data.map((a) => this.instantiate(a)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Lists all addresses for a specific client
+     *
+     * @param clientId - The client ID
+     * @param options - Optional pagination options
+     * @returns Paginated list of Addresses
+     */
+    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,
+        };
+    }
+    /**
+     * Returns an async iterator over all addresses matching the filter.
+     */
+    iterate(filter) {
+        return this.createIterator({ filter });
+    }
+    async createMany(addresses, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createAddressInputSchema), addresses);
+        const response = await this.execute(() => this.trpc.addresses.createMany.mutate({ items: validated, 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: updateAddressInputSchema,
+        });
+        const validated = this.validate(z.array(updateItemSchema), updates);
+        const response = await this.execute(() => this.trpc.addresses.updateMany.mutate({ items: validated, 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(createAddressInputSchema, updateAddressInputSchema)), items);
+        const response = await this.execute(() => this.trpc.addresses.sync.mutate({
+            clientId,
+            items: validated,
+            replaceMode: options?.replaceMode,
+        }));
+        return {
+            created: response.created.map((a) => this.instantiate(a)),
+            updated: response.updated.map((a) => this.instantiate(a)),
+            deleted: response.deleted,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Helper Methods
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Gets the primary address for a client
+     *
+     * @param clientId - The client ID
+     * @param type - Optional address type filter
+     * @returns The primary Address or null
+     */
+    async getPrimary(clientId, type) {
+        const response = await this.execute(() => this.trpc.addresses.getPrimary.query({ clientId, type }));
+        return response ? this.instantiate(response) : null;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Instantiation
+    // ─────────────────────────────────────────────────────────────────
+    instantiate(data) {
+        return new Address(data);
+    }
+}