@jogolabs/billing-sdk-v2 0.0.1

package/dist/billing/src/__generated__/services/CardsService.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardsService = void 0;
+class CardsService {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    /**
+     * Tokenizar y guardar una tarjeta
+     * Envía los datos de la tarjeta al proveedor de pago configurado para el negocio, obtiene un token seguro y lo guarda asociado al cliente autenticado. Los datos de la tarjeta **nunca se almacenan** en la base de datos de este servicio.
+     *
+     * @returns SavedCard Tarjeta tokenizada y guardada exitosamente
+     * @throws ApiError
+     */
+    postApiV1CardsTokenize({ requestBody, }) {
+        return this.httpRequest.request({
+            method: 'POST',
+            url: '/api/v1/cards/tokenize',
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                400: `Datos de tarjeta inválidos`,
+                401: `Token JWT ausente o inválido`,
+            },
+        });
+    }
+    /**
+     * Listar tarjetas guardadas del cliente
+     * Retorna las tarjetas tokenizadas del cliente autenticado para un negocio específico.
+     * @returns SavedCard Lista de tarjetas guardadas
+     * @throws ApiError
+     */
+    getApiV1Cards({ merchantId, }) {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/api/v1/cards',
+            query: {
+                'merchantId': merchantId,
+            },
+            errors: {
+                400: `merchantId requerido`,
+                401: `Token JWT ausente o inválido`,
+            },
+        });
+    }
+    /**
+     * Establecer tarjeta predeterminada
+     * Marca una tarjeta como predeterminada para renovaciones automáticas. Solo puede haber una tarjeta predeterminada por cliente + negocio.
+     *
+     * @returns any Tarjeta predeterminada actualizada
+     * @throws ApiError
+     */
+    patchApiV1CardsDefault({ id, requestBody, }) {
+        return this.httpRequest.request({
+            method: 'PATCH',
+            url: '/api/v1/cards/{id}/default',
+            path: {
+                'id': id,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                404: `Tarjeta no encontrada`,
+            },
+        });
+    }
+    /**
+     * Eliminar tarjeta guardada
+     * Desactiva la tarjeta guardada (no se elimina físicamente de la base de datos).
+     * @returns void
+     * @throws ApiError
+     */
+    deleteApiV1Cards({ id, }) {
+        return this.httpRequest.request({
+            method: 'DELETE',
+            url: '/api/v1/cards/{id}',
+            path: {
+                'id': id,
+            },
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                403: `La tarjeta no pertenece al cliente`,
+            },
+        });
+    }
+}
+exports.CardsService = CardsService;

package/dist/billing/src/__generated__/services/HealthService.d.ts

@@ -0,0 +1,16 @@
+import type { CancelablePromise } from '../core/CancelablePromise';
+import type { BaseHttpRequest } from '../core/BaseHttpRequest';
+export declare class HealthService {
+    readonly httpRequest: BaseHttpRequest;
+    constructor(httpRequest: BaseHttpRequest);
+    /**
+     * Health check
+     * Verifica que el servicio está funcionando correctamente.
+     * @returns any Servicio en línea
+     * @throws ApiError
+     */
+    getHealth(): CancelablePromise<{
+        status?: string;
+        service?: string;
+    }>;
+}

package/dist/billing/src/__generated__/services/HealthService.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthService = void 0;
+class HealthService {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    /**
+     * Health check
+     * Verifica que el servicio está funcionando correctamente.
+     * @returns any Servicio en línea
+     * @throws ApiError
+     */
+    getHealth() {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/health',
+        });
+    }
+}
+exports.HealthService = HealthService;

package/dist/billing/src/__generated__/services/MerchantsService.d.ts

