@payez/next-mvp 4.8.0 → 4.8.2

package/src/templates/instrumentation.ts

@@ -1,60 +1,60 @@
-/**
- * Next.js Instrumentation Hook Template
- *
- * Copy this file to your project root as `instrumentation.ts`
- *
- * This runs once when the server starts up (before any requests are handled).
- * It initializes the broker handshake to fetch OAuth providers and secrets from IDP.
- *
- * REQUIRED: Your next.config.js must have `output: 'standalone'` for this to work.
- */
-
-export async function register() {
-  if (process.env.NEXT_RUNTIME === 'nodejs') {
-    // Only run on Node.js runtime (not Edge)
-    console.log('\n');
-    console.log('╔══════════════════════════════════════════════════════════════╗');
-    console.log('║            PayEz Next MVP - Server Startup                   ║');
-    console.log('╚══════════════════════════════════════════════════════════════╝');
-    console.log('');
-
-    try {
-      // Dynamically import at runtime to ensure server environment
-      const { logStartupStatus, ensureInitialized } = await import(
-        '@payez/next-mvp/lib/startup-init'
-      );
-
-      // Log startup status
-      logStartupStatus();
-
-      // Perform initialization (fetch client config from IDP including OAuth providers)
-      await ensureInitialized();
-
-      console.log('');
-      console.log('Server startup initialization complete!');
-      console.log('');
-    } catch (error) {
-      // DO NOT SWALLOW THIS. The previous version logged "Will retry initialization on
-      // first request" and let the server come up - so a site printed "Ready" while
-      // holding NO auth config, and betterAuth() got an empty secret, which it silently
-      // upgrades to the public DEFAULT_SECRET. Unavailable beats forgeable.
-      //
-      // payez_idp_admin_web/src/instrumentation.ts is the reference: it does not catch
-      // at all, and has a deliberate, named EMERGENCY_BYPASS_IDP escape hatch instead.
-      const msg = error instanceof Error ? error.message : String(error);
-      console.error('');
-      console.error('╔══════════════════════════════════════════════════════════════╗');
-      console.error('║   STARTUP FAILED — REFUSING TO SERVE                         ║');
-      console.error('╚══════════════════════════════════════════════════════════════╝');
-      console.error('');
-      console.error('  ' + msg);
-      console.error('');
-      console.error('  This server cannot obtain its auth configuration from the IDP,');
-      console.error('  so it has no signing secret and no sign-in policy.');
-      console.error('');
-      // Next CATCHES errors thrown from register() and continues; exiting is the only
-      // thing that actually stops the server coming up.
-      process.exit(1);
-    }
-  }
-}
+/**
+ * Next.js Instrumentation Hook Template
+ *
+ * Copy this file to your project root as `instrumentation.ts`
+ *
+ * This runs once when the server starts up (before any requests are handled).
+ * It initializes the broker handshake to fetch OAuth providers and secrets from IDP.
+ *
+ * REQUIRED: Your next.config.js must have `output: 'standalone'` for this to work.
+ */
+
+export async function register() {
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    // Only run on Node.js runtime (not Edge)
+    console.log('\n');
+    console.log('╔══════════════════════════════════════════════════════════════╗');
+    console.log('║            PayEz Next MVP - Server Startup                   ║');
+    console.log('╚══════════════════════════════════════════════════════════════╝');
+    console.log('');
+
+    try {
+      // Dynamically import at runtime to ensure server environment
+      const { logStartupStatus, ensureInitialized } = await import(
+        '@payez/next-mvp/lib/startup-init'
+      );
+
+      // Log startup status
+      logStartupStatus();
+
+      // Perform initialization (fetch client config from IDP including OAuth providers)
+      await ensureInitialized();
+
+      console.log('');
+      console.log('Server startup initialization complete!');
+      console.log('');
+    } catch (error) {
+      // DO NOT SWALLOW THIS. The previous version logged "Will retry initialization on
+      // first request" and let the server come up - so a site printed "Ready" while
+      // holding NO auth config, and betterAuth() got an empty secret, which it silently
+      // upgrades to the public DEFAULT_SECRET. Unavailable beats forgeable.
+      //
+      // payez_idp_admin_web/src/instrumentation.ts is the reference: it does not catch
+      // at all, and has a deliberate, named EMERGENCY_BYPASS_IDP escape hatch instead.
+      const msg = error instanceof Error ? error.message : String(error);
+      console.error('');
+      console.error('╔══════════════════════════════════════════════════════════════╗');
+      console.error('║   STARTUP FAILED — REFUSING TO SERVE                         ║');
+      console.error('╚══════════════════════════════════════════════════════════════╝');
+      console.error('');
+      console.error('  ' + msg);
+      console.error('');
+      console.error('  This server cannot obtain its auth configuration from the IDP,');
+      console.error('  so it has no signing secret and no sign-in policy.');
+      console.error('');
+      // Next CATCHES errors thrown from register() and continues; exiting is the only
+      // thing that actually stops the server coming up.
+      process.exit(1);
+    }
+  }
+}

