npm - @plumbus/ui - Versions diffs - 0.1.0 - Mend

@plumbus/ui 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (49) hide show

package/dist/.tsbuildinfo +1 -0
package/dist/generators/__tests__/auth-generator.test.d.ts +2 -0
package/dist/generators/__tests__/auth-generator.test.d.ts.map +1 -0
package/dist/generators/__tests__/auth-generator.test.js +222 -0
package/dist/generators/__tests__/auth-generator.test.js.map +1 -0
package/dist/generators/__tests__/client-generator.test.d.ts +2 -0
package/dist/generators/__tests__/client-generator.test.d.ts.map +1 -0
package/dist/generators/__tests__/client-generator.test.js +224 -0
package/dist/generators/__tests__/client-generator.test.js.map +1 -0
package/dist/generators/__tests__/form-generator.test.d.ts +2 -0
package/dist/generators/__tests__/form-generator.test.d.ts.map +1 -0
package/dist/generators/__tests__/form-generator.test.js +192 -0
package/dist/generators/__tests__/form-generator.test.js.map +1 -0
package/dist/generators/__tests__/nextjs-template.test.d.ts +2 -0
package/dist/generators/__tests__/nextjs-template.test.d.ts.map +1 -0
package/dist/generators/__tests__/nextjs-template.test.js +214 -0
package/dist/generators/__tests__/nextjs-template.test.js.map +1 -0
package/dist/generators/auth-generator.d.ts +31 -0
package/dist/generators/auth-generator.d.ts.map +1 -0
package/dist/generators/auth-generator.js +292 -0
package/dist/generators/auth-generator.js.map +1 -0
package/dist/generators/client-generator.d.ts +31 -0
package/dist/generators/client-generator.d.ts.map +1 -0
package/dist/generators/client-generator.js +336 -0
package/dist/generators/client-generator.js.map +1 -0
package/dist/generators/form-generator.d.ts +47 -0
package/dist/generators/form-generator.d.ts.map +1 -0
package/dist/generators/form-generator.js +189 -0
package/dist/generators/form-generator.js.map +1 -0
package/dist/generators/index.d.ts +9 -0
package/dist/generators/index.d.ts.map +1 -0
package/dist/generators/index.js +6 -0
package/dist/generators/index.js.map +1 -0
package/dist/generators/nextjs-template.d.ts +44 -0
package/dist/generators/nextjs-template.d.ts.map +1 -0
package/dist/generators/nextjs-template.js +444 -0
package/dist/generators/nextjs-template.js.map +1 -0
package/dist/index.d.ts +9 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +11 -0
package/dist/index.js.map +1 -0
package/instructions/auth-generator.md +154 -0
package/instructions/client-generator.md +149 -0
package/instructions/form-generator.md +157 -0
package/instructions/framework.md +108 -0
package/instructions/nextjs-template.md +160 -0
package/instructions/patterns.md +109 -0
package/instructions/testing.md +211 -0
package/package.json +52 -0

package/dist/generators/nextjs-template.js ADDED Viewed

