@qwickapps/server 1.5.2 → 1.6.1

package/dist-ui-lib/src/components/auth/shared/AuthLayout.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AuthLayout - Common layout wrapper for authentication pages
+ *
+ * Provides centered, card-style layout for auth forms
+ */
+import React from 'react';
+export interface AuthLayoutProps {
+    title: string;
+    children: React.ReactNode;
+}
+export declare function AuthLayout({ title, children }: AuthLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/src/components/auth/shared/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared auth components
+ */
+export { AuthLayout } from './AuthLayout';
+export type { AuthLayoutProps } from './AuthLayout';
+export { AuthError } from './AuthError';
+export type { AuthErrorProps } from './AuthError';

package/dist-ui-lib/{components → src/components}/index.d.ts

@@ -6,13 +6,16 @@
  * Copyright (c) 2025 QwickApps.com. All rights reserved.
  */
 export { ControlPanelApp, type ControlPanelAppProps } from './ControlPanelApp';
-export type { MenuItem } from '@qwickapps/react-framework';
+export type { MenuItem, Column, StatCardProps, DataTableProps } from '@qwickapps/react-framework';
+export { StatCard, DataTable } from '@qwickapps/react-framework';
 export { DashboardPage } from '../pages/DashboardPage';
 export { LogsPage } from '../pages/LogsPage';
 export { SystemPage } from '../pages/SystemPage';
 export { NotFoundPage } from '../pages/NotFoundPage';
 export { UsersPage, type UsersPageProps } from '../pages/UsersPage';
 export { EntitlementsPage, type EntitlementsPageProps } from '../pages/EntitlementsPage';
+export { AcceptInvitationPage, type AcceptInvitationPageProps } from '../pages/AcceptInvitationPage';
 export { DashboardWidgetProvider, useDashboardWidgets, useRegisterWidget, DashboardWidgetRenderer, type DashboardWidget, type DashboardWidgetProviderProps, WidgetComponentRegistryProvider, useWidgetComponentRegistry, PluginWidgetRenderer, getBuiltInWidgetComponents, ServiceHealthWidget, type WidgetComponent, type WidgetComponentRegistryProviderProps, } from '../dashboard';
+export { PluginManagementPage, PluginStatusWidget, PluginConfigPanel, type PluginManagementPageProps, type PluginStatusWidgetProps, type PluginConfigPanelProps, type ConfigField, type ConfigFieldType, } from './plugins';
 export { api } from '../api/controlPanelApi';
-export type { HealthCheck, HealthResponse, InfoResponse, DiagnosticsResponse, ConfigResponse, LogEntry, LogsResponse, LogSource, User, UsersResponse, Ban, BansResponse, EntitlementDefinition, EntitlementResult, EntitlementSourceInfo, EntitlementsStatus, PluginFeatures, } from '../api/controlPanelApi';
+export type { HealthCheck, HealthResponse, InfoResponse, DiagnosticsResponse, ConfigResponse, LogEntry, LogsResponse, LogSource, UserStatus, User, UsersResponse, InviteUserRequest, InvitationResponse, AcceptInvitationRequest, AcceptInvitationResponse, Ban, BansResponse, EntitlementDefinition, EntitlementResult, EntitlementSourceInfo, EntitlementsStatus, PluginFeatures, } from '../api/controlPanelApi';

package/dist-ui-lib/src/components/plugins/PluginConfigPanel.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PluginConfigPanel - Live configuration editor for plugins
+ *
+ * Provides form-based config editing with validation and real-time updates.
+ *
+ * @example
+ * ```tsx
+ * <PluginConfigPanel
+ *   title="Rate Limit Configuration"
+ *   description="Adjust rate limiting settings"
+ *   config={config}
+ *   schema={[
+ *     { key: 'maxRequests', label: 'Max Requests', type: 'number', min: 1 },
+ *     { key: 'windowMs', label: 'Window (ms)', type: 'number', min: 1000 },
+ *     { key: 'strategy', label: 'Strategy', type: 'select', options: [...] }
+ *   ]}
+ *   onSave={handleSave}
+ *   onReset={handleReset}
+ * />
+ * ```
+ */
+import React from 'react';
+export type ConfigFieldType = 'text' | 'number' | 'boolean' | 'select' | 'textarea';
+export interface ConfigField {
+    /** Config key */
+    key: string;
+    /** Display label */
+    label: string;
+    /** Field type */
+    type: ConfigFieldType;
+    /** Field description */
+    description?: string;
+    /** For number type */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** For select type */
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    /** Validation */
+    required?: boolean;
+    pattern?: RegExp;
+    validate?: (value: unknown) => string | null;
+}
+export interface PluginConfigPanelProps {
+    /** Panel title */
+    title: string;
+    /** Optional description */
+    description?: string;
+    /** Current configuration */
+    config: Record<string, unknown>;
+    /** Schema defining config fields */
+    schema: ConfigField[];
+    /** Save handler */
+    onSave: (newConfig: Record<string, unknown>) => Promise<void>;
+    /** Reset handler */
+    onReset: () => void;
+    /** Loading state */
+    loading?: boolean;
+    /** Read-only mode */
+    readOnly?: boolean;
+}
+export declare const PluginConfigPanel: React.FC<PluginConfigPanelProps>;

package/dist-ui-lib/src/components/plugins/PluginManagementPage.d.ts

@@ -0,0 +1,62 @@
+/**
+ * PluginManagementPage - Template for full plugin management pages
+ *
+ * Provides consistent layout for plugin management with search, filters, and actions.
+ *
+ * @example
+ * ```tsx
+ * <PluginManagementPage
+ *   title="User Management"
+ *   description="Manage user accounts and permissions"
+ *   icon={<UsersIcon />}
+ *   searchPlaceholder="Search users by email or name..."
+ *   onSearch={handleSearch}
+ *   actions={[
+ *     { label: 'Create User', onClick: handleCreate, variant: 'primary' }
+ *   ]}
+ * >
+ *   <DataTable columns={columns} data={users} />
+ * </PluginManagementPage>
+ * ```
+ */
+import React, { ReactNode } from 'react';
+export interface PluginManagementPageProps {
+    /** Page title */
+    title: string;
+    /** Optional description */
+    description?: string;
+    /** Optional icon */
+    icon?: ReactNode;
+    /** Search bar placeholder */
+    searchPlaceholder?: string;
+    /** Search handler */
+    onSearch?: (query: string) => void;
+    /** Page-level action buttons */
+    actions?: Array<{
+        label: string;
+        onClick: () => void;
+        variant?: 'primary' | 'secondary' | 'danger';
+        icon?: ReactNode;
+    }>;
+    /** Optional filter controls */
+    filters?: ReactNode;
+    /** Optional tabs for multi-section pages */
+    tabs?: Array<{
+        id: string;
+        label: string;
+    }>;
+    /** Active tab ID */
+    activeTab?: string;
+    /** Tab change handler */
+    onTabChange?: (tabId: string) => void;
+    /** Page content (typically DataTable) */
+    children: ReactNode;
+    /** Loading state */
+    loading?: boolean;
+    /** Breadcrumb items */
+    breadcrumbs?: Array<{
+        label: string;
+        href?: string;
+    }>;
+}
+export declare const PluginManagementPage: React.FC<PluginManagementPageProps>;

package/dist-ui-lib/src/components/plugins/PluginStatusWidget.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PluginStatusWidget - Template for plugin dashboard widgets
+ *
+ * Provides consistent layout for plugin status displays on the dashboard.
+ * Supports stats, health indicators, and quick actions.
+ *
+ * @example
+ * ```tsx
+ * <PluginStatusWidget
+ *   title="PostgreSQL"
+ *   icon={<DatabaseIcon />}
+ *   status="healthy"
+ *   stats={[
+ *     { label: 'Connections', value: 42, status: 'healthy' },
+ *     { label: 'Queries/sec', value: 1250, status: 'info' }
+ *   ]}
+ *   actions={[
+ *     { label: 'View Details', onClick: () => navigate('/postgres') }
+ *   ]}
+ * />
+ * ```
+ */
+import React from 'react';
+import { StatCardProps } from '@qwickapps/react-framework';
+export interface PluginStatusWidgetProps {
+    /** Plugin name */
+    title: string;
+    /** Optional icon */
+    icon?: React.ReactNode;
+    /** Overall plugin status */
+    status?: 'healthy' | 'warning' | 'error' | 'disabled';
+    /** Overall plugin health (alias for status, for backward compatibility) */
+    health?: 'healthy' | 'warning' | 'error' | 'disabled';
+    /** Array of stats to display */
+    stats?: StatCardProps[];
+    /** Quick action buttons */
+    actions?: Array<{
+        label: string;
+        onClick: () => void;
+        variant?: 'primary' | 'secondary' | 'danger';
+    }>;
+    /** Optional message or description */
+    message?: string;
+    /** Loading state */
+    loading?: boolean;
+    /** Error message */
+    error?: string | null;
+    /** Path to details page */
+    detailsPath?: string;
+}
+export declare const PluginStatusWidget: React.FC<PluginStatusWidgetProps>;

package/dist-ui-lib/src/components/plugins/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Server Plugin UI Components
+ *
+ * Server-specific component patterns for qwickapps-server plugin UIs.
+ *
+ * @packageDocumentation
+ */
+export { PluginStatusWidget } from './PluginStatusWidget.js';
+export type { PluginStatusWidgetProps } from './PluginStatusWidget.js';
+export { PluginManagementPage } from './PluginManagementPage.js';
+export type { PluginManagementPageProps } from './PluginManagementPage.js';
+export { PluginConfigPanel } from './PluginConfigPanel.js';
+export type { PluginConfigPanelProps, ConfigField, ConfigFieldType, } from './PluginConfigPanel.js';

package/dist-ui-lib/src/config/preferences.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Preferences Configuration
+ *
+ * Shared constants for preferences management.
+ * These constants are used by both UI and server code.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Maximum size of preferences JSON string (100KB)
+ */
+export declare const MAX_PREFERENCES_SIZE = 100000;
+/**
+ * Maximum nesting depth for preferences object
+ */
+export declare const MAX_NESTING_DEPTH = 10;

package/dist-ui-lib/src/dashboard/widgets/CMSMaintenanceWidget.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CMS Maintenance Widget
+ *
+ * Provides CMS service control and seed management for the maintenance page
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export declare function CMSMaintenanceWidget(): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/src/dashboard/widgets/CMSStatusWidget.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CMS Status Widget
+ *
+ * Displays Payload CMS service status on the dashboard
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export declare function CMSStatusWidget(): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/{dashboard → src/dashboard}/widgets/index.d.ts

@@ -7,3 +7,5 @@ export { ServiceHealthWidget } from './ServiceHealthWidget';
 export { IntegrationStatusWidget } from './IntegrationStatusWidget';
 export { AuthStatusWidget } from './AuthStatusWidget';
 export { NotificationsStatsWidget } from './NotificationsStatsWidget';
+export { CMSStatusWidget } from './CMSStatusWidget';
+export { CMSMaintenanceWidget } from './CMSMaintenanceWidget';

package/dist-ui-lib/src/hooks/useJobStream.d.ts

@@ -0,0 +1,38 @@
+/**
+ * useJobStream Hook
+ *
+ * React hook for real-time job updates via Server-Sent Events (SSE).
+ * Based on the QwickForge useRealtimeEvents pattern.
+ */
+export interface Job {
+    id: string;
+    userId: string;
+    requestId?: string;
+    jobType: 'generate_variants' | 'publish' | 'index_content' | 'sync_analytics';
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    error?: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date;
+}
+export interface JobChangeEvent {
+    type: 'insert' | 'update' | 'delete';
+    table: string;
+    record: Job;
+}
+export interface UseJobStreamOptions {
+    enabled?: boolean;
+    onError?: (error: Error) => void;
+}
+export interface UseJobStreamReturn {
+    jobs: Job[];
+    connected: boolean;
+    error: string | null;
+    reconnecting: boolean;
+    refresh: () => Promise<void>;
+}
+/**
+ * Hook for streaming real-time job updates
+ */
+export declare function useJobStream(options?: UseJobStreamOptions): UseJobStreamReturn;

package/dist-ui-lib/src/pages/AcceptInvitationPage.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AcceptInvitationPage Component
+ *
+ * Standalone page for users to accept invitations and activate their accounts.
+ * Can be used in control panel or frontend applications.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { type User } from '../api/controlPanelApi';
+export interface AcceptInvitationPageProps {
+    /** Invitation token (if not provided, will extract from URL) */
+    token?: string;
+    /** Title text */
+    title?: string;
+    /** Subtitle text */
+    subtitle?: string;
+    /** Success message */
+    successMessage?: string;
+    /** URL to redirect to after successful activation (optional) */
+    redirectUrl?: string;
+    /** Label for the redirect button */
+    redirectLabel?: string;
+    /** Callback when invitation is accepted successfully */
+    onSuccess?: (user: User) => void;
+    /** Callback when invitation acceptance fails */
+    onError?: (error: string) => void;
+}
+export declare function AcceptInvitationPage({ token: tokenProp, title, subtitle, successMessage, redirectUrl, redirectLabel, onSuccess, onError, }: AcceptInvitationPageProps): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/src/pages/PreferencesPage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PreferencesPage Component
+ *
+ * User preferences management page with JSON editor.
+ * Preferences are stored as flexible JSON objects per user.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export declare function PreferencesPage(): import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@qwickapps/server",
-  "version": "1.5.2",
+  "version": "1.6.1",
   "description": "Plugin-based application server framework for building websites, APIs, admin dashboards, and full-stack products",
-  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -15,7 +14,7 @@
       "import": "./dist/plugins/index.js"
     },
     "./ui": {
-      "types": "./dist-ui-lib/components/index.d.ts",
+      "types": "./dist-ui-lib/src/components/index.d.ts",
       "import": "./dist-ui-lib/index.js"
     }
   },
