@juanito_boop/w-sdk 0.1.0

package/README.md

@@ -0,0 +1,126 @@
+# @juanito_boop/w-sdk
+
+SDK oficial para la API de TuOrg.
+
+## Instalacion
+
+```bash
+npm install @juanito_boop/w-sdk
+```
+
+## Uso rapido
+
+```ts
+import { createClient } from "@juanito_boop/w-sdk";
+
+const client = createClient({
+  baseUrl: "https://api.tuorg.com",
+  apiKey: "TU_API_KEY",
+});
+
+// Auth
+const login = await client.auth.login({
+  email: "user@tuorg.com",
+  password: "secret",
+});
+
+if (!login.success) {
+  console.error(login.error);
+} else {
+  console.log(login.data.token);
+}
+
+// Realtime
+const wines = await client.realtime.getWines();
+console.log(wines);
+```
+
+## API
+
+### Client
+
+```ts
+createClient(options: ClientOptions): WineClient
+getClient(options?: ClientOptions): WineClient
+```
+
+`ClientOptions`
+
+- `baseUrl` (string, requerido) URL base de la API.
+- `apiKey` (string, opcional) API key para endpoints privados.
+
+### Auth
+
+```ts
+client.auth.login(data: LoginData): Promise<Result<AuthResponse>>
+client.auth.register(data: RegisterData): Promise<Result<AuthResponse>>
+client.auth.requestMagicLink(data: MagicLinkRequestData): Promise<Result<unknown>>
+```
+
+### Realtime (WebSocket)
+
+```ts
+client.realtime.setApiKey(apiKey?: string): void
+client.realtime.getWines(): Promise<Result<any[]>>
+client.realtime.insertWine(data: unknown): Promise<Result<unknown>>
+client.realtime.editWine(data: unknown): Promise<Result<unknown>>
+```
+
+## Tipos y schemas
+
+Todos los tipos y schemas Zod estan exportados desde el paquete.
+
+```ts
+import {
+  type Result,
+  type ApiError,
+  type ClientOptions,
+  type LoginData,
+  type RegisterData,
+  type MagicLinkRequestData,
+  type AuthResponse,
+  type RealtimeOptions,
+  type Wine,
+  type WineDetails,
+  type WineData,
+  type CreateWine,
+  type EditWine,
+  type BulkInsertWines,
+  ClientOptionsSchema,
+  ApiErrorSchema,
+  LoginDataSchema,
+  RegisterDataSchema,
+  MagicLinkRequestDataSchema,
+  AuthResponseSchema,
+  RealtimeOptionsSchema,
+  WineSchema,
+  WineDetailsSchema,
+  WineDataSchema,
+  CreateWineSchema,
+  EditWineSchema,
+  BulkInsertWinesSchema,
+} from "@juanito_boop/w-sdk";
+```
+
+## Requisitos
+
+- Node.js 18+ (usa `fetch` nativo). En Node 16, agrega un polyfill de `fetch`.
+
+## Scripts
+
+```bash
+npm run build
+npm run dev
+npm run lint
+npm run release
+```
+
+## Publicar en npm
+
+1. Asegura el build: `npm run build`.
+2. Inicia sesion: `npm login`.
+3. Publica: `npm publish --access public`.
+
+## Licencia
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,218 @@
+import type { ClientOptions } from './types';
+export declare class WineClient {
+    readonly auth: {
+        login: (data: import("./types").LoginData) => Promise<import("./types").Result<{
+            token: string;
+            user: {
+                id: string;
+                email: string;
+                fullName?: string | undefined;
+            };
+            apiKey?: {
+                id: string;
+                key: string;
+                name: string;
+                expiresAt: string;
+            } | undefined;
+        }>>;
+        register: (data: import("./types").RegisterData) => Promise<import("./types").Result<{
+            token: string;
+            user: {
+                id: string;
+                email: string;
+                fullName?: string | undefined;
+            };
+            apiKey?: {
+                id: string;
+                key: string;
+                name: string;
+                expiresAt: string;
+            } | undefined;
+        }>>;
+        requestMagicLink: (data: import("./types").MagicLinkRequestData) => Promise<import("./types").Result<unknown>>;
+    };
+    readonly realtime: {
+        connect: () => Promise<void>;
+        disconnect: () => void;
+        setApiKey: (key?: string) => void;
+        getWines: () => Promise<import("./types").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: import("./types").CreateWine) => Promise<import("./types").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: import("./types").CreateWine[]) => Promise<import("./types").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: import("./types").EditWine) => Promise<import("./types").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;
+            };
+        }>>;
+    };
+    private apiKey?;
+    private readonly baseUrl;
+    constructor(options: ClientOptions);
+    setApiKey(apiKey?: string): void;
+    connectRealtime(): Promise<{
+        connect: () => Promise<void>;
+        disconnect: () => void;
+        setApiKey: (key?: string) => void;
+        getWines: () => Promise<import("./types").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: import("./types").CreateWine) => Promise<import("./types").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: import("./types").CreateWine[]) => Promise<import("./types").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: import("./types").EditWine) => Promise<import("./types").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;
+            };
+        }>>;
+    }>;
+    disconnectRealtime(): void;
+}
+export declare function createClient(options: ClientOptions): WineClient;

