create-bw-app 0.12.0 → 0.13.0

package/template/base/components/app-shell-preview.tsx

@@ -1,185 +0,0 @@
-"use client";
-
-import { useMemo, useState } from "react";
-import {
-  AccountMenu,
-  AppHeader,
-  DesktopSidebar,
-  MobileNav,
-  computeInitials,
-  getShellNavGroup,
-  type NavGroupConfig,
-  type ResolvedClientAppShellConfig,
-} from "@brightweblabs/app-shell";
-import { LayoutTemplate, Sparkles, Users } from "lucide-react";
-import { starterBrandConfig } from "../config/brand";
-import { getStarterShellConfig } from "../config/shell";
-
-const mockUser = {
-  email: "admin@starter-client.test",
-  user_metadata: {
-    first_name: "Starter",
-    last_name: "Admin",
-  },
-};
-
-const mockSurfaceCards = [
-  {
-    title: "Module activation",
-    description: "Nav, admin access, and tools placement are resolved from the starter client config.",
-    icon: LayoutTemplate,
-  },
-  {
-    title: "Shared updates",
-    description: "The shell primitives come from `@brightweblabs/app-shell`, so new clients keep the same integration contract.",
-    icon: Sparkles,
-  },
-  {
-    title: "User governance",
-    description: "Admin placement stays visible because the preview assumes an admin/staff viewer.",
-    icon: Users,
-  },
-];
-
-export function AppShellPreview() {
-  const { shellPreview: config } = getStarterShellConfig() as { shellPreview: ResolvedClientAppShellConfig };
-  const [isSidebarCollapsed, setIsSidebarCollapsed] = useState(false);
-  const [toolsExpanded, setToolsExpanded] = useState(true);
-  const [crmExpanded, setCrmExpanded] = useState(true);
-  const [activeHref, setActiveHref] = useState(config.primaryNav[0]?.href ?? "/dashboard");
-
-  const crmNavGroup = useMemo(
-    () =>
-      getShellNavGroup(config, "crm")
-      ?? ({
-        label: "CRM",
-        icon: Users,
-        children: [{ href: "/crm", label: "CRM", icon: Users }],
-      } satisfies NavGroupConfig),
-    [config],
-  );
-  const collapsedToolsHref = config.toolsSection.items[0]?.href ?? "/";
-  const displayName = "Starter Admin";
-  const userInitials = computeInitials(displayName);
-  const isNavItemActive = (href: string) => activeHref === href;
-  const isToolLinkActive = (href: string) => activeHref === href;
-  const isCrmChildActive = (href: string) => activeHref === href;
-  const isCrmGroupActive = crmNavGroup.children.some((item) => activeHref === item.href);
-  const isToolActive = config.toolsSection.items.some((item) => activeHref === item.href);
-
-  return (
-    <div className="app-preview-shell">
-      <DesktopSidebar
-        className="app-preview-sidebar"
-        brand={config.brand}
-        collapsedToolsHref={collapsedToolsHref}
-        isSidebarCollapsed={isSidebarCollapsed}
-        isToolActive={isToolActive}
-        toolsExpanded={toolsExpanded}
-        visiblePrimaryNav={config.primaryNav}
-        adminNavItem={config.adminNavItem}
-        visibleToolNav={config.toolsSection.items}
-        crmNavGroup={crmNavGroup}
-        crmGroupExpanded={crmExpanded}
-        isCrmGroupActive={isCrmGroupActive}
-        isNavItemActive={isNavItemActive}
-        isToolLinkActive={isToolLinkActive}
-        isCrmChildActive={isCrmChildActive}
-        onToggleSidebar={() => setIsSidebarCollapsed((current) => !current)}
-        onToggleTools={() => setToolsExpanded((current) => !current)}
-        onToggleCrmGroup={() => setCrmExpanded((current) => !current)}
-      />
-
-      <div className="app-preview-main">
-        <AppHeader className="app-preview-header">
-          <div className="app-preview-header-copy">
-            <span className="eyebrow">{starterBrandConfig.companyName}</span>
-            <h1>Logged-in shell preview</h1>
-            <p className="muted">This is the packaged shell running with the starter client registration.</p>
-          </div>
-          <div className="app-preview-header-actions">
-            <div className="status ok">Admin preview</div>
-            <AccountMenu
-              displayName={displayName}
-              isStaff
-              onSignOut={async () => {}}
-              user={mockUser}
-              userInitials={userInitials}
-            />
-          </div>
-        </AppHeader>
-
-        <div className="app-preview-mobile-nav">
-          <MobileNav
-            className="panel"
-            toolsExpanded={toolsExpanded}
-            visiblePrimaryNav={config.primaryNav}
-            visibleToolNav={config.toolsSection.items}
-            isNavItemActive={isNavItemActive}
-            isToolLinkActive={isToolLinkActive}
-            onToggleTools={() => setToolsExpanded((current) => !current)}
-          />
-        </div>
-
-        <section className="app-preview-content">
-          <div className="app-preview-stage">
-            <div className="grid">
-              {mockSurfaceCards.map((card) => (
-                <article key={card.title} className="panel preview-glass-card">
-                  <div className="panel-inner">
-                    <div className="preview-card-icon">
-                      <card.icon className="size-4" />
-                    </div>
-                    <h2>{card.title}</h2>
-                    <p className="muted">{card.description}</p>
-                  </div>
-                </article>
-              ))}
-            </div>
-
-            <article className="panel preview-stage-panel">
-              <div className="panel-inner">
-                <div className="preview-stage-head">
-                  <div>
-                    <span className="eyebrow">Active path</span>
-                    <h2>{activeHref}</h2>
-                  </div>
-                  <div className="actions">
-                    {[...config.primaryNav, ...crmNavGroup.children, ...(config.adminNavItem ? [config.adminNavItem] : []), ...config.toolsSection.items].map((item) => (
-                      <button
-                        key={item.href}
-                        type="button"
-                        className={`nav-chip ${activeHref === item.href ? "active" : ""}`}
-                        onClick={() => setActiveHref(item.href)}
-                      >
-                        {item.label}
-                      </button>
-                    ))}
-                  </div>
-                </div>
-
-                <div className="preview-surface-grid">
-                  <div className="preview-surface-card">
-                    <p className="preview-label">Primary navigation</p>
-                    <strong>{config.primaryNav.length} item(s)</strong>
-                    <span>{config.primaryNav.map((item) => item.label).join(" · ")}</span>
-                  </div>
-                  <div className="preview-surface-card">
-                    <p className="preview-label">CRM group</p>
-                    <strong>{crmNavGroup.children.length} item(s)</strong>
-                    <span>{crmNavGroup.children.map((item) => item.label).join(" · ")}</span>
-                  </div>
-                  <div className="preview-surface-card">
-                    <p className="preview-label">Tools section</p>
-                    <strong>{config.toolsSection.items.length} item(s)</strong>
-                    <span>{config.toolsSection.items.map((item) => item.label).join(" · ") || "No tools enabled"}</span>
-                  </div>
-                </div>
-              </div>
-            </article>
-          </div>
-        </section>
-      </div>
-    </div>
-  );
-}