@@ -28,7 +27,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "npm run build:server && npm run build:ui && npm run build:ui-lib",
+    "build": "npm run build:ui-lib && npm run build:server && npm run build:ui",
     "build:server": "tsc",
     "build:ui": "cd ui && vite build",
     "build:ui-lib": "cd ui && vite build --config vite.lib.config.ts && tsc -p tsconfig.lib.json",
@@ -54,15 +53,21 @@
     "cors": "^2.8.5",
     "express": "^4.18.2",
     "helmet": "^7.1.0",
-    "http-proxy-middleware": "^3.0.3"
+    "http-proxy-middleware": "^3.0.3",
+    "zod": "^3.22.4"
   },
   "devDependencies": {
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.0",
     "@mui/icons-material": "^7.2.0",
     "@mui/material": "^7.2.0",
+    "@mui/x-data-grid": "^7.29.12",
     "@playwright/test": "^1.57.0",
+    "@qwickapps/auth-client": "^1.0.0",
     "@qwickapps/react-framework": "^1.5.5",
+    "@testing-library/jest-dom": "^6.0.0",
+    "@testing-library/react": "^14.0.0",
+    "@testing-library/user-event": "^14.0.0",
     "@types/compression": "^1.7.5",
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
@@ -71,8 +76,10 @@
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "@vitejs/plugin-react": "^4.3.4",
+    "@vitest/ui": "^2.1.0",
     "express-openid-connect": "^2.19.3",
     "ioredis": "^5.4.0",
+    "jsdom": "^25.0.0",
     "pg": "^8.13.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",