@hexclave/shared 1.0.3 → 1.0.6

package/dist/interface/admin-metrics.d.ts

@@ -150,15 +150,15 @@ declare const MetricsEmailOverviewSchema: yup.ObjectSchema<{
     activity: number;
   }[];
   daily_emails_by_status: {
-    error: number;
     date: string;
     ok: number;
+    error: number;
     in_progress: number;
   }[];
   emails_sent: number;
   recent_emails: {
-    status: string;
     id: string;
+    status: string;
     subject: string;
     created_at_millis: number;
   }[];
@@ -310,9 +310,9 @@ declare const UserActivityResponseBodySchema: yup.ObjectSchema<{
   data_points: undefined;
 }, "">;
 declare const MetricsActiveUsersByCountrySchema: yup.MixedSchema<Record<string, {
-  primary_email: string | null;
-  display_name: string | null;
   id: string;
+  display_name: string | null;
+  primary_email: string | null;
   profile_image_url: string | null;
   signed_up_at_millis: number;
   last_active_at_millis: number | null;
@@ -330,25 +330,25 @@ declare const MetricsResponseBodySchema: yup.ObjectSchema<{
   }[];
   users_by_country: Record<string, number>;
   active_users_by_country: Record<string, {
-    primary_email: string | null;
-    display_name: string | null;
     id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
     last_active_at_millis: number | null;
   }[]>;
   recently_registered: {
-    primary_email: string | null;
-    display_name: string | null;
     id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
     last_active_at_millis: number | null;
   }[];
   recently_active: {
-    primary_email: string | null;
-    display_name: string | null;
     id: string;
+    display_name: string | null;
+    primary_email: string | null;
     profile_image_url: string | null;
     signed_up_at_millis: number;
     last_active_at_millis: number | null;
@@ -422,15 +422,15 @@ declare const MetricsResponseBodySchema: yup.ObjectSchema<{
     emails_by_status: Record<string, number>;
     total_emails: number;
     daily_emails_by_status: {
-      error: number;
       date: string;
       ok: number;
+      error: number;
       in_progress: number;
     }[];
     emails_sent: number;
     recent_emails: {
-      status: string;
       id: string;
+      status: string;
       subject: string;
       created_at_millis: number;
     }[];

package/dist/interface/admin-metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-metrics.js","names":[],"sources":["../../src/interface/admin-metrics.ts"],"sourcesContent":["import yup from \"yup\";\nimport { yupArray, yupMixed, yupNumber, yupObject, yupRecord, yupString } from \"../schema-fields\";\n\n// Single source of truth for the `/internal/metrics` endpoint shape.\n//\n// Both the backend route handler (`apps/backend/src/app/api/latest/internal/metrics/route.tsx`)\n// and the dashboard hook (`apps/dashboard/src/lib/stack-app-internals.ts`) import\n// these schemas. The runtime validation lives in the schemas; the static types\n// are derived via `yup.InferType` so we never have to keep parallel copies in\n// sync.\n\nexport const MetricsDataPointSchema = yupObject({\n  date: yupString().defined(),\n  activity: yupNumber().defined(),\n}).defined();\n\nexport const MetricsDataPointsSchema = yupArray(MetricsDataPointSchema).defined();\n\nexport const MetricsActivitySplitSchema = yupObject({\n  total: MetricsDataPointsSchema,\n  new: MetricsDataPointsSchema,\n  retained: MetricsDataPointsSchema,\n  reactivated: MetricsDataPointsSchema,\n}).defined();\n\nexport const MetricsAuthOverviewSchema = yupObject({\n  verified_users: yupNumber().integer().defined(),\n  unverified_users: yupNumber().integer().defined(),\n  anonymous_users: yupNumber().integer().defined(),\n  total_teams: yupNumber().integer().defined(),\n  mau: yupNumber().integer().defined(),\n  daily_active_users_split: MetricsActivitySplitSchema,\n  daily_active_teams_split: MetricsActivitySplitSchema,\n  total_users_filtered: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsPaymentsOverviewSchema = yupObject({\n  subscriptions_by_status: yupRecord(yupString().defined(), yupNumber().defined()).defined(),\n  active_subscription_count: yupNumber().integer().defined(),\n  total_one_time_purchases: yupNumber().integer().defined(),\n  daily_subscriptions: MetricsDataPointsSchema,\n  revenue_cents: yupNumber().integer().defined(),\n  mrr_cents: yupNumber().integer().defined(),\n  total_orders: yupNumber().integer().defined(),\n  checkout_conversion_rate: yupNumber().defined(),\n}).defined();\n\nexport const MetricsRecentEmailSchema = yupObject({\n  id: yupString().defined(),\n  status: yupString().defined(),\n  subject: yupString().defined(),\n  created_at_millis: yupNumber().defined(),\n}).defined();\n\nexport const MetricsDailyEmailStatusBreakdownSchema = yupObject({\n  date: yupString().defined(),\n  ok: yupNumber().integer().defined(),\n  error: yupNumber().integer().defined(),\n  in_progress: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsEmailOverviewSchema = yupObject({\n  emails_by_status: yupRecord(yupString().defined(), yupNumber().defined()).defined(),\n  total_emails: yupNumber().integer().defined(),\n  daily_emails: MetricsDataPointsSchema,\n  daily_emails_by_status: yupArray(MetricsDailyEmailStatusBreakdownSchema).defined(),\n  emails_sent: yupNumber().integer().defined(),\n  recent_emails: yupArray(MetricsRecentEmailSchema).defined(),\n  deliverability_status: yupObject({\n    delivered: yupNumber().integer().defined(),\n    bounced: yupNumber().integer().defined(),\n    error: yupNumber().integer().defined(),\n    in_progress: yupNumber().integer().defined(),\n  }).defined(),\n  deliverability_rate: yupNumber().defined(),\n  bounce_rate: yupNumber().defined(),\n  click_rate: yupNumber().defined(),\n}).defined();\n\nexport const MetricsDailyRevenuePointSchema = yupObject({\n  date: yupString().defined(),\n  new_cents: yupNumber().integer().defined(),\n  refund_cents: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsTopReferrerSchema = yupObject({\n  referrer: yupString().defined(),\n  visitors: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsTopRegionSchema = yupObject({\n  country_code: yupString().nullable().defined(),\n  region_code: yupString().nullable().defined(),\n  count: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsAnalyticsOverviewSchema = yupObject({\n  daily_page_views: MetricsDataPointsSchema,\n  daily_clicks: MetricsDataPointsSchema,\n  daily_visitors: MetricsDataPointsSchema,\n  // Token-refresh-derived anonymous-visitor fallback. Populated only when the\n  // analytics app isn't installed (no `$page-view` events) — counts DISTINCT\n  // anonymous users per day from the events table. See\n  // `loadAnonymousVisitorsFromTokenRefresh` in the backend metrics route.\n  //\n  // Optional for one release cycle so older clients/servers don't hard-fail\n  // validation during a staged rollout. Tighten to `.defined()` after.\n  daily_anonymous_visitors_fallback: yupArray(MetricsDataPointSchema).optional().default([]),\n  daily_revenue: yupArray(MetricsDailyRevenuePointSchema).defined(),\n  total_revenue_cents: yupNumber().integer().defined(),\n  total_replays: yupNumber().integer().defined(),\n  recent_replays: yupNumber().integer().defined(),\n  visitors: yupNumber().integer().defined(),\n  anonymous_visitors_fallback: yupNumber().integer().optional().default(0),\n  avg_session_seconds: yupNumber().defined(),\n  online_live: yupNumber().integer().defined(),\n  revenue_per_visitor: yupNumber().defined(),\n  top_referrers: yupArray(MetricsTopReferrerSchema).defined(),\n  top_region: MetricsTopRegionSchema.nullable().defined(),\n  // dev-fallback fields (only present in non-production environments)\n  bounce_rate: yupNumber().optional(),\n  conversion_rate: yupNumber().optional(),\n  deltas: yupMixed().optional(),\n}).defined();\n\nexport const MetricsLoginMethodEntrySchema = yupObject({\n  method: yupString().defined(),\n  count: yupNumber().integer().defined(),\n}).defined();\n\n// Recent user summary — a slim projection of UsersCrud[\"Admin\"][\"Read\"] with\n// just the fields the overview list views actually read. Defined here so the\n// metrics response stays self-contained and doesn't pull in users-crud.\n//\n// `.noUnknown(false)` tells our strict object validator to allow the extra\n// fields that the backend returns as part of the full users-crud payload —\n// `is_anonymous`, `has_password`, `oauth_providers`, etc. — without rejecting\n// them. Only the keys explicitly listed here are validated; extras pass through.\nexport const MetricsRecentUserSchema = yupObject({\n  id: yupString().defined(),\n  display_name: yupString().nullable().defined(),\n  primary_email: yupString().nullable().defined(),\n  profile_image_url: yupString().nullable().defined(),\n  signed_up_at_millis: yupNumber().defined(),\n  last_active_at_millis: yupNumber().nullable().defined(),\n}).noUnknown(false).defined();\n\n// Per-user activity heatmap — a simple list of daily event counts for a single\n// user. Backed by ClickHouse `analytics_internal.events` filtered by user_id,\n// project_id, and branch_id. See `/internal/user-activity` on the backend.\nexport const UserActivityResponseBodySchema = yupObject({\n  data_points: MetricsDataPointsSchema,\n}).defined();\n\n// Recent \"currently live\" users keyed by ISO country code. Populated by\n// joining a bounded ClickHouse selection from the live `$token-refresh` window\n// with the corresponding Prisma profile rows, so the overview globe can render\n// real avatars of real users from each country. Optional for one release cycle\n// so clients talking to older servers don't fail validation on the returned\n// body.\nexport const MetricsActiveUsersByCountrySchema = yupRecord(\n  yupString().defined(),\n  yupArray(MetricsRecentUserSchema).defined(),\n).optional().default({});\n\nexport const MetricsResponseBodySchema = yupObject({\n  total_users: yupNumber().integer().defined(),\n  // Count of distinct users seen refreshing a token in the last ~2 minutes —\n  // the \"who's online right now\" number rendered on the overview globe. Derived\n  // from the same `$token-refresh` window that powers `active_users_by_country`,\n  // so it works for every project regardless of whether the analytics app\n  // (page-view-based `analytics_overview.online_live`) is installed.\n  //\n  // Optional for one release cycle so older servers don't fail schema\n  // validation on the returned body. Tighten to `.defined()` after.\n  live_users: yupNumber().integer().optional().default(0),\n  daily_users: MetricsDataPointsSchema,\n  daily_active_users: MetricsDataPointsSchema,\n  users_by_country: yupRecord(yupString().defined(), yupNumber().defined()).defined(),\n  active_users_by_country: MetricsActiveUsersByCountrySchema,\n  // recently_registered/active are CRUD User objects passed through from the\n  // backend. The schema only validates the fields the dashboard actually\n  // reads — extra fields from UsersCrud[\"Admin\"][\"Read\"] are allowed through.\n  recently_registered: yupArray(MetricsRecentUserSchema).defined(),\n  recently_active: yupArray(MetricsRecentUserSchema).defined(),\n  login_methods: yupArray(MetricsLoginMethodEntrySchema).defined(),\n  auth_overview: MetricsAuthOverviewSchema,\n  payments_overview: MetricsPaymentsOverviewSchema,\n  email_overview: MetricsEmailOverviewSchema,\n  analytics_overview: MetricsAnalyticsOverviewSchema,\n}).defined();\n\nexport const MetricsUserCountsSchema = yupObject({\n  total_users: yupNumber().integer().defined(),\n  anonymous_users: yupNumber().integer().defined(),\n}).defined();\n\n// Derived static types — single source of truth lives in the schemas above.\nexport type MetricsDataPoint = yup.InferType<typeof MetricsDataPointSchema>;\nexport type MetricsActivitySplit = yup.InferType<typeof MetricsActivitySplitSchema>;\nexport type MetricsAuthOverview = yup.InferType<typeof MetricsAuthOverviewSchema>;\nexport type MetricsPaymentsOverview = yup.InferType<typeof MetricsPaymentsOverviewSchema>;\nexport type MetricsRecentEmail = yup.InferType<typeof MetricsRecentEmailSchema>;\nexport type MetricsDailyEmailStatusBreakdown = yup.InferType<typeof MetricsDailyEmailStatusBreakdownSchema>;\nexport type MetricsEmailOverview = yup.InferType<typeof MetricsEmailOverviewSchema>;\nexport type MetricsDailyRevenuePoint = yup.InferType<typeof MetricsDailyRevenuePointSchema>;\nexport type MetricsTopReferrer = yup.InferType<typeof MetricsTopReferrerSchema>;\nexport type MetricsTopRegion = yup.InferType<typeof MetricsTopRegionSchema>;\nexport type MetricsAnalyticsOverview = yup.InferType<typeof MetricsAnalyticsOverviewSchema>;\nexport type MetricsLoginMethodEntry = yup.InferType<typeof MetricsLoginMethodEntrySchema>;\nexport type MetricsRecentUser = yup.InferType<typeof MetricsRecentUserSchema>;\nexport type MetricsResponse = yup.InferType<typeof MetricsResponseBodySchema>;\nexport type MetricsUserCounts = yup.InferType<typeof MetricsUserCountsSchema>;\nexport type UserActivityResponse = yup.InferType<typeof UserActivityResponseBodySchema>;\n"],"mappings":"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"}
+{"version":3,"file":"admin-metrics.js","names":[],"sources":["../../src/interface/admin-metrics.ts"],"sourcesContent":["import yup from \"yup\";\nimport { yupArray, yupMixed, yupNumber, yupObject, yupRecord, yupString } from \"../schema-fields\";\n\n// Single source of truth for the `/internal/metrics` endpoint shape.\n//\n// Both the backend route handler (`apps/backend/src/app/api/latest/internal/metrics/route.tsx`)\n// and the dashboard hook (`apps/dashboard/src/lib/hexclave-app-internals.ts`) import\n// these schemas. The runtime validation lives in the schemas; the static types\n// are derived via `yup.InferType` so we never have to keep parallel copies in\n// sync.\n\nexport const MetricsDataPointSchema = yupObject({\n  date: yupString().defined(),\n  activity: yupNumber().defined(),\n}).defined();\n\nexport const MetricsDataPointsSchema = yupArray(MetricsDataPointSchema).defined();\n\nexport const MetricsActivitySplitSchema = yupObject({\n  total: MetricsDataPointsSchema,\n  new: MetricsDataPointsSchema,\n  retained: MetricsDataPointsSchema,\n  reactivated: MetricsDataPointsSchema,\n}).defined();\n\nexport const MetricsAuthOverviewSchema = yupObject({\n  verified_users: yupNumber().integer().defined(),\n  unverified_users: yupNumber().integer().defined(),\n  anonymous_users: yupNumber().integer().defined(),\n  total_teams: yupNumber().integer().defined(),\n  mau: yupNumber().integer().defined(),\n  daily_active_users_split: MetricsActivitySplitSchema,\n  daily_active_teams_split: MetricsActivitySplitSchema,\n  total_users_filtered: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsPaymentsOverviewSchema = yupObject({\n  subscriptions_by_status: yupRecord(yupString().defined(), yupNumber().defined()).defined(),\n  active_subscription_count: yupNumber().integer().defined(),\n  total_one_time_purchases: yupNumber().integer().defined(),\n  daily_subscriptions: MetricsDataPointsSchema,\n  revenue_cents: yupNumber().integer().defined(),\n  mrr_cents: yupNumber().integer().defined(),\n  total_orders: yupNumber().integer().defined(),\n  checkout_conversion_rate: yupNumber().defined(),\n}).defined();\n\nexport const MetricsRecentEmailSchema = yupObject({\n  id: yupString().defined(),\n  status: yupString().defined(),\n  subject: yupString().defined(),\n  created_at_millis: yupNumber().defined(),\n}).defined();\n\nexport const MetricsDailyEmailStatusBreakdownSchema = yupObject({\n  date: yupString().defined(),\n  ok: yupNumber().integer().defined(),\n  error: yupNumber().integer().defined(),\n  in_progress: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsEmailOverviewSchema = yupObject({\n  emails_by_status: yupRecord(yupString().defined(), yupNumber().defined()).defined(),\n  total_emails: yupNumber().integer().defined(),\n  daily_emails: MetricsDataPointsSchema,\n  daily_emails_by_status: yupArray(MetricsDailyEmailStatusBreakdownSchema).defined(),\n  emails_sent: yupNumber().integer().defined(),\n  recent_emails: yupArray(MetricsRecentEmailSchema).defined(),\n  deliverability_status: yupObject({\n    delivered: yupNumber().integer().defined(),\n    bounced: yupNumber().integer().defined(),\n    error: yupNumber().integer().defined(),\n    in_progress: yupNumber().integer().defined(),\n  }).defined(),\n  deliverability_rate: yupNumber().defined(),\n  bounce_rate: yupNumber().defined(),\n  click_rate: yupNumber().defined(),\n}).defined();\n\nexport const MetricsDailyRevenuePointSchema = yupObject({\n  date: yupString().defined(),\n  new_cents: yupNumber().integer().defined(),\n  refund_cents: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsTopReferrerSchema = yupObject({\n  referrer: yupString().defined(),\n  visitors: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsTopRegionSchema = yupObject({\n  country_code: yupString().nullable().defined(),\n  region_code: yupString().nullable().defined(),\n  count: yupNumber().integer().defined(),\n}).defined();\n\nexport const MetricsAnalyticsOverviewSchema = yupObject({\n  daily_page_views: MetricsDataPointsSchema,\n  daily_clicks: MetricsDataPointsSchema,\n  daily_visitors: MetricsDataPointsSchema,\n  // Token-refresh-derived anonymous-visitor fallback. Populated only when the\n  // analytics app isn't installed (no `$page-view` events) — counts DISTINCT\n  // anonymous users per day from the events table. See\n  // `loadAnonymousVisitorsFromTokenRefresh` in the backend metrics route.\n  //\n  // Optional for one release cycle so older clients/servers don't hard-fail\n  // validation during a staged rollout. Tighten to `.defined()` after.\n  daily_anonymous_visitors_fallback: yupArray(MetricsDataPointSchema).optional().default([]),\n  daily_revenue: yupArray(MetricsDailyRevenuePointSchema).defined(),\n  total_revenue_cents: yupNumber().integer().defined(),\n  total_replays: yupNumber().integer().defined(),\n  recent_replays: yupNumber().integer().defined(),\n  visitors: yupNumber().integer().defined(),\n  anonymous_visitors_fallback: yupNumber().integer().optional().default(0),\n  avg_session_seconds: yupNumber().defined(),\n  online_live: yupNumber().integer().defined(),\n  revenue_per_visitor: yupNumber().defined(),\n  top_referrers: yupArray(MetricsTopReferrerSchema).defined(),\n  top_region: MetricsTopRegionSchema.nullable().defined(),\n  // dev-fallback fields (only present in non-production environments)\n  bounce_rate: yupNumber().optional(),\n  conversion_rate: yupNumber().optional(),\n  deltas: yupMixed().optional(),\n}).defined();\n\nexport const MetricsLoginMethodEntrySchema = yupObject({\n  method: yupString().defined(),\n  count: yupNumber().integer().defined(),\n}).defined();\n\n// Recent user summary — a slim projection of UsersCrud[\"Admin\"][\"Read\"] with\n// just the fields the overview list views actually read. Defined here so the\n// metrics response stays self-contained and doesn't pull in users-crud.\n//\n// `.noUnknown(false)` tells our strict object validator to allow the extra\n// fields that the backend returns as part of the full users-crud payload —\n// `is_anonymous`, `has_password`, `oauth_providers`, etc. — without rejecting\n// them. Only the keys explicitly listed here are validated; extras pass through.\nexport const MetricsRecentUserSchema = yupObject({\n  id: yupString().defined(),\n  display_name: yupString().nullable().defined(),\n  primary_email: yupString().nullable().defined(),\n  profile_image_url: yupString().nullable().defined(),\n  signed_up_at_millis: yupNumber().defined(),\n  last_active_at_millis: yupNumber().nullable().defined(),\n}).noUnknown(false).defined();\n\n// Per-user activity heatmap — a simple list of daily event counts for a single\n// user. Backed by ClickHouse `analytics_internal.events` filtered by user_id,\n// project_id, and branch_id. See `/internal/user-activity` on the backend.\nexport const UserActivityResponseBodySchema = yupObject({\n  data_points: MetricsDataPointsSchema,\n}).defined();\n\n// Recent \"currently live\" users keyed by ISO country code. Populated by\n// joining a bounded ClickHouse selection from the live `$token-refresh` window\n// with the corresponding Prisma profile rows, so the overview globe can render\n// real avatars of real users from each country. Optional for one release cycle\n// so clients talking to older servers don't fail validation on the returned\n// body.\nexport const MetricsActiveUsersByCountrySchema = yupRecord(\n  yupString().defined(),\n  yupArray(MetricsRecentUserSchema).defined(),\n).optional().default({});\n\nexport const MetricsResponseBodySchema = yupObject({\n  total_users: yupNumber().integer().defined(),\n  // Count of distinct users seen refreshing a token in the last ~2 minutes —\n  // the \"who's online right now\" number rendered on the overview globe. Derived\n  // from the same `$token-refresh` window that powers `active_users_by_country`,\n  // so it works for every project regardless of whether the analytics app\n  // (page-view-based `analytics_overview.online_live`) is installed.\n  //\n  // Optional for one release cycle so older servers don't fail schema\n  // validation on the returned body. Tighten to `.defined()` after.\n  live_users: yupNumber().integer().optional().default(0),\n  daily_users: MetricsDataPointsSchema,\n  daily_active_users: MetricsDataPointsSchema,\n  users_by_country: yupRecord(yupString().defined(), yupNumber().defined()).defined(),\n  active_users_by_country: MetricsActiveUsersByCountrySchema,\n  // recently_registered/active are CRUD User objects passed through from the\n  // backend. The schema only validates the fields the dashboard actually\n  // reads — extra fields from UsersCrud[\"Admin\"][\"Read\"] are allowed through.\n  recently_registered: yupArray(MetricsRecentUserSchema).defined(),\n  recently_active: yupArray(MetricsRecentUserSchema).defined(),\n  login_methods: yupArray(MetricsLoginMethodEntrySchema).defined(),\n  auth_overview: MetricsAuthOverviewSchema,\n  payments_overview: MetricsPaymentsOverviewSchema,\n  email_overview: MetricsEmailOverviewSchema,\n  analytics_overview: MetricsAnalyticsOverviewSchema,\n}).defined();\n\nexport const MetricsUserCountsSchema = yupObject({\n  total_users: yupNumber().integer().defined(),\n  anonymous_users: yupNumber().integer().defined(),\n}).defined();\n\n// Derived static types — single source of truth lives in the schemas above.\nexport type MetricsDataPoint = yup.InferType<typeof MetricsDataPointSchema>;\nexport type MetricsActivitySplit = yup.InferType<typeof MetricsActivitySplitSchema>;\nexport type MetricsAuthOverview = yup.InferType<typeof MetricsAuthOverviewSchema>;\nexport type MetricsPaymentsOverview = yup.InferType<typeof MetricsPaymentsOverviewSchema>;\nexport type MetricsRecentEmail = yup.InferType<typeof MetricsRecentEmailSchema>;\nexport type MetricsDailyEmailStatusBreakdown = yup.InferType<typeof MetricsDailyEmailStatusBreakdownSchema>;\nexport type MetricsEmailOverview = yup.InferType<typeof MetricsEmailOverviewSchema>;\nexport type MetricsDailyRevenuePoint = yup.InferType<typeof MetricsDailyRevenuePointSchema>;\nexport type MetricsTopReferrer = yup.InferType<typeof MetricsTopReferrerSchema>;\nexport type MetricsTopRegion = yup.InferType<typeof MetricsTopRegionSchema>;\nexport type MetricsAnalyticsOverview = yup.InferType<typeof MetricsAnalyticsOverviewSchema>;\nexport type MetricsLoginMethodEntry = yup.InferType<typeof MetricsLoginMethodEntrySchema>;\nexport type MetricsRecentUser = yup.InferType<typeof MetricsRecentUserSchema>;\nexport type MetricsResponse = yup.InferType<typeof MetricsResponseBodySchema>;\nexport type MetricsUserCounts = yup.InferType<typeof MetricsUserCountsSchema>;\nexport type UserActivityResponse = yup.InferType<typeof UserActivityResponseBodySchema>;\n"],"mappings":";;;;;AAWA,MAAa,4DAAmC;CAC9C,0CAAiB,CAAC,SAAS;CAC3B,8CAAqB,CAAC,SAAS;CAChC,CAAC,CAAC,SAAS;AAEZ,MAAa,4DAAmC,uBAAuB,CAAC,SAAS;AAEjF,MAAa,gEAAuC;CAClD,OAAO;CACP,KAAK;CACL,UAAU;CACV,aAAa;CACd,CAAC,CAAC,SAAS;AAEZ,MAAa,+DAAsC;CACjD,oDAA2B,CAAC,SAAS,CAAC,SAAS;CAC/C,sDAA6B,CAAC,SAAS,CAAC,SAAS;CACjD,qDAA4B,CAAC,SAAS,CAAC,SAAS;CAChD,iDAAwB,CAAC,SAAS,CAAC,SAAS;CAC5C,yCAAgB,CAAC,SAAS,CAAC,SAAS;CACpC,0BAA0B;CAC1B,0BAA0B;CAC1B,0DAAiC,CAAC,SAAS,CAAC,SAAS;CACtD,CAAC,CAAC,SAAS;AAEZ,MAAa,mEAA0C;CACrD,gGAA8C,CAAC,SAAS,sCAAa,CAAC,SAAS,CAAC,CAAC,SAAS;CAC1F,+DAAsC,CAAC,SAAS,CAAC,SAAS;CAC1D,8DAAqC,CAAC,SAAS,CAAC,SAAS;CACzD,qBAAqB;CACrB,mDAA0B,CAAC,SAAS,CAAC,SAAS;CAC9C,+CAAsB,CAAC,SAAS,CAAC,SAAS;CAC1C,kDAAyB,CAAC,SAAS,CAAC,SAAS;CAC7C,8DAAqC,CAAC,SAAS;CAChD,CAAC,CAAC,SAAS;AAEZ,MAAa,8DAAqC;CAChD,wCAAe,CAAC,SAAS;CACzB,4CAAmB,CAAC,SAAS;CAC7B,6CAAoB,CAAC,SAAS;CAC9B,uDAA8B,CAAC,SAAS;CACzC,CAAC,CAAC,SAAS;AAEZ,MAAa,4EAAmD;CAC9D,0CAAiB,CAAC,SAAS;CAC3B,wCAAe,CAAC,SAAS,CAAC,SAAS;CACnC,2CAAkB,CAAC,SAAS,CAAC,SAAS;CACtC,iDAAwB,CAAC,SAAS,CAAC,SAAS;CAC7C,CAAC,CAAC,SAAS;AAEZ,MAAa,gEAAuC;CAClD,yFAAuC,CAAC,SAAS,sCAAa,CAAC,SAAS,CAAC,CAAC,SAAS;CACnF,kDAAyB,CAAC,SAAS,CAAC,SAAS;CAC7C,cAAc;CACd,0DAAiC,uCAAuC,CAAC,SAAS;CAClF,iDAAwB,CAAC,SAAS,CAAC,SAAS;CAC5C,iDAAwB,yBAAyB,CAAC,SAAS;CAC3D,0DAAiC;EAC/B,+CAAsB,CAAC,SAAS,CAAC,SAAS;EAC1C,6CAAoB,CAAC,SAAS,CAAC,SAAS;EACxC,2CAAkB,CAAC,SAAS,CAAC,SAAS;EACtC,iDAAwB,CAAC,SAAS,CAAC,SAAS;EAC7C,CAAC,CAAC,SAAS;CACZ,yDAAgC,CAAC,SAAS;CAC1C,iDAAwB,CAAC,SAAS;CAClC,gDAAuB,CAAC,SAAS;CAClC,CAAC,CAAC,SAAS;AAEZ,MAAa,oEAA2C;CACtD,0CAAiB,CAAC,SAAS;CAC3B,+CAAsB,CAAC,SAAS,CAAC,SAAS;CAC1C,kDAAyB,CAAC,SAAS,CAAC,SAAS;CAC9C,CAAC,CAAC,SAAS;AAEZ,MAAa,8DAAqC;CAChD,8CAAqB,CAAC,SAAS;CAC/B,8CAAqB,CAAC,SAAS,CAAC,SAAS;CAC1C,CAAC,CAAC,SAAS;AAEZ,MAAa,4DAAmC;CAC9C,kDAAyB,CAAC,UAAU,CAAC,SAAS;CAC9C,iDAAwB,CAAC,UAAU,CAAC,SAAS;CAC7C,2CAAkB,CAAC,SAAS,CAAC,SAAS;CACvC,CAAC,CAAC,SAAS;AAEZ,MAAa,oEAA2C;CACtD,kBAAkB;CAClB,cAAc;CACd,gBAAgB;CAQhB,qEAA4C,uBAAuB,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;CAC1F,iDAAwB,+BAA+B,CAAC,SAAS;CACjE,yDAAgC,CAAC,SAAS,CAAC,SAAS;CACpD,mDAA0B,CAAC,SAAS,CAAC,SAAS;CAC9C,oDAA2B,CAAC,SAAS,CAAC,SAAS;CAC/C,8CAAqB,CAAC,SAAS,CAAC,SAAS;CACzC,iEAAwC,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE;CACxE,yDAAgC,CAAC,SAAS;CAC1C,iDAAwB,CAAC,SAAS,CAAC,SAAS;CAC5C,yDAAgC,CAAC,SAAS;CAC1C,iDAAwB,yBAAyB,CAAC,SAAS;CAC3D,YAAY,uBAAuB,UAAU,CAAC,SAAS;CAEvD,iDAAwB,CAAC,UAAU;CACnC,qDAA4B,CAAC,UAAU;CACvC,2CAAkB,CAAC,UAAU;CAC9B,CAAC,CAAC,SAAS;AAEZ,MAAa,mEAA0C;CACrD,4CAAmB,CAAC,SAAS;CAC7B,2CAAkB,CAAC,SAAS,CAAC,SAAS;CACvC,CAAC,CAAC,SAAS;AAUZ,MAAa,6DAAoC;CAC/C,wCAAe,CAAC,SAAS;CACzB,kDAAyB,CAAC,UAAU,CAAC,SAAS;CAC9C,mDAA0B,CAAC,UAAU,CAAC,SAAS;CAC/C,uDAA8B,CAAC,UAAU,CAAC,SAAS;CACnD,yDAAgC,CAAC,SAAS;CAC1C,2DAAkC,CAAC,UAAU,CAAC,SAAS;CACxD,CAAC,CAAC,UAAU,MAAM,CAAC,SAAS;AAK7B,MAAa,oEAA2C,EACtD,aAAa,yBACd,CAAC,CAAC,SAAS;AAQZ,MAAa,2GACA,CAAC,SAAS,oCACZ,wBAAwB,CAAC,SAAS,CAC5C,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;AAExB,MAAa,+DAAsC;CACjD,iDAAwB,CAAC,SAAS,CAAC,SAAS;CAS5C,gDAAuB,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE;CACvD,aAAa;CACb,oBAAoB;CACpB,yFAAuC,CAAC,SAAS,sCAAa,CAAC,SAAS,CAAC,CAAC,SAAS;CACnF,yBAAyB;CAIzB,uDAA8B,wBAAwB,CAAC,SAAS;CAChE,mDAA0B,wBAAwB,CAAC,SAAS;CAC5D,iDAAwB,8BAA8B,CAAC,SAAS;CAChE,eAAe;CACf,mBAAmB;CACnB,gBAAgB;CAChB,oBAAoB;CACrB,CAAC,CAAC,SAAS;AAEZ,MAAa,6DAAoC;CAC/C,iDAAwB,CAAC,SAAS,CAAC,SAAS;CAC5C,qDAA4B,CAAC,SAAS,CAAC,SAAS;CACjD,CAAC,CAAC,SAAS"}

package/dist/interface/client-interface.js

@@ -13,9 +13,9 @@ let ___utils_globals_js = require("../utils/globals.js");
 let ___utils_http_js = require("../utils/http.js");
 let ___utils_promises_js = require("../utils/promises.js");
 
-//#region ../../node_modules/.pnpm/oauth4webapi@3.8.3/node_modules/oauth4webapi/build/index.js
+//#region ../../node_modules/.pnpm/oauth4webapi@3.8.5/node_modules/oauth4webapi/build/index.js
 let USER_AGENT;
-if (typeof navigator === "undefined" || !navigator.userAgent?.startsWith?.("Mozilla/5.0 ")) USER_AGENT = `oauth4webapi/v3.8.3`;
+if (typeof navigator === "undefined" || !navigator.userAgent?.startsWith?.("Mozilla/5.0 ")) USER_AGENT = `oauth4webapi/v3.8.5`;
 function looseInstanceOf(input, expected) {
 	if (input == null) return false;
 	try {