package/template/base/components/auth-playground.tsx

@@ -1,112 +0,0 @@
-"use client";
-
-import { useMemo, useState } from "react";
-import {
-  AUTH_RESEND_COOLDOWN_SECONDS,
-  buildResetPasswordRedirectUrl,
-  buildSignupCallbackUrl,
-  validateEmail,
-  validatePassword,
-} from "@brightweblabs/core-auth/shared";
-import { useCooldownTimer } from "@brightweblabs/core-auth/client";
-
-export function AuthPlayground() {
-  const [email, setEmail] = useState("hello@brightweblabs.pt");
-  const [password, setPassword] = useState("Brightweb2026");
-  const passwordResult = useMemo(() => validatePassword(password), [password]);
-  const emailIsValid = useMemo(() => validateEmail(email), [email]);
-  const cooldown = useCooldownTimer(AUTH_RESEND_COOLDOWN_SECONDS);
-  const authUrls = useMemo(() => {
-    try {
-      return {
-        signupCallbackUrl: buildSignupCallbackUrl(),
-        resetPasswordUrl: buildResetPasswordRedirectUrl(),
-        error: null,
-      };
-    } catch (error) {
-      return {
-        signupCallbackUrl: null,
-        resetPasswordUrl: null,
-        error: error instanceof Error ? error.message : "Unknown error",
-      };
-    }
-  }, []);
-
-  return (
-    <>
-      <article className="panel">
-        <div className="panel-inner">
-          <p className="eyebrow">Core Auth</p>
-          <h1>Auth package playground</h1>
-          <p className="muted">
-            This page exercises the external `@brightweblabs/core-auth` shared and client entrypoints directly.
-          </p>
-        </div>
-      </article>
-
-      <article className="panel">
-        <div className="panel-inner form-grid">
-          <div className="field">
-            <label htmlFor="email">Email validator</label>
-            <input id="email" value={email} onChange={(event) => setEmail(event.target.value)} />
-          </div>
-
-          <p className={`status ${emailIsValid ? "ok" : "error"}`}>
-            {emailIsValid ? "Valid email" : "Invalid email"}
-          </p>
-
-          <div className="field">
-            <label htmlFor="password">Password validator</label>
-            <input id="password" value={password} onChange={(event) => setPassword(event.target.value)} />
-          </div>
-
-          <div className="result-box">
-            <strong>{passwordResult.isValid ? "Password accepted" : "Password rejected"}</strong>
-            <ul>
-              {passwordResult.errors.length === 0 ? <li>No validation errors.</li> : null}
-              {passwordResult.errors.map((error) => <li key={error}>{error}</li>)}
-            </ul>
-          </div>
-        </div>
-      </article>
-
-      <article className="panel">
-        <div className="panel-inner stack">
-          <div>
-            <h2>Derived URLs</h2>
-            <p className="muted">These values come from the auth package and depend on `NEXT_PUBLIC_APP_URL`.</p>
-          </div>
-          <div className="code-box">
-            {authUrls.error ? (
-              <div>
-                <strong>Configuration required:</strong> {authUrls.error}
-              </div>
-            ) : (
-              <>
-                <div><strong>Signup callback:</strong> {authUrls.signupCallbackUrl}</div>
-                <div><strong>Reset password:</strong> {authUrls.resetPasswordUrl}</div>
-              </>
-            )}
-          </div>
-        </div>
-      </article>
-
-      <article className="panel">
-        <div className="panel-inner stack">
-          <div>
-            <h2>Cooldown hook</h2>
-            <p className="muted">Useful for resend-email and rate-limited auth actions.</p>
-          </div>
-          <div className="actions">
-            <button className="action" onClick={() => cooldown.start()} disabled={cooldown.isCoolingDown}>
-              {cooldown.isCoolingDown ? `Cooling down: ${cooldown.remaining}s` : "Start cooldown"}
-            </button>
-            <button className="action secondary" onClick={() => cooldown.reset()}>
-              Reset
-            </button>
-          </div>
-        </div>
-      </article>
-    </>
-  );
-}

