@tinyweb_dev/oe-exam-sdk 0.1.1 → 0.1.2

package/dist/shared/lib/hooks/useConfirmDialog.js

@@ -1,89 +1 @@
-'use client';
-import { useCallback, useState } from 'react';
-const DEFAULT_CONFIG = {
-    confirmLabel: 'Confirm',
-    cancelLabel: 'Cancel',
-    isDestructive: false,
-};
-/**
- * Hook for managing confirmation dialogs
- * Use this when you need user confirmation before performing an action
- *
- * @example
- * const { isOpen, config, confirm } = useConfirmDialog();
- *
- * const handleDelete = () => {
- *   confirm({
- *     title: 'Delete Item',
- *     description: 'Are you sure you want to delete this item?',
- *     isDestructive: true,
- *     onConfirm: async () => {
- *       await deleteItem();
- *     }
- *   });
- * };
- */
-export function useConfirmDialog() {
-    const [state, setState] = useState({
-        isOpen: false,
-        isLoading: false,
-        title: '',
-        description: '',
-        ...DEFAULT_CONFIG,
-    });
-    const confirm = useCallback((config) => {
-        setState((prev) => ({
-            ...prev,
-            ...config,
-            isOpen: true,
-            isLoading: false,
-            onConfirm: config.onConfirm,
-            onCancel: config.onCancel,
-        }));
-    }, []);
-    const close = useCallback(() => {
-        setState((prev) => ({
-            ...prev,
-            isOpen: false,
-        }));
-    }, []);
-    const setLoading = useCallback((isLoading) => {
-        setState((prev) => ({
-            ...prev,
-            isLoading,
-        }));
-    }, []);
-    const handleConfirm = useCallback(async () => {
-        if (state.onConfirm) {
-            try {
-                setLoading(true);
-                await state.onConfirm();
-                close();
-            }
-            finally {
-                setLoading(false);
-            }
-        }
-    }, [state.onConfirm, setLoading, close]);
-    const handleCancel = useCallback(() => {
-        if (state.onCancel) {
-            state.onCancel();
-        }
-        close();
-    }, [state.onCancel, close]);
-    return {
-        isOpen: state.isOpen,
-        isLoading: state.isLoading,
-        config: {
-            title: state.title,
-            description: state.description,
-            confirmLabel: state.confirmLabel || DEFAULT_CONFIG.confirmLabel,
-            cancelLabel: state.cancelLabel || DEFAULT_CONFIG.cancelLabel,
-            isDestructive: state.isDestructive || DEFAULT_CONFIG.isDestructive,
-        },
-        confirm,
-        close,
-        handleConfirm,
-        handleCancel,
-    };
-}
+"use client";import{useCallback as n,useState as i}from"react";const e={confirmLabel:"Confirm",cancelLabel:"Cancel",isDestructive:!1};export function useConfirmDialog(){const[o,c]=i({isOpen:!1,isLoading:!1,title:"",description:"",...e}),a=n(n=>{c(i=>({...i,...n,isOpen:!0,isLoading:!1,onConfirm:n.onConfirm,onCancel:n.onCancel}))},[]),l=n(()=>{c(n=>({...n,isOpen:!1}))},[]),r=n(n=>{c(i=>({...i,isLoading:n}))},[]),s=n(async()=>{if(o.onConfirm)try{r(!0),await o.onConfirm(),l()}finally{r(!1)}},[o.onConfirm,r,l]),t=n(()=>{o.onCancel&&o.onCancel(),l()},[o.onCancel,l]);return{isOpen:o.isOpen,isLoading:o.isLoading,config:{title:o.title,description:o.description,confirmLabel:o.confirmLabel||e.confirmLabel,cancelLabel:o.cancelLabel||e.cancelLabel,isDestructive:o.isDestructive||e.isDestructive},confirm:a,close:l,handleConfirm:s,handleCancel:t}}

