@nsxbet/admin-sdk 0.5.0 → 0.6.0

package/dist/hooks/useTelemetry.d.ts

@@ -14,4 +14,3 @@ export interface UseTelemetryResult {
  * In standalone mode: Logs to console (or could send to local analytics)
  */
 export declare function useTelemetry(): UseTelemetryResult;
-//# sourceMappingURL=useTelemetry.d.ts.map

package/dist/hooks/useTimestamp.d.ts

@@ -0,0 +1,8 @@
+import type { TimezoneMode, TimestampFormat } from '../types/platform';
+export interface UseTimestampResult {
+    mode: TimezoneMode;
+    setMode: (mode: TimezoneMode) => void;
+    formatDate: (date: Date, format?: TimestampFormat) => string;
+    timezone: string;
+}
+export declare function useTimestamp(): UseTimestampResult;

package/dist/hooks/useTimestamp.js

@@ -0,0 +1,122 @@
+import { useEffect, useState, useCallback, useMemo } from 'react';
+import { usePlatformAPI } from './usePlatformAPI';
+import { useI18n } from './useI18n';
+const TIMEZONE_STORAGE_KEY = 'admin-timezone-mode';
+function getStoredTimezoneMode() {
+    if (typeof window === 'undefined')
+        return 'local';
+    const stored = localStorage.getItem(TIMEZONE_STORAGE_KEY);
+    if (stored === 'utc' || stored === 'local')
+        return stored;
+    return 'local';
+}
+function getRelativeTime(date, locale) {
+    const now = Date.now();
+    const diffMs = now - date.getTime();
+    const absDiffMs = Math.abs(diffMs);
+    const isFuture = diffMs < 0;
+    const SECOND = 1000;
+    const MINUTE = 60 * SECOND;
+    const HOUR = 60 * MINUTE;
+    const DAY = 24 * HOUR;
+    const MONTH = 30 * DAY;
+    const YEAR = 12 * MONTH;
+    if (absDiffMs < 60 * SECOND) {
+        return new Intl.RelativeTimeFormat(locale, { numeric: 'auto' }).format(0, 'second');
+    }
+    const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });
+    let value;
+    let unit;
+    if (absDiffMs < HOUR) {
+        value = Math.round(absDiffMs / MINUTE);
+        unit = 'minute';
+    }
+    else if (absDiffMs < DAY) {
+        value = Math.round(absDiffMs / HOUR);
+        unit = 'hour';
+    }
+    else if (absDiffMs < MONTH) {
+        value = Math.round(absDiffMs / DAY);
+        unit = 'day';
+    }
+    else if (absDiffMs < YEAR) {
+        value = Math.round(absDiffMs / MONTH);
+        unit = 'month';
+    }
+    else {
+        value = Math.round(absDiffMs / YEAR);
+        unit = 'year';
+    }
+    return rtf.format(isFuture ? value : -value, unit);
+}
+function formatDateValue(date, format, mode, locale) {
+    if (format === 'relative') {
+        return getRelativeTime(date, locale);
+    }
+    const tzOption = mode === 'utc' ? 'UTC' : undefined;
+    const suffix = mode === 'utc' ? ' UTC' : '';
+    let options;
+    switch (format) {
+        case 'date':
+            options = {
+                year: 'numeric',
+                month: 'short',
+                day: 'numeric',
+                timeZone: tzOption,
+            };
+            return new Intl.DateTimeFormat(locale, options).format(date);
+        case 'time':
+            options = {
+                hour: 'numeric',
+                minute: '2-digit',
+                second: '2-digit',
+                timeZone: tzOption,
+            };
+            return new Intl.DateTimeFormat(locale, options).format(date) + suffix;
+        case 'datetime':
+        default:
+            options = {
+                year: 'numeric',
+                month: 'short',
+                day: 'numeric',
+                hour: 'numeric',
+                minute: '2-digit',
+                second: '2-digit',
+                timeZone: tzOption,
+            };
+            return new Intl.DateTimeFormat(locale, options).format(date) + suffix;
+    }
+}
+export function useTimestamp() {
+    const { isShellMode, api } = usePlatformAPI();
+    const { locale } = useI18n();
+    const [standaloneMode, setStandaloneMode] = useState(getStoredTimezoneMode);
+    useEffect(() => {
+        if (isShellMode && api) {
+            setStandaloneMode(api.timestamp.mode);
+            const unsubscribe = api.timestamp.onModeChange((newMode) => {
+                setStandaloneMode(newMode);
+            });
+            return unsubscribe;
+        }
+    }, [isShellMode, api]);
+    const mode = isShellMode && api ? api.timestamp.mode : standaloneMode;
+    const setMode = useCallback((newMode) => {
+        if (isShellMode && api) {
+            api.timestamp.setMode(newMode);
+        }
+        else {
+            localStorage.setItem(TIMEZONE_STORAGE_KEY, newMode);
+            setStandaloneMode(newMode);
+        }
+    }, [isShellMode, api]);
+    const formatDate = useCallback((date, format = 'datetime') => {
+        return formatDateValue(date, format, mode, locale);
+    }, [mode, locale]);
+    const timezone = useMemo(() => {
+        if (mode === 'utc')
+            return 'UTC';
+        return Intl.DateTimeFormat().resolvedOptions().timeZone;
+    }, [mode]);
+    return { mode, setMode, formatDate, timezone };
+}

