@next-vibe/checker 1.0.11 → 1.0.13

package/src/app/api/[locale]/i18n/de/index.ts

@@ -0,0 +1,13 @@
+import { translations as sharedTranslations } from "../../shared/i18n/de";
+import { translations as sharedUtilsTranslations } from "../../shared/utils/i18n/de";
+import { translations as systemTranslations } from "../../system/i18n/de";
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  shared: {
+    ...sharedTranslations,
+    utils: sharedUtilsTranslations,
+  },
+
+  system: systemTranslations,
+};

package/src/app/api/[locale]/i18n/en/index.ts

@@ -0,0 +1,12 @@
+import { translations as sharedTranslations } from "../../shared/i18n/en";
+import { translations as sharedUtilsTranslations } from "../../shared/utils/i18n/en";
+import { translations as systemTranslations } from "../../system/i18n/en";
+
+export const translations = {
+  shared: {
+    ...sharedTranslations,
+    utils: sharedUtilsTranslations,
+  },
+
+  system: systemTranslations,
+};

package/src/app/api/[locale]/i18n/pl/index.ts

@@ -0,0 +1,11 @@
+import { translations as sharedTranslations } from "../../shared/i18n/pl";
+import { translations as sharedUtilsTranslations } from "../../shared/utils/i18n/pl";
+import { translations as systemTranslations } from "../../system/i18n/pl";
+
+export const translations = {
+  shared: {
+    ...sharedTranslations,
+    utils: sharedUtilsTranslations,
+  },
+  system: systemTranslations,
+};

package/src/app/api/[locale]/shared/i18n/de/index.ts

@@ -0,0 +1,85 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  stats: {
+    timePeriod: {
+      day: "Tag",
+      week: "Woche",
+      month: "Monat",
+      quarter: "Quartal",
+      year: "Jahr",
+    },
+    dateRange: {
+      today: "Heute",
+      yesterday: "Gestern",
+      last7Days: "Letzte 7 Tage",
+      last30Days: "Letzte 30 Tage",
+      last90Days: "Letzte 90 Tage",
+      thisWeek: "Diese Woche",
+      lastWeek: "Letzte Woche",
+      thisMonth: "Dieser Monat",
+      lastMonth: "Letzter Monat",
+      thisQuarter: "Dieses Quartal",
+      lastQuarter: "Letztes Quartal",
+      thisYear: "Dieses Jahr",
+      lastYear: "Letztes Jahr",
+      custom: "Benutzerdefiniert",
+    },
+    chartType: {
+      line: "Liniendiagramm",
+      bar: "Balkendiagramm",
+      area: "Flächendiagramm",
+      pie: "Kreisdiagramm",
+      donut: "Ringdiagramm",
+    },
+  },
+  errorTypes: {
+    external_service_error: "Externer Service-Fehler",
+    two_factor_required: "Zwei-Faktor-Authentifizierung erforderlich",
+    forbidden: "Verboten",
+    bad_request: "Fehlerhafte Anfrage",
+    unknown_error: "Unbekannter Fehler",
+    database_error: "Datenbankfehler",
+    validation_error: "Validierungsfehler",
+    auth_error: "Authentifizierungsfehler",
+    unauthorized: "Nicht autorisiert",
+    not_found: "Nicht gefunden",
+    email_error: "E-Mail-Fehler",
+    internal_error: "Interner Serverfehler",
+    no_response_data: "Keine Antwortdaten",
+    http_error: "HTTP-Fehler",
+    sms_error: "SMS-Fehler",
+    token_expired_error: "Token abgelaufen",
+    permission_error: "Berechtigungsfehler",
+    invalid_token_error: "Ungültiges Token",
+    permission_denied: "Berechtigung verweigert",
+    invalid_credentials_error: "Ungültige Anmeldedaten",
+    invalid_request_error: "Ungültige Anfrage",
+    invalid_data_error: "Ungültige Daten",
+    invalid_input_error: "Ungültige Eingabe",
+    invalid_payload_error: "Ungültige Nutzdaten",
+    invalid_format_error: "Ungültiges Format",
+    invalid_parameter_error: "Ungültiger Parameter",
+    invalid_query_error: "Ungültige Abfrage",
+    invalid_url_error: "Ungültige URL",
+    invalid_path_error: "Ungültiger Pfad",
+    invalid_method_error: "Ungültige Methode",
+    invalid_status_error: "Ungültiger Status",
+    invalid_response_error: "Ungültige Antwort",
+    payment_failed: "Zahlung fehlgeschlagen",
+    payment_required: "Zahlung erforderlich",
+    partial_failure: "Teilweiser Fehler",
+  },
+  errors: {
+    invalid_request_data: "Ungültige Anfragedaten",
+    invalid_url_parameters: "Ungültige URL-Parameter",
+    validationFailed: {
+      title: "Validierung fehlgeschlagen",
+      description: "Die Anfragedaten haben die Validierung nicht bestanden",
+    },
+    serverError: {
+      title: "Serverfehler",
+      description: "Ein interner Serverfehler ist aufgetreten",
+    },
+  },
+};