@@ -0,0 +1,43 @@
+import type { CreateMerchantRequest } from '../models/CreateMerchantRequest';
+import type { Merchant } from '../models/Merchant';
+import type { UpdateMerchantRequest } from '../models/UpdateMerchantRequest';
+import type { CancelablePromise } from '../core/CancelablePromise';
+import type { BaseHttpRequest } from '../core/BaseHttpRequest';
+export declare class MerchantsService {
+    readonly httpRequest: BaseHttpRequest;
+    constructor(httpRequest: BaseHttpRequest);
+    /**
+     * Registrar negocio con proveedor de pago
+     * Registra un negocio y su configuración de proveedor de pago (Wompi). La API Key se encripta con AES-256 antes de guardarse en la base de datos.
+     *
+     * @returns Merchant Negocio registrado exitosamente
+     * @throws ApiError
+     */
+    postApiV1Merchants({ requestBody, }: {
+        requestBody: CreateMerchantRequest;
+    }): CancelablePromise<Merchant>;
+    /**
+     * Obtener negocio por businessId
+     * Retorna la configuración del negocio sin incluir la API Key del proveedor de pago.
+     *
+     * @returns Merchant Configuración del negocio (sin API Key)
+     * @throws ApiError
+     */
+    getApiV1MerchantsBusiness({ businessId, }: {
+        /**
+         * ID del negocio en jogo-backend
+         */
+        businessId: string;
+    }): CancelablePromise<Merchant>;
+    /**
+     * Actualizar configuración del negocio
+     * Actualiza los datos del negocio. Si se envía `apiKey`, se re-encripta antes de guardarse.
+     *
+     * @returns Merchant Negocio actualizado
+     * @throws ApiError
+     */
+    putApiV1MerchantsBusiness({ businessId, requestBody, }: {
+        businessId: string;
+        requestBody: UpdateMerchantRequest;
+    }): CancelablePromise<Merchant>;
+}

package/dist/billing/src/__generated__/services/MerchantsService.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MerchantsService = void 0;
+class MerchantsService {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    /**
+     * Registrar negocio con proveedor de pago
+     * Registra un negocio y su configuración de proveedor de pago (Wompi). La API Key se encripta con AES-256 antes de guardarse en la base de datos.
+     *
+     * @returns Merchant Negocio registrado exitosamente
+     * @throws ApiError
+     */
+    postApiV1Merchants({ requestBody, }) {
+        return this.httpRequest.request({
+            method: 'POST',
+            url: '/api/v1/merchants',
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `No autorizado`,
+                409: `El negocio ya está registrado`,
+            },
+        });
+    }
+    /**
+     * Obtener negocio por businessId
+     * Retorna la configuración del negocio sin incluir la API Key del proveedor de pago.
+     *
+     * @returns Merchant Configuración del negocio (sin API Key)
+     * @throws ApiError
+     */
+    getApiV1MerchantsBusiness({ businessId, }) {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/api/v1/merchants/business/{businessId}',
+            path: {
+                'businessId': businessId,
+            },
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                404: `Negocio no encontrado`,
+            },
+        });
+    }
+    /**
+     * Actualizar configuración del negocio
+     * Actualiza los datos del negocio. Si se envía `apiKey`, se re-encripta antes de guardarse.
+     *
+     * @returns Merchant Negocio actualizado
+     * @throws ApiError
+     */
+    putApiV1MerchantsBusiness({ businessId, requestBody, }) {
+        return this.httpRequest.request({
+            method: 'PUT',
+            url: '/api/v1/merchants/business/{businessId}',
+            path: {
+                'businessId': businessId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                404: `Negocio no encontrado`,
+            },
+        });
+    }
+}
+exports.MerchantsService = MerchantsService;

package/dist/billing/src/__generated__/services/PackagesService.d.ts