package/template/base/config/bootstrap.ts

@@ -1,131 +0,0 @@
-import { getStarterClientConfig } from "./client";
-
-export type StarterChecklistItem = {
-  label: string;
-  done: boolean;
-  detail?: string;
-};
-
-export type StarterChecklistSection = {
-  key: string;
-  title: string;
-  items: StarterChecklistItem[];
-};
-
-function hasModule(moduleKeys: string[], key: string) {
-  return moduleKeys.includes(key);
-}
-
-export function getStarterBootstrapChecklist() {
-  const config = getStarterClientConfig();
-  const moduleKeys = config.enabledModules.map((moduleConfig) => moduleConfig.key);
-
-  const identitySection: StarterChecklistSection = {
-    key: "identity",
-    title: "Client identity",
-    items: [
-      {
-        label: "Define company and product name",
-        done: config.brand.companyName !== "Starter Client" && config.brand.productName !== "Operations Platform",
-        detail: `${config.brand.companyName} / ${config.brand.productName}`,
-      },
-      {
-        label: "Set client slug",
-        done: config.brand.slug !== "starter-client",
-        detail: config.brand.slug,
-      },
-      {
-        label: "Set client contact and support inboxes",
-        done: config.brand.contactEmail !== "hello@example.com" && config.brand.supportEmail !== "support@example.com",
-        detail: `${config.brand.contactEmail} · ${config.brand.supportEmail}`,
-      },
-    ],
-  };
-
-  const envSection: StarterChecklistSection = {
-    key: "environment",
-    title: "Environment and infrastructure",
-    items: config.envStatus.map((item) => ({
-      label: `Configure ${item.key}`,
-      done: item.present,
-      detail: `${item.scope} · ${item.requiredFor.join(", ")}`,
-    })),
-  };
-
-  const dataSection: StarterChecklistSection = {
-    key: "services",
-    title: "Client services",
-    items: [
-      {
-        label: "Provision dedicated Supabase project",
-        done: config.envStatus.filter((item) => item.key.includes("SUPABASE")).every((item) => item.present),
-        detail: "Database, auth, storage, and RPC functions should be client-specific.",
-      },
-      {
-        label: "Configure Resend for the client sender domain",
-        done: [
-          "RESEND_API_KEY",
-          "RESEND_FROM_TRANSACTIONAL",
-          "RESEND_FROM_MARKETING",
-          "CONTACT_TO_EMAIL",
-          "RESEND_WEBHOOK_SECRET",
-        ].every((key) => Boolean(config.envStatus.find((item) => item.key === key)?.present)),
-        detail: "Use client-owned sender identities and configure webhook signature verification.",
-      },
-      {
-        label: "Create per-client environment variables",
-        done: config.envReadiness.allReady,
-        detail: "Fill `.env.local` with the real service values for this client.",
-      },
-    ],
-  };
-
-  const modulesSection: StarterChecklistSection = {
-    key: "modules",
-    title: "Enabled modules",
-    items: config.enabledModules.map((moduleConfig) => ({
-      label: `Validate ${moduleConfig.label}`,
-      done: Boolean(moduleConfig.playgroundHref),
-      detail: moduleConfig.playgroundHref
-        ? `Preview at ${moduleConfig.playgroundHref}`
-        : `Package ${moduleConfig.packageName}`,
-    })),
-  };
-
-  const rolloutSection: StarterChecklistSection = {
-    key: "rollout",
-    title: "Launch readiness",
-    items: [
-      {
-        label: "Preview Auth flows",
-        done: true,
-        detail: "/playground/auth",
-      },
-      {
-        label: "Preview CRM module",
-        done: hasModule(moduleKeys, "crm"),
-        detail: hasModule(moduleKeys, "crm") ? "/crm" : "CRM not enabled",
-      },
-      {
-        label: "Preview Projects module",
-        done: hasModule(moduleKeys, "projects"),
-        detail: hasModule(moduleKeys, "projects") ? "/playground/projects" : "Projects not enabled",
-      },
-      {
-        label: "Preview Admin module",
-        done: hasModule(moduleKeys, "admin"),
-        detail: hasModule(moduleKeys, "admin") ? "/playground/admin" : "Admin not enabled",
-      },
-      {
-        label: "Deploy only after env readiness is green",
-        done: config.envReadiness.allReady,
-        detail: config.envReadiness.allReady ? "Ready for deploy validation." : `${config.envReadiness.missing.length} env key(s) still missing.`,
-      },
-    ],
-  };
-
-  return {
-    client: config,
-    sections: [identitySection, envSection, dataSection, modulesSection, rolloutSection],
-  };
-}

