@dypai-ai/client-sdk 0.0.1

package/README.md

@@ -0,0 +1,5 @@
+# @dypai-ai/client-sdk
+
+Cliente JavaScript para Dypai Engine.
+
+Contacta al equipo de desarrollo para más información.

package/README.md.backup

@@ -0,0 +1,5 @@
+# @dypai-ai/client-sdk
+
+Cliente JavaScript para Dypai Engine.
+
+Contacta al equipo de desarrollo para más información.

package/dist/index.d.ts

@@ -0,0 +1,958 @@
+/**
+ * Tipos para el paquete @dypai/client-sdk
+ */
+type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+interface ApiOptions {
+    token: string;
+    apiKey?: string;
+    body?: any;
+    params?: Record<string, any>;
+    showToasts?: boolean;
+}
+interface ApiContextType {
+    token: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+interface SupportedStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+interface AuthClientOptions {
+    storage?: SupportedStorage;
+    storageKey?: string;
+    autoRefreshToken?: boolean;
+    persistSession?: boolean;
+}
+/**
+ * Error estandarizado de Dypai.
+ * Permite manejar errores de forma consistente (ej: if (error.status === 401))
+ */
+declare class DypaiError extends Error {
+    status: number;
+    code?: string | undefined;
+    details?: any | undefined;
+    constructor(message: string, status?: number, code?: string | undefined, details?: any | undefined);
+}
+/**
+ * Respuesta estandarizada del SDK (Estilo Supabase)
+ * @typeParam T - Tipo de los datos en caso de éxito
+ */
+type DypaiResponse<T> = {
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: DypaiError;
+};
+/**
+ * Configuración global para el cliente API.
+ */
+interface GlobalClientOptions {
+    /**
+     * Implementación personalizada de fetch.
+     * Útil para Node.js, tests, o para mockear peticiones.
+     */
+    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    /**
+     * Headers globales que se enviarán en todas las peticiones.
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Define la estructura de un endpoint tipado.
+ * Usado para inferir tipos de request/response automáticamente.
+ */
+interface EndpointDefinition {
+    /** Tipo de respuesta del endpoint */
+    response?: unknown;
+    /** Tipo del body para POST/PUT/PATCH */
+    body?: unknown;
+    /** Tipo de los query params */
+    params?: Record<string, unknown>;
+}
+/**
+ * Mapa de endpoints tipados.
+ * El usuario define su API así:
+ *
+ * @example
+ * ```typescript
+ * interface MyApi extends EndpointMap {
+ *   'get-pacientes': { response: Paciente[], params: { active?: boolean } };
+ *   'create-cita': { body: CitaInput, response: Cita };
+ *   'update-paciente': { body: Partial<Paciente>, response: Paciente, params: { id: string } };
+ * }
+ * ```
+ */
+interface EndpointMap {
+    [endpoint: string]: EndpointDefinition;
+}
+/**
+ * Extrae el tipo de respuesta de un endpoint
+ */
+type EndpointResponse<TMap extends EndpointMap, TEndpoint extends keyof TMap> = TMap[TEndpoint] extends {
+    response: infer R;
+} ? R : any;
+/**
+ * Extrae el tipo del body de un endpoint
+ */
+type EndpointBody<TMap extends EndpointMap, TEndpoint extends keyof TMap> = TMap[TEndpoint] extends {
+    body: infer B;
+} ? B : any;
+/**
+ * Extrae el tipo de los params de un endpoint
+ */
+type EndpointParams<TMap extends EndpointMap, TEndpoint extends keyof TMap> = TMap[TEndpoint] extends {
+    params: infer P;
+} ? P : Record<string, any>;
+/**
+ * Opciones para llamadas GET tipadas
+ */
+interface TypedGetOptions<TParams> {
+    params?: TParams;
+    showToasts?: boolean;
+}
+/**
+ * Opciones para llamadas POST/PUT/PATCH tipadas
+ */
+interface TypedMutationOptions<TParams> {
+    params?: TParams;
+    showToasts?: boolean;
+}
+/**
+ * Cliente API tipado con inferencia de tipos para endpoints.
+ * Permite autocompletado para endpoints conocidos, pero acepta strings arbitrarios (fallback a any).
+ */
+interface TypedApiClient<TMap extends EndpointMap = EndpointMap> {
+    /**
+     * GET request tipado
+     */
+    get<TEndpoint extends (keyof TMap & string) | (string & {})>(endpoint: TEndpoint, options?: TypedGetOptions<TEndpoint extends keyof TMap ? EndpointParams<TMap, TEndpoint> : Record<string, any>>): Promise<TEndpoint extends keyof TMap ? EndpointResponse<TMap, TEndpoint> : any>;
+    /**
+     * POST request tipado
+     */
+    post<TEndpoint extends (keyof TMap & string) | (string & {})>(endpoint: TEndpoint, body: TEndpoint extends keyof TMap ? EndpointBody<TMap, TEndpoint> : any, options?: TypedMutationOptions<TEndpoint extends keyof TMap ? EndpointParams<TMap, TEndpoint> : Record<string, any>>): Promise<TEndpoint extends keyof TMap ? EndpointResponse<TMap, TEndpoint> : any>;
+    /**
+     * PUT request tipado
+     */
+    put<TEndpoint extends (keyof TMap & string) | (string & {})>(endpoint: TEndpoint, body: TEndpoint extends keyof TMap ? EndpointBody<TMap, TEndpoint> : any, options?: TypedMutationOptions<TEndpoint extends keyof TMap ? EndpointParams<TMap, TEndpoint> : Record<string, any>>): Promise<TEndpoint extends keyof TMap ? EndpointResponse<TMap, TEndpoint> : any>;
+    /**
+     * PATCH request tipado
+     */
+    patch<TEndpoint extends (keyof TMap & string) | (string & {})>(endpoint: TEndpoint, body?: TEndpoint extends keyof TMap ? Partial<EndpointBody<TMap, TEndpoint>> : any, options?: TypedMutationOptions<TEndpoint extends keyof TMap ? EndpointParams<TMap, TEndpoint> : Record<string, any>>): Promise<TEndpoint extends keyof TMap ? EndpointResponse<TMap, TEndpoint> : any>;
+    /**
+     * DELETE request tipado
+     */
+    delete<TEndpoint extends (keyof TMap & string) | (string & {})>(endpoint: TEndpoint, options?: TypedGetOptions<TEndpoint extends keyof TMap ? EndpointParams<TMap, TEndpoint> : Record<string, any>>): Promise<TEndpoint extends keyof TMap ? EndpointResponse<TMap, TEndpoint> : any>;
+}
+/**
+ * Tipo para el cliente API sin tipado (legacy/fallback)
+ */
+interface ApiClient {
+    get: (endpoint: string, options?: {
+        params?: Record<string, any>;
+        [key: string]: any;
+    }) => Promise<any>;
+    post: (endpoint: string, body: any, options?: {
+        params?: Record<string, any>;
+        [key: string]: any;
+    }) => Promise<any>;
+    put: (endpoint: string, body: any, options?: {
+        params?: Record<string, any>;
+        [key: string]: any;
+    }) => Promise<any>;
+    patch: (endpoint: string, body?: any, options?: {
+        params?: Record<string, any>;
+        [key: string]: any;
+    }) => Promise<any>;
+    delete: (endpoint: string, options?: {
+        params?: Record<string, any>;
+        [key: string]: any;
+    }) => Promise<any>;
+}
+interface AppConfig {
+    DYPAI_API_URL: string;
+    DYPAI_API_KEY?: string;
+    VITE_DYPAI_DEV_USERNAME?: string;
+    VITE_DYPAI_DEV_PASSWORD?: string;
+    [key: string]: any;
+}
+interface UserData {
+    token: string;
+    userId: string;
+    username: string;
+    email: string;
+}
+interface AppData {
+    config: AppConfig;
+    userData: UserData;
+}
+interface ToastFunction {
+    (props: {
+        title?: string;
+        description?: string;
+        variant?: 'default' | 'success' | 'error' | 'warning' | 'info';
+    }): void;
+}
+interface ApiServiceConfig {
+    toast?: ToastFunction;
+    showToasts?: boolean;
+    onUnauthorized?: () => void;
+    onTokenExpired?: () => Promise<string | null>;
+}
+
+declare class DataModule<TDatabase = any> {
+    private api;
+    constructor(api: ApiClient);
+    /**
+     * Inicia una operación sobre una tabla/colección específica.
+     * En el backend esto mapea a /api/v0/{table}
+     * @param table Nombre de la tabla o workflow
+     */
+    from<TTableName extends keyof TDatabase & string>(table: TTableName): QueryBuilder;
+}
+declare class QueryBuilder {
+    private table;
+    private api;
+    constructor(table: string, api: ApiClient);
+    select(filters?: Record<string, any>): Promise<any>;
+    insert(data: Record<string, any>): Promise<any>;
+    update(id: string | number, data: Record<string, any>): Promise<any>;
+    delete(id: string | number): Promise<any>;
+}
+
+interface AppRole {
+    name: string;
+    weight: number;
+    description?: string;
+}
+interface User {
+    id: string;
+    email: string;
+    name?: string;
+    username?: string;
+    role?: string;
+    _role_details?: AppRole;
+    _app_context?: {
+        app_id: string;
+    };
+    created_at?: string;
+    updated_at?: string;
+    app_metadata?: any;
+    user_metadata?: any;
+    [key: string]: any;
+}
+interface AppUserResponse {
+    user: User;
+    role: AppRole;
+    app_id: string;
+}
+interface AuthResponse {
+    user: User;
+    token: string;
+    refreshToken?: string;
+    expiresIn?: number;
+    expiresAt?: number;
+}
+interface LoginCredentials {
+    email?: string;
+    phone?: string;
+    identifier?: string;
+    password: string;
+}
+interface RegisterData {
+    email?: string;
+    phone?: string;
+    password: string;
+    user_data?: Record<string, any>;
+    [key: string]: any;
+}
+interface OAuthOptions {
+    redirectTo?: string;
+    scopes?: string[];
+}
+interface JoinResponse {
+    message: string;
+    joined: boolean;
+}
+interface PasswordRecoveryRequest {
+    email: string;
+}
+interface PasswordResetRequest {
+    password: string;
+}
+interface ResetPasswordWithTokenRequest {
+    token: string;
+    password: string;
+}
+interface PasswordRecoveryResponse {
+    message: string;
+}
+interface PasswordResetResponse {
+    message: string;
+}
+interface OTPRequest {
+    email?: string;
+    phone?: string;
+    create_user?: boolean;
+    data?: Record<string, any>;
+}
+interface VerifyOTPRequest {
+    email?: string;
+    phone?: string;
+    token: string;
+    type?: 'sms' | 'signup' | 'magiclink' | 'recovery' | 'invite';
+}
+interface UpdateUserAttributes {
+    email?: string;
+    password?: string;
+    data?: Record<string, any>;
+}
+/**
+ * Sesión de autenticación (similar a Supabase)
+ */
+interface Session {
+    access_token: string;
+    refresh_token?: string;
+    expires_in?: number;
+    expires_at?: number;
+    token_type?: string;
+    user: User;
+}
+type AuthChangeEvent = 'SIGNED_IN' | 'SIGNED_OUT' | 'USER_UPDATED' | 'TOKEN_REFRESHED' | 'INITIAL_SESSION' | 'PASSWORD_RECOVERY';
+/**
+ * Respuesta de getSession (similar a Supabase)
+ */
+interface SessionResponse {
+    data: {
+        session: Session | null;
+    };
+    error: Error | null;
+}
+
+type AuthListener = (event: AuthChangeEvent, session: Session | null) => void;
+declare class AuthModule {
+    private config;
+    private _user;
+    private _token;
+    private _refreshToken;
+    private _expiresAt;
+    private _listeners;
+    private _refreshTimeout;
+    private readonly STORAGE_KEY;
+    private storage;
+    private _sessionRecovered;
+    constructor(config: {
+        baseUrl?: string;
+        apiKey?: string;
+    } & AuthClientOptions, _apiClient?: ApiClient | null);
+    private _handleVisibilityChange;
+    private deriveStorageKey;
+    get user(): User | null;
+    get token(): string | null;
+    onAuthStateChange(listener: AuthListener): {
+        data: {
+            subscription: {
+                unsubscribe: () => void;
+            };
+        };
+    };
+    /**
+     * Login con email y contraseña
+     */
+    signInWithPassword(credentials: LoginCredentials): Promise<DypaiResponse<AuthResponse>>;
+    /** Alias para signInWithPassword */
+    login(credentials: LoginCredentials): Promise<DypaiResponse<AuthResponse>>;
+    /**
+     * Registro de nuevo usuario
+     */
+    signUp(data: RegisterData): Promise<DypaiResponse<AuthResponse>>;
+    /** Alias para signUp */
+    register(data: RegisterData): Promise<DypaiResponse<AuthResponse>>;
+    /**
+     * Obtiene la sesión actual
+     */
+    getSession(): Promise<DypaiResponse<Session | null>>;
+    /**
+     * Obtiene los datos del usuario actual desde el servidor
+     */
+    getUser(): Promise<DypaiResponse<User>>;
+    /** Alias para getUser */
+    me(): Promise<DypaiResponse<User>>;
+    /**
+     * Inicia sesión con OAuth
+     */
+    signInWithOAuth(provider: 'google' | 'github', options?: OAuthOptions): Promise<DypaiResponse<void>>;
+    /**
+     * Cierra la sesión
+     */
+    signOut(): Promise<DypaiResponse<void>>;
+    /** Alias para signOut */
+    logout(): Promise<DypaiResponse<void>>;
+    /**
+     * Solicita recuperación de contraseña
+     */
+    resetPasswordForEmail(email: string): Promise<DypaiResponse<PasswordRecoveryResponse>>;
+    /** Alias para resetPasswordForEmail */
+    recoverPassword(data: PasswordRecoveryRequest): Promise<DypaiResponse<PasswordRecoveryResponse>>;
+    /**
+     * Refresca la sesión actual utilizando el refresh token.
+     */
+    refreshSession(): Promise<DypaiResponse<AuthResponse>>;
+    /**
+     * Envía un código OTP (One Time Password) al email o teléfono indicado.
+     * Utilizado para login sin contraseña (Magic Link o SMS OTP).
+     */
+    signInWithOtp(credentials: OTPRequest): Promise<DypaiResponse<any>>;
+    /**
+     * Verifica un código OTP enviado por email o teléfono.
+     * Si es válido, inicia la sesión del usuario.
+     */
+    verifyOtp(params: VerifyOTPRequest): Promise<DypaiResponse<AuthResponse>>;
+    /**
+     * Actualiza los datos del usuario actual (email, contraseña o metadatos).
+     * Requiere que el usuario esté autenticado.
+     */
+    updateUser(attributes: UpdateUserAttributes): Promise<DypaiResponse<User>>;
+    /**
+     * Programa un refresco de sesión automático antes de que el token caduque.
+     */
+    private _scheduleRefresh;
+    private _normalizeUser;
+    private _handleAuthResponse;
+    private _updateUser;
+    private _clearSession;
+    private _recoverSession;
+    private _getSessionObject;
+    private _notifyListeners;
+    handleSessionExpired(): void;
+}
+
+interface CreateUserRequest {
+    email: string;
+    password: string;
+    email_confirm?: boolean;
+    user_metadata?: Record<string, any>;
+    app_metadata?: Record<string, any>;
+}
+interface UpdateUserRequest {
+    email?: string;
+    password?: string;
+    email_confirm?: boolean;
+    user_metadata?: Record<string, any>;
+    app_metadata?: Record<string, any>;
+}
+interface UserListResponse {
+    users: User[];
+    aud: string;
+}
+
+/**
+ * Módulo para gestión administrativa de usuarios
+ */
+declare class UsersModule {
+    private api;
+    constructor(api: ApiClient);
+    /**
+     * Obtiene la lista de usuarios de la aplicación.
+     * Requiere rol de admin.
+     */
+    list(params?: {
+        page?: number;
+        per_page?: number;
+    }): Promise<DypaiResponse<UserListResponse>>;
+    /**
+     * Crea un nuevo usuario en la aplicación.
+     */
+    create(data: CreateUserRequest): Promise<DypaiResponse<User>>;
+    /**
+     * Actualiza un usuario existente.
+     */
+    update(userId: string, data: UpdateUserRequest): Promise<DypaiResponse<User>>;
+    /**
+     * Elimina un usuario.
+     */
+    delete(userId: string): Promise<DypaiResponse<{
+        success: boolean;
+    }>>;
+}
+
+/**
+ * Tipos para el módulo de Storage
+ */
+interface UploadOptions {
+    path?: string;
+    onProgress?: (percent: number) => void;
+    params?: Record<string, any>;
+    uploadEndpoint?: string;
+    confirmEndpoint?: string;
+    contentType?: string;
+    cacheControl?: string;
+    metadata?: Record<string, string>;
+}
+interface DownloadOptions {
+    fileName?: string;
+    method?: 'GET' | 'POST';
+    params?: Record<string, any>;
+    downloadEndpoint?: string;
+}
+interface SignedUrlOptions {
+    expiresIn?: number;
+    params?: Record<string, any>;
+    endpoint?: string;
+}
+interface ListOptions {
+    prefix?: string;
+    limit?: number;
+    offset?: number;
+    sortBy?: 'name' | 'created_at' | 'updated_at' | 'last_accessed_at';
+    order?: 'asc' | 'desc';
+    search?: string;
+    params?: Record<string, any>;
+    endpoint?: string;
+}
+interface UploadResponse {
+    files: Array<{
+        file_name: string;
+        file_path: string;
+        size_bytes: number;
+        content_type: string;
+        public_url?: string;
+        id?: string;
+    }>;
+    bucket: string;
+}
+interface SignedUrlResponse {
+    signedUrl: string;
+    expiresIn: number;
+    path: string;
+}
+interface StorageObject {
+    id: string;
+    name: string;
+    path: string;
+    size: number;
+    mime_type?: string;
+    created_at: string;
+    updated_at: string;
+    last_accessed_at?: string;
+    metadata?: Record<string, any>;
+}
+interface ListResponse {
+    data: StorageObject[];
+    total?: number;
+    hasMore?: boolean;
+}
+
+/**
+ * Módulo de Storage (Almacenamiento)
+ *
+ * Proporciona una API tipo Supabase para gestionar archivos.
+ * Internamente usa Smart Storage con workflows del Engine.
+ */
+declare class StorageModule {
+    private api;
+    constructor(api: ApiClient);
+    /**
+     * Selecciona un bucket para operaciones
+     * @param bucketName Nombre del bucket
+     * @returns Builder para operaciones en el bucket
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await dypai.storage
+     *   .from('imagenes')
+     *   .upload('avatar.jpg', file);
+     * ```
+     */
+    from(bucketName: string): StorageBucketBuilder;
+}
+/**
+ * Builder para operaciones en un bucket específico
+ */
+declare class StorageBucketBuilder {
+    private bucketName;
+    private api;
+    constructor(bucketName: string, api: ApiClient);
+    /**
+     * Sube un archivo al bucket
+     *
+     * @param path Path donde guardar el archivo (ej: 'carpeta/archivo.jpg')
+     * @param file Archivo a subir
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * const file = document.getElementById('input').files[0];
+     * const { data, error } = await dypai.storage
+     *   .from('documentos')
+     *   .upload('facturas/2024/inv-001.pdf', file, {
+     *     onProgress: (pct) => console.log(`${pct}%`)
+     *   });
+     * ```
+     */
+    upload(path: string, file: File, options?: UploadOptions): Promise<DypaiResponse<UploadResponse>>;
+    /**
+     * Descarga un archivo del bucket
+     *
+     * @param path Path del archivo a descargar
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * await dypai.storage
+     *   .from('documentos')
+     *   .download('facturas/2024/inv-001.pdf', {
+     *     fileName: 'factura.pdf'
+     *   });
+     * ```
+     */
+    download(path: string, options?: DownloadOptions): Promise<DypaiResponse<void>>;
+    /**
+     * Obtiene una URL firmada para acceso temporal
+     *
+     * @param path Path del archivo
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await dypai.storage
+     *   .from('documentos')
+     *   .createSignedUrl('facturas/inv-001.pdf', 15);
+     *
+     * if (data) {
+     *   console.log('URL:', data.signedUrl);
+     * }
+     * ```
+     */
+    createSignedUrl(path: string, expiresIn?: number, options?: Omit<SignedUrlOptions, 'expiresIn'>): Promise<DypaiResponse<SignedUrlResponse>>;
+    /**
+     * Obtiene la URL pública de un archivo (solo para buckets públicos)
+     *
+     * @param path Path del archivo
+     *
+     * @example
+     * ```typescript
+     * const { data } = await dypai.storage
+     *   .from('public-images')
+     *   .getPublicUrl('logo.png');
+     *
+     * console.log('URL pública:', data.publicUrl);
+     * ```
+     */
+    getPublicUrl(path: string): {
+        data: {
+            publicUrl: string;
+        };
+    };
+    /**
+     * Lista archivos en el bucket
+     *
+     * @param path Path/carpeta a listar (opcional, lista raíz si no se especifica)
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * const { data, error } = await dypai.storage
+     *   .from('documentos')
+     *   .list('facturas/2024', {
+     *     limit: 20,
+     *     sortBy: 'created_at',
+     *     order: 'desc'
+     *   });
+     *
+     * if (data) {
+     *   data.data.forEach(file => {
+     *     console.log(file.name, file.size);
+     *   });
+     * }
+     * ```
+     */
+    list(path?: string, options?: ListOptions): Promise<DypaiResponse<ListResponse>>;
+    /**
+     * Elimina un archivo del bucket
+     *
+     * @param path Path del archivo a eliminar
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * const { error } = await dypai.storage
+     *   .from('documentos')
+     *   .remove('facturas/2024/inv-001.pdf');
+     *
+     * if (!error) {
+     *   console.log('Archivo eliminado');
+     * }
+     * ```
+     */
+    remove(path: string | string[], options?: {
+        endpoint?: string;
+        params?: Record<string, any>;
+    }): Promise<DypaiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Mueve/renombra un archivo
+     *
+     * @param fromPath Path origen
+     * @param toPath Path destino
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * await dypai.storage
+     *   .from('documentos')
+     *   .move('temp/archivo.pdf', 'final/archivo.pdf');
+     * ```
+     */
+    move(fromPath: string, toPath: string, options?: {
+        endpoint?: string;
+        params?: Record<string, any>;
+    }): Promise<DypaiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Copia un archivo
+     *
+     * @param fromPath Path origen
+     * @param toPath Path destino
+     * @param options Opciones adicionales
+     *
+     * @example
+     * ```typescript
+     * await dypai.storage
+     *   .from('documentos')
+     *   .copy('original.pdf', 'copia.pdf');
+     * ```
+     */
+    copy(fromPath: string, toPath: string, options?: {
+        endpoint?: string;
+        params?: Record<string, any>;
+    }): Promise<DypaiResponse<{
+        success: boolean;
+    }>>;
+}
+
+interface DypaiConfig {
+    /** URL base de la API (ej: 'http://localhost:8000') - Debe apuntar al Gateway unificado */
+    baseUrl: string;
+    /** API Key pública (Anon Key) */
+    apiKey: string;
+    /** Opciones de autenticación */
+    auth?: AuthClientOptions;
+    /** Opciones globales (fetch, headers) */
+    global?: GlobalClientOptions;
+    /** Opcional: ID para aislar localStorage entre múltiples clientes */
+    storageKey?: string;
+}
+/**
+ * Cliente unificado de Dypai.
+ *
+ * @typeParam TDatabase - Estructura de la base de datos (opcional)
+ * @typeParam TApi - Mapa de endpoints tipados (opcional)
+ */
+declare class DypaiClient<TDatabase = any, TApi extends EndpointMap = EndpointMap> {
+    /** Módulo de autenticación */
+    auth: AuthModule;
+    /** Módulo de base de datos (CRUD) */
+    db: DataModule<TDatabase>;
+    /** Módulo de gestión de usuarios (admin) */
+    users: UsersModule;
+    /** Módulo de almacenamiento (Storage) */
+    storage: StorageModule;
+    /** Cliente API tipado para endpoints personalizados */
+    api: TApi extends EndpointMap ? TypedApiClient<TApi> : ApiClient;
+    constructor(config: DypaiConfig);
+    /**
+     * Alias para acceder a datos (estilo Supabase)
+     */
+    from<TTableName extends keyof TDatabase & string>(table: TTableName): QueryBuilder;
+    /**
+     * Obtiene el usuario actual
+     */
+    me(): Promise<DypaiResponse<User>>;
+}
+/**
+ * Crea una instancia del cliente Dypai.
+ * Requiere URL y API Key (modo standalone estilo Supabase).
+ *
+ * @typeParam TDatabase - Estructura de la base de datos (opcional)
+ * @typeParam TApi - Mapa de endpoints tipados (opcional)
+ */
+declare function createClient<TDatabase = any, TApi extends EndpointMap = EndpointMap>(url: string, apiKey: string, options?: Omit<DypaiConfig, 'baseUrl' | 'apiKey'>): DypaiClient<TDatabase, TApi>;
+
+/**
+ * @dypai/client-sdk - Cliente HTTP centralizado
+ *
+ * Gestiona llamadas al Gateway unificado (Auth + Engine).
+ */
+
+type TokenProvider = () => string | null;
+declare function setTokenProvider(provider: TokenProvider): void;
+declare function configureApiService(config: ApiServiceConfig): void;
+declare function callApi(token: string, method: HttpMethod, endpoint: string, body?: any, showToastsOverride?: boolean, params?: Record<string, any>, apiKey?: string, baseUrl?: string): Promise<any>;
+declare function createApiClient(context: ApiContextType | (() => ApiContextType)): ApiClient;
+
+/**
+ * Configuración global para todos los servicios DYPAI
+ *
+ * Este archivo maneja la configuración centralizada para:
+ * - ApiService (API autenticada)
+ */
+
+/**
+ * Configura todos los servicios DYPAI de una vez (recomendado)
+ * Esta es la función principal que deberías usar al inicio de tu aplicación
+ *
+ * @param config Configuración global para todos los servicios
+ * @example
+ * ```typescript
+ * import { configureDypaiServices } from '@dypai/client-sdk';
+ *
+ * configureDypaiServices({
+ *   showToasts: true,
+ *   toast: myCustomToast
+ * });
+ * ```
+ */
+declare function configureDypaiServices(config: ApiServiceConfig): void;
+/**
+ * Obtiene la configuración global actual
+ * @returns Configuración global compartida
+ */
+declare function getGlobalConfig(): ApiServiceConfig;
+/**
+ * Resetea toda la configuración global (útil para testing)
+ */
+declare function resetGlobalConfig(): void;
+/**
+ * Fuerza la recarga de la configuración detectando cambios en variables de entorno
+ * Útil cuando se cambian variables de entorno en tiempo de ejecución
+ *
+ * @example
+ * ```typescript
+ * import { reloadDypaiConfig } from '@dypai/client-sdk';
+ *
+ * // Después de cambiar variables de entorno
+ * await reloadDypaiConfig();
+ * ```
+ */
+declare function reloadDypaiConfig(): Promise<void>;
+
+/**
+ * Hook básico para notificaciones toast en el paquete @dypai/client-sdk
+ *
+ * Este es un hook minimalista que puede ser reemplazado por la implementación
+ * de la aplicación host mediante la configuración del ApiService.
+ */
+
+/**
+ * Configura una función toast personalizada para usar en el paquete
+ * @param toastFn Función toast de la aplicación host
+ */
+declare function setToastFunction(toastFn: ToastFunction): void;
+/**
+ * Hook que retorna la función toast configurada o el fallback
+ */
+declare function useToast(): {
+    toast: ToastFunction;
+    toastSuccess: (title: string, description?: string) => void;
+    toastError: (title: string, description?: string) => void;
+    toastWarning: (title: string, description?: string) => void;
+    toastInfo: (title: string, description?: string) => void;
+};
+/**
+ * Función toast independiente que puede ser usada sin hook
+ */
+declare const toast: (props: Parameters<ToastFunction>[0]) => void;
+declare const toastSuccess: (title: string, description?: string) => void;
+declare const toastError: (title: string, description?: string) => void;
+declare const toastWarning: (title: string, description?: string) => void;
+declare const toastInfo: (title: string, description?: string) => void;
+
+/**
+ * @dypai-ai/client-sdk
+ *
+ * Paquete centralizado para manejo de llamadas API con autenticación DYPAI
+ *
+ * ⚠️ IMPORTANTE: Debes crear el cliente primero (igual que Supabase). No puedes usar el paquete sin crear una instancia del cliente.
+ *
+ * @example Crear el cliente (OBLIGATORIO - Paso 1)
+ * ```typescript
+ * // src/lib/dypai.ts
+ * import { createClient } from '@dypai/client-sdk';
+ *
+ * // Crear el cliente con tu URL y API Key
+ * export const dypai = createClient(
+ *   'https://api.dypai.es',           // URL de la API
+ *   'tu-anon-key-publica'             // API Key pública
+ * );
+ *
+ * // Con variables de entorno (Vite)
+ * export const dypai = createClient(
+ *   import.meta.env.VITE_DYPAI_API_URL,
+ *   import.meta.env.VITE_DYPAI_API_KEY
+ * );
+ * ```
+ *
+ * @example Uso básico con el cliente (Paso 2)
+ * ```typescript
+ * // En cualquier componente o archivo
+ * import { dypai } from '../lib/dypai'; // Tu cliente configurado
+ *
+ * // Autenticación
+ * const { data, error } = await dypai.auth.signInWithPassword({ email: 'user@test.com', password: '123' });
+ *
+ * // Base de Datos (CRUD) con autocompletado
+ * const { data: productos, error: dbError } = await dypai.from('productos').select({ limit: 10 });
+ *
+ * // API personalizada (endpoints)
+ * const facturas = await dypai.api.get('mis_facturas');
+ *
+ * // Storage (Almacenamiento) - Estilo Supabase
+ * const { data, error } = await dypai.storage
+ *   .from('documentos')
+ *   .upload('facturas/2024/inv-001.pdf', file);
+ *
+ * const { data: url } = await dypai.storage
+ *   .from('documentos')
+ *   .getSignedUrl('facturas/2024/inv-001.pdf', { expiresIn: 15 });
+ * ```
+ *
+ * @example Uso avanzado con tipado de Base de Datos y API
+ * ```typescript
+ * // Define tus interfaces
+ * interface Database {
+ *   productos: { id: string; nombre: string; precio: number };
+ * }
+ *
+ * export const dypai = createClient<Database>(url, key);
+ *
+ * // 'productos' tiene autocompletado y el resultado está tipado
+ * const { data } = await dypai.from('productos').select();
+ * ```
+ *
+ * @example Uso con servicios estáticos (Legacy - No recomendado para nuevas apps)
+ * ```typescript
+ * // ⚠️ Solo si usas configuración global
+ * // import { ApiService, FileService } from '@dypai/client-sdk'; // DEPRECATED
+ * // Usa createClient() en su lugar
+ * ```
+ *
+ */
+/**
+ * Nuevo Cliente Unificado DYPAI
+ * Forma recomendada de acceder a toda la funcionalidad (Auth, Data, etc.)
+ */
+
+declare const PACKAGE_INFO: {
+    readonly name: "@dypai-ai/client-sdk";
+    readonly version: "0.0.1";
+    readonly description: "Cliente JavaScript para Dypai Engine";
+    readonly features: readonly ["API REST autenticada", "Smart Storage (Upload/Download delegado)", "Gestión de usuarios (Admin)"];
+};
+
+export { DypaiClient, PACKAGE_INFO, callApi, configureApiService, configureDypaiServices, createApiClient, createClient, getGlobalConfig, reloadDypaiConfig, resetGlobalConfig, setToastFunction, setTokenProvider, toast, toastError, toastInfo, toastSuccess, toastWarning, useToast };
+export type { ApiClient, ApiContextType, ApiOptions, ApiServiceConfig, AppConfig, AppData, AppRole, AppUserResponse, AuthChangeEvent, AuthResponse, CreateUserRequest, DownloadOptions, DypaiConfig, EndpointBody, EndpointDefinition, EndpointMap, EndpointParams, EndpointResponse, HttpMethod, JoinResponse, ListOptions, ListResponse, LoginCredentials, OAuthOptions, PasswordRecoveryRequest, PasswordRecoveryResponse, PasswordResetRequest, PasswordResetResponse, RegisterData, ResetPasswordWithTokenRequest, Session, SessionResponse, SignedUrlOptions, SignedUrlResponse, StorageObject, ToastFunction, TypedApiClient, TypedGetOptions, TypedMutationOptions, UpdateUserRequest, UploadOptions, UploadResponse, User, UserData, UserListResponse };

package/dist/index.esm.js

@@ -0,0 +1 @@
+class t extends Error{constructor(t,e=500,s,n){super(t),this.status=e,this.code=s,this.details=n,this.name="DypaiError"}}const e={getItem:t=>"undefined"==typeof window?null:window.localStorage.getItem(t),setItem:(t,e)=>{if("undefined"!=typeof window)try{window.localStorage.setItem(t,e)}catch(t){console.error("[DYPAI SDK] ❌ Error crítico guardando en localStorage (¿Quota/Permisos?):",t)}},removeItem:t=>{if("undefined"!=typeof window)try{window.localStorage.removeItem(t)}catch(t){}}};async function s(e){try{return{data:await e,error:null}}catch(e){return{data:null,error:e instanceof t?e:new t(e.message||"Error de autenticación",e.status||400)}}}class n{constructor(t,s=null){this.config=t,this.t=null,this.i=null,this.o=null,this.h=null,this.u=[],this.l=null,this.storage=t.storage||e;const n=t.storageKey||this.deriveStorageKey(t.apiKey);console.log(`[DYPAI SDK] 🛠️ Inicializando AuthModule (apiKey: ${t.apiKey?.substring(0,8)}..., storageKey: ${n})`),this.STORAGE_KEY=`dypai-${n}-auth-session`,this.p=this.S().then(()=>{this.i&&this.getUser().catch(()=>{})}),"undefined"!=typeof window&&(window.addEventListener("visibilitychange",this.m.bind(this)),window.addEventListener("focus",this.m.bind(this)))}async m(){"undefined"!=typeof document&&"visible"===document.visibilityState&&(console.log("[DYPAI SDK] 👁️ Ventana visible. Verificando estado de sesión..."),await this.S())}deriveStorageKey(t){return t?t.substring(0,8):"default"}get user(){return this.t}get token(){return this.i}onAuthStateChange(t){return console.log("[DYPAI SDK] 👂 Nuevo suscriptor añadido a onAuthStateChange"),this.u.push(t),this.p.then(()=>{const e=this._(),s=e?"SIGNED_IN":"INITIAL_SESSION";console.log(`[DYPAI SDK] 📣 Notificando estado inicial a nuevo suscriptor: ${s} (Sesión activa: ${!!e})`),t(s,e)}).catch(e=>{console.error("[DYPAI SDK] ❌ Error esperando recuperación de sesión para suscriptor:",e),t("INITIAL_SESSION",null)}),{data:{subscription:{unsubscribe:()=>{this.u=this.u.filter(e=>e!==t)}}}}}async signInWithPassword(e){return s((async()=>{const s=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/token?grant_type=password`,n={email:e.email||e.identifier||"",password:e.password},i=await fetch(s,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(n)});if(!i.ok){const e=await i.json();throw new t(e.msg||e.error_description||"Login failed",i.status)}const a=await i.json(),o={token:a.access_token,refreshToken:a.refresh_token,expiresIn:a.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(a.expires_in||3600),user:this.D(a)};return this.v(o),o})())}async login(t){return this.signInWithPassword(t)}async signUp(e){return s((async()=>{const s=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/signup`,n={email:e.email,password:e.password,data:e.user_data||{}},i=await fetch(s,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(n)});if(!i.ok){const e=await i.json();throw new t(e.msg||e.error_description||"Registration failed",i.status)}const a=await i.json(),o={token:a.access_token,refreshToken:a.refresh_token,expiresIn:a.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(a.expires_in||3600),user:this.D(a)};return o.token&&this.v(o),o})())}async register(t){return this.signUp(t)}async getSession(){try{if(!this.i||!this.t)return{data:null,error:null};const t=Math.floor(Date.now()/1e3);return(this.h||0)-t<30&&this.o&&(console.log("[DYPAI SDK] ⏳ getSession: Token próximo a expirar. Refrescando..."),await this.refreshSession().catch(t=>console.warn("Error refreshing session in getSession:",t))),{data:{access_token:this.i,refresh_token:this.o||void 0,token_type:"bearer",user:this.t},error:null}}catch(e){return{data:null,error:new t(e.message,500)}}}async getUser(){return s((async()=>{if(!this.i)throw new t("No hay sesión activa",401);const e=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/user`,s=await fetch(e,{headers:{Authorization:`Bearer ${this.i}`,...this.config.apiKey&&{apikey:this.config.apiKey}}});if(!s.ok)throw new t("Session invalid",s.status);const n=await s.json(),i=this.D(n);return this.$(i),i})())}async me(){return this.getUser()}async signInWithOAuth(t,e={}){return s((async()=>{const{redirectTo:s=window.location.href}=e,n=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/authorize?provider=${t}&redirect_to=${encodeURIComponent(s)}`;window.location.href=n})())}async signOut(){return s((async()=>{try{if(this.i){const t=this.config.baseUrl||"http://localhost:8000";await fetch(`${t}/auth/v1/logout`,{method:"POST",headers:{Authorization:`Bearer ${this.i}`,...this.config.apiKey&&{apikey:this.config.apiKey}}})}}finally{this.I()}})())}async logout(){return this.signOut()}async resetPasswordForEmail(e){return s((async()=>{const s=this.config.baseUrl||"http://localhost:8000",n=await fetch(`${s}/auth/v1/recover`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({email:e})});if(!n.ok)throw new t("Recovery failed",n.status);return await n.json()})())}async recoverPassword(t){return this.resetPasswordForEmail(t.email)}async refreshSession(){return console.log("[DYPAI SDK] 🔄 Intentando refrescar sesión con Refresh Token..."),s((async()=>{if(!this.o)throw new t("No hay refresh token disponible",401);const e=`${this.config.baseUrl||"http://localhost:8000"}/api/v0/auth/token?grant_type=refresh_token`,s=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify({refresh_token:this.o})});if(!s.ok){const e=await s.json();throw 400!==s.status&&401!==s.status||this.I(),new t(e.msg||e.error_description||"Refresh session failed",s.status)}const n=await s.json(),i={token:n.access_token,refreshToken:n.refresh_token,expiresIn:n.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(n.expires_in||3600),user:this.D(n)};return this.v(i),i})())}async signInWithOtp(e){return s((async()=>{const s=this.config.baseUrl||"http://localhost:8000",n=await fetch(`${s}/auth/v1/otp`,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(e)});if(!n.ok){const e=await n.json();throw new t(e.detail||"OTP request failed",n.status)}return await n.json()})())}async verifyOtp(e){return s((async()=>{const s=this.config.baseUrl||"http://localhost:8000",n=await fetch(`${s}/auth/v1/verify`,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(e)});if(!n.ok){const e=await n.json();throw new t(e.detail||"OTP verification failed",n.status)}const i=await n.json(),a={token:i.access_token,refreshToken:i.refresh_token,expiresIn:i.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(i.expires_in||3600),user:this.D(i)};return a.token&&this.v(a),a})())}async updateUser(e){return s((async()=>{if(!this.i)throw new t("No hay sesión activa",401);const s=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/user`,n=await fetch(s,{method:"PUT",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.i}`,...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(e)});if(!n.ok){const e=await n.json();throw new t(e.detail||"Update user failed",n.status)}const i=await n.json(),a=this.D(i);return this.$(a),a})())}T(t){this.l&&(clearTimeout(this.l),this.l=null);const e=t-Math.floor(Date.now()/1e3)-60;e>0?(console.log(`[DYPAI SDK] ⏱️ Refresco de sesión programado en ${e} segundos.`),this.l=setTimeout(()=>{this.refreshSession().catch(t=>{console.error("Error in auto-refresh:",t)})},1e3*e)):this.o&&this.refreshSession().catch(()=>{})}D(t){if(!t)return console.warn("[DYPAI SDK] ⚠️ Intentando normalizar un usuario inexistente (data es null/undefined)"),{};const e=t.user||t,s=e.app_metadata||{},n=e.user_metadata||{};return{id:e.id,email:e.email,phone:e.phone,role:s.role||e.role,created_at:e.created_at,updated_at:e.updated_at,confirmed_at:e.confirmed_at,last_sign_in_at:e.last_sign_in_at,app_metadata:s,user_metadata:n,k:{name:s.role||"authenticated",weight:0},P:{app_id:"default"}}}v(t){t.token&&(this.i=t.token,this.o=t.refreshToken||null,this.h=t.expiresAt||null,this.$(t.user,t.token,t.refreshToken,t.expiresAt))}async $(t,e,s,n){this.t=t,e&&(this.i=e),void 0!==s&&(this.o=s||null),void 0!==n&&(this.h=n||null);try{if(this.i&&this.t){const t={access_token:this.i,refresh_token:this.o,expires_at:this.h,user:this.t};await this.storage.setItem(this.STORAGE_KEY,JSON.stringify(t))}else console.warn("[DYPAI SDK] ⚠️ _updateUser: No se guardó sesión porque falta token o user.",{hasToken:!!this.i,hasUser:!!this.t})}catch(t){console.error("[DYPAI SDK] ❌ Error guardando sesión en storage:",t)}this.h&&this.T(this.h);const i=e?"SIGNED_IN":"USER_UPDATED";this.A(i)}async I(){console.log("[DYPAI SDK] 🧹 Limpiando sesión del estado y storage."),this.i=null,this.o=null,this.t=null,this.h=null,this.l&&(clearTimeout(this.l),this.l=null);try{await this.storage.removeItem(this.STORAGE_KEY)}catch(t){console.error("[DYPAI SDK] ❌ Error eliminando sesión de storage:",t)}this.A()}async S(){console.log("[DYPAI SDK] 🔍 Iniciando recuperación de sesión...");try{const t=await this.storage.getItem(this.STORAGE_KEY);if(t){console.log("[DYPAI SDK] ✅ Sesión consolidada encontrada. Restaurando datos...");const e=JSON.parse(t);this.i=e.access_token,this.o=e.refresh_token,this.h=e.expires_at,this.t=e.user}else{console.log("[DYPAI SDK] ℹ️ No hay sesión consolidada. Buscando llaves antiguas para migración...");const t=this.STORAGE_KEY.replace("dypai-","").replace("-auth-session",""),e=await this.storage.getItem(`dypai-auth-token-${t}`),s=await this.storage.getItem(`dypai-auth-user-${t}`);if(!e||!s)return void console.log("[DYPAI SDK] ℹ️ No se encontró ninguna sesión (storage vacío).");{console.log("[DYPAI SDK] 🚚 Migración: Datos antiguos detectados. Consolidando...");const n=JSON.parse(s);this.i=e,this.t=n;const i=await this.storage.getItem(`dypai-auth-refresh-token-${t}`),a=await this.storage.getItem(`dypai-auth-expires-at-${t}`);this.o=i,this.h=a?parseInt(a,10):null,await this.$(n,this.i||void 0,this.o||void 0,this.h||void 0);const o=[`dypai-auth-token-${t}`,`dypai-auth-refresh-token-${t}`,`dypai-auth-user-${t}`,`dypai-auth-expires-at-${t}`];for(const t of o)try{await this.storage.removeItem(t)}catch(t){}console.log("[DYPAI SDK] ✨ Migración completada con éxito.")}}const e=Math.floor(Date.now()/1e3);console.log(`[DYPAI SDK] 🕒 Token expira en: ${this.h}. Ahora es: ${e}. Diferencia: ${(this.h||0)-e}s`),this.h&&this.h<=e&&this.o?(console.log("[DYPAI SDK] ⚠️ El Access Token ha caducado. Intentando refrescar sesión inmediatamente..."),await this.refreshSession().catch(t=>{console.error("[DYPAI SDK] ❌ El refresco inicial falló (posible error de red):",t)})):this.h&&(console.log("[DYPAI SDK] ✨ Sesión válida. Programando refresco futuro."),this.T(this.h)),this.A("SIGNED_IN")}catch(t){console.error("[DYPAI SDK] ❌ Error crítico durante la recuperación de sesión:",t)}}_(){return this.i&&this.t?{access_token:this.i,refresh_token:this.o||void 0,expires_at:this.h||void 0,token_type:"bearer",user:this.t}:null}A(t="USER_UPDATED"){const e=this._();console.log(`[DYPAI SDK] 📢 Notificando a ${this.u.length} suscriptores: Evento=${t} (Sesión activa: ${!!e})`),this.u.forEach(s=>s(t,e))}handleSessionExpired(){this.I()}}class i{constructor(t){this.api=t}from(t){return new a(t,this.api)}}class a{constructor(t,e){this.table=t,this.api=e}async select(t={}){return this.api.get(this.table,{params:t})}async insert(t){return this.api.post(this.table,t)}async update(t,e){return this.api.patch(`${this.table}/${t}`,e)}async delete(t){return this.api.delete(`${this.table}/${t}`)}}async function o(e){try{return{data:await e,error:null}}catch(e){return{data:null,error:e instanceof t?e:new t(e.message||"Error desconocido",e.status||500)}}}class r{constructor(t){this.api=t}async list(t={}){return o(this.api.get("admin/users",{params:t}))}async create(t){return o(this.api.post("admin/users",{body:t}))}async update(t,e){return o(this.api.put(`admin/users/${t}`,{body:e}))}async delete(t){return o(this.api.delete(`admin/users/${t}`))}}let c=null;function h(t){c=t}const u=t=>{const{title:e,description:s,variant:n="default"}=t,i=`${"error"===n?"❌":"success"===n?"✅":"warning"===n?"⚠️":"info"===n?"ℹ️":"📢"} ${e}${s?`: ${s}`:""}`;"error"===n?console.error(i):"warning"===n?console.warn(i):console.log(i)};function l(){const t=c||u;return{toast:t,toastSuccess:(e,s)=>t({title:e,description:s,variant:"success"}),toastError:(e,s)=>t({title:e,description:s,variant:"error"}),toastWarning:(e,s)=>t({title:e,description:s,variant:"warning"}),toastInfo:(e,s)=>t({title:e,description:s,variant:"info"})}}const d=t=>(c||u)(t),p=(t,e)=>d({title:t,description:e,variant:"success"}),f=(t,e)=>d({title:t,description:e,variant:"error"}),y=(t,e)=>d({title:t,description:e,variant:"warning"}),w=(t,e)=>d({title:t,description:e,variant:"info"});let S={},g=null;function m(t){g=t}function _(t){S={...S,...t}}const D=new Map;function v(){let t=S;try{const{getGlobalConfig:e}=require("../config/global-config");t={...e(),...S}}catch(t){}return t}async function $(e,s,n,i,a,o,r,c){const h=v(),u=c||null;if(!u&&!n.startsWith("http"))throw new Error("Base URL no definida. Usa createClient(url, key).");if("string"!=typeof n||!n.trim())throw new Error("Endpoint debe ser un string válido");let l;if(n.startsWith("http"))l=n;else{const t=u.replace(/\/+$/,"");l=n.startsWith("/")?t+n:t+"/api/v0/"+n}if(o&&Object.keys(o).length>0){const t=new URLSearchParams,e=(s,n)=>{null!=n&&(Array.isArray(n)?n.forEach((t,n)=>e(`${s}[${n}]`,t)):"object"==typeof n?Object.entries(n).forEach(([t,n])=>e(`${s}[${t}]`,n)):t.append(s,String(n)))};Object.entries(o).forEach(([t,s])=>e(t,s));const s=t.toString();s&&(l+=`?${s}`)}const p="GET"===s?`${s}:${l}:${JSON.stringify(i)}`:null;if(p&&D.has(p))return D.get(p);const f=i instanceof FormData,y={...h.headers||{},...f?{}:{"Content-Type":"application/json"},...e&&{Authorization:`Bearer ${e}`},...r&&{"x-api-key":r}},w={method:s,headers:y,credentials:"include"};i&&"GET"!==s&&"DELETE"!==s&&(w.body=f?i:JSON.stringify(i));const S=h.fetch||("undefined"!=typeof window?window.fetch.bind(window):fetch);if(!S)throw new Error("Fetch no disponible.");const g=(async()=>{const e=v().toast||d,u=(void 0!==a?a:!1!==h.showToasts)&&e;try{const d=await S(l,w);if(!d.ok){let l,p="Error en la petición";try{const t=await d.text();try{const e=JSON.parse(t);l=e,p=e.message||e.msg||e.error_description||e.error||p}catch{t.length<200&&(p=t)}}catch{}if(401===d.status){if(h.onTokenExpired){console.log("[DYPAI SDK] 🔄 Token caducado detectado. Intentando refrescar...");const t=await h.onTokenExpired();if(t)return console.log("[DYPAI SDK] ✅ Token refrescado con éxito. Reintentando petición..."),$(t,s,n,i,a,o,r,c)}h.onUnauthorized&&h.onUnauthorized()}throw u&&e({title:"Error",description:p,variant:"error"}),new t(p,d.status,void 0,l)}!u||"POST"!==s&&"PUT"!==s&&"PATCH"!==s&&"DELETE"!==s||e({title:"Éxito",description:"Operación completada",variant:"success"});const p=d.headers.get("content-type")||"";return p.includes("application/pdf")||p.includes("image/")||p.includes("audio/")||p.includes("video/")||p.includes("application/octet-stream")||p.includes("application/zip")||p.includes("application/vnd.openxmlformats-officedocument")?await d.blob():p.includes("application/json")?await d.json():await d.text()}finally{p&&D.delete(p)}})();return p&&D.set(p,g),g}function I(t,e){return async(s,n,i)=>{const a=t();let o,r={};n&&"object"==typeof n&&("token"in n||"params"in n||"apiKey"in n)?(r=n,o=r.body):(o=n,r=i||{});const c=r.token||a.token||(g?g():"")||"",h=r.apiKey||a.apiKey;return $(c,e,s,o,r.showToasts,r.params,h,a.baseUrl)}}function T(t){const e=()=>"function"==typeof t?t():t;return{get:k(e,"GET"),post:k(e,"POST"),put:k(e,"PUT"),patch:k(e,"PATCH"),delete:k(e,"DELETE")}}function k(t,e){return async(s,n,i)=>{const a=t(),o=await async function(t,e){let s,n={};t&&"object"==typeof t&&("token"in t||"params"in t||"apiKey"in t)?(n=t,s=n.body):(s=t,n=e||{});let i=n.token;return!i&&g&&(i=g()||""),i=i||"",{token:i,apiKey:n.apiKey,body:s,params:n.params,showToasts:n.showToasts}}(n,i),r=o.token||a.token||"",c=o.apiKey||a.apiKey;return $(r,e,s,o.body,o.showToasts,o.params,c,a.baseUrl)}}class P{constructor(t){this.api=t}from(t){return new b(t,this.api)}}class b{constructor(t,e){this.bucketName=t,this.api=e}async upload(e,s,n={}){return A(async()=>{const i=n.uploadEndpoint||`storage_upload_${this.bucketName}`,a={file_path:e,...n.params},o=await async function(e,s,n,i){const a=await e.post(s,{file_path:n.name,content_type:n.type||"application/octet-stream",size_bytes:n.size,confirm:!1,...i?.params||{}});if(!a||!a.upload_url)throw new t("El workflow no devolvió una URL de subida válida (¿falta get_upload_url?)",400);const{upload_url:o,method:r="PUT",headers:c={},file_path:h}=a;i?.onProgress&&i.onProgress(10);const u=await fetch(o,{method:r,headers:{"Content-Type":n.type||"application/octet-stream",...c},body:n});if(!u.ok)throw new t("Error en la subida directa a la nube",u.status);i?.onProgress&&i.onProgress(90);const l=i?.confirmEndpoint||s,d=await e.post(l,{...i?.params,bucket:a.bucket||i?.params?.bucket,file_path:h,filename:n.name,content_type:n.type||"application/octet-stream",size_bytes:n.size,confirm:!0});return i?.onProgress&&i.onProgress(100),d}(this.api,i,s,{confirmEndpoint:n.confirmEndpoint,params:a,onProgress:n.onProgress});return o})}async download(t,e={}){return A(async()=>{const s=e.downloadEndpoint||`storage_download_${this.bucketName}`,n={bucket:this.bucketName,file_path:t,...e.params};await async function(t,e,s,n){const i=n?.method,a=await("GET"===i?t.get(e,{params:n?.params}):t.post(e,s,{params:n?.params}));if(a instanceof Blob){const t=window.URL.createObjectURL(a),e=document.createElement("a");e.href=t,e.download=n?.fileName||"archivo-descargado",document.body.appendChild(e),e.click(),window.URL.revokeObjectURL(t),document.body.removeChild(e)}else if(a&&"object"==typeof a&&("url"in a||"signed_url"in a||"signedUrl"in a)){const t=a.url||a.signed_url||a.signedUrl;"string"==typeof t&&window.open(t,"_blank")}}(this.api,s,n,{fileName:e.fileName,method:e.method||"POST"})})}async createSignedUrl(t,e=15,s={}){return A(async()=>{const n=s.endpoint||`storage_signed_url_${this.bucketName}`,i={bucket:this.bucketName,file_path:t,expires_minutes:e,...s.params},a=await this.api.post(n,i);return{signedUrl:a.signed_url||a.signedUrl||a.url,expiresIn:a.expires_in||a.expiresIn||e,path:t}})}getPublicUrl(t){const e=t.replace(/^\/+/,"");return{data:{publicUrl:`${this.api.baseUrl||""}/storage/v1/render/public/${this.bucketName}/${e}`}}}async list(t="",e={}){return A(async()=>{const s=e.endpoint||`storage_list_${this.bucketName}`,n={bucket:this.bucketName,prefix:t||e.prefix||"",limit:e.limit,offset:e.offset,sort_by:e.sortBy,order:e.order,search:e.search,...e.params},i=await this.api.post(s,n);return{data:i.data||i.files||[],total:i.total,hasMore:i.has_more||i.hasMore||!1}})}async remove(t,e={}){return A(async()=>{const s=e.endpoint||`storage_delete_${this.bucketName}`,n=Array.isArray(t)?t:[t],i={bucket:this.bucketName,paths:n,...e.params};return await this.api.post(s,i),{success:!0}})}async move(t,e,s={}){return A(async()=>{const n=s.endpoint||`storage_move_${this.bucketName}`,i={bucket:this.bucketName,from_path:t,to_path:e,...s.params};return await this.api.post(n,i),{success:!0}})}async copy(t,e,s={}){return A(async()=>{const n=s.endpoint||`storage_copy_${this.bucketName}`,i={bucket:this.bucketName,from_path:t,to_path:e,...s.params};return await this.api.post(n,i),{success:!0}})}}async function A(e){try{return{data:await e(),error:null}}catch(e){return{data:null,error:e instanceof t?e:new t(e.message||"Error de storage",e.status||500)}}}class E{constructor(t){const{baseUrl:e,apiKey:s}=t,a=t.auth?.storageKey||t.storageKey;t.global&&function(t){S={...S,...t}}(t.global),this.auth=new n({baseUrl:e,apiKey:s,storageKey:a,storage:t.auth?.storage,autoRefreshToken:t.auth?.autoRefreshToken,persistSession:t.auth?.persistSession},null);const o={get:I(c=()=>({token:this.auth.token,apiKey:s,baseUrl:e}),"GET"),post:I(c,"POST"),put:I(c,"PUT"),patch:I(c,"PATCH"),delete:I(c,"DELETE")};var c;this.auth.api=o,this.db=new i(o),this.users=new r(o),this.storage=new P(o),this.api=T(()=>({token:this.auth.token||"",apiKey:s,baseUrl:e})),m(()=>this.auth.token),_({onTokenExpired:async()=>{const t=await this.auth.refreshSession();return t.data?.token||null},onUnauthorized:()=>this.auth.handleSessionExpired()})}from(t){return this.db.from(t)}async me(){return this.auth.getUser()}}function K(t,e,s){if(!t||!e)throw new Error("createClient() requiere URL y API Key");return new E({baseUrl:t,apiKey:e,...s})}let O={};function U(t){O={...O,toast:d,...t},x()}function N(){return{...O}}function x(){try{const{configureApiService:t}=require("../services/ApiService");t(O)}catch(t){}}function Y(){O={},x()}async function C(){x()}const R={name:"@dypai-ai/client-sdk",version:"0.0.1",description:"Cliente JavaScript para Dypai Engine",features:["API REST autenticada","Smart Storage (Upload/Download delegado)","Gestión de usuarios (Admin)"]};export{E as DypaiClient,R as PACKAGE_INFO,$ as callApi,_ as configureApiService,U as configureDypaiServices,T as createApiClient,K as createClient,N as getGlobalConfig,C as reloadDypaiConfig,Y as resetGlobalConfig,h as setToastFunction,m as setTokenProvider,d as toast,f as toastError,w as toastInfo,p as toastSuccess,y as toastWarning,l as useToast};

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";class DypaiError extends Error{constructor(t,e=500,s,i){super(t),this.status=e,this.code=s,this.details=i,this.name="DypaiError"}}const localStorageAdapter={getItem:t=>"undefined"==typeof window?null:window.localStorage.getItem(t),setItem:(t,e)=>{if("undefined"!=typeof window)try{window.localStorage.setItem(t,e)}catch(t){console.error("[DYPAI SDK] ❌ Error crítico guardando en localStorage (¿Quota/Permisos?):",t)}},removeItem:t=>{if("undefined"!=typeof window)try{window.localStorage.removeItem(t)}catch(t){}}};async function wrapAuthResponse(t){try{return{data:await t,error:null}}catch(t){return{data:null,error:t instanceof DypaiError?t:new DypaiError(t.message||"Error de autenticación",t.status||400)}}}class AuthModule{constructor(t,e=null){this.config=t,this.t=null,this.i=null,this.o=null,this.h=null,this.l=[],this.u=null,this.storage=t.storage||localStorageAdapter;const s=t.storageKey||this.deriveStorageKey(t.apiKey);console.log(`[DYPAI SDK] 🛠️ Inicializando AuthModule (apiKey: ${t.apiKey?.substring(0,8)}..., storageKey: ${s})`),this.STORAGE_KEY=`dypai-${s}-auth-session`,this.p=this.S().then(()=>{this.i&&this.getUser().catch(()=>{})}),"undefined"!=typeof window&&(window.addEventListener("visibilitychange",this.D.bind(this)),window.addEventListener("focus",this.D.bind(this)))}async D(){"undefined"!=typeof document&&"visible"===document.visibilityState&&(console.log("[DYPAI SDK] 👁️ Ventana visible. Verificando estado de sesión..."),await this.S())}deriveStorageKey(t){return t?t.substring(0,8):"default"}get user(){return this.t}get token(){return this.i}onAuthStateChange(t){return console.log("[DYPAI SDK] 👂 Nuevo suscriptor añadido a onAuthStateChange"),this.l.push(t),this.p.then(()=>{const e=this.m(),s=e?"SIGNED_IN":"INITIAL_SESSION";console.log(`[DYPAI SDK] 📣 Notificando estado inicial a nuevo suscriptor: ${s} (Sesión activa: ${!!e})`),t(s,e)}).catch(e=>{console.error("[DYPAI SDK] ❌ Error esperando recuperación de sesión para suscriptor:",e),t("INITIAL_SESSION",null)}),{data:{subscription:{unsubscribe:()=>{this.l=this.l.filter(e=>e!==t)}}}}}async signInWithPassword(t){return wrapAuthResponse((async()=>{const e=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/token?grant_type=password`,s={email:t.email||t.identifier||"",password:t.password},i=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(s)});if(!i.ok){const t=await i.json();throw new DypaiError(t.msg||t.error_description||"Login failed",i.status)}const n=await i.json(),o={token:n.access_token,refreshToken:n.refresh_token,expiresIn:n.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(n.expires_in||3600),user:this.v(n)};return this.A(o),o})())}async login(t){return this.signInWithPassword(t)}async signUp(t){return wrapAuthResponse((async()=>{const e=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/signup`,s={email:t.email,password:t.password,data:t.user_data||{}},i=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(s)});if(!i.ok){const t=await i.json();throw new DypaiError(t.msg||t.error_description||"Registration failed",i.status)}const n=await i.json(),o={token:n.access_token,refreshToken:n.refresh_token,expiresIn:n.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(n.expires_in||3600),user:this.v(n)};return o.token&&this.A(o),o})())}async register(t){return this.signUp(t)}async getSession(){try{if(!this.i||!this.t)return{data:null,error:null};const t=Math.floor(Date.now()/1e3);return(this.h||0)-t<30&&this.o&&(console.log("[DYPAI SDK] ⏳ getSession: Token próximo a expirar. Refrescando..."),await this.refreshSession().catch(t=>console.warn("Error refreshing session in getSession:",t))),{data:{access_token:this.i,refresh_token:this.o||void 0,token_type:"bearer",user:this.t},error:null}}catch(t){return{data:null,error:new DypaiError(t.message,500)}}}async getUser(){return wrapAuthResponse((async()=>{if(!this.i)throw new DypaiError("No hay sesión activa",401);const t=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/user`,e=await fetch(t,{headers:{Authorization:`Bearer ${this.i}`,...this.config.apiKey&&{apikey:this.config.apiKey}}});if(!e.ok)throw new DypaiError("Session invalid",e.status);const s=await e.json(),i=this.v(s);return this.T(i),i})())}async me(){return this.getUser()}async signInWithOAuth(t,e={}){return wrapAuthResponse((async()=>{const{redirectTo:s=window.location.href}=e,i=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/authorize?provider=${t}&redirect_to=${encodeURIComponent(s)}`;window.location.href=i})())}async signOut(){return wrapAuthResponse((async()=>{try{if(this.i){const t=this.config.baseUrl||"http://localhost:8000";await fetch(`${t}/auth/v1/logout`,{method:"POST",headers:{Authorization:`Bearer ${this.i}`,...this.config.apiKey&&{apikey:this.config.apiKey}}})}}finally{this._()}})())}async logout(){return this.signOut()}async resetPasswordForEmail(t){return wrapAuthResponse((async()=>{const e=this.config.baseUrl||"http://localhost:8000",s=await fetch(`${e}/auth/v1/recover`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({email:t})});if(!s.ok)throw new DypaiError("Recovery failed",s.status);return await s.json()})())}async recoverPassword(t){return this.resetPasswordForEmail(t.email)}async refreshSession(){return console.log("[DYPAI SDK] 🔄 Intentando refrescar sesión con Refresh Token..."),wrapAuthResponse((async()=>{if(!this.o)throw new DypaiError("No hay refresh token disponible",401);const t=`${this.config.baseUrl||"http://localhost:8000"}/api/v0/auth/token?grant_type=refresh_token`,e=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify({refresh_token:this.o})});if(!e.ok){const t=await e.json();throw 400!==e.status&&401!==e.status||this._(),new DypaiError(t.msg||t.error_description||"Refresh session failed",e.status)}const s=await e.json(),i={token:s.access_token,refreshToken:s.refresh_token,expiresIn:s.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(s.expires_in||3600),user:this.v(s)};return this.A(i),i})())}async signInWithOtp(t){return wrapAuthResponse((async()=>{const e=this.config.baseUrl||"http://localhost:8000",s=await fetch(`${e}/auth/v1/otp`,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(t)});if(!s.ok){const t=await s.json();throw new DypaiError(t.detail||"OTP request failed",s.status)}return await s.json()})())}async verifyOtp(t){return wrapAuthResponse((async()=>{const e=this.config.baseUrl||"http://localhost:8000",s=await fetch(`${e}/auth/v1/verify`,{method:"POST",headers:{"Content-Type":"application/json",...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(t)});if(!s.ok){const t=await s.json();throw new DypaiError(t.detail||"OTP verification failed",s.status)}const i=await s.json(),n={token:i.access_token,refreshToken:i.refresh_token,expiresIn:i.expires_in,expiresAt:Math.floor(Date.now()/1e3)+(i.expires_in||3600),user:this.v(i)};return n.token&&this.A(n),n})())}async updateUser(t){return wrapAuthResponse((async()=>{if(!this.i)throw new DypaiError("No hay sesión activa",401);const e=`${this.config.baseUrl||"http://localhost:8000"}/auth/v1/user`,s=await fetch(e,{method:"PUT",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.i}`,...this.config.apiKey&&{apikey:this.config.apiKey}},body:JSON.stringify(t)});if(!s.ok){const t=await s.json();throw new DypaiError(t.detail||"Update user failed",s.status)}const i=await s.json(),n=this.v(i);return this.T(n),n})())}k(t){this.u&&(clearTimeout(this.u),this.u=null);const e=t-Math.floor(Date.now()/1e3)-60;e>0?(console.log(`[DYPAI SDK] ⏱️ Refresco de sesión programado en ${e} segundos.`),this.u=setTimeout(()=>{this.refreshSession().catch(t=>{console.error("Error in auto-refresh:",t)})},1e3*e)):this.o&&this.refreshSession().catch(()=>{})}v(t){if(!t)return console.warn("[DYPAI SDK] ⚠️ Intentando normalizar un usuario inexistente (data es null/undefined)"),{};const e=t.user||t,s=e.app_metadata||{},i=e.user_metadata||{};return{id:e.id,email:e.email,phone:e.phone,role:s.role||e.role,created_at:e.created_at,updated_at:e.updated_at,confirmed_at:e.confirmed_at,last_sign_in_at:e.last_sign_in_at,app_metadata:s,user_metadata:i,P:{name:s.role||"authenticated",weight:0},$:{app_id:"default"}}}A(t){t.token&&(this.i=t.token,this.o=t.refreshToken||null,this.h=t.expiresAt||null,this.T(t.user,t.token,t.refreshToken,t.expiresAt))}async T(t,e,s,i){this.t=t,e&&(this.i=e),void 0!==s&&(this.o=s||null),void 0!==i&&(this.h=i||null);try{if(this.i&&this.t){const t={access_token:this.i,refresh_token:this.o,expires_at:this.h,user:this.t};await this.storage.setItem(this.STORAGE_KEY,JSON.stringify(t))}else console.warn("[DYPAI SDK] ⚠️ _updateUser: No se guardó sesión porque falta token o user.",{hasToken:!!this.i,hasUser:!!this.t})}catch(t){console.error("[DYPAI SDK] ❌ Error guardando sesión en storage:",t)}this.h&&this.k(this.h);const n=e?"SIGNED_IN":"USER_UPDATED";this.I(n)}async _(){console.log("[DYPAI SDK] 🧹 Limpiando sesión del estado y storage."),this.i=null,this.o=null,this.t=null,this.h=null,this.u&&(clearTimeout(this.u),this.u=null);try{await this.storage.removeItem(this.STORAGE_KEY)}catch(t){console.error("[DYPAI SDK] ❌ Error eliminando sesión de storage:",t)}this.I()}async S(){console.log("[DYPAI SDK] 🔍 Iniciando recuperación de sesión...");try{const t=await this.storage.getItem(this.STORAGE_KEY);if(t){console.log("[DYPAI SDK] ✅ Sesión consolidada encontrada. Restaurando datos...");const e=JSON.parse(t);this.i=e.access_token,this.o=e.refresh_token,this.h=e.expires_at,this.t=e.user}else{console.log("[DYPAI SDK] ℹ️ No hay sesión consolidada. Buscando llaves antiguas para migración...");const t=this.STORAGE_KEY.replace("dypai-","").replace("-auth-session",""),e=await this.storage.getItem(`dypai-auth-token-${t}`),s=await this.storage.getItem(`dypai-auth-user-${t}`);if(!e||!s)return void console.log("[DYPAI SDK] ℹ️ No se encontró ninguna sesión (storage vacío).");{console.log("[DYPAI SDK] 🚚 Migración: Datos antiguos detectados. Consolidando...");const i=JSON.parse(s);this.i=e,this.t=i;const n=await this.storage.getItem(`dypai-auth-refresh-token-${t}`),o=await this.storage.getItem(`dypai-auth-expires-at-${t}`);this.o=n,this.h=o?parseInt(o,10):null,await this.T(i,this.i||void 0,this.o||void 0,this.h||void 0);const r=[`dypai-auth-token-${t}`,`dypai-auth-refresh-token-${t}`,`dypai-auth-user-${t}`,`dypai-auth-expires-at-${t}`];for(const t of r)try{await this.storage.removeItem(t)}catch(t){}console.log("[DYPAI SDK] ✨ Migración completada con éxito.")}}const e=Math.floor(Date.now()/1e3);console.log(`[DYPAI SDK] 🕒 Token expira en: ${this.h}. Ahora es: ${e}. Diferencia: ${(this.h||0)-e}s`),this.h&&this.h<=e&&this.o?(console.log("[DYPAI SDK] ⚠️ El Access Token ha caducado. Intentando refrescar sesión inmediatamente..."),await this.refreshSession().catch(t=>{console.error("[DYPAI SDK] ❌ El refresco inicial falló (posible error de red):",t)})):this.h&&(console.log("[DYPAI SDK] ✨ Sesión válida. Programando refresco futuro."),this.k(this.h)),this.I("SIGNED_IN")}catch(t){console.error("[DYPAI SDK] ❌ Error crítico durante la recuperación de sesión:",t)}}m(){return this.i&&this.t?{access_token:this.i,refresh_token:this.o||void 0,expires_at:this.h||void 0,token_type:"bearer",user:this.t}:null}I(t="USER_UPDATED"){const e=this.m();console.log(`[DYPAI SDK] 📢 Notificando a ${this.l.length} suscriptores: Evento=${t} (Sesión activa: ${!!e})`),this.l.forEach(s=>s(t,e))}handleSessionExpired(){this._()}}class DataModule{constructor(t){this.api=t}from(t){return new QueryBuilder(t,this.api)}}class QueryBuilder{constructor(t,e){this.table=t,this.api=e}async select(t={}){return this.api.get(this.table,{params:t})}async insert(t){return this.api.post(this.table,t)}async update(t,e){return this.api.patch(`${this.table}/${t}`,e)}async delete(t){return this.api.delete(`${this.table}/${t}`)}}async function wrapResponse(t){try{return{data:await t,error:null}}catch(t){return{data:null,error:t instanceof DypaiError?t:new DypaiError(t.message||"Error desconocido",t.status||500)}}}class UsersModule{constructor(t){this.api=t}async list(t={}){return wrapResponse(this.api.get("admin/users",{params:t}))}async create(t){return wrapResponse(this.api.post("admin/users",{body:t}))}async update(t,e){return wrapResponse(this.api.put(`admin/users/${t}`,{body:e}))}async delete(t){return wrapResponse(this.api.delete(`admin/users/${t}`))}}let customToastFunction=null;const fallbackToast=t=>{const{title:e,description:s,variant:i="default"}=t,n=`${"error"===i?"❌":"success"===i?"✅":"warning"===i?"⚠️":"info"===i?"ℹ️":"📢"} ${e}${s?`: ${s}`:""}`;"error"===i?console.error(n):"warning"===i?console.warn(n):console.log(n)},toast=t=>(customToastFunction||fallbackToast)(t);let serviceConfig={},globalTokenProvider=null;function setTokenProvider(t){globalTokenProvider=t}function configureApiService(t){serviceConfig={...serviceConfig,...t}}const pendingRequests=new Map;function getCompleteConfig(){let t=serviceConfig;try{const{getGlobalConfig:e}=require("../config/global-config");t={...e(),...serviceConfig}}catch(t){}return t}async function callApi(t,e,s,i,n,o,r,a){const c=getCompleteConfig(),h=a||null;if(!h&&!s.startsWith("http"))throw new Error("Base URL no definida. Usa createClient(url, key).");if("string"!=typeof s||!s.trim())throw new Error("Endpoint debe ser un string válido");let l;if(s.startsWith("http"))l=s;else{const t=h.replace(/\/+$/,"");l=s.startsWith("/")?t+s:t+"/api/v0/"+s}if(o&&Object.keys(o).length>0){const t=new URLSearchParams,e=(s,i)=>{null!=i&&(Array.isArray(i)?i.forEach((t,i)=>e(`${s}[${i}]`,t)):"object"==typeof i?Object.entries(i).forEach(([t,i])=>e(`${s}[${t}]`,i)):t.append(s,String(i)))};Object.entries(o).forEach(([t,s])=>e(t,s));const s=t.toString();s&&(l+=`?${s}`)}const u="GET"===e?`${e}:${l}:${JSON.stringify(i)}`:null;if(u&&pendingRequests.has(u))return pendingRequests.get(u);const p=i instanceof FormData,d={...c.headers||{},...p?{}:{"Content-Type":"application/json"},...t&&{Authorization:`Bearer ${t}`},...r&&{"x-api-key":r}},y={method:e,headers:d,credentials:"include"};i&&"GET"!==e&&"DELETE"!==e&&(y.body=p?i:JSON.stringify(i));const f=c.fetch||("undefined"!=typeof window?window.fetch.bind(window):fetch);if(!f)throw new Error("Fetch no disponible.");const w=(async()=>{const t=getCompleteConfig().toast||toast,h=(void 0!==n?n:!1!==c.showToasts)&&t;try{const u=await f(l,y);if(!u.ok){let l,p="Error en la petición";try{const t=await u.text();try{const e=JSON.parse(t);l=e,p=e.message||e.msg||e.error_description||e.error||p}catch{t.length<200&&(p=t)}}catch{}if(401===u.status){if(c.onTokenExpired){console.log("[DYPAI SDK] 🔄 Token caducado detectado. Intentando refrescar...");const t=await c.onTokenExpired();if(t)return console.log("[DYPAI SDK] ✅ Token refrescado con éxito. Reintentando petición..."),callApi(t,e,s,i,n,o,r,a)}c.onUnauthorized&&c.onUnauthorized()}throw h&&t({title:"Error",description:p,variant:"error"}),new DypaiError(p,u.status,void 0,l)}!h||"POST"!==e&&"PUT"!==e&&"PATCH"!==e&&"DELETE"!==e||t({title:"Éxito",description:"Operación completada",variant:"success"});const p=u.headers.get("content-type")||"";return p.includes("application/pdf")||p.includes("image/")||p.includes("audio/")||p.includes("video/")||p.includes("application/octet-stream")||p.includes("application/zip")||p.includes("application/vnd.openxmlformats-officedocument")?await u.blob():p.includes("application/json")?await u.json():await u.text()}finally{u&&pendingRequests.delete(u)}})();return u&&pendingRequests.set(u,w),w}function createMethod(t,e){return async(s,i,n)=>{const o=t();let r,a={};i&&"object"==typeof i&&("token"in i||"params"in i||"apiKey"in i)?(a=i,r=a.body):(r=i,a=n||{});const c=a.token||o.token||(globalTokenProvider?globalTokenProvider():"")||"",h=a.apiKey||o.apiKey;return callApi(c,e,s,r,a.showToasts,a.params,h,o.baseUrl)}}function createApiClient(t){const e=()=>"function"==typeof t?t():t;return{get:createMethodFromCtx(e,"GET"),post:createMethodFromCtx(e,"POST"),put:createMethodFromCtx(e,"PUT"),patch:createMethodFromCtx(e,"PATCH"),delete:createMethodFromCtx(e,"DELETE")}}function createMethodFromCtx(t,e){return async(s,i,n)=>{const o=t(),r=await async function(t,e){let s,i={};t&&"object"==typeof t&&("token"in t||"params"in t||"apiKey"in t)?(i=t,s=i.body):(s=t,i=e||{});let n=i.token;return!n&&globalTokenProvider&&(n=globalTokenProvider()||""),n=n||"",{token:n,apiKey:i.apiKey,body:s,params:i.params,showToasts:i.showToasts}}(i,n),a=r.token||o.token||"",c=r.apiKey||o.apiKey;return callApi(a,e,s,r.body,r.showToasts,r.params,c,o.baseUrl)}}class StorageModule{constructor(t){this.api=t}from(t){return new StorageBucketBuilder(t,this.api)}}class StorageBucketBuilder{constructor(t,e){this.bucketName=t,this.api=e}async upload(t,e,s={}){return wrapStorageResponse(async()=>{const i=s.uploadEndpoint||`storage_upload_${this.bucketName}`,n={file_path:t,...s.params},o=await async function(t,e,s,i){const n=await t.post(e,{file_path:s.name,content_type:s.type||"application/octet-stream",size_bytes:s.size,confirm:!1,...i?.params||{}});if(!n||!n.upload_url)throw new DypaiError("El workflow no devolvió una URL de subida válida (¿falta get_upload_url?)",400);const{upload_url:o,method:r="PUT",headers:a={},file_path:c}=n;i?.onProgress&&i.onProgress(10);const h=await fetch(o,{method:r,headers:{"Content-Type":s.type||"application/octet-stream",...a},body:s});if(!h.ok)throw new DypaiError("Error en la subida directa a la nube",h.status);i?.onProgress&&i.onProgress(90);const l=i?.confirmEndpoint||e,u=await t.post(l,{...i?.params,bucket:n.bucket||i?.params?.bucket,file_path:c,filename:s.name,content_type:s.type||"application/octet-stream",size_bytes:s.size,confirm:!0});return i?.onProgress&&i.onProgress(100),u}(this.api,i,e,{confirmEndpoint:s.confirmEndpoint,params:n,onProgress:s.onProgress});return o})}async download(t,e={}){return wrapStorageResponse(async()=>{const s=e.downloadEndpoint||`storage_download_${this.bucketName}`,i={bucket:this.bucketName,file_path:t,...e.params};await async function(t,e,s,i){const n=i?.method,o=await("GET"===n?t.get(e,{params:i?.params}):t.post(e,s,{params:i?.params}));if(o instanceof Blob){const t=window.URL.createObjectURL(o),e=document.createElement("a");e.href=t,e.download=i?.fileName||"archivo-descargado",document.body.appendChild(e),e.click(),window.URL.revokeObjectURL(t),document.body.removeChild(e)}else if(o&&"object"==typeof o&&("url"in o||"signed_url"in o||"signedUrl"in o)){const t=o.url||o.signed_url||o.signedUrl;"string"==typeof t&&window.open(t,"_blank")}}(this.api,s,i,{fileName:e.fileName,method:e.method||"POST"})})}async createSignedUrl(t,e=15,s={}){return wrapStorageResponse(async()=>{const i=s.endpoint||`storage_signed_url_${this.bucketName}`,n={bucket:this.bucketName,file_path:t,expires_minutes:e,...s.params},o=await this.api.post(i,n);return{signedUrl:o.signed_url||o.signedUrl||o.url,expiresIn:o.expires_in||o.expiresIn||e,path:t}})}getPublicUrl(t){const e=t.replace(/^\/+/,"");return{data:{publicUrl:`${this.api.baseUrl||""}/storage/v1/render/public/${this.bucketName}/${e}`}}}async list(t="",e={}){return wrapStorageResponse(async()=>{const s=e.endpoint||`storage_list_${this.bucketName}`,i={bucket:this.bucketName,prefix:t||e.prefix||"",limit:e.limit,offset:e.offset,sort_by:e.sortBy,order:e.order,search:e.search,...e.params},n=await this.api.post(s,i);return{data:n.data||n.files||[],total:n.total,hasMore:n.has_more||n.hasMore||!1}})}async remove(t,e={}){return wrapStorageResponse(async()=>{const s=e.endpoint||`storage_delete_${this.bucketName}`,i=Array.isArray(t)?t:[t],n={bucket:this.bucketName,paths:i,...e.params};return await this.api.post(s,n),{success:!0}})}async move(t,e,s={}){return wrapStorageResponse(async()=>{const i=s.endpoint||`storage_move_${this.bucketName}`,n={bucket:this.bucketName,from_path:t,to_path:e,...s.params};return await this.api.post(i,n),{success:!0}})}async copy(t,e,s={}){return wrapStorageResponse(async()=>{const i=s.endpoint||`storage_copy_${this.bucketName}`,n={bucket:this.bucketName,from_path:t,to_path:e,...s.params};return await this.api.post(i,n),{success:!0}})}}async function wrapStorageResponse(t){try{return{data:await t(),error:null}}catch(t){return{data:null,error:t instanceof DypaiError?t:new DypaiError(t.message||"Error de storage",t.status||500)}}}class DypaiClient{constructor(t){const{baseUrl:e,apiKey:s}=t,i=t.auth?.storageKey||t.storageKey;t.global&&function(t){serviceConfig={...serviceConfig,...t}}(t.global),this.auth=new AuthModule({baseUrl:e,apiKey:s,storageKey:i,storage:t.auth?.storage,autoRefreshToken:t.auth?.autoRefreshToken,persistSession:t.auth?.persistSession},null);const n={get:createMethod(o=()=>({token:this.auth.token,apiKey:s,baseUrl:e}),"GET"),post:createMethod(o,"POST"),put:createMethod(o,"PUT"),patch:createMethod(o,"PATCH"),delete:createMethod(o,"DELETE")};var o;this.auth.api=n,this.db=new DataModule(n),this.users=new UsersModule(n),this.storage=new StorageModule(n),this.api=createApiClient(()=>({token:this.auth.token||"",apiKey:s,baseUrl:e})),setTokenProvider(()=>this.auth.token),configureApiService({onTokenExpired:async()=>{const t=await this.auth.refreshSession();return t.data?.token||null},onUnauthorized:()=>this.auth.handleSessionExpired()})}from(t){return this.db.from(t)}async me(){return this.auth.getUser()}}let globalConfig={};function applyConfigToAllServices(){try{const{configureApiService:t}=require("../services/ApiService");t(globalConfig)}catch(t){}}exports.DypaiClient=DypaiClient,exports.PACKAGE_INFO={name:"@dypai-ai/client-sdk",version:"0.0.1",description:"Cliente JavaScript para Dypai Engine",features:["API REST autenticada","Smart Storage (Upload/Download delegado)","Gestión de usuarios (Admin)"]},exports.callApi=callApi,exports.configureApiService=configureApiService,exports.configureDypaiServices=function(t){globalConfig={...globalConfig,toast:toast,...t},applyConfigToAllServices()},exports.createApiClient=createApiClient,exports.createClient=function(t,e,s){if(!t||!e)throw new Error("createClient() requiere URL y API Key");return new DypaiClient({baseUrl:t,apiKey:e,...s})},exports.getGlobalConfig=function(){return{...globalConfig}},exports.reloadDypaiConfig=async function(){applyConfigToAllServices()},exports.resetGlobalConfig=function(){globalConfig={},applyConfigToAllServices()},exports.setToastFunction=function(t){customToastFunction=t},exports.setTokenProvider=setTokenProvider,exports.toast=toast,exports.toastError=(t,e)=>toast({title:t,description:e,variant:"error"}),exports.toastInfo=(t,e)=>toast({title:t,description:e,variant:"info"}),exports.toastSuccess=(t,e)=>toast({title:t,description:e,variant:"success"}),exports.toastWarning=(t,e)=>toast({title:t,description:e,variant:"warning"}),exports.useToast=function(){const t=customToastFunction||fallbackToast;return{toast:t,toastSuccess:(e,s)=>t({title:e,description:s,variant:"success"}),toastError:(e,s)=>t({title:e,description:s,variant:"error"}),toastWarning:(e,s)=>t({title:e,description:s,variant:"warning"}),toastInfo:(e,s)=>t({title:e,description:s,variant:"info"})}};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@dypai-ai/client-sdk",
+  "version": "0.0.1",
+  "description": "Cliente JavaScript para Dypai Engine",
+  "type": "module",
+  "private": false,
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "build:watch": "rollup -c -w",
+    "dev": "NODE_ENV=development rollup -c -w",
+    "dev:watch": "NODE_ENV=development rollup -c -w",
+    "dev:test": "vite",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "clean": "rimraf dist",
+    "postbuild_DISABLED": "node scripts/obfuscate-dts.cjs",
+    "prepublishOnly": "npm run clean && npm run build && npm run type-check && node -e \"if(require('fs').existsSync('README.md.backup')) require('fs').unlinkSync('README.md.backup')\" && node -e \"require('fs').copyFileSync('README.md', 'README.md.backup')\" && node -e \"require('fs').writeFileSync('README.md', '# @dypai-ai/client-sdk\\n\\nCliente JavaScript para Dypai Engine.\\n\\nContacta al equipo de desarrollo para más información.')\"",
+    "postpublish": "node -e \"if(require('fs').existsSync('README.md.backup')) { require('fs').copyFileSync('README.md.backup', 'README.md'); require('fs').unlinkSync('README.md.backup'); }\"",
+    "publish:public": "npm publish --access public"
+  },
+  "keywords": [
+    "api",
+    "http",
+    "client",
+    "service"
+  ],
+  "author": "DYPAI Team",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@types/jest": "^29.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "dotenv": "^17.2.2",
+    "eslint": "^8.0.0",
+    "eslint-plugin-react": "^7.0.0",
+    "eslint-plugin-react-hooks": "^4.0.0",
+    "jest": "^29.0.0",
+    "rimraf": "^5.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-dts": "^6.0.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.0.0",
+    "vite": "^7.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}