@fitzzero/quickdraw-core 2.0.0 → 2.1.0

package/dist/client/index.d.ts

@@ -385,4 +385,100 @@ interface SocketSwitchProps<TEntry, TAllowedUpdate, TKey extends keyof TAllowedU
  */
 declare function SocketSwitch<TEntry, TAllowedUpdate, TKey extends keyof TAllowedUpdate>(props: SocketSwitchProps<TEntry, TAllowedUpdate, TKey>): React.ReactElement;
 
-export { type CommitMode, QuickdrawProvider, QuickdrawProviderProps, QuickdrawSocketContextValue, SocketCheckbox, type SocketCheckboxProps, SocketSelect, type SocketSelectProps, SocketSlider, type SocketSliderProps, SocketSwitch, type SocketSwitchProps, SocketTextField, type SocketTextFieldProps, UseServiceOptions, UseServiceQueryOptions, UseServiceQueryResult, UseServiceResult, type UseSocketInputOptions, type UseSocketInputResult, UseSubscriptionOptions, UseSubscriptionResult, useQuickdrawSocket, useService, useServiceMethod, useServiceQuery, useSocketInput, useSubscription };
+/**
+ * Format a currency value for display.
+ */
+declare function formatCurrency(value: string | number | null | undefined, currency?: string, locale?: string): string;
+/**
+ * Format a number for display with optional decimal places.
+ */
+declare function formatNumber(value: string | number | null | undefined, options?: Intl.NumberFormatOptions, locale?: string): string;
+/**
+ * Format a date for display.
+ */
+declare function formatDate(value: string | Date | null | undefined, options?: Intl.DateTimeFormatOptions, locale?: string): string;
+/**
+ * Format a date with time for display.
+ */
+declare function formatDateTime(value: string | Date | null | undefined, options?: Intl.DateTimeFormatOptions, locale?: string): string;
+/**
+ * Truncate a string to a maximum length.
+ */
+declare function truncate(value: string | null | undefined, maxLength?: number): string;
+/**
+ * Format a percentage for display.
+ */
+declare function formatPercent(value: string | number | null | undefined, decimals?: number, locale?: string): string;
+
+/**
+ * Get the stored auth token from localStorage.
+ */
+declare function getAuthToken(): string | null;
+/**
+ * Store the auth token in localStorage and dispatch a change event.
+ */
+declare function setAuthToken(token: string): void;
+/**
+ * Remove the auth token from localStorage and dispatch a change event.
+ */
+declare function clearAuthToken(): void;
+interface JWTPayload {
+    userId: string;
+    email?: string;
+}
+/**
+ * Parse JWT payload client-side (not verified, for display purposes only).
+ */
+declare function parseJWTPayload(token: string): JWTPayload | null;
+/**
+ * Build an OAuth redirect URL for a given provider.
+ */
+declare function getOAuthUrl(provider: string, apiUrl?: string): string;
+/**
+ * Logout from current session (invalidate token on server and clear localStorage).
+ */
+declare function logout(apiUrl?: string): Promise<void>;
+/**
+ * Logout from all devices (invalidate all sessions and clear localStorage).
+ * Returns the number of sessions invalidated.
+ */
+declare function logoutAllDevices(apiUrl?: string): Promise<number>;
+
+interface NavItem {
+    id: string;
+    label: string;
+    href: string;
+    icon?: unknown;
+    children?: NavItem[];
+    defaultExpanded?: boolean;
+    requireAuth?: boolean;
+    dynamicChildren?: boolean;
+    serviceName?: string;
+    minAccessLevel?: string;
+}
+interface BreadcrumbItem {
+    label: string;
+    href: string;
+    siblings?: {
+        label: string;
+        href: string;
+    }[];
+}
+/**
+ * Find a nav item by its href (exact match, searching children recursively).
+ */
+declare function findNavItemByHref(items: NavItem[], href: string): NavItem | undefined;
+/**
+ * Find the parent nav item containing a child with the given href.
+ */
+declare function findParentNavItem(items: NavItem[], href: string): NavItem | undefined;
+/**
+ * Build breadcrumb items from a pathname using the provided navigation config.
+ */
+declare function buildBreadcrumbs(pathname: string, navigation: NavItem[]): BreadcrumbItem[];
+/**
+ * Check if a route requires authentication by searching the navigation config.
+ */
+declare function routeRequiresAuth(pathname: string, navigation: NavItem[], userMenuItems?: NavItem[]): boolean;
+
+export { type BreadcrumbItem, type CommitMode, type JWTPayload, type NavItem, QuickdrawProvider, QuickdrawProviderProps, QuickdrawSocketContextValue, SocketCheckbox, type SocketCheckboxProps, SocketSelect, type SocketSelectProps, SocketSlider, type SocketSliderProps, SocketSwitch, type SocketSwitchProps, SocketTextField, type SocketTextFieldProps, UseServiceOptions, UseServiceQueryOptions, UseServiceQueryResult, UseServiceResult, type UseSocketInputOptions, type UseSocketInputResult, UseSubscriptionOptions, UseSubscriptionResult, buildBreadcrumbs, clearAuthToken, findNavItemByHref, findParentNavItem, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, getAuthToken, getOAuthUrl, logout, logoutAllDevices, parseJWTPayload, routeRequiresAuth, setAuthToken, truncate, useQuickdrawSocket, useService, useServiceMethod, useServiceQuery, useSocketInput, useSubscription };