package/src/theme/ThemeProvider.tsx

@@ -1,39 +1,39 @@
-/**
- * Theme Provider for @payez/next-mvp
- *
- * Provides theme configuration to all child components via React Context.
- * Consumer apps wrap their app with this provider and pass custom theme config.
- */
-
-'use client';
-
-import React, { createContext, useContext } from 'react';
-import { ThemeConfig } from './types';
-import { defaultTheme } from './default';
-import { mergeDeep } from './utils';
-
-const ThemeContext = createContext<ThemeConfig>(defaultTheme);
-
-export interface ThemeProviderProps {
-  children: React.ReactNode;
-  theme?: Partial<ThemeConfig>;
-}
-
-export function ThemeProvider({ children, theme }: ThemeProviderProps) {
-  // Deep merge consumer theme with defaults
-  const mergedTheme = mergeDeep(defaultTheme, theme || {});
-
-  return (
-    <ThemeContext.Provider value={mergedTheme}>
-      {children}
-    </ThemeContext.Provider>
-  );
-}
-
-export function useTheme() {
-  const context = useContext(ThemeContext);
-  if (!context) {
-    throw new Error('useTheme must be used within ThemeProvider');
-  }
-  return context;
-}
+/**
+ * Theme Provider for @payez/next-mvp
+ *
+ * Provides theme configuration to all child components via React Context.
+ * Consumer apps wrap their app with this provider and pass custom theme config.
+ */
+
+'use client';
+
+import React, { createContext, useContext } from 'react';
+import { ThemeConfig } from './types';
+import { defaultTheme } from './default';
+import { mergeDeep } from './utils';
+
+const ThemeContext = createContext<ThemeConfig>(defaultTheme);
+
+export interface ThemeProviderProps {
+  children: React.ReactNode;
+  theme?: Partial<ThemeConfig>;
+}
+
+export function ThemeProvider({ children, theme }: ThemeProviderProps) {
+  // Deep merge consumer theme with defaults
+  const mergedTheme = mergeDeep(defaultTheme, theme || {});
+
+  return (
+    <ThemeContext.Provider value={mergedTheme}>
+      {children}
+    </ThemeContext.Provider>
+  );
+}
+
+export function useTheme() {
+  const context = useContext(ThemeContext);
+  if (!context) {
+    throw new Error('useTheme must be used within ThemeProvider');
+  }
+  return context;
+}

package/src/theme/default.ts