@@ -0,0 +1,66 @@
+import type { CreatePackageRequest } from '../models/CreatePackageRequest';
+import type { Package } from '../models/Package';
+import type { UpdatePackageRequest } from '../models/UpdatePackageRequest';
+import type { CancelablePromise } from '../core/CancelablePromise';
+import type { BaseHttpRequest } from '../core/BaseHttpRequest';
+export declare class PackagesService {
+    readonly httpRequest: BaseHttpRequest;
+    constructor(httpRequest: BaseHttpRequest);
+    /**
+     * Crear paquete de clases
+     * Crea un nuevo paquete de clases para el negocio especificado.
+     * @returns Package Paquete creado
+     * @throws ApiError
+     */
+    postApiV1MerchantsPackages({ merchantId, requestBody, }: {
+        /**
+         * ID del merchant en este servicio
+         */
+        merchantId: string;
+        requestBody: CreatePackageRequest;
+    }): CancelablePromise<Package>;
+    /**
+     * Listar paquetes del negocio
+     * Retorna los paquetes de clases disponibles para un negocio. Por defecto solo retorna los activos. Usa `?all=true` para incluir inactivos.
+     *
+     * @returns Package Lista de paquetes
+     * @throws ApiError
+     */
+    getApiV1MerchantsPackages({ merchantId, all, }: {
+        merchantId: string;
+        /**
+         * Si es `true`, incluye paquetes inactivos
+         */
+        all?: 'true' | 'false';
+    }): CancelablePromise<Array<Package>>;
+    /**
+     * Obtener paquete por ID
+     * @returns Package Detalle del paquete
+     * @throws ApiError
+     */
+    getApiV1MerchantsPackages1({ merchantId, id, }: {
+        merchantId: string;
+        id: string;
+    }): CancelablePromise<Package>;
+    /**
+     * Actualizar paquete
+     * @returns Package Paquete actualizado
+     * @throws ApiError
+     */
+    putApiV1MerchantsPackages({ merchantId, id, requestBody, }: {
+        merchantId: string;
+        id: string;
+        requestBody: UpdatePackageRequest;
+    }): CancelablePromise<Package>;
+    /**
+     * Desactivar paquete
+     * Desactiva el paquete (no lo elimina físicamente). Las suscripciones existentes no se ven afectadas.
+     *
+     * @returns Package Paquete desactivado
+     * @throws ApiError
+     */
+    deleteApiV1MerchantsPackages({ merchantId, id, }: {
+        merchantId: string;
+        id: string;
+    }): CancelablePromise<Package>;
+}

package/dist/billing/src/__generated__/services/PackagesService.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackagesService = void 0;
+class PackagesService {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    /**
+     * Crear paquete de clases
+     * Crea un nuevo paquete de clases para el negocio especificado.
+     * @returns Package Paquete creado
+     * @throws ApiError
+     */
+    postApiV1MerchantsPackages({ merchantId, requestBody, }) {
+        return this.httpRequest.request({
+            method: 'POST',
+            url: '/api/v1/merchants/{merchantId}/packages',
+            path: {
+                'merchantId': merchantId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `Token JWT ausente o inválido`,
+            },
+        });
+    }
+    /**
+     * Listar paquetes del negocio
+     * Retorna los paquetes de clases disponibles para un negocio. Por defecto solo retorna los activos. Usa `?all=true` para incluir inactivos.
+     *
+     * @returns Package Lista de paquetes
+     * @throws ApiError
+     */
+    getApiV1MerchantsPackages({ merchantId, all, }) {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/api/v1/merchants/{merchantId}/packages',
+            path: {
+                'merchantId': merchantId,
+            },
+            query: {
+                'all': all,
+            },
+        });
+    }
+    /**
+     * Obtener paquete por ID
+     * @returns Package Detalle del paquete
+     * @throws ApiError
+     */
+    getApiV1MerchantsPackages1({ merchantId, id, }) {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/api/v1/merchants/{merchantId}/packages/{id}',
+            path: {
+                'merchantId': merchantId,
+                'id': id,
+            },
+            errors: {
+                404: `Paquete no encontrado`,
+            },
+        });
+    }
+    /**
+     * Actualizar paquete
+     * @returns Package Paquete actualizado
+     * @throws ApiError
+     */
+    putApiV1MerchantsPackages({ merchantId, id, requestBody, }) {
+        return this.httpRequest.request({
+            method: 'PUT',
+            url: '/api/v1/merchants/{merchantId}/packages/{id}',
+            path: {
+                'merchantId': merchantId,
+                'id': id,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                403: `El paquete no pertenece a este negocio`,
+                404: `Paquete no encontrado`,
+            },
+        });
+    }
+    /**
+     * Desactivar paquete
+     * Desactiva el paquete (no lo elimina físicamente). Las suscripciones existentes no se ven afectadas.
+     *
+     * @returns Package Paquete desactivado
+     * @throws ApiError
+     */
+    deleteApiV1MerchantsPackages({ merchantId, id, }) {
+        return this.httpRequest.request({
+            method: 'DELETE',
+            url: '/api/v1/merchants/{merchantId}/packages/{id}',
+            path: {
+                'merchantId': merchantId,
+                'id': id,
+            },
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                403: `Forbidden`,
+            },
+        });
+    }
+}
+exports.PackagesService = PackagesService;

package/dist/billing/src/__generated__/services/PaymentsService.d.ts