package/template/base/config/client.ts

@@ -1,18 +0,0 @@
-import { starterBrandConfig } from "./brand";
-import { getStarterEnvStatus, isStarterEnvReady } from "./env";
-import { getStarterShellConfig } from "./shell";
-
-export function getStarterClientConfig() {
-  const shell = getStarterShellConfig();
-  const enabledModules = shell.enabledModules;
-  const moduleKeys = enabledModules.map((moduleConfig) => moduleConfig.key);
-
-  return {
-    brand: starterBrandConfig,
-    enabledModules,
-    envStatus: getStarterEnvStatus(),
-    envReadiness: isStarterEnvReady(moduleKeys),
-    shellPreview: shell.shellPreview,
-    toolbarRoutes: shell.toolbarRoutes,
-  };
-}

package/template/base/config/env.ts

@@ -1,100 +0,0 @@
-export type StarterEnvScope = "public" | "server";
-
-export type StarterEnvRequirement = {
-  key: string;
-  scope: StarterEnvScope;
-  description: string;
-  requiredFor: string[];
-};
-
-export type StarterEnvStatus = StarterEnvRequirement & {
-  present: boolean;
-};
-
-export const starterEnvRequirements: StarterEnvRequirement[] = [
-  {
-    key: "NEXT_PUBLIC_APP_URL",
-    scope: "public",
-    description: "Canonical base URL used by auth callbacks and platform links.",
-    requiredFor: ["core-auth"],
-  },
-  {
-    key: "NEXT_PUBLIC_SUPABASE_URL",
-    scope: "public",
-    description: "Supabase project URL for client-side and server-side API access.",
-    requiredFor: ["crm", "projects", "admin"],
-  },
-  {
-    key: "NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY",
-    scope: "public",
-    description: "Supabase publishable key for browser auth and RPC calls.",
-    requiredFor: ["crm", "projects", "admin"],
-  },
-  {
-    key: "SUPABASE_SECRET_DEFAULT_KEY",
-    scope: "server",
-    description: "Supabase secret key for privileged admin, CRM, and project actions.",
-    requiredFor: ["crm", "projects", "admin"],
-  },
-  {
-    key: "RESEND_API_KEY",
-    scope: "server",
-    description: "Email delivery key for app-owned transactional and marketing server flows.",
-    requiredFor: ["admin"],
-  },
-  {
-    key: "RESEND_FROM_TRANSACTIONAL",
-    scope: "server",
-    description: "Default transactional sender used by app-owned invite/contact email flows.",
-    requiredFor: ["admin"],
-  },
-  {
-    key: "RESEND_FROM_MARKETING",
-    scope: "server",
-    description: "Default marketing sender used by campaign and workflow email flows.",
-    requiredFor: ["admin"],
-  },
-  {
-    key: "CONTACT_TO_EMAIL",
-    scope: "server",
-    description: "Destination inbox for app-owned contact notifications.",
-    requiredFor: ["admin"],
-  },
-  {
-    key: "RESEND_WEBHOOK_SECRET",
-    scope: "server",
-    description: "Webhook signing secret used to verify inbound Resend event payloads.",
-    requiredFor: ["admin"],
-  },
-  {
-    key: "MARKETING_WORKER_SECRET",
-    scope: "server",
-    description: "Shared secret required to trigger internal marketing worker endpoints.",
-    requiredFor: ["admin"],
-  },
-  {
-    key: "MARKETING_TEST_EMAIL",
-    scope: "server",
-    description: "Inbox used by admin marketing test send actions.",
-    requiredFor: ["admin"],
-  },
-];
-
-export function getStarterEnvStatus() {
-  return starterEnvRequirements.map(
-    (requirement) =>
-      ({
-        ...requirement,
-        present: typeof process.env[requirement.key] === "string" && process.env[requirement.key]!.trim().length > 0,
-      }) satisfies StarterEnvStatus,
-  );
-}
-
-export function isStarterEnvReady(requiredModules: string[]) {
-  const relevant = getStarterEnvStatus().filter((item) => item.requiredFor.some((moduleKey) => requiredModules.includes(moduleKey)));
-  return {
-    allReady: relevant.every((item) => item.present),
-    items: relevant,
-    missing: relevant.filter((item) => !item.present),
-  };
-}