@@ -1,33 +1,33 @@
-/**
- * Default Theme Configuration for @payez/next-mvp
- *
- * This is the fallback theme when no custom theme is provided.
- * It provides sensible defaults that match the current unbranded styling.
- */
-
-import { ThemeConfig } from './types';
-
-export const defaultTheme: ThemeConfig = {
-  branding: {
-    logo: {
-      light: "/logo.svg",
-      dark: "/logo.svg",
-      alt: "Logo",
-      height: "h-10",
-      width: "w-auto",
-    },
-    appName: "App",
-  },
-  colors: {
-    primary: "#3b82f6",      // blue-500
-    background: "bg-gray-50",
-    card: "bg-white",
-    muted: "text-gray-600",
-    border: "border-gray-200",
-  },
-  layout: {
-    maxWidth: "max-w-4xl",
-    padding: "p-6",
-    spacing: "space-y-6",
-  },
-};
+/**
+ * Default Theme Configuration for @payez/next-mvp
+ *
+ * This is the fallback theme when no custom theme is provided.
+ * It provides sensible defaults that match the current unbranded styling.
+ */
+
+import { ThemeConfig } from './types';
+
+export const defaultTheme: ThemeConfig = {
+  branding: {
+    logo: {
+      light: "/logo.svg",
+      dark: "/logo.svg",
+      alt: "Logo",
+      height: "h-10",
+      width: "w-auto",
+    },
+    appName: "App",
+  },
+  colors: {
+    primary: "#3b82f6",      // blue-500
+    background: "bg-gray-50",
+    card: "bg-white",
+    muted: "text-gray-600",
+    border: "border-gray-200",
+  },
+  layout: {
+    maxWidth: "max-w-4xl",
+    padding: "p-6",
+    spacing: "space-y-6",
+  },
+};

package/src/theme/index.ts

@@ -1,31 +1,31 @@
-/**
- * Theme Module for @payez/next-mvp
- *
- * Main export for the theme system. Provides:
- * - ThemeProvider component
- * - Theme hooks (useTheme, useBranding, useColors, etc.)
- * - TypeScript types for theme configuration
- * - Default theme
- */
-
-export { ThemeProvider } from './ThemeProvider';
-export type { ThemeProviderProps } from './ThemeProvider';
-
-export {
-  useTheme,
-  useBranding,
-  useColors,
-  useTypography,
-  useLayout,
-  useComponentTheme,
-} from './useTheme';
-
-export type {
-  ThemeConfig,
-  LoginPageTheme,
-  ProfilePageTheme,
-  RecoveryPageTheme,
-} from './types';
-
-export { defaultTheme } from './default';
-export { mergeDeep } from './utils';
+/**
+ * Theme Module for @payez/next-mvp
+ *
+ * Main export for the theme system. Provides:
+ * - ThemeProvider component
+ * - Theme hooks (useTheme, useBranding, useColors, etc.)
+ * - TypeScript types for theme configuration
+ * - Default theme
+ */
+
+export { ThemeProvider } from './ThemeProvider';
+export type { ThemeProviderProps } from './ThemeProvider';
+
+export {
+  useTheme,
+  useBranding,
+  useColors,
+  useTypography,
+  useLayout,
+  useComponentTheme,
+} from './useTheme';
+
+export type {
+  ThemeConfig,
+  LoginPageTheme,
+  ProfilePageTheme,
+  RecoveryPageTheme,
+} from './types';
+
+export { defaultTheme } from './default';
+export { mergeDeep } from './utils';

package/src/theme/types.ts