package/dist/i18n/config.d.ts

@@ -5,9 +5,28 @@
  */
 import i18n from 'i18next';
 export declare const SUPPORTED_LOCALES: readonly ["pt-BR", "es", "en-US", "ro"];
-export type SupportedLocale = typeof SUPPORTED_LOCALES[number];
+export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+/**
+ * Localized string value - one string per supported locale.
+ * Used for manifest title, description, and command titles.
+ */
+export type LocalizedField = Record<SupportedLocale, string>;
+/**
+ * Resolves a localized string for the given locale.
+ * Falls back to en-US if the locale is missing.
+ */
+export declare function resolveLocalizedString(value: LocalizedField | undefined, locale: string): string;
 export declare const LOCALE_FLAGS: Record<SupportedLocale, string>;
 export declare const LOCALE_NAMES: Record<SupportedLocale, string>;
+/**
+ * Register module translation bundles.
+ * If i18n is already initialized, registers immediately.
+ * Otherwise queues for application when initI18n() is called.
+ * Used by the Vite plugin's auto-injected registration code.
+ *
+ * Idempotent: subsequent calls for the same namespace are no-ops.
+ */
+export declare function registerModuleTranslations(namespace: string, translations: Record<string, Record<string, unknown>>): void;
 /**
  * Save locale to localStorage
  */
@@ -23,4 +42,3 @@ export declare function initI18n(): typeof i18n;
 export declare function isSupportedLocale(locale: string): locale is SupportedLocale;
 export { i18n };
 export default i18n;
-//# sourceMappingURL=config.d.ts.map

package/dist/i18n/config.js

@@ -10,6 +10,18 @@ import es from './locales/es.json';
 import enUS from './locales/en-US.json';
 import ro from './locales/ro.json';
 export const SUPPORTED_LOCALES = ['pt-BR', 'es', 'en-US', 'ro'];