@@ -0,0 +1,53 @@
+import type { Payment } from '../models/Payment';
+import type { CancelablePromise } from '../core/CancelablePromise';
+import type { BaseHttpRequest } from '../core/BaseHttpRequest';
+export declare class PaymentsService {
+    readonly httpRequest: BaseHttpRequest;
+    constructor(httpRequest: BaseHttpRequest);
+    /**
+     * Webhook de notificación de Wompi
+     * Endpoint que Wompi llama para notificar el resultado de una transacción. **No requiere autenticación** — es invocado directamente por Wompi.
+     * Al recibir un pago completado (`APROBADA`), activa automáticamente la suscripción asociada.
+     * Configurar esta URL en el `webhookUrl` del merchant: `POST https://tu-servidor.com/api/v1/webhooks/{merchantId}`
+     *
+     * @returns any Webhook recibido y procesado
+     * @throws ApiError
+     */
+    postApiV1Webhooks({ merchantId, requestBody, }: {
+        /**
+         * ID del merchant en este servicio (no el businessId de jogo-backend)
+         */
+        merchantId: string;
+        requestBody: {
+            /**
+             * ID de la transacción en Wompi
+             */
+            idTransaccion?: string;
+            monto?: number;
+            estado?: 'APROBADA' | 'RECHAZADA' | 'PENDIENTE' | 'ERROR';
+            /**
+             * Metadata enviada al crear la transacción
+             */
+            datosAdicionales?: Record<string, any>;
+        };
+    }): CancelablePromise<{
+        received?: boolean;
+    }>;
+    /**
+     * Detalle de un pago
+     * @returns Payment Detalle del pago incluyendo respuesta del proveedor
+     * @throws ApiError
+     */
+    getApiV1Payments({ id, }: {
+        id: string;
+    }): CancelablePromise<Payment>;
+    /**
+     * Historial de pagos de una suscripción
+     * Retorna todos los pagos realizados para una suscripción específica, ordenados por fecha descendente.
+     * @returns Payment Historial de pagos
+     * @throws ApiError
+     */
+    getApiV1PaymentsSubscription({ subscriptionId, }: {
+        subscriptionId: string;
+    }): CancelablePromise<Array<Payment>>;
+}

package/dist/billing/src/__generated__/services/PaymentsService.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentsService = void 0;
+class PaymentsService {
+    httpRequest;
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    /**
+     * Webhook de notificación de Wompi
+     * Endpoint que Wompi llama para notificar el resultado de una transacción. **No requiere autenticación** — es invocado directamente por Wompi.
+     * Al recibir un pago completado (`APROBADA`), activa automáticamente la suscripción asociada.
+     * Configurar esta URL en el `webhookUrl` del merchant: `POST https://tu-servidor.com/api/v1/webhooks/{merchantId}`
+     *
+     * @returns any Webhook recibido y procesado
+     * @throws ApiError
+     */
+    postApiV1Webhooks({ merchantId, requestBody, }) {
+        return this.httpRequest.request({
+            method: 'POST',
+            url: '/api/v1/webhooks/{merchantId}',
+            path: {
+                'merchantId': merchantId,
+            },
+            body: requestBody,
+            mediaType: 'application/json',
+        });
+    }
+    /**
+     * Detalle de un pago
+     * @returns Payment Detalle del pago incluyendo respuesta del proveedor
+     * @throws ApiError
+     */
+    getApiV1Payments({ id, }) {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/api/v1/payments/{id}',
+            path: {
+                'id': id,
+            },
+            errors: {
+                401: `Token JWT ausente o inválido`,
+                404: `Pago no encontrado`,
+            },
+        });
+    }
+    /**
+     * Historial de pagos de una suscripción
+     * Retorna todos los pagos realizados para una suscripción específica, ordenados por fecha descendente.
+     * @returns Payment Historial de pagos
+     * @throws ApiError
+     */
+    getApiV1PaymentsSubscription({ subscriptionId, }) {
+        return this.httpRequest.request({
+            method: 'GET',
+            url: '/api/v1/payments/subscription/{subscriptionId}',
+            path: {
+                'subscriptionId': subscriptionId,
+            },
+            errors: {
+                401: `Token JWT ausente o inválido`,
+            },
+        });
+    }
+}
+exports.PaymentsService = PaymentsService;