package/src/app/api/[locale]/shared/i18n/en/index.ts

@@ -0,0 +1,83 @@
+export const translations = {
+  stats: {
+    timePeriod: {
+      day: "Day",
+      week: "Week",
+      month: "Month",
+      quarter: "Quarter",
+      year: "Year",
+    },
+    dateRange: {
+      today: "Today",
+      yesterday: "Yesterday",
+      last7Days: "Last 7 Days",
+      last30Days: "Last 30 Days",
+      last90Days: "Last 90 Days",
+      thisWeek: "This Week",
+      lastWeek: "Last Week",
+      thisMonth: "This Month",
+      lastMonth: "Last Month",
+      thisQuarter: "This Quarter",
+      lastQuarter: "Last Quarter",
+      thisYear: "This Year",
+      lastYear: "Last Year",
+      custom: "Custom",
+    },
+    chartType: {
+      line: "Line Chart",
+      bar: "Bar Chart",
+      area: "Area Chart",
+      pie: "Pie Chart",
+      donut: "Donut Chart",
+    },
+  },
+  errorTypes: {
+    external_service_error: "External Service Error",
+    two_factor_required: "Two Factor Authentication Required",
+    forbidden: "Forbidden",
+    bad_request: "Bad Request",
+    unknown_error: "Unknown Error",
+    database_error: "Database Error",
+    validation_error: "Validation Error",
+    auth_error: "Authentication Error",
+    unauthorized: "Unauthorized",
+    not_found: "Not Found",
+    email_error: "Email Error",
+    internal_error: "Internal Server Error",
+    no_response_data: "No Response Data",
+    http_error: "HTTP Error",
+    sms_error: "SMS Error",
+    token_expired_error: "Token Expired",
+    permission_error: "Permission Error",
+    invalid_token_error: "Invalid Token",
+    permission_denied: "Permission Denied",
+    invalid_credentials_error: "Invalid Credentials",
+    invalid_request_error: "Invalid Request",
+    invalid_data_error: "Invalid Data",
+    invalid_input_error: "Invalid Input",
+    invalid_payload_error: "Invalid Payload",
+    invalid_format_error: "Invalid Format",
+    invalid_parameter_error: "Invalid Parameter",
+    invalid_query_error: "Invalid Query",
+    invalid_url_error: "Invalid URL",
+    invalid_path_error: "Invalid Path",
+    invalid_method_error: "Invalid Method",
+    invalid_status_error: "Invalid Status",
+    invalid_response_error: "Invalid Response",
+    payment_failed: "Payment Failed",
+    payment_required: "Payment Required",
+    partial_failure: "Partial Failure",
+  },
+  errors: {
+    invalid_request_data: "Invalid request data",
+    invalid_url_parameters: "Invalid URL parameters",
+    validationFailed: {
+      title: "Validation Failed",
+      description: "The request data failed validation",
+    },
+    serverError: {
+      title: "Server Error",
+      description: "An internal server error occurred",
+    },
+  },
+};

package/src/app/api/[locale]/shared/i18n/pl/index.ts