+/**
+ * Resolves a localized string for the given locale.
+ * Falls back to en-US if the locale is missing.
+ */
+export function resolveLocalizedString(value, locale) {
+    if (!value || typeof value !== 'object')
+        return '';
+    const supported = value[locale];
+    if (typeof supported === 'string')
+        return supported;
+    return value['en-US'] ?? Object.values(value)[0] ?? '';
+}
 export const LOCALE_FLAGS = {
     'pt-BR': '🇧🇷',
     'es': '🇪🇸',
@@ -23,6 +35,35 @@ export const LOCALE_NAMES = {
     'ro': 'Română',
 };
 const STORAGE_KEY = 'adminPlatform.locale';
+const pendingTranslations = [];
+const registeredNamespaces = new Set();
+/**
+ * Register module translation bundles.
+ * If i18n is already initialized, registers immediately.
+ * Otherwise queues for application when initI18n() is called.
+ * Used by the Vite plugin's auto-injected registration code.
+ *
+ * Idempotent: subsequent calls for the same namespace are no-ops.
+ */
+export function registerModuleTranslations(namespace, translations) {
+    if (registeredNamespaces.has(namespace))
+        return;
+    registeredNamespaces.add(namespace);
+    if (import.meta.env?.DEV) {
+        const missing = SUPPORTED_LOCALES.filter(l => !(l in translations));
+        if (missing.length > 0) {
+            console.warn(`[i18n] registerModuleTranslations("${namespace}"): missing locales: ${missing.join(', ')}`);
+        }
+    }
+    if (i18n.isInitialized) {
+        for (const [lng, resources] of Object.entries(translations)) {
+            i18n.addResourceBundle(lng, namespace, resources, true, true);
+        }
+    }
+    else {
+        pendingTranslations.push({ namespace, translations });
+    }
+}
 /**
  * Get the saved locale from localStorage, or return default
  */
@@ -80,6 +121,13 @@ export function initI18n() {
             }
         },
     });
+    // Apply any module translations that were queued before init
+    for (const { namespace, translations } of pendingTranslations) {
+        for (const [lng, resources] of Object.entries(translations)) {
+            i18n.addResourceBundle(lng, namespace, resources, true, true);
+        }
+    }
+    pendingTranslations.length = 0;
     return i18n;
 }
 /**

package/dist/i18n/index.d.ts

@@ -1,6 +1,5 @@
 /**
  * i18n module exports
  */
-export { initI18n, saveLocale, isSupportedLocale, i18n, SUPPORTED_LOCALES, LOCALE_FLAGS, LOCALE_NAMES, } from './config';
-export type { SupportedLocale } from './config';
-//# sourceMappingURL=index.d.ts.map
+export { initI18n, saveLocale, isSupportedLocale, resolveLocalizedString, registerModuleTranslations, i18n, SUPPORTED_LOCALES, LOCALE_FLAGS, LOCALE_NAMES, } from './config';
+export type { SupportedLocale, LocalizedField } from './config';

package/dist/i18n/index.js

@@ -1,4 +1,4 @@
 /**
  * i18n module exports
  */
-export { initI18n, saveLocale, isSupportedLocale, i18n, SUPPORTED_LOCALES, LOCALE_FLAGS, LOCALE_NAMES, } from './config';
+export { initI18n, saveLocale, isSupportedLocale, resolveLocalizedString, registerModuleTranslations, i18n, SUPPORTED_LOCALES, LOCALE_FLAGS, LOCALE_NAMES, } from './config';

package/dist/i18n/locales/en-US.json

@@ -30,9 +30,14 @@
         "themeLight": "Light",
         "themeDark": "Dark",
         "themeSystem": "System",
-        "language": "Language"
+        "language": "Language",
+        "timezone": "Timezone",
+        "timezoneUtc": "UTC",
+        "timezoneLocal": "Local",
+        "timezoneToggleUtc": "Toggle timezone: currently UTC",
+        "timezoneToggleLocal": "Toggle timezone: currently Local"
     },
