@qwickapps/server 1.3.0 → 1.4.0

package/dist-ui-lib/pages/AuthPage.d.ts

@@ -0,0 +1 @@
+export declare function AuthPage(): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/pages/IntegrationsPage.d.ts

@@ -0,0 +1 @@
+export declare function IntegrationsPage(): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/pages/PluginsPage.d.ts

@@ -0,0 +1 @@
+export declare function PluginsPage(): import("react/jsx-runtime").JSX.Element;

package/dist-ui-lib/pages/RateLimitPage.d.ts

@@ -0,0 +1 @@
+export declare function RateLimitPage(): import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwickapps/server",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Plugin-based application server framework for building websites, APIs, admin dashboards, and full-stack products",
   "type": "module",
   "main": "dist/index.js",
@@ -76,6 +76,7 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-router-dom": "^6.30.1",
+    "supertokens-node": "^20.1.7",
     "tsx": "^4.20.6",
     "typescript": "^5.3.3",
     "vite": "^6.0.0",
@@ -85,7 +86,8 @@
     "@qwickapps/react-framework": ">=1.0.0",
     "express-openid-connect": ">=2.0.0",
     "ioredis": ">=5.0.0",
-    "pg": ">=8.0.0"
+    "pg": ">=8.0.0",
+    "supertokens-node": ">=20.0.0"
   },
   "peerDependenciesMeta": {
     "@qwickapps/react-framework": {
@@ -99,6 +101,9 @@
     },
     "pg": {
       "optional": true
+    },
+    "supertokens-node": {
+      "optional": true
     }
   },
   "keywords": [

package/src/core/control-panel.ts

@@ -197,11 +197,42 @@ export function createControlPanel(options: CreateControlPanelOptions): ControlP
   });
 
   /**
-   * GET /api/plugins - List all registered plugins
+   * GET /api/plugins - List all registered plugins with contribution counts
    */
   router.get('/plugins', (_req: Request, res: Response) => {
+    const plugins = pluginRegistry.listPlugins().map((plugin) => {
+      const contributions = pluginRegistry.getPluginContributions(plugin.id);
+      return {
+        ...plugin,
+        contributionCounts: {
+          routes: contributions.routes.length,
+          menuItems: contributions.menuItems.length,
+          pages: contributions.pages.length,
+          widgets: contributions.widgets.length,
+          hasConfig: !!contributions.config,
+        },
+      };
+    });
+    res.json({ plugins });
+  });
+
+  /**
+   * GET /api/plugins/:id - Get detailed plugin info with contributions
+   */
+  router.get('/plugins/:id', (req: Request, res: Response) => {
+    const { id } = req.params;
+    const plugins = pluginRegistry.listPlugins();
+    const plugin = plugins.find((p) => p.id === id);
+
+    if (!plugin) {
+      res.status(404).json({ error: `Plugin not found: ${id}` });
+      return;
+    }
+
+    const contributions = pluginRegistry.getPluginContributions(id);
     res.json({
-      plugins: pluginRegistry.listPlugins(),
+      ...plugin,
+      contributions,
     });
   });
 
@@ -289,6 +320,22 @@ export function createControlPanel(options: CreateControlPanelOptions): ControlP
     }
   }
 