package/dist/client/index.js

@@ -849,6 +849,215 @@ function SocketSwitch(props) {
   );
 }
 
-export { QuickdrawProvider, SocketCheckbox, SocketSelect, SocketSlider, SocketSwitch, SocketTextField, useQuickdrawSocket, useService, useServiceMethod, useServiceQuery, useSocketInput, useSubscription };
+// src/client/utils/formatting.ts
+function formatCurrency(value, currency = "USD", locale = "en-US") {
+  if (value == null) return "-";
+  const num = typeof value === "string" ? parseFloat(value) : value;
+  if (isNaN(num)) return "-";
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency
+  }).format(num);
+}
+function formatNumber(value, options, locale = "en-US") {
+  if (value == null) return "-";
+  const num = typeof value === "string" ? parseFloat(value) : value;
+  if (isNaN(num)) return "-";
+  return new Intl.NumberFormat(locale, options).format(num);
+}
+function formatDate(value, options, locale = "en-US") {
+  if (!value) return "-";
+  const date = typeof value === "string" ? new Date(value) : value;
+  if (isNaN(date.getTime())) return "-";
+  return date.toLocaleDateString(
+    locale,
+    options ?? {
+      year: "numeric",
+      month: "short",
+      day: "numeric"
+    }
+  );
+}
+function formatDateTime(value, options, locale = "en-US") {
+  if (!value) return "-";
+  const date = typeof value === "string" ? new Date(value) : value;
+  if (isNaN(date.getTime())) return "-";
+  return date.toLocaleString(
+    locale,
+    options ?? {
+      year: "numeric",
+      month: "short",
+      day: "numeric",
+      hour: "numeric",
+      minute: "2-digit"
+    }
+  );
+}
+function truncate(value, maxLength = 50) {
+  if (!value) return "-";
+  if (value.length <= maxLength) return value;
+  return `${value.slice(0, maxLength - 3)}...`;
+}
+function formatPercent(value, decimals = 1, locale = "en-US") {
+  if (value == null) return "-";
+  const num = typeof value === "string" ? parseFloat(value) : value;
+  if (isNaN(num)) return "-";
+  return new Intl.NumberFormat(locale, {
+    style: "percent",
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals
+  }).format(num / 100);
+}
+
+// src/client/utils/auth.ts
+var AUTH_TOKEN_KEY = "auth_token";
+function getAuthToken() {
+  if (typeof window === "undefined") return null;
+  return localStorage.getItem(AUTH_TOKEN_KEY);
+}
+function setAuthToken(token) {
+  if (typeof window === "undefined") return;
+  localStorage.setItem(AUTH_TOKEN_KEY, token);
+  window.dispatchEvent(new Event("auth-token-changed"));
+}
+function clearAuthToken() {
+  if (typeof window === "undefined") return;
+  localStorage.removeItem(AUTH_TOKEN_KEY);
+  window.dispatchEvent(new Event("auth-token-changed"));
+}
+function parseJWTPayload(token) {
+  try {
+    const parts = token.split(".");
+    if (parts.length !== 3 || !parts[1]) return null;
+    const decoded = atob(parts[1]);
+    const payload = JSON.parse(decoded);
+    if (typeof payload === "object" && payload !== null && "userId" in payload && typeof payload.userId === "string") {
+      const typedPayload = payload;
+      return {
+        userId: typedPayload.userId,
+        email: typedPayload.email
+      };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getOAuthUrl(provider, apiUrl) {
+  const base = apiUrl ?? process.env.NEXT_PUBLIC_API_URL ?? "http://localhost:4000";
+  return `${base}/auth/${provider}`;
+}
+async function logout(apiUrl) {
+  const base = apiUrl ?? process.env.NEXT_PUBLIC_API_URL ?? "http://localhost:4000";
+  const token = getAuthToken();
+  if (token) {
+    try {
+      await fetch(`${base}/auth/logout`, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${token}` }
+      });
+    } catch {
+    }
+  }
+  clearAuthToken();
+}
+async function logoutAllDevices(apiUrl) {
+  const base = apiUrl ?? process.env.NEXT_PUBLIC_API_URL ?? "http://localhost:4000";
+  const token = getAuthToken();
+  if (!token) {
+    clearAuthToken();
+    return 0;
+  }
+  try {
+    const response = await fetch(`${base}/auth/sessions`, {
+      method: "DELETE",
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (response.ok) {
+      const data = await response.json();
+      clearAuthToken();
+      return data.sessionsDeleted ?? 0;
+    }
+  } catch {
+  }
+  clearAuthToken();
+  return 0;
+}
+
+// src/client/utils/navigation.ts
+function findNavItemByHref(items, href) {
+  for (const item of items) {
+    if (item.href === href) return item;
+    if (item.children) {
+      const found = findNavItemByHref(item.children, href);
+      if (found) return found;
+    }
+  }
+  return void 0;
+}
+function findParentNavItem(items, href) {
+  for (const item of items) {
+    if (item.children) {
+      const childMatch = item.children.find((c) => c.href === href);
+      if (childMatch) return item;
+      const nested = findParentNavItem(item.children, href);
+      if (nested) return nested;
+    }
+  }
+  return void 0;
+}
+function buildBreadcrumbs(pathname, navigation) {
+  const breadcrumbs = [];
+  if (pathname === "/") {
+    breadcrumbs.push({
+      label: "Home",
+      href: "/",
+      siblings: navigation.filter((item) => item.href === "/" || !item.requireAuth).map((item) => ({ label: item.label, href: item.href }))
+    });
+    return breadcrumbs;
+  }
+  const segments = pathname.split("/").filter(Boolean);
+  let currentPath = "";
+  for (const segment of segments) {
+    currentPath += `/${segment}`;
+    const navItem = findNavItemByHref(navigation, currentPath);
+    if (navItem) {
+      const parent = findParentNavItem(navigation, currentPath);
+      const siblingItems = parent?.children ?? navigation;
+      breadcrumbs.push({
+        label: navItem.label,
+        href: navItem.href,
+        siblings: siblingItems.map((item) => ({
+          label: item.label,
+          href: item.href
+        }))
+      });
+    } else {
+      breadcrumbs.push({
+        label: segment,
+        href: currentPath
+      });
+    }
+  }
+  return breadcrumbs;
+}
+function routeRequiresAuth(pathname, navigation, userMenuItems) {
+  const navItem = findNavItemByHref(navigation, pathname);
+  if (navItem) return navItem.requireAuth ?? false;
+  if (userMenuItems) {
+    const userItem = findNavItemByHref(userMenuItems, pathname);
+    if (userItem) return userItem.requireAuth ?? false;
+  }
+  const segments = pathname.split("/").filter(Boolean);
+  let currentPath = "";
+  for (const segment of segments) {
+    currentPath += `/${segment}`;
+    const item = findNavItemByHref(navigation, currentPath);
+    if (item?.requireAuth) return true;
+  }
+  return false;
+}
+
+export { QuickdrawProvider, SocketCheckbox, SocketSelect, SocketSlider, SocketSwitch, SocketTextField, buildBreadcrumbs, clearAuthToken, findNavItemByHref, findParentNavItem, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, getAuthToken, getOAuthUrl, logout, logoutAllDevices, parseJWTPayload, routeRequiresAuth, setAuthToken, truncate, useQuickdrawSocket, useService, useServiceMethod, useServiceQuery, useSocketInput, useSubscription };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map