everything-dev 1.42.1 → 1.43.0

package/skills/ui-integration/SKILL.md

@@ -0,0 +1,382 @@
+---
+name: ui-integration
+description: Route creation, API client usage, auth client, SSR hydration, sidebar system, and the @/app module surface. Use when adding new UI routes, fetching data from the API, implementing auth flows, or customizing sidebar navigation.
+metadata:
+  sources: "ui/src/app.ts,ui/src/lib/api.ts,ui/src/lib/auth.ts,ui/src/router.tsx,ui/src/router.server.tsx,ui/src/hydrate.tsx,ui/src/routes/__root.tsx,ui/src/routes/_layout.tsx,ui/src/routes/_layout/_authenticated.tsx"
+---
+
+# UI Integration
+
+## File-based Routing
+
+Routes are defined as files in `ui/src/routes/`. TanStack Router auto-generates the route tree.
+
+### Route File Convention
+
+```
+ui/src/routes/
+├── __root.tsx                     # Root layout (HTML shell, head, scripts)
+├── index.tsx                      # /
+├── _layout.tsx                    # Shell layout (sidebar, header, footer)
+├── _layout/
+│   ├── index.tsx                  # / (inside shell)
+│   ├── _authenticated.tsx         # Auth guard layout (redirects to /login)
+│   └── _authenticated/
+│       ├── index.tsx              # / (authenticated)
+│       ├── settings.tsx           # /settings
+│       └── your-plugin/
+│           └── index.tsx          # /your-plugin
+├── login.tsx                      # /login
+└── about.tsx                      # /about
+```
+
+- Files starting with `_` are **layout** routes (parent components with `<Outlet />`)
+- Files starting with `_` followed by a path segment are **nested layouts**
+- Regular files become path segments (e.g., `settings.tsx` → `/settings`)
+- Directories create nested paths (e.g., `_authenticated/settings.tsx` → `/settings` inside the auth guard)
+
+### Basic Route
+
+```tsx
+import { createFileRoute } from "@tanstack/react-router";
+
+export const Route = createFileRoute("/about")({
+  component: AboutPage,
+});
+
+function AboutPage() {
+  return <div>About</div>;
+}
+```
+
+### Route with Loader
+
+```tsx
+import { createFileRoute } from "@tanstack/react-router";
+import { useApiClient } from "@/app";
+
+export const Route = createFileRoute("/projects/$id")({
+  loader: async ({ context, params }) => {
+    const { apiClient } = context;
+    const project = await apiClient.projects.getProject({ id: params.id });
+    return { project };
+  },
+  component: ProjectPage,
+});
+
+function ProjectPage() {
+  const { project } = Route.useLoaderData();
+  return <div>{project.name}</div>;
+}
+```
+
+### Route with Head/Sidebar Metadata
+
+```tsx
+export const Route = createFileRoute("/_layout/settings")({
+  component: SettingsPage,
+  head: () => ({
+    meta: [{ title: "Settings" }],
+  }),
+});
+```
+
+## The `@/app` Module Surface
+
+`ui/src/app.ts` exports everything UI route code needs:
+
+```ts
+// Runtime config helpers
+import { getRuntimeConfig, getAccount, getAppName, getActiveRuntime, getRepository, getCspNonce } from "@/app";
+
+// API client
+import { createApiClient, useApiClient, useOrpc, type ApiClient } from "@/app";
+
+// Auth client
+import { createAuthClient, useAuthClient, sessionQueryOptions, useRelayHistory, type AuthClient, type SessionData } from "@/app";
+
+// Types
+import type { ClientRuntimeConfig, RouterContext, CreateRouterOptions, RenderOptions } from "@/app";
+```
+
+### Runtime Helpers
+
+```ts
+const config = getRuntimeConfig();           // Full window.__RUNTIME_CONFIG__
+const account = getAccount(config);           // NEAR account
+const appName = getAppName(config);           // Title or account
+const activeRuntime = getActiveRuntime(config); // { accountId, gatewayId, title }
+const repo = getRepository(config);           // Repository URL
+const nonce = getCspNonce();                  // CSP nonce for inline scripts
+```
+
+These are SSR-safe — they accept an optional `RuntimeConfigInput` to work with config from loader data.
+
+## API Client
+
+### Creation
+
+The client is created once in `hydrate.tsx` and stored in the Router context:
+
+```ts
+const apiClient = createApiClient({
+  hostUrl: runtimeConfig.hostUrl,
+  rpcBase: runtimeConfig.rpcBase,   // "/api/rpc"
+});
+```
+
+It uses `RPCLink` with `credentials: "include"` and a global error interceptor that shows a toast on network failures.
+
+### In Route Components
+
+```ts
+import { useApiClient, useOrpc } from "@/app";
+
+function Component() {
+  // Direct usage
+  const apiClient = useApiClient();
+  const { data } = await apiClient.registry.listRegistryApps({ limit: 24 });
+
+  // With TanStack Query utils (caching, refetch, mutations)
+  const orpc = useOrpc();
+  const { data, isLoading } = orpc.registry.listRegistryApps.useQuery({ limit: 24 });
+  const mutation = orpc.registry.listRegistryApps.useMutation();
+
+  // In route loaders (from context, no hooks):
+  const { apiClient } = context;
+  const result = await apiClient.ping();
+}
+```
+
+### Typed API Calls
+
+Every procedure from every plugin is available on `apiClient` with full TypeScript types:
+
+```ts
+apiClient.ping()                                          // → { status, timestamp }
+apiClient.registry.listRegistryApps({ limit: 24 })         // → { apps, meta }
+apiClient.projects.getProject({ id: "proj_123" })         // → Project
+apiClient.authHealth()                                     // → { status, emailConfigured, ... }
+```
+
+The types come from the auto-generated `api-types.gen.ts`, which merges every plugin's contract into a single `ApiContract` type.
+
+### Error Handling
+
+Network/fetch errors are automatically caught by the `RPCLink` interceptor and shown as a toast:
+
+```
+"Unable to connect to API" — The API is currently unavailable.
+```
+
+Procedure-level errors (like `UNAUTHORIZED`, `NOT_FOUND`) are thrown as `ORPCError` instances and should be caught inline:
+
+```ts
+try {
+  await apiClient.authHealth();
+} catch (error) {
+  if (error instanceof ORPCError) {
+    // Handle specific error
+  }
+}
+```
+
+## Auth Client
+
+### Creation
+
+The auth client is also created once in `hydrate.tsx`:
+
+```ts
+const authClient = createAuthClient(runtimeConfig);
+```
+
+Configured with Better-Auth plugins: SIWN (NEAR), passkey, organization, admin, API key, anonymous, phone.
+
+### In Route Components
+
+```ts
+import { useAuthClient, sessionQueryOptions } from "@/app";
+
+function LoginPage() {
+  const authClient = useAuthClient();
+
+  // Sign in with email
+  await authClient.signIn.email({ email, password });
+
+  // Sign in with NEAR (SIWN)
+  await authClient.signIn.siwn({ networkId: "mainnet" });
+
+  // Sign out
+  await authClient.signOut();
+
+  // Organization switching
+  await authClient.organization.setActive({ organizationId: "org_123" });
+}
+```
+
+### Session Query Pattern
+
+Use `sessionQueryOptions()` for standardized session fetching with TanStack Query:
+
+```ts
+// In a route loader:
+const session = await queryClient.ensureQueryData(
+  sessionQueryOptions(authClient, context.session),
+);
+
+// In a component:
+const { data: session } = useQuery(sessionQueryOptions(authClient));
+```
+
+Returns `SessionData` with `user`, `session`, and typed auth context.
+
+## Auth Route Guard
+
+The `_authenticated.tsx` layout protects routes that require a session:
+
+```ts
+export const Route = createFileRoute("/_layout/_authenticated")({
+  beforeLoad: async ({ context, location }) => {
+    const { queryClient, authClient } = context;
+    const session = await queryClient.ensureQueryData(
+      sessionQueryOptions(authClient, context.session),
+    );
+    if (!session?.user) {
+      throw redirect({
+        to: "/login",
+        search: { redirect: location.href },
+      });
+    }
+    if (session.user.banned) {
+      throw redirect({ to: "/login", hash: "banned" });
+    }
+    return {
+      auth: {
+        isAuthenticated: true,
+        user: session.user,
+        session: session.session,
+        activeOrganizationId: session.session?.activeOrganizationId || null,
+        isAnonymous: session.user.isAnonymous || false,
+        isAdmin: session.user.role === "admin",
+        isBanned: session.user.banned || false,
+      },
+    };
+  },
+  component: AuthenticatedLayout,
+});
+```
+
+Nest routes under `_layout/_authenticated/` to inherit this guard. Unauthenticated users are redirected to `/login?redirect=<current-path>`.
+
+## Sidebar System
+
+Sidebar items are defined inline in `ui/src/routes/_layout.tsx` as a `sidebarItems` array:
+
+```ts
+import { Globe, Home } from "lucide-react";
+
+type SidebarRole = "anon" | "member" | "admin";
+
+interface SidebarItem {
+  icon: React.ComponentType<{ className?: string }>;
+  label: string;
+  to: string;
+  roleRequired: SidebarRole;
+}
+```
+
+### Role filtering:
+
+```ts
+function filterSidebarByRole(items: SidebarItem[], userRole: SidebarRole): SidebarItem[] {
+  return items.filter((item) => {
+    if (item.roleRequired === "anon") return true;
+    if (item.roleRequired === "member" && userRole !== "anon") return true;
+    if (item.roleRequired === "admin" && userRole === "admin") return true;
+    return false;
+  });
+}
+
+const sidebarItems: SidebarItem[] = [
+  { icon: Home, label: "home", to: "/home", roleRequired: "anon" },
+];
+const visibleItems = filterSidebarByRole(sidebarItems, userRole);
+```
+
+Add items manually to the `sidebarItems` array. Available icons: any `lucide-react` icon name.
+
+## SSR Architecture
+
+### Client Bootstrap (`hydrate.tsx`)
+
+1. Reads `window.__RUNTIME_CONFIG__`
+2. Creates `QueryClient`, `ApiClient`, `AuthClient`
+3. Creates TanStack Router with browser history
+4. Hydrates React DOM into the HTML shell
+
+### Server-Side (`router.server.tsx`)
+
+1. Creates request-scoped router with memory history
+2. Creates per-request `apiClient` and `authClient`
+3. Renders to stream via TanStack Router SSR's `createRequestHandler`
+4. Host calls `loadRouterModule()` to dynamically load the SSR bundle
+
+### Route Loading for SSR
+
+Loaders run on both server and client. Use `loader` for data needed at render time, `beforeLoad` for auth checks and redirects:
+
+```ts
+export const Route = createFileRoute("/projects")({
+  beforeLoad: async ({ context }) => {
+    // Runs on server and client — good for auth
+  },
+  loader: async ({ context }) => {
+    // Runs on server and client — good for data fetching
+    const { apiClient } = context;
+    return await apiClient.projects.listProjects();
+  },
+  component: ProjectsPage,
+});
+```
+
+The `RouterContext` type:
+
+```ts
+interface RouterContext extends BaseRouterContextWithApi<ApiClient, SessionData> {
+  apiClient: ApiClient;
+  authClient: AuthClient;
+}
+```
+
+## Component Patterns
+
+### Semantic Tailwind Classes
+
+Use theme-aware classes — never hardcoded colors:
+
+```tsx
+<div className="bg-background text-foreground">      // ✅ correct
+<div className="bg-blue-600 text-white">                 // ❌ wrong
+<div className="text-muted-foreground">                  // ✅ muted text
+<div className="bg-card border border-border">            // ✅ card surface
+```
+
+### SSR-Safe Rendering
+
+For values that only exist on the client:
+
+```tsx
+import { useClientValue } from "@/hooks";
+
+function Component() {
+  const appName = useClientValue(() => getAppName(), "app");
+  return <h1>{appName}</h1>;
+}
+```
+
+### Component Location
+
+- Shared UI components: `ui/src/components/ui/` — semantic, reusable primitives
+- Feature components: colocated with the route that uses them
+- Exports from `ui/src/components/index.ts` for shared components