package/template/base/lib/email/resend-base.ts

@@ -1,13 +0,0 @@
-import "server-only";
-
-export {
-  getContactDestination,
-  getMarketingSender,
-  getResendApiKey,
-  getResendWebhookSecret,
-  getTransactionalSender,
-  resendApiRequest,
-  verifyResendWebhookSignature,
-  ResendApiError,
-  ResendConfigError,
-} from "@brightweblabs/infra/server";

package/template/modules/admin/app/playground/admin/page.tsx

@@ -1,102 +0,0 @@
-export const dynamic = "force-dynamic";
-
-function formatError(error: unknown) {
-  if (error instanceof Error) {
-    return error.message;
-  }
-
-  return "Unknown error";
-}
-
-export default async function AdminPlaygroundPage() {
-  try {
-    const { getAdminUsersPageData } = await import("@brightweblabs/module-admin");
-    const { users } = await getAdminUsersPageData();
-
-    return (
-      <>
-        <article className="panel">
-          <div className="panel-inner">
-            <p className="eyebrow">Admin Module</p>
-            <h1>Admin users and roles playground</h1>
-            <p className="muted">
-              This route previews the shared admin governance module without relying on any client-specific app.
-            </p>
-          </div>
-        </article>
-
-        <article className="grid">
-          <div className="panel">
-            <div className="panel-inner">
-              <p className="status ok">Connected</p>
-              <h2>User governance snapshot</h2>
-              <ul className="list">
-                <li>Total users in page: {users.data.length}</li>
-                <li>Total users overall: {users.pagination.total}</li>
-                <li>Current page: {users.pagination.page}</li>
-                <li>Total pages: {users.pagination.totalPages}</li>
-              </ul>
-            </div>
-          </div>
-
-          <div className="panel">
-            <div className="panel-inner">
-              <h2>Role mix</h2>
-              <div className="code-box">
-                <pre>
-                  {JSON.stringify(
-                    users.data.reduce<Record<string, number>>((acc, row) => {
-                      acc[row.role] = (acc[row.role] ?? 0) + 1;
-                      return acc;
-                    }, {}),
-                    null,
-                    2,
-                  )}
-                </pre>
-              </div>
-            </div>
-          </div>
-        </article>
-
-        <article className="panel">
-          <div className="panel-inner">
-            <h2>First admin users</h2>
-            <div className="code-box">
-              <pre>{JSON.stringify(users.data.slice(0, 5), null, 2)}</pre>
-            </div>
-          </div>
-        </article>
-      </>
-    );
-  } catch (error) {
-    return (
-      <>
-        <article className="panel">
-          <div className="panel-inner">
-            <p className="eyebrow">Admin Module</p>
-            <h1>Admin users and roles playground</h1>
-            <p className="muted">
-              The admin package is wired, but this starter app still needs a configured client database and admin-ready
-              auth environment.
-            </p>
-          </div>
-        </article>
-
-        <article className="panel">
-          <div className="panel-inner stack">
-            <p className="status warn">Configuration required</p>
-            <div className="result-box">
-              <strong>Current error</strong>
-              <p>{formatError(error)}</p>
-            </div>
-            <ul className="list">
-              <li>Set the Supabase public URL and publishable key.</li>
-              <li>Set the Supabase secret key.</li>
-              <li>Ensure the client database includes the admin role assignment tables and RPCs.</li>
-            </ul>
-          </div>
-        </article>
-      </>
-    );
-  }
-}

package/template/modules/crm/app/api/crm/_shared/create-module-route-handler.ts

@@ -1,13 +0,0 @@
-type RouteHandler = (request: Request) => Response | Promise<Response>;
-
-type ModuleWithHandler<THandlerName extends string> = Record<THandlerName, RouteHandler>;
-
-export function createModuleRouteHandler<THandlerName extends string>(
-  loadModule: () => Promise<ModuleWithHandler<THandlerName>>,
-  handlerName: THandlerName,
-): RouteHandler {
-  return async function moduleRouteHandler(request: Request) {
-    const module = await loadModule();
-    return module[handlerName](request);
-  };
-}