@@ -1,69 +1,69 @@
-/**
- * Theme Configuration Types for @payez/next-mvp
- *
- * These types define the shape of theme configurations that consumers
- * can provide to customize branding, colors, typography, and layout.
- */
-
-export interface ThemeConfig {
-  // Branding
-  branding: {
-    logo: {
-      light: string;        // Path to logo for light backgrounds
-      dark: string;         // Path to logo for dark backgrounds
-      alt: string;          // Alt text
-      height?: string;      // Default: "h-10"
-      width?: string;       // Default: "w-auto"
-    };
-    appName: string;        // "Nexus", "CryptAply", etc.
-    tagline?: string;       // Optional tagline
-  };
-
-  // Colors (Tailwind classes or hex)
-  colors: {
-    primary: string;        // Primary brand color
-    secondary?: string;     // Secondary brand color
-    accent?: string;        // Accent color
-    background: string;     // Page background
-    card: string;          // Card background
-    muted: string;         // Muted text/elements
-    border: string;        // Border color
-  };
-
-  // Typography
-  typography?: {
-    fontFamily?: string;   // Font family
-    headingWeight?: string; // "font-bold", etc.
-    bodyWeight?: string;   // "font-normal", etc.
-  };
-
-  // Layout
-  layout?: {
-    maxWidth?: string;     // "max-w-4xl", etc.
-    padding?: string;      // "p-6", etc.
-    spacing?: string;      // "space-y-6", etc.
-  };
-
-  // Component-specific overrides
-  components?: {
-    loginPage?: Partial<LoginPageTheme>;
-    profilePage?: Partial<ProfilePageTheme>;
-    recoveryPage?: Partial<RecoveryPageTheme>;
-  };
-}
-
-export interface LoginPageTheme {
-  cardBackground: string;
-  gradient: string;
-  buttonColor: string;
-  showLogo: boolean;
-}
-
-export interface ProfilePageTheme {
-  layout: "centered" | "full-width";
-  showAvatar: boolean;
-}
-
-export interface RecoveryPageTheme {
-  layout: "centered" | "full-width";
-}
+/**
+ * Theme Configuration Types for @payez/next-mvp
+ *
+ * These types define the shape of theme configurations that consumers
+ * can provide to customize branding, colors, typography, and layout.
+ */
+
+export interface ThemeConfig {
+  // Branding
+  branding: {
+    logo: {
+      light: string;        // Path to logo for light backgrounds
+      dark: string;         // Path to logo for dark backgrounds
+      alt: string;          // Alt text
+      height?: string;      // Default: "h-10"
+      width?: string;       // Default: "w-auto"
+    };
+    appName: string;        // "Nexus", "CryptAply", etc.
+    tagline?: string;       // Optional tagline
+  };
+
+  // Colors (Tailwind classes or hex)
+  colors: {
+    primary: string;        // Primary brand color
+    secondary?: string;     // Secondary brand color
+    accent?: string;        // Accent color
+    background: string;     // Page background
+    card: string;          // Card background
+    muted: string;         // Muted text/elements
+    border: string;        // Border color
+  };
+
+  // Typography
+  typography?: {
+    fontFamily?: string;   // Font family
+    headingWeight?: string; // "font-bold", etc.
+    bodyWeight?: string;   // "font-normal", etc.
+  };
+
+  // Layout
+  layout?: {
+    maxWidth?: string;     // "max-w-4xl", etc.
+    padding?: string;      // "p-6", etc.
+    spacing?: string;      // "space-y-6", etc.
+  };
+
+  // Component-specific overrides
+  components?: {
+    loginPage?: Partial<LoginPageTheme>;
+    profilePage?: Partial<ProfilePageTheme>;
+    recoveryPage?: Partial<RecoveryPageTheme>;
+  };
+}
+
+export interface LoginPageTheme {
+  cardBackground: string;
+  gradient: string;
+  buttonColor: string;
+  showLogo: boolean;
+}
+
+export interface ProfilePageTheme {
+  layout: "centered" | "full-width";
+  showAvatar: boolean;
+}
+
+export interface RecoveryPageTheme {
+  layout: "centered" | "full-width";
+}

package/src/theme/useTheme.ts