package/dist/client.js

@@ -0,0 +1,33 @@
+import { createAuthHttp } from './http/auth';
+import { createRealtime } from './ws/realtime';
+export class WineClient {
+    constructor(options) {
+        if (!options.baseUrl) {
+            throw new Error('baseUrl es requerido');
+        }
+        this.baseUrl = options.baseUrl;
+        this.apiKey = options.apiKey;
+        this.auth = createAuthHttp({
+            baseUrl: this.baseUrl,
+            apiKey: this.apiKey,
+        });
+        this.realtime = createRealtime({
+            baseUrl: this.baseUrl,
+            apiKey: this.apiKey,
+        });
+    }
+    setApiKey(apiKey) {
+        this.apiKey = apiKey;
+        this.realtime.setApiKey(apiKey);
+    }
+    async connectRealtime() {
+        await this.realtime.connect();
+        return this.realtime;
+    }
+    disconnectRealtime() {
+        this.realtime.disconnect();
+    }
+}
+export function createClient(options) {
+    return new WineClient(options);
+}

package/dist/http/auth.d.ts

@@ -0,0 +1,38 @@
+import type { LoginData, RegisterData, MagicLinkRequestData, Result } from '../types';
+type AuthHttpOptions = {
+    baseUrl: string;
+    apiKey?: string;
+    fetch?: typeof fetch;
+};
+export declare function createAuthHttp(opts: AuthHttpOptions): {
+    login: (data: LoginData) => Promise<Result<{
+        token: string;
+        user: {
+            id: string;
+            email: string;
+            fullName?: string | undefined;
+        };
+        apiKey?: {
+            id: string;
+            key: string;
+            name: string;
+            expiresAt: string;
+        } | undefined;
+    }>>;
+    register: (data: RegisterData) => Promise<Result<{
+        token: string;
+        user: {
+            id: string;
+            email: string;
+            fullName?: string | undefined;
+        };
+        apiKey?: {
+            id: string;
+            key: string;
+            name: string;
+            expiresAt: string;
+        } | undefined;
+    }>>;
+    requestMagicLink: (data: MagicLinkRequestData) => Promise<Result<unknown>>;
+};
+export {};

package/dist/http/auth.js

@@ -0,0 +1,42 @@
+export function createAuthHttp(opts) {
+    const fetcher = opts.fetch ?? globalThis.fetch;
+    async function post(path, body) {
+        try {
+            const res = await fetcher(`${opts.baseUrl}${path}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(opts.apiKey ? { 'x-api-key': opts.apiKey } : {}),
+                },
+                body: JSON.stringify(body),
+            });
+            const json = await res.json().catch(() => null);
+            if (!res.ok) {
+                return {
+                    success: false,
+                    error: {
+                        message: json?.message ?? res.statusText,
+                        code: json?.code,
+                        statusCode: res.status,
+                        details: json,
+                    },
+                };
+            }
+            return { success: true, data: json };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: {
+                    message: err instanceof Error ? err.message : 'Network error',
+                    code: 'NETWORK_ERROR',
+                },
+            };
+        }
+    }
+    return {
+        login: (data) => post('/auth/login', data),
+        register: (data) => post('/auth/register', data),
+        requestMagicLink: (data) => post('/auth/magic-link/request', data)
+    };
+}