@@ -0,0 +1,85 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  stats: {
+    timePeriod: {
+      day: "Dzień",
+      week: "Tydzień",
+      month: "Miesiąc",
+      quarter: "Kwartał",
+      year: "Rok",
+    },
+    dateRange: {
+      today: "Dzisiaj",
+      yesterday: "Wczoraj",
+      last7Days: "Ostatnie 7 dni",
+      last30Days: "Ostatnie 30 dni",
+      last90Days: "Ostatnie 90 dni",
+      thisWeek: "Ten tydzień",
+      lastWeek: "Ostatni tydzień",
+      thisMonth: "Ten miesiąc",
+      lastMonth: "Ostatni miesiąc",
+      thisQuarter: "Ten kwartał",
+      lastQuarter: "Ostatni kwartał",
+      thisYear: "Ten rok",
+      lastYear: "Ostatni rok",
+      custom: "Niestandardowy",
+    },
+    chartType: {
+      line: "Wykres liniowy",
+      bar: "Wykres słupkowy",
+      area: "Wykres obszarowy",
+      pie: "Wykres kołowy",
+      donut: "Wykres pierścieniowy",
+    },
+  },
+  errorTypes: {
+    external_service_error: "Błąd usługi zewnętrznej",
+    two_factor_required: "Wymagana autoryzacja dwuskładnikowa",
+    forbidden: "Zabronione",
+    bad_request: "Nieprawidłowe żądanie",
+    unknown_error: "Nieznany błąd",
+    database_error: "Błąd bazy danych",
+    validation_error: "Błąd walidacji",
+    auth_error: "Błąd uwierzytelnienia",
+    unauthorized: "Nieautoryzowany",
+    not_found: "Nie znaleziono",
+    email_error: "Błąd e-mail",
+    internal_error: "Wewnętrzny błąd serwera",
+    no_response_data: "Brak danych odpowiedzi",
+    http_error: "Błąd HTTP",
+    sms_error: "Błąd SMS",
+    token_expired_error: "Token wygasł",
+    permission_error: "Błąd uprawnień",
+    invalid_token_error: "Nieprawidłowy token",
+    permission_denied: "Odmowa dostępu",
+    invalid_credentials_error: "Nieprawidłowe dane logowania",
+    invalid_request_error: "Nieprawidłowe żądanie",
+    invalid_data_error: "Nieprawidłowe dane",
+    invalid_input_error: "Nieprawidłowe dane wejściowe",
+    invalid_payload_error: "Nieprawidłowy ładunek",
+    invalid_format_error: "Nieprawidłowy format",
+    invalid_parameter_error: "Nieprawidłowy parametr",
+    invalid_query_error: "Nieprawidłowe zapytanie",
+    invalid_url_error: "Nieprawidłowy URL",
+    invalid_path_error: "Nieprawidłowa ścieżka",
+    invalid_method_error: "Nieprawidłowa metoda",
+    invalid_status_error: "Nieprawidłowy status",
+    invalid_response_error: "Nieprawidłowa odpowiedź",
+    payment_failed: "Płatność nie powiodła się",
+    payment_required: "Wymagana płatność",
+    partial_failure: "Częściowa awaria",
+  },
+  errors: {
+    invalid_request_data: "Nieprawidłowe dane żądania",
+    invalid_url_parameters: "Nieprawidłowe parametry URL",
+    validationFailed: {
+      title: "Walidacja nie powiodła się",
+      description: "Dane żądania nie przeszły walidacji",
+    },
+    serverError: {
+      title: "Błąd serwera",
+      description: "Wystąpił wewnętrzny błąd serwera",
+    },
+  },
+};

package/src/app/api/[locale]/shared/stats-filtering.ts