-    "nav": {
+    "navigation": {
         "home": "Home",
         "settings": "Settings",
         "profile": "Profile",
@@ -95,23 +100,40 @@
         "mode": "Mode",
         "apiMode": "API Mode",
         "inMemoryMode": "In-Memory Mode",
-        "addModule": "Add Module",
-        "addByUrl": "By URL",
-        "addByManifest": "By Manifest",
-        "moduleUrl": "Module URL",
-        "moduleUrlPlaceholder": "https://example.com/module",
-        "manifestJson": "Manifest JSON",
-        "manifestPlaceholder": "Paste the manifest JSON here...",
-        "register": "Register",
         "registeredModules": "Registered Modules",
         "noModules": "No modules registered",
-        "moduleId": "ID",
-        "moduleTitle": "Title",
-        "moduleCategory": "Category",
-        "moduleRoute": "Route",
-        "moduleBaseUrl": "Base URL",
-        "deleteModule": "Delete Module",
-        "deleteModuleConfirm": "Are you sure you want to delete this module?"
+        "noModulesHint": "Modules are registered through the CI/CD pipeline.",
+        "loadingModules": "Loading modules...",
+        "loadingVersions": "Loading versions...",
+        "enabled": "Enabled",
+        "disabled": "Disabled",
+        "unversioned": "unversioned",
+        "noDescription": "No description",
+        "versionHistory": "Version History",
+        "versionActive": "Active",
+        "noVersionHistory": "No version history available.",
+        "rollback": "Rollback",
+        "rollbackTitle": "Roll back to v{{version}}?",
+        "rollbackDescription": "{{name}} will be rolled back from v{{fromVersion}} to v{{toVersion}}. The current version will be replaced immediately for all users.",
+        "rollbackConfirm": "Confirm Rollback",
+        "rollingBack": "Rolling back...",
+        "rolledBackFrom": "rolled back from v{{version}}",
+        "disableTitle": "Disable {{name}}?",
+        "disableDescription": "This module will be removed from navigation for all users. Module routes will become inaccessible until re-enabled.",
+        "disableConfirm": "Disable Module",
+        "deleteConfirm": "Are you sure you want to delete \"{{name}}\"? This action cannot be undone.",
+        "manageOrder": "Manage Order",
+        "saveOrder": "Save Order",
+        "savingOrder": "Saving...",
+        "position": "#{{position}}",
+        "errorClientUnavailable": "Registry client not available. Please check configuration.",
+        "errorLoadModules": "Failed to load modules",
+        "errorUpdateModule": "Failed to update module",
+        "errorDisableModule": "Failed to disable module",
+        "errorDeleteModule": "Failed to delete module",
+        "errorLoadVersions": "Failed to load version history",
+        "errorRollback": "Failed to rollback module",
+        "errorSaveOrder": "Failed to save order"
     },
     "moduleOverview": {
         "title": "Module Overview",
@@ -128,6 +150,17 @@
         "support": "Support",
         "supportChannel": "Support Channel"
     },
+    "moduleError": {
+        "title": "Failed to Load Module",
+        "description": "An error occurred while loading the module.",
+        "ownerTeam": "Owner",
+        "supportChannel": "Support",
+        "retry": "Try Again",
+        "reload": "Reload Page",
+        "networkTitle": "Module Unavailable",
+        "networkDescription": "The module server is not responding. Please ensure the module is running.",
+        "contactHeading": "Report this issue"
+    },
     "errors": {
         "generic": "Something went wrong",
         "notFound": "Page not found",
@@ -138,7 +171,51 @@
         "moduleLoadFailed": "Failed to load module",
         "networkError": "Network error"
     },
+    "registryCache": {
+        "cachedMessage": "Using cached module data — registry unavailable",
+        "staleMessage": "Using outdated module data — registry unavailable for over 24 hours",
+        "unavailableTitle": "Admin Registry Unavailable",
+        "unavailableDescription": "Unable to load module catalog from the registry. Please check your connection and try again.",
+        "retry": "Retry",
+        "lastUpdated": "Last updated {{time}}"
+    },
+    "devtoolsPanel": {
+        "title": "Devtools",
+        "triggerLabel": "Open devtools panel",
+        "registry": "Registry",
+        "modules": "Modules",
+        "cacheStatus": "Cache Status",
+        "cspViolations": "CSP Violations",
+        "copyDebugInfo": "Copy debug info",
+        "copied": "Copied!",
+        "close": "Close",
+        "catalogVersion": "Catalog Version",
+        "generatedAt": "Generated At",
+        "registryMode": "Registry Mode",
+        "apiMode": "API Mode",
+        "inMemoryMode": "In-Memory Mode",
+        "fresh": "Fresh",
+        "cached": "Cached",
+        "stale": "Stale",
+        "unavailable": "Unavailable",
+        "cachedAt": "Cached At",
+        "enabled": "Enabled",
+        "disabled": "Disabled",
+        "noModules": "No modules registered",
+        "noViolations": "No violations recorded",
+        "cspHintConnect": "Add {{host}} to CSP_CONNECT_HOSTS",
+        "cspHintScript": "Add {{host}} to CSP_SCRIPT_HOSTS",
+        "cspHintGeneric": "CSP {{directive}} violation for {{uri}}",
+        "blockedUri": "Blocked URI",
+        "violatedDirective": "Violated Directive",
+        "hint": "Hint",
+        "baseUrl": "Base URL",
+        "id": "ID"
+    },
     "breadcrumbs": {
-        "home": "Home"
+        "home": "Home",
+        "registry": "Registry",
+        "settings": "Settings",
+        "profile": "Profile"
     }
 }

