@artu-ai/compliance-sdk 0.4.1 → 0.4.3

package/src/resources/mex/actividad-vulnerable/jys/clients.ts

@@ -1,445 +0,0 @@
-/**
- * JYS (Juegos y Sorteos) Clients Resource
- *
- * Extends MexClientsResource with JYS-specific behavior.
- * JYS clients have the same fields as Mexico clients (no additional activity fields).
- * Returns MexJYSClient models.
- */
-
-import { z } from "zod";
-import type {
-  CreateClientInput,
-  UpdateClientInput,
-  ListOptions,
-  PaginatedResponse,
-  CreateJYSClientInput,
-  UpdateJYSClientInput,
-  CreateMexClientInput,
-  UpdateMexClientInput,
-  AtomicBatchResult,
-  PartialBatchResult,
-  ClientRelationshipType,
-  LinkedClient as LinkedClientInput,
-  CreateMexAddressInput,
-  UpdateMexAddressInput,
-  CreateContactMethodInput,
-  UpdateContactMethodInput,
-  CreateBankAccountInput,
-  UpdateBankAccountInput,
-  SyncItem,
-  SyncResult,
-  JYSClientFilter,
-  JYSClientSort,
-} from "@artu-ai/shared";
-import {
-  CodigoActividad,
-  createJYSClientInputSchema,
-  updateJYSClientInputSchema,
-  linkedClientSchema,
-  transformSort,
-  jysClientFieldMapping,
-} from "@artu-ai/shared";
-import type { ClientSort } from "@artu-ai/shared";
-import { MexClientsResource } from "../../clients";
-import { type BatchOptions, type ClientIncludeMap } from "../../../clients";
-import {
-  MexJYSClient,
-  MexAddress,
-  MexBankAccount,
-  ContactMethod,
-  LinkedClient,
-  type ClientData,
-} from "../../../../models";
-
-// ===========================
-// JYSClientsResource
-// ===========================
-
-/**
- * JYS (Juegos y Sorteos) scoped clients resource.
- *
- * @example
- * ```typescript
- * const jysSdk = new ComplianceSDK({
- *   apiKey,
- *   environment: "test",
- *   jurisdiction: Jurisdiction.Mexico,
- *   actividadVulnerable: CodigoActividad.JYS,
- * });
- *
- * const client = await jysSdk.clients.create({
- *   type: ClientType.Person,
- *   name: "Juan García",
- *   rfc: "GAJL850101ABC",
- * });
- *
- * // Returns MexJYSClient
- * ```
- */
-export class JYSClientsResource extends MexClientsResource<JYSClientSort> {
-  // ─────────────────────────────────────────────────────────────────
-  // CRUD Operations
-  // ─────────────────────────────────────────────────────────────────
-
-  async create(data: CreateJYSClientInput): Promise<MexJYSClient> {
-    const validated = this.validate(createJYSClientInputSchema, data);
-    const nestedData = this.transformToNested(validated);
-
-    const response = await this.execute(() =>
-      this.trpc.clients.create.mutate(nestedData)
-    );
-
-    return this.instantiate(response);
-  }
-
-  async retrieve(
-    id: string,
-    include?: ClientIncludeMap
-  ): Promise<MexJYSClient> {
-    const response = await this.execute(() =>
-      this.trpc.clients.retrieve.query({ id, include })
-    );
-    return this.instantiate(response);
-  }
-
-  async retrieveByExternalId(externalId: string): Promise<MexJYSClient> {
-    const response = await this.execute(() =>
-      this.trpc.clients.retrieveByExternalId.query({ externalId })
-    );
-    return this.instantiate(response);
-  }
-
-  async update(id: string, data: UpdateJYSClientInput): Promise<MexJYSClient> {
-    const validated = this.validate(updateJYSClientInputSchema, 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 JYS clients with optional filtering.
-   *
-   * Accepts flattened JYS filter (MX fields at root level) and automatically
-   * transforms to nested format before calling the API.
-   */
-  async list(
-    options?: ListOptions<JYSClientFilter, JYSClientSort> & { includePrimaryContacts?: boolean }
-  ): Promise<PaginatedResponse<MexJYSClient>> {
-    const scopedFilter = this.applyScopeToFilter(options?.filter);
-    const scopedSort = this.applyScopeToSort(options?.sort);
-
-    const response = await this.execute(() =>
-      this.trpc.clients.list.query({
-        ...options,
-        filter: scopedFilter,
-        sort: scopedSort,
-      })
-    );
-
-    return {
-      data: response.data.map((c) => this.instantiate(c)),
-      pagination: response.pagination,
-    };
-  }
-
-  /**
-   * Iterates over JYS clients.
-   *
-   * Accepts flattened JYS filter (MX fields at root level) and automatically
-   * transforms to nested format before calling the API.
-   */
-  iterate(
-    filter?: JYSClientFilter
-  ): AsyncGenerator<MexJYSClient, void, undefined> {
-    const scopedFilter = this.applyScopeToFilter(filter);
-    return this.createIterator<MexJYSClient>({ filter: scopedFilter });
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Batch Operations
-  // ─────────────────────────────────────────────────────────────────
-
-  async createMany(
-    clients: CreateJYSClientInput[],
-    options?: { atomic?: true }
-  ): Promise<AtomicBatchResult<MexJYSClient>>;
-  async createMany(
-    clients: CreateJYSClientInput[],
-    options: { atomic: false }
-  ): Promise<PartialBatchResult<MexJYSClient>>;
-  async createMany(
-    clients: CreateJYSClientInput[],
-    options: BatchOptions = {}
-  ): Promise<
-    AtomicBatchResult<MexJYSClient> | PartialBatchResult<MexJYSClient>
-  > {
-    const atomic = options.atomic ?? true;
-    const validated = this.validate(
-      z.array(createJYSClientInputSchema),
-      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: { id: string; data: UpdateJYSClientInput }[],
-    options?: { atomic?: true }
-  ): Promise<AtomicBatchResult<MexJYSClient>>;
-  async updateMany(
-    updates: { id: string; data: UpdateJYSClientInput }[],
-    options: { atomic: false }
-  ): Promise<PartialBatchResult<MexJYSClient>>;
-  async updateMany(
-    updates: { id: string; data: UpdateJYSClientInput }[],
-    options: BatchOptions = {}
-  ): Promise<
-    AtomicBatchResult<MexJYSClient> | PartialBatchResult<MexJYSClient>
-  > {
-    const atomic = options.atomic ?? true;
-    const updateItemSchema = z.object({
-      id: z.uuid(),
-      data: updateJYSClientInputSchema,
-    });
-
-    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: string,
-    childClientId: string,
-    relationshipType: ClientRelationshipType,
-    metadata?: Record<string, unknown>
-  ): Promise<MexJYSClient> {
-    const response = await this.execute(() =>
-      this.trpc.clients.linkClient.mutate({
-        parentClientId,
-        childClientId,
-        relationshipType,
-        metadata,
-      })
-    );
-    return this.instantiate(response);
-  }
-
-  async unlinkClient(
-    parentClientId: string,
-    childClientId: string,
-    relationshipType: ClientRelationshipType
-  ): Promise<MexJYSClient> {
-    const response = await this.execute(() =>
-      this.trpc.clients.unlinkClient.mutate({
-        parentClientId,
-        childClientId,
-        relationshipType,
-      })
-    );
-    return this.instantiate(response);
-  }
-
-  async listLinkedClients(
-    parentClientId: string,
-    relationshipType?: ClientRelationshipType
-  ): Promise<LinkedClient[]> {
-    return super.listLinkedClients(parentClientId, relationshipType);
-  }
-
-  async setLinkedClients(
-    parentClientId: string,
-    linkedClients: LinkedClientInput[]
-  ): Promise<MexJYSClient> {
-    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);
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Sync All (Atomic)
-  // ─────────────────────────────────────────────────────────────────
-
-  async syncAll(
-    clientId: string,
-    data: {
-      client?: UpdateJYSClientInput;
-      addresses?: SyncItem<CreateMexAddressInput>[];
-      contactMethods?: SyncItem<CreateContactMethodInput>[];
-      bankAccounts?: SyncItem<CreateBankAccountInput>[];
-      linkedClients?: LinkedClientInput[];
-    },
-    options: { replaceMode: true }
-  ): Promise<{
-    client: MexJYSClient;
-    addresses: SyncResult<MexAddress>;
-    contactMethods: SyncResult<ContactMethod>;
-    bankAccounts: SyncResult<MexBankAccount>;
-  }>;
-  async syncAll(
-    clientId: string,
-    data: {
-      client?: UpdateJYSClientInput;
-      addresses?: SyncItem<UpdateMexAddressInput>[];
-      contactMethods?: SyncItem<UpdateContactMethodInput>[];
-      bankAccounts?: SyncItem<UpdateBankAccountInput>[];
-      linkedClients?: LinkedClientInput[];
-    },
-    options?: { replaceMode?: boolean }
-  ): Promise<{
-    client: MexJYSClient;
-    addresses: SyncResult<MexAddress>;
-    contactMethods: SyncResult<ContactMethod>;
-    bankAccounts: SyncResult<MexBankAccount>;
-  }>;
-  async syncAll(
-    clientId: string,
-    data: {
-      client?: UpdateJYSClientInput;
-      addresses?: SyncItem<UpdateMexAddressInput | CreateMexAddressInput>[];
-      contactMethods?: SyncItem<UpdateContactMethodInput | CreateContactMethodInput>[];
-      bankAccounts?: SyncItem<UpdateBankAccountInput | CreateBankAccountInput>[];
-      linkedClients?: LinkedClientInput[];
-    },
-    options?: { replaceMode?: boolean }
-  ): Promise<{
-    client: MexJYSClient;
-    addresses: SyncResult<MexAddress>;
-    contactMethods: SyncResult<ContactMethod>;
-    bankAccounts: SyncResult<MexBankAccount>;
-  }> {
-    // Transform client input using JYS-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 as UpdateMexClientInput,
-      },
-      options as { replaceMode?: boolean }
-    );
-
-    // Re-instantiate client with JYS-specific model
-    return {
-      ...result,
-      client: this.instantiate(result.client as unknown as ClientData),
-    };
-  }
-
-  // ─────────────────────────────────────────────────────────────────
-  // Protected Helpers
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Transforms a flattened JYSClientSort to nested ClientSort format.
-   *
-   * Maps flattened field names to their full API paths.
-   */
-  protected override applyScopeToSort(sort?: JYSClientSort): ClientSort | undefined {
-    if (!sort || sort.length === 0) {
-      return undefined;
-    }
-    return transformSort(sort, jysClientFieldMapping);
-  }
-
-  /**
-   * Transforms JYS input to nested API format.
-   * JYS has no additional fields, but we add the JYS activity marker.
-   */
-  protected override transformToNested(
-    data: CreateJYSClientInput
-  ): CreateClientInput {
-    // Use parent transform for base + MX fields (cast needed for discriminated union)
-    const nested = super.transformToNested(
-      data as unknown as CreateMexClientInput
-    );
-
-    // Add JYS activity marker (parent always provides jurisdictions.MX)
-    const mexData = nested.jurisdictions?.MX;
-
-    return {
-      ...nested,
-      jurisdictions: {
-        MX: {
-          ...mexData,
-          actividadVulnerable: {
-            [CodigoActividad.JYS]: {},
-          },
-        },
-      },
-    } as CreateClientInput;
-  }
-
-  protected override transformUpdateToNested(
-    data: UpdateJYSClientInput
-  ): UpdateClientInput {
-    return super.transformUpdateToNested(
-      data as unknown as UpdateMexClientInput
-    );
-  }
-
-  protected override instantiate(data: ClientData): MexJYSClient {
-    return new MexJYSClient(data);
-  }
-}

package/src/resources/mex/actividad-vulnerable/jys/index.ts

@@ -1,7 +0,0 @@
-/**
- * JYS (Juegos y Sorteos) Scoped Resources
- */
-
-export { JYSClientsResource } from "./clients";
-export { JYSTransactionsResource } from "./transactions";
-export { JYSReportsResource } from "./reports";