@@ -0,0 +1,202 @@
+/**
+ * Shared Stats Filtering Schemas and Enums
+ * Reusable filtering infrastructure for stats endpoints
+ */
+
+import { dateSchema } from "next-vibe/shared/types/common.schema";
+import { z } from "zod";
+
+import { createEnumOptions } from "@/app/api/[locale]/system/unified-interface/shared/field/enum";
+import type { TranslationKey } from "@/i18n/core/static-types";
+
+/**
+ * Time Period Enum
+ * Defines different time periods for historical data aggregation
+ */
+export const { enum: TimePeriod, options: TimePeriodOptions } =
+  createEnumOptions({
+    DAY: "app.api.shared.stats.timePeriod.day",
+    WEEK: "app.api.shared.stats.timePeriod.week",
+    MONTH: "app.api.shared.stats.timePeriod.month",
+    QUARTER: "app.api.shared.stats.timePeriod.quarter",
+    YEAR: "app.api.shared.stats.timePeriod.year",
+  });
+
+/**
+ * Date Range Preset Enum
+ * Common date range presets for quick filtering
+ */
+export const { enum: DateRangePreset, options: DateRangePresetOptions } =
+  createEnumOptions({
+    TODAY: "app.api.shared.stats.dateRange.today",
+    YESTERDAY: "app.api.shared.stats.dateRange.yesterday",
+    LAST_7_DAYS: "app.api.shared.stats.dateRange.last7Days",
+    LAST_30_DAYS: "app.api.shared.stats.dateRange.last30Days",
+    LAST_90_DAYS: "app.api.shared.stats.dateRange.last90Days",
+    THIS_WEEK: "app.api.shared.stats.dateRange.thisWeek",
+    LAST_WEEK: "app.api.shared.stats.dateRange.lastWeek",
+    THIS_MONTH: "app.api.shared.stats.dateRange.thisMonth",
+    LAST_MONTH: "app.api.shared.stats.dateRange.lastMonth",
+    THIS_QUARTER: "app.api.shared.stats.dateRange.thisQuarter",
+    LAST_QUARTER: "app.api.shared.stats.dateRange.lastQuarter",
+    THIS_YEAR: "app.api.shared.stats.dateRange.thisYear",
+    LAST_YEAR: "app.api.shared.stats.dateRange.lastYear",
+    CUSTOM: "app.api.shared.stats.dateRange.custom",
+  });
+
+/**
+ * Chart Type Enum
+ * Different chart visualization types
+ */
+export const { enum: ChartType, options: ChartTypeOptions } = createEnumOptions(
+  {
+    LINE: "app.api.shared.stats.chartType.line",
+    BAR: "app.api.shared.stats.chartType.bar",
+    AREA: "app.api.shared.stats.chartType.area",
+    PIE: "app.api.shared.stats.chartType.pie",
+    DONUT: "app.api.shared.stats.chartType.donut",
+  },
+);
+
+/**
+ * Historical Data Point Schema
+ * Structure for time-series data points
+ */
+export const historicalDataPointSchema = z.object({
+  date: dateSchema,
+  value: z.coerce.number(),
+  label: z.string().optional() as z.ZodType<TranslationKey | undefined>,
+  metadata: z
+    .record(
+      z.string(),
+      z.union([
+        z.string() as z.ZodType<TranslationKey>,
+        z.coerce.number(),
+        z.boolean(),
+      ]),
+    )
+    .optional(),
+});
+
+export type HistoricalDataPointType = z.infer<typeof historicalDataPointSchema>;
+
+/**
+ * Calculate date range from preset
+ */
+export function getDateRangeFromPreset(
+  preset: (typeof DateRangePreset)[keyof typeof DateRangePreset],
+): {
+  from: Date;
+  to: Date;
+} {
+  const now = new Date();
+  const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+
+  switch (preset) {
+    case DateRangePreset.TODAY:
+      return {
+        from: today,
+        to: new Date(today.getTime() + 24 * 60 * 60 * 1000 - 1),
+      };
+    case DateRangePreset.YESTERDAY: {
+      const yesterday = new Date(today.getTime() - 24 * 60 * 60 * 1000);
+      return {
+        from: yesterday,
+        to: new Date(yesterday.getTime() + 24 * 60 * 60 * 1000 - 1),
+      };
+    }
+    case DateRangePreset.LAST_7_DAYS:
+      return {
+        from: new Date(today.getTime() - 7 * 24 * 60 * 60 * 1000),
+        to: now,
+      };
+    case DateRangePreset.LAST_30_DAYS:
+      return {
+        from: new Date(today.getTime() - 30 * 24 * 60 * 60 * 1000),
+        to: now,
+      };
+    case DateRangePreset.LAST_90_DAYS:
+      return {
+        from: new Date(today.getTime() - 90 * 24 * 60 * 60 * 1000),
+        to: now,
+      };
+    case DateRangePreset.THIS_WEEK: {
+      const startOfWeek = new Date(today);
+      startOfWeek.setDate(today.getDate() - today.getDay());
+      return { from: startOfWeek, to: now };
+    }
+    case DateRangePreset.LAST_WEEK: {
+      const lastWeekStart = new Date(today);
+      lastWeekStart.setDate(today.getDate() - today.getDay() - 7);
+      const lastWeekEnd = new Date(lastWeekStart);
+      lastWeekEnd.setDate(lastWeekStart.getDate() + 6);
+      lastWeekEnd.setHours(23, 59, 59, 999);
+      return { from: lastWeekStart, to: lastWeekEnd };
+    }
+    case DateRangePreset.THIS_MONTH:
+      return {
+        from: new Date(today.getFullYear(), today.getMonth(), 1),
+        to: now,
+      };
+    case DateRangePreset.LAST_MONTH: {
+      const lastMonthStart = new Date(
+        today.getFullYear(),
+        today.getMonth() - 1,
+        1,
+      );
+      const lastMonthEnd = new Date(
+        today.getFullYear(),
+        today.getMonth(),
+        0,
+        23,
+        59,
+        59,
+        999,
+      );
+      return { from: lastMonthStart, to: lastMonthEnd };
+    }
+    case DateRangePreset.THIS_QUARTER: {
+      const quarterStart = new Date(
+        today.getFullYear(),
+        Math.floor(today.getMonth() / 3) * 3,
+        1,
+      );
+      return { from: quarterStart, to: now };
+    }
+    case DateRangePreset.LAST_QUARTER: {
+      const lastQuarterMonth = Math.floor(today.getMonth() / 3) * 3 - 3;
+      const lastQuarterStart = new Date(
+        today.getFullYear(),
+        lastQuarterMonth,
+        1,
+      );
+      if (lastQuarterMonth < 0) {
+        lastQuarterStart.setFullYear(today.getFullYear() - 1);
+        lastQuarterStart.setMonth(9);
+      }
+      const lastQuarterEnd = new Date(
+        lastQuarterStart.getFullYear(),
+        lastQuarterStart.getMonth() + 3,
+        0,
+        23,
+        59,
+        59,
+        999,
+      );
+      return { from: lastQuarterStart, to: lastQuarterEnd };
+    }
+    case DateRangePreset.THIS_YEAR:
+      return { from: new Date(today.getFullYear(), 0, 1), to: now };
+    case DateRangePreset.LAST_YEAR:
+      return {
+        from: new Date(today.getFullYear() - 1, 0, 1),
+        to: new Date(today.getFullYear() - 1, 11, 31, 23, 59, 59, 999),
+      };
+    case DateRangePreset.CUSTOM:
+    default:
+      return {
+        from: new Date(today.getTime() - 30 * 24 * 60 * 60 * 1000),
+        to: now,
+      };
+  }
+}