package/dist/i18n/locales/es.json

@@ -30,9 +30,14 @@
         "themeLight": "Claro",
         "themeDark": "Oscuro",
         "themeSystem": "Sistema",
-        "language": "Idioma"
+        "language": "Idioma",
+        "timezone": "Zona horaria",
+        "timezoneUtc": "UTC",
+        "timezoneLocal": "Local",
+        "timezoneToggleUtc": "Cambiar zona horaria: actualmente UTC",
+        "timezoneToggleLocal": "Cambiar zona horaria: actualmente Local"
     },
-    "nav": {
+    "navigation": {
         "home": "Inicio",
         "settings": "Configuración",
         "profile": "Perfil",
@@ -95,23 +100,40 @@
         "mode": "Modo",
         "apiMode": "Modo API",
         "inMemoryMode": "Modo En Memoria",
-        "addModule": "Agregar Módulo",
-        "addByUrl": "Por URL",
-        "addByManifest": "Por Manifiesto",
-        "moduleUrl": "URL del Módulo",
-        "moduleUrlPlaceholder": "https://ejemplo.com/modulo",
-        "manifestJson": "JSON del Manifiesto",
-        "manifestPlaceholder": "Pega el JSON del manifiesto aquí...",
-        "register": "Registrar",
         "registeredModules": "Módulos Registrados",
         "noModules": "No hay módulos registrados",
-        "moduleId": "ID",
-        "moduleTitle": "Título",
-        "moduleCategory": "Categoría",
-        "moduleRoute": "Ruta",
-        "moduleBaseUrl": "URL Base",
-        "deleteModule": "Eliminar Módulo",
-        "deleteModuleConfirm": "¿Estás seguro de que deseas eliminar este módulo?"
+        "noModulesHint": "Los módulos se registran a través del pipeline CI/CD.",
+        "loadingModules": "Cargando módulos...",
+        "loadingVersions": "Cargando versiones...",
+        "enabled": "Habilitado",
+        "disabled": "Deshabilitado",
+        "unversioned": "sin versión",
+        "noDescription": "Sin descripción",
+        "versionHistory": "Historial de Versiones",
+        "versionActive": "Activo",
+        "noVersionHistory": "No hay historial de versiones disponible.",
+        "rollback": "Revertir",
+        "rollbackTitle": "¿Revertir a v{{version}}?",
+        "rollbackDescription": "{{name}} será revertido de v{{fromVersion}} a v{{toVersion}}. La versión actual será reemplazada inmediatamente para todos los usuarios.",
+        "rollbackConfirm": "Confirmar Reversión",
+        "rollingBack": "Revirtiendo...",
+        "rolledBackFrom": "revertido de v{{version}}",
+        "disableTitle": "¿Deshabilitar {{name}}?",
+        "disableDescription": "Este módulo será eliminado de la navegación para todos los usuarios. Las rutas del módulo serán inaccesibles hasta que se rehabilite.",
+        "disableConfirm": "Deshabilitar Módulo",
+        "deleteConfirm": "¿Estás seguro de que deseas eliminar \"{{name}}\"? Esta acción no se puede deshacer.",
+        "manageOrder": "Gestionar Orden",
+        "saveOrder": "Guardar Orden",
+        "savingOrder": "Guardando...",
+        "position": "#{{position}}",
+        "errorClientUnavailable": "Cliente del registro no disponible. Verifica la configuración.",
+        "errorLoadModules": "Error al cargar módulos",
+        "errorUpdateModule": "Error al actualizar módulo",
+        "errorDisableModule": "Error al deshabilitar módulo",
+        "errorDeleteModule": "Error al eliminar módulo",
+        "errorLoadVersions": "Error al cargar historial de versiones",
+        "errorRollback": "Error al revertir módulo",
+        "errorSaveOrder": "Error al guardar orden"
     },
     "moduleOverview": {
         "title": "Vista General del Módulo",
@@ -128,6 +150,17 @@
         "support": "Soporte",
         "supportChannel": "Canal de Soporte"
     },
+    "moduleError": {
+        "title": "Error al Cargar Módulo",
+        "description": "Ocurrió un error al cargar el módulo.",
+        "ownerTeam": "Propietario",
+        "supportChannel": "Soporte",
+        "retry": "Intentar de Nuevo",
+        "reload": "Recargar Página",
+        "networkTitle": "Módulo No Disponible",
+        "networkDescription": "El servidor del módulo no responde. Asegúrate de que el módulo esté en ejecución.",
+        "contactHeading": "Reportar este problema"
+    },
     "errors": {
         "generic": "Algo salió mal",
         "notFound": "Página no encontrada",
@@ -138,7 +171,51 @@
         "moduleLoadFailed": "Error al cargar módulo",
         "networkError": "Error de conexión"
     },
+    "registryCache": {
+        "cachedMessage": "Usando datos de módulos en caché — registro no disponible",
+        "staleMessage": "Usando datos de módulos desactualizados — registro no disponible por más de 24 horas",
+        "unavailableTitle": "Registro Admin No Disponible",
+        "unavailableDescription": "No se pudo cargar el catálogo de módulos del registro. Verifica tu conexión e inténtalo de nuevo.",
+        "retry": "Reintentar",
+        "lastUpdated": "Última actualización {{time}}"
+    },
+    "devtoolsPanel": {
+        "title": "Devtools",
+        "triggerLabel": "Abrir panel de devtools",
+        "registry": "Registro",
+        "modules": "Módulos",
+        "cacheStatus": "Estado del Caché",
+        "cspViolations": "Violaciones CSP",
+        "copyDebugInfo": "Copiar info de depuración",
+        "copied": "¡Copiado!",
+        "close": "Cerrar",
+        "catalogVersion": "Versión del Catálogo",
+        "generatedAt": "Generado El",
+        "registryMode": "Modo del Registro",
+        "apiMode": "Modo API",
+        "inMemoryMode": "Modo En Memoria",
+        "fresh": "Actualizado",
+        "cached": "En Caché",
+        "stale": "Desactualizado",
+        "unavailable": "No Disponible",
+        "cachedAt": "En Caché Desde",
+        "enabled": "Habilitado",
+        "disabled": "Deshabilitado",
+        "noModules": "No hay módulos registrados",
+        "noViolations": "No se registraron violaciones",
+        "cspHintConnect": "Agrega {{host}} a CSP_CONNECT_HOSTS",
+        "cspHintScript": "Agrega {{host}} a CSP_SCRIPT_HOSTS",
+        "cspHintGeneric": "Violación CSP {{directive}} para {{uri}}",
+        "blockedUri": "URI Bloqueada",
+        "violatedDirective": "Directiva Violada",
+        "hint": "Pista",
+        "baseUrl": "URL Base",
+        "id": "ID"
+    },
     "breadcrumbs": {
-        "home": "Inicio"
+        "home": "Inicio",
+        "registry": "Registro",
+        "settings": "Configuración",
+        "profile": "Perfil"
     }
 }