package/dist/billing/src/__generated__/services/SubscriptionsService.d.ts

@@ -0,0 +1,86 @@
+import type { ConsumeClassResponse } from '../models/ConsumeClassResponse';
+import type { CreateSubscriptionRequest } from '../models/CreateSubscriptionRequest';
+import type { CreateSubscriptionResponse } from '../models/CreateSubscriptionResponse';
+import type { Subscription } from '../models/Subscription';
+import type { CancelablePromise } from '../core/CancelablePromise';
+import type { BaseHttpRequest } from '../core/BaseHttpRequest';
+export declare class SubscriptionsService {
+    readonly httpRequest: BaseHttpRequest;
+    constructor(httpRequest: BaseHttpRequest);
+    /**
+     * Crear y pagar una suscripción
+     * Crea una suscripción para el cliente autenticado y ejecuta el cobro al proveedor de pago configurado para el negocio.
+     * **Flujo con tarjeta guardada (recomendado para renovaciones):** Enviar `savedCardId` + `cvv`. Si el pago completa de inmediato, retorna `201` con la suscripción activa.
+     * **Flujo con tarjeta nueva (3DS):** Enviar datos de tarjeta directamente. Wompi puede requerir autenticación 3DS, en cuyo caso retorna `202` con un `redirectUrl`. Redirigir al cliente a esa URL. La suscripción se activará automáticamente cuando Wompi envíe el webhook de confirmación.
+     *
+     * @returns CreateSubscriptionResponse Suscripción creada y activa (pago completado sin 3DS)
+     * @throws ApiError
+     */
+    postApiV1Subscriptions({ requestBody, }: {
+        requestBody: CreateSubscriptionRequest;
+    }): CancelablePromise<CreateSubscriptionResponse>;
+    /**
+     * Mis suscripciones
+     * Retorna todas las suscripciones del cliente autenticado.
+     * @returns Subscription Lista de suscripciones del cliente
+     * @throws ApiError
+     */
+    getApiV1SubscriptionsMe(): CancelablePromise<Array<Subscription>>;
+    /**
+     * Suscripciones de un cliente (admin)
+     * Retorna las suscripciones de un cliente específico. Uso interno/admin — el negocio puede consultar el estado de sus clientes.
+     *
+     * @returns Subscription Lista de suscripciones
+     * @throws ApiError
+     */
+    getApiV1SubscriptionsCustomer({ customerId, }: {
+        /**
+         * ID del cliente en jogo-backend
+         */
+        customerId: string;
+    }): CancelablePromise<Array<Subscription>>;
+    /**
+     * Detalle de una suscripción
+     * @returns Subscription Detalle de la suscripción con info del paquete populada
+     * @throws ApiError
+     */
+    getApiV1Subscriptions({ id, }: {
+        id: string;
+    }): CancelablePromise<Subscription>;
+    /**
+     * Registrar uso de una clase
+     * Descuenta una clase del saldo disponible en la suscripción. Solo aplica a suscripciones en estado `active` con clases restantes.
+     *
+     * @returns ConsumeClassResponse Clase registrada exitosamente
+     * @throws ApiError
+     */
+    postApiV1SubscriptionsConsume({ id, }: {
+        id: string;
+    }): CancelablePromise<ConsumeClassResponse>;
+    /**
+     * Cancelar suscripción
+     * Cancela la suscripción y desactiva la renovación automática. El cliente mantiene acceso hasta la fecha de vencimiento.
+     *
+     * @returns Subscription Suscripción cancelada
+     * @throws ApiError
+     */
+    postApiV1SubscriptionsCancel({ id, }: {
+        id: string;
+    }): CancelablePromise<Subscription>;
+    /**
+     * Renovar suscripción manualmente
+     * Renueva una suscripción usando la tarjeta guardada previamente. Requiere CVV por cumplimiento PCI. Si el pago requiere 3DS, retorna `redirectUrl` para completar la autenticación.
+     *
+     * @returns CreateSubscriptionResponse Suscripción renovada
+     * @throws ApiError
+     */
+    postApiV1SubscriptionsRenew({ id, requestBody, }: {
+        id: string;
+        requestBody: {
+            /**
+             * CVV de la tarjeta guardada
+             */
+            cvv: string;
+        };
+    }): CancelablePromise<CreateSubscriptionResponse>;
+}