anhedral 0.1.3 → 0.1.5

package/dist/templates/backend.d.ts

@@ -1,2 +1,2 @@
 import type { ProjectOptions } from '../scaffold.js';
-export declare function scaffoldBackend(root: string, { projectName, displayName, frontendUrl }: ProjectOptions): Promise<void>;
+export declare function scaffoldBackend(root: string, { projectName, displayName, frontendUrl, skipInstall }: ProjectOptions): Promise<void>;

package/dist/templates/backend.js

@@ -1,9 +1,10 @@
 import path from 'node:path';
-import { writeFile, exec } from '../util.js';
+import { writeFile, execCommand } from '../util.js';
 import { anhedralPrint } from '../print.js';
 import { getBackendInstallCommands } from '../commands.js';
-export async function scaffoldBackend(root, { projectName, displayName, frontendUrl }) {
-    const dir = path.join(root, 'apps/api');
+import { BACKEND_DEPENDENCIES } from '../dependencies.js';
+export async function scaffoldBackend(root, { projectName, displayName, frontendUrl, skipInstall }) {
+    const dir = path.join(root, 'Backend');
     anhedralPrint.section('Backend (Fastify)');
     anhedralPrint.step('Writing backend source files');
     writePackageJson(dir, projectName);
@@ -23,16 +24,17 @@ export async function scaffoldBackend(root, { projectName, displayName, frontend
     writeRepositories(dir);
     writeRoutes(dir, displayName);
     writeAppAndIndex(dir, displayName);
-    writeVercelEntry(dir);
+    writeVercelConfig(dir);
     writeTestFiles(dir);
     anhedralPrint.done('Backend source files written');
-    if (process.env.ANHEDRAL_SKIP_INSTALL === '1') {
-        anhedralPrint.info('Skipping backend dependency install (ANHEDRAL_SKIP_INSTALL=1)');
+    if (skipInstall) {
+        anhedralPrint.info('Skipping backend dependency install (--skip-install)');
+        anhedralPrint.info('Run after init: pnpm install');
         return;
     }
     anhedralPrint.step('Installing backend dependencies');
     for (const command of getBackendInstallCommands()) {
-        exec(command.cmd, dir);
+        execCommand(command.command, command.args, dir);
     }
     anhedralPrint.done('Backend dependencies installed');
 }
@@ -59,9 +61,8 @@ function writePackageJson(dir, projectName) {
         },
         keywords: [],
         license: 'MIT',
-        dependencies: {
-            '@anhedral/db': 'workspace:*',
-        },
+        dependencies: BACKEND_DEPENDENCIES.dependencies,
+        devDependencies: BACKEND_DEPENDENCIES.devDependencies,
     }, null, 2) + '\n');
 }
 function writeTsConfig(dir) {
@@ -1143,8 +1144,8 @@ const configPlugin: FastifyPluginAsync = async (fastify: FastifyInstance) => {
       R2_ACCESS_KEY_ID: { type: 'string', nullable: true },
       R2_SECRET_ACCESS_KEY: { type: 'string', nullable: true },
       R2_BUCKET: { type: 'string', nullable: true },
-      RC_SECRET_API_KEY: { type: 'string', default: '' },
-      RC_WEBHOOK_SECRET: { type: 'string', default: '' },
+      RC_SECRET_API_KEY: { type: 'string', nullable: true, default: '' },
+      RC_WEBHOOK_SECRET: { type: 'string', nullable: true, default: '' },
       RC_ENTITLEMENT_ID: { type: 'string', default: 'pro' },
       RC_OFFERING_ID: { type: 'string', default: 'default' },
     },
@@ -1155,6 +1156,23 @@ const configPlugin: FastifyPluginAsync = async (fastify: FastifyInstance) => {
     dotenv: !process.env.VERCEL,
     confKey: 'env',
   } as unknown as Record<string, unknown>);