@@ -1,57 +1,57 @@
-/**
- * Theme Hooks for @payez/next-mvp
- *
- * Convenience hooks for accessing specific parts of the theme configuration.
- * These hooks can only be used within components wrapped by ThemeProvider.
- */
-
-'use client';
-
-import { useTheme as useThemeContext } from './ThemeProvider';
-
-/**
- * Access the full theme configuration
- */
-export function useTheme() {
-  return useThemeContext();
-}
-
-/**
- * Access branding configuration (logo, app name, tagline)
- */
-export function useBranding() {
-  const theme = useThemeContext();
-  return theme.branding;
-}
-
-/**
- * Access color configuration
- */
-export function useColors() {
-  const theme = useThemeContext();
-  return theme.colors;
-}
-
-/**
- * Access typography configuration
- */
-export function useTypography() {
-  const theme = useThemeContext();
-  return theme.typography;
-}
-
-/**
- * Access layout configuration
- */
-export function useLayout() {
-  const theme = useThemeContext();
-  return theme.layout;
-}
-
-/**
- * Access component-specific theme overrides
- */
-export function useComponentTheme() {
-  const theme = useThemeContext();
-  return theme.components;
-}
+/**
+ * Theme Hooks for @payez/next-mvp
+ *
+ * Convenience hooks for accessing specific parts of the theme configuration.
+ * These hooks can only be used within components wrapped by ThemeProvider.
+ */
+
+'use client';
+
+import { useTheme as useThemeContext } from './ThemeProvider';
+
+/**
+ * Access the full theme configuration
+ */
+export function useTheme() {
+  return useThemeContext();
+}
+
+/**
+ * Access branding configuration (logo, app name, tagline)
+ */
+export function useBranding() {
+  const theme = useThemeContext();
+  return theme.branding;
+}
+
+/**
+ * Access color configuration
+ */
+export function useColors() {
+  const theme = useThemeContext();
+  return theme.colors;
+}
+
+/**
+ * Access typography configuration
+ */
+export function useTypography() {
+  const theme = useThemeContext();
+  return theme.typography;
+}
+
+/**
+ * Access layout configuration
+ */
+export function useLayout() {
+  const theme = useThemeContext();
+  return theme.layout;
+}
+
+/**
+ * Access component-specific theme overrides
+ */
+export function useComponentTheme() {
+  const theme = useThemeContext();
+  return theme.components;
+}

package/src/theme/utils.ts

@@ -1,40 +1,40 @@
-/**
- * Theme Utility Functions
- *
- * Provides helper functions for theme management, including deep merging
- * of theme configurations.
- */
-
-/**
- * Deep merge two objects, with the second object taking precedence
- * @param target - Base object
- * @param source - Object to merge in (takes precedence)
- * @returns Merged object
- */
-export function mergeDeep<T extends Record<string, any>>(target: T, source: Partial<T>): T {
-  const output: any = { ...target };
-
-  if (isObject(target) && isObject(source)) {
-    Object.keys(source).forEach((key) => {
-      const sourceValue = (source as any)[key];
-      const targetValue = (target as any)[key];
-
-      if (isObject(sourceValue) && isObject(targetValue)) {
-        // Recursively merge nested objects
-        output[key] = mergeDeep(targetValue, sourceValue);
-      } else if (sourceValue !== undefined) {
-        // Use source value if it's defined
-        output[key] = sourceValue;
-      }
-    });
-  }
-
-  return output as T;
-}
-
-/**
- * Check if a value is a plain object
- */
-function isObject(item: any): item is Record<string, any> {
-  return item && typeof item === 'object' && !Array.isArray(item);
-}
+/**
+ * Theme Utility Functions
+ *
+ * Provides helper functions for theme management, including deep merging
+ * of theme configurations.
+ */
+
+/**
+ * Deep merge two objects, with the second object taking precedence
+ * @param target - Base object
+ * @param source - Object to merge in (takes precedence)
+ * @returns Merged object
+ */
+export function mergeDeep<T extends Record<string, any>>(target: T, source: Partial<T>): T {
+  const output: any = { ...target };
+
+  if (isObject(target) && isObject(source)) {
+    Object.keys(source).forEach((key) => {
+      const sourceValue = (source as any)[key];
+      const targetValue = (target as any)[key];
+
+      if (isObject(sourceValue) && isObject(targetValue)) {
+        // Recursively merge nested objects
+        output[key] = mergeDeep(targetValue, sourceValue);
+      } else if (sourceValue !== undefined) {
+        // Use source value if it's defined
+        output[key] = sourceValue;
+      }
+    });
+  }
+
+  return output as T;
+}
+
+/**
+ * Check if a value is a plain object
+ */
+function isObject(item: any): item is Record<string, any> {
+  return item && typeof item === 'object' && !Array.isArray(item);
+}