package/dist/sidebar.cjs

@@ -1,116 +0,0 @@
-const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-let node_fs = require("node:fs");
-let node_path = require("node:path");
-
-//#region src/sidebar.ts
-const ICON_IMPORTS = {
-	Home: "lucide-react",
-	Globe: "lucide-react",
-	FolderKanban: "lucide-react",
-	Building2: "lucide-react",
-	Settings: "lucide-react",
-	User: "lucide-react",
-	Users: "lucide-react",
-	Shield: "lucide-react",
-	LayoutDashboard: "lucide-react",
-	CreditCard: "lucide-react",
-	Bell: "lucide-react",
-	Key: "lucide-react",
-	FileText: "lucide-react",
-	Database: "lucide-react",
-	Activity: "lucide-react",
-	BarChart3: "lucide-react",
-	Zap: "lucide-react",
-	Terminal: "lucide-react",
-	Code: "lucide-react",
-	Package: "lucide-react",
-	Store: "lucide-react",
-	ShoppingBag: "lucide-react",
-	Wallet: "lucide-react",
-	Coins: "lucide-react",
-	Plug: "lucide-react",
-	Link: "lucide-react",
-	ExternalLink: "lucide-react",
-	Puzzle: "lucide-react",
-	Layers: "lucide-react",
-	Grid3X3: "lucide-react",
-	AppWindow: "lucide-react"
-};
-function resolveIconModule(iconName) {
-	if (ICON_IMPORTS[iconName]) return ICON_IMPORTS[iconName];
-	return "lucide-react";
-}
-function collectIconImports(items) {
-	const moduleMap = /* @__PURE__ */ new Map();
-	for (const item of items) {
-		const module = resolveIconModule(item.icon);
-		if (!moduleMap.has(module)) moduleMap.set(module, /* @__PURE__ */ new Set());
-		moduleMap.get(module).add(item.icon);
-	}
-	return moduleMap;
-}
-function generatePluginSidebarContent(runtimeConfig) {
-	const coreItems = [{
-		icon: "Home",
-		label: "home",
-		to: "/home",
-		roleRequired: "anon"
-	}];
-	if (runtimeConfig.auth?.sidebar) for (const item of runtimeConfig.auth.sidebar) coreItems.push({
-		...item,
-		to: item.to ?? "/auth",
-		roleRequired: item.roleRequired ?? "member"
-	});
-	const pluginItems = [];
-	if (runtimeConfig.plugins) for (const [key, entry] of Object.entries(runtimeConfig.plugins)) {
-		const sidebar = entry.sidebar;
-		if (!sidebar) continue;
-		for (const item of sidebar) pluginItems.push({
-			...item,
-			to: item.to ?? `/${key}`,
-			roleRequired: item.roleRequired ?? "member"
-		});
-	}
-	const allItems = [...coreItems, ...pluginItems];
-	const moduleMap = collectIconImports(allItems);
-	const importLines = [];
-	for (const [module, icons] of moduleMap) {
-		const iconList = [...icons].join(", ");
-		importLines.push(`import { ${iconList} } from "${module}";`);
-	}
-	const itemsCode = allItems.map((item) => `  { icon: ${item.icon}, label: "${item.label}", to: "${item.to}" as const, roleRequired: "${item.roleRequired}" as const },`).join("\n");
-	return `// Auto-generated by bos sync/pluginAdd/pluginRemove. Do not edit.
-${importLines.join("\n")}
-
-export type SidebarRole = "anon" | "member" | "admin";
-
-export interface SidebarItem {
-  icon: React.ComponentType<{ className?: string }>;
-  label: string;
-  to: string;
-  roleRequired: SidebarRole;
-}
-
-export const pluginSidebarItems: SidebarItem[] = [
-${itemsCode}
-];
-`;
-}
-function writePluginSidebarGen(configDir, runtimeConfig) {
-	const outputPath = (0, node_path.join)(configDir, "ui/src/lib/plugin-sidebar.gen.ts");
-	const content = generatePluginSidebarContent(runtimeConfig);
-	const outputDir = (0, node_path.dirname)(outputPath);
-	if (!(0, node_fs.existsSync)(outputDir)) (0, node_fs.mkdirSync)(outputDir, { recursive: true });
-	let existingContent = null;
-	try {
-		existingContent = (0, node_fs.existsSync)(outputPath) ? (0, node_fs.readFileSync)(outputPath, "utf-8") : null;
-	} catch {}
-	if (existingContent === content) return outputPath;
-	(0, node_fs.writeFileSync)(outputPath, content);
-	return outputPath;
-}
-
-//#endregion
-exports.generatePluginSidebarContent = generatePluginSidebarContent;
-exports.writePluginSidebarGen = writePluginSidebarGen;
-//# sourceMappingURL=sidebar.cjs.map

