@artu-ai/compliance-sdk 0.0.6 → 0.3.0

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

@@ -0,0 +1,252 @@
+/**
+ * AVI (Activos Virtuales) Transactions Resource
+ *
+ * Extends MexTransactionsResource with AVI-specific behavior:
+ * - Accepts flattened CreateAVITransactionInput (AVI fields at root level)
+ * - Returns MexAVITransaction models
+ */
+import { z } from "zod";
+import { Jurisdiction, CodigoActividad, createAVITransactionInputSchema, updateAVITransactionInputSchema, transformSort, aviTransactionFieldMapping, } from "@artu-ai/shared";
+import { MexTransactionsResource } from "../../transactions";
+import { MexAVITransaction } from "../../../../models";
+// ===========================
+// AVITransactionsResource
+// ===========================
+/**
+ * AVI (Activos Virtuales) scoped transactions resource.
+ *
+ * @example
+ * ```typescript
+ * const aviSdk = new ComplianceSDK({
+ *   apiKey,
+ *   jurisdiction: Jurisdiction.Mexico,
+ *   actividadVulnerable: CodigoActividad.AVI,
+ * });
+ *
+ * // Create with fully flattened input
+ * const txn = await aviSdk.transactions.create({
+ *   amount: 50000,
+ *   currency: "MXN",
+ *   timestamp: new Date(),
+ *   operationType: "buy",
+ *   crypto: "BTC",
+ *   hash: "ABC123DEF456",
+ * });
+ *
+ * // Returns MexAVITransaction
+ * console.log(txn.operationType);
+ * ```
+ */
+export class AVITransactionsResource extends MexTransactionsResource {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        const validated = this.validate(createAVITransactionInputSchema, data);
+        const nestedData = this.transformToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.create.mutate(nestedData));
+        return this.instantiate(response);
+    }
+    async retrieve(id) {
+        const response = await this.execute(() => this.trpc.transactions.retrieve.query({ id }));
+        return this.instantiate(response);
+    }
+    async retrieveByMetadata(key, value) {
+        const response = await this.execute(() => this.trpc.transactions.retrieveByMetadata.query({ key, value }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        const validated = this.validate(updateAVITransactionInputSchema, data);
+        const nestedData = this.transformUpdateToNested(validated);
+        const response = await this.execute(() => this.trpc.transactions.update.mutate({ id, data: nestedData }));
+        return this.instantiate(response);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // List & Pagination
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Lists AVI transactions with optional filtering.
+     *
+     * Accepts flattened AVI filter (future AVI-specific transaction 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.transactions.list.query({
+            ...options,
+            filter: scopedFilter,
+            sort: scopedSort,
+        }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    /**
+     * Iterates over AVI transactions.
+     *
+     * Accepts flattened AVI filter (future AVI-specific transaction fields at root level).
+     */
+    iterate(filter) {
+        const scopedFilter = this.applyScopeToFilter(filter);
+        return this.createIterator({ filter: scopedFilter });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Client Relationship Management (scoped returns)
+    // ─────────────────────────────────────────────────────────────────
+    async listByClient(clientId, options) {
+        const response = await this.execute(() => this.trpc.transactions.listByClient.query({ clientId, ...options }));
+        return {
+            data: response.data.map((t) => this.instantiate(t)),
+            pagination: response.pagination,
+        };
+    }
+    async linkClient(transactionId, clientId, role) {
+        const response = await this.execute(() => this.trpc.transactions.linkClient.mutate({
+            transactionId,
+            clientId,
+            role,
+        }));
+        return this.instantiate(response);
+    }
+    async unlinkClient(transactionId, clientId) {
+        const response = await this.execute(() => this.trpc.transactions.unlinkClient.mutate({
+            transactionId,
+            clientId,
+        }));
+        return this.instantiate(response);
+    }
+    async setClients(transactionId, clients) {
+        const response = await this.execute(() => this.trpc.transactions.setClients.mutate({
+            transactionId,
+            clients,
+        }));
+        return this.instantiate(response);
+    }
+    async createMany(transactions, options = {}) {
+        const atomic = options.atomic ?? true;
+        const validated = this.validate(z.array(createAVITransactionInputSchema), transactions);
+        const nestedItems = validated.map((t) => this.transformToNested(t));
+        const response = await this.execute(() => this.trpc.transactions.createMany.mutate({ items: nestedItems, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((t) => this.instantiate(t)),
+            };
+        }
+        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: updateAVITransactionInputSchema,
+        });
+        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.transactions.updateMany.mutate({ items: nestedUpdates, atomic }));
+        if (response.atomic) {
+            return {
+                atomic: true,
+                data: response.data.map((t) => this.instantiate(t)),
+            };
+        }
+        else {
+            return {
+                atomic: false,
+                succeeded: response.succeeded.map((item) => ({
+                    index: item.index,
+                    data: this.instantiate(item.data),
+                })),
+                failed: response.failed,
+            };
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms a flattened AVITransactionSort to nested TransactionSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    applyScopeToSort(sort) {
+        if (!sort || sort.length === 0) {
+            return undefined;
+        }
+        return transformSort(sort, aviTransactionFieldMapping);
+    }
+    transformToNested(data) {
+        // Extract AVI-specific fields based on operation type
+        const { amount, currency, timestamp, relatedClientIds, description, externalId, metadata, ...aviFields } = data;
+        // Build base fields (relatedClientIds is required)
+        const baseFields = {
+            amount,
+            currency,
+            timestamp,
+            relatedClientIds,
+        };
+        if (description !== undefined)
+            baseFields.description = description;
+        if (externalId !== undefined)
+            baseFields.externalId = externalId;
+        if (metadata !== undefined)
+            baseFields.metadata = metadata;
+        return {
+            ...baseFields,
+            primaryJurisdiction: Jurisdiction.Mexico,
+            jurisdictions: {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.AVI]: aviFields,
+                    },
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        // Cast to access fields - Zod validation ensures correctness
+        const input = data;
+        const { status, description, externalId, metadata, primaryJurisdiction, ...aviFields } = input;
+        // Build base update fields
+        const result = {};
+        if (status !== undefined)
+            result.status = status;
+        if (description !== undefined)
+            result.description = description;
+        if (externalId !== undefined)
+            result.externalId = externalId;
+        if (metadata !== undefined)
+            result.metadata = metadata;
+        if (primaryJurisdiction !== undefined)
+            result.primaryJurisdiction =
+                primaryJurisdiction;
+        // If AVI fields are present (all-or-nothing), nest them in jurisdictions
+        // Check for operationType as the indicator that AVI data is being updated
+        if (aviFields.operationType !== undefined) {
+            result.jurisdictions = {
+                MX: {
+                    actividadVulnerable: {
+                        [CodigoActividad.AVI]: aviFields,
+                    },
+                },
+            };
+        }
+        return result;
+    }
+    instantiate(data) {
+        return new MexAVITransaction(data);
+    }
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Actividad Vulnerable Scoped Resources
+ */
+export * from "./avi";
+export * from "./jys";
+export * from "./tsc";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/resources/mex/actividad-vulnerable/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,OAAO,CAAC;AAGtB,cAAc,OAAO,CAAC;AAGtB,cAAc,OAAO,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Actividad Vulnerable Scoped Resources
+ */
+// AVI (Activos Virtuales)
+export * from "./avi";
+// JYS (Juegos y Sorteos)
+export * from "./jys";
+// TSC (Tarjetas de Servicio y Crédito)
+export * from "./tsc";

package/dist/resources/mex/actividad-vulnerable/jys/clients.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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 type { CreateClientInput, UpdateClientInput, ListOptions, PaginatedResponse, CreateJYSClientInput, UpdateJYSClientInput, AtomicBatchResult, PartialBatchResult, ClientRelationshipType, LinkedClient as LinkedClientInput, CreateMexAddressInput, UpdateMexAddressInput, CreateContactMethodInput, UpdateContactMethodInput, CreateBankAccountInput, UpdateBankAccountInput, SyncItem, SyncResult, JYSClientFilter, JYSClientSort } from "@artu-ai/shared";
+import type { ClientSort } from "@artu-ai/shared";
+import { MexClientsResource } from "../../clients";
+import { type ClientIncludeMap } from "../../../clients";
+import { MexJYSClient, MexAddress, MexBankAccount, ContactMethod, LinkedClient, type ClientData } from "../../../../models";
+/**
+ * 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 declare class JYSClientsResource extends MexClientsResource<JYSClientSort> {
+    create(data: CreateJYSClientInput): Promise<MexJYSClient>;
+    retrieve(id: string, include?: ClientIncludeMap): Promise<MexJYSClient>;
+    retrieveByExternalId(externalId: string): Promise<MexJYSClient>;
+    update(id: string, data: UpdateJYSClientInput): Promise<MexJYSClient>;
+    /**
+     * 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.
+     */
+    list(options?: ListOptions<JYSClientFilter, JYSClientSort> & {
+        includePrimaryContacts?: boolean;
+    }): Promise<PaginatedResponse<MexJYSClient>>;
+    /**
+     * 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>;
+    createMany(clients: CreateJYSClientInput[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexJYSClient>>;
+    createMany(clients: CreateJYSClientInput[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexJYSClient>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateJYSClientInput;
+    }[], options?: {
+        atomic?: true;
+    }): Promise<AtomicBatchResult<MexJYSClient>>;
+    updateMany(updates: {
+        id: string;
+        data: UpdateJYSClientInput;
+    }[], options: {
+        atomic: false;
+    }): Promise<PartialBatchResult<MexJYSClient>>;
+    linkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType, metadata?: Record<string, unknown>): Promise<MexJYSClient>;
+    unlinkClient(parentClientId: string, childClientId: string, relationshipType: ClientRelationshipType): Promise<MexJYSClient>;
+    listLinkedClients(parentClientId: string, relationshipType?: ClientRelationshipType): Promise<LinkedClient[]>;
+    setLinkedClients(parentClientId: string, linkedClients: LinkedClientInput[]): Promise<MexJYSClient>;
+    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>;
+    }>;
+    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>;
+    }>;
+    /**
+     * Transforms a flattened JYSClientSort to nested ClientSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    protected applyScopeToSort(sort?: JYSClientSort): ClientSort | undefined;
+    /**
+     * Transforms JYS input to nested API format.
+     * JYS has no additional fields, but we add the JYS activity marker.
+     */
+    protected transformToNested(data: CreateJYSClientInput): CreateClientInput;
+    protected transformUpdateToNested(data: UpdateJYSClientInput): UpdateClientInput;
+    protected instantiate(data: ClientData): MexJYSClient;
+}
+//# sourceMappingURL=clients.d.ts.map

package/dist/resources/mex/actividad-vulnerable/jys/clients.d.ts.map

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

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

@@ -0,0 +1,231 @@
+/**
+ * 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 { CodigoActividad, createJYSClientInputSchema, updateJYSClientInputSchema, linkedClientSchema, transformSort, jysClientFieldMapping, } from "@artu-ai/shared";
+import { MexClientsResource } from "../../clients";
+import { MexJYSClient, } 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 {
+    // ─────────────────────────────────────────────────────────────────
+    // CRUD Operations
+    // ─────────────────────────────────────────────────────────────────
+    async create(data) {
+        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, include) {
+        const response = await this.execute(() => this.trpc.clients.retrieve.query({ id, include }));
+        return this.instantiate(response);
+    }
+    async retrieveByExternalId(externalId) {
+        const response = await this.execute(() => this.trpc.clients.retrieveByExternalId.query({ externalId }));
+        return this.instantiate(response);
+    }
+    async update(id, data) {
+        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) {
+        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) {
+        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(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, options = {}) {
+        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, 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 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,
+        }, options);
+        // Re-instantiate client with JYS-specific model
+        return {
+            ...result,
+            client: this.instantiate(result.client),
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Protected Helpers
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Transforms a flattened JYSClientSort to nested ClientSort format.
+     *
+     * Maps flattened field names to their full API paths.
+     */
+    applyScopeToSort(sort) {
+        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.
+     */
+    transformToNested(data) {
+        // Use parent transform for base + MX fields (cast needed for discriminated union)
+        const nested = super.transformToNested(data);
+        // Add JYS activity marker (parent always provides jurisdictions.MX)
+        const mexData = nested.jurisdictions?.MX;
+        return {
+            ...nested,
+            jurisdictions: {
+                MX: {
+                    ...mexData,
+                    actividadVulnerable: {
+                        [CodigoActividad.JYS]: {},
+                    },
+                },
+            },
+        };
+    }
+    transformUpdateToNested(data) {
+        return super.transformUpdateToNested(data);
+    }
+    instantiate(data) {
+        return new MexJYSClient(data);
+    }
+}

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

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

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

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

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