package/dist/shared/lib/hooks/useDebouncedCallback.js

@@ -1,32 +1 @@
-import { useCallback, useRef, useEffect } from 'react';
-/**
- * Custom hook for debouncing a callback function
- * @param callback The function to debounce
- * @param delay The debounce delay in milliseconds
- * @returns A debounced version of the callback
- */
-export function useDebouncedCallback(callback, delay) {
-    const callbackRef = useRef(callback);
-    const timeoutRef = useRef(null);
-    // Keep callback ref up to date
-    useEffect(() => {
-        callbackRef.current = callback;
-    }, [callback]);
-    // Cleanup timeout on unmount
-    useEffect(() => {
-        return () => {
-            if (timeoutRef.current) {
-                clearTimeout(timeoutRef.current);
-            }
-        };
-    }, []);
-    const debouncedCallback = useCallback((...args) => {
-        if (timeoutRef.current) {
-            clearTimeout(timeoutRef.current);
-        }
-        timeoutRef.current = setTimeout(() => {
-            callbackRef.current(...args);
-        }, delay);
-    }, [delay]);
-    return debouncedCallback;
-}
+import{useCallback as r,useRef as e,useEffect as t}from"react";export function useDebouncedCallback(u,c){const n=e(u),o=e(null);t(()=>{n.current=u},[u]),t(()=>()=>{o.current&&clearTimeout(o.current)},[]);return r((...r)=>{o.current&&clearTimeout(o.current),o.current=setTimeout(()=>{n.current(...r)},c)},[c])}

package/dist/shared/lib/hooks/useDelayedAutoPlay.js

@@ -1,12 +1 @@
-'use client';
-import { useEffect } from 'react';
-export const DEFAULT_AUTO_PLAY_DELAY_MS = 3000;
-export function useDelayedAutoPlay({ audioRef, audioUrl, delayMs = DEFAULT_AUTO_PLAY_DELAY_MS, enabled = true }) {
-    useEffect(() => {
-        if (!enabled || !audioRef.current || !audioUrl)
-            return;
-        const audio = audioRef.current;
-        const timer = window.setTimeout(() => { void audio.play().catch(() => undefined); }, delayMs);
-        return () => window.clearTimeout(timer);
-    }, [audioRef, audioUrl, delayMs, enabled]);
-}
+"use client";import{useEffect as e}from"react";export const DEFAULT_AUTO_PLAY_DELAY_MS=3e3;export function useDelayedAutoPlay({audioRef:t,audioUrl:r,delayMs:o=3e3,enabled:n=!0}){e(()=>{if(!n||!t.current||!r)return;const e=t.current,u=window.setTimeout(()=>{e.play().catch(()=>{})},o);return()=>window.clearTimeout(u)},[t,r,o,n])}

package/dist/shared/lib/hooks/useFileUpload.js

@@ -1,24 +1 @@
-import { useState, useCallback } from 'react';
-export function useFileUpload(options = {}) {
-    const [isUploading, setIsUploading] = useState(false);
-    const [error, setError] = useState(null);
-    const uploadFile = useCallback(async (file) => {
-        setIsUploading(true);
-        setError(null);
-        try {
-            const url = URL.createObjectURL(file);
-            options.onSuccess?.(url, url);
-            return { key: url, presignedUrl: url };
-        }
-        catch (err) {
-            const error = err instanceof Error ? err : new Error('Upload failed');
-            setError(error);
-            options.onError?.(error);
-            return null;
-        }
-        finally {
-            setIsUploading(false);
-        }
-    }, [options]);
-    return { uploadFile, isUploading, error };
-}
+import{useState as r,useCallback as n}from"react";export function useFileUpload(e={}){const[o,l]=r(!1),[t,c]=r(null),a=n(async r=>{l(!0),c(null);try{const n=URL.createObjectURL(r);return e.onSuccess?.(n,n),{key:n,presignedUrl:n}}catch(r){const n=r instanceof Error?r:new Error("Upload failed");return c(n),e.onError?.(n),null}finally{l(!1)}},[e]);return{uploadFile:a,isUploading:o,error:t}}