package/dist/sidebar.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sidebar.cjs","names":[],"sources":["../src/sidebar.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { RuntimeConfig, SidebarItem } from \"./types\";\n\nconst ICON_IMPORTS: Record<string, string> = {\n  Home: \"lucide-react\",\n  Globe: \"lucide-react\",\n  FolderKanban: \"lucide-react\",\n  Building2: \"lucide-react\",\n  Settings: \"lucide-react\",\n  User: \"lucide-react\",\n  Users: \"lucide-react\",\n  Shield: \"lucide-react\",\n  LayoutDashboard: \"lucide-react\",\n  CreditCard: \"lucide-react\",\n  Bell: \"lucide-react\",\n  Key: \"lucide-react\",\n  FileText: \"lucide-react\",\n  Database: \"lucide-react\",\n  Activity: \"lucide-react\",\n  BarChart3: \"lucide-react\",\n  Zap: \"lucide-react\",\n  Terminal: \"lucide-react\",\n  Code: \"lucide-react\",\n  Package: \"lucide-react\",\n  Store: \"lucide-react\",\n  ShoppingBag: \"lucide-react\",\n  Wallet: \"lucide-react\",\n  Coins: \"lucide-react\",\n  Plug: \"lucide-react\",\n  Link: \"lucide-react\",\n  ExternalLink: \"lucide-react\",\n  Puzzle: \"lucide-react\",\n  Layers: \"lucide-react\",\n  Grid3X3: \"lucide-react\",\n  AppWindow: \"lucide-react\",\n};\n\nfunction resolveIconModule(iconName: string): string {\n  if (ICON_IMPORTS[iconName]) return ICON_IMPORTS[iconName];\n  return \"lucide-react\";\n}\n\nfunction collectIconImports(items: SidebarItem[]): Map<string, Set<string>> {\n  const moduleMap = new Map<string, Set<string>>();\n  for (const item of items) {\n    const module = resolveIconModule(item.icon);\n    if (!moduleMap.has(module)) moduleMap.set(module, new Set());\n    moduleMap.get(module)!.add(item.icon);\n  }\n  return moduleMap;\n}\n\nexport function generatePluginSidebarContent(runtimeConfig: RuntimeConfig): string {\n  const coreItems: SidebarItem[] = [\n    { icon: \"Home\", label: \"home\", to: \"/home\", roleRequired: \"anon\" },\n  ];\n\n  if (runtimeConfig.auth?.sidebar) {\n    for (const item of runtimeConfig.auth.sidebar) {\n      coreItems.push({\n        ...item,\n        to: item.to ?? \"/auth\",\n        roleRequired: item.roleRequired ?? \"member\",\n      });\n    }\n  }\n\n  const pluginItems: SidebarItem[] = [];\n  if (runtimeConfig.plugins) {\n    for (const [key, entry] of Object.entries(runtimeConfig.plugins)) {\n      const sidebar = entry.sidebar;\n      if (!sidebar) continue;\n      for (const item of sidebar) {\n        pluginItems.push({\n          ...item,\n          to: item.to ?? `/${key}`,\n          roleRequired: item.roleRequired ?? \"member\",\n        });\n      }\n    }\n  }\n\n  const allItems = [...coreItems, ...pluginItems];\n  const moduleMap = collectIconImports(allItems);\n\n  const importLines: string[] = [];\n  for (const [module, icons] of moduleMap) {\n    const iconList = [...icons].join(\", \");\n    importLines.push(`import { ${iconList} } from \"${module}\";`);\n  }\n\n  const itemsCode = allItems\n    .map(\n      (item) =>\n        `  { icon: ${item.icon}, label: \"${item.label}\", to: \"${item.to}\" as const, roleRequired: \"${item.roleRequired}\" as const },`,\n    )\n    .join(\"\\n\");\n\n  return `// Auto-generated by bos sync/pluginAdd/pluginRemove. Do not edit.\n${importLines.join(\"\\n\")}\n\nexport type SidebarRole = \"anon\" | \"member\" | \"admin\";\n\nexport interface SidebarItem {\n  icon: React.ComponentType<{ className?: string }>;\n  label: string;\n  to: string;\n  roleRequired: SidebarRole;\n}\n\nexport const pluginSidebarItems: SidebarItem[] = [\n${itemsCode}\n];\n`;\n}\n\nexport function writePluginSidebarGen(configDir: string, runtimeConfig: RuntimeConfig): string {\n  const outputPath = join(configDir, \"ui/src/lib/plugin-sidebar.gen.ts\");\n\n  const content = generatePluginSidebarContent(runtimeConfig);\n\n  const outputDir = dirname(outputPath);\n  if (!existsSync(outputDir)) {\n    mkdirSync(outputDir, { recursive: true });\n  }\n\n  let existingContent: string | null = null;\n  try {\n    existingContent = existsSync(outputPath)\n      ? // eslint-disable-next-line no-restricted-syntax\n        readFileSync(outputPath, \"utf-8\")\n      : null;\n  } catch {\n    // file doesn't exist yet\n  }\n\n  if (existingContent === content) return outputPath;\n\n  writeFileSync(outputPath, content);\n  return outputPath;\n}\n"],"mappings":";;;;;AAIA,MAAM,eAAuC;CAC3C,MAAM;CACN,OAAO;CACP,cAAc;CACd,WAAW;CACX,UAAU;CACV,MAAM;CACN,OAAO;CACP,QAAQ;CACR,iBAAiB;CACjB,YAAY;CACZ,MAAM;CACN,KAAK;CACL,UAAU;CACV,UAAU;CACV,UAAU;CACV,WAAW;CACX,KAAK;CACL,UAAU;CACV,MAAM;CACN,SAAS;CACT,OAAO;CACP,aAAa;CACb,QAAQ;CACR,OAAO;CACP,MAAM;CACN,MAAM;CACN,cAAc;CACd,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,WAAW;CACZ;AAED,SAAS,kBAAkB,UAA0B;AACnD,KAAI,aAAa,UAAW,QAAO,aAAa;AAChD,QAAO;;AAGT,SAAS,mBAAmB,OAAgD;CAC1E,MAAM,4BAAY,IAAI,KAA0B;AAChD,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,kBAAkB,KAAK,KAAK;AAC3C,MAAI,CAAC,UAAU,IAAI,OAAO,CAAE,WAAU,IAAI,wBAAQ,IAAI,KAAK,CAAC;AAC5D,YAAU,IAAI,OAAO,CAAE,IAAI,KAAK,KAAK;;AAEvC,QAAO;;AAGT,SAAgB,6BAA6B,eAAsC;CACjF,MAAM,YAA2B,CAC/B;EAAE,MAAM;EAAQ,OAAO;EAAQ,IAAI;EAAS,cAAc;EAAQ,CACnE;AAED,KAAI,cAAc,MAAM,QACtB,MAAK,MAAM,QAAQ,cAAc,KAAK,QACpC,WAAU,KAAK;EACb,GAAG;EACH,IAAI,KAAK,MAAM;EACf,cAAc,KAAK,gBAAgB;EACpC,CAAC;CAIN,MAAM,cAA6B,EAAE;AACrC,KAAI,cAAc,QAChB,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,cAAc,QAAQ,EAAE;EAChE,MAAM,UAAU,MAAM;AACtB,MAAI,CAAC,QAAS;AACd,OAAK,MAAM,QAAQ,QACjB,aAAY,KAAK;GACf,GAAG;GACH,IAAI,KAAK,MAAM,IAAI;GACnB,cAAc,KAAK,gBAAgB;GACpC,CAAC;;CAKR,MAAM,WAAW,CAAC,GAAG,WAAW,GAAG,YAAY;CAC/C,MAAM,YAAY,mBAAmB,SAAS;CAE9C,MAAM,cAAwB,EAAE;AAChC,MAAK,MAAM,CAAC,QAAQ,UAAU,WAAW;EACvC,MAAM,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK;AACtC,cAAY,KAAK,YAAY,SAAS,WAAW,OAAO,IAAI;;CAG9D,MAAM,YAAY,SACf,KACE,SACC,aAAa,KAAK,KAAK,YAAY,KAAK,MAAM,UAAU,KAAK,GAAG,6BAA6B,KAAK,aAAa,eAClH,CACA,KAAK,KAAK;AAEb,QAAO;EACP,YAAY,KAAK,KAAK,CAAC;;;;;;;;;;;;EAYvB,UAAU;;;;AAKZ,SAAgB,sBAAsB,WAAmB,eAAsC;CAC7F,MAAM,iCAAkB,WAAW,mCAAmC;CAEtE,MAAM,UAAU,6BAA6B,cAAc;CAE3D,MAAM,mCAAoB,WAAW;AACrC,KAAI,yBAAY,UAAU,CACxB,wBAAU,WAAW,EAAE,WAAW,MAAM,CAAC;CAG3C,IAAI,kBAAiC;AACrC,KAAI;AACF,4CAA6B,WAAW,6BAEvB,YAAY,QAAQ,GACjC;SACE;AAIR,KAAI,oBAAoB,QAAS,QAAO;AAExC,4BAAc,YAAY,QAAQ;AAClC,QAAO"}

