@juanito_boop/w-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,300 @@
+import { z } from 'zod';
+export declare const ClientOptionsDef: {
+    schema: z.ZodObject<{
+        baseUrl: z.ZodURL;
+        apiKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    type: {
+        baseUrl: string;
+        apiKey?: string | undefined;
+    };
+};
+export type ClientOptions = typeof ClientOptionsDef.type;
+export type HttpClient = {
+    post<T>(path: string, body: unknown): Promise<T>;
+};
+export type Result<T, E = ApiError> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+export declare const ApiErrorDef: {
+    schema: z.ZodObject<{
+        message: z.ZodString;
+        code: z.ZodOptional<z.ZodString>;
+        statusCode: z.ZodOptional<z.ZodNumber>;
+        details: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>;
+    type: {
+        message: string;
+        code?: string | undefined;
+        statusCode?: number | undefined;
+        details?: unknown;
+    };
+};
+export type ApiError = typeof ApiErrorDef.type;
+export declare const LoginDataDef: {
+    schema: z.ZodObject<{
+        email: z.ZodEmail;
+        password: z.ZodString;
+    }, z.core.$strip>;
+    type: {
+        email: string;
+        password: string;
+    };
+};
+export type LoginData = typeof LoginDataDef.type;
+export declare const RegisterDataDef: {
+    schema: z.ZodObject<{
+        email: z.ZodEmail;
+        password: z.ZodString;
+        fullName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    type: {
+        email: string;
+        password: string;
+        fullName?: string | undefined;
+    };
+};
+export type RegisterData = typeof RegisterDataDef.type;
+export declare const MagicLinkRequestDataDef: {
+    schema: z.ZodObject<{
+        email: z.ZodEmail;
+        redirectUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    type: {
+        email: string;
+        redirectUrl?: string | undefined;
+    };
+};
+export type MagicLinkRequestData = typeof MagicLinkRequestDataDef.type;
+export declare const AuthResponseDef: {
+    schema: z.ZodObject<{
+        token: z.ZodString;
+        user: z.ZodObject<{
+            id: z.ZodUUID;
+            email: z.ZodEmail;
+            fullName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        apiKey: z.ZodOptional<z.ZodObject<{
+            id: z.ZodUUID;
+            key: z.ZodString;
+            name: z.ZodString;
+            expiresAt: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    type: {
+        token: string;
+        user: {
+            id: string;
+            email: string;
+            fullName?: string | undefined;
+        };
+        apiKey?: {
+            id: string;
+            key: string;
+            name: string;
+            expiresAt: string;
+        } | undefined;
+    };
+};
+export type AuthResponse = typeof AuthResponseDef.type;
+export declare const RealtimeOptionsDef: {
+    schema: z.ZodObject<{
+        baseUrl: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    type: {
+        baseUrl: string;
+        apiKey?: string | undefined;
+    };
+};
+export type RealtimeOptions = typeof RealtimeOptionsDef.type;
+export declare const WineDataDef: {
+    schema: z.ZodObject<{
+        id: z.ZodOptional<z.ZodUUID>;
+    }, z.core.$strict>;
+    type: {
+        id?: string | undefined;
+    };
+};
+export type WineData = typeof WineDataDef.type;
+export declare const WineDetailsDef: {
+    schema: z.ZodObject<{
+        id_detalle: z.ZodOptional<z.ZodUUID>;
+        id_vino: z.ZodOptional<z.ZodUUID>;
+        notas_cata: z.ZodString;
+        tipo_crianza: z.ZodString;
+        bodega: z.ZodString;
+    }, z.core.$strip>;
+    type: {
+        notas_cata: string;
+        tipo_crianza: string;
+        bodega: string;
+        id_detalle?: string | undefined;
+        id_vino?: string | undefined;
+    };
+};
+export type WineDetails = typeof WineDetailsDef.type;
+export declare const WineDef: {
+    schema: z.ZodObject<{
+        id_vino: z.ZodUUID;
+        nombre: z.ZodString;
+        precio: z.ZodNumber;
+        url_imagen: z.ZodString;
+        descripcion: z.ZodString;
+        nivel_alcohol: z.ZodNumber;
+        variedades: z.ZodArray<z.ZodString>;
+        pais_importacion: z.ZodString;
+        color_vino: z.ZodString;
+        stock: z.ZodNumber;
+        capacidad: z.ZodNumber;
+        is_deleted: z.ZodDefault<z.ZodBoolean>;
+        wine_details: z.ZodObject<{
+            id_detalle: z.ZodOptional<z.ZodUUID>;
+            id_vino: z.ZodOptional<z.ZodUUID>;
+            notas_cata: z.ZodString;
+            tipo_crianza: z.ZodString;
+            bodega: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    type: {
+        id_vino: string;
+        nombre: string;
+        precio: number;
+        url_imagen: string;
+        descripcion: string;
+        nivel_alcohol: number;
+        variedades: string[];
+        pais_importacion: string;
+        color_vino: string;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        wine_details: {
+            notas_cata: string;
+            tipo_crianza: string;
+            bodega: string;
+            id_detalle?: string | undefined;
+            id_vino?: string | undefined;
+        };
+    };
+};
+export type Wine = typeof WineDef.type;
+export declare const EditWineDef: {
+    schema: z.ZodObject<{
+        nombre: z.ZodOptional<z.ZodString>;
+        precio: z.ZodOptional<z.ZodNumber>;
+        url_imagen: z.ZodOptional<z.ZodString>;
+        descripcion: z.ZodOptional<z.ZodString>;
+        nivel_alcohol: z.ZodOptional<z.ZodNumber>;
+        variedades: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pais_importacion: z.ZodOptional<z.ZodString>;
+        color_vino: z.ZodOptional<z.ZodString>;
+        stock: z.ZodOptional<z.ZodNumber>;
+        capacidad: z.ZodOptional<z.ZodNumber>;
+        is_deleted: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        id_vino: z.ZodUUID;
+        wine_details: z.ZodOptional<z.ZodObject<{
+            id_detalle: z.ZodOptional<z.ZodOptional<z.ZodUUID>>;
+            id_vino: z.ZodOptional<z.ZodOptional<z.ZodUUID>>;
+            notas_cata: z.ZodOptional<z.ZodString>;
+            tipo_crianza: z.ZodOptional<z.ZodString>;
+            bodega: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+    type: {
+        id_vino: string;
+        nombre?: string | undefined;
+        precio?: number | undefined;
+        url_imagen?: string | undefined;
+        descripcion?: string | undefined;
+        nivel_alcohol?: number | undefined;
+        variedades?: string[] | undefined;
+        pais_importacion?: string | undefined;
+        color_vino?: string | undefined;
+        stock?: number | undefined;
+        capacidad?: number | undefined;
+        is_deleted?: boolean | undefined;
+        wine_details?: {
+            id_detalle?: string | undefined;
+            id_vino?: string | undefined;
+            notas_cata?: string | undefined;
+            tipo_crianza?: string | undefined;
+            bodega?: string | undefined;
+        } | undefined;
+    };
+};
+export type EditWine = typeof EditWineDef.type;
+export declare const CreateWineDef: {
+    schema: z.ZodObject<{
+        nombre: z.ZodString;
+        precio: z.ZodNumber;
+        url_imagen: z.ZodOptional<z.ZodString>;
+        descripcion: z.ZodOptional<z.ZodString>;
+        nivel_alcohol: z.ZodDefault<z.ZodNumber>;
+        variedades: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pais_importacion: z.ZodOptional<z.ZodString>;
+        color_vino: z.ZodOptional<z.ZodString>;
+        stock: z.ZodDefault<z.ZodNumber>;
+        capacidad: z.ZodDefault<z.ZodNumber>;
+        is_deleted: z.ZodDefault<z.ZodBoolean>;
+        notas_cata: z.ZodOptional<z.ZodString>;
+        tipo_crianza: z.ZodOptional<z.ZodString>;
+        bodega: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    type: {
+        nombre: string;
+        precio: number;
+        nivel_alcohol: number;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        url_imagen?: string | undefined;
+        descripcion?: string | undefined;
+        variedades?: string[] | undefined;
+        pais_importacion?: string | undefined;
+        color_vino?: string | undefined;
+        notas_cata?: string | undefined;
+        tipo_crianza?: string | undefined;
+        bodega?: string | undefined;
+    };
+};
+export type CreateWine = typeof CreateWineDef.type;
+export declare const BulkInsertWinesDef: {
+    schema: z.ZodArray<z.ZodObject<{
+        nombre: z.ZodString;
+        precio: z.ZodNumber;
+        url_imagen: z.ZodOptional<z.ZodString>;
+        descripcion: z.ZodOptional<z.ZodString>;
+        nivel_alcohol: z.ZodDefault<z.ZodNumber>;
+        variedades: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pais_importacion: z.ZodOptional<z.ZodString>;
+        color_vino: z.ZodOptional<z.ZodString>;
+        stock: z.ZodDefault<z.ZodNumber>;
+        capacidad: z.ZodDefault<z.ZodNumber>;
+        is_deleted: z.ZodDefault<z.ZodBoolean>;
+        notas_cata: z.ZodOptional<z.ZodString>;
+        tipo_crianza: z.ZodOptional<z.ZodString>;
+        bodega: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    type: {
+        nombre: string;
+        precio: number;
+        nivel_alcohol: number;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        url_imagen?: string | undefined;
+        descripcion?: string | undefined;
+        variedades?: string[] | undefined;
+        pais_importacion?: string | undefined;
+        color_vino?: string | undefined;
+        notas_cata?: string | undefined;
+        tipo_crianza?: string | undefined;
+        bodega?: string | undefined;
+    }[];
+};
+export type BulkInsertWines = typeof BulkInsertWinesDef.type;

package/dist/types.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { defineSchema } from './types/_helpers';
+/* ============================================================================
+ * Core / Client
+ * ========================================================================== */
+export const ClientOptionsDef = defineSchema(z.object({
+    baseUrl: z.url('baseUrl debe ser una URL válida'),
+    apiKey: z.string().optional(),
+}));
+export const ApiErrorDef = defineSchema(z.object({
+    message: z.string(),
+    code: z.string().optional(),
+    statusCode: z.number().optional(),
+    details: z.unknown().optional(),
+}));
+/* ============================================================================
+ * Auth
+ * ========================================================================== */
+export const LoginDataDef = defineSchema(z.object({
+    email: z.email('Email inválido'),
+    password: z.string().min(1, 'Password es requerido'),
+}));
+export const RegisterDataDef = defineSchema(z.object({
+    email: z.email('Email inválido'),
+    password: z.string().min(6, 'Password debe tener al menos 6 caracteres'),
+    fullName: z.string().optional(),
+}));
+export const MagicLinkRequestDataDef = defineSchema(z.object({
+    email: z.email('Email inválido'),
+    redirectUrl: z.string().url().optional(),
+}));
+export const AuthResponseDef = defineSchema(z.object({
+    token: z.string(),
+    user: z.object({
+        id: z.uuid(),
+        email: z.email(),
+        fullName: z.string().optional(),
+    }),
+    apiKey: z.object({
+        id: z.uuid(),
+        key: z.string(),
+        name: z.string(),
+        expiresAt: z.string().datetime(),
+    }).optional(),
+}));
+/* ============================================================================
+ * Realtime
+ * ========================================================================== */
+export const RealtimeOptionsDef = defineSchema(z.object({
+    baseUrl: z.string().url(),
+    apiKey: z.string().optional(),
+}));
+/* ============================================================================
+ * Wine – Base
+ * ========================================================================== */
+export const WineDataDef = defineSchema(z.object({
+    id: z.uuid().optional(),
+}).strict());
+/* ============================================================================
+ * Wine – Details
+ * ========================================================================== */
+export const WineDetailsDef = defineSchema(z.object({
+    id_detalle: z.uuid().optional(),
+    id_vino: z.uuid().optional(),
+    notas_cata: z.string(),
+    tipo_crianza: z.string(),
+    bodega: z.string(),
+}));
+/* ============================================================================
+ * Wine – Read
+ * ========================================================================== */
+export const WineDef = defineSchema(z.object({
+    id_vino: z.uuid(),
+    nombre: z.string(),
+    precio: z.number().int(),
+    url_imagen: z.string(),
+    descripcion: z.string(),
+    nivel_alcohol: z.number(),
+    variedades: z.array(z.string()),
+    pais_importacion: z.string(),
+    color_vino: z.string(),
+    stock: z.number().int(),
+    capacidad: z.number().int(),
+    is_deleted: z.boolean().default(false),
+    wine_details: WineDetailsDef.schema,
+}));
+/* ============================================================================
+ * Wine – Update
+ * ========================================================================== */
+export const EditWineDef = defineSchema(WineDef.schema
+    .omit({ wine_details: true })
+    .partial()
+    .extend({
+    id_vino: z.uuid(),
+    wine_details: WineDetailsDef.schema.partial().optional(),
+})
+    .strict());
+/* ============================================================================
+ * Wine – Create
+ * ========================================================================== */
+export const CreateWineDef = defineSchema(z.object({
+    nombre: z.string().min(1, 'El campo "nombre" es obligatorio'),
+    precio: z.number().int().positive('El precio debe ser positivo'),
+    url_imagen: z.string().optional(),
+    descripcion: z.string().optional(),
+    nivel_alcohol: z.number().default(0),
+    variedades: z.array(z.string()).optional(),
+    pais_importacion: z.string().optional(),
+    color_vino: z.string().optional(),
+    stock: z.number().int().default(0),
+    capacidad: z.number().int().default(750),
+    is_deleted: z.boolean().default(false),
+    notas_cata: z.string().optional(),
+    tipo_crianza: z.string().optional(),
+    bodega: z.string().optional(),
+}));
+/* ============================================================================
+ * Wine – Bulk
+ * ========================================================================== */
+export const BulkInsertWinesDef = defineSchema(z.array(CreateWineDef.schema));

package/dist/ws/realtime.d.ts

@@ -0,0 +1,90 @@
+import type { Result, CreateWine, EditWine, RealtimeOptions } from '../types';
+export declare function createRealtime(opts: RealtimeOptions): {
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    setApiKey: (key?: string) => void;
+    getWines: () => Promise<Result<{
+        id_vino: string;
+        nombre: string;
+        precio: number;
+        url_imagen: string;
+        descripcion: string;
+        nivel_alcohol: number;
+        variedades: string[];
+        pais_importacion: string;
+        color_vino: string;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        wine_details: {
+            notas_cata: string;
+            tipo_crianza: string;
+            bodega: string;
+            id_detalle?: string | undefined;
+            id_vino?: string | undefined;
+        };
+    }[]>>;
+    insertWine: (data: CreateWine) => Promise<Result<{
+        id_vino: string;
+        nombre: string;
+        precio: number;
+        url_imagen: string;
+        descripcion: string;
+        nivel_alcohol: number;
+        variedades: string[];
+        pais_importacion: string;
+        color_vino: string;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        wine_details: {
+            notas_cata: string;
+            tipo_crianza: string;
+            bodega: string;
+            id_detalle?: string | undefined;
+            id_vino?: string | undefined;
+        };
+    }>>;
+    insertBulkWines: (data: CreateWine[]) => Promise<Result<{
+        id_vino: string;
+        nombre: string;
+        precio: number;
+        url_imagen: string;
+        descripcion: string;
+        nivel_alcohol: number;
+        variedades: string[];
+        pais_importacion: string;
+        color_vino: string;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        wine_details: {
+            notas_cata: string;
+            tipo_crianza: string;
+            bodega: string;
+            id_detalle?: string | undefined;
+            id_vino?: string | undefined;
+        };
+    }[]>>;
+    editWine: (data: EditWine) => Promise<Result<{
+        id_vino: string;
+        nombre: string;
+        precio: number;
+        url_imagen: string;
+        descripcion: string;
+        nivel_alcohol: number;
+        variedades: string[];
+        pais_importacion: string;
+        color_vino: string;
+        stock: number;
+        capacidad: number;
+        is_deleted: boolean;
+        wine_details: {
+            notas_cata: string;
+            tipo_crianza: string;
+            bodega: string;
+            id_detalle?: string | undefined;
+            id_vino?: string | undefined;
+        };
+    }>>;
+};

package/dist/ws/realtime.js

@@ -0,0 +1,103 @@
+import { io } from 'socket.io-client';
+export function createRealtime(opts) {
+    let socket = null;
+    let apiKey = opts.apiKey;
+    function connect() {
+        return new Promise((resolve, reject) => {
+            if (socket?.connected) {
+                resolve();
+                return;
+            }
+            const auth = apiKey ? { apiKey } : undefined;
+            const extraHeaders = apiKey ? { 'x-api-key': apiKey } : undefined;
+            socket = io(opts.baseUrl, {
+                path: '/ws',
+                transports: ['websocket', 'polling'],
+                auth,
+                extraHeaders,
+            });
+            const handleConnect = () => {
+                socket?.off('connect', handleConnect);
+                socket?.off('connect_error', handleError);
+                resolve();
+            };
+            const handleError = (error) => {
+                socket?.off('connect', handleConnect);
+                socket?.off('connect_error', handleError);
+                reject(error);
+            };
+            socket.on('connect', handleConnect);
+            socket.on('connect_error', handleError);
+            // Timeout de seguridad
+            const timeoutId = setTimeout(() => {
+                socket?.off('connect', handleConnect);
+                socket?.off('connect_error', handleError);
+                reject(new Error('Connection timeout'));
+            }, 5000);
+            // Limpiar timeout cuando se resuelva
+            Promise.resolve().then(() => {
+                clearTimeout(timeoutId);
+            });
+        });
+    }
+    function disconnect() {
+        socket?.disconnect();
+        socket = null;
+    }
+    function setApiKey(key) {
+        apiKey = key;
+        if (socket) {
+            disconnect();
+            connect();
+        }
+    }
+    function emitAck(event, payload) {
+        if (!socket) {
+            return Promise.resolve({
+                success: false,
+                error: {
+                    message: 'Socket no conectado',
+                    code: 'SOCKET_NOT_CONNECTED',
+                },
+            });
+        }
+        return new Promise((resolve) => {
+            socket
+                .timeout(10000)
+                .emit(event, payload, (err, res) => {
+                if (err) {
+                    resolve({
+                        success: false,
+                        error: {
+                            message: err.message ?? 'Socket error',
+                            code: err.code ?? 'SOCKET_ERROR',
+                            details: err,
+                        },
+                    });
+                    return;
+                }
+                if (res?.error) {
+                    resolve({
+                        success: false,
+                        error: {
+                            message: res.error.message,
+                            code: res.error.code,
+                            details: res.error,
+                        },
+                    });
+                    return;
+                }
+                resolve({ success: true, data: res });
+            });
+        });
+    }
+    return {
+        connect,
+        disconnect,
+        setApiKey,
+        getWines: () => emitAck('get_wines', undefined),
+        insertWine: (data) => emitAck('insert_wine', data),
+        insertBulkWines: (data) => emitAck('insert_bulk_wines', data),
+        editWine: (data) => emitAck('edit_wine', data),
+    };
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@juanito_boop/w-sdk",
+  "version": "0.1.0",
+  "description": "SDK oficial para la API de juanito_boop",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --watch --format esm,cjs --dts",
+    "lint": "eslint .",
+    "test": "jest --runInBand --detectOpenHandles",
+    "release": "npm publish --access public"
+  },
+  "keywords": [
+    "sdk",
+    "api",
+    "nestjs",
+    "rest"
+  ],
+  "author": "juanito_boop",
+  "license": "MIT",
+  "dependencies": {
+    "socket.io-client": "^4.7.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  }
+}