@vaiftech/cli 1.2.0 → 1.3.1

package/dist/chunk-7XA2HKEQ.js

@@ -0,0 +1,2067 @@
+import h from'fs';import w from'path';import L from'dotenv';import M from'pg';import j from'ora';import o from'chalk';import O from'prettier';import F from'readline';L.config();async function T(r){let t=w.resolve(r);if(!h.existsSync(t))return null;try{let a=h.readFileSync(t,"utf-8"),e=JSON.parse(a);return e.database?.url&&(e.database.url=A(e.database.url)),e.api?.apiKey&&(e.api.apiKey=A(e.api.apiKey)),e}catch{throw new Error(`Failed to parse config file: ${r}`)}}function A(r){return r.replace(/\$\{([^}]+)\}/g,(t,a)=>process.env[a]||t)}async function N(r,t){let a=await r.query(`
+    SELECT table_name, table_type
+    FROM information_schema.tables
+    WHERE table_schema = $1
+      AND table_type = 'BASE TABLE'
+    ORDER BY table_name
+  `,[t]),e=await r.query(`
+    SELECT
+      table_name,
+      column_name,
+      data_type,
+      is_nullable,
+      column_default,
+      udt_name,
+      is_identity,
+      character_maximum_length,
+      numeric_precision,
+      numeric_scale
+    FROM information_schema.columns
+    WHERE table_schema = $1
+    ORDER BY table_name, ordinal_position
+  `,[t]),i=await r.query(`
+    SELECT
+      tc.constraint_name,
+      tc.table_name,
+      kcu.column_name,
+      ccu.table_name AS foreign_table_name,
+      ccu.column_name AS foreign_column_name
+    FROM information_schema.table_constraints AS tc
+    JOIN information_schema.key_column_usage AS kcu
+      ON tc.constraint_name = kcu.constraint_name
+      AND tc.table_schema = kcu.table_schema
+    JOIN information_schema.constraint_column_usage AS ccu
+      ON ccu.constraint_name = tc.constraint_name
+      AND ccu.table_schema = tc.table_schema
+    WHERE tc.constraint_type = 'FOREIGN KEY'
+      AND tc.table_schema = $1
+  `,[t]),s=await r.query(`
+    SELECT
+      t.typname as enum_name,
+      e.enumlabel as enum_value
+    FROM pg_type t
+    JOIN pg_enum e ON t.oid = e.enumtypid
+    JOIN pg_namespace n ON n.oid = t.typnamespace
+    WHERE n.nspname = $1
+    ORDER BY t.typname, e.enumsortorder
+  `,[t]),c=new Map;for(let n of a.rows)c.set(n.table_name,[]);for(let n of e.rows){let p=c.get(n.table_name);p&&p.push(n);}let l=new Map;for(let n of s.rows){let p=l.get(n.enum_name)||[];p.push(n.enum_value),l.set(n.enum_name,p);}return {tables:c,enums:l,foreignKeys:i.rows}}var x={smallint:"number",integer:"number",bigint:"string",int2:"number",int4:"number",int8:"string",decimal:"string",numeric:"string",real:"number",float4:"number",float8:"number","double precision":"number",money:"string",boolean:"boolean",bool:"boolean",text:"string",varchar:"string",char:"string",character:"string","character varying":"string",name:"string",citext:"string",date:"string",time:"string",timetz:"string","time without time zone":"string","time with time zone":"string",timestamp:"string",timestamptz:"string","timestamp without time zone":"string","timestamp with time zone":"string",interval:"string",bytea:"Buffer",uuid:"string",json:"unknown",jsonb:"unknown",inet:"string",cidr:"string",macaddr:"string",macaddr8:"string",point:"{ x: number; y: number }",line:"string",lseg:"string",box:"string",path:"string",polygon:"string",circle:"string",ARRAY:"unknown[]"};function K(r,t){let{data_type:a,udt_name:e,is_nullable:i}=r;if(t.has(e)){let l=t.get(e).map(n=>`"${n}"`).join(" | ");return i==="YES"?`(${l}) | null`:l}if(a==="ARRAY"){let c=e.replace(/^_/,"");if(t.has(c)){let p=t.get(c).map(u=>`"${u}"`).join(" | ");return i==="YES"?`(${p})[] | null`:`(${p})[]`}let l=x[c]||"unknown";return i==="YES"?`${l}[] | null`:`${l}[]`}let s=x[a]||x[e]||"unknown";return i==="YES"&&(s=`${s} | null`),s}function E(r){return r.split(/[_\-\s]+/).map(t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()).join("")}function $(r,t){let a=E(r),e=t.map(i=>`  | "${i}"`).join(`
+`);return `export type ${a} =
+${e};`}function B(r,t,a){let e=E(r),i=[],s=[],c=[];for(let u of t){let f=K(u,a),v=u.column_name,k=u.column_default!==null||u.is_identity==="YES",U=u.is_nullable==="YES";i.push(`  ${v}: ${f};`),k||u.column_name==="id"?s.push(`  ${v}?: ${f.replace(" | null","")} | null;`):U?s.push(`  ${v}?: ${f};`):s.push(`  ${v}: ${f.replace(" | null","")};`),c.push(`  ${v}?: ${f.replace(" | null","")} | null;`);}let l=`export interface ${e} {
+${i.join(`
+`)}
+}`,n=`export interface ${e}Insert {
+${s.join(`
+`)}
+}`,p=`export interface ${e}Update {
+${c.join(`
+`)}
+}`;return {base:l,insert:n,update:p}}function Y(r,t,a){let e=["/**"," * Auto-generated TypeScript types from database schema"," * Generated by @vaiftech/cli",` * Generated at: ${new Date().toISOString()}`," * "," * DO NOT EDIT MANUALLY - changes will be overwritten"," */",""];if(t.size>0){e.push("// ============ ENUMS ============"),e.push("");for(let[s,c]of t)e.push($(s,c)),e.push("");}e.push("// ============ TABLES ============"),e.push("");let i=[];for(let[s,c]of r){let{base:l,insert:n,update:p}=B(s,c,t);i.push(s),e.push(l),e.push(""),e.push(n),e.push(""),e.push(p),e.push("");}e.push("// ============ DATABASE SCHEMA ============"),e.push(""),e.push("export interface Database {");for(let s of i){let c=E(s);e.push(`  ${s}: {`),e.push(`    Row: ${c};`),e.push(`    Insert: ${c}Insert;`),e.push(`    Update: ${c}Update;`),e.push("  };");}return e.push("}"),e.push(""),e.push("export type TableName = keyof Database;"),e.push(""),e.push("// ============ HELPER TYPES ============"),e.push(""),e.push('export type Row<T extends TableName> = Database[T]["Row"];'),e.push('export type Insert<T extends TableName> = Database[T]["Insert"];'),e.push('export type Update<T extends TableName> = Database[T]["Update"];'),e.push(""),e.join(`
+`)}async function ie(r){let t=j("Loading configuration...").start();try{let a=await T(r.config),e=r.connection||a?.database?.url||process.env.DATABASE_URL;e||(t.fail("No database connection string provided"),console.log(o.yellow(`
+Provide a connection string via:`)),console.log(o.gray("  --connection <url>")),console.log(o.gray("  DATABASE_URL environment variable")),console.log(o.gray("  vaif.config.json database.url")),process.exit(1)),t.text="Connecting to database...";let i=new M.Client({connectionString:e});await i.connect(),t.text="Introspecting schema...";let{tables:s,enums:c,foreignKeys:l}=await N(i,r.schema);if(await i.end(),s.size===0){t.warn(`No tables found in schema "${r.schema}"`);return}t.text=`Generating types for ${s.size} tables...`;let n=Y(s,c,l),p=await O.format(n,{parser:"typescript",semi:!0,singleQuote:!1,trailingComma:"es5",printWidth:100});if(r.dryRun){t.succeed("Generated types (dry run):"),console.log(""),console.log(o.gray("\u2500".repeat(60))),console.log(p),console.log(o.gray("\u2500".repeat(60)));return}let u=w.resolve(r.output),f=w.dirname(u);h.existsSync(f)||h.mkdirSync(f,{recursive:!0}),h.writeFileSync(u,p,"utf-8"),t.succeed(`Generated types for ${s.size} tables \u2192 ${o.cyan(r.output)}`),console.log(""),console.log(o.green("Generated:")),console.log(o.gray(`  Tables: ${s.size}`)),console.log(o.gray(`  Enums: ${c.size}`)),console.log(""),console.log(o.gray("Import in your code:")),console.log(o.cyan(`  import type { Database, Row, Insert, Update } from "${r.output.replace(/\.ts$/,"")}";`));}catch(a){t.fail("Failed to generate types"),a instanceof Error&&(console.error(o.red(`
+Error: ${a.message}`)),a.message.includes("ECONNREFUSED")&&console.log(o.yellow(`
+Make sure your database is running and accessible.`))),process.exit(1);}}var g=[{name:"database",label:"Database",description:"CRUD queries, type-safe operations"},{name:"auth",label:"Authentication",description:"login, signup, OAuth, sessions"},{name:"realtime",label:"Realtime",description:"live subscriptions, presence"},{name:"storage",label:"Storage",description:"file uploads, signed URLs"},{name:"functions",label:"Functions",description:"serverless function calls"}],R={"nextjs-fullstack":{name:"Next.js Full-Stack",description:"Next.js app with server/client VAIF client, auth middleware, and React hooks",tag:"Next.js",defaultFeatures:["database","auth"],files:[{path:"package.json",content:`{
+  "name": "my-vaif-app",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@vaiftech/client": "^1.0.0",
+    "@vaiftech/auth": "^1.0.0",
+    "@vaiftech/react": "^1.0.0",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "typescript": "^5.7.0"
+  }
+}
+`},{path:"tsconfig.json",content:`{
+  "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,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
+`},{path:"next.config.ts",content:`import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {};
+
+export default nextConfig;
+`},{path:"app/layout.tsx",content:`import type { Metadata } from "next";
+import { VaifProvider } from "@vaiftech/react";
+import { vaif } from "@/lib/vaif";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "My VAIF App",
+  description: "Built with VAIF Studio",
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <VaifProvider client={vaif}>{children}</VaifProvider>
+      </body>
+    </html>
+  );
+}
+`},{path:"app/page.tsx",content:`export default function Home() {
+  return (
+    <main style={{ maxWidth: 600, margin: "80px auto", textAlign: "center" }}>
+      <h1>Welcome to VAIF</h1>
+      <p>Your Next.js app is ready. Start building!</p>
+    </main>
+  );
+}
+`},{path:"app/globals.css",content:`*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+`},{path:"lib/vaif.ts",content:`import { createClient } from "@vaiftech/client";
+import { createServerClient } from "@vaiftech/client/server";
+
+// Browser client \u2013 safe to use in Client Components
+export const vaif = createClient({
+  projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+  apiKey: process.env.NEXT_PUBLIC_VAIF_API_KEY!,
+});
+
+// Server client \u2013 use in Server Components, Route Handlers, Server Actions
+export function createVaifServer() {
+  return createServerClient({
+    projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+    secretKey: process.env.VAIF_SECRET_KEY!,
+  });
+}
+`},{path:".env.local.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+NEXT_PUBLIC_VAIF_PROJECT_ID=your-project-id
+NEXT_PUBLIC_VAIF_API_KEY=your-anon-key
+VAIF_SECRET_KEY=your-secret-key
+`},{path:".gitignore",content:`node_modules
+.next
+out
+.env
+.env.local
+*.local
+`}],featureFiles:{auth:[{path:"middleware.ts",content:`import { NextResponse, type NextRequest } from "next/server";
+import { createServerClient } from "@vaiftech/client/server";
+import { authMiddleware } from "@vaiftech/auth/nextjs";
+
+const protectedRoutes = ["/dashboard", "/settings", "/api/protected"];
+
+export async function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl;
+  const isProtected = protectedRoutes.some((route) => pathname.startsWith(route));
+  if (!isProtected) return NextResponse.next();
+
+  const vaif = createServerClient({
+    projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+    secretKey: process.env.VAIF_SECRET_KEY!,
+  });
+
+  return authMiddleware(vaif, request, {
+    loginRedirect: "/login",
+    onUnauthenticated: () => {
+      const loginUrl = new URL("/login", request.url);
+      loginUrl.searchParams.set("redirect", pathname);
+      return NextResponse.redirect(loginUrl);
+    },
+  });
+}
+
+export const config = {
+  matcher: ["/dashboard/:path*", "/settings/:path*", "/api/protected/:path*"],
+};
+`},{path:"app/(auth)/login/page.tsx",content:`"use client";
+
+import { useState } from "react";
+import { useRouter } from "next/navigation";
+import { vaif } from "@/lib/vaif";
+
+export default function LoginPage() {
+  const router = useRouter();
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setLoading(true);
+    setError(null);
+
+    const { error } = await vaif.auth.signInWithPassword({ email, password });
+    if (error) {
+      setError(error.message);
+      setLoading(false);
+    } else {
+      router.push("/dashboard");
+    }
+  }
+
+  return (
+    <div style={{ maxWidth: 400, margin: "80px auto" }}>
+      <h1>Log In</h1>
+      <form onSubmit={handleSubmit}>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="email">Email</label>
+          <input id="email" type="email" value={email} onChange={(e) => setEmail(e.target.value)} required style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="password">Password</label>
+          <input id="password" type="password" value={password} onChange={(e) => setPassword(e.target.value)} required style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        {error && <p style={{ color: "red" }}>{error}</p>}
+        <button type="submit" disabled={loading} style={{ padding: "8px 24px" }}>
+          {loading ? "Logging in..." : "Log In"}
+        </button>
+      </form>
+    </div>
+  );
+}
+`},{path:"app/(auth)/signup/page.tsx",content:`"use client";
+
+import { useState } from "react";
+import { useRouter } from "next/navigation";
+import { vaif } from "@/lib/vaif";
+
+export default function SignupPage() {
+  const router = useRouter();
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setLoading(true);
+    setError(null);
+
+    const { error } = await vaif.auth.signUp({ email, password });
+    if (error) {
+      setError(error.message);
+      setLoading(false);
+    } else {
+      router.push("/");
+    }
+  }
+
+  return (
+    <div style={{ maxWidth: 400, margin: "80px auto" }}>
+      <h1>Sign Up</h1>
+      <form onSubmit={handleSubmit}>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="email">Email</label>
+          <input id="email" type="email" value={email} onChange={(e) => setEmail(e.target.value)} required style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="password">Password</label>
+          <input id="password" type="password" value={password} onChange={(e) => setPassword(e.target.value)} required minLength={8} style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        {error && <p style={{ color: "red" }}>{error}</p>}
+        <button type="submit" disabled={loading} style={{ padding: "8px 24px" }}>
+          {loading ? "Creating account..." : "Sign Up"}
+        </button>
+      </form>
+    </div>
+  );
+}
+`}],storage:[{path:"lib/storage.ts",content:`import { createVaifServer } from "./vaif";
+
+export async function uploadFile(bucket: string, file: Buffer | Blob, filePath: string) {
+  const vaif = createVaifServer();
+  const { data, error } = await vaif.storage.from(bucket).upload(filePath, file);
+  if (error) throw error;
+  const { data: urlData } = vaif.storage.from(bucket).getPublicUrl(data.path);
+  return { path: data.path, publicUrl: urlData.publicUrl };
+}
+
+export async function getSignedUrl(bucket: string, filePath: string, expiresIn = 3600) {
+  const vaif = createVaifServer();
+  const { data, error } = await vaif.storage.from(bucket).createSignedUrl(filePath, expiresIn);
+  if (error) throw error;
+  return data.signedUrl;
+}
+`},{path:"app/api/upload/route.ts",content:`import { NextRequest, NextResponse } from "next/server";
+import { uploadFile } from "@/lib/storage";
+
+export async function POST(request: NextRequest) {
+  const formData = await request.formData();
+  const file = formData.get("file") as Blob | null;
+  if (!file) return NextResponse.json({ error: "No file provided" }, { status: 400 });
+
+  const fileName = (formData.get("fileName") as string) || "upload";
+  const bucket = (formData.get("bucket") as string) || "uploads";
+  const filePath = \`\${Date.now()}-\${fileName}\`;
+
+  const result = await uploadFile(bucket, file, filePath);
+  return NextResponse.json(result);
+}
+`}],realtime:[{path:"hooks/useRealtime.ts",content:`"use client";
+
+import { useEffect, useState, useCallback } from "react";
+import { vaif } from "@/lib/vaif";
+
+interface UseRealtimeOptions<T> {
+  table: string;
+  schema?: string;
+  filter?: string;
+  initialData?: T[];
+}
+
+export function useRealtime<T extends { id: string }>({
+  table,
+  schema = "public",
+  filter,
+  initialData = [],
+}: UseRealtimeOptions<T>) {
+  const [data, setData] = useState<T[]>(initialData);
+
+  useEffect(() => {
+    vaif.from(table).select("*").then(({ data: rows }) => {
+      if (rows) setData(rows as T[]);
+    });
+  }, [table]);
+
+  useEffect(() => {
+    const channelConfig: Record<string, string> = { event: "*", schema, table };
+    if (filter) channelConfig.filter = filter;
+
+    const channel = vaif
+      .channel(\`\${table}-changes\`)
+      .on("postgres_changes", channelConfig, (payload) => {
+        if (payload.eventType === "INSERT") {
+          setData((prev) => [...prev, payload.new as T]);
+        } else if (payload.eventType === "UPDATE") {
+          setData((prev) => prev.map((item) => (item.id === (payload.new as T).id ? (payload.new as T) : item)));
+        } else if (payload.eventType === "DELETE") {
+          setData((prev) => prev.filter((item) => item.id !== (payload.old as T).id));
+        }
+      })
+      .subscribe();
+
+    return () => { channel.unsubscribe(); };
+  }, [table, schema, filter]);
+
+  const refresh = useCallback(async () => {
+    const { data: rows } = await vaif.from(table).select("*");
+    if (rows) setData(rows as T[]);
+  }, [table]);
+
+  return { data, refresh };
+}
+`}]},dependencies:["@vaiftech/client","@vaiftech/auth","@vaiftech/react","next","react","react-dom"],devDependencies:["@types/node","@types/react","@types/react-dom","typescript"],postInstructions:["cd my-vaif-app","npm install","# Copy .env.local.example to .env.local and add your VAIF credentials","npm run dev"]},"react-spa":{name:"React SPA",description:"Single-page React app with Vite, VAIF client, and provider wrapper",tag:"React + Vite",defaultFeatures:["database","auth"],files:[{path:"package.json",content:`{
+  "name": "my-vaif-app",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@vaiftech/client": "^1.0.0",
+    "@vaiftech/react": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.4.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  }
+}
+`},{path:"tsconfig.json",content:`{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src"]
+}
+`},{path:"vite.config.ts",content:`import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import path from "path";
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+});
+`},{path:"index.html",content:`<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>My VAIF App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`},{path:"src/main.tsx",content:`import React from "react";
+import ReactDOM from "react-dom/client";
+import { BrowserRouter } from "react-router-dom";
+import { VaifProvider } from "@vaiftech/react";
+import { vaif } from "./lib/vaif";
+import App from "./App";
+
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <BrowserRouter>
+      <VaifProvider client={vaif}>
+        <App />
+      </VaifProvider>
+    </BrowserRouter>
+  </React.StrictMode>,
+);
+`},{path:"src/App.tsx",content:`import { Routes, Route } from "react-router-dom";
+
+export default function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<Home />} />
+    </Routes>
+  );
+}
+
+function Home() {
+  return (
+    <div style={{ maxWidth: 600, margin: "80px auto", textAlign: "center" }}>
+      <h1>Welcome to VAIF</h1>
+      <p>Your app is ready. Start building!</p>
+    </div>
+  );
+}
+`},{path:"src/lib/vaif.ts",content:`import { createClient } from "@vaiftech/client";
+
+export const vaif = createClient({
+  projectId: import.meta.env.VITE_VAIF_PROJECT_ID,
+  apiKey: import.meta.env.VITE_VAIF_API_KEY,
+});
+`},{path:"src/vite-env.d.ts",content:`/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_VAIF_PROJECT_ID: string;
+  readonly VITE_VAIF_API_KEY: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+VITE_VAIF_PROJECT_ID=your-project-id
+VITE_VAIF_API_KEY=your-anon-key
+`},{path:".gitignore",content:`node_modules
+dist
+.env
+.env.local
+*.local
+`}],featureFiles:{auth:[{path:"src/pages/Login.tsx",content:`import { useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { vaif } from "../lib/vaif";
+
+export default function Login() {
+  const navigate = useNavigate();
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setLoading(true);
+    setError(null);
+
+    const { error } = await vaif.auth.signInWithPassword({ email, password });
+    if (error) {
+      setError(error.message);
+      setLoading(false);
+    } else {
+      navigate("/");
+    }
+  }
+
+  return (
+    <div style={{ maxWidth: 400, margin: "80px auto" }}>
+      <h1>Log In</h1>
+      <form onSubmit={handleSubmit}>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="email">Email</label>
+          <input id="email" type="email" value={email} onChange={(e) => setEmail(e.target.value)} required style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="password">Password</label>
+          <input id="password" type="password" value={password} onChange={(e) => setPassword(e.target.value)} required style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        {error && <p style={{ color: "red" }}>{error}</p>}
+        <button type="submit" disabled={loading} style={{ padding: "8px 24px" }}>
+          {loading ? "Logging in..." : "Log In"}
+        </button>
+      </form>
+    </div>
+  );
+}
+`},{path:"src/pages/Signup.tsx",content:`import { useState } from "react";
+import { useNavigate } from "react-router-dom";
+import { vaif } from "../lib/vaif";
+
+export default function Signup() {
+  const navigate = useNavigate();
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setLoading(true);
+    setError(null);
+
+    const { error } = await vaif.auth.signUp({ email, password });
+    if (error) {
+      setError(error.message);
+      setLoading(false);
+    } else {
+      navigate("/");
+    }
+  }
+
+  return (
+    <div style={{ maxWidth: 400, margin: "80px auto" }}>
+      <h1>Sign Up</h1>
+      <form onSubmit={handleSubmit}>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="email">Email</label>
+          <input id="email" type="email" value={email} onChange={(e) => setEmail(e.target.value)} required style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        <div style={{ marginBottom: 12 }}>
+          <label htmlFor="password">Password</label>
+          <input id="password" type="password" value={password} onChange={(e) => setPassword(e.target.value)} required minLength={8} style={{ display: "block", width: "100%", padding: 8 }} />
+        </div>
+        {error && <p style={{ color: "red" }}>{error}</p>}
+        <button type="submit" disabled={loading} style={{ padding: "8px 24px" }}>
+          {loading ? "Creating account..." : "Sign Up"}
+        </button>
+      </form>
+    </div>
+  );
+}
+`},{path:"src/components/AuthGuard.tsx",content:`import { useEffect, useState, type ReactNode } from "react";
+import { useNavigate } from "react-router-dom";
+import { vaif } from "../lib/vaif";
+
+interface AuthGuardProps {
+  children: ReactNode;
+  fallback?: ReactNode;
+}
+
+export function AuthGuard({ children, fallback }: AuthGuardProps) {
+  const navigate = useNavigate();
+  const [loading, setLoading] = useState(true);
+  const [authenticated, setAuthenticated] = useState(false);
+
+  useEffect(() => {
+    vaif.auth.getSession().then(({ data }) => {
+      if (data.session) {
+        setAuthenticated(true);
+      } else {
+        navigate("/login");
+      }
+      setLoading(false);
+    });
+
+    const { data: { subscription } } = vaif.auth.onAuthStateChange((_event, session) => {
+      setAuthenticated(!!session);
+      if (!session) navigate("/login");
+    });
+
+    return () => subscription.unsubscribe();
+  }, [navigate]);
+
+  if (loading) return fallback ?? <div>Loading...</div>;
+  if (!authenticated) return null;
+  return <>{children}</>;
+}
+`}],storage:[{path:"src/hooks/useFileUpload.ts",content:`import { useState, useCallback } from "react";
+import { vaif } from "../lib/vaif";
+
+interface UploadResult {
+  path: string;
+  publicUrl: string;
+}
+
+interface UseFileUploadOptions {
+  bucket?: string;
+  folder?: string;
+}
+
+export function useFileUpload({ bucket = "uploads", folder = "" }: UseFileUploadOptions = {}) {
+  const [uploading, setUploading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const upload = useCallback(
+    async (file: File): Promise<UploadResult | null> => {
+      setUploading(true);
+      setError(null);
+
+      const filePath = folder
+        ? \`\${folder}/\${Date.now()}-\${file.name}\`
+        : \`\${Date.now()}-\${file.name}\`;
+
+      const { data, error: uploadError } = await vaif.storage
+        .from(bucket)
+        .upload(filePath, file);
+
+      if (uploadError) {
+        setError(uploadError.message);
+        setUploading(false);
+        return null;
+      }
+
+      const { data: urlData } = vaif.storage.from(bucket).getPublicUrl(data.path);
+
+      setUploading(false);
+      return { path: data.path, publicUrl: urlData.publicUrl };
+    },
+    [bucket, folder],
+  );
+
+  return { upload, uploading, error };
+}
+`}],realtime:[{path:"src/hooks/useRealtimeSubscription.ts",content:`import { useEffect, useState, useCallback } from "react";
+import { vaif } from "../lib/vaif";
+
+interface UseRealtimeOptions<T> {
+  table: string;
+  schema?: string;
+  filter?: string;
+  initialData?: T[];
+}
+
+export function useRealtimeSubscription<T extends { id: string }>({
+  table,
+  schema = "public",
+  filter,
+  initialData = [],
+}: UseRealtimeOptions<T>) {
+  const [data, setData] = useState<T[]>(initialData);
+
+  useEffect(() => {
+    // Load initial data
+    let query = vaif.from(table).select("*");
+    query.then(({ data: rows }) => {
+      if (rows) setData(rows as T[]);
+    });
+  }, [table]);
+
+  useEffect(() => {
+    const channelConfig: Record<string, string> = {
+      event: "*",
+      schema,
+      table,
+    };
+    if (filter) channelConfig.filter = filter;
+
+    const channel = vaif
+      .channel(\`\${table}-changes\`)
+      .on("postgres_changes", channelConfig, (payload) => {
+        if (payload.eventType === "INSERT") {
+          setData((prev) => [...prev, payload.new as T]);
+        } else if (payload.eventType === "UPDATE") {
+          setData((prev) =>
+            prev.map((item) => (item.id === (payload.new as T).id ? (payload.new as T) : item)),
+          );
+        } else if (payload.eventType === "DELETE") {
+          setData((prev) => prev.filter((item) => item.id !== (payload.old as T).id));
+        }
+      })
+      .subscribe();
+
+    return () => {
+      channel.unsubscribe();
+    };
+  }, [table, schema, filter]);
+
+  const refresh = useCallback(async () => {
+    const { data: rows } = await vaif.from(table).select("*");
+    if (rows) setData(rows as T[]);
+  }, [table]);
+
+  return { data, refresh };
+}
+`}]},dependencies:["@vaiftech/client","@vaiftech/react","react","react-dom","react-router-dom"],devDependencies:["@types/react","@types/react-dom","@vitejs/plugin-react","typescript","vite"],postInstructions:["cd my-vaif-app","npm install","# Copy .env.example to .env and add your VAIF credentials","npm run dev"]},"ios-swift-app":{name:"iOS Swift App",description:"Swift client manager for iOS/macOS apps using Swift Package Manager",tag:"Swift / iOS",defaultFeatures:["database","auth"],files:[{path:"VaifManager.swift",content:`import Foundation
+import VaifClient
+
+/// Singleton manager for the VAIF client.
+/// Add your project ID and API key in the initialiser or load from a config file.
+@MainActor
+final class VaifManager: ObservableObject {
+    static let shared = VaifManager()
+
+    let client: VaifClient
+
+    @Published var isAuthenticated = false
+
+    private init() {
+        guard
+            let projectId = ProcessInfo.processInfo.environment["VAIF_PROJECT_ID"]
+                ?? Bundle.main.infoDictionary?["VAIF_PROJECT_ID"] as? String,
+            let apiKey = ProcessInfo.processInfo.environment["VAIF_API_KEY"]
+                ?? Bundle.main.infoDictionary?["VAIF_API_KEY"] as? String
+        else {
+            fatalError("VAIF_PROJECT_ID and VAIF_API_KEY must be set")
+        }
+
+        self.client = VaifClient(
+            projectId: projectId,
+            apiKey: apiKey
+        )
+    }
+
+    // MARK: - Auth helpers
+
+    func signIn(email: String, password: String) async throws {
+        try await client.auth.signIn(email: email, password: password)
+        isAuthenticated = true
+    }
+
+    func signOut() async throws {
+        try await client.auth.signOut()
+        isAuthenticated = false
+    }
+
+    // MARK: - Database helpers
+
+    func query<T: Decodable>(_ table: String, type: T.Type) async throws -> [T] {
+        return try await client.from(table).select().execute().value
+    }
+
+    func insert<T: Encodable>(_ table: String, values: T) async throws {
+        try await client.from(table).insert(values).execute()
+    }
+}
+`},{path:".env.example",content:`# VAIF Configuration
+# Add these to your Xcode scheme environment variables or Info.plist
+
+VAIF_PROJECT_ID=your-project-id
+VAIF_API_KEY=your-anon-key
+`},{path:"README-VAIF.md",content:`# VAIF Swift Setup
+
+## 1. Add the Swift Package
+
+In Xcode: **File \u2192 Add Package Dependencies\u2026**
+
+Enter the repository URL:
+\`\`\`
+https://github.com/vaif-technologies/vaif-swift
+\`\`\`
+
+Select the **VaifClient** library and add it to your target.
+
+## 2. Configure Environment
+
+Add your project credentials to your Xcode scheme:
+
+1. Edit Scheme \u2192 Run \u2192 Arguments \u2192 Environment Variables
+2. Add \`VAIF_PROJECT_ID\` and \`VAIF_API_KEY\`
+
+Or add them to **Info.plist**:
+\`\`\`xml
+<key>VAIF_PROJECT_ID</key>
+<string>your-project-id</string>
+<key>VAIF_API_KEY</key>
+<string>your-anon-key</string>
+\`\`\`
+
+## 3. Usage
+
+\`\`\`swift
+import SwiftUI
+
+struct ContentView: View {
+    @StateObject private var vaif = VaifManager.shared
+
+    var body: some View {
+        // Use vaif.client to interact with your project
+        Text("Connected to VAIF")
+    }
+}
+\`\`\`
+
+## 4. Generate Types
+
+Run the VAIF CLI to generate Swift models from your schema:
+
+\`\`\`bash
+npx @vaiftech/cli generate --output ./Models/Database.swift --lang swift
+\`\`\`
+`}],postInstructions:["Add the VaifClient Swift package from https://github.com/vaif-technologies/vaif-swift","Add VAIF_PROJECT_ID and VAIF_API_KEY to your Xcode scheme environment","See README-VAIF.md for full setup instructions"]},"expo-mobile-app":{name:"Expo Mobile App",description:"React Native / Expo app with VAIF client configured for mobile",tag:"Expo / React Native",defaultFeatures:["database","auth"],files:[{path:"package.json",content:`{
+  "name": "my-vaif-app",
+  "version": "0.1.0",
+  "main": "expo-router/entry",
+  "scripts": {
+    "start": "expo start",
+    "android": "expo start --android",
+    "ios": "expo start --ios",
+    "web": "expo start --web"
+  },
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "^2.1.0",
+    "@vaiftech/sdk-expo": "^1.0.0",
+    "expo": "~52.0.0",
+    "expo-router": "~4.0.0",
+    "react": "^19.0.0",
+    "react-native": "~0.76.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "typescript": "^5.7.0"
+  }
+}
+`},{path:"app.json",content:`{
+  "expo": {
+    "name": "my-vaif-app",
+    "slug": "my-vaif-app",
+    "version": "1.0.0",
+    "scheme": "myvaifapp",
+    "platforms": ["ios", "android", "web"],
+    "newArchEnabled": true
+  }
+}
+`},{path:"app/_layout.tsx",content:`import { Stack } from "expo-router";
+import { VaifProvider } from "@vaiftech/sdk-expo";
+import { vaif } from "../lib/vaif";
+
+export default function RootLayout() {
+  return (
+    <VaifProvider client={vaif}>
+      <Stack>
+        <Stack.Screen name="index" options={{ title: "Home" }} />
+      </Stack>
+    </VaifProvider>
+  );
+}
+`},{path:"app/index.tsx",content:`import { View, Text, StyleSheet } from "react-native";
+
+export default function HomeScreen() {
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>Welcome to VAIF</Text>
+      <Text style={styles.subtitle}>Your mobile app is ready. Start building!</Text>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1, alignItems: "center", justifyContent: "center", padding: 24 },
+  title: { fontSize: 28, fontWeight: "bold", marginBottom: 8 },
+  subtitle: { fontSize: 16, color: "#666", textAlign: "center" },
+});
+`},{path:"lib/vaif.ts",content:`import { createExpoClient } from "@vaiftech/sdk-expo";
+import AsyncStorage from "@react-native-async-storage/async-storage";
+
+export const vaif = createExpoClient({
+  projectId: process.env.EXPO_PUBLIC_VAIF_PROJECT_ID!,
+  apiKey: process.env.EXPO_PUBLIC_VAIF_API_KEY!,
+  storage: AsyncStorage,
+  realtime: { enabled: true },
+});
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+EXPO_PUBLIC_VAIF_PROJECT_ID=your-project-id
+EXPO_PUBLIC_VAIF_API_KEY=your-anon-key
+`},{path:".gitignore",content:`node_modules
+.expo
+dist
+.env
+`}],featureFiles:{auth:[{path:"app/(auth)/login.tsx",content:`import { useState } from "react";
+import { View, Text, TextInput, TouchableOpacity, StyleSheet, Alert } from "react-native";
+import { useRouter } from "expo-router";
+import { vaif } from "../../lib/vaif";
+
+export default function LoginScreen() {
+  const router = useRouter();
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [loading, setLoading] = useState(false);
+
+  async function handleLogin() {
+    setLoading(true);
+    const { error } = await vaif.auth.signInWithPassword({ email, password });
+    setLoading(false);
+    if (error) Alert.alert("Error", error.message);
+    else router.replace("/");
+  }
+
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>Log In</Text>
+      <TextInput style={styles.input} placeholder="Email" value={email} onChangeText={setEmail} autoCapitalize="none" keyboardType="email-address" />
+      <TextInput style={styles.input} placeholder="Password" value={password} onChangeText={setPassword} secureTextEntry />
+      <TouchableOpacity style={styles.button} onPress={handleLogin} disabled={loading}>
+        <Text style={styles.buttonText}>{loading ? "Logging in..." : "Log In"}</Text>
+      </TouchableOpacity>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1, padding: 24, justifyContent: "center" },
+  title: { fontSize: 28, fontWeight: "bold", marginBottom: 24, textAlign: "center" },
+  input: { borderWidth: 1, borderColor: "#ccc", borderRadius: 8, padding: 12, marginBottom: 12, fontSize: 16 },
+  button: { backgroundColor: "#0070f3", borderRadius: 8, padding: 14, alignItems: "center" },
+  buttonText: { color: "#fff", fontSize: 16, fontWeight: "600" },
+});
+`},{path:"app/(auth)/signup.tsx",content:`import { useState } from "react";
+import { View, Text, TextInput, TouchableOpacity, StyleSheet, Alert } from "react-native";
+import { useRouter } from "expo-router";
+import { vaif } from "../../lib/vaif";
+
+export default function SignupScreen() {
+  const router = useRouter();
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [loading, setLoading] = useState(false);
+
+  async function handleSignup() {
+    setLoading(true);
+    const { error } = await vaif.auth.signUp({ email, password });
+    setLoading(false);
+    if (error) Alert.alert("Error", error.message);
+    else router.replace("/");
+  }
+
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>Sign Up</Text>
+      <TextInput style={styles.input} placeholder="Email" value={email} onChangeText={setEmail} autoCapitalize="none" keyboardType="email-address" />
+      <TextInput style={styles.input} placeholder="Password" value={password} onChangeText={setPassword} secureTextEntry />
+      <TouchableOpacity style={styles.button} onPress={handleSignup} disabled={loading}>
+        <Text style={styles.buttonText}>{loading ? "Creating account..." : "Sign Up"}</Text>
+      </TouchableOpacity>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1, padding: 24, justifyContent: "center" },
+  title: { fontSize: 28, fontWeight: "bold", marginBottom: 24, textAlign: "center" },
+  input: { borderWidth: 1, borderColor: "#ccc", borderRadius: 8, padding: 12, marginBottom: 12, fontSize: 16 },
+  button: { backgroundColor: "#0070f3", borderRadius: 8, padding: 14, alignItems: "center" },
+  buttonText: { color: "#fff", fontSize: 16, fontWeight: "600" },
+});
+`}],storage:[{path:"hooks/useImagePicker.ts",content:`import { useState, useCallback } from "react";
+import * as ImagePicker from "expo-image-picker";
+import { vaif } from "../lib/vaif";
+
+interface UploadResult {
+  path: string;
+  publicUrl: string;
+}
+
+export function useImagePicker(bucket = "uploads") {
+  const [uploading, setUploading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const pickAndUpload = useCallback(async (): Promise<UploadResult | null> => {
+    const result = await ImagePicker.launchImageLibraryAsync({
+      mediaTypes: ImagePicker.MediaTypeOptions.Images,
+      quality: 0.8,
+    });
+
+    if (result.canceled || !result.assets[0]) return null;
+
+    setUploading(true);
+    setError(null);
+
+    const asset = result.assets[0];
+    const ext = asset.uri.split(".").pop() || "jpg";
+    const filePath = \`\${Date.now()}.\${ext}\`;
+
+    const response = await fetch(asset.uri);
+    const blob = await response.blob();
+
+    const { data, error: uploadError } = await vaif.storage
+      .from(bucket)
+      .upload(filePath, blob);
+
+    if (uploadError) {
+      setError(uploadError.message);
+      setUploading(false);
+      return null;
+    }
+
+    const { data: urlData } = vaif.storage.from(bucket).getPublicUrl(data.path);
+    setUploading(false);
+    return { path: data.path, publicUrl: urlData.publicUrl };
+  }, [bucket]);
+
+  return { pickAndUpload, uploading, error };
+}
+`}],realtime:[{path:"hooks/useRealtimeMessages.ts",content:`import { useEffect, useState, useCallback } from "react";
+import { vaif } from "../lib/vaif";
+
+interface Message {
+  id: string;
+  content: string;
+  user_id: string;
+  created_at: string;
+}
+
+export function useRealtimeMessages(channelId: string) {
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    vaif.from("messages").select("*").eq("channel_id", channelId)
+      .order("created_at", { ascending: true }).limit(50)
+      .then(({ data }) => {
+        if (data) setMessages(data as Message[]);
+        setLoading(false);
+      });
+  }, [channelId]);
+
+  useEffect(() => {
+    const channel = vaif
+      .channel(\`messages:\${channelId}\`)
+      .on("postgres_changes", { event: "INSERT", schema: "public", table: "messages", filter: \`channel_id=eq.\${channelId}\` }, (payload) => {
+        setMessages((prev) => [...prev, payload.new as Message]);
+      })
+      .subscribe();
+
+    return () => { channel.unsubscribe(); };
+  }, [channelId]);
+
+  const refresh = useCallback(async () => {
+    const { data } = await vaif.from("messages").select("*").eq("channel_id", channelId).order("created_at", { ascending: true }).limit(50);
+    if (data) setMessages(data as Message[]);
+  }, [channelId]);
+
+  return { messages, loading, refresh };
+}
+`}]},dependencies:["@vaiftech/sdk-expo","@react-native-async-storage/async-storage","expo","expo-router","react","react-native"],postInstructions:["cd my-vaif-app","npm install","# Copy .env.example to .env and add your VAIF credentials","npx expo start"]},"flutter-app":{name:"Flutter App",description:"Dart/Flutter client setup with environment configuration",tag:"Flutter / Dart",defaultFeatures:["database","auth"],files:[{path:"lib/main.dart",content:`import 'package:flutter/material.dart';
+import 'vaif_client.dart';
+
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  await initVaif();
+  runApp(const MyApp());
+}
+
+class MyApp extends StatelessWidget {
+  const MyApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      title: 'My VAIF App',
+      theme: ThemeData(colorSchemeSeed: Colors.blue, useMaterial3: true),
+      home: const HomeScreen(),
+    );
+  }
+}
+
+class HomeScreen extends StatelessWidget {
+  const HomeScreen({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('My VAIF App')),
+      body: const Center(child: Text('Welcome to VAIF! Start building.')),
+    );
+  }
+}
+`},{path:"lib/vaif_client.dart",content:`import 'package:vaif_client/vaif_client.dart';
+import 'package:flutter_dotenv/flutter_dotenv.dart';
+
+late final VaifClient vaif;
+
+Future<void> initVaif() async {
+  await dotenv.load(fileName: '.env');
+
+  final projectId = dotenv.env['VAIF_PROJECT_ID'];
+  final apiKey = dotenv.env['VAIF_API_KEY'];
+
+  if (projectId == null || apiKey == null) {
+    throw Exception('VAIF_PROJECT_ID and VAIF_API_KEY must be set in .env');
+  }
+
+  vaif = VaifClient(
+    projectId: projectId,
+    apiKey: apiKey,
+    realtime: const RealtimeConfig(enabled: true),
+  );
+}
+`},{path:"pubspec.yaml",content:`name: my_vaif_app
+description: A Flutter app powered by VAIF.
+version: 0.1.0
+publish_to: 'none'
+
+environment:
+  sdk: ^3.5.0
+
+dependencies:
+  flutter:
+    sdk: flutter
+  vaif_client: ^1.0.0
+  flutter_dotenv: ^5.1.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^5.0.0
+
+flutter:
+  uses-material-design: true
+  assets:
+    - .env
+`},{path:".env.example",content:`VAIF_PROJECT_ID=your-project-id
+VAIF_API_KEY=your-anon-key
+`},{path:".gitignore",content:`build/
+.dart_tool/
+.packages
+.env
+*.iml
+`}],featureFiles:{auth:[{path:"lib/screens/login_screen.dart",content:`import 'package:flutter/material.dart';
+import '../vaif_client.dart';
+
+class LoginScreen extends StatefulWidget {
+  const LoginScreen({super.key});
+
+  @override
+  State<LoginScreen> createState() => _LoginScreenState();
+}
+
+class _LoginScreenState extends State<LoginScreen> {
+  final _emailController = TextEditingController();
+  final _passwordController = TextEditingController();
+  bool _loading = false;
+  String? _error;
+
+  Future<void> _handleLogin() async {
+    setState(() { _loading = true; _error = null; });
+
+    try {
+      await vaif.auth.signInWithPassword(
+        email: _emailController.text,
+        password: _passwordController.text,
+      );
+      if (mounted) Navigator.of(context).pushReplacementNamed('/');
+    } catch (e) {
+      setState(() { _error = e.toString(); });
+    } finally {
+      if (mounted) setState(() { _loading = false; });
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Log In')),
+      body: Padding(
+        padding: const EdgeInsets.all(24),
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            TextField(controller: _emailController, decoration: const InputDecoration(labelText: 'Email'), keyboardType: TextInputType.emailAddress),
+            const SizedBox(height: 12),
+            TextField(controller: _passwordController, decoration: const InputDecoration(labelText: 'Password'), obscureText: true),
+            const SizedBox(height: 24),
+            if (_error != null) Text(_error!, style: const TextStyle(color: Colors.red)),
+            const SizedBox(height: 12),
+            ElevatedButton(
+              onPressed: _loading ? null : _handleLogin,
+              child: Text(_loading ? 'Logging in...' : 'Log In'),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+`}]},postInstructions:["flutter pub get","# Copy .env.example to .env and add your VAIF credentials","flutter run"]},"python-fastapi-backend":{name:"Python FastAPI Backend",description:"FastAPI backend with VAIF client, auth middleware, and type-safe queries",tag:"Python / FastAPI",defaultFeatures:["database","auth"],files:[{path:"main.py",content:`"""VAIF FastAPI application."""
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from vaif_client import get_vaif_client
+
+app = FastAPI(title="My VAIF API", version="0.1.0")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+@app.get("/")
+async def root():
+    return {"status": "ok", "message": "VAIF API running"}
+
+
+@app.get("/health")
+async def health():
+    return {"status": "healthy"}
+
+
+@app.get("/items")
+async def list_items():
+    client = get_vaif_client()
+    result = await client.from_("items").select("*").execute()
+    return {"data": result.data}
+`},{path:"vaif_client.py",content:`"""VAIF client setup for FastAPI."""
+
+import os
+from functools import lru_cache
+
+from dotenv import load_dotenv
+from vaif import Client, ServiceClient
+
+load_dotenv()
+
+VAIF_PROJECT_ID = os.environ["VAIF_PROJECT_ID"]
+VAIF_API_KEY = os.environ["VAIF_API_KEY"]
+VAIF_SECRET_KEY = os.environ.get("VAIF_SECRET_KEY", "")
+
+
+@lru_cache()
+def get_vaif_client() -> Client:
+    """Public client using the anon key (respects Row Level Security)."""
+    return Client(project_id=VAIF_PROJECT_ID, api_key=VAIF_API_KEY)
+
+
+@lru_cache()
+def get_vaif_admin() -> ServiceClient:
+    """Admin/service client that bypasses RLS. Use with caution."""
+    return ServiceClient(project_id=VAIF_PROJECT_ID, secret_key=VAIF_SECRET_KEY)
+`},{path:"requirements.txt",content:`vaif-client>=1.0.0
+fastapi>=0.110.0
+uvicorn[standard]>=0.27.0
+python-dotenv>=1.0.0
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+VAIF_PROJECT_ID=your-project-id
+VAIF_API_KEY=your-anon-key
+VAIF_SECRET_KEY=your-secret-key
+`},{path:".gitignore",content:`__pycache__
+*.pyc
+.env
+.venv
+venv
+`}],featureFiles:{auth:[{path:"middleware/auth.py",content:`"""VAIF auth middleware for FastAPI."""
+
+from typing import Optional
+
+from fastapi import Depends, HTTPException, status
+from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
+from vaif_client import get_vaif_admin
+
+security = HTTPBearer(auto_error=False)
+
+
+async def get_current_user(
+    credentials: Optional[HTTPAuthorizationCredentials] = Depends(security),
+):
+    """FastAPI dependency that validates VAIF auth tokens.
+
+    Usage:
+        @app.get("/protected")
+        async def protected_route(user=Depends(get_current_user)):
+            return {"user_id": user["id"]}
+    """
+    if credentials is None:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="Missing authorization header",
+        )
+
+    client = get_vaif_admin()
+    try:
+        user = await client.auth.get_user(credentials.credentials)
+    except Exception as exc:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail=f"Invalid token: {exc}",
+        )
+
+    if user is None:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="Invalid or expired token",
+        )
+
+    return user
+`},{path:"middleware/__init__.py",content:""}],storage:[{path:"routes/storage.py",content:`"""File upload routes using VAIF Storage."""
+
+from fastapi import APIRouter, UploadFile, File
+from vaif_client import get_vaif_admin
+
+router = APIRouter(prefix="/storage", tags=["storage"])
+
+BUCKET = "uploads"
+
+
+@router.post("/upload")
+async def upload_file(file: UploadFile = File(...)):
+    client = get_vaif_admin()
+    file_path = f"{file.filename}"
+    contents = await file.read()
+
+    result = await client.storage.from_(BUCKET).upload(file_path, contents)
+    url_data = client.storage.from_(BUCKET).get_public_url(result.path)
+
+    return {"path": result.path, "public_url": url_data}
+`},{path:"routes/__init__.py",content:""}],functions:[{path:"routes/functions.py",content:`"""Invoke VAIF serverless functions."""
+
+from fastapi import APIRouter
+from vaif_client import get_vaif_client
+
+router = APIRouter(prefix="/functions", tags=["functions"])
+
+
+@router.post("/invoke/{function_name}")
+async def invoke_function(function_name: str, payload: dict = {}):
+    client = get_vaif_client()
+    result = await client.functions.invoke(function_name, body=payload)
+    return {"data": result}
+`}]},postInstructions:["pip install -r requirements.txt","# Copy .env.example to .env and add your VAIF credentials","uvicorn main:app --reload"]},"go-backend-api":{name:"Go Backend API",description:"Go backend with VAIF client initialisation and HTTP middleware",tag:"Go",defaultFeatures:["database","auth"],files:[{path:"main.go",content:`package main
+
+import (
+	"encoding/json"
+	"log"
+	"net/http"
+
+	"github.com/joho/godotenv"
+	"myapp/vaif"
+)
+
+func main() {
+	_ = godotenv.Load()
+
+	if err := vaif.Init(); err != nil {
+		log.Fatalf("Failed to initialise VAIF: %v", err)
+	}
+
+	mux := http.NewServeMux()
+
+	mux.HandleFunc("GET /health", func(w http.ResponseWriter, r *http.Request) {
+		json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
+	})
+
+	log.Println("Server running on :8080")
+	log.Fatal(http.ListenAndServe(":8080", mux))
+}
+`},{path:"vaif/client.go",content:`package vaif
+
+import (
+	"fmt"
+	"os"
+
+	vaifclient "github.com/vaif-technologies/vaif-go"
+)
+
+var Client *vaifclient.Client
+
+func Init() error {
+	projectID := os.Getenv("VAIF_PROJECT_ID")
+	apiKey := os.Getenv("VAIF_API_KEY")
+	secretKey := os.Getenv("VAIF_SECRET_KEY")
+
+	if projectID == "" || apiKey == "" {
+		return fmt.Errorf("VAIF_PROJECT_ID and VAIF_API_KEY must be set")
+	}
+
+	var err error
+	Client, err = vaifclient.NewClient(vaifclient.Config{
+		ProjectID: projectID,
+		APIKey:    apiKey,
+		SecretKey: secretKey,
+	})
+	if err != nil {
+		return fmt.Errorf("failed to create VAIF client: %w", err)
+	}
+
+	return nil
+}
+`},{path:"go.mod",content:`module myapp
+
+go 1.22
+
+require (
+	github.com/joho/godotenv v1.5.1
+	github.com/vaif-technologies/vaif-go v1.0.0
+)
+`},{path:".env.example",content:`# VAIF Configuration
+VAIF_PROJECT_ID=your-project-id
+VAIF_API_KEY=your-anon-key
+VAIF_SECRET_KEY=your-secret-key
+`},{path:".gitignore",content:`*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+.env
+`}],featureFiles:{auth:[{path:"middleware/auth.go",content:`package middleware
+
+import (
+	"net/http"
+	"strings"
+
+	"myapp/vaif"
+	vaifclient "github.com/vaif-technologies/vaif-go"
+)
+
+func AuthMiddleware(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		auth := r.Header.Get("Authorization")
+		if auth == "" {
+			http.Error(w, "missing authorization header", http.StatusUnauthorized)
+			return
+		}
+
+		token := strings.TrimPrefix(auth, "Bearer ")
+		if token == auth {
+			http.Error(w, "invalid authorization format", http.StatusUnauthorized)
+			return
+		}
+
+		user, err := vaif.Client.Auth.GetUser(r.Context(), token)
+		if err != nil {
+			http.Error(w, "invalid or expired token", http.StatusUnauthorized)
+			return
+		}
+
+		ctx := vaifclient.WithUser(r.Context(), user)
+		next.ServeHTTP(w, r.WithContext(ctx))
+	})
+}
+`}],storage:[{path:"handlers/storage.go",content:`package handlers
+
+import (
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"time"
+
+	"myapp/vaif"
+)
+
+func UploadHandler(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodPost {
+		http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
+		return
+	}
+
+	file, header, err := r.FormFile("file")
+	if err != nil {
+		http.Error(w, "invalid file", http.StatusBadRequest)
+		return
+	}
+	defer file.Close()
+
+	data, err := io.ReadAll(file)
+	if err != nil {
+		http.Error(w, "failed to read file", http.StatusInternalServerError)
+		return
+	}
+
+	path := fmt.Sprintf("%d-%s", time.Now().Unix(), header.Filename)
+	result, err := vaif.Client.Storage.From("uploads").Upload(r.Context(), path, data)
+	if err != nil {
+		http.Error(w, "upload failed", http.StatusInternalServerError)
+		return
+	}
+
+	w.Header().Set("Content-Type", "application/json")
+	json.NewEncoder(w).Encode(result)
+}
+`}]},postInstructions:["go mod tidy","# Copy .env.example to .env and add your VAIF credentials","go run main.go"]},"todo-app":{name:"Todo App",description:"Simple React todo app \u2013 great for learning VAIF basics",tag:"React Starter",defaultFeatures:["database"],files:[{path:"src/lib/vaif.ts",content:`import { createClient } from "@vaiftech/client";
+
+export const vaif = createClient({
+  projectId: import.meta.env.VITE_VAIF_PROJECT_ID,
+  apiKey: import.meta.env.VITE_VAIF_API_KEY,
+});
+
+// Typed helpers for the todos table
+export interface Todo {
+  id: string;
+  title: string;
+  done: boolean;
+  created_at: string;
+  user_id?: string;
+}
+
+export async function getTodos(): Promise<Todo[]> {
+  const { data, error } = await vaif
+    .from("todos")
+    .select("*")
+    .order("created_at", { ascending: false });
+
+  if (error) throw error;
+  return data as Todo[];
+}
+
+export async function addTodo(title: string): Promise<Todo> {
+  const { data, error } = await vaif
+    .from("todos")
+    .insert({ title, done: false })
+    .select()
+    .single();
+
+  if (error) throw error;
+  return data as Todo;
+}
+
+export async function toggleTodo(id: string, done: boolean): Promise<void> {
+  const { error } = await vaif
+    .from("todos")
+    .update({ done })
+    .eq("id", id);
+
+  if (error) throw error;
+}
+
+export async function deleteTodo(id: string): Promise<void> {
+  const { error } = await vaif
+    .from("todos")
+    .delete()
+    .eq("id", id);
+
+  if (error) throw error;
+}
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+VITE_VAIF_PROJECT_ID=your-project-id
+VITE_VAIF_API_KEY=your-anon-key
+`}],dependencies:["@vaiftech/client","@vaiftech/react"],postInstructions:["Copy .env.example to .env and fill in your project credentials","Create a 'todos' table in your VAIF dashboard with columns: id (uuid), title (text), done (boolean), created_at (timestamptz)","Import helpers from './lib/vaif' in your components","Run: npx vaif generate  to generate TypeScript types"]},"realtime-chat":{name:"Realtime Chat",description:"React chat app with VAIF realtime subscriptions for live messaging",tag:"React + Realtime",defaultFeatures:["database","realtime","auth"],files:[{path:"src/lib/vaif.ts",content:`import { createClient } from "@vaiftech/client";
+
+export const vaif = createClient({
+  projectId: import.meta.env.VITE_VAIF_PROJECT_ID,
+  apiKey: import.meta.env.VITE_VAIF_API_KEY,
+  realtime: {
+    enabled: true,
+    // Automatically reconnect on connection loss
+    reconnect: true,
+    reconnectInterval: 1000,
+    maxReconnectAttempts: 10,
+  },
+});
+
+export interface Message {
+  id: string;
+  content: string;
+  user_id: string;
+  username: string;
+  channel_id: string;
+  created_at: string;
+}
+
+export async function sendMessage(
+  channelId: string,
+  content: string,
+  userId: string,
+  username: string,
+): Promise<Message> {
+  const { data, error } = await vaif
+    .from("messages")
+    .insert({
+      content,
+      user_id: userId,
+      username,
+      channel_id: channelId,
+    })
+    .select()
+    .single();
+
+  if (error) throw error;
+  return data as Message;
+}
+
+export async function getMessages(channelId: string, limit = 50): Promise<Message[]> {
+  const { data, error } = await vaif
+    .from("messages")
+    .select("*")
+    .eq("channel_id", channelId)
+    .order("created_at", { ascending: true })
+    .limit(limit);
+
+  if (error) throw error;
+  return data as Message[];
+}
+`},{path:"src/hooks/useRealtimeMessages.ts",content:`import { useEffect, useState, useCallback } from "react";
+import { vaif, type Message, getMessages } from "../lib/vaif";
+
+interface UseRealtimeMessagesOptions {
+  channelId: string;
+  initialLimit?: number;
+}
+
+/**
+ * Hook that subscribes to realtime message changes on a channel.
+ *
+ * Usage:
+ *   const { messages, isLoading, error } = useRealtimeMessages({
+ *     channelId: "general",
+ *   });
+ */
+export function useRealtimeMessages({
+  channelId,
+  initialLimit = 50,
+}: UseRealtimeMessagesOptions) {
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState<Error | null>(null);
+
+  // Load initial messages
+  useEffect(() => {
+    let cancelled = false;
+
+    async function load() {
+      try {
+        setIsLoading(true);
+        const data = await getMessages(channelId, initialLimit);
+        if (!cancelled) {
+          setMessages(data);
+          setError(null);
+        }
+      } catch (err) {
+        if (!cancelled) {
+          setError(err instanceof Error ? err : new Error(String(err)));
+        }
+      } finally {
+        if (!cancelled) setIsLoading(false);
+      }
+    }
+
+    load();
+    return () => { cancelled = true; };
+  }, [channelId, initialLimit]);
+
+  // Subscribe to realtime changes
+  useEffect(() => {
+    const subscription = vaif
+      .channel(\`messages:\${channelId}\`)
+      .on(
+        "postgres_changes",
+        {
+          event: "*",
+          schema: "public",
+          table: "messages",
+          filter: \`channel_id=eq.\${channelId}\`,
+        },
+        (payload) => {
+          if (payload.eventType === "INSERT") {
+            setMessages((prev) => [...prev, payload.new as Message]);
+          } else if (payload.eventType === "UPDATE") {
+            setMessages((prev) =>
+              prev.map((msg) =>
+                msg.id === (payload.new as Message).id
+                  ? (payload.new as Message)
+                  : msg,
+              ),
+            );
+          } else if (payload.eventType === "DELETE") {
+            setMessages((prev) =>
+              prev.filter((msg) => msg.id !== (payload.old as Message).id),
+            );
+          }
+        },
+      )
+      .subscribe();
+
+    return () => {
+      subscription.unsubscribe();
+    };
+  }, [channelId]);
+
+  const refresh = useCallback(async () => {
+    const data = await getMessages(channelId, initialLimit);
+    setMessages(data);
+  }, [channelId, initialLimit]);
+
+  return { messages, isLoading, error, refresh };
+}
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+VITE_VAIF_PROJECT_ID=your-project-id
+VITE_VAIF_API_KEY=your-anon-key
+`}],dependencies:["@vaiftech/client","@vaiftech/react"],postInstructions:["Copy .env.example to .env and fill in your project credentials","Create a 'messages' table with columns: id (uuid), content (text), user_id (text), username (text), channel_id (text), created_at (timestamptz)","Enable Realtime on the messages table in your VAIF dashboard","Use the useRealtimeMessages hook in your components","Run: npx vaif generate  to generate TypeScript types"]},"saas-starter":{name:"SaaS Starter",description:"Full SaaS starter with VAIF auth, team/org support, and server-side helpers",tag:"Next.js SaaS",defaultFeatures:["database","auth","functions"],files:[{path:"lib/vaif.ts",content:`import { createClient } from "@vaiftech/client";
+import { createServerClient } from "@vaiftech/client/server";
+
+// Browser client \u2013 use in Client Components
+export const vaif = createClient({
+  projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+  apiKey: process.env.NEXT_PUBLIC_VAIF_API_KEY!,
+});
+
+// Server client \u2013 use in Server Components, Route Handlers, Server Actions
+export function createVaifServer() {
+  return createServerClient({
+    projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+    secretKey: process.env.VAIF_SECRET_KEY!,
+  });
+}
+`},{path:"lib/auth.ts",content:`import { createVaifServer } from "./vaif";
+
+// \u2500\u2500 User helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+export async function getCurrentUser() {
+  const vaif = createVaifServer();
+  const { data: { user }, error } = await vaif.auth.getUser();
+  if (error || !user) return null;
+  return user;
+}
+
+export async function requireUser() {
+  const user = await getCurrentUser();
+  if (!user) throw new Error("Unauthorized");
+  return user;
+}
+
+// \u2500\u2500 Team / Organisation helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+export interface Team {
+  id: string;
+  name: string;
+  slug: string;
+  owner_id: string;
+  created_at: string;
+}
+
+export interface TeamMember {
+  id: string;
+  team_id: string;
+  user_id: string;
+  role: "owner" | "admin" | "member" | "viewer";
+  joined_at: string;
+}
+
+export async function getUserTeams(userId: string): Promise<Team[]> {
+  const vaif = createVaifServer();
+
+  // Get team IDs the user belongs to
+  const { data: memberships, error: memberError } = await vaif
+    .from("team_members")
+    .select("team_id")
+    .eq("user_id", userId);
+
+  if (memberError) throw memberError;
+  if (!memberships?.length) return [];
+
+  const teamIds = memberships.map((m) => m.team_id);
+
+  const { data: teams, error: teamError } = await vaif
+    .from("teams")
+    .select("*")
+    .in("id", teamIds)
+    .order("name");
+
+  if (teamError) throw teamError;
+  return (teams ?? []) as Team[];
+}
+
+export async function getTeamMembers(teamId: string): Promise<TeamMember[]> {
+  const vaif = createVaifServer();
+
+  const { data, error } = await vaif
+    .from("team_members")
+    .select("*")
+    .eq("team_id", teamId)
+    .order("joined_at");
+
+  if (error) throw error;
+  return (data ?? []) as TeamMember[];
+}
+
+export async function createTeam(name: string, slug: string): Promise<Team> {
+  const user = await requireUser();
+  const vaif = createVaifServer();
+
+  const { data: team, error } = await vaif
+    .from("teams")
+    .insert({ name, slug, owner_id: user.id })
+    .select()
+    .single();
+
+  if (error) throw error;
+
+  // Add the creator as owner
+  await vaif.from("team_members").insert({
+    team_id: team.id,
+    user_id: user.id,
+    role: "owner",
+  });
+
+  return team as Team;
+}
+
+export async function inviteToTeam(
+  teamId: string,
+  email: string,
+  role: TeamMember["role"] = "member",
+): Promise<void> {
+  const vaif = createVaifServer();
+
+  // Look up user by email
+  const { data: users } = await vaif
+    .from("users")
+    .select("id")
+    .eq("email", email)
+    .limit(1);
+
+  if (!users?.length) {
+    throw new Error("User not found. They must create an account first.");
+  }
+
+  const { error } = await vaif.from("team_members").insert({
+    team_id: teamId,
+    user_id: users[0].id,
+    role,
+  });
+
+  if (error) throw error;
+}
+
+// \u2500\u2500 Role-based checks \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+export async function requireTeamRole(
+  teamId: string,
+  requiredRoles: TeamMember["role"][],
+): Promise<TeamMember> {
+  const user = await requireUser();
+  const vaif = createVaifServer();
+
+  const { data: member, error } = await vaif
+    .from("team_members")
+    .select("*")
+    .eq("team_id", teamId)
+    .eq("user_id", user.id)
+    .single();
+
+  if (error || !member) {
+    throw new Error("Not a member of this team");
+  }
+
+  if (!requiredRoles.includes(member.role)) {
+    throw new Error(\`Requires one of: \${requiredRoles.join(", ")}\`);
+  }
+
+  return member as TeamMember;
+}
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+NEXT_PUBLIC_VAIF_PROJECT_ID=your-project-id
+NEXT_PUBLIC_VAIF_API_KEY=your-anon-key
+VAIF_SECRET_KEY=your-secret-key
+`}],dependencies:["@vaiftech/client","@vaiftech/auth","@vaiftech/react"],postInstructions:["Copy .env.example to .env.local and fill in your project credentials","Create 'teams' and 'team_members' tables in your VAIF dashboard","Import auth helpers from '@/lib/auth' in your Server Components/Actions","Use requireUser() for authenticated routes and requireTeamRole() for role checks","Run: npx vaif generate  to generate TypeScript types"]},"ecommerce-api":{name:"E-commerce API",description:"API-first e-commerce setup with VAIF storage for product images",tag:"Next.js E-commerce",defaultFeatures:["database","auth","storage"],files:[{path:"lib/vaif.ts",content:`import { createClient } from "@vaiftech/client";
+import { createServerClient } from "@vaiftech/client/server";
+
+// Browser client
+export const vaif = createClient({
+  projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+  apiKey: process.env.NEXT_PUBLIC_VAIF_API_KEY!,
+});
+
+// Server client
+export function createVaifServer() {
+  return createServerClient({
+    projectId: process.env.NEXT_PUBLIC_VAIF_PROJECT_ID!,
+    secretKey: process.env.VAIF_SECRET_KEY!,
+  });
+}
+`},{path:"lib/storage.ts",content:`import { createVaifServer } from "./vaif";
+
+const PRODUCT_IMAGES_BUCKET = "product-images";
+
+interface UploadResult {
+  path: string;
+  publicUrl: string;
+}
+
+/**
+ * Upload a product image to VAIF Storage.
+ *
+ * @param file - The file buffer or Blob to upload
+ * @param productId - Product ID used to organise files in folders
+ * @param fileName - Original filename (will be sanitised)
+ * @returns The storage path and public URL
+ */
+export async function uploadProductImage(
+  file: Buffer | Blob,
+  productId: string,
+  fileName: string,
+): Promise<UploadResult> {
+  const vaif = createVaifServer();
+
+  // Sanitise filename and build path
+  const sanitised = fileName.replace(/[^a-zA-Z0-9._-]/g, "_");
+  const storagePath = \`\${productId}/\${Date.now()}-\${sanitised}\`;
+
+  const { data, error } = await vaif.storage
+    .from(PRODUCT_IMAGES_BUCKET)
+    .upload(storagePath, file, {
+      contentType: getContentType(fileName),
+      upsert: false,
+    });
+
+  if (error) throw error;
+
+  const { data: urlData } = vaif.storage
+    .from(PRODUCT_IMAGES_BUCKET)
+    .getPublicUrl(data.path);
+
+  return {
+    path: data.path,
+    publicUrl: urlData.publicUrl,
+  };
+}
+
+/**
+ * Delete a product image from storage.
+ */
+export async function deleteProductImage(storagePath: string): Promise<void> {
+  const vaif = createVaifServer();
+
+  const { error } = await vaif.storage
+    .from(PRODUCT_IMAGES_BUCKET)
+    .remove([storagePath]);
+
+  if (error) throw error;
+}
+
+/**
+ * Generate a signed URL for a private product image.
+ *
+ * @param storagePath - The path returned from uploadProductImage
+ * @param expiresIn - Seconds until the URL expires (default: 1 hour)
+ */
+export async function getSignedImageUrl(
+  storagePath: string,
+  expiresIn = 3600,
+): Promise<string> {
+  const vaif = createVaifServer();
+
+  const { data, error } = await vaif.storage
+    .from(PRODUCT_IMAGES_BUCKET)
+    .createSignedUrl(storagePath, expiresIn);
+
+  if (error) throw error;
+  return data.signedUrl;
+}
+
+/**
+ * List all images for a product.
+ */
+export async function listProductImages(productId: string) {
+  const vaif = createVaifServer();
+
+  const { data, error } = await vaif.storage
+    .from(PRODUCT_IMAGES_BUCKET)
+    .list(productId, {
+      sortBy: { column: "created_at", order: "desc" },
+    });
+
+  if (error) throw error;
+  return data;
+}
+
+function getContentType(fileName: string): string {
+  const ext = fileName.split(".").pop()?.toLowerCase();
+  const mimeTypes: Record<string, string> = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    avif: "image/avif",
+  };
+  return mimeTypes[ext ?? ""] ?? "application/octet-stream";
+}
+`},{path:".env.example",content:`# VAIF Configuration
+# Get these values from https://vaif.studio/dashboard \u2192 Project Settings \u2192 API Keys
+
+NEXT_PUBLIC_VAIF_PROJECT_ID=your-project-id
+NEXT_PUBLIC_VAIF_API_KEY=your-anon-key
+VAIF_SECRET_KEY=your-secret-key
+`}],dependencies:["@vaiftech/client","@vaiftech/auth"],postInstructions:["Copy .env.example to .env.local and fill in your project credentials","Create a 'product-images' storage bucket in your VAIF dashboard","Import storage helpers from '@/lib/storage' in your API routes","Use uploadProductImage() in your product creation flow","Run: npx vaif generate  to generate TypeScript types"]}};function me(){console.log(""),console.log(o.bold("Available project templates")),console.log("");let r=26,t=22;console.log(`  ${o.gray("Template".padEnd(r))}${o.gray("Stack".padEnd(t))}${o.gray("Description")}`),console.log(o.gray("  "+"-".repeat(r+t+40)));for(let[a,e]of Object.entries(R))console.log(`  ${o.cyan(a.padEnd(r))}${o.yellow(e.tag.padEnd(t))}${o.white(e.description)}`);console.log(""),console.log(o.gray("Usage:")),console.log(o.gray("  npx @vaiftech/cli init --template <name>")),console.log(o.gray("  npx @vaiftech/cli init -t nextjs-fullstack")),console.log(o.gray("  npx @vaiftech/cli init -t react-spa --features auth,database,realtime")),console.log(""),console.log(o.gray("Available features: auth, database, realtime, storage, functions")),console.log("");}async function q(r){if(!process.stdin.isTTY||!process.stdout.isTTY)return r;let t=new Set(r.map(e=>g.findIndex(i=>i.name===e)).filter(e=>e>=0)),a=0;return new Promise(e=>{let i=F.createInterface({input:process.stdin,output:process.stdout});F.emitKeypressEvents(process.stdin,i),process.stdin.setRawMode&&process.stdin.setRawMode(true);function s(){let l=g.length+2;process.stdout.write(`\x1B[${l}A`),c();}function c(){console.log(o.bold(`
+? Which VAIF features do you want to include?`)),g.forEach((l,n)=>{let p=t.has(n)?o.green("[x]"):"[ ]",u=n===a?o.cyan("> "):"  ";console.log(`${u}${p} ${l.label} ${o.gray(`(${l.description})`)}`);}),console.log(o.gray("  (up/down to move, space to toggle, enter to confirm)"));}c(),process.stdin.on("keypress",(l,n)=>{if(n.name==="up"&&a>0)a--,s();else if(n.name==="down"&&a<g.length-1)a++,s();else if(n.name==="space")t.has(a)?t.delete(a):t.add(a),s();else if(n.name==="return"){process.stdin.setRawMode&&process.stdin.setRawMode(false),i.close();let p=[...t].sort().map(u=>g[u].name);e(p.length>0?p:r);}else n.name==="c"&&n.ctrl&&(process.stdin.setRawMode&&process.stdin.setRawMode(false),i.close(),process.exit(0));});})}async function V(r,t={}){let a=R[r];a||(console.log(o.red(`
+Unknown template: ${r}`)),console.log(o.yellow(`Run 'vaif templates' to see available templates.
+`)),process.exit(1));let e;t.features&&t.features.length>0?e=t.features.filter(l=>g.some(n=>n.name===l)):a.featureFiles&&Object.keys(a.featureFiles).length>0?e=await q(a.defaultFeatures??["database","auth"]):e=a.defaultFeatures??[],console.log(""),console.log(o.bold(`Scaffolding ${o.cyan(a.name)} template...`)),e.length>0&&console.log(o.gray(`  Features: ${e.join(", ")}`)),console.log("");let i=[...a.files];if(a.featureFiles)for(let l of e){let n=a.featureFiles[l];n&&i.push(...n);}let s=0,c=0;for(let l of i){let n=w.resolve(l.path),p=w.dirname(n);if(h.existsSync(p)||h.mkdirSync(p,{recursive:true}),h.existsSync(n)&&!t.force){console.log(o.yellow(`  skip  ${l.path}  (already exists)`)),c++;continue}h.writeFileSync(n,l.content,"utf-8"),console.log(o.green(`  create  ${l.path}`)),s++;}console.log(""),s>0&&console.log(o.green(`Created ${s} file${s!==1?"s":""}.`)),c>0&&console.log(o.yellow(`Skipped ${c} file${c!==1?"s":""} (use --force to overwrite).`)),(a.dependencies?.length||a.devDependencies?.length)&&(console.log(""),console.log(o.bold("Install dependencies:")),a.dependencies?.length&&console.log(o.cyan(`  npm install ${a.dependencies.join(" ")}`)),a.devDependencies?.length&&console.log(o.cyan(`  npm install -D ${a.devDependencies.join(" ")}`))),console.log(""),console.log(o.bold.green("Project scaffolded successfully!")),console.log(""),console.log(o.bold("  Next steps:")),a.postInstructions.forEach(l=>{console.log(o.gray(`    ${l}`));}),console.log(""),console.log(o.gray("  Get your project credentials at https://vaif.studio")),console.log("");}var z={$schema:"https://vaif.studio/schemas/config.json",projectId:"",database:{url:"${DATABASE_URL}",schema:"public"},types:{output:"./src/types/database.ts"},api:{baseUrl:"https://api.vaif.studio"}};async function Ie(r){let t=j("Initializing VAIF configuration...").start(),a=w.resolve("vaif.config.json");h.existsSync(a)&&!r.force&&(t.fail("vaif.config.json already exists"),console.log(o.yellow(`
+Use --force to overwrite existing configuration.`)),process.exit(1));try{if(h.writeFileSync(a,JSON.stringify(z,null,2),"utf-8"),t.succeed("Created vaif.config.json"),r.template){let e=r.features?r.features.split(",").map(i=>i.trim()):void 0;await V(r.template,{force:r.force,features:e});}else {let e=w.resolve(".env.example");if(h.existsSync(e)||(h.writeFileSync(e,`# VAIF Configuration
+DATABASE_URL=postgresql://user:password@localhost:5432/database
+VAIF_API_KEY=your-api-key
+`,"utf-8"),console.log(o.gray("Created .env.example"))),r.typescript){let i=w.resolve("src/types");h.existsSync(i)||(h.mkdirSync(i,{recursive:!0}),console.log(o.gray("Created src/types directory")));}console.log(""),console.log(o.green("VAIF initialized successfully!")),console.log(""),console.log(o.gray("Next steps:")),console.log(o.gray("  1. Update vaif.config.json with your project ID")),console.log(o.gray("  2. Set DATABASE_URL in your environment")),console.log(o.gray("  3. Run: npx vaif generate")),console.log("");}}catch(e){t.fail("Failed to initialize"),e instanceof Error&&console.error(o.red(`
+Error: ${e.message}`)),process.exit(1);}}export{T as a,ie as b,me as c,Ie as d};