@payez/next-mvp 3.0.0

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+import React from 'react';
+import { ThemeConfig } from './types';
+export interface ThemeProviderProps {
+    children: React.ReactNode;
+    theme?: Partial<ThemeConfig>;
+}
+export declare function ThemeProvider({ children, theme }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useTheme(): ThemeConfig;

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * 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';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeProvider = ThemeProvider;
+exports.useTheme = useTheme;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const default_1 = require("./default");
+const utils_1 = require("./utils");
+const ThemeContext = (0, react_1.createContext)(default_1.defaultTheme);
+function ThemeProvider({ children, theme }) {
+    // Deep merge consumer theme with defaults
+    const mergedTheme = (0, utils_1.mergeDeep)(default_1.defaultTheme, theme || {});
+    return ((0, jsx_runtime_1.jsx)(ThemeContext.Provider, { value: mergedTheme, children: children }));
+}
+function useTheme() {
+    const context = (0, react_1.useContext)(ThemeContext);
+    if (!context) {
+        throw new Error('useTheme must be used within ThemeProvider');
+    }
+    return context;
+}

package/dist/theme/default.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 declare const defaultTheme: ThemeConfig;

package/dist/theme/default.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTheme = void 0;
+exports.defaultTheme = {
+    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/dist/theme/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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/dist/theme/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeDeep = exports.defaultTheme = exports.useComponentTheme = exports.useLayout = exports.useTypography = exports.useColors = exports.useBranding = exports.useTheme = exports.ThemeProvider = void 0;
+var ThemeProvider_1 = require("./ThemeProvider");
+Object.defineProperty(exports, "ThemeProvider", { enumerable: true, get: function () { return ThemeProvider_1.ThemeProvider; } });
+var useTheme_1 = require("./useTheme");
+Object.defineProperty(exports, "useTheme", { enumerable: true, get: function () { return useTheme_1.useTheme; } });
+Object.defineProperty(exports, "useBranding", { enumerable: true, get: function () { return useTheme_1.useBranding; } });
+Object.defineProperty(exports, "useColors", { enumerable: true, get: function () { return useTheme_1.useColors; } });
+Object.defineProperty(exports, "useTypography", { enumerable: true, get: function () { return useTheme_1.useTypography; } });
+Object.defineProperty(exports, "useLayout", { enumerable: true, get: function () { return useTheme_1.useLayout; } });
+Object.defineProperty(exports, "useComponentTheme", { enumerable: true, get: function () { return useTheme_1.useComponentTheme; } });
+var default_1 = require("./default");
+Object.defineProperty(exports, "defaultTheme", { enumerable: true, get: function () { return default_1.defaultTheme; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "mergeDeep", { enumerable: true, get: function () { return utils_1.mergeDeep; } });

package/dist/theme/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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: {
+        logo: {
+            light: string;
+            dark: string;
+            alt: string;
+            height?: string;
+            width?: string;
+        };
+        appName: string;
+        tagline?: string;
+    };
+    colors: {
+        primary: string;
+        secondary?: string;
+        accent?: string;
+        background: string;
+        card: string;
+        muted: string;
+        border: string;
+    };
+    typography?: {
+        fontFamily?: string;
+        headingWeight?: string;
+        bodyWeight?: string;
+    };
+    layout?: {
+        maxWidth?: string;
+        padding?: string;
+        spacing?: string;
+    };
+    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/dist/theme/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/theme/useTheme.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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.
+ */
+/**
+ * Access the full theme configuration
+ */
+export declare function useTheme(): import("./types").ThemeConfig;
+/**
+ * Access branding configuration (logo, app name, tagline)
+ */
+export declare function useBranding(): {
+    logo: {
+        light: string;
+        dark: string;
+        alt: string;
+        height?: string;
+        width?: string;
+    };
+    appName: string;
+    tagline?: string;
+};
+/**
+ * Access color configuration
+ */
+export declare function useColors(): {
+    primary: string;
+    secondary?: string;
+    accent?: string;
+    background: string;
+    card: string;
+    muted: string;
+    border: string;
+};
+/**
+ * Access typography configuration
+ */
+export declare function useTypography(): {
+    fontFamily?: string;
+    headingWeight?: string;
+    bodyWeight?: string;
+} | undefined;
+/**
+ * Access layout configuration
+ */
+export declare function useLayout(): {
+    maxWidth?: string;
+    padding?: string;
+    spacing?: string;
+} | undefined;
+/**
+ * Access component-specific theme overrides
+ */
+export declare function useComponentTheme(): {
+    loginPage?: Partial<import("./types").LoginPageTheme>;
+    profilePage?: Partial<import("./types").ProfilePageTheme>;
+    recoveryPage?: Partial<import("./types").RecoveryPageTheme>;
+} | undefined;

package/dist/theme/useTheme.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * 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';
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTheme = useTheme;
+exports.useBranding = useBranding;
+exports.useColors = useColors;
+exports.useTypography = useTypography;
+exports.useLayout = useLayout;
+exports.useComponentTheme = useComponentTheme;
+const ThemeProvider_1 = require("./ThemeProvider");
+/**
+ * Access the full theme configuration
+ */
+function useTheme() {
+    return (0, ThemeProvider_1.useTheme)();
+}
+/**
+ * Access branding configuration (logo, app name, tagline)
+ */
+function useBranding() {
+    const theme = (0, ThemeProvider_1.useTheme)();
+    return theme.branding;
+}
+/**
+ * Access color configuration
+ */
+function useColors() {
+    const theme = (0, ThemeProvider_1.useTheme)();
+    return theme.colors;
+}
+/**
+ * Access typography configuration
+ */
+function useTypography() {
+    const theme = (0, ThemeProvider_1.useTheme)();
+    return theme.typography;
+}
+/**
+ * Access layout configuration
+ */
+function useLayout() {
+    const theme = (0, ThemeProvider_1.useTheme)();
+    return theme.layout;
+}
+/**
+ * Access component-specific theme overrides
+ */
+function useComponentTheme() {
+    const theme = (0, ThemeProvider_1.useTheme)();
+    return theme.components;
+}

package/dist/theme/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 declare function mergeDeep<T extends Record<string, any>>(target: T, source: Partial<T>): T;

package/dist/theme/utils.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Theme Utility Functions
+ *
+ * Provides helper functions for theme management, including deep merging
+ * of theme configurations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeDeep = mergeDeep;
+/**
+ * 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
+ */
+function mergeDeep(target, source) {
+    const output = { ...target };
+    if (isObject(target) && isObject(source)) {
+        Object.keys(source).forEach((key) => {
+            const sourceValue = source[key];
+            const targetValue = target[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;
+}
+/**
+ * Check if a value is a plain object
+ */
+function isObject(item) {
+    return item && typeof item === 'object' && !Array.isArray(item);
+}

package/dist/types/api.d.ts

@@ -0,0 +1,134 @@
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: ApiError;
+    meta?: ApiMeta;
+    timestamp: string;
+    requestId: string;
+}
+export interface ApiError {
+    code: string;
+    message: string;
+    details?: Record<string, any>;
+    field?: string;
+    resolution?: string;
+    supportContact?: string;
+    remainingAttempts?: number;
+}
+export interface ApiMeta {
+    version: string;
+    responseTime: number;
+    operation?: string;
+    rateLimit?: {
+        limit: number;
+        remaining: number;
+        resetAt: string;
+    };
+    pagination?: {
+        page: number;
+        pageSize: number;
+        total: number;
+        totalPages: number;
+    };
+    cached?: boolean;
+    filters?: Record<string, any>;
+    aggregation?: Record<string, any>;
+    resourceId?: string | number;
+}
+export interface ApiRequestContext {
+    requestId: string;
+    startTime: number;
+    userAgent?: string;
+    ipAddress?: string;
+    userId?: string;
+    sessionId?: string;
+    endpoint: string;
+    method: string;
+    params?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+export interface ApiValidationError {
+    field: string;
+    message: string;
+    code: string;
+    value?: any;
+}
+export interface ApiAuthContext {
+    accessToken: string | null;
+    tokenType: string;
+    refreshToken: string | null;
+    userId?: string;
+    roles?: string[];
+    sessionId?: string;
+    expiresAt?: number;
+}
+export interface ApiHandlerConfig {
+    requireAuth?: boolean;
+    requiredRoles?: readonly string[];
+    rateLimit?: {
+        windowMs: number;
+        maxRequests: number;
+    };
+    validation?: {
+        body?: any;
+        query?: any;
+        params?: any;
+    };
+    timeout?: number;
+    retries?: number;
+    cacheTtl?: number;
+    tokenRefreshBuffer?: number;
+}
+export interface ApiMiddleware {
+    name: string;
+    execute: (context: ApiRequestContext, config: ApiHandlerConfig) => Promise<void>;
+}
+export declare enum ApiErrorCode {
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    TOKEN_EXPIRED = "TOKEN_EXPIRED",
+    INVALID_TOKEN = "INVALID_TOKEN",
+    INVALID_SESSION = "INVALID_SESSION",
+    INVALID_2FA_TOKEN = "INVALID_2FA_TOKEN",
+    INSUFFICIENT_PERMISSIONS = "INSUFFICIENT_PERMISSIONS",
+    RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
+    TOO_MANY_REQUESTS = "TOO_MANY_REQUESTS",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    MISSING_REQUIRED_FIELD = "MISSING_REQUIRED_FIELD",
+    INVALID_FORMAT = "INVALID_FORMAT",
+    RESOURCE_NOT_FOUND = "RESOURCE_NOT_FOUND",
+    NOT_FOUND = "NOT_FOUND",
+    RESOURCE_CONFLICT = "RESOURCE_CONFLICT",
+    CONFLICT = "CONFLICT",
+    BUSINESS_RULE_VIOLATION = "BUSINESS_RULE_VIOLATION",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    TIMEOUT = "TIMEOUT",
+    CIRCUIT_BREAKER_OPEN = "CIRCUIT_BREAKER_OPEN",
+    UPSTREAM_SERVICE_ERROR = "UPSTREAM_SERVICE_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    CONNECTION_ERROR = "CONNECTION_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+export declare const ApiErrorMessages: Record<ApiErrorCode, string>;
+export type ApiSuccessResponse<T> = ApiResponse<T> & {
+    success: true;
+    data: T;
+    message: string;
+    operation_code: string;
+};
+export type ApiErrorResponse = ApiResponse<never> & {
+    success: false;
+    error: ApiError;
+};
+export declare class ApiResponseBuilder {
+    private context;
+    private config;
+    constructor(context: ApiRequestContext, config?: ApiHandlerConfig);
+    success<T>(data: T, meta?: Partial<ApiMeta>): ApiSuccessResponse<T>;
+    error(code: ApiErrorCode, message?: string, details?: Record<string, any>, field?: string): ApiErrorResponse;
+    private getResolution;
+}

package/dist/types/api.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiResponseBuilder = exports.ApiErrorMessages = exports.ApiErrorCode = void 0;
+var ApiErrorCode;
+(function (ApiErrorCode) {
+    ApiErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    ApiErrorCode["FORBIDDEN"] = "FORBIDDEN";
+    ApiErrorCode["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+    ApiErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
+    ApiErrorCode["INVALID_SESSION"] = "INVALID_SESSION";
+    ApiErrorCode["INVALID_2FA_TOKEN"] = "INVALID_2FA_TOKEN";
+    ApiErrorCode["INSUFFICIENT_PERMISSIONS"] = "INSUFFICIENT_PERMISSIONS";
+    ApiErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
+    ApiErrorCode["TOO_MANY_REQUESTS"] = "TOO_MANY_REQUESTS";
+    ApiErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ApiErrorCode["INVALID_REQUEST"] = "INVALID_REQUEST";
+    ApiErrorCode["MISSING_REQUIRED_FIELD"] = "MISSING_REQUIRED_FIELD";
+    ApiErrorCode["INVALID_FORMAT"] = "INVALID_FORMAT";
+    ApiErrorCode["RESOURCE_NOT_FOUND"] = "RESOURCE_NOT_FOUND";
+    ApiErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    ApiErrorCode["RESOURCE_CONFLICT"] = "RESOURCE_CONFLICT";
+    ApiErrorCode["CONFLICT"] = "CONFLICT";
+    ApiErrorCode["BUSINESS_RULE_VIOLATION"] = "BUSINESS_RULE_VIOLATION";
+    ApiErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    ApiErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ApiErrorCode["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+    ApiErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+    ApiErrorCode["TIMEOUT"] = "TIMEOUT";
+    ApiErrorCode["CIRCUIT_BREAKER_OPEN"] = "CIRCUIT_BREAKER_OPEN";
+    ApiErrorCode["UPSTREAM_SERVICE_ERROR"] = "UPSTREAM_SERVICE_ERROR";
+    ApiErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ApiErrorCode["CONNECTION_ERROR"] = "CONNECTION_ERROR";
+    ApiErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(ApiErrorCode || (exports.ApiErrorCode = ApiErrorCode = {}));
+exports.ApiErrorMessages = { [ApiErrorCode.UNAUTHORIZED]: 'Authentication required', [ApiErrorCode.FORBIDDEN]: 'Access denied', [ApiErrorCode.TOKEN_EXPIRED]: 'Authentication token has expired', [ApiErrorCode.INVALID_TOKEN]: 'Invalid authentication token', [ApiErrorCode.INVALID_SESSION]: 'Invalid session - please log in again', [ApiErrorCode.INVALID_2FA_TOKEN]: 'Invalid or expired 2FA verification token', [ApiErrorCode.INSUFFICIENT_PERMISSIONS]: 'Insufficient permissions for this resource', [ApiErrorCode.RATE_LIMIT_EXCEEDED]: 'Rate limit exceeded', [ApiErrorCode.TOO_MANY_REQUESTS]: 'Too many requests', [ApiErrorCode.VALIDATION_ERROR]: 'Request validation failed', [ApiErrorCode.INVALID_REQUEST]: 'Invalid request format', [ApiErrorCode.MISSING_REQUIRED_FIELD]: 'Required field is missing', [ApiErrorCode.INVALID_FORMAT]: 'Invalid data format', [ApiErrorCode.RESOURCE_NOT_FOUND]: 'Resource not found', [ApiErrorCode.NOT_FOUND]: 'Not found', [ApiErrorCode.RESOURCE_CONFLICT]: 'Resource conflict', [ApiErrorCode.CONFLICT]: 'Conflict', [ApiErrorCode.BUSINESS_RULE_VIOLATION]: 'Business rule violation', [ApiErrorCode.NOT_IMPLEMENTED]: 'Feature not yet implemented', [ApiErrorCode.INTERNAL_ERROR]: 'Internal error occurred', [ApiErrorCode.INTERNAL_SERVER_ERROR]: 'Internal server error', [ApiErrorCode.SERVICE_UNAVAILABLE]: 'Service temporarily unavailable', [ApiErrorCode.TIMEOUT]: 'Request timeout', [ApiErrorCode.CIRCUIT_BREAKER_OPEN]: 'Service circuit breaker is open', [ApiErrorCode.UPSTREAM_SERVICE_ERROR]: 'Upstream service error', [ApiErrorCode.NETWORK_ERROR]: 'Network error', [ApiErrorCode.CONNECTION_ERROR]: 'Connection error', [ApiErrorCode.UNKNOWN_ERROR]: 'An unknown error occurred' };
+class ApiResponseBuilder {
+    context;
+    config;
+    constructor(context, config = {}) { this.context = context; this.config = config; }
+    success(data, meta) { return { success: true, data, message: meta?.operation ? `${meta.operation.replace(/-/g, ' ')} completed successfully` : 'Operation completed successfully', operation_code: meta?.operation || 'unknown-operation', meta: { version: '1.0', responseTime: Date.now() - this.context.startTime, ...meta }, timestamp: new Date().toISOString(), requestId: this.context.requestId }; }
+    error(code, message, details, field) { const errorMessage = message || exports.ApiErrorMessages[code]; const enhancedDetails = { ...details, ...(this.context.endpoint && { endpoint: this.context.endpoint }), ...(this.context.method && { method: this.context.method }), timestamp: new Date().toISOString() }; return { success: false, error: { code, message: errorMessage, details: enhancedDetails, field, resolution: this.getResolution(code), supportContact: process.env.SUPPORT_CONTACT }, meta: { version: '1.0', responseTime: Date.now() - this.context.startTime }, timestamp: new Date().toISOString(), requestId: this.context.requestId }; }
+    getResolution(code) { const resolutions = { [ApiErrorCode.RATE_LIMIT_EXCEEDED]: 'Please try again later', [ApiErrorCode.TOKEN_EXPIRED]: 'Please refresh your session', [ApiErrorCode.UNAUTHORIZED]: 'Please log in again', [ApiErrorCode.SERVICE_UNAVAILABLE]: 'Please try again in a few minutes', [ApiErrorCode.CIRCUIT_BREAKER_OPEN]: 'Service is temporarily unavailable. Please try again later.' }; return resolutions[code]; }
+}
+exports.ApiResponseBuilder = ApiResponseBuilder;

package/dist/types/auth.d.ts

@@ -0,0 +1,19 @@
+import { JwtPayload } from 'jwt-decode';
+export type AuthMode = 'traditional' | 'federated';
+export type FederatedProvider = 'google' | 'microsoft' | 'facebook' | 'github' | 'apple';
+export interface AuthConfig {
+    mode: AuthMode;
+    providers: FederatedProvider[];
+    enableRecovery: boolean;
+    enableEmailSignup: boolean;
+    allowPasswordReset: boolean;
+}
+export interface JwtPayloadWithRoles extends JwtPayload {
+    role?: string | string[];
+    roles?: string[];
+    amr?: string[];
+    acr?: string;
+    mfa_time?: number;
+    mfa_expires?: number;
+    mfa_validity_hours?: number;
+}

package/dist/types/auth.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/logging.d.ts

@@ -0,0 +1,42 @@
+export interface LoggingConfig {
+    logLevel: LogLevel;
+    console: {
+        enabled: boolean;
+        colors: boolean;
+    };
+    graylog: {
+        enabled: boolean;
+        host: string;
+        port: number;
+        facility: string;
+        staticMeta: {
+            service: string;
+            application: string;
+            version: string;
+            [key: string]: any;
+        };
+    };
+    components: {
+        [key: string]: {
+            enabled: boolean;
+            prefix: string;
+        };
+    };
+    levels: {
+        [key: string]: number;
+    };
+}
+export type LogLevel = 'error' | 'warn' | 'info' | 'http' | 'debug';
+export interface ComponentLoggerConfig {
+    enabled: boolean;
+    prefix: string;
+}
+export interface Logger {
+    error: (message: string, meta?: any) => void;
+    warn: (message: string, meta?: any) => void;
+    info: (message: string, meta?: any) => void;
+    http: (message: string, meta?: any) => void;
+    debug: (message: string, meta?: any) => void;
+}
+export interface ComponentLogger extends Logger {
+}

package/dist/types/logging.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/recovery.d.ts

@@ -0,0 +1,48 @@
+export type RecoveryStep = 'initiate' | 'select-method' | 'verify-code' | 'set-password' | 'complete';
+export interface RecoverySession {
+    recoveryToken: string;
+    email: string;
+    maskedEmail?: string;
+    maskedPhone?: string;
+    hasAuthenticator?: boolean;
+    availableMethods: Array<'email' | 'sms' | 'authenticator'>;
+    expiresAt: string;
+}
+export interface PasswordResetToken {
+    token: string;
+    expiresAt: string;
+}
+export interface RecoveryError {
+    code: string;
+    message: string;
+    attemptsRemaining?: number;
+}
+export interface RecoveryInitiateResponse {
+    success: boolean;
+    data: {
+        recovery_session_token?: string;
+        masked_email?: string;
+        masked_phone?: string;
+        has_authenticator?: boolean;
+        available_methods?: Array<'email' | 'sms' | 'authenticator'>;
+        expires_at?: string;
+        message?: string;
+    };
+}
+export interface SendCodeResponse {
+    success: boolean;
+    data: {
+        method: string;
+        masked_destination: string;
+        code_length: number;
+        expires_in: number;
+    };
+}
+export interface VerifyCodeResponse {
+    success: boolean;
+    data?: {
+        password_reset_token: string;
+        expires_at: string;
+    };
+    error?: RecoveryError;
+}