@@ -0,0 +1,444 @@
+// ── Next.js Project Template Generator ──
+// Generates a Next.js project scaffold with Plumbus auth integration,
+// generated client imports, and example pages wired to capabilities.
+// ── Helpers ──
+function toPascalCase(str) {
+    return str.replace(/(^|[-_ ])(\w)/g, (_, _sep, c) => c.toUpperCase());
+}
+function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+/** Generate package.json for the Next.js project */
+export function generatePackageJson(config) {
+    const name = toKebabCase(config.appName);
+    const content = JSON.stringify({
+        name,
+        version: '0.1.0',
+        private: true,
+        scripts: {
+            dev: 'next dev',
+            build: 'next build',
+            start: 'next start',
+        },
+        dependencies: {
+            next: '^14.0.0',
+            react: '^18.2.0',
+            'react-dom': '^18.2.0',
+            tailwindcss: '^4.0.0',
+            '@tailwindcss/postcss': '^4.0.0',
+        },
+        devDependencies: {
+            typescript: '^5.0.0',
+            '@types/react': '^18.2.0',
+            '@types/react-dom': '^18.2.0',
+        },
+    }, null, 2);
+    return { path: 'package.json', content };
+}
+/** Generate tsconfig.json */
+export function generateTsConfig() {
+    const content = JSON.stringify({
+        compilerOptions: {
+            target: 'ES2017',
+            lib: ['dom', 'dom.iterable', 'esnext'],
+            allowJs: true,
+            skipLibCheck: true,
+            strict: true,
+            noEmit: true,
+            esModuleInterop: true,
+            module: 'esnext',
+            moduleResolution: 'bundler',
+            resolveJsonModule: true,
+            isolatedModules: true,
+            jsx: 'preserve',
+            incremental: true,
+            paths: {
+                '@/*': ['./*'],
+            },
+        },
+        include: ['next-env.d.ts', '**/*.ts', '**/*.tsx'],
+        exclude: ['node_modules'],
+    }, null, 2);
+    return { path: 'tsconfig.json', content };
+}
+/** Generate globals.css with Tailwind import and basic resets */
+export function generateGlobalsCss() {
+    return {
+        path: 'app/globals.css',
+        content: `@import "tailwindcss";
+/* ── Base resets ── */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+html {
+  min-height: 100%;
+}
+body {
+  margin: 0;
+  min-height: 100vh;
+  font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+`,
+    };
+}
+/** Generate postcss.config.mjs for Tailwind CSS */
+export function generatePostcssConfig() {
+    return {
+        path: 'postcss.config.mjs',
+        content: `export default {\n  plugins: {\n    "@tailwindcss/postcss": {},\n  },\n};\n`,
+    };
+}
+/** Generate the layout component */
+export function generateLayout(config) {
+    const auth = config.auth !== false;
+    const authImport = auth ? `import { AuthProvider } from "../components/AuthProvider";\n` : '';
+    const authWrapOpen = auth ? '        <AuthProvider>\n' : '';
+    const authWrapClose = auth ? '        </AuthProvider>\n' : '';
+    return {
+        path: 'app/layout.tsx',
+        content: `import type { Metadata } from "next";
+import "./globals.css";
+${authImport}
+export const metadata: Metadata = {
+  title: "${config.appName}",
+  description: "Generated by @plumbus/ui",
+};
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+${authWrapOpen}          {children}
+${authWrapClose}      </body>
+    </html>
+  );
+}
+`,
+    };
+}
+/** Generate the home page */
+export function generateHomePage(config) {
+    return {
+        path: 'app/page.tsx',
+        content: `export default function Home() {
+  return (
+    <main>
+      <h1>${config.appName}</h1>
+      <p>Welcome to your Plumbus application.</p>
+    </main>
+  );
+}
+`,
+    };
+}
+/** Generate example page for a capability */
+export function generateCapabilityPage(cap) {
+    const pascal = toPascalCase(cap.name);
+    const slug = toKebabCase(cap.name);
+    if (cap.kind === 'query') {
+        return {
+            path: `app/${slug}/page.tsx`,
+            content: `"use client";
+import { use${pascal} } from "@/generated/hooks";
+export default function ${pascal}Page() {
+  const { data, loading, error } = use${pascal}({});
+  if (loading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+  return (
+    <main>
+      <h1>${cap.name}</h1>
+      <pre>{JSON.stringify(data, null, 2)}</pre>
+    </main>
+  );
+}
+`,
+        };
+    }
+    return {
+        path: `app/${slug}/page.tsx`,
+        content: `"use client";
+import { use${pascal} } from "@/generated/hooks";
+export default function ${pascal}Page() {
+  const { mutate, data, loading, error, reset } = use${pascal}();
+  const handleSubmit = async (e: React.FormEvent<HTMLFormElement>) => {
+    e.preventDefault();
+    const formData = new FormData(e.currentTarget);
+    const input = Object.fromEntries(formData.entries());
+    await mutate(input as Record<string, unknown>);
+  };
+  return (
+    <main>
+      <h1>${cap.name}</h1>
+      <form onSubmit={handleSubmit}>
+        <button type="submit" disabled={loading}>
+          {loading ? "Processing..." : "Submit"}
+        </button>
+      </form>
+      {error && <p>Error: {error.message}</p>}
+      {data && (
+        <div>
+          <pre>{JSON.stringify(data, null, 2)}</pre>
+          <button onClick={reset}>Reset</button>
+        </div>
+      )}
+    </main>
+  );
+}
+`,
+    };
+}
+/** Generate AuthProvider component */
+export function generateAuthProvider() {
+    return {
+        path: 'components/AuthProvider.tsx',
+        content: `"use client";
+import React, { createContext, useContext, useState, useEffect } from "react";
+import { getStoredToken, isTokenExpired, refreshSession } from "@/generated/auth";
+import type { AuthUser, AuthState } from "@/generated/auth";
+const AuthContext = createContext<AuthState>({
+  user: null,
+  isAuthenticated: false,
+  isLoading: true,
+  error: null,
+});
+export function useAuthContext() {
+  return useContext(AuthContext);
+}
+export function AuthProvider({ children }: { children: React.ReactNode }) {
+  const [state, setState] = useState<AuthState>({
+    user: null,
+    isAuthenticated: false,
+    isLoading: true,
+    error: null,
+  });
+  useEffect(() => {
+    const token = getStoredToken();
+    if (!token || isTokenExpired(token)) {
+      setState({ user: null, isAuthenticated: false, isLoading: false, error: null });
+      return;
+    }
+    refreshSession()
+      .then((user: AuthUser | null) => {
+        setState({ user, isAuthenticated: !!user, isLoading: false, error: null });
+      })
+      .catch((err: unknown) => {
+        setState({
+          user: null,
+          isAuthenticated: false,
+          isLoading: false,
+          error: err instanceof Error ? err : new Error(String(err)),
+        });
+      });
+  }, []);
+  return <AuthContext.Provider value={state}>{children}</AuthContext.Provider>;
+}
+`,
+    };
+}
+/** Generate the "generated" directory placeholder */
+export function generatePlaceholderFiles() {
+    return [
+        {
+            path: 'generated/.gitkeep',
+            content: '',
+        },
+        {
+            path: 'hooks/.gitkeep',
+            content: '',
+        },
+    ];
+}
+/** Generate .env.local template with Plumbus-specific variables */
+export function generateEnvLocal(config) {
+    const baseUrl = config.apiBaseUrl ?? 'http://localhost:3000';
+    return {
+        path: '.env.local',
+        content: `# Plumbus API
+NEXT_PUBLIC_API_BASE_URL=${baseUrl}
+# Auth
+NEXT_PUBLIC_AUTH_ENABLED=${config.auth !== false ? 'true' : 'false'}
+AUTH_SECRET=change-me-in-production
+# Database (if using Next.js API routes with direct DB access)
+# DATABASE_URL=postgresql://postgres:postgres@localhost:5432/plumbus
+`,
+    };
+}
+/** Generate a global error boundary component */
+export function generateErrorBoundary() {
+    return {
+        path: 'app/error.tsx',
+        content: `"use client";
+import { useEffect } from "react";
+export default function ErrorBoundary({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  useEffect(() => {
+    console.error("Application error:", error);
+  }, [error]);
+  return (
+    <main>
+      <h2>Something went wrong</h2>
+      <p>{error.message}</p>
+      <button onClick={reset}>Try again</button>
+    </main>
+  );
+}
+`,
+    };
+}
+/** Generate a global loading component */
+export function generateLoadingComponent() {
+    return {
+        path: 'app/loading.tsx',
+        content: `export default function Loading() {
+  return (
+    <main>
+      <div role="status" aria-label="Loading">
+        <p>Loading...</p>
+      </div>
+    </main>
+  );
+}
+`,
+    };
+}
+/** Generate Next.js middleware for auth token forwarding */
+export function generateMiddleware(config) {
+    const protectedPaths = config.auth !== false
+        ? `
+  // Protect routes that require authentication
+  const protectedPaths = ["/dashboard", "/settings", "/api/protected"];
+  const isProtected = protectedPaths.some((p) => request.nextUrl.pathname.startsWith(p));
+  if (isProtected) {
+    const token = request.cookies.get("auth_token")?.value;
+    if (!token) {
+      return NextResponse.redirect(new URL("/login", request.url));
+    }
+  }
+`
+        : '';
+    return {
+        path: 'middleware.ts',
+        content: `import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+export function middleware(request: NextRequest) {${protectedPaths}
+  return NextResponse.next();
+}
+export const config = {
+  matcher: [
+    // Match all paths except static files and Next.js internals
+    "/((?!_next/static|_next/image|favicon.ico).*)",
+  ],
+};
+`,
+    };
+}
+/** Generate API route helper for proxying to the Plumbus backend */
+export function generateApiRouteHelper(config) {
+    const baseUrl = config.apiBaseUrl ?? 'http://localhost:3000';
+    return {
+        path: 'app/api/plumbus/[...path]/route.ts',
+        content: `import { NextRequest, NextResponse } from "next/server";
+const API_BASE = process.env.NEXT_PUBLIC_API_BASE_URL ?? "${baseUrl}";
+/**
+ * Proxy handler that forwards requests to the Plumbus API server.
+ * Forwards auth headers and returns the upstream response.
+ */
+async function handler(request: NextRequest, { params }: { params: Promise<{ path: string[] }> }) {
+  const { path } = await params;
+  const target = new URL(path.join("/"), API_BASE);
+  // Forward query parameters
+  request.nextUrl.searchParams.forEach((value, key) => {
+    target.searchParams.set(key, value);
+  });
+  const headers = new Headers(request.headers);
+  headers.delete("host");
+  const resp = await fetch(target.toString(), {
+    method: request.method,
+    headers,
+    body: request.method !== "GET" && request.method !== "HEAD" ? await request.text() : undefined,
+  });
+  const body = await resp.text();
+  return new NextResponse(body, {
+    status: resp.status,
+    headers: { "Content-Type": resp.headers.get("Content-Type") ?? "application/json" },
+  });
+}
+export const GET = handler;
+export const POST = handler;
+export const PUT = handler;
+export const PATCH = handler;
+export const DELETE = handler;
+`,
+    };
+}
+/** Generate the complete Next.js template file set */
+export function generateNextjsTemplate(config, capabilities) {
+    const files = [
+        generatePackageJson(config),
+        generateTsConfig(),
+        generateGlobalsCss(),
+        generatePostcssConfig(),
+        generateLayout(config),
+        generateHomePage(config),
+        generateEnvLocal(config),
+        generateErrorBoundary(),
+        generateLoadingComponent(),
+        generateMiddleware(config),
+        generateApiRouteHelper(config),
+        ...generatePlaceholderFiles(),
+    ];
+    if (config.auth !== false) {
+        files.push(generateAuthProvider());
+    }
+    if (capabilities) {
+        for (const cap of capabilities) {
+            files.push(generateCapabilityPage(cap));
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=nextjs-template.js.map

package/dist/generators/nextjs-template.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"nextjs-template.js","sourceRoot":"","sources":["../../src/generators/nextjs-template.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+export { generateCapabilityTypes, generateClientModule, generateErrorTypes, generateFlowTrigger, generateHooksModule, generateMutationHook, generateQueryHook, generateReactHook, generateTypedClient, } from './generators/client-generator.js';
+export type { ClientGeneratorConfig, FlowTriggerInput } from './generators/client-generator.js';
+export { generateAuthFunctions, generateAuthModule, generateAuthTypes, generateRouteGuard, generateTenantContext, generateTokenUtils, generateUseAuthHook, generateUseCurrentUserHook, } from './generators/auth-generator.js';
+export type { AuthHelperConfig } from './generators/auth-generator.js';
+export { generateApiRouteHelper, generateAuthProvider, generateCapabilityPage, generateEnvLocal, generateErrorBoundary, generateGlobalsCss, generateHomePage, generateLayout, generateLoadingComponent, generateMiddleware, generateNextjsTemplate, generatePackageJson, generatePlaceholderFiles, generatePostcssConfig, generateTsConfig, } from './generators/nextjs-template.js';
+export type { GeneratedFile, NextjsTemplateConfig } from './generators/nextjs-template.js';
+export { extractFieldHint, extractFormHints, generateFormHintsCode, generateFormHintsModule, } from './generators/form-generator.js';
+export type { FormFieldHint, FormFieldType, FormHints, FormValidation, } from './generators/form-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGhG,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG3F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,aAAa,EACb,aAAa,EACb,SAAS,EACT,cAAc,GACf,MAAM,gCAAgC,CAAC"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,11 @@
+// ── @plumbus/ui ──
+// UI layer generators for Plumbus framework
+// Client & Hooks Generators
+export { generateCapabilityTypes, generateClientModule, generateErrorTypes, generateFlowTrigger, generateHooksModule, generateMutationHook, generateQueryHook, generateReactHook, generateTypedClient, } from './generators/client-generator.js';
+// Auth Helpers Generator
+export { generateAuthFunctions, generateAuthModule, generateAuthTypes, generateRouteGuard, generateTenantContext, generateTokenUtils, generateUseAuthHook, generateUseCurrentUserHook, } from './generators/auth-generator.js';
+// Next.js Template Generator
+export { generateApiRouteHelper, generateAuthProvider, generateCapabilityPage, generateEnvLocal, generateErrorBoundary, generateGlobalsCss, generateHomePage, generateLayout, generateLoadingComponent, generateMiddleware, generateNextjsTemplate, generatePackageJson, generatePlaceholderFiles, generatePostcssConfig, generateTsConfig, } from './generators/nextjs-template.js';
+// Form Generation Hints
+export { extractFieldHint, extractFormHints, generateFormHintsCode, generateFormHintsModule, } from './generators/form-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,4CAA4C;AAE5C,4BAA4B;AAC5B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAG1C,yBAAyB;AACzB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AAGxC,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAGzC,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC"}

package/instructions/auth-generator.md ADDED Viewed

@@ -0,0 +1,154 @@
+# Auth Generator
+Generates frontend authentication utilities — types, token management, login/logout functions, React hooks, a route guard component, and optional multi-tenant support.
+## Configuration
+```ts
+interface AuthHelperConfig {
+  /** Auth provider type (e.g. "jwt", "oauth") */
+  provider: string;
+  /** localStorage key for token (default: "plumbus_auth_token") */
+  tokenKey?: string;
+  /** Login endpoint (default: "/api/auth/login") */
+  loginEndpoint?: string;
+  /** Logout endpoint (default: "/api/auth/logout") */
+  logoutEndpoint?: string;
+  /** Session refresh endpoint (default: "/api/auth/refresh") */
+  refreshEndpoint?: string;
+  /** Enable tenant context provider (default: false) */
+  multiTenant?: boolean;
+}
+```
+## Individual Generators
+### `generateAuthTypes()`
+Produces core TypeScript interfaces used across auth code:
+| Type | Fields |
+|------|--------|
+| `AuthUser` | `userId`, `roles`, `scopes`, `tenantId?`, `provider`, `sessionId?` |
+| `AuthState` | `user`, `isAuthenticated`, `isLoading`, `error` |
+| `AuthActions` | `login()`, `logout()`, `refreshSession()`, `getToken()` |
+| `LoginCredentials` | `email?`, `password?`, `token?`, `provider?` |
+| `AuthConfig` | `loginEndpoint`, `logoutEndpoint`, `refreshEndpoint`, `tokenKey` |
+### `generateTokenUtils(config?)`
+Token storage utilities for browser environments:
+| Function | Purpose |
+|----------|---------|
+| `getStoredToken()` | Read token from `localStorage` (returns `null` on server) |
+| `setStoredToken(token)` | Persist token to `localStorage` |
+| `clearStoredToken()` | Remove token from `localStorage` |
+| `parseJwtPayload(token)` | Decode JWT payload (base64url → JSON) |
+| `isTokenExpired(token)` | Check `exp` claim against `Date.now()` |
+- Uses the configurable `tokenKey` (default: `"plumbus_auth_token"`).
+- All functions guard against SSR with `typeof window === "undefined"`.
+### `generateAuthFunctions(config?)`
+HTTP-based auth operations:
+| Function | HTTP | Endpoint |
+|----------|------|----------|
+| `login(credentials)` | POST | `{loginEndpoint}` |
+| `logout()` | POST | `{logoutEndpoint}` |
+| `refreshSession()` | POST | `{refreshEndpoint}` |
+| `getAuthHeaders()` | — | Returns `{ Authorization: "Bearer ..." }` or `{}` |
+- `login` stores the returned token and returns `AuthUser`.
+- `logout` calls the endpoint (fire-and-forget) then clears the stored token.
+- `refreshSession` returns `AuthUser | null` — clears token on failure.
+### `generateUseAuthHook()`
+Full React hook combining state and actions:
+```ts
+function useAuth(): AuthState & AuthActions
+```
+- On mount: checks stored token, refreshes session if valid, sets loading state.
+- Returns `{ user, isAuthenticated, isLoading, error, login, logout, refreshSession, getToken }`.
+- `login` and `logout` update state and re-render.
+### `generateUseCurrentUserHook()`
+Simplified read-only hook:
+```ts
+function useCurrentUser(): { user: AuthUser | null; isAuthenticated: boolean; isLoading: boolean }
+```
+Delegates to `useAuth()` internally.
+### `generateRouteGuard()`
+Role/scope-based route protection component:
+```ts
+interface RouteGuardProps {
+  children: React.ReactNode;
+  roles?: string[];       // User must have at least one of these roles
+  scopes?: string[];      // User must have at least one of these scopes
+  fallback?: React.ReactNode;  // Shown while loading or when unauthorized
+  redirectTo?: string;    // Redirect URL for unauthenticated users
+}
+```
+Behavior:
+1. While loading → render `fallback` (or null).
+2. Not authenticated → redirect if `redirectTo` set, else render `fallback`.
+3. Roles check → `some` match (any role matches → pass).
+4. Scopes check → `some` match (any scope matches → pass).
+5. Authorized → render `children`.
+### `generateTenantContext()`
+Multi-tenant context hook (only included when `config.multiTenant` is true):
+```ts
+interface TenantContextValue {
+  tenantId: string | null;
+  setTenantId(id: string): void;
+}
+function useTenant(): TenantContextValue
+```
+- Initializes `tenantId` from the authenticated user's `tenantId`.
+- Syncs when user identity changes.
+## Module Generator
+### `generateAuthModule(config?)`
+Combines all auth generators into a single file:
+```ts
+const code = generateAuthModule({
+  provider: "jwt",
+  tokenKey: "my_app_token",
+  loginEndpoint: "/api/v1/auth/login",
+  multiTenant: true,
+});
+// Write to: generated/auth.ts
+```
+Output order: imports → types → token utils → auth functions → useAuth → useCurrentUser → RouteGuard → (tenant context if enabled).
+Imports `React`, `useState`, `useEffect` from React.
+## Auth Flow
+```
+Login:   credentials → POST /api/auth/login → { token, user } → localStorage
+Refresh: token → POST /api/auth/refresh → { token, user } → localStorage
+Logout:  token → POST /api/auth/logout → clear localStorage
+Request: getAuthHeaders() → { Authorization: "Bearer <token>" }
+```