package/src/app/api/[locale]/shared/types/common.schema.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+
+// Common reusable schemas
+
+export const dateSchema = z
+  .union([z.string(), z.date(), z.coerce.number()])
+  .transform((val): string | Date | number => {
+    if (val instanceof Date) {
+      return val;
+    }
+    return new Date(val);
+  });
+
+export type DateInputType = z.input<typeof dateRangeSchema>;
+
+// Runtime: accepts any string (emoji, string), Type: string
+export const iconSchema = z.string() as z.ZodString;
+
+export const idSchema = z.object({
+  id: z.uuid(),
+});
+export type IdType = z.infer<typeof idSchema>;
+
+export const stringToIntSchema = (
+  errorMessage: string,
+): ReturnType<typeof z.coerce.number> => {
+  return z.coerce.number().int({
+    message: errorMessage,
+  });
+};
+
+export const paginationSchema = z.object({
+  page: z.coerce.number().int().positive().default(1),
+  limit: z.coerce.number().int().positive().max(100).default(10),
+});
+export type PaginationType = z.infer<typeof paginationSchema>;
+
+export const searchSchema = z.object({
+  search: z.string().nullable(),
+});
+export type SearchType = z.infer<typeof searchSchema>;
+
+export const dateRangeSchema = z.object({
+  startDate: dateSchema.nullable(),
+  endDate: dateSchema.nullable(),
+});
+export type DateRangeType = z.infer<typeof dateRangeSchema>;
+
+export const undefinedSchema = z.undefined();
+export type UndefinedType = z.input<typeof undefinedSchema>;
+
+export const booleanSchema = z.object({
+  exists: z.boolean(),
+});
+export type BooleanType = z.input<typeof booleanSchema>;