package/dist/shared/lib/hooks/useImageUrl.js

@@ -1,5 +1 @@
-'use client';
-import { usePresignedFileUrl } from './usePresignedFileUrl';
-export function useImageUrl(src) {
-    return usePresignedFileUrl(src).previewUrl || src || '';
-}
+"use client";import{usePresignedFileUrl as e}from"./usePresignedFileUrl";export function useImageUrl(r){return e(r).previewUrl||r||""}

package/dist/shared/lib/hooks/usePresignedFileUrl.js

@@ -1,10 +1 @@
-import { useMemo } from 'react';
-export function usePresignedFileUrl(fileKey) {
-    const previewUrl = useMemo(() => fileKey || '', [fileKey]);
-    return {
-        // Components-only SDK: host should pass displayable URLs. Storage-key resolving belongs to the host app.
-        previewUrl,
-        isLoading: false,
-        error: null,
-    };
-}
+import{useMemo as r}from"react";export function usePresignedFileUrl(e){return{previewUrl:r(()=>e||"",[e]),isLoading:!1,error:null}}

package/dist/shared/lib/hooks/useReactHookForm.js

@@ -1,31 +1 @@
-import { useForm as useRHF } from 'react-hook-form';
-import { zodResolver } from '@hookform/resolvers/zod';
-/**
- * Wrapper hook cho React Hook Form với Zod integration
- * Cung cấp interface đơn giản hơn và tích hợp sẵn Zod resolver
- */
-export const useReactHookForm = (options) => {
-    const { zodSchema, ...formOptions } = options;
-    const form = useRHF({
-        resolver: zodSchema ? zodResolver(zodSchema) : undefined,
-        mode: 'onSubmit',
-        reValidateMode: 'onChange', // After errors appear, re-validate on change to clear them
-        ...formOptions,
-    });
-    return {
-        ...form,
-        // Helper methods for easier usage
-        setFieldValue: (field, value) => {
-            form.setValue(field, value, { shouldValidate: true });
-        },
-        clearFieldError: (field) => {
-            form.clearErrors(field);
-        },
-        hasError: (field) => {
-            return !!form.formState.errors[field];
-        },
-        getFieldError: (field) => {
-            return form.formState.errors[field]?.message;
-        },
-    };
-};
+import{useForm as r}from"react-hook-form";import{zodResolver as o}from"@hookform/resolvers/zod";export const useReactHookForm=e=>{const{zodSchema:t,...a}=e,s=r({resolver:t?o(t):void 0,mode:"onSubmit",reValidateMode:"onChange",...a});return{...s,setFieldValue:(r,o)=>{s.setValue(r,o,{shouldValidate:!0})},clearFieldError:r=>{s.clearErrors(r)},hasError:r=>!!s.formState.errors[r],getFieldError:r=>s.formState.errors[r]?.message}};

package/dist/shared/lib/hooks/useToast.js