+  // Serve landing page at root (/) when control panel is mounted elsewhere
+  if (mountPath !== '/' && config.landingPage !== false) {
+    const landingConfig = config.landingPage || {};
+    app.get('/', (_req: Request, res: Response) => {
+      const html = generateLandingPageHtml({
+        productName: config.productName,
+        title: landingConfig.title || config.productName,
+        heading: landingConfig.heading || `Welcome to ${config.productName}`,
+        description: landingConfig.description || `${config.productName} is running.`,
+        controlPanelPath: mountPath,
+        links: landingConfig.links,
+      });
+      res.type('html').send(html);
+    });
+  }
+
   // Start a plugin with the registry
   const startPlugin = async (plugin: Plugin, pluginConfig: PluginConfig = {}): Promise<boolean> => {
     return pluginRegistry.startPlugin(plugin, pluginConfig);
@@ -533,3 +580,115 @@ function generateDashboardHtml(
 </body>
 </html>`;
 }
+
+/**
+ * Generate landing page HTML for root path
+ */
+function generateLandingPageHtml(options: {
+  productName: string;
+  title: string;
+  heading: string;
+  description: string;
+  controlPanelPath: string;
+  links?: Array<{ label: string; url: string }>;
+}): string {
+  const { productName, title, heading, description, controlPanelPath, links = [] } = options;
+
+  const linksHtml = [
+    { label: 'Control Panel', url: controlPanelPath },
+    ...links,
+  ]
+    .map(
+      (link) =>
+        `<a href="${link.url}" class="link">${link.label}</a>`
+    )
+    .join('');
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: linear-gradient(135deg, #0f172a 0%, #1e1b4b 100%);
+      color: #e2e8f0;
+      min-height: 100vh;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .container {
+      text-align: center;
+      max-width: 600px;
+      padding: 2rem;
+    }
+    .logo {
+      width: 80px;
+      height: 80px;
+      background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%);
+      border-radius: 20px;
+      margin: 0 auto 2rem;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-size: 2rem;
+      font-weight: bold;
+    }
+    h1 {
+      font-size: 2.5rem;
+      margin-bottom: 1rem;
+      background: linear-gradient(135deg, #6366f1 0%, #a78bfa 100%);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      background-clip: text;
+    }
+    p {
+      color: #94a3b8;
+      font-size: 1.125rem;
+      margin-bottom: 2rem;
+      line-height: 1.6;
+    }
+    .links {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 1rem;
+      justify-content: center;
+    }
+    .link {
+      display: inline-block;
+      padding: 0.875rem 2rem;
+      background: linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%);
+      color: white;
+      text-decoration: none;
+      border-radius: 0.75rem;
+      font-weight: 600;
+      transition: transform 0.2s, box-shadow 0.2s;
+    }
+    .link:hover {
+      transform: translateY(-2px);
+      box-shadow: 0 10px 25px -5px rgba(99, 102, 241, 0.4);
+    }
+    .footer {
+      margin-top: 3rem;
+      color: #475569;
+      font-size: 0.875rem;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="logo">${productName.charAt(0)}</div>
+    <h1>${heading}</h1>
+    <p>${description}</p>
+    <div class="links">${linksHtml}</div>
+    <div class="footer">
+      Powered by QwickApps Server
+    </div>
+  </div>
+</body>
+</html>`;
+}

package/src/core/plugin-registry.ts

@@ -164,6 +164,31 @@ export interface RouteDefinition {
   pluginId: string;
 }
 
+/**
+ * Configuration UI contribution for plugin settings
+ */
+export interface ConfigContribution {
+  /** Unique ID for this config contribution */
+  id: string;
+  /** React component name to render (matched by frontend registry) */
+  component: string;
+  /** Display title for the config section */
+  title?: string;
+  /** Plugin ID that contributed this */
+  pluginId: string;
+}
+
+/**
+ * Aggregated contributions for a specific plugin
+ */
+export interface PluginContributions {
+  routes: Array<{ method: string; path: string }>;
+  menuItems: MenuContribution[];
+  pages: PageContribution[];
+  widgets: WidgetContribution[];
+  config?: ConfigContribution;
+}
+
 // =============================================================================
 // Plugin Registry Interface
 // =============================================================================
@@ -204,6 +229,9 @@ export interface PluginRegistry {
   /** Register a widget */
   addWidget(widget: WidgetContribution): void;
 
+  /** Register a config component for plugin settings UI */
+  addConfigComponent(config: ConfigContribution): void;
+
   // ---------------------------------------------------------------------------
   // Contribution queries
   // ---------------------------------------------------------------------------
@@ -220,6 +248,12 @@ export interface PluginRegistry {
   /** Get all widgets */
   getWidgets(): WidgetContribution[];
 
+  /** Get all config components */
+  getConfigComponents(): ConfigContribution[];
+
+  /** Get all contributions for a specific plugin */
+  getPluginContributions(pluginId: string): PluginContributions;
+
   // ---------------------------------------------------------------------------
   // Configuration
   // ---------------------------------------------------------------------------
@@ -292,6 +326,7 @@ export class PluginRegistryImpl implements PluginRegistry {
   private menuItems: MenuContribution[] = [];
   private pages: PageContribution[] = [];
   private widgets: WidgetContribution[] = [];
+  private configComponents: ConfigContribution[] = [];
 
   private eventHandlers = new Set<PluginEventHandler>();
 
@@ -385,6 +420,17 @@ export class PluginRegistryImpl implements PluginRegistry {
     this.logger.debug(`Widget registered: ${widget.title} by ${widget.pluginId}`);
   }
 
+  addConfigComponent(config: ConfigContribution): void {
+    // Only one config component per plugin - warn if replacing
+    const existing = this.configComponents.find((c) => c.pluginId === config.pluginId);
+    if (existing) {
+      this.logger.warn(`Replacing config component for plugin ${config.pluginId}: ${existing.component} → ${config.component}`);
+    }
+    this.configComponents = this.configComponents.filter((c) => c.pluginId !== config.pluginId);
+    this.configComponents.push(config);
+    this.logger.debug(`Config component registered: ${config.component} by ${config.pluginId}`);
+  }
+
   // ---------------------------------------------------------------------------
   // Contribution queries
   // ---------------------------------------------------------------------------
@@ -405,6 +451,22 @@ export class PluginRegistryImpl implements PluginRegistry {
     return [...this.widgets];
   }
 
+  getConfigComponents(): ConfigContribution[] {
+    return [...this.configComponents];
+  }
+
+  getPluginContributions(pluginId: string): PluginContributions {
+    return {
+      routes: this.routes
+        .filter((r) => r.pluginId === pluginId)
+        .map((r) => ({ method: r.method, path: r.path })),
+      menuItems: this.menuItems.filter((m) => m.pluginId === pluginId),
+      pages: this.pages.filter((p) => p.pluginId === pluginId),
+      widgets: this.widgets.filter((w) => w.pluginId === pluginId),
+      config: this.configComponents.find((c) => c.pluginId === pluginId),
+    };
+  }
+
   // ---------------------------------------------------------------------------
   // Configuration
   // ---------------------------------------------------------------------------
@@ -577,6 +639,7 @@ export class PluginRegistryImpl implements PluginRegistry {
       this.menuItems = this.menuItems.filter((m) => m.pluginId !== pluginId);
       this.pages = this.pages.filter((p) => p.pluginId !== pluginId);
       this.widgets = this.widgets.filter((w) => w.pluginId !== pluginId);
+      this.configComponents = this.configComponents.filter((c) => c.pluginId !== pluginId);
 
       this.emit({
         type: 'plugin:stopped',

package/src/core/types.ts

@@ -175,6 +175,23 @@ export interface ControlPanelConfig {
 
   /** Optional: Custom path to a dist-ui folder for serving a custom React UI */
   customUiPath?: string;
+
+  /**
+   * Optional: Landing page configuration for root path (/).
+   * Only used when mountPath is not '/'.
+   * If not provided, a default landing page is generated.
+   * Set to false to disable the landing page.
+   */
+  landingPage?: {
+    /** Page title */
+    title?: string;
+    /** Main heading */
+    heading?: string;
+    /** Description text */
+    description?: string;
+    /** Additional links */
+    links?: Array<{ label: string; url: string }>;
+  } | false;
 }
 
 // Plugin types are now in plugin-registry.ts

package/src/index.ts

@@ -89,6 +89,10 @@ export {
   hasCache,
   // Auth plugin
   createAuthPlugin,
+  createAuthPluginFromEnv,
+  getAuthStatus,
+  setAuthConfigStore,
+  postgresAuthConfigStore,
   isAuthenticated,
   getAuthenticatedUser,
   getAccessToken,
@@ -98,6 +102,7 @@ export {
   auth0Adapter,
   basicAdapter,
   supabaseAdapter,
+  supertokensAdapter,
   isAuthenticatedRequest,
   // Users plugin
   createUsersPlugin,
@@ -137,6 +142,28 @@ export {
   requireAnyEntitlement,
   requireAllEntitlements,
   postgresEntitlementSource,
+  // Rate Limit plugin
+  createRateLimitPlugin,
+  createRateLimitPluginFromEnv,
+  getRateLimitConfigStatus,
+  postgresRateLimitStore,
+  createRateLimitCache,
+  createNoOpCache,
+  createSlidingWindowStrategy,
+  createFixedWindowStrategy,
+  createTokenBucketStrategy,
+  getStrategy,
+  rateLimitMiddleware,
+  rateLimitStatusMiddleware,
+  RateLimitService,
+  getRateLimitService,
+  isLimited,
+  checkLimit,
+  incrementLimit,
+  getRemainingRequests,
+  getLimitStatus,
+  clearLimit,
+  createCleanupJob,
 } from './plugins/index.js';
 export type {
   HealthPluginConfig,
@@ -159,6 +186,12 @@ export type {
   Auth0AdapterConfig,
   SupabaseAdapterConfig,
   BasicAdapterConfig,
+  SupertokensAdapterConfig,
+  AuthPluginState,
+  AuthEnvPluginOptions,
+  AuthConfigStatus,
+  AuthConfigStore,
+  PostgresAuthConfigStoreConfig,
   // Users plugin types
   UsersPluginConfig,
   UserStore,
@@ -191,4 +224,16 @@ export type {
   UserEntitlement,
   CachedEntitlements,
   EntitlementStats,
+  // Rate Limit plugin types
+  RateLimitPluginConfig,
+  RateLimitEnvPluginOptions,
+  RateLimitStrategy,
+  LimitStatus,
+  StoredLimit,
+  IncrementOptions,
+  RateLimitStore,
+  PostgresRateLimitStoreConfig,
+  RateLimitCache,
+  RateLimitCacheConfig,
+  RateLimitMiddlewareOptions,
 } from './plugins/index.js';