amliq-dashboard 2.0.0

package/src/hooks/useConfig.ts

@@ -0,0 +1,35 @@
+import { useState, useEffect, useCallback } from 'react';
+import { configApi, TenantConfigResponse } from '../api/config';
+
+export function useConfig() {
+  const [config, setConfig] = useState<TenantConfigResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetchConfig = useCallback(async () => {
+    setLoading(true);
+    try {
+      const resp = await configApi.get();
+      setConfig(resp);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    fetchConfig();
+  }, [fetchConfig]);
+
+  const updateConfig = useCallback(
+    async (data: Partial<TenantConfigResponse>) => {
+      const resp = await configApi.update(data);
+      setConfig(resp);
+      return resp;
+    },
+    [],
+  );
+
+  return { config, loading, error, refetch: fetchConfig, updateConfig };
+}

package/src/hooks/useDebounce.test.ts

@@ -0,0 +1,84 @@
+import { renderHook, act } from '@testing-library/react'
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { useDebounce } from './useDebounce'
+
+beforeEach(() => {
+  vi.useFakeTimers()
+})
+
+afterEach(() => {
+  vi.useRealTimers()
+})
+
+describe('useDebounce', () => {
+  it('returns initial value immediately', () => {
+    const { result } = renderHook(() => useDebounce('initial'))
+    expect(result.current).toBe('initial')
+  })
+
+  it('debounces value changes', () => {
+    const { result, rerender } = renderHook(
+      ({ value }) => useDebounce(value, 300),
+      { initialProps: { value: 'first' } }
+    )
+
+    expect(result.current).toBe('first')
+
+    rerender({ value: 'second' })
+    expect(result.current).toBe('first')
+
+    act(() => { vi.advanceTimersByTime(300) })
+    expect(result.current).toBe('second')
+  })
+
+  it('respects custom delay', () => {
+    const { result, rerender } = renderHook(
+      ({ value }) => useDebounce(value, 500),
+      { initialProps: { value: 'initial' } }
+    )
+
+    rerender({ value: 'updated' })
+    act(() => { vi.advanceTimersByTime(300) })
+    expect(result.current).toBe('initial')
+
+    act(() => { vi.advanceTimersByTime(200) })
+    expect(result.current).toBe('updated')
+  })
+
+  it('uses default delay of 300ms', () => {
+    const { result, rerender } = renderHook(
+      ({ value }) => useDebounce(value),
+      { initialProps: { value: 'start' } }
+    )
+
+    rerender({ value: 'end' })
+    act(() => { vi.advanceTimersByTime(300) })
+    expect(result.current).toBe('end')
+  })
+
+  it('cancels previous timer on rapid changes', () => {
+    const { result, rerender } = renderHook(
+      ({ value }) => useDebounce(value, 300),
+      { initialProps: { value: 'a' } }
+    )
+
+    rerender({ value: 'b' })
+    act(() => { vi.advanceTimersByTime(100) })
+
+    rerender({ value: 'c' })
+    act(() => { vi.advanceTimersByTime(100) })
+
+    expect(result.current).toBe('a')
+
+    act(() => { vi.advanceTimersByTime(200) })
+    expect(result.current).toBe('c')
+  })
+
+  it('works with different types', () => {
+    const numberHook = renderHook(() => useDebounce(42, 300))
+    expect(numberHook.result.current).toBe(42)
+
+    const objectHook = renderHook(() => useDebounce({ key: 'value' }, 300))
+    expect(objectHook.result.current).toEqual({ key: 'value' })
+  })
+})

package/src/hooks/useDebounce.ts

@@ -0,0 +1,15 @@
+import { useEffect, useState } from 'react';
+
+export function useDebounce<T>(value: T, delay: number = 300): T {
+  const [debouncedValue, setDebouncedValue] = useState<T>(value);
+
+  useEffect(() => {
+    const handler = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+
+    return () => clearTimeout(handler);
+  }, [value, delay]);
+
+  return debouncedValue;
+}

package/src/hooks/useDirection.ts

@@ -0,0 +1,15 @@
+import { useEffect } from 'react'
+import { useTranslation } from 'react-i18next'
+import { isRTL } from '../i18n/config'
+
+export function useDirection() {
+  const { i18n } = useTranslation()
+  const dir = isRTL(i18n.language) ? 'rtl' : 'ltr'
+
+  useEffect(() => {
+    document.documentElement.dir = dir
+    document.documentElement.lang = i18n.language
+  }, [dir, i18n.language])
+
+  return dir
+}

package/src/hooks/useLists.ts

@@ -0,0 +1,34 @@
+import { useState, useEffect, useCallback } from 'react';
+import { listsApi, ListMeta } from '../api/lists';
+
+export function useLists() {
+  const [lists, setLists] = useState<ListMeta[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetchLists = useCallback(async () => {
+    setLoading(true);
+    try {
+      const resp = await listsApi.list();
+      setLists(resp.lists || []);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    fetchLists();
+  }, [fetchLists]);
+
+  const triggerSync = useCallback(
+    async (listId: string) => {
+      await listsApi.sync(listId);
+      await fetchLists();
+    },
+    [fetchLists],
+  );
+
+  return { lists, loading, error, refetch: fetchLists, triggerSync };
+}

package/src/hooks/useMediaQuery.test.ts

@@ -0,0 +1,97 @@
+import { renderHook, act } from '@testing-library/react'
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { useMediaQuery, useIsMobile, useIsTablet, useIsDesktop } from './useMediaQuery'
+
+let listeners: Array<() => void> = []
+let mockMatches = false
+
+function createMockMediaQuery() {
+  return {
+    get matches() { return mockMatches },
+    media: '',
+    addEventListener: vi.fn((_e: string, cb: () => void) => {
+      listeners.push(cb)
+    }),
+    removeEventListener: vi.fn((_e: string, cb: () => void) => {
+      listeners = listeners.filter((l) => l !== cb)
+    }),
+    addListener: vi.fn(),
+    removeListener: vi.fn(),
+    dispatchEvent: vi.fn(),
+    onchange: null,
+  }
+}
+
+beforeEach(() => {
+  listeners = []
+  mockMatches = false
+  vi.spyOn(window, 'matchMedia').mockImplementation(
+    () => createMockMediaQuery() as unknown as MediaQueryList
+  )
+})
+
+afterEach(() => {
+  vi.restoreAllMocks()
+})
+
+describe('useMediaQuery', () => {
+  it('returns false initially', () => {
+    const { result } = renderHook(() => useMediaQuery('(min-width: 768px)'))
+    expect(result.current).toBe(false)
+  })
+
+  it('returns match result from window.matchMedia', () => {
+    const { result } = renderHook(() => useMediaQuery('(max-width: 639px)'))
+    expect(typeof result.current).toBe('boolean')
+  })
+
+  it('responds to media query changes', () => {
+    const { result } = renderHook(() => useMediaQuery('(min-width: 768px)'))
+    expect(result.current).toBe(false)
+
+    mockMatches = true
+    act(() => { listeners.forEach((l) => l()) })
+
+    expect(result.current).toBe(true)
+  })
+
+  it('cleans up event listener on unmount', () => {
+    const { unmount } = renderHook(() => useMediaQuery('(min-width: 768px)'))
+    unmount()
+    expect(window.matchMedia('').removeEventListener).toBeDefined()
+  })
+})
+
+describe('useIsMobile', () => {
+  it('returns mobile breakpoint match', () => {
+    const { result } = renderHook(() => useIsMobile())
+    expect(typeof result.current).toBe('boolean')
+  })
+
+  it('queries max-width 639px', () => {
+    renderHook(() => useIsMobile())
+    expect(window.matchMedia).toHaveBeenCalledWith('(max-width: 639px)')
+  })
+})
+
+describe('useIsTablet', () => {
+  it('returns tablet breakpoint match', () => {
+    const { result } = renderHook(() => useIsTablet())
+    expect(typeof result.current).toBe('boolean')
+  })
+
+  it('queries tablet range', () => {
+    renderHook(() => useIsTablet())
+    expect(window.matchMedia).toHaveBeenCalledWith(
+      '(min-width: 640px) and (max-width: 1023px)'
+    )
+  })
+})
+
+describe('useIsDesktop', () => {
+  it('returns boolean and queries correct breakpoint', () => {
+    const { result } = renderHook(() => useIsDesktop())
+    expect(typeof result.current).toBe('boolean')
+    expect(window.matchMedia).toHaveBeenCalledWith('(min-width: 1024px)')
+  })
+})

package/src/hooks/useMediaQuery.ts

@@ -0,0 +1,28 @@
+import { useState, useEffect } from 'react';
+
+export function useMediaQuery(query: string): boolean {
+  const [matches, setMatches] = useState(false);
+
+  useEffect(() => {
+    const media = window.matchMedia(query);
+    if (media.matches !== matches) setMatches(media.matches);
+
+    const listener = () => setMatches(media.matches);
+    media.addEventListener('change', listener);
+    return () => media.removeEventListener('change', listener);
+  }, [matches, query]);
+
+  return matches;
+}
+
+export function useIsMobile() {
+  return useMediaQuery('(max-width: 639px)');
+}
+
+export function useIsTablet() {
+  return useMediaQuery('(min-width: 640px) and (max-width: 1023px)');
+}
+
+export function useIsDesktop() {
+  return useMediaQuery('(min-width: 1024px)');
+}

package/src/hooks/useScreening.ts

@@ -0,0 +1,33 @@
+import { useState, useCallback } from 'react';
+import { screeningApi, ScreenPayload } from '../api/screening';
+import type { ScreenResponse } from '../types';
+
+export function useScreening() {
+  const [result, setResult] = useState<ScreenResponse | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+
+  const screen = useCallback(async (data: ScreenPayload) => {
+    setLoading(true);
+    setError(null);
+    setResult(null);
+    try {
+      const resp = await screeningApi.screen(data);
+      setResult(resp);
+      return resp;
+    } catch (err) {
+      const e = err instanceof Error ? err : new Error(String(err));
+      setError(e);
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const clear = useCallback(() => {
+    setResult(null);
+    setError(null);
+  }, []);
+
+  return { result, loading, error, screen, clear };
+}

package/src/hooks/useSidebar.ts

@@ -0,0 +1,18 @@
+import { useState, useEffect } from 'react';
+import { useIsMobile } from './useMediaQuery';
+
+export function useSidebar() {
+  const isMobile = useIsMobile();
+  const [isOpen, setIsOpen] = useState(!isMobile);
+
+  useEffect(() => {
+    setIsOpen(!isMobile);
+  }, [isMobile]);
+
+  return {
+    isOpen,
+    toggle: () => setIsOpen((v) => !v),
+    close: () => setIsOpen(false),
+    open: () => setIsOpen(true),
+  };
+}

package/src/hooks/useUsage.ts

@@ -0,0 +1,27 @@
+import { useState, useEffect, useCallback } from 'react'
+import * as billingApi from '../api/billing'
+import type { UsageRecord } from '../types/billing'
+
+export function useUsage(product?: string) {
+  const [usage, setUsage] = useState<UsageRecord | null>(null)
+  const [loading, setLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+
+  const fetch = useCallback(async () => {
+    if (!product) { setLoading(false); return }
+    setLoading(true)
+    try {
+      const rec = await billingApi.getUsage(product)
+      setUsage(rec)
+      setError(null)
+    } catch (e) {
+      setError(e instanceof Error ? e.message : 'Failed to load usage')
+    } finally {
+      setLoading(false)
+    }
+  }, [product])
+
+  useEffect(() => { fetch() }, [fetch])
+
+  return { usage, loading, error, refetch: fetch }
+}

package/src/i18n/config.ts

@@ -0,0 +1,33 @@
+import i18n from 'i18next'
+import { initReactI18next } from 'react-i18next'
+import LanguageDetector from 'i18next-browser-languagedetector'
+import en from './locales/en'
+import he from './locales/he'
+import ar from './locales/ar'
+
+export const defaultNS = 'common'
+export const RTL_LANGUAGES = ['he', 'ar']
+
+export const resources = { en, he, ar } as const
+
+export function isRTL(lang: string): boolean {
+  return RTL_LANGUAGES.includes(lang)
+}
+
+i18n
+  .use(LanguageDetector)
+  .use(initReactI18next)
+  .init({
+    resources,
+    defaultNS,
+    fallbackLng: 'en',
+    supportedLngs: ['en', 'he', 'ar'],
+    interpolation: { escapeValue: false },
+    detection: {
+      order: ['localStorage', 'navigator'],
+      caches: ['localStorage'],
+      lookupLocalStorage: 'amliq_lang',
+    },
+  })
+
+export default i18n

package/src/i18n/locales/ar/admin.json

@@ -0,0 +1,19 @@
+{
+  "tenants": {
+    "title": "الإدارة: المستأجرون",
+    "search_placeholder": "بحث في المستأجرين..."
+  },
+  "tenant_detail": {
+    "screening_history": "سجل الفحص",
+    "total_screenings": "إجمالي عمليات الفحص",
+    "config_override": "تجاوز الإعدادات",
+    "match_threshold": "حد المطابقة (%)",
+    "save": "حفظ"
+  },
+  "health": {
+    "title": "صحة النظام",
+    "api_status": "حالة API",
+    "database": "قاعدة البيانات",
+    "version": "الإصدار"
+  }
+}

package/src/i18n/locales/ar/alerts.json

@@ -0,0 +1,52 @@
+{
+  "queue": {
+    "title": "قائمة التنبيهات",
+    "no_alerts": "لا توجد تنبيهات",
+    "all_clear": "الكل واضح"
+  },
+  "filters": {
+    "status": "الحالة",
+    "priority": "الأولوية",
+    "open": "مفتوح",
+    "investigating": "قيد التحقيق",
+    "resolved": "تم الحل",
+    "archived": "مؤرشف",
+    "critical": "حرج",
+    "high": "مرتفع",
+    "medium": "متوسط",
+    "low": "منخفض"
+  },
+  "card": {
+    "risk": "المخاطر:"
+  },
+  "detail": {
+    "not_found": "التنبيه غير موجود"
+  },
+  "actions": {
+    "title": "الإجراءات",
+    "confirm": "تأكيد",
+    "false_positive": "إيجابي كاذب",
+    "escalate": "تصعيد",
+    "ai_draft": "مسودة الذكاء الاصطناعي"
+  },
+  "sidebar": {
+    "status": "الحالة",
+    "current_status": "الحالة الحالية",
+    "priority": "الأولوية",
+    "risk_level": "مستوى المخاطر",
+    "investigator": "المحقق",
+    "timeline": "الجدول الزمني"
+  },
+  "entity_details": {
+    "title": "تفاصيل الكيان",
+    "type": "النوع",
+    "nationality": "الجنسية",
+    "dob": "تاريخ الميلاد",
+    "matches_found": "التطابقات الموجودة"
+  },
+  "notes": {
+    "title": "ملاحظات التحقيق",
+    "placeholder": "أضف ملاحظات التحقيق...",
+    "save": "حفظ الملاحظات"
+  }
+}

package/src/i18n/locales/ar/analytics.json

@@ -0,0 +1,9 @@
+{
+  "title": "التحليلات",
+  "description": "مقاييس الفحص والتنبيهات",
+  "charts": {
+    "screening_volume": "حجم الفحص",
+    "alert_disposition": "توزيع التنبيهات",
+    "risk_distribution": "توزيع المخاطر"
+  }
+}

package/src/i18n/locales/ar/audit.json

@@ -0,0 +1,12 @@
+{
+  "title": "سجل التدقيق",
+  "description": "سجل النشاط الكامل",
+  "actions": {
+    "screen_initiated": "بدء الفحص",
+    "alert_created": "إنشاء تنبيه",
+    "alert_resolved": "حل التنبيه",
+    "config_updated": "تحديث الإعدادات",
+    "list_imported": "استيراد قائمة",
+    "export_generated": "إنشاء تصدير"
+  }
+}

package/src/i18n/locales/ar/auth.json

@@ -0,0 +1,60 @@
+{
+  "login": {
+    "title": "تسجيل الدخول إلى AMLIQ",
+    "subtitle": "اختر طريقة تسجيل الدخول",
+    "email_placeholder": "you@company.com",
+    "password_placeholder": "كلمة المرور",
+    "forgot_password": "نسيت كلمة المرور؟",
+    "submit": "تسجيل الدخول",
+    "submitting": "جارٍ تسجيل الدخول...",
+    "no_account": "ليس لديك حساب؟",
+    "start_trial": "ابدأ التجربة المجانية",
+    "failed": "فشل تسجيل الدخول"
+  },
+  "login_panel": {
+    "welcome": "مرحباً بعودتك",
+    "description": "محرك الفحص الخاص بك يعمل. لوحة الامتثال في انتظارك.",
+    "feature_ai": "محرك فحص بالذكاء الاصطناعي من 6 طبقات",
+    "feature_lists": "أكثر من {{listCount}} قائمة عقوبات عالمية",
+    "feature_speed": "زمن مطابقة أقل من 50 مللي ثانية"
+  },
+  "signup": {
+    "title": "ابدأ تجربتك المجانية",
+    "subtitle": "14 يوماً مجاناً. لا حاجة لبطاقة ائتمان.",
+    "org_placeholder": "اسم المؤسسة",
+    "email_placeholder": "البريد الإلكتروني للعمل",
+    "password_placeholder": "كلمة المرور",
+    "min_chars": "8 أحرف كحد أدنى",
+    "submit": "إنشاء حساب",
+    "submitting": "جارٍ إنشاء الحساب...",
+    "agree_prefix": "بالتسجيل فإنك توافق على",
+    "terms_link": "الشروط",
+    "and": "و",
+    "privacy_link": "سياسة الخصوصية",
+    "have_account": "لديك حساب بالفعل؟",
+    "sign_in_link": "تسجيل الدخول",
+    "failed": "فشل إنشاء الحساب"
+  },
+  "signup_panel": {
+    "tagline": "فحص مكافحة غسل الأموال الذي لا يفوّت شيئاً",
+    "description": "استبدل الأدوات المكلفة وغير الشفافة بمطابقة قابلة للتخصيص مدعومة بالذكاء الاصطناعي.",
+    "perk_ai": "محرك مطابقة بالذكاء الاصطناعي من 6 طبقات",
+    "perk_lists": "أكثر من {{listCount}} قائمة عقوبات مضمّنة",
+    "perk_compliance": "بنية أمان أولاً",
+    "perk_speed": "زمن فحص أقل من 50 مللي ثانية"
+  },
+  "forgot": {
+    "title": "إعادة تعيين كلمة المرور",
+    "description": "أدخل عنوان البريد الإلكتروني المرتبط بحسابك وسنرسل لك رابط إعادة التعيين.",
+    "back_to_login": "العودة لتسجيل الدخول",
+    "email_placeholder": "عنوان البريد الإلكتروني",
+    "submit": "إرسال رابط إعادة التعيين",
+    "success_title": "تحقق من بريدك الوارد",
+    "success_message": "إذا كان هناك حساب مرتبط بـ {{email}}، فستتلقى رابط إعادة تعيين كلمة المرور قريباً."
+  },
+  "oauth": {
+    "continue_with": "المتابعة عبر {{provider}}",
+    "sign_up_with": "التسجيل عبر {{provider}}",
+    "or_continue_email": "أو المتابعة عبر البريد الإلكتروني"
+  }
+}

package/src/i18n/locales/ar/batch.json

@@ -0,0 +1,5 @@
+{
+  "title": "المهام المجمّعة",
+  "description": "إدارة عمليات الفحص المجمّعة",
+  "new_job": "مهمة جديدة"
+}

package/src/i18n/locales/ar/billing.json

@@ -0,0 +1,41 @@
+{
+  "title": "الفوترة والاشتراكات",
+  "subtitle": "إدارة المنتجات والاستخدام والفواتير",
+  "add_product": "إضافة منتج",
+  "sections": {
+    "active_subscriptions": "الاشتراكات النشطة",
+    "dashboard_seats": "مقاعد لوحة المعلومات",
+    "promo_code": "رمز ترويجي",
+    "usage_history": "الاستخدام والسجل",
+    "invoices": "الفواتير"
+  },
+  "subscriptions": {
+    "no_subscriptions": "لا توجد اشتراكات نشطة",
+    "current_plan": "الخطة الحالية",
+    "renews_on": "يتجدد في",
+    "manage": "إدارة الاشتراك",
+    "change_plan": "تغيير الخطة"
+  },
+  "seats": {
+    "email_placeholder": "user@company.com",
+    "investigator": "محقق",
+    "analyst": "محلل",
+    "manager": "مدير",
+    "used": "{{current}} من {{total}} مقعد مستخدم"
+  },
+  "promo": {
+    "placeholder": "أدخل الرمز الترويجي",
+    "apply": "تطبيق",
+    "discount": "تم تطبيق خصم {{percent}}%"
+  },
+  "pricing": {
+    "title": "خمسة منتجات قوية",
+    "subtitle": "اختر وادمج. ابدأ ببساطة، وتوسّع بسرعة. بدون رسوم إعداد.",
+    "most_popular": "الأكثر شعبية",
+    "per_month": "/شهر",
+    "billed_yearly": "يُفوتر ${{price}}/سنة",
+    "custom": "مخصص",
+    "get_started": "ابدأ الآن",
+    "contact_sales": "تواصل مع المبيعات"
+  }
+}