@@ -1,62 +1 @@
-'use client';
-import { toast } from 'sonner';
-import { useCallback } from 'react';
-/**
- * Hook for showing toast notifications using Sonner
- * Use this hook instead of alert() for non-blocking notifications
- *
- * @example
- * const { success, error, info, warning } = useToast();
- *
- * success({
- *   message: 'Success!',
- *   description: 'Your action was completed'
- * });
- *
- * error({
- *   message: 'Error!',
- *   description: 'Something went wrong'
- * });
- */
-export function useToast() {
-    const success = useCallback((config) => {
-        toast.success(config.message, {
-            description: config.description,
-            duration: config.duration,
-            action: config.action,
-        });
-    }, []);
-    const error = useCallback((config) => {
-        toast.error(config.message, {
-            description: config.description,
-            duration: config.duration,
-            action: config.action,
-        });
-    }, []);
-    const info = useCallback((config) => {
-        toast.info(config.message, {
-            description: config.description,
-            duration: config.duration,
-            action: config.action,
-        });
-    }, []);
-    const warning = useCallback((config) => {
-        toast.warning(config.message, {
-            description: config.description,
-            duration: config.duration,
-            action: config.action,
-        });
-    }, []);
-    const loading = useCallback((config) => {
-        toast.loading(config.message, {
-            description: config.description,
-        });
-    }, []);
-    return {
-        success,
-        error,
-        info,
-        warning,
-        loading,
-    };
-}
+"use client";import{toast as i}from"sonner";import{useCallback as n}from"react";export function useToast(){return{success:n(n=>{i.success(n.message,{description:n.description,duration:n.duration,action:n.action})},[]),error:n(n=>{i.error(n.message,{description:n.description,duration:n.duration,action:n.action})},[]),info:n(n=>{i.info(n.message,{description:n.description,duration:n.duration,action:n.action})},[]),warning:n(n=>{i.warning(n.message,{description:n.description,duration:n.duration,action:n.action})},[]),loading:n(n=>{i.loading(n.message,{description:n.description})},[])}}

package/dist/shared/lib/i18n/index.js

@@ -1,54 +1 @@
-import { useCallback } from 'react';
-import { useLocaleStore } from '../../lib/stores/localeStore';
-import vi from './messages/vi';
-import en from './messages/en';
-export const SUPPORTED_LOCALES = ['vi', 'en'];
-const messages = { vi, en };
-/** Get the current locale from Zustand store (works outside React components) */
-export function getLocale() {
-    return useLocaleStore.getState().locale;
-}
-/**
- * Translate a message key with optional parameter interpolation.
- *
- * Lookup order: messages[currentLocale] → messages['vi'] → raw key.
- *
- * **Non-reactive** — reads locale via `getState()` (snapshot).
- * Use in toast callbacks, event handlers, or outside React components.
- * For reactive usage inside components, use `useT()` instead.
- *
- * @example
- * t('common.http.400')
- * t('admin.exam.copy.success', { name: 'Exam 01', count: '10' })
- */
-export function t(key, params) {
-    const locale = getLocale();
-    let message = messages[locale]?.[key] ?? messages.vi[key] ?? key;
-    if (params) {
-        Object.entries(params).forEach(([k, v]) => {
-            message = message.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v));
-        });
-    }
-    return message;
-}
-/**
- * Reactive translation hook — subscribes to locale changes via Zustand.
- *
- * Components using `useT()` will re-render when the user switches language.
- *
- * @example
- * const t = useT();
- * return <h1>{t('admin.reports.title')}</h1>;
- */
-export function useT() {
-    const locale = useLocaleStore((s) => s.locale);
-    return useCallback((key, params) => {
-        let message = messages[locale]?.[key] ?? messages.vi[key] ?? key;
-        if (params) {
-            Object.entries(params).forEach(([k, v]) => {
-                message = message.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v));
-            });
-        }
-        return message;
-    }, [locale]);
-}
+import{useCallback as e}from"react";import{useLocaleStore as r}from"../../lib/stores/localeStore";import o from"./messages/vi";import n from"./messages/en";export const SUPPORTED_LOCALES=["vi","en"];const c={vi:o,en:n};export function getLocale(){return r.getState().locale}export function t(e,r){const o=getLocale();let n=c[o]?.[e]??c.vi[e]??e;return r&&Object.entries(r).forEach(([e,r])=>{n=n.replace(new RegExp(`\\{${e}\\}`,"g"),String(r))}),n}export function useT(){const o=r(e=>e.locale);return e((e,r)=>{let n=c[o]?.[e]??c.vi[e]??e;return r&&Object.entries(r).forEach(([e,r])=>{n=n.replace(new RegExp(`\\{${e}\\}`,"g"),String(r))}),n},[o])}