@vaiftech/cli 1.9.8 → 1.10.0

package/dist/{chunk-T7GOLIY4.js → chunk-6Y62OF5M.js}

@@ -1,19 +1,19 @@
-import b from'fs';import k from'path';import Z from'dotenv';import ee from'os';import {exec}from'child_process';import L from'ora';import l from'chalk';import $ from'readline';import ue from'pg';import pe from'prettier';Z.config();async function q(a){let t=k.resolve(a);if(!b.existsSync(t))return null;try{let n=b.readFileSync(t,"utf-8"),e=JSON.parse(n);return e.database?.url&&(e.database.url=B(e.database.url)),e.api?.apiKey&&(e.api.apiKey=B(e.api.apiKey)),e}catch{throw new Error(`Failed to parse config file: ${a}`)}}function B(a){return a.replace(/\$\{([^}]+)\}/g,(t,n)=>process.env[n]||t)}var C=k.join(ee.homedir(),".vaif"),_=k.join(C,"auth.json"),R=process.env.VAIF_API_URL||"https://api.vaif.studio";function ae(){b.existsSync(C)||b.mkdirSync(C,{recursive:true});}function G(a){ae(),b.writeFileSync(_,JSON.stringify(a,null,2),"utf-8"),b.chmodSync(_,384);}function V(){if(!b.existsSync(_))return null;try{let a=b.readFileSync(_,"utf-8");return JSON.parse(a)}catch{return null}}function ne(a){let t=$.createInterface({input:process.stdin,output:process.stdout});return new Promise(n=>{t.question(a,e=>{t.close(),n(e);});})}function ie(a){return new Promise(t=>{let n=$.createInterface({input:process.stdin,output:process.stdout});process.stdin;let r=process.stdout.write.bind(process.stdout),i=false;process.stdout.write=((...c)=>i?true:r(...c)),n.question(a,c=>{i=false,process.stdout.write=r,console.log(""),n.close(),t(c);}),i=true;})}function oe(a){let t=process.platform,n;t==="darwin"?n=`open "${a}"`:t==="win32"?n=`start "" "${a}"`:n=`xdg-open "${a}"`,exec(n,e=>{});}function re(a){return new Promise(t=>setTimeout(t,a))}async function se(a){try{let t=await fetch(`${R}/auth/me`,{headers:{Authorization:`Bearer ${a}`}});if(t.ok){let n=await t.json();return {valid:!0,email:n.user?.email||n.email}}return {valid:!1}}catch{return {valid:false}}}async function le(a){let t=L();t.start("Setting up authentication...");let n,e;try{let u=await fetch(`${R}/auth/cli/authorize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({})});u.ok||(t.fail("Failed to initiate authentication"),console.log(l.red(`
-Could not connect to VAIF API. Please try again later.`)),process.exit(1));let o=await u.json();n=o.code,e=o.url;}catch{t.fail("Failed to connect to VAIF API"),console.log(l.red(`
-Could not connect to VAIF API.`)),console.log(l.gray("Check your internet connection or try: vaif login --email")),process.exit(1);}t.stop(),console.log(l.cyan("  Opening browser for authentication...")),console.log(""),console.log(l.gray("  If the browser doesn't open, visit this URL:")),console.log(l.white(`  ${e}`)),console.log(""),oe(e),t.start("Waiting for browser authentication...");let r=12e4,i=2e3,c=Date.now();for(;Date.now()-c<r;){await re(i);try{let u=await fetch(`${R}/auth/cli/token`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({code:n})});if(!u.ok){let s=await u.json();(s.error==="ExpiredCode"||s.error==="InvalidCode")&&(t.fail("Authentication expired"),console.log(l.red(`
-The authentication session expired. Please try again.`)),process.exit(1));continue}let o=await u.json();if(o.ok&&o.accessToken){let s={token:o.accessToken,email:o.user?.email,projectId:a,expiresAt:new Date(Date.now()+o.expiresIn*1e3).toISOString()};G(s),t.succeed("Logged in successfully"),console.log(""),o.user?.email&&console.log(l.green(`  Authenticated as: ${o.user.email}`)),console.log(l.gray(`  Config saved to: ${_}`)),console.log("");return}}catch{}}t.fail("Authentication timed out"),console.log(l.red(`
-Timed out waiting for browser authentication.`)),console.log(l.gray("Try again or use: vaif login --email")),process.exit(1);}async function ce(a){console.log(""),console.log(l.bold("VAIF CLI Login")),console.log(l.gray("Enter your VAIF account credentials")),console.log("");let t=await ne(l.cyan("  Email: "));(!t||t.trim()==="")&&(console.log(l.red(`
-No email provided. Login cancelled.`)),process.exit(1));let n=await ie(l.cyan("  Password: "));(!n||n.trim()==="")&&(console.log(l.red(`
-No password provided. Login cancelled.`)),process.exit(1));let e=L("Authenticating...").start();try{let r=await fetch(`${R}/auth/cli/login`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({email:t.trim(),password:n})}),i=await r.json();(!r.ok||!i.ok)&&(e.fail("Login failed"),console.log(l.red(`
-${i.message||"Invalid email or password."}`)),process.exit(1));let c={token:i.accessToken,email:i.user?.email,projectId:a,expiresAt:new Date(Date.now()+i.expiresIn*1e3).toISOString()};G(c),e.succeed("Logged in successfully"),console.log(""),i.user?.email&&console.log(l.green(`  Authenticated as: ${i.user.email}`)),console.log(l.gray(`  Config saved to: ${_}`)),console.log("");}catch{e.fail("Failed to connect to VAIF API"),console.log(l.red(`
-Could not connect to VAIF API. Please try again later.`)),process.exit(1);}}async function Ue(a){console.log(""),console.log(l.bold("Welcome to VAIF CLI")),console.log(l.gray("Authenticate to access your VAIF projects")),console.log(""),a.email?await ce(a.projectId):await le(a.projectId),console.log(l.gray("You can now use VAIF CLI commands like:")),console.log(l.gray("  vaif pull    - Pull remote schema")),console.log(l.gray("  vaif push    - Push schema changes")),console.log(l.gray("  vaif generate - Generate TypeScript types")),console.log("");}async function De(){b.existsSync(_)?(b.unlinkSync(_),console.log(l.green("Logged out successfully"))):console.log(l.yellow("Not currently logged in"));}async function ke(){let a=V();(!a||!a.token)&&(console.log(l.yellow("Not logged in")),console.log(l.gray("Run `vaif login` to authenticate")),process.exit(1));let t=L("Checking authentication...").start(),{valid:n,email:e}=await se(a.token);n||(t.fail("Session expired"),console.log(l.yellow(`
-Your session has expired. Please login again.`)),process.exit(1)),t.succeed("Authenticated"),console.log(""),console.log(l.green(`  Email: ${e||a.email||"Unknown"}`)),a.projectId&&console.log(l.green(`  Project: ${a.projectId}`)),console.log("");}var me=process.env.VAIF_API_URL||"https://api.vaif.studio";async function fe(a,t){let n=await fetch(`${me}/schema-engine/introspect/${t}`,{headers:{Authorization:`Bearer ${a}`,"Content-Type":"application/json"}});if(!n.ok){let u=await n.text();throw new Error(`API introspection failed: ${u}`)}let e=await n.json();if(!e.ok||!e.schemaExists)throw new Error("Project schema does not exist yet. Push a migration first with `vaif db push`.");let r=new Map,i=[];for(let u of e.tables){let o=u.columns.map(s=>({column_name:s.name,data_type:s.type,is_nullable:s.nullable?"YES":"NO",column_default:s.default,udt_name:s.type,is_identity:s.primaryKey&&s.default?.includes("gen_random_uuid")?"YES":"NO",character_maximum_length:null,numeric_precision:null,numeric_scale:null}));r.set(u.name,o);for(let s of u.foreignKeys)i.push({constraint_name:s.constraintName,table_name:u.name,column_name:s.columnName,foreign_table_name:s.refTable,foreign_column_name:s.refColumn});}return {tables:r,enums:new Map,foreignKeys:i}}async function ge(a,t){let n=await a.query(`
+import v from'fs';import I from'path';import se from'dotenv';import le from'os';import {exec}from'child_process';import j from'ora';import u from'chalk';import H from'readline';import ve from'pg';import Ie from'prettier';se.config();async function N(n){let e=I.resolve(n);if(!v.existsSync(e))return null;try{let a=v.readFileSync(e,"utf-8"),t=JSON.parse(a);return t.database?.url&&(t.database.url=G(t.database.url)),t.api?.apiKey&&(t.api.apiKey=G(t.api.apiKey)),t}catch{throw new Error(`Failed to parse config file: ${n}`)}}function G(n){return n.replace(/\$\{([^}]+)\}/g,(e,a)=>process.env[a]||e)}var V=I.join(le.homedir(),".vaif"),S=I.join(V,"auth.json"),D=process.env.VAIF_API_URL||"https://api.vaif.studio";function de(){v.existsSync(V)||v.mkdirSync(V,{recursive:true});}function W(n){de(),v.writeFileSync(S,JSON.stringify(n,null,2),"utf-8"),v.chmodSync(S,384);}function R(){if(!v.existsSync(S))return null;try{let n=v.readFileSync(S,"utf-8");return JSON.parse(n)}catch{return null}}function ue(n){let e=H.createInterface({input:process.stdin,output:process.stdout});return new Promise(a=>{e.question(n,t=>{e.close(),a(t);});})}function pe(n){return new Promise(e=>{let a=H.createInterface({input:process.stdin,output:process.stdout});process.stdin;let o=process.stdout.write.bind(process.stdout),i=false;process.stdout.write=((...s)=>i?true:o(...s)),a.question(n,s=>{i=false,process.stdout.write=o,console.log(""),a.close(),e(s);}),i=true;})}function me(n){let e=process.platform,a;e==="darwin"?a=`open "${n}"`:e==="win32"?a=`start "" "${n}"`:a=`xdg-open "${n}"`,exec(a,t=>{});}function fe(n){return new Promise(e=>setTimeout(e,n))}async function ge(n){try{let e=await fetch(`${D}/auth/me`,{headers:{Authorization:`Bearer ${n}`}});if(e.ok){let a=await e.json();return {valid:!0,email:a.user?.email||a.email}}return {valid:!1}}catch{return {valid:false}}}async function he(n){let e=j();e.start("Setting up authentication...");let a,t;try{let l=await fetch(`${D}/auth/cli/authorize`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({})});l.ok||(e.fail("Failed to initiate authentication"),console.log(u.red(`
+Could not connect to VAIF API. Please try again later.`)),process.exit(1));let r=await l.json();a=r.code,t=r.url;}catch{e.fail("Failed to connect to VAIF API"),console.log(u.red(`
+Could not connect to VAIF API.`)),console.log(u.gray("Check your internet connection or try: vaif login --email")),process.exit(1);}e.stop(),console.log(u.cyan("  Opening browser for authentication...")),console.log(""),console.log(u.gray("  If the browser doesn't open, visit this URL:")),console.log(u.white(`  ${t}`)),console.log(""),me(t),e.start("Waiting for browser authentication...");let o=12e4,i=2e3,s=Date.now();for(;Date.now()-s<o;){await fe(i);try{let l=await fetch(`${D}/auth/cli/token`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({code:a})});if(!l.ok){let c=await l.json();(c.error==="ExpiredCode"||c.error==="InvalidCode")&&(e.fail("Authentication expired"),console.log(u.red(`
+The authentication session expired. Please try again.`)),process.exit(1));continue}let r=await l.json();if(r.ok&&r.accessToken){let c={token:r.accessToken,email:r.user?.email,projectId:n,expiresAt:new Date(Date.now()+r.expiresIn*1e3).toISOString()};W(c),e.succeed("Logged in successfully"),console.log(""),r.user?.email&&console.log(u.green(`  Authenticated as: ${r.user.email}`)),console.log(u.gray(`  Config saved to: ${S}`)),console.log("");return}}catch{}}e.fail("Authentication timed out"),console.log(u.red(`
+Timed out waiting for browser authentication.`)),console.log(u.gray("Try again or use: vaif login --email")),process.exit(1);}async function ye(n){console.log(""),console.log(u.bold("VAIF CLI Login")),console.log(u.gray("Enter your VAIF account credentials")),console.log("");let e=await ue(u.cyan("  Email: "));(!e||e.trim()==="")&&(console.log(u.red(`
+No email provided. Login cancelled.`)),process.exit(1));let a=await pe(u.cyan("  Password: "));(!a||a.trim()==="")&&(console.log(u.red(`
+No password provided. Login cancelled.`)),process.exit(1));let t=j("Authenticating...").start();try{let o=await fetch(`${D}/auth/cli/login`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({email:e.trim(),password:a})}),i=await o.json();(!o.ok||!i.ok)&&(t.fail("Login failed"),console.log(u.red(`
+${i.message||"Invalid email or password."}`)),process.exit(1));let s={token:i.accessToken,email:i.user?.email,projectId:n,expiresAt:new Date(Date.now()+i.expiresIn*1e3).toISOString()};W(s),t.succeed("Logged in successfully"),console.log(""),i.user?.email&&console.log(u.green(`  Authenticated as: ${i.user.email}`)),console.log(u.gray(`  Config saved to: ${S}`)),console.log("");}catch{t.fail("Failed to connect to VAIF API"),console.log(u.red(`
+Could not connect to VAIF API. Please try again later.`)),process.exit(1);}}async function Qe(n){console.log(""),console.log(u.bold("Welcome to VAIF CLI")),console.log(u.gray("Authenticate to access your VAIF projects")),console.log(""),n.email?await ye(n.projectId):await he(n.projectId),console.log(u.gray("You can now use VAIF CLI commands like:")),console.log(u.gray("  vaif pull    - Pull remote schema")),console.log(u.gray("  vaif push    - Push schema changes")),console.log(u.gray("  vaif generate - Generate TypeScript types")),console.log("");}async function Ze(){v.existsSync(S)?(v.unlinkSync(S),console.log(u.green("Logged out successfully"))):console.log(u.yellow("Not currently logged in"));}async function et(){let n=R();(!n||!n.token)&&(console.log(u.yellow("Not logged in")),console.log(u.gray("Run `vaif login` to authenticate")),process.exit(1));let e=j("Checking authentication...").start(),{valid:a,email:t}=await ge(n.token);a||(e.fail("Session expired"),console.log(u.yellow(`
+Your session has expired. Please login again.`)),process.exit(1)),e.succeed("Authenticated"),console.log(""),console.log(u.green(`  Email: ${t||n.email||"Unknown"}`)),n.projectId&&console.log(u.green(`  Project: ${n.projectId}`)),console.log("");}var _e=process.env.VAIF_API_URL||"https://api.vaif.studio";async function Ee(n,e){let a=await fetch(`${_e}/schema-engine/introspect/${e}`,{headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"}});if(!a.ok){let l=await a.text();throw new Error(`API introspection failed: ${l}`)}let t=await a.json();if(!t.ok||!t.schemaExists)throw new Error("Project schema does not exist yet. Push a migration first with `vaif db push`.");let o=new Map,i=[];for(let l of t.tables){let r=l.columns.map(c=>({column_name:c.name,data_type:c.type,is_nullable:c.nullable?"YES":"NO",column_default:c.default,udt_name:c.type,is_identity:c.primaryKey&&c.default?.includes("gen_random_uuid")?"YES":"NO",character_maximum_length:null,numeric_precision:null,numeric_scale:null}));o.set(l.name,r);for(let c of l.foreignKeys)i.push({constraint_name:c.constraintName,table_name:l.name,column_name:c.columnName,foreign_table_name:c.refTable,foreign_column_name:c.refColumn});}return {tables:o,enums:new Map,foreignKeys:i}}async function Ae(n,e){let a=await n.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 a.query(`
+  `,[e]),t=await n.query(`
     SELECT
       table_name,
       column_name,
@@ -28,7 +28,7 @@ Your session has expired. Please login again.`)),process.exit(1)),t.succeed("Aut
     FROM information_schema.columns
     WHERE table_schema = $1
     ORDER BY table_name, ordinal_position
-  `,[t]),r=await a.query(`
+  `,[e]),o=await n.query(`
     SELECT
       tc.constraint_name,
       tc.table_name,
@@ -44,7 +44,7 @@ Your session has expired. Please login again.`)),process.exit(1)),t.succeed("Aut
       AND ccu.table_schema = tc.table_schema
     WHERE tc.constraint_type = 'FOREIGN KEY'
       AND tc.table_schema = $1
-  `,[t]),i=await a.query(`
+  `,[e]),i=await n.query(`
     SELECT
       t.typname as enum_name,
       e.enumlabel as enum_value
@@ -53,24 +53,24 @@ Your session has expired. Please login again.`)),process.exit(1)),t.succeed("Aut
     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 o of n.rows)c.set(o.table_name,[]);for(let o of e.rows){let s=c.get(o.table_name);s&&s.push(o);}let u=new Map;for(let o of i.rows){let s=u.get(o.enum_name)||[];s.push(o.enum_value),u.set(o.enum_name,s);}return {tables:c,enums:u,foreignKeys:r.rows}}var U={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 he(a,t){let{data_type:n,udt_name:e,is_nullable:r}=a;if(t.has(e)){let u=t.get(e).map(o=>`"${o}"`).join(" | ");return r==="YES"?`(${u}) | null`:u}if(n==="ARRAY"){let c=e.replace(/^_/,"");if(t.has(c)){let s=t.get(c).map(f=>`"${f}"`).join(" | ");return r==="YES"?`(${s})[] | null`:`(${s})[]`}let u=U[c]||"unknown";return r==="YES"?`${u}[] | null`:`${u}[]`}let i=U[n]||U[e]||"unknown";return r==="YES"&&(i=`${i} | null`),i}function D(a){return a.split(/[_\-\s]+/).map(t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()).join("")}function ve(a,t){let n=D(a),e=t.map(r=>`  | "${r}"`).join(`
-`);return `export type ${n} =
-${e};`}function ye(a,t,n){let e=D(a),r=[],i=[],c=[];for(let f of t){let h=he(f,n),d=f.column_name,m=f.column_default!==null||f.is_identity==="YES",I=f.is_nullable==="YES";r.push(`  ${d}: ${h};`),m||f.column_name==="id"?i.push(`  ${d}?: ${h.replace(" | null","")} | null;`):I?i.push(`  ${d}?: ${h};`):i.push(`  ${d}: ${h.replace(" | null","")};`),c.push(`  ${d}?: ${h.replace(" | null","")} | null;`);}let u=`export interface ${e} {
-${r.join(`
+  `,[e]),s=new Map;for(let r of a.rows)s.set(r.table_name,[]);for(let r of t.rows){let c=s.get(r.table_name);c&&c.push(r);}let l=new Map;for(let r of i.rows){let c=l.get(r.enum_name)||[];c.push(r.enum_value),l.set(r.enum_name,c);}return {tables:s,enums:l,foreignKeys:o.rows}}var M={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 Te(n,e){let{data_type:a,udt_name:t,is_nullable:o}=n;if(e.has(t)){let l=e.get(t).map(r=>`"${r}"`).join(" | ");return o==="YES"?`(${l}) | null`:l}if(a==="ARRAY"){let s=t.replace(/^_/,"");if(e.has(s)){let c=e.get(s).map(h=>`"${h}"`).join(" | ");return o==="YES"?`(${c})[] | null`:`(${c})[]`}let l=M[s]||"unknown";return o==="YES"?`${l}[] | null`:`${l}[]`}let i=M[a]||M[t]||"unknown";return o==="YES"&&(i=`${i} | null`),i}function K(n){return n.split(/[_\-\s]+/).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join("")}function Se(n,e){let a=K(n),t=e.map(o=>`  | "${o}"`).join(`
+`);return `export type ${a} =
+${t};`}function we(n,e,a){let t=K(n),o=[],i=[],s=[];for(let h of e){let m=Te(h,a),d=h.column_name,f=h.column_default!==null||h.is_identity==="YES",A=h.is_nullable==="YES";o.push(`  ${d}: ${m};`),f||h.column_name==="id"?i.push(`  ${d}?: ${m.replace(" | null","")} | null;`):A?i.push(`  ${d}?: ${m};`):i.push(`  ${d}: ${m.replace(" | null","")};`),s.push(`  ${d}?: ${m.replace(" | null","")} | null;`);}let l=`export interface ${t} {
+${o.join(`
 `)}
-}`,o=`export interface ${e}Insert {
+}`,r=`export interface ${t}Insert {
 ${i.join(`
 `)}
-}`,s=`export interface ${e}Update {
-${c.join(`
+}`,c=`export interface ${t}Update {
+${s.join(`
 `)}
-}`;return {base:u,insert:o,update:s}}function be(a,t,n){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[i,c]of t)e.push(ve(i,c)),e.push("");}e.push("// ============ TABLES ============"),e.push("");let r=[];for(let[i,c]of a){let{base:u,insert:o,update:s}=ye(i,c,t);r.push(i),e.push(u),e.push(""),e.push(o),e.push(""),e.push(s),e.push("");}e.push("// ============ DATABASE SCHEMA ============"),e.push(""),e.push("export interface Database {");for(let i of r){let c=D(i);e.push(`  ${i}: {`),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 He(a){let t=L("Loading configuration...").start();try{let n=await q(a.config),e=a.connection||n?.database?.url||process.env.DATABASE_URL,r=e&&!e.includes("${"),i,c,u;if(r){t.text="Connecting to database...";let d=new ue.Client({connectionString:e});await d.connect(),t.text="Introspecting schema...",{tables:i,enums:c,foreignKeys:u}=await ge(d,a.schema),await d.end();}else {let d=V();(!d||!d.token)&&(t.fail("No database connection and not logged in"),console.log(l.yellow(`
-Either:`)),console.log(l.gray("  1. Run `vaif login` to authenticate (no DATABASE_URL needed)")),console.log(l.gray("  2. Set DATABASE_URL in your .env file")),console.log(l.gray("  3. Pass --connection postgresql://user:pass@host:5432/db")),process.exit(1));let m=n?.projectId||process.env.VAIF_PROJECT_ID||d.projectId;m||(t.fail("No project ID specified"),console.log(l.yellow(`
-Set projectId in vaif.config.json or use VAIF_PROJECT_ID env var.`)),process.exit(1)),t.text="Introspecting schema via API...",{tables:i,enums:c,foreignKeys:u}=await fe(d.token,m);}if(i.size===0){t.warn("No tables found"),console.log(l.yellow(`
-Push a migration first: vaif db push`));return}t.text=`Generating types for ${i.size} tables...`;let o=be(i,c,u),s=await pe.format(o,{parser:"typescript",semi:!0,singleQuote:!1,trailingComma:"es5",printWidth:100});if(a.dryRun){t.succeed("Generated types (dry run):"),console.log(""),console.log(l.gray("\u2500".repeat(60))),console.log(s),console.log(l.gray("\u2500".repeat(60)));return}let f=k.resolve(a.output),h=k.dirname(f);b.existsSync(h)||b.mkdirSync(h,{recursive:!0}),b.writeFileSync(f,s,"utf-8"),t.succeed(`Generated types for ${i.size} tables \u2192 ${l.cyan(a.output)}`),console.log(""),console.log(l.green("Generated:")),console.log(l.gray(`  Tables: ${i.size}`)),console.log(l.gray(`  Enums: ${c.size}`)),console.log(""),console.log(l.gray("Import in your code:")),console.log(l.cyan(`  import type { Database, Row, Insert, Update } from "${a.output.replace(/\.ts$/,"")}";`));}catch(n){t.fail("Failed to generate types"),n instanceof Error&&(console.error(l.red(`
-Error: ${n.message}`)),n.message.includes("ECONNREFUSED")&&console.log(l.yellow(`
-Make sure your database is running and accessible.`))),process.exit(1);}}var T=[{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"}],W={"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:`{
+}`;return {base:l,insert:r,update:c}}function xe(n,e,a){let t=["/**"," * 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(e.size>0){t.push("// ============ ENUMS ============"),t.push("");for(let[i,s]of e)t.push(Se(i,s)),t.push("");}t.push("// ============ TABLES ============"),t.push("");let o=[];for(let[i,s]of n){let{base:l,insert:r,update:c}=we(i,s,e);o.push(i),t.push(l),t.push(""),t.push(r),t.push(""),t.push(c),t.push("");}t.push("// ============ DATABASE SCHEMA ============"),t.push(""),t.push("export interface Database {");for(let i of o){let s=K(i);t.push(`  ${i}: {`),t.push(`    Row: ${s};`),t.push(`    Insert: ${s}Insert;`),t.push(`    Update: ${s}Update;`),t.push("  };");}return t.push("}"),t.push(""),t.push("export type TableName = keyof Database;"),t.push(""),t.push("// ============ HELPER TYPES ============"),t.push(""),t.push('export type Row<T extends TableName> = Database[T]["Row"];'),t.push('export type Insert<T extends TableName> = Database[T]["Insert"];'),t.push('export type Update<T extends TableName> = Database[T]["Update"];'),t.push(""),t.join(`
+`)}async function ut(n){let e=j("Loading configuration...").start();try{let a=await N(n.config),t=n.connection||a?.database?.url||process.env.DATABASE_URL,o=t&&!t.includes("${"),i,s,l;if(o){e.text="Connecting to database...";let d=new ve.Client({connectionString:t});await d.connect(),e.text="Introspecting schema...",{tables:i,enums:s,foreignKeys:l}=await Ae(d,n.schema),await d.end();}else {let d=R();(!d||!d.token)&&(e.fail("No database connection and not logged in"),console.log(u.yellow(`
+Either:`)),console.log(u.gray("  1. Run `vaif login` to authenticate (no DATABASE_URL needed)")),console.log(u.gray("  2. Set DATABASE_URL in your .env file")),console.log(u.gray("  3. Pass --connection postgresql://user:pass@host:5432/db")),process.exit(1));let f=a?.projectId||process.env.VAIF_PROJECT_ID||d.projectId;f||(e.fail("No project ID specified"),console.log(u.yellow(`
+Set projectId in vaif.config.json or use VAIF_PROJECT_ID env var.`)),process.exit(1)),e.text="Introspecting schema via API...",{tables:i,enums:s,foreignKeys:l}=await Ee(d.token,f);}if(i.size===0){e.warn("No tables found"),console.log(u.yellow(`
+Push a migration first: vaif db push`));return}e.text=`Generating types for ${i.size} tables...`;let r=xe(i,s,l),c=await Ie.format(r,{parser:"typescript",semi:!0,singleQuote:!1,trailingComma:"es5",printWidth:100});if(n.dryRun){e.succeed("Generated types (dry run):"),console.log(""),console.log(u.gray("\u2500".repeat(60))),console.log(c),console.log(u.gray("\u2500".repeat(60)));return}let h=I.resolve(n.output),m=I.dirname(h);v.existsSync(m)||v.mkdirSync(m,{recursive:!0}),v.writeFileSync(h,c,"utf-8"),e.succeed(`Generated types for ${i.size} tables \u2192 ${u.cyan(n.output)}`),console.log(""),console.log(u.green("Generated:")),console.log(u.gray(`  Tables: ${i.size}`)),console.log(u.gray(`  Enums: ${s.size}`)),console.log(""),console.log(u.gray("Import in your code:")),console.log(u.cyan(`  import type { Database, Row, Insert, Update } from "${n.output.replace(/\.ts$/,"")}";`));}catch(a){e.fail("Failed to generate types"),a instanceof Error&&(console.error(u.red(`
+Error: ${a.message}`)),a.message.includes("ECONNREFUSED")&&console.log(u.yellow(`
+Make sure your database is running and accessible.`))),process.exit(1);}}var C=[{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"}],ee={"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",
@@ -180,7 +180,7 @@ export function createVaifServer() {
   });
 }
 `},{path:".env.local.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys \u2192 Project Settings \u2192 API Keys
+# Get these values from https://console.vaif.studio/security/api-keys \u2192 Project Settings \u2192 API Keys
 
 NEXT_PUBLIC_VAIF_API_URL=https://api.vaif.studio
 NEXT_PUBLIC_VAIF_PROJECT_ID=your-project-id
@@ -221,7 +221,7 @@ A full-stack Next.js application powered by [VAIF Studio](https://vaif.studio),
    cp .env.local.example .env.local
    \\\`\\\`\\\`
 
-   Get your Project ID, API Key, and Secret Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID, API Key, and Secret Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -695,7 +695,7 @@ interface ImportMeta {
   readonly env: ImportMetaEnv;
 }
 `},{path:".env.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys
+# Get these values from https://console.vaif.studio/security/api-keys
 
 VITE_VAIF_API_URL=https://api.vaif.studio
 VITE_VAIF_PROJECT_ID=your-project-id
@@ -729,7 +729,7 @@ A single-page React application built with [Vite](https://vite.dev/) and powered
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID and API Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID and API Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -1252,7 +1252,7 @@ An iOS/macOS application powered by [VAIF Studio](https://vaif.studio), using th
    <string>your-anon-key</string>
    \\\`\\\`\\\`
 
-   Get your credentials from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your credentials from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI** (for type generation)
 
@@ -1381,7 +1381,7 @@ export const vaif = createExpoClient({
   realtime: { enabled: true },
 });
 `},{path:".env.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys \u2192 Project Settings \u2192 API Keys
+# Get these values from https://console.vaif.studio/security/api-keys \u2192 Project Settings \u2192 API Keys
 
 EXPO_PUBLIC_VAIF_PROJECT_ID=your-project-id
 EXPO_PUBLIC_VAIF_API_KEY=your-anon-key
@@ -1418,7 +1418,7 @@ A React Native / Expo mobile application powered by [VAIF Studio](https://vaif.s
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID and API Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID and API Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -1853,7 +1853,7 @@ A Flutter application powered by [VAIF Studio](https://vaif.studio), with Dart c
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID and API Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID and API Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI** (for schema and type generation)
 
@@ -2111,7 +2111,7 @@ 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/app/security/api-keys \u2192 Project Settings \u2192 API Keys
+# Get these values from https://console.vaif.studio/security/api-keys \u2192 Project Settings \u2192 API Keys
 
 VAIF_PROJECT_ID=your-project-id
 VAIF_API_KEY=your-anon-key
@@ -2153,7 +2153,7 @@ A FastAPI backend application powered by [VAIF Studio](https://vaif.studio), wit
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID, API Key, and Secret Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID, API Key, and Secret Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 4. **Install and log in to the VAIF CLI**
 
@@ -2476,7 +2476,7 @@ A Go backend API powered by [VAIF Studio](https://vaif.studio), with HTTP handle
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID, API Key, and Secret Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID, API Key, and Secret Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -2751,7 +2751,7 @@ export async function deleteTodo(id: string): Promise<void> {
   if (error) throw error;
 }
 `},{path:".env.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys
+# Get these values from https://console.vaif.studio/security/api-keys
 
 VITE_VAIF_API_URL=https://api.vaif.studio
 VITE_VAIF_PROJECT_ID=your-project-id
@@ -2780,7 +2780,7 @@ A simple React todo application for learning [VAIF Studio](https://vaif.studio)
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID and API Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID and API Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -3031,7 +3031,7 @@ export function useRealtimeMessages({
   return { messages, isLoading, error, refresh };
 }
 `},{path:".env.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys
+# Get these values from https://console.vaif.studio/security/api-keys
 
 VITE_VAIF_API_URL=https://api.vaif.studio
 VITE_VAIF_PROJECT_ID=your-project-id
@@ -3060,7 +3060,7 @@ A React chat application with live messaging powered by [VAIF Studio](https://va
    cp .env.example .env
    \\\`\\\`\\\`
 
-   Get your Project ID and API Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID and API Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -3347,7 +3347,7 @@ export async function requireTeamRole(
   return member as TeamMember;
 }
 `},{path:".env.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys \u2192 Project Settings \u2192 API Keys
+# Get these values from https://console.vaif.studio/security/api-keys \u2192 Project Settings \u2192 API Keys
 
 NEXT_PUBLIC_VAIF_API_URL=https://api.vaif.studio
 NEXT_PUBLIC_VAIF_PROJECT_ID=your-project-id
@@ -3380,7 +3380,7 @@ A full SaaS starter kit powered by [VAIF Studio](https://vaif.studio) with authe
    cp .env.example .env.local
    \\\`\\\`\\\`
 
-   Get your Project ID, API Key, and Secret Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID, API Key, and Secret Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -3625,7 +3625,7 @@ function getContentType(fileName: string): string {
   return mimeTypes[ext ?? ""] ?? "application/octet-stream";
 }
 `},{path:".env.example",content:`# VAIF Configuration
-# Get these values from https://vaif.studio/app/security/api-keys \u2192 Project Settings \u2192 API Keys
+# Get these values from https://console.vaif.studio/security/api-keys \u2192 Project Settings \u2192 API Keys
 
 NEXT_PUBLIC_VAIF_API_URL=https://api.vaif.studio
 NEXT_PUBLIC_VAIF_PROJECT_ID=your-project-id
@@ -3658,7 +3658,7 @@ An API-first e-commerce setup powered by [VAIF Studio](https://vaif.studio) with
    cp .env.example .env.local
    \\\`\\\`\\\`
 
-   Get your Project ID, API Key, and Secret Key from <https://vaif.studio/app/security/api-keys> under **Project Settings > API Keys**.
+   Get your Project ID, API Key, and Secret Key from <https://console.vaif.studio/security/api-keys> under **Project Settings > API Keys**.
 
 3. **Install and log in to the VAIF CLI**
 
@@ -3774,16 +3774,1356 @@ export const posts = pgTable("posts", {
 
   return Response.json({ message: \`Hello, \${name}!\` });
 }
-`}]},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 tt(){console.log(""),console.log(l.bold("Available project templates")),console.log("");let a=26,t=22;console.log(`  ${l.gray("Template".padEnd(a))}${l.gray("Stack".padEnd(t))}${l.gray("Description")}`),console.log(l.gray("  "+"-".repeat(a+t+40)));for(let[n,e]of Object.entries(W))console.log(`  ${l.cyan(n.padEnd(a))}${l.yellow(e.tag.padEnd(t))}${l.white(e.description)}`);console.log(""),console.log(l.gray("Usage:")),console.log(l.gray("  npx @vaiftech/cli init --template <name>")),console.log(l.gray("  npx @vaiftech/cli init -t nextjs-fullstack")),console.log(l.gray("  npx @vaiftech/cli init -t react-spa --features auth,database,realtime")),console.log(""),console.log(l.gray("Available features: auth, database, realtime, storage, functions")),console.log("");}async function Ie(a){if(!process.stdin.isTTY||!process.stdout.isTTY)return a;let t=new Set(a.map(e=>T.findIndex(r=>r.name===e)).filter(e=>e>=0)),n=0;return new Promise(e=>{let r=$.createInterface({input:process.stdin,output:process.stdout});$.emitKeypressEvents(process.stdin,r),process.stdin.setRawMode&&process.stdin.setRawMode(true);function i(){let u=T.length+2;process.stdout.write(`\x1B[${u}A`),c();}function c(){console.log(l.bold(`
-? Which VAIF features do you want to include?`)),T.forEach((u,o)=>{let s=t.has(o)?l.green("[x]"):"[ ]",f=o===n?l.cyan("> "):"  ";console.log(`${f}${s} ${u.label} ${l.gray(`(${u.description})`)}`);}),console.log(l.gray("  (up/down to move, space to toggle, enter to confirm)"));}c(),process.stdin.on("keypress",(u,o)=>{if(o.name==="up"&&n>0)n--,i();else if(o.name==="down"&&n<T.length-1)n++,i();else if(o.name==="space")t.has(n)?t.delete(n):t.add(n),i();else if(o.name==="return"){process.stdin.setRawMode&&process.stdin.setRawMode(false),r.close();let s=[...t].sort().map(f=>T[f].name);e(s.length>0?s:a);}else o.name==="c"&&o.ctrl&&(process.stdin.setRawMode&&process.stdin.setRawMode(false),r.close(),process.exit(0));});})}async function j(a,t={}){let n=W[a];n||(console.log(l.red(`
-Unknown template: ${a}`)),console.log(l.yellow(`Run 'vaif templates' to see available templates.
-`)),process.exit(1));let e;t.features&&t.features.length>0?e=t.features.filter(d=>T.some(m=>m.name===d)):t.addOnly?(console.log(l.red(`
-No features specified.`)),console.log(l.yellow("Usage: vaif init --template <name> --add-features <features>")),console.log(l.gray("Available features: auth, database, realtime, storage, functions")),process.exit(1)):n.featureFiles&&Object.keys(n.featureFiles).length>0?e=await Ie(n.defaultFeatures??["database","auth"]):e=n.defaultFeatures??[],t.addOnly?(console.log(""),console.log(l.bold(`Adding features to ${l.cyan(n.name)} project...`)),console.log(l.gray(`  Features: ${e.join(", ")}`)),console.log("")):(console.log(""),console.log(l.bold(`Scaffolding ${l.cyan(n.name)} template...`)),e.length>0&&console.log(l.gray(`  Features: ${e.join(", ")}`)),console.log(""));let r=t.addOnly?[]:[...n.files],i=new Set,c=[];if(n.featureFiles)for(let d of e){let m=n.featureFiles[d];if(m)for(let I of m)i.add(I.path),c.push(I);}let u=r.filter(d=>!i.has(d.path)).concat(c),o=0,s=0;for(let d of u){let m=k.resolve(d.path),I=k.dirname(m);if(b.existsSync(I)||b.mkdirSync(I,{recursive:true}),d.path==="package.json"&&b.existsSync(m)&&!t.force)try{let y=JSON.parse(b.readFileSync(m,"utf-8")),E=JSON.parse(d.content),S=M=>{if(!M)return {};let K={};for(let[X,w]of Object.entries(M))!w.startsWith("workspace:")&&!w.startsWith("link:")&&!w.startsWith("file:")&&(K[X]=w);return K};y.dependencies={...S(y.dependencies),...E.dependencies||{}},y.devDependencies={...S(y.devDependencies),...E.devDependencies||{}},E.scripts&&(y.scripts={...y.scripts||{},...E.scripts}),b.writeFileSync(m,JSON.stringify(y,null,2)+`
-`,"utf-8"),console.log(l.green(`  merge   ${d.path}  (added dependencies)`)),o++;continue}catch{}if(b.existsSync(m)&&!t.force){console.log(l.yellow(`  skip  ${d.path}  (already exists)`)),s++;continue}b.writeFileSync(m,d.content,"utf-8"),console.log(l.green(`  create  ${d.path}`)),o++;}console.log(""),o>0&&console.log(l.green(`Created ${o} file${o!==1?"s":""}.`)),s>0&&console.log(l.yellow(`Skipped ${s} file${s!==1?"s":""} (use --force to overwrite).`));let f={auth:{"@vaiftech/auth":"^1.0.0"},database:{},realtime:{},storage:{},functions:{}},h=k.resolve("package.json");if(b.existsSync(h)&&e.length>0)try{let d=JSON.parse(b.readFileSync(h,"utf-8")),m=!1;for(let I of e){let y=f[I];if(y)for(let[E,S]of Object.entries(y))d.dependencies?.[E]||(d.dependencies=d.dependencies||{},d.dependencies[E]=S,m=!0);}m&&b.writeFileSync(h,JSON.stringify(d,null,2)+`
-`,"utf-8");}catch{}(n.dependencies?.length||n.devDependencies?.length)&&(console.log(""),console.log(l.bold("Install dependencies:")),n.dependencies?.length&&console.log(l.cyan(`  npm install ${n.dependencies.join(" ")}`)),n.devDependencies?.length&&console.log(l.cyan(`  npm install -D ${n.devDependencies.join(" ")}`))),console.log(""),console.log(l.bold.green("Project scaffolded successfully!")),console.log(""),console.log(l.bold("  Next steps:")),n.postInstructions.forEach(d=>{console.log(l.gray(`    ${d}`));}),console.log(""),console.log(l.gray("  Get your project credentials at https://vaif.studio/app/security/api-keys")),console.log("");}var _e={$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 ct(a){if(a.addFeatures){a.template||(console.log(l.red(`
---add-features requires --template to know which template to use.`)),console.log(l.gray("Example: vaif init --template react-spa --add-features functions,storage")),process.exit(1));let e=a.addFeatures.split(",").map(r=>r.trim());await j(a.template,{force:a.force,features:e,addOnly:true});return}let t=L("Initializing VAIF configuration...").start(),n=k.resolve("vaif.config.json");b.existsSync(n)&&!a.force&&(t.fail("vaif.config.json already exists"),console.log(l.yellow(`
-Use --force to overwrite existing configuration.`)),process.exit(1));try{if(b.writeFileSync(n,JSON.stringify(_e,null,2),"utf-8"),t.succeed("Created vaif.config.json"),a.template){let e=a.features?a.features.split(",").map(r=>r.trim()):void 0;await j(a.template,{force:a.force,features:e});}else {let e=k.resolve(".env.example");if(b.existsSync(e)||(b.writeFileSync(e,`# VAIF Configuration
+`}]},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 vt(){console.log(""),console.log(u.bold("Available project templates")),console.log("");let n=26,e=22;console.log(`  ${u.gray("Template".padEnd(n))}${u.gray("Stack".padEnd(e))}${u.gray("Description")}`),console.log(u.gray("  "+"-".repeat(n+e+40)));for(let[a,t]of Object.entries(ee))console.log(`  ${u.cyan(a.padEnd(n))}${u.yellow(t.tag.padEnd(e))}${u.white(t.description)}`);console.log(""),console.log(u.gray("Usage:")),console.log(u.gray("  npx @vaiftech/cli init --template <name>")),console.log(u.gray("  npx @vaiftech/cli init -t nextjs-fullstack")),console.log(u.gray("  npx @vaiftech/cli init -t react-spa --features auth,database,realtime")),console.log(""),console.log(u.gray("Available features: auth, database, realtime, storage, functions")),console.log("");}async function Pe(n){if(!process.stdin.isTTY||!process.stdout.isTTY)return n;let e=new Set(n.map(t=>C.findIndex(o=>o.name===t)).filter(t=>t>=0)),a=0;return new Promise(t=>{let o=H.createInterface({input:process.stdin,output:process.stdout});H.emitKeypressEvents(process.stdin,o),process.stdin.setRawMode&&process.stdin.setRawMode(true);function i(){let l=C.length+2;process.stdout.write(`\x1B[${l}A`),s();}function s(){console.log(u.bold(`
+? Which VAIF features do you want to include?`)),C.forEach((l,r)=>{let c=e.has(r)?u.green("[x]"):"[ ]",h=r===a?u.cyan("> "):"  ";console.log(`${h}${c} ${l.label} ${u.gray(`(${l.description})`)}`);}),console.log(u.gray("  (up/down to move, space to toggle, enter to confirm)"));}s(),process.stdin.on("keypress",(l,r)=>{if(r.name==="up"&&a>0)a--,i();else if(r.name==="down"&&a<C.length-1)a++,i();else if(r.name==="space")e.has(a)?e.delete(a):e.add(a),i();else if(r.name==="return"){process.stdin.setRawMode&&process.stdin.setRawMode(false),o.close();let c=[...e].sort().map(h=>C[h].name);t(c.length>0?c:n);}else r.name==="c"&&r.ctrl&&(process.stdin.setRawMode&&process.stdin.setRawMode(false),o.close(),process.exit(0));});})}async function q(n,e={}){let a=ee[n];a||(console.log(u.red(`
+Unknown template: ${n}`)),console.log(u.yellow(`Run 'vaif templates' to see available templates.
+`)),process.exit(1));let t;e.features&&e.features.length>0?t=e.features.filter(d=>C.some(f=>f.name===d)):e.addOnly?(console.log(u.red(`
+No features specified.`)),console.log(u.yellow("Usage: vaif init --template <name> --add-features <features>")),console.log(u.gray("Available features: auth, database, realtime, storage, functions")),process.exit(1)):a.featureFiles&&Object.keys(a.featureFiles).length>0?t=await Pe(a.defaultFeatures??["database","auth"]):t=a.defaultFeatures??[],e.addOnly?(console.log(""),console.log(u.bold(`Adding features to ${u.cyan(a.name)} project...`)),console.log(u.gray(`  Features: ${t.join(", ")}`)),console.log("")):(console.log(""),console.log(u.bold(`Scaffolding ${u.cyan(a.name)} template...`)),t.length>0&&console.log(u.gray(`  Features: ${t.join(", ")}`)),console.log(""));let o=e.addOnly?[]:[...a.files],i=new Set,s=[];if(a.featureFiles)for(let d of t){let f=a.featureFiles[d];if(f)for(let A of f)i.add(A.path),s.push(A);}let l=o.filter(d=>!i.has(d.path)).concat(s),r=0,c=0;for(let d of l){let f=I.resolve(d.path),A=I.dirname(f);if(v.existsSync(A)||v.mkdirSync(A,{recursive:true}),d.path==="package.json"&&v.existsSync(f)&&!e.force)try{let _=JSON.parse(v.readFileSync(f,"utf-8")),w=JSON.parse(d.content),U=z=>{if(!z)return {};let Y={};for(let[oe,L]of Object.entries(z))!L.startsWith("workspace:")&&!L.startsWith("link:")&&!L.startsWith("file:")&&(Y[oe]=L);return Y};_.dependencies={...U(_.dependencies),...w.dependencies||{}},_.devDependencies={...U(_.devDependencies),...w.devDependencies||{}},w.scripts&&(_.scripts={..._.scripts||{},...w.scripts}),v.writeFileSync(f,JSON.stringify(_,null,2)+`
+`,"utf-8"),console.log(u.green(`  merge   ${d.path}  (added dependencies)`)),r++;continue}catch{}if(v.existsSync(f)&&!e.force){console.log(u.yellow(`  skip  ${d.path}  (already exists)`)),c++;continue}v.writeFileSync(f,d.content,"utf-8"),console.log(u.green(`  create  ${d.path}`)),r++;}console.log(""),r>0&&console.log(u.green(`Created ${r} file${r!==1?"s":""}.`)),c>0&&console.log(u.yellow(`Skipped ${c} file${c!==1?"s":""} (use --force to overwrite).`));let h={auth:{"@vaiftech/auth":"^1.0.0"},database:{},realtime:{},storage:{},functions:{}},m=I.resolve("package.json");if(v.existsSync(m)&&t.length>0)try{let d=JSON.parse(v.readFileSync(m,"utf-8")),f=!1;for(let A of t){let _=h[A];if(_)for(let[w,U]of Object.entries(_))d.dependencies?.[w]||(d.dependencies=d.dependencies||{},d.dependencies[w]=U,f=!0);}f&&v.writeFileSync(m,JSON.stringify(d,null,2)+`
+`,"utf-8");}catch{}(a.dependencies?.length||a.devDependencies?.length)&&(console.log(""),console.log(u.bold("Install dependencies:")),a.dependencies?.length&&console.log(u.cyan(`  npm install ${a.dependencies.join(" ")}`)),a.devDependencies?.length&&console.log(u.cyan(`  npm install -D ${a.devDependencies.join(" ")}`))),console.log(""),console.log(u.bold.green("Project scaffolded successfully!")),console.log(""),console.log(u.bold("  Next steps:")),a.postInstructions.forEach(d=>{console.log(u.gray(`    ${d}`));}),console.log(""),console.log(u.gray("  Get your project credentials at https://console.vaif.studio/security/api-keys")),console.log("");}var F=process.env.VAIF_API_URL||"https://api.vaif.studio";function Fe(n){let e=H.createInterface({input:process.stdin,output:process.stdout});return new Promise(a=>{e.question(n,t=>{e.close(),a(t.trim());});})}function Re(n,e,a){return n.projectId||e?.projectId||process.env.VAIF_PROJECT_ID||a.projectId||null}async function Ue(n){let e=j("Fetching your projects...").start();try{let a=await fetch(`${F}/projects`,{headers:{Authorization:`Bearer ${n}`}});if(!a.ok)return e.fail("Could not fetch projects"),null;let t=await a.json();if(!t||t.length===0)return e.fail("No projects found. Create a project at https://vaif.studio first."),null;if(t.length===1)return e.succeed(`Found project: ${u.cyan(t[0].name)} (${t[0].id})`),t[0].id;e.succeed(`Found ${t.length} projects
+`);for(let s=0;s<t.length;s++)console.log(u.gray(`  ${s+1}.`)+` ${u.white(t[s].name)} ${u.gray(`(${t[s].id})`)}`);console.log("");let o=await Fe(u.cyan(`  Select a project [1-${t.length}]: `)),i=parseInt(o,10)-1;return isNaN(i)||i<0||i>=t.length?(console.log(u.red(`
+  Invalid selection.`)),null):t[i].id}catch{return e.fail("Could not fetch projects"),null}}function Le(n){if(!n||n.length===0)return "*No tables found. Create tables in the VAIF Studio dashboard.*";let e="";for(let a of n){e+=`### \`${a.name}\`
+
+`,e+=`| Column | Type | Nullable | Default | Constraints |
+`,e+=`|--------|------|----------|---------|-------------|
+`;for(let t of a.columns){let o=[];t.isPrimaryKey&&o.push("PK"),t.nullable||o.push("NOT NULL");let i=a.foreignKeys?.find(s=>s.column===t.name);i&&o.push(`FK \u2192 ${i.foreignTable}.${i.foreignColumn}`),e+=`| ${t.name} | ${t.type} | ${t.nullable?"yes":"no"} | ${t.defaultValue||"-"} | ${o.join(", ")||"-"} |
+`;}e+=`
+`;}return e}function Ne(n,e,a){let t=n.slice(0,3);if(t.length===0)return "";let o="";for(let i of t){let s=i.columns.filter(r=>!r.isPrimaryKey&&r.name!=="created_at"&&r.name!=="updated_at"),l=s.slice(0,3).map(r=>`  ${r.name}: ${De(r)}`).join(`,
+`);o+=`### \`${i.name}\`
+
+`,o+="```typescript\n",o+=`// Select all
+const ${i.name} = await vaif.from("${i.name}").select();
+
+`,o+=`// Select with filter
+const filtered = await vaif.from("${i.name}").select().eq("${s[0]?.name||"id"}", value);
+
+`,o+=`// Insert
+const created = await vaif.from("${i.name}").insert({
+${l}
+});
+
+`,o+=`// Update
+await vaif.from("${i.name}").update(recordId, {
+  ${s[0]?.name||"name"}: newValue
+});
+
+`,o+=`// Delete
+await vaif.from("${i.name}").delete(recordId);
+`,o+="```\n\n",i===t[0]&&(o+=`#### Direct REST API (fetch)
+
+`,o+="```typescript\n",o+=`// GET all rows (returns { data: [...], count: N })
+`,o+=`const res = await fetch("${e}/generated/${i.name}", {
+`,o+=`  headers: { "x-vaif-key": "${a}" },
+`,o+=`});
+`,o+=`const { data } = await res.json();
+
+`,o+=`// GET single row (returns { data: {...} })
+`,o+=`const res2 = await fetch("${e}/generated/${i.name}/\${id}", {
+`,o+=`  headers: { "x-vaif-key": "${a}" },
+`,o+=`});
+`,o+=`const { data: record } = await res2.json();
+`,o+="```\n\n");}return o}function De(n){let e=n.type.toLowerCase();return e.includes("uuid")?'"crypto.randomUUID()"':e.includes("int")||e.includes("serial")?"42":e.includes("bool")?"true":e.includes("timestamp")||e.includes("date")?'"new Date().toISOString()"':e.includes("json")?"{}":e.includes("float")||e.includes("numeric")||e.includes("decimal")||e.includes("double")?"3.14":`"example_${n.name}"`}function ke(n){let{projectId:e,apiKey:a,apiUrl:t,projectName:o,schema:i}=n,s=Le(i.tables),l=Ne(i.tables,t,a);return `# VAIF Studio Backend
+
+This project uses **VAIF Studio** as its backend. Project: **${o}** (\`${e}\`).
+
+## SDK Setup
+
+\`\`\`bash
+npm install @vaiftech/client
+\`\`\`
+
+\`\`\`typescript
+import { createVaifClient } from "@vaiftech/client";
+
+const vaif = createVaifClient({
+  baseUrl: "${t}",
+  projectId: "${e}",
+  apiKey: "${a}",
+});
+\`\`\`
+
+## Database Schema
+
+${s}
+
+## CRUD Examples
+
+${l}
+
+## Authentication (End-User Auth)
+
+VAIF provides **project-scoped** authentication for your app's end-users. All auth routes are scoped to your project ID.
+
+### API Routes
+
+| Route | Method | Auth | Description |
+|-------|--------|------|-------------|
+| \`/projects/${e}/auth/signup\` | POST | None (public) | Register a new user |
+| \`/projects/${e}/auth/login\` | POST | None (public) | Login with email/password |
+| \`/projects/${e}/auth/refresh\` | POST | Cookie | Refresh access token |
+
+### Signup
+
+\`\`\`typescript
+const res = await fetch("${t}/projects/${e}/auth/signup", {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({
+    email: "user@example.com",
+    password: "securePassword123",
+    metadata: { displayName: "Jane Doe" },  // optional
+  }),
+});
+const { accessToken, expiresIn, user } = await res.json();
+// accessToken: JWT with { sub: userId, email, projectId, type: "project_user" }
+\`\`\`
+
+### Login
+
+\`\`\`typescript
+const res = await fetch("${t}/projects/${e}/auth/login", {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({
+    email: "user@example.com",
+    password: "securePassword123",
+  }),
+});
+const { accessToken, expiresIn, user } = await res.json();
+\`\`\`
+
+### Token Refresh
+
+\`\`\`typescript
+// Refresh token is stored as httpOnly cookie (project_refresh_token)
+// and sent automatically with same-origin requests
+const res = await fetch("${t}/projects/${e}/auth/refresh", {
+  method: "POST",
+  credentials: "include",  // sends the httpOnly cookie
+});
+const { accessToken, expiresIn, user } = await res.json();
+\`\`\`
+
+### Using Auth in Your App
+
+\`\`\`typescript
+// Store the access token and use it for authenticated requests
+const headers = {
+  Authorization: \\\`Bearer \\\${accessToken}\\\`,
+  "x-vaif-key": "${a}",
+};
+
+// The JWT contains: { sub: userId, email, projectId, type: "project_user" }
+// Use this with RLS to scope data to the current user
+\`\`\`
+
+> **Important**: Auth routes are at \`/projects/{projectId}/auth/*\`, NOT \`/auth/*\`. The \`/auth/*\` routes are for VAIF Studio platform accounts, not your app's end-users.
+
+## Storage
+
+\`\`\`typescript
+// Upload a file
+const { url } = await vaif.storage.upload("avatars", file, {
+  contentType: "image/png",
+});
+
+// Download a file
+const blob = await vaif.storage.download("avatars", "photo.png");
+
+// Create a signed URL (expiring)
+const { signedUrl } = await vaif.storage.createSignedUrl("avatars", "photo.png", {
+  expiresIn: 3600,
+});
+
+// List files in a bucket
+const files = await vaif.storage.list("avatars", { limit: 100 });
+\`\`\`
+
+## Functions
+
+\`\`\`typescript
+// Invoke a serverless function
+const result = await vaif.functions.invoke("send_welcome_email", {
+  body: { userId: "user_123", template: "welcome" },
+});
+\`\`\`
+
+> **Function naming**: Names must be alphanumeric and underscores only (\`^[a-zA-Z0-9_]+$\`). Use \`send_email\` not \`send-email\`.
+
+## Realtime
+
+\`\`\`typescript
+// Subscribe to a channel
+const channel = vaif.realtime.channel("my-channel");
+
+// Listen for postgres changes
+channel.on("postgres_changes", {
+  event: "INSERT",
+  schema: "public",
+  table: "messages",
+}, (payload) => {
+  console.log("New message:", payload.new);
+});
+
+// Listen for UPDATE events
+channel.on("postgres_changes", {
+  event: "UPDATE",
+  schema: "public",
+  table: "messages",
+}, (payload) => {
+  console.log("Updated:", payload.new, "was:", payload.old);
+});
+
+// Listen for DELETE events
+channel.on("postgres_changes", {
+  event: "DELETE",
+  schema: "public",
+  table: "messages",
+}, (payload) => {
+  console.log("Deleted:", payload.old);
+});
+
+// Subscribe to start receiving events
+channel.subscribe();
+
+// Unsubscribe when done
+channel.unsubscribe();
+\`\`\`
+
+## Row-Level Security (RLS)
+
+Filter data per-user by sending the \`X-VAIF-RLS\` header with your requests. The header format is \`field:value\`, comma-separated for multiple fields.
+
+\`\`\`typescript
+// SDK: pass RLS context to scope queries to the current user
+const posts = await vaif.from("posts").select({
+  headers: { "x-vaif-rls": \`user_id:\${currentUser.id}\` },
+});
+
+// Multiple RLS fields (e.g., multi-tenant + user scoping)
+const data = await vaif.from("documents").select({
+  headers: { "x-vaif-rls": \`org_id:\${orgId},user_id:\${userId}\` },
+});
+\`\`\`
+
+**How it works:**
+- On **SELECT / UPDATE / DELETE**: RLS fields are added as WHERE conditions (e.g., \`WHERE user_id = $1\`)
+- On **INSERT**: RLS fields are auto-populated into the record if not already provided
+- This enables multi-tenant data isolation without database-level RLS policies
+
+## Realtime Setup
+
+Enable realtime on your tables, then subscribe to live changes:
+
+\`\`\`typescript
+// 1. Enable realtime on tables via API
+await fetch("${t}/realtime/install", {
+  method: "POST",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    projectId: "${e}",
+    tables: ["messages", "notifications"],
+  }),
+});
+
+// 2. Subscribe to changes via SDK
+const channel = vaif.realtime.channel("chat-room");
+
+channel.on("postgres_changes", {
+  event: "*",        // INSERT, UPDATE, DELETE, or * for all
+  schema: "public",
+  table: "messages",
+}, (payload) => {
+  console.log("Change:", payload.eventType, payload.new);
+});
+
+channel.subscribe();
+
+// 3. Presence: track who's online
+channel.on("presence", { event: "sync" }, () => {
+  const state = channel.presenceState();
+  console.log("Online users:", Object.keys(state));
+});
+channel.track({ user_id: currentUser.id, status: "online" });
+
+// 4. Broadcast: send ephemeral messages (typing indicators, cursors)
+channel.send({
+  type: "broadcast",
+  event: "typing",
+  payload: { userId: currentUser.id },
+});
+
+// Cleanup
+channel.unsubscribe();
+\`\`\`
+
+## Storage Policies
+
+Control who can access storage buckets with RLS-style policies:
+
+\`\`\`typescript
+// Create a policy: only the uploader can read their own files
+await fetch("${t}/storage/buckets/\${bucketId}/policies", {
+  method: "POST",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "owner_read",
+    operation: "SELECT",         // SELECT | INSERT | UPDATE | DELETE | ALL
+    definition: "auth.uid() = owner_id",
+  }),
+});
+
+// Create a policy: authenticated users can upload
+await fetch("${t}/storage/buckets/\${bucketId}/policies", {
+  method: "POST",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    name: "auth_insert",
+    operation: "INSERT",
+    definition: "auth.uid() IS NOT NULL",
+  }),
+});
+\`\`\`
+
+## Edge Function Deployment
+
+Create and deploy serverless functions:
+
+\`\`\`typescript
+// 1. Create a function
+const fn = await fetch("${t}/functions", {
+  method: "POST",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    projectId: "${e}",
+    name: "send_welcome_email",
+    runtime: "nodejs20",       // nodejs20 (default)
+    entrypoint: "index.ts",    // default
+    timeoutMs: 10000,          // 1000\u201330000ms, default 10000
+  }),
+});
+
+// 2. Deploy source code
+await fetch(\`${t}/functions/\${fn.id}/source\`, {
+  method: "PUT",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    sourceCode: \`
+      export default async function handler(req, ctx) {
+        const { userId } = req.body;
+        // ctx.secrets contains your encrypted secrets
+        const apiKey = ctx.secrets.SENDGRID_KEY;
+        return { status: "sent", userId };
+      }
+    \`,
+  }),
+});
+
+// 3. Invoke the function
+const result = await vaif.functions.invoke("send_welcome_email", {
+  body: { userId: "user_123" },
+});
+\`\`\`
+
+### Authenticated Context in Functions
+
+Access the caller's verified identity via \\\`vaif.auth\\\`:
+
+\`\`\`typescript
+export default async function handler(req) {
+  const auth = vaif.auth;
+  // auth.type = 'user' | 'api_key' | 'function'
+  // auth.userId    \u2014 User ID (for user/function types)
+  // auth.email     \u2014 User email (for user type)
+  // auth.projectId \u2014 Always present
+  // auth.scopes    \u2014 API key scopes (for api_key type)
+
+  if (!auth || auth.type !== 'user') {
+    return { statusCode: 401, body: { error: 'Unauthorized' } };
+  }
+
+  return { body: { message: "Hello " + auth.email } };
+}
+\`\`\`
+
+### Function-to-Function Invocation
+
+Call other functions from within a handler:
+
+\`\`\`typescript
+export default async function handler(req) {
+  const result = await vaif.invoke("send_email", {
+    to: "user@example.com",
+    subject: "Hello",
+  });
+  return { statusCode: 200, body: result };
+}
+\`\`\`
+
+### Database Triggers
+
+Fire functions automatically on insert/update/delete events. Configure triggers via the API:
+
+\`\`\`
+POST /functions/\\\${functionId}/triggers
+{ "event": "db.insert", "tableName": "orders", "enabled": true }
+\`\`\`
+
+## API Key Management
+
+API keys are project-scoped and used for data-plane authentication (CRUD, storage, functions).
+
+\`\`\`typescript
+// Create a new API key
+const { key } = await fetch("${t}/projects/${e}/api-keys", {
+  method: "POST",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({ name: "production-frontend" }),
+}).then(r => r.json());
+
+// List keys
+const keys = await fetch("${t}/projects/${e}/api-keys", {
+  headers: { Authorization: \`Bearer \${token}\` },
+}).then(r => r.json());
+
+// Rotate a key (generates new secret, old key stops working)
+await fetch(\`${t}/projects/${e}/api-keys/\${keyId}/rotate\`, {
+  method: "POST",
+  headers: { Authorization: \`Bearer \${token}\` },
+});
+
+// Revoke a key
+await fetch(\`${t}/projects/${e}/api-keys/\${keyId}/revoke\`, {
+  method: "POST",
+  headers: { Authorization: \`Bearer \${token}\` },
+});
+\`\`\`
+
+## Secrets & Environment Variables
+
+Secrets are encrypted at rest and injected into function invocations at runtime.
+
+\`\`\`typescript
+// Set a secret (via API)
+await fetch("${t}/functions/secrets", {
+  method: "POST",
+  headers: {
+    Authorization: \`Bearer \${token}\`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    projectId: "${e}",
+    key: "STRIPE_SECRET_KEY",
+    value: "sk_live_...",
+  }),
+});
+
+// Or use the CLI
+// vaif secrets set STRIPE_SECRET_KEY sk_live_...
+// vaif secrets list
+// vaif secrets delete STRIPE_SECRET_KEY
+\`\`\`
+
+**Accessing secrets in functions:**
+
+\`\`\`typescript
+export default async function handler(req, ctx) {
+  const stripe = new Stripe(ctx.secrets.STRIPE_SECRET_KEY);
+  // ...
+}
+\`\`\`
+
+## API Reference Notes
+
+### Filter Syntax
+
+The SDK supports these filter operators:
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| \`eq\` | Equal | \`.eq("status", "active")\` |
+| \`neq\` | Not equal | \`.neq("status", "deleted")\` |
+| \`gt\` | Greater than | \`.gt("age", 18)\` |
+| \`lt\` | Less than | \`.lt("price", 100)\` |
+| \`gte\` | Greater than or equal | \`.gte("score", 90)\` |
+| \`lte\` | Less than or equal | \`.lte("count", 10)\` |
+| \`in\` | In array | \`.in("role", ["admin", "editor"])\` |
+| \`like\` | Pattern match (case-sensitive) | \`.like("name", "%john%")\` |
+| \`ilike\` | Pattern match (case-insensitive) | \`.ilike("name", "%john%")\` |
+| \`is\` | IS comparison (null, true, false) | \`.is("deleted_at", null)\` |
+
+### JSONB Subkey Filters
+
+Filter on nested JSONB fields using arrow notation:
+
+| Filter | SQL Generated |
+|--------|--------------|
+| \\\`filter[metadata->status]=active\\\` | \\\`metadata->>'status' = 'active'\\\` |
+| \\\`filter[config->theme.ilike]=%dark%\\\` | \\\`config->>'theme' ILIKE '%dark%'\\\` |
+| \\\`filter[data->user->role]=admin\\\` | \\\`data->'user'->>'role' = 'admin'\\\` |
+
+All standard operators work with JSONB paths. The last segment uses \\\`->>\\\` (text extraction).
+
+### Compound Filters (AND + OR)
+
+Combine AND and OR conditions:
+
+\`\`\`
+?filter[status]=active&or_filter[role]=admin&or_filter[role]=moderator
+\`\`\`
+
+This generates: \\\`WHERE status = 'active' AND (role = 'admin' OR role = 'moderator')\\\`
+
+### Full-Text Search
+
+\`\`\`typescript
+const results = await fetch("${t}/generated/posts/search", {
+  method: "POST",
+  headers: { "x-vaif-key": "${a}", "Content-Type": "application/json" },
+  body: JSON.stringify({
+    query: "search term",
+    columns: ["title", "body"],
+    limit: 20,
+  }),
+});
+// Results ranked by ts_rank score
+\`\`\`
+
+### Aggregation
+
+\`\`\`typescript
+const stats = await fetch("${t}/generated/orders/aggregate", {
+  method: "POST",
+  headers: { "x-vaif-key": "${a}", "Content-Type": "application/json" },
+  body: JSON.stringify({
+    aggregates: [
+      { fn: "count", column: "*" },
+      { fn: "sum", column: "total" },
+      { fn: "avg", column: "total" },
+    ],
+    groupBy: ["status"],
+  }),
+});
+\`\`\`
+
+### Joins (Foreign Key Includes)
+
+Include related rows by specifying foreign key columns:
+
+\`\`\`
+GET /generated/posts?include=author_id&include=category_id
+\`\`\`
+
+Returns posts with \\\`author_id_included\\\` and \\\`category_id_included\\\` objects containing the related rows.
+
+### Upsert
+
+Insert or update on conflict:
+
+\`\`\`typescript
+const result = await fetch("${t}/generated/users", {
+  method: "POST",
+  headers: { "x-vaif-key": "${a}", "Content-Type": "application/json" },
+  body: JSON.stringify({
+    email: "alice@example.com",
+    name: "Alice",
+    _upsert: true,
+    _conflictColumns: ["email"],
+  }),
+});
+\`\`\`
+
+### Pagination
+
+\`\`\`typescript
+// Default: limit 20, offset 0
+const page1 = await vaif.from("posts").select().limit(20).offset(0);
+const page2 = await vaif.from("posts").select().limit(20).offset(20);
+\`\`\`
+
+### REST API Response Format
+
+When calling the REST API directly (without the SDK), all data-plane responses are wrapped:
+
+\`\`\`typescript
+// GET /generated/{table} \u2192 list
+{ data: [...], count: 5 }
+
+// GET /generated/{table}/{id} \u2192 single record
+{ data: { id: "...", ... } }
+
+// POST /generated/{table} \u2192 created record
+{ data: { id: "...", ... } }
+
+// PATCH /generated/{table}/{id} \u2192 updated record
+{ data: { id: "...", ... } }
+
+// DELETE /generated/{table}/{id}
+{ ok: true }
+
+// Error responses
+{ error: "NotFound", message: "...", requestId: "..." }
+\`\`\`
+
+The SDK unwraps these automatically, but if you use \`fetch()\` directly, access the data via \`response.data\`.
+
+### Numeric/Decimal Column Serialization
+
+PostgreSQL \`numeric\` and \`decimal\` columns serialize to **JSON strings** (to preserve arbitrary precision). This is standard behavior. Any column typed as \`numeric\` or \`decimal\` will arrive as \`"3.14"\` not \`3.14\`.
+
+\`\`\`typescript
+// Wrong \u2014 value is a string, comparison may fail
+if (item.price > 10.0) { ... }
+
+// Correct \u2014 parse before arithmetic
+if (parseFloat(item.price) > 10.0) { ... }
+\`\`\`
+
+### Auth Headers
+
+VAIF uses **two auth modes** \u2014 choose the right one for each operation:
+
+| Auth Mode | Header | Used For |
+|-----------|--------|----------|
+| **API Key** | \`x-vaif-key: vaif_xxx\` | Data-plane: CRUD (\`/generated/*\`), storage uploads/downloads, function invocation |
+| **JWT Token** | \`Authorization: Bearer <jwt>\` | Control-plane: schema introspection, project management, function CRUD, bucket creation |
+
+> **Important**: API keys do NOT work for control-plane endpoints (creating functions, managing buckets, schema changes). Those require a JWT session token. The MCP server handles this automatically by using both auth modes.
+
+### MCP Tools (via .mcp.json)
+
+The \`.mcp.json\` file configures an MCP server that gives Claude Code direct access to your VAIF project. Available tools:
+
+| Tool | What it does |
+|------|-------------|
+| \`list_tables\`, \`describe_table\` | Inspect database schema |
+| \`get_schema\` | Full schema as JSON |
+| \`create_tables\` | Create or update tables declaratively |
+| \`query_rows\` | Query with filters, JSONB paths, pagination |
+| \`insert_row\`, \`update_row\`, \`delete_row\` | CRUD operations on any table |
+| \`list_functions\`, \`deploy_function\`, \`invoke_function\` | Function management |
+| \`get_function_logs\` | Execution history with status filters |
+| \`set_secret\`, \`list_secrets\`, \`delete_secret\` | Function secrets |
+| \`list_buckets\`, \`list_files\`, \`get_signed_url\` | Storage operations |
+| \`enable_realtime\`, \`realtime_status\` | Realtime subscriptions |
+
+> **Note**: MCP tools are only available to the main Claude Code session, not to spawned sub-agents (Task tool). The main session should handle all VAIF backend operations directly.
+`}async function ne(n){let e=j(),a=R();(!a||!a.token)&&(console.log(u.red("Not logged in")),console.log(u.gray("Run `vaif login` first to authenticate")),process.exit(1));let t=n.config||"vaif.config.json",o=null;try{o=await N(t);}catch{}let i=Re(n,o,a);i||(console.log(u.yellow(`No project ID specified \u2014 fetching your projects...
+`)),i=await Ue(a.token),i||(console.log(u.gray(`
+  Tip: pass --project-id <id> or set projectId in vaif.config.json`)),process.exit(1)));let s=I.resolve(n.outputDir||".");console.log(""),console.log(u.bold("VAIF Claude Code Setup")),console.log(u.gray(`  Project: ${i}`)),console.log(""),e.start("Fetching database schema...");let l={tables:[]};try{let m=await fetch(`${F}/schema-engine/introspect/${i}`,{headers:{Authorization:`Bearer ${a.token}`}});m.ok?(l=await m.json(),e.succeed(`Fetched schema (${l.tables?.length||0} tables)`)):e.warn("Could not fetch schema \u2014 continuing without it");}catch{e.warn("Could not fetch schema \u2014 continuing without it");}e.start("Fetching project info...");let r=i,c=F;try{let m=await fetch(`${F}/projects/${i}`,{headers:{Authorization:`Bearer ${a.token}`}});if(m.ok){let d=await m.json(),f=d.project||d;r=f.name||i,c=f.apiUrl||F,e.succeed(`Project: ${r}`);}else e.warn("Could not fetch project info \u2014 using defaults");}catch{e.warn("Could not fetch project info \u2014 using defaults");}let h=n.apiKey||o?.api?.apiKey||"";if(!h){e.start("Generating API key for Claude Code...");try{let m=`claude-code-${Date.now()}`,d=await fetch(`${F}/projects/${i}/api-keys`,{method:"POST",headers:{Authorization:`Bearer ${a.token}`,"Content-Type":"application/json"},body:JSON.stringify({name:m,scopes:["crud","realtime","functions","storage"]})});if(d.ok){let f=await d.json();h=f.apiKey||f.key,e.succeed(`Generated API key: ${m}`);}else e.fail("Could not auto-generate API key"),console.log(u.yellow("  Pass one with --api-key or generate via `vaif keys generate`")),process.exit(1);}catch{e.fail("Could not auto-generate API key"),console.log(u.yellow("  Pass one with --api-key or generate via `vaif keys generate`")),process.exit(1);}}if(!n.skipMcp){e.start("Writing .mcp.json...");let m={mcpServers:{"vaif-studio":{command:"npx",args:["@vaiftech/mcp"],env:{VAIF_API_KEY:h,VAIF_PROJECT_ID:i,VAIF_API_URL:c,VAIF_AUTH_TOKEN:a.token}}}},d=I.join(s,".mcp.json");v.writeFileSync(d,JSON.stringify(m,null,2)+`
+`,"utf-8"),e.succeed(`Written ${u.cyan(".mcp.json")}`);}if(!n.skipClaudeMd){e.start("Writing CLAUDE.md...");let m=ke({projectId:i,apiKey:h,apiUrl:c,projectName:r,schema:l}),d=I.join(s,"CLAUDE.md");v.writeFileSync(d,m,"utf-8"),e.succeed(`Written ${u.cyan("CLAUDE.md")}`);}console.log(""),console.log(u.green.bold("  Claude Code integration configured!")),console.log(""),n.skipMcp||console.log(u.gray("  MCP Server:  ")+u.white(".mcp.json")),n.skipClaudeMd||console.log(u.gray("  Context:     ")+u.white("CLAUDE.md")),console.log(""),console.log(u.bold("  Next steps:")),console.log(u.gray("  1. Open this project in Claude Code")),console.log(u.gray("  2. The MCP server auto-connects to your VAIF project")),console.log(u.gray("  3. Ask Claude to query, modify, or build against your schema")),console.log("");}var k={base:`# VAIF Studio Backend
+
+This project uses **VAIF Studio** as its backend.
+
+## SDK Setup
+
+\`\`\`bash
+npm install @vaiftech/client
+\`\`\`
+
+\`\`\`typescript
+import { createVaifClient } from "@vaiftech/client";
+
+const vaif = createVaifClient({
+  baseUrl: "https://api.vaif.studio",
+  projectId: process.env.VAIF_PROJECT_ID!,
+  apiKey: process.env.VAIF_API_KEY!,
+});
+\`\`\`
+
+## MCP Server
+
+This project includes an MCP server for Claude Code integration. Tools available:
+
+- **Database**: list_tables, describe_table, query_rows, insert_row, update_row, delete_row
+- **Schema**: get_schema, create_tables
+- **Storage**: list_buckets, create_bucket, list_files, get_signed_url
+- **Functions**: list_functions, invoke_function, create_function, deploy_function
+- **Auth**: list_api_keys, create_api_key
+- **Realtime**: realtime_status, enable_realtime
+
+## Database
+
+\`\`\`typescript
+// Query
+const { data } = await vaif.from("table_name").select().eq("column", value);
+
+// Insert
+const { data } = await vaif.from("table_name").insert({ column: value });
+
+// Update
+await vaif.from("table_name").update({ column: newValue }).eq("id", recordId);
+
+// Delete
+await vaif.from("table_name").delete().eq("id", recordId);
+\`\`\`
+
+## Authentication
+
+\`\`\`typescript
+// Sign up
+await vaif.auth.signUp({ email, password });
+
+// Sign in
+const { data } = await vaif.auth.signIn({ email, password });
+
+// OAuth
+await vaif.auth.signInWithOAuth({ provider: "google", redirectTo: callbackUrl });
+
+// Get current user
+const user = await vaif.auth.getUser();
+\`\`\`
+
+## Storage
+
+\`\`\`typescript
+// Upload
+await vaif.storage.from("bucket").upload("path/file.png", file);
+
+// Signed URL
+const { url } = await vaif.storage.from("bucket").createSignedUrl("path/file.png", 3600);
+
+// List files
+const { data } = await vaif.storage.from("bucket").list("path/");
+\`\`\`
+
+## Functions
+
+\`\`\`typescript
+// Invoke
+const result = await vaif.functions.invoke("function_name", { body: { key: "value" } });
+\`\`\`
+
+> Function names must be alphanumeric + underscores only (\`^[a-zA-Z0-9_]+$\`).
+
+## Realtime
+
+\`\`\`typescript
+const subscription = vaif.realtime
+  .channel("table_name")
+  .on("INSERT", (payload) => console.log("New:", payload.new))
+  .on("UPDATE", (payload) => console.log("Updated:", payload.new))
+  .on("DELETE", (payload) => console.log("Removed:", payload.old))
+  .subscribe();
+\`\`\`
+
+## Filter Operators
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| eq | Equal | \`.eq("status", "active")\` |
+| neq | Not equal | \`.neq("status", "deleted")\` |
+| gt / gte | Greater than | \`.gt("age", 18)\` |
+| lt / lte | Less than | \`.lt("price", 100)\` |
+| in | In array | \`.in("role", ["admin", "editor"])\` |
+| like / ilike | Pattern match | \`.ilike("name", "%john%")\` |
+| is | IS NULL check | \`.is("deleted_at", null)\` |
+
+## Auth Headers
+
+| Mode | Header | Used For |
+|------|--------|----------|
+| API Key | \`x-vaif-key: vk_xxx\` | Data-plane: CRUD, storage, functions |
+| JWT Token | \`Authorization: Bearer <jwt>\` | Control-plane: schema, project management |
+
+## Environment Variables
+
+\`\`\`bash
+VAIF_API_URL=https://api.vaif.studio
+VAIF_PROJECT_ID=proj_xxx
+VAIF_API_KEY=vk_xxx
+\`\`\`
+`,saas:`# VAIF Studio \u2014 SaaS Backend
+
+This project uses **VAIF Studio** as its backend for a SaaS application.
+
+## SDK Setup
+
+\`\`\`bash
+npm install @vaiftech/client @vaiftech/react
+\`\`\`
+
+\`\`\`typescript
+import { createVaifClient } from "@vaiftech/client";
+
+const vaif = createVaifClient({
+  baseUrl: "https://api.vaif.studio",
+  projectId: process.env.VAIF_PROJECT_ID!,
+  apiKey: process.env.VAIF_API_KEY!,
+});
+\`\`\`
+
+## Common SaaS Schema Patterns
+
+### Multi-Tenant with Organizations
+
+\`\`\`sql
+-- Organizations (tenants)
+CREATE TABLE orgs (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL,
+  slug TEXT UNIQUE NOT NULL,
+  plan TEXT DEFAULT 'free',
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Organization members
+CREATE TABLE org_members (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  org_id UUID REFERENCES orgs(id) ON DELETE CASCADE,
+  user_id UUID NOT NULL,
+  role TEXT DEFAULT 'member', -- owner, admin, member
+  created_at TIMESTAMPTZ DEFAULT now(),
+  UNIQUE(org_id, user_id)
+);
+
+-- Tenant-scoped data
+CREATE TABLE projects (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  org_id UUID REFERENCES orgs(id) ON DELETE CASCADE,
+  name TEXT NOT NULL,
+  settings JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+CREATE INDEX idx_projects_org ON projects(org_id);
+\`\`\`
+
+### Row-Level Security for Multi-Tenancy
+
+\`\`\`typescript
+// Scope all queries to the current organization
+const projects = await vaif.from("projects").select().eq("org_id", currentOrgId);
+
+// Or use RLS headers for automatic scoping
+const data = await vaif.from("projects").select({
+  headers: { "x-vaif-rls": \\\`org_id:\${currentOrgId}\\\` },
+});
+\`\`\`
+
+### Auth Flows
+
+\`\`\`typescript
+// Sign up \u2192 create org \u2192 add as owner
+const { data: user } = await vaif.auth.signUp({ email, password });
+const { data: org } = await vaif.from("orgs").insert({ name: orgName, slug });
+await vaif.from("org_members").insert({ org_id: org.id, user_id: user.id, role: "owner" });
+\`\`\`
+
+### Billing Integration
+
+\`\`\`typescript
+// Store Stripe customer/subscription IDs
+CREATE TABLE billing_accounts (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  org_id UUID UNIQUE REFERENCES orgs(id),
+  stripe_customer_id TEXT,
+  stripe_subscription_id TEXT,
+  plan TEXT DEFAULT 'free',
+  period_start TIMESTAMPTZ,
+  period_end TIMESTAMPTZ
+);
+
+// Webhook handler (VAIF Function)
+export default async function handler(req, ctx) {
+  const event = req.body;
+  if (event.type === "customer.subscription.updated") {
+    const sub = event.data.object;
+    await vaif.from("billing_accounts")
+      .update({ plan: sub.metadata.plan, period_end: sub.current_period_end })
+      .eq("stripe_subscription_id", sub.id);
+  }
+  return { received: true };
+}
+\`\`\`
+
+### Invite System
+
+\`\`\`sql
+CREATE TABLE invites (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  org_id UUID REFERENCES orgs(id) ON DELETE CASCADE,
+  email TEXT NOT NULL,
+  role TEXT DEFAULT 'member',
+  token TEXT UNIQUE NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL,
+  accepted_at TIMESTAMPTZ
+);
+\`\`\`
+
+## API Key Scoping
+
+\`\`\`
+x-vaif-key: vk_xxx          \u2192 Data-plane (CRUD, storage, functions)
+Authorization: Bearer <jwt>   \u2192 Control-plane (schema, project management)
+\`\`\`
+
+## Environment Variables
+
+\`\`\`bash
+VAIF_API_URL=https://api.vaif.studio
+VAIF_PROJECT_ID=proj_xxx
+VAIF_API_KEY=vk_xxx
+STRIPE_SECRET_KEY=sk_live_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+\`\`\`
+`,mobile:`# VAIF Studio \u2014 Mobile App Backend
+
+This project uses **VAIF Studio** as its backend for a mobile application (React Native/Expo, Flutter, or Swift).
+
+## SDK Setup
+
+### React Native / Expo
+\`\`\`bash
+npm install @vaiftech/sdk-expo
+\`\`\`
+
+\`\`\`typescript
+import { VaifProvider, useVaif } from "@vaiftech/sdk-expo";
+
+export default function App() {
+  return (
+    <VaifProvider
+      config={{
+        baseUrl: "https://api.vaif.studio",
+        projectId: "proj_xxx",
+        apiKey: "vk_xxx",
+      }}
+    >
+      <MainApp />
+    </VaifProvider>
+  );
+}
+\`\`\`
+
+### Flutter / Dart
+\`\`\`yaml
+# pubspec.yaml
+dependencies:
+  vaif_client: ^1.0.0
+\`\`\`
+
+\`\`\`dart
+import 'package:vaif_client/vaif_client.dart';
+
+final vaif = VaifClient(
+  baseUrl: 'https://api.vaif.studio',
+  projectId: 'proj_xxx',
+  apiKey: 'vk_xxx',
+);
+\`\`\`
+
+### Swift / iOS
+\`\`\`swift
+// Package.swift
+.package(url: "https://github.com/vaifllc/vaif-swift", from: "0.2.0")
+
+import VaifClient
+
+let vaif = VaifClient(
+    baseUrl: "https://api.vaif.studio",
+    projectId: "proj_xxx",
+    apiKey: "vk_xxx"
+)
+\`\`\`
+
+## Common Mobile Patterns
+
+### User Profiles with Avatars
+
+\`\`\`sql
+CREATE TABLE profiles (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID UNIQUE NOT NULL,
+  display_name TEXT,
+  avatar_url TEXT,
+  bio TEXT,
+  push_token TEXT,
+  device_type TEXT, -- ios, android
+  last_seen TIMESTAMPTZ DEFAULT now()
+);
+\`\`\`
+
+### Push Notifications
+
+\`\`\`typescript
+// Store push tokens
+await vaif.from("profiles").update({
+  push_token: expoPushToken,
+  device_type: Platform.OS,
+}).eq("user_id", userId);
+
+// Send notification (VAIF Function)
+export default async function handler(req, ctx) {
+  const { userId, title, body } = req.body;
+  const { data: profile } = await vaif.from("profiles")
+    .select("push_token, device_type")
+    .eq("user_id", userId)
+    .single();
+
+  // Send via Expo Push API or APNs/FCM
+  await fetch("https://exp.host/--/api/v2/push/send", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      to: profile.push_token,
+      title, body,
+    }),
+  });
+  return { sent: true };
+}
+\`\`\`
+
+### Offline-First with Sync
+
+\`\`\`typescript
+// Cache data locally, sync when online
+import AsyncStorage from "@react-native-async-storage/async-storage";
+
+// Fetch and cache
+const { data } = await vaif.from("items").select();
+await AsyncStorage.setItem("items_cache", JSON.stringify(data));
+
+// Read from cache when offline
+const cached = JSON.parse(await AsyncStorage.getItem("items_cache") || "[]");
+\`\`\`
+
+### Image Upload from Camera
+
+\`\`\`typescript
+import * as ImagePicker from "expo-image-picker";
+
+const result = await ImagePicker.launchCameraAsync({ quality: 0.8 });
+if (!result.canceled) {
+  const uri = result.assets[0].uri;
+  const response = await fetch(uri);
+  const blob = await response.blob();
+
+  await vaif.storage.from("avatars").upload(
+    \\\`\${userId}/avatar.jpg\\\`,
+    blob,
+    { contentType: "image/jpeg" }
+  );
+}
+\`\`\`
+
+### Realtime Chat
+
+\`\`\`typescript
+// Subscribe to new messages
+const subscription = vaif.realtime
+  .channel("messages")
+  .on("INSERT", (payload) => {
+    setMessages(prev => [...prev, payload.new]);
+  })
+  .subscribe();
+
+// Send a message
+await vaif.from("messages").insert({
+  room_id: roomId,
+  user_id: userId,
+  content: messageText,
+});
+\`\`\`
+
+## Auth with Secure Token Storage
+
+The Expo SDK automatically stores auth tokens in SecureStore (iOS Keychain / Android Keystore).
+
+\`\`\`typescript
+const { useAuth } = require("@vaiftech/sdk-expo");
+
+function LoginScreen() {
+  const { signIn, signUp, user, loading } = useAuth();
+
+  const handleLogin = async () => {
+    const { error } = await signIn({ email, password });
+    if (error) Alert.alert("Error", error.message);
+  };
+}
+\`\`\`
+
+## Environment Variables
+
+\`\`\`bash
+VAIF_API_URL=https://api.vaif.studio
+VAIF_PROJECT_ID=proj_xxx
+VAIF_API_KEY=vk_xxx
+EXPO_PUBLIC_VAIF_PROJECT_ID=proj_xxx
+EXPO_PUBLIC_VAIF_API_KEY=vk_xxx
+\`\`\`
+`,ecommerce:`# VAIF Studio \u2014 E-Commerce Backend
+
+This project uses **VAIF Studio** as its backend for an e-commerce application.
+
+## SDK Setup
+
+\`\`\`bash
+npm install @vaiftech/client
+\`\`\`
+
+\`\`\`typescript
+import { createVaifClient } from "@vaiftech/client";
+
+const vaif = createVaifClient({
+  baseUrl: "https://api.vaif.studio",
+  projectId: process.env.VAIF_PROJECT_ID!,
+  apiKey: process.env.VAIF_API_KEY!,
+});
+\`\`\`
+
+## E-Commerce Schema
+
+\`\`\`sql
+-- Products
+CREATE TABLE products (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL,
+  slug TEXT UNIQUE NOT NULL,
+  description TEXT,
+  price NUMERIC(10,2) NOT NULL,
+  compare_at_price NUMERIC(10,2),
+  currency TEXT DEFAULT 'USD',
+  sku TEXT UNIQUE,
+  inventory_count INTEGER DEFAULT 0,
+  category_id UUID REFERENCES categories(id),
+  images JSONB DEFAULT '[]', -- [{url, alt, position}]
+  metadata JSONB DEFAULT '{}',
+  status TEXT DEFAULT 'draft', -- draft, active, archived
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+CREATE INDEX idx_products_category ON products(category_id);
+CREATE INDEX idx_products_status ON products(status);
+
+-- Categories
+CREATE TABLE categories (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL,
+  slug TEXT UNIQUE NOT NULL,
+  parent_id UUID REFERENCES categories(id),
+  sort_order INTEGER DEFAULT 0
+);
+
+-- Orders
+CREATE TABLE orders (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID NOT NULL,
+  status TEXT DEFAULT 'pending', -- pending, confirmed, shipped, delivered, cancelled
+  subtotal NUMERIC(10,2) NOT NULL,
+  tax NUMERIC(10,2) DEFAULT 0,
+  shipping NUMERIC(10,2) DEFAULT 0,
+  total NUMERIC(10,2) NOT NULL,
+  currency TEXT DEFAULT 'USD',
+  shipping_address JSONB,
+  billing_address JSONB,
+  stripe_payment_intent_id TEXT,
+  notes TEXT,
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+CREATE INDEX idx_orders_user ON orders(user_id);
+CREATE INDEX idx_orders_status ON orders(status);
+
+-- Order items
+CREATE TABLE order_items (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  order_id UUID REFERENCES orders(id) ON DELETE CASCADE,
+  product_id UUID REFERENCES products(id),
+  quantity INTEGER NOT NULL,
+  unit_price NUMERIC(10,2) NOT NULL,
+  total NUMERIC(10,2) NOT NULL
+);
+CREATE INDEX idx_order_items_order ON order_items(order_id);
+
+-- Cart (session-based)
+CREATE TABLE carts (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID,
+  session_id TEXT,
+  items JSONB DEFAULT '[]', -- [{productId, quantity, price}]
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Reviews
+CREATE TABLE reviews (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID REFERENCES products(id) ON DELETE CASCADE,
+  user_id UUID NOT NULL,
+  rating INTEGER CHECK (rating >= 1 AND rating <= 5),
+  title TEXT,
+  body TEXT,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+CREATE INDEX idx_reviews_product ON reviews(product_id);
+\`\`\`
+
+## Common Patterns
+
+### Product Listing with Filters
+
+\`\`\`typescript
+// Browse products with category filter and pagination
+const { data: products } = await vaif
+  .from("products")
+  .select("id, name, slug, price, compare_at_price, images, category:categories(name)")
+  .eq("status", "active")
+  .eq("category_id", categoryId)
+  .order("created_at", { ascending: false })
+  .limit(20)
+  .offset(page * 20);
+\`\`\`
+
+### Cart Management
+
+\`\`\`typescript
+// Add to cart
+const cart = await vaif.from("carts").select().eq("user_id", userId).single();
+const items = [...(cart.data?.items || [])];
+const existing = items.findIndex(i => i.productId === productId);
+if (existing >= 0) {
+  items[existing].quantity += quantity;
+} else {
+  items.push({ productId, quantity, price });
+}
+await vaif.from("carts").update({ items, updated_at: new Date().toISOString() }).eq("id", cart.data.id);
+\`\`\`
+
+### Order Creation
+
+\`\`\`typescript
+// Create order from cart
+const { data: order } = await vaif.from("orders").insert({
+  user_id: userId,
+  subtotal, tax, shipping,
+  total: subtotal + tax + shipping,
+  shipping_address: addressData,
+});
+
+// Create order items
+const orderItems = cartItems.map(item => ({
+  order_id: order.id,
+  product_id: item.productId,
+  quantity: item.quantity,
+  unit_price: item.price,
+  total: item.price * item.quantity,
+}));
+await vaif.from("order_items").insert(orderItems);
+\`\`\`
+
+### Inventory Management
+
+\`\`\`typescript
+// Decrement inventory on order (VAIF Function)
+export default async function handler(req, ctx) {
+  const { items } = req.body; // [{productId, quantity}]
+  for (const item of items) {
+    const { data: product } = await vaif.from("products")
+      .select("inventory_count")
+      .eq("id", item.productId)
+      .single();
+
+    if (product.inventory_count < item.quantity) {
+      return { error: \\\`Insufficient stock for \${item.productId}\\\` };
+    }
+
+    await vaif.from("products")
+      .update({ inventory_count: product.inventory_count - item.quantity })
+      .eq("id", item.productId);
+  }
+  return { success: true };
+}
+\`\`\`
+
+### Payment Webhooks
+
+\`\`\`typescript
+// Stripe webhook handler (VAIF Function)
+export default async function handler(req, ctx) {
+  const sig = req.headers["stripe-signature"];
+  const event = stripe.webhooks.constructEvent(req.rawBody, sig, ctx.secrets.STRIPE_WEBHOOK_SECRET);
+
+  switch (event.type) {
+    case "payment_intent.succeeded":
+      await vaif.from("orders")
+        .update({ status: "confirmed" })
+        .eq("stripe_payment_intent_id", event.data.object.id);
+      break;
+    case "payment_intent.payment_failed":
+      await vaif.from("orders")
+        .update({ status: "cancelled" })
+        .eq("stripe_payment_intent_id", event.data.object.id);
+      break;
+  }
+  return { received: true };
+}
+\`\`\`
+
+### Product Image Upload
+
+\`\`\`typescript
+// Upload product images to storage
+const { url } = await vaif.storage
+  .from("product-images")
+  .upload(\\\`\${productId}/\${fileName}\\\`, file, { contentType: "image/webp" });
+
+// Update product images array
+const { data: product } = await vaif.from("products").select("images").eq("id", productId).single();
+const images = [...(product.images || []), { url, alt: altText, position: product.images.length }];
+await vaif.from("products").update({ images }).eq("id", productId);
+\`\`\`
+
+## Environment Variables
+
+\`\`\`bash
+VAIF_API_URL=https://api.vaif.studio
+VAIF_PROJECT_ID=proj_xxx
+VAIF_API_KEY=vk_xxx
+STRIPE_SECRET_KEY=sk_live_xxx
+STRIPE_PUBLISHABLE_KEY=pk_live_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+\`\`\`
+
+> **Note**: \`numeric\` columns (like \`price\`) serialize to JSON strings to preserve precision. Parse with \`parseFloat()\` before arithmetic.
+`};var Ve={$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 Ot(n){if(n.claude!==void 0){let t=typeof n.claude=="string"?n.claude:null;if(t&&t in k){let i=j("Generating CLAUDE.md from template...").start(),s=k[t],l=Oe();l&&(s+=`
+## Team Conventions
+
+${l}
+`);let r=I.resolve("CLAUDE.md");v.existsSync(r)&&!n.force&&(i.fail("CLAUDE.md already exists"),console.log(u.yellow(`
+Use --force to overwrite.`)),process.exit(1)),v.writeFileSync(r,s,"utf-8"),i.succeed(`Created CLAUDE.md (${t} template)`),l&&console.log(u.gray("  Imported team conventions from existing config files.")),console.log(u.gray(`
+  Customize the generated CLAUDE.md with your project details.`)),console.log(u.gray(`  For a personalized version from live data, run: vaif claude-setup
+`));return}t&&!(t in k)&&(console.log(u.red(`
+  Unknown template type: "${t}"`)),console.log(u.gray("  Available types: base, saas, mobile, ecommerce")),console.log(u.gray(`  Or omit the type to auto-generate from your live project: vaif init --claude
+`)),process.exit(1));let o=je();o?(console.log(u.gray(`
+  Detected project type: ${u.cyan(o)}`)),console.log(u.gray(`  Generating from live project data with template context...
+`))):console.log(u.gray(`
+  Generating from live project data...
+`)),await ne({skipMcp:false});return}if(n.addFeatures){n.template||(console.log(u.red(`
+--add-features requires --template to know which template to use.`)),console.log(u.gray("Example: vaif init --template react-spa --add-features functions,storage")),process.exit(1));let t=n.addFeatures.split(",").map(o=>o.trim());await q(n.template,{force:n.force,features:t,addOnly:true});return}let e=j("Initializing VAIF configuration...").start(),a=I.resolve("vaif.config.json");v.existsSync(a)&&!n.force&&(e.fail("vaif.config.json already exists"),console.log(u.yellow(`
+Use --force to overwrite existing configuration.`)),process.exit(1));try{if(v.writeFileSync(a,JSON.stringify(Ve,null,2),"utf-8"),e.succeed("Created vaif.config.json"),n.template){let t=n.features?n.features.split(",").map(o=>o.trim()):void 0;await q(n.template,{force:n.force,features:t});}else {let t=I.resolve(".env.example");if(v.existsSync(t)||(v.writeFileSync(t,`# VAIF Configuration
 DATABASE_URL=postgresql://user:password@localhost:5432/database
 VAIF_API_KEY=your-api-key
-`,"utf-8"),console.log(l.gray("Created .env.example"))),a.typescript){let r=k.resolve("src/types");b.existsSync(r)||(b.mkdirSync(r,{recursive:!0}),console.log(l.gray("Created src/types directory")));}console.log(""),console.log(l.green("VAIF initialized successfully!")),console.log(""),console.log(l.gray("Next steps:")),console.log(l.gray("  1. Update vaif.config.json with your project ID")),console.log(l.gray("  2. Set DATABASE_URL in your environment")),console.log(l.gray("  3. Run: npx vaif generate")),console.log("");}}catch(e){t.fail("Failed to initialize"),e instanceof Error&&console.error(l.red(`
-Error: ${e.message}`)),process.exit(1);}}export{q as a,V as b,Ue as c,De as d,ke as e,He as f,tt as g,ct as h};
+`,"utf-8"),console.log(u.gray("Created .env.example"))),n.typescript){let o=I.resolve("src/types");v.existsSync(o)||(v.mkdirSync(o,{recursive:!0}),console.log(u.gray("Created src/types directory")));}console.log(""),console.log(u.green("VAIF initialized successfully!")),console.log(""),console.log(u.gray("Next steps:")),console.log(u.gray("  1. Update vaif.config.json with your project ID")),console.log(u.gray("  2. Set DATABASE_URL in your environment")),console.log(u.gray("  3. Run: npx vaif generate")),console.log("");}}catch(t){e.fail("Failed to initialize"),t instanceof Error&&console.error(u.red(`
+Error: ${t.message}`)),process.exit(1);}}function je(){try{let n=I.resolve("package.json");if(!v.existsSync(n))return null;let e=JSON.parse(v.readFileSync(n,"utf-8")),a={...e.dependencies,...e.devDependencies};return a.expo||a["react-native"]||a["@vaiftech/sdk-expo"]||v.existsSync(I.resolve("pubspec.yaml"))||v.existsSync(I.resolve("Package.swift"))||v.existsSync(I.resolve("*.xcodeproj"))?"mobile":(a.stripe||a["@stripe/stripe-js"]||a["shopify-api-node"]||a["@shopify/shopify-api"])&&(v.existsSync(I.resolve("src/models/product.ts"))||v.existsSync(I.resolve("src/models/order.ts"))||v.existsSync(I.resolve("src/pages/products"))||v.existsSync(I.resolve("src/pages/cart")))?"ecommerce":a.stripe||a["@stripe/stripe-js"]||e.name?.includes("saas")||e.description?.toLowerCase().includes("saas")?"saas":"base"}catch{return null}}function Oe(){let n=[{path:".cursorrules",label:"Cursor Rules"},{path:".github/copilot-instructions.md",label:"GitHub Copilot Instructions"},{path:".windsurfrules",label:"Windsurf Rules"},{path:".clinerules",label:"Cline Rules"}],e=[];for(let a of n){let t=I.resolve(a.path);if(v.existsSync(t))try{let o=v.readFileSync(t,"utf-8").trim();o.length>0&&o.length<1e4&&e.push(`### From ${a.label} (\`${a.path}\`)
+
+${o}`);}catch{}}return e.length>0?e.join(`
+
+`):null}export{N as a,R as b,Qe as c,Ze as d,et as e,ut as f,vt as g,ne as h,Ot as i};