+
+  if (fastify.env.NODE_ENV === 'production') {
+    if (fastify.env.ANHEDRAL_DEMO === 'true') {
+      throw new Error('ANHEDRAL_DEMO must be false in production');
+    }
+
+    const required = [
+      'CLERK_PUBLISHABLE_KEY',
+      'CLERK_SECRET_KEY',
+      'RC_SECRET_API_KEY',
+      'RC_WEBHOOK_SECRET',
+    ] as const;
+    const missing = required.filter((key) => !fastify.env[key]);
+    if (missing.length > 0) {
+      throw new Error(\`Missing production environment variables: \${missing.join(', ')}\`);
+    }
+  }
 };
 
 export default fp(configPlugin, { name: 'env-config', fastify: '5.x' });
@@ -2155,39 +2173,12 @@ main().catch((err) => {
 });
 `);
 }
-function writeVercelEntry(dir) {
-    writeFile(path.join(dir, 'api/index.ts'), `import type { VercelRequest, VercelResponse } from '@vercel/node';
-import type { FastifyInstance } from 'fastify';
-import { buildApp } from '../src/app.js';
-
-let appReadyPromise: Promise<FastifyInstance> | undefined;
-
-async function getApp(): Promise<FastifyInstance> {
-  if (!appReadyPromise) {
-    appReadyPromise = (async () => {
-      const app = await buildApp();
-      await app.ready();
-      return app;
-    })().catch((err) => {
-      appReadyPromise = undefined;
-      throw err;
-    });
-  }
-  return appReadyPromise;
-}
-
-export default async function handler(req: VercelRequest, res: VercelResponse) {
-  const app = await getApp();
-  if (req.url === '/api' || req.url === '/backend') {
-    req.url = '/';
-  } else if (req.url?.startsWith('/api/')) {
-    req.url = req.url.slice('/api'.length);
-  } else if (req.url?.startsWith('/backend/')) {
-    req.url = req.url.slice('/backend'.length);
-  }
-  app.server.emit('request', req, res);
-}
-`);
+function writeVercelConfig(dir) {
+    writeFile(path.join(dir, 'vercel.json'), JSON.stringify({
+        $schema: 'https://openapi.vercel.sh/vercel.json',
+        buildCommand: 'pnpm build',
+        devCommand: 'vercel dev',
+    }, null, 2) + '\n');
 }
 // ═══════════════════════════════════════════════════════════════════════════
 // Tests

package/dist/templates/extension.d.ts

@@ -1,2 +1,2 @@
 import type { ProjectOptions } from '../scaffold.js';
-export declare function scaffoldExtension(root: string, { projectName, displayName }: ProjectOptions): Promise<void>;
+export declare function scaffoldExtension(root: string, { projectName, displayName, skipInstall }: ProjectOptions): Promise<void>;

package/dist/templates/extension.js

@@ -2,21 +2,25 @@ import { rmSync } from 'node:fs';
 import path from 'node:path';
 import { writeFile, exec } from '../util.js';
 import { anhedralPrint } from '../print.js';
+import { EXTENSION_DEPENDENCIES } from '../dependencies.js';
 import { resolveToolchainChannel, resolveToolchain, toolPackageRef } from '../toolchain.js';
-export async function scaffoldExtension(root, { projectName, displayName }) {
-    const appsRoot = path.join(root, 'apps');
-    const dir = path.join(appsRoot, 'extension');
+export async function scaffoldExtension(root, { projectName, displayName, skipInstall }) {
+    const dir = path.join(root, 'Extension');
     const toolchain = resolveToolchain(resolveToolchainChannel(process.env.ANHEDRAL_TOOLCHAIN));
     anhedralPrint.section('Chrome extension (WXT)');
     anhedralPrint.step('Scaffolding WXT extension');
-    writeFile(path.join(appsRoot, '.gitkeep'), '');
-    exec(`pnpm dlx ${toolPackageRef('wxt', toolchain.wxt)} init extension -t react --pm pnpm`, appsRoot);
+    exec(`pnpm dlx --allow-build=esbuild --allow-build=spawn-sync ${toolPackageRef('wxt', toolchain.wxt)} init Extension -t react --pm pnpm`, root);
     writePackageJson(dir, projectName);
     anhedralPrint.done('WXT extension scaffolded');
     anhedralPrint.step('Installing Clerk + React + Tailwind dependencies');
-    exec(`pnpm add -D @types/chrome @types/react @types/react-dom @wxt-dev/module-react autoprefixer postcss tailwindcss@3.4.19 typescript@5.9.3 ${toolPackageRef('wxt', toolchain.wxt)}`, dir);
-    exec('pnpm add @clerk/chrome-extension react react-dom clsx tailwind-merge class-variance-authority lucide-react@0.468.0', dir);
-    anhedralPrint.done('Extension dependencies installed');
+    if (skipInstall) {
+        anhedralPrint.info('Skipping extension dependency install (--skip-install)');
+        anhedralPrint.info('Run after init: pnpm install');
+    }
+    else {
+        exec('pnpm install --no-frozen-lockfile', dir);
+    }
+    anhedralPrint.done(skipInstall ? 'Extension dependency manifests written' : 'Extension dependencies installed');
     cleanWxtStarterFiles(dir);
     writeWxtConfig(dir, displayName);
     writeTsConfig(dir);
@@ -27,6 +31,7 @@ export async function scaffoldExtension(root, { projectName, displayName }) {
     writeShadcnConfig(dir);
     writeReadme(dir, displayName);
     writeCnUtil(dir);
+    writeButtonComponent(dir);
     writeAuthContext(dir);
     writeApiClient(dir);
     writeBackground(dir);
@@ -35,10 +40,7 @@ export async function scaffoldExtension(root, { projectName, displayName }) {
     writeSidepanelHtml(dir, displayName);
     writeSidepanelApp(dir);
     writeStyles(dir);
-    anhedralPrint.step('Adding shadcn button component');
-    exec(`pnpm dlx ${toolPackageRef('shadcn', toolchain.shadcn)} add button`, dir);
-    writeStyles(dir);
-    anhedralPrint.done('shadcn button installed');
+    anhedralPrint.done('Extension source files written');
 }
 function cleanWxtStarterFiles(dir) {
     for (const relativePath of [
@@ -65,6 +67,8 @@ function writePackageJson(dir, projectName) {
             'zip:firefox': 'wxt zip -b firefox',
             typecheck: 'tsc --noEmit',
         },
+        dependencies: EXTENSION_DEPENDENCIES.dependencies,
+        devDependencies: EXTENSION_DEPENDENCIES.devDependencies,
     }, null, 2) + '\n');
 }
 function writeWxtConfig(dir, displayName) {
@@ -80,14 +84,23 @@ export default defineConfig({
       description: '${displayName} Chrome Extension',
       version: '0.1.0',
       ...(crxPublicKey ? { key: crxPublicKey } : {}),
-      permissions: ['activeTab', 'cookies', 'storage'],
+      minimum_chrome_version: '114',
+      permissions: ['activeTab', 'cookies', 'storage', 'sidePanel'],
       host_permissions: [],
       action: {
         default_title: 'Open ${displayName}',
       },
+      side_panel: {
+        default_path: 'sidepanel.html',
+      },
     };
   },
   modules: ['@wxt-dev/module-react'],
+  vite: () => ({
+    build: {
+      chunkSizeWarningLimit: 3000,
+    },
+  }),
 });
 `);
 }
@@ -108,7 +121,6 @@ function writeTsConfig(dir) {
             jsx: 'react-jsx',
             lib: ['DOM', 'DOM.Iterable', 'ESNext'],
             types: ['wxt/browser', '@wxt-dev/module-react', 'chrome'],
-            baseUrl: '.',
             paths: { '@/*': ['./src/*'] },
         },
         include: ['**/*.ts', '**/*.tsx', '.wxt/wxt.d.ts'],
@@ -190,6 +202,41 @@ export function cn(...inputs: ClassValue[]) {
 }
 `);
 }
+function writeButtonComponent(dir) {
+    writeFile(path.join(dir, 'src/components/ui/button.tsx'), `import * as React from 'react';
+import { cn } from '@/lib/utils';
+
+type ButtonVariant = 'default' | 'outline';
+
+export type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
+  variant?: ButtonVariant;
+};
+
+const variantClasses: Record<ButtonVariant, string> = {
+  default: 'bg-primary text-primary-foreground hover:bg-primary/90',
+  outline: 'border border-input bg-background hover:bg-accent hover:text-accent-foreground',
+};
+
+export const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant = 'default', type = 'button', ...props }, ref) => {
+    return (
+      <button
+        ref={ref}
+        type={type}
+        className={cn(
+          'inline-flex h-9 items-center justify-center whitespace-nowrap rounded-md px-4 py-2 text-sm font-medium transition-colors disabled:pointer-events-none disabled:opacity-50',
+          variantClasses[variant],
+          className,
+        )}
+        {...props}
+      />
+    );
+  },
+);
+
+Button.displayName = 'Button';
+`);
+}
 function writeTailwindConfig(dir) {
     writeFile(path.join(dir, 'tailwind.config.cjs'), `/** @type {import('tailwindcss').Config} */
 module.exports = {
@@ -261,7 +308,7 @@ Set \`VITE_CLERK_PUBLISHABLE_KEY\` and \`VITE_API_URL\` in \`.env\` before using
 
 Run \`pnpm build\`, then load \`.output/chrome-mv3\` as an unpacked extension from \`chrome://extensions\`.
 
-The browser action opens the side panel. The background script initializes Clerk, the side panel handles sign-in/subscription state, and the content script is ready for page-to-extension messages.
+The extension uses Chrome's Side Panel API. The browser action opens \`sidepanel.html\`, \`wxt.config.ts\` declares the \`sidePanel\` permission and Chrome 114+ minimum version, the background script initializes Clerk, and the content script is ready for page-to-extension messages.
 `);
 }
 function writeAuthContext(dir) {
@@ -405,58 +452,25 @@ export { WEBSITE_URL };
 `);
 }
 function writeApiClient(dir) {
-    writeFile(path.join(dir, 'src/lib/api.ts'), `const API_BASE_URL = import.meta.env.VITE_API_URL || 'http://localhost:8787';
-
-export type SubscriptionEntitlements = {
-  pro: boolean;
-  inTrial: boolean;
-  trialEndsAt?: string;
-  expiresAt?: string;
-  periodStart?: string;
-  periodEnd?: string;
-  method?: 'trialing' | 'redeemed' | 'paid' | null;
-  managementUrl?: string;
-  cancelAtPeriodEnd?: boolean;
-};
+    writeFile(path.join(dir, 'src/lib/api.ts'), `import { ApiClient } from '@anhedral/api-client';
 
 export class APIClient {
   constructor(private getToken: () => Promise<string | null>) {}
 
-  private async request<T>(endpoint: string, options: RequestInit = {}): Promise<T> {
-    const token = await this.getToken();
-    if (!token) throw new Error('Not authenticated');
-
-    const headers: Record<string, string> = {
-      Authorization: \`Bearer \${token}\`,
-      'Content-Type': 'application/json',
-      'X-Client-Type': 'chrome-extension',
-      'X-Platform': 'chrome',
-      ...(options.headers as Record<string, string>),
-    };
-
-    const response = await fetch(\`\${API_BASE_URL}\${endpoint}\`, { ...options, headers });
-
-    if (!response.ok) {
-      let error: { message?: string } = {};
-      try { error = await response.json(); } catch {}
-      throw new Error(error.message || \`Request failed (\${response.status})\`);
-    }
-
-    if (response.status === 204) return {} as T;
-    return response.json();
+  private client() {
+    return new ApiClient({
+      baseUrl: import.meta.env.VITE_API_URL || 'http://localhost:8787',
+      getToken: this.getToken,
+      platform: 'extension',
+    });
   }
 
-  async getMe() {
-    return this.request<{
-      user: { id: string; email: string; subscriptionTier: string; subscriptionStatus: string };
-    }>('/auth/me');
+  getMe() {
+    return this.client().getMe();
   }
 
-  async getSubscriptionEntitlements(options?: { refresh?: boolean }): Promise<SubscriptionEntitlements> {
-    const path = options?.refresh
-      ? '/subscriptions/entitlements/me?refresh=true'
-      : '/subscriptions/entitlements/me';
-    return this.request<SubscriptionEntitlements>(path);
+  getSubscriptionEntitlements(options?: { refresh?: boolean }) {
+    return this.client().getSubscriptionEntitlements(options);
   }
 }
 `);
@@ -464,15 +478,20 @@ export class APIClient {
 function writeBackground(dir) {
     writeFile(path.join(dir, 'src/entrypoints/background.ts'), `import { createClerkClient } from '@clerk/chrome-extension/background';
 
+type ChromeWithSidePanel = typeof chrome & {
+  sidePanel: {
+    setPanelBehavior: (behavior: { openPanelOnActionClick: boolean }) => Promise<void>;
+  };
+};
+
 export default defineBackground(() => {
   // Initialize Clerk in the background script for cookie-based auth
   void createClerkClient({
     publishableKey: import.meta.env.VITE_CLERK_PUBLISHABLE_KEY || '',
   }).catch(() => {});
 
-  // Open the side panel when the extension icon is clicked
-  // The sidePanel permission is auto-added by WXT when the sidepanel entrypoint exists
-  chrome.sidePanel
+  // Open the side panel when the extension icon is clicked.
+  (chrome as ChromeWithSidePanel).sidePanel
     .setPanelBehavior({ openPanelOnActionClick: true })
     .catch(() => {});
 });

package/dist/templates/frontend.d.ts

@@ -1,2 +1,2 @@
 import type { ProjectOptions } from '../scaffold.js';
-export declare function scaffoldFrontend(root: string, { projectName, displayName }: ProjectOptions): Promise<void>;
+export declare function scaffoldFrontend(root: string, { projectName, displayName, skipInstall }: ProjectOptions): Promise<void>;