package/dist/sidebar.d.cts

@@ -1,8 +0,0 @@
-import { RuntimeConfig } from "./types.cjs";
-
-//#region src/sidebar.d.ts
-declare function generatePluginSidebarContent(runtimeConfig: RuntimeConfig): string;
-declare function writePluginSidebarGen(configDir: string, runtimeConfig: RuntimeConfig): string;
-//#endregion
-export { generatePluginSidebarContent, writePluginSidebarGen };
-//# sourceMappingURL=sidebar.d.cts.map

package/dist/sidebar.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sidebar.d.cts","names":[],"sources":["../src/sidebar.ts"],"mappings":";;;iBAqDgB,4BAAA,CAA6B,aAAA,EAAe,aAAA;AAAA,iBAgE5C,qBAAA,CAAsB,SAAA,UAAmB,aAAA,EAAe,aAAA"}

package/dist/sidebar.d.mts

@@ -1,8 +0,0 @@
-import { RuntimeConfig } from "./types.mjs";
-
-//#region src/sidebar.d.ts
-declare function generatePluginSidebarContent(runtimeConfig: RuntimeConfig): string;
-declare function writePluginSidebarGen(configDir: string, runtimeConfig: RuntimeConfig): string;
-//#endregion
-export { generatePluginSidebarContent, writePluginSidebarGen };
-//# sourceMappingURL=sidebar.d.mts.map

package/dist/sidebar.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sidebar.d.mts","names":[],"sources":["../src/sidebar.ts"],"mappings":";;;iBAqDgB,4BAAA,CAA6B,aAAA,EAAe,aAAA;AAAA,iBAgE5C,qBAAA,CAAsB,SAAA,UAAmB,aAAA,EAAe,aAAA"}

package/dist/sidebar.mjs

@@ -1,114 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-
-//#region src/sidebar.ts
-const ICON_IMPORTS = {
-	Home: "lucide-react",
-	Globe: "lucide-react",
-	FolderKanban: "lucide-react",
-	Building2: "lucide-react",
-	Settings: "lucide-react",
-	User: "lucide-react",
-	Users: "lucide-react",
-	Shield: "lucide-react",
-	LayoutDashboard: "lucide-react",
-	CreditCard: "lucide-react",
-	Bell: "lucide-react",
-	Key: "lucide-react",
-	FileText: "lucide-react",
-	Database: "lucide-react",
-	Activity: "lucide-react",
-	BarChart3: "lucide-react",
-	Zap: "lucide-react",
-	Terminal: "lucide-react",
-	Code: "lucide-react",
-	Package: "lucide-react",
-	Store: "lucide-react",
-	ShoppingBag: "lucide-react",
-	Wallet: "lucide-react",
-	Coins: "lucide-react",
-	Plug: "lucide-react",
-	Link: "lucide-react",
-	ExternalLink: "lucide-react",
-	Puzzle: "lucide-react",
-	Layers: "lucide-react",
-	Grid3X3: "lucide-react",
-	AppWindow: "lucide-react"
-};
-function resolveIconModule(iconName) {
-	if (ICON_IMPORTS[iconName]) return ICON_IMPORTS[iconName];
-	return "lucide-react";
-}
-function collectIconImports(items) {
-	const moduleMap = /* @__PURE__ */ new Map();
-	for (const item of items) {
-		const module = resolveIconModule(item.icon);
-		if (!moduleMap.has(module)) moduleMap.set(module, /* @__PURE__ */ new Set());
-		moduleMap.get(module).add(item.icon);
-	}
-	return moduleMap;
-}
-function generatePluginSidebarContent(runtimeConfig) {
-	const coreItems = [{
-		icon: "Home",
-		label: "home",
-		to: "/home",
-		roleRequired: "anon"
-	}];
-	if (runtimeConfig.auth?.sidebar) for (const item of runtimeConfig.auth.sidebar) coreItems.push({
-		...item,
-		to: item.to ?? "/auth",
-		roleRequired: item.roleRequired ?? "member"
-	});
-	const pluginItems = [];
-	if (runtimeConfig.plugins) for (const [key, entry] of Object.entries(runtimeConfig.plugins)) {
-		const sidebar = entry.sidebar;
-		if (!sidebar) continue;
-		for (const item of sidebar) pluginItems.push({
-			...item,
-			to: item.to ?? `/${key}`,
-			roleRequired: item.roleRequired ?? "member"
-		});
-	}
-	const allItems = [...coreItems, ...pluginItems];
-	const moduleMap = collectIconImports(allItems);
-	const importLines = [];
-	for (const [module, icons] of moduleMap) {
-		const iconList = [...icons].join(", ");
-		importLines.push(`import { ${iconList} } from "${module}";`);
-	}
-	const itemsCode = allItems.map((item) => `  { icon: ${item.icon}, label: "${item.label}", to: "${item.to}" as const, roleRequired: "${item.roleRequired}" as const },`).join("\n");
-	return `// Auto-generated by bos sync/pluginAdd/pluginRemove. Do not edit.
-${importLines.join("\n")}
-
-export type SidebarRole = "anon" | "member" | "admin";
-
-export interface SidebarItem {
-  icon: React.ComponentType<{ className?: string }>;
-  label: string;
-  to: string;
-  roleRequired: SidebarRole;
-}
-
-export const pluginSidebarItems: SidebarItem[] = [
-${itemsCode}
-];
-`;
-}
-function writePluginSidebarGen(configDir, runtimeConfig) {
-	const outputPath = join(configDir, "ui/src/lib/plugin-sidebar.gen.ts");
-	const content = generatePluginSidebarContent(runtimeConfig);
-	const outputDir = dirname(outputPath);
-	if (!existsSync(outputDir)) mkdirSync(outputDir, { recursive: true });
-	let existingContent = null;
-	try {
-		existingContent = existsSync(outputPath) ? readFileSync(outputPath, "utf-8") : null;
-	} catch {}
-	if (existingContent === content) return outputPath;
-	writeFileSync(outputPath, content);
-	return outputPath;
-}
-
-//#endregion
-export { generatePluginSidebarContent, writePluginSidebarGen };
-//# sourceMappingURL=sidebar.mjs.map

package/dist/sidebar.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"sidebar.mjs","names":[],"sources":["../src/sidebar.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport type { RuntimeConfig, SidebarItem } from \"./types\";\n\nconst ICON_IMPORTS: Record<string, string> = {\n  Home: \"lucide-react\",\n  Globe: \"lucide-react\",\n  FolderKanban: \"lucide-react\",\n  Building2: \"lucide-react\",\n  Settings: \"lucide-react\",\n  User: \"lucide-react\",\n  Users: \"lucide-react\",\n  Shield: \"lucide-react\",\n  LayoutDashboard: \"lucide-react\",\n  CreditCard: \"lucide-react\",\n  Bell: \"lucide-react\",\n  Key: \"lucide-react\",\n  FileText: \"lucide-react\",\n  Database: \"lucide-react\",\n  Activity: \"lucide-react\",\n  BarChart3: \"lucide-react\",\n  Zap: \"lucide-react\",\n  Terminal: \"lucide-react\",\n  Code: \"lucide-react\",\n  Package: \"lucide-react\",\n  Store: \"lucide-react\",\n  ShoppingBag: \"lucide-react\",\n  Wallet: \"lucide-react\",\n  Coins: \"lucide-react\",\n  Plug: \"lucide-react\",\n  Link: \"lucide-react\",\n  ExternalLink: \"lucide-react\",\n  Puzzle: \"lucide-react\",\n  Layers: \"lucide-react\",\n  Grid3X3: \"lucide-react\",\n  AppWindow: \"lucide-react\",\n};\n\nfunction resolveIconModule(iconName: string): string {\n  if (ICON_IMPORTS[iconName]) return ICON_IMPORTS[iconName];\n  return \"lucide-react\";\n}\n\nfunction collectIconImports(items: SidebarItem[]): Map<string, Set<string>> {\n  const moduleMap = new Map<string, Set<string>>();\n  for (const item of items) {\n    const module = resolveIconModule(item.icon);\n    if (!moduleMap.has(module)) moduleMap.set(module, new Set());\n    moduleMap.get(module)!.add(item.icon);\n  }\n  return moduleMap;\n}\n\nexport function generatePluginSidebarContent(runtimeConfig: RuntimeConfig): string {\n  const coreItems: SidebarItem[] = [\n    { icon: \"Home\", label: \"home\", to: \"/home\", roleRequired: \"anon\" },\n  ];\n\n  if (runtimeConfig.auth?.sidebar) {\n    for (const item of runtimeConfig.auth.sidebar) {\n      coreItems.push({\n        ...item,\n        to: item.to ?? \"/auth\",\n        roleRequired: item.roleRequired ?? \"member\",\n      });\n    }\n  }\n\n  const pluginItems: SidebarItem[] = [];\n  if (runtimeConfig.plugins) {\n    for (const [key, entry] of Object.entries(runtimeConfig.plugins)) {\n      const sidebar = entry.sidebar;\n      if (!sidebar) continue;\n      for (const item of sidebar) {\n        pluginItems.push({\n          ...item,\n          to: item.to ?? `/${key}`,\n          roleRequired: item.roleRequired ?? \"member\",\n        });\n      }\n    }\n  }\n\n  const allItems = [...coreItems, ...pluginItems];\n  const moduleMap = collectIconImports(allItems);\n\n  const importLines: string[] = [];\n  for (const [module, icons] of moduleMap) {\n    const iconList = [...icons].join(\", \");\n    importLines.push(`import { ${iconList} } from \"${module}\";`);\n  }\n\n  const itemsCode = allItems\n    .map(\n      (item) =>\n        `  { icon: ${item.icon}, label: \"${item.label}\", to: \"${item.to}\" as const, roleRequired: \"${item.roleRequired}\" as const },`,\n    )\n    .join(\"\\n\");\n\n  return `// Auto-generated by bos sync/pluginAdd/pluginRemove. Do not edit.\n${importLines.join(\"\\n\")}\n\nexport type SidebarRole = \"anon\" | \"member\" | \"admin\";\n\nexport interface SidebarItem {\n  icon: React.ComponentType<{ className?: string }>;\n  label: string;\n  to: string;\n  roleRequired: SidebarRole;\n}\n\nexport const pluginSidebarItems: SidebarItem[] = [\n${itemsCode}\n];\n`;\n}\n\nexport function writePluginSidebarGen(configDir: string, runtimeConfig: RuntimeConfig): string {\n  const outputPath = join(configDir, \"ui/src/lib/plugin-sidebar.gen.ts\");\n\n  const content = generatePluginSidebarContent(runtimeConfig);\n\n  const outputDir = dirname(outputPath);\n  if (!existsSync(outputDir)) {\n    mkdirSync(outputDir, { recursive: true });\n  }\n\n  let existingContent: string | null = null;\n  try {\n    existingContent = existsSync(outputPath)\n      ? // eslint-disable-next-line no-restricted-syntax\n        readFileSync(outputPath, \"utf-8\")\n      : null;\n  } catch {\n    // file doesn't exist yet\n  }\n\n  if (existingContent === content) return outputPath;\n\n  writeFileSync(outputPath, content);\n  return outputPath;\n}\n"],"mappings":";;;;AAIA,MAAM,eAAuC;CAC3C,MAAM;CACN,OAAO;CACP,cAAc;CACd,WAAW;CACX,UAAU;CACV,MAAM;CACN,OAAO;CACP,QAAQ;CACR,iBAAiB;CACjB,YAAY;CACZ,MAAM;CACN,KAAK;CACL,UAAU;CACV,UAAU;CACV,UAAU;CACV,WAAW;CACX,KAAK;CACL,UAAU;CACV,MAAM;CACN,SAAS;CACT,OAAO;CACP,aAAa;CACb,QAAQ;CACR,OAAO;CACP,MAAM;CACN,MAAM;CACN,cAAc;CACd,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,WAAW;CACZ;AAED,SAAS,kBAAkB,UAA0B;AACnD,KAAI,aAAa,UAAW,QAAO,aAAa;AAChD,QAAO;;AAGT,SAAS,mBAAmB,OAAgD;CAC1E,MAAM,4BAAY,IAAI,KAA0B;AAChD,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,kBAAkB,KAAK,KAAK;AAC3C,MAAI,CAAC,UAAU,IAAI,OAAO,CAAE,WAAU,IAAI,wBAAQ,IAAI,KAAK,CAAC;AAC5D,YAAU,IAAI,OAAO,CAAE,IAAI,KAAK,KAAK;;AAEvC,QAAO;;AAGT,SAAgB,6BAA6B,eAAsC;CACjF,MAAM,YAA2B,CAC/B;EAAE,MAAM;EAAQ,OAAO;EAAQ,IAAI;EAAS,cAAc;EAAQ,CACnE;AAED,KAAI,cAAc,MAAM,QACtB,MAAK,MAAM,QAAQ,cAAc,KAAK,QACpC,WAAU,KAAK;EACb,GAAG;EACH,IAAI,KAAK,MAAM;EACf,cAAc,KAAK,gBAAgB;EACpC,CAAC;CAIN,MAAM,cAA6B,EAAE;AACrC,KAAI,cAAc,QAChB,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,cAAc,QAAQ,EAAE;EAChE,MAAM,UAAU,MAAM;AACtB,MAAI,CAAC,QAAS;AACd,OAAK,MAAM,QAAQ,QACjB,aAAY,KAAK;GACf,GAAG;GACH,IAAI,KAAK,MAAM,IAAI;GACnB,cAAc,KAAK,gBAAgB;GACpC,CAAC;;CAKR,MAAM,WAAW,CAAC,GAAG,WAAW,GAAG,YAAY;CAC/C,MAAM,YAAY,mBAAmB,SAAS;CAE9C,MAAM,cAAwB,EAAE;AAChC,MAAK,MAAM,CAAC,QAAQ,UAAU,WAAW;EACvC,MAAM,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK;AACtC,cAAY,KAAK,YAAY,SAAS,WAAW,OAAO,IAAI;;CAG9D,MAAM,YAAY,SACf,KACE,SACC,aAAa,KAAK,KAAK,YAAY,KAAK,MAAM,UAAU,KAAK,GAAG,6BAA6B,KAAK,aAAa,eAClH,CACA,KAAK,KAAK;AAEb,QAAO;EACP,YAAY,KAAK,KAAK,CAAC;;;;;;;;;;;;EAYvB,UAAU;;;;AAKZ,SAAgB,sBAAsB,WAAmB,eAAsC;CAC7F,MAAM,aAAa,KAAK,WAAW,mCAAmC;CAEtE,MAAM,UAAU,6BAA6B,cAAc;CAE3D,MAAM,YAAY,QAAQ,WAAW;AACrC,KAAI,CAAC,WAAW,UAAU,CACxB,WAAU,WAAW,EAAE,WAAW,MAAM,CAAC;CAG3C,IAAI,kBAAiC;AACrC,KAAI;AACF,oBAAkB,WAAW,WAAW,GAEpC,aAAa,YAAY,QAAQ,GACjC;SACE;AAIR,KAAI,oBAAoB,QAAS,QAAO;AAExC,eAAc,YAAY,QAAQ;AAClC,QAAO"}