generatesaas 1.2.0 → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +77 -77
- package/dist/skill/content/SKILL.md +84 -83
- package/dist/skill/content/scripts/_helpers.js +1 -1
- package/dist/skill/content/scripts/apply-auto.js +3 -3
- package/dist/skill/content/scripts/classify-files.js +8 -8
- package/dist/skill/content/scripts/complete-update.js +56 -11
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{Command as Qo}from"commander";import*as En from"@clack/prompts";import{existsSync as Ao,readdirSync as ko,rmSync as Po}from"fs";import{join as _o,resolve as Ro}from"path";import{Option as j}from"commander";import*as E from"@clack/prompts";import*as Be from"@clack/prompts";import vt from"picocolors";function Ft(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";Be.intro(vt.bgYellow(vt.black(t)))}function Bt(){Be.outro(vt.yellow("Happy building!"))}import*as
|
|
3
|
-
`);
|
|
4
|
-
`),p=[` Deploy target: ${f.cyan(
|
|
5
|
-
`),y=[b!=="none"?` Payment: ${f.cyan(Ge[b].label)} (${
|
|
6
|
-
`),O=[f.bold("Project"),c,"",f.bold("Infrastructure"),p,"",f.bold("Features"),y];if(Fe.length>0){let
|
|
7
|
-
`);O.push("",f.bold("Credentials"),
|
|
8
|
-
`),"Summary");let D=await
|
|
9
|
-
`,{mode:384})}async function
|
|
10
|
-
`)}function $n(e,t){return!(e.startsWith("mcp__")||t!=="nuxt"&&e.includes("nuxt"))}import{join as zn}from"path";import{mkdir as jn,readdir as Mn,rm as Vn,rmdir as Fn,writeFile as Bn}from"fs/promises";import{dirname as st,join as Gn,relative as Kn}from"path";async function at(e){await jn(e,{recursive:!0})}async function l(e,t){await at(st(e)),await Bn(e,t,"utf-8")}async function Tt(e,t){await Vn(e,{force:!0});let r=st(e);for(;r!==t&&r!==st(r);){try{await Fn(r)}catch{return}r=st(r)}}async function
|
|
11
|
-
- **Payments:** ${Wn[e.paymentProvider]}`,
|
|
2
|
+
import{Command as Qo}from"commander";import*as En from"@clack/prompts";import{existsSync as Ao,readdirSync as ko,rmSync as Po}from"fs";import{join as _o,resolve as Ro}from"path";import{Option as j}from"commander";import*as E from"@clack/prompts";import*as Be from"@clack/prompts";import vt from"picocolors";function Ft(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";Be.intro(vt.bgYellow(vt.black(t)))}function Bt(){Be.outro(vt.yellow("Happy building!"))}import*as u from"@clack/prompts";import f from"picocolors";var Oe={nextjs:{label:"Next.js",hint:"React 19 + Next.js 16"},nuxt:{label:"Nuxt",hint:"Vue 3 + Nuxt 4"}},De={fullstack:{label:"Fullstack",hint:"Frontend hosts the API - works on serverless or long-running"},separate:{label:"Separate",hint:"Standalone Hono backend - long-running runtimes only (Docker, Render, Fly.io, Railway, Coolify, Dokploy)"}},Ge={stripe:{label:"Stripe"},polar:{label:"Polar"},none:{label:"None",hint:"disable payments"}},Ke={smtp:{label:"SMTP",hint:"Mailpit for local dev"},ses:{label:"Amazon SES"},resend:{label:"Resend"}},ze={user:{label:"Per user",hint:"each user has their own subscription"},organization:{label:"Per organization",hint:"org subscription shared by members"}},ye={postgres:{label:"PostgreSQL",hint:"port 5432",port:5432},redis:{label:"Redis",hint:"port 6379",port:6379},inngest:{label:"Inngest",hint:"port 8288",port:8288},mailpit:{label:"Mailpit",hint:"port 1025",port:1025}},xe={"claude-code":{label:"Claude Code"},cursor:{label:"Cursor"},codex:{label:"Codex"},"gemini-cli":{label:"Gemini CLI"},windsurf:{label:"Windsurf"}};var ie={USD:{symbol:"$",name:"US Dollar",place:"left",space:!1},EUR:{symbol:"\u20AC",name:"Euro",place:"right",space:!1},GBP:{symbol:"\xA3",name:"British Pound",place:"left",space:!1},CAD:{symbol:"CA$",name:"Canadian Dollar",place:"left",space:!1},AUD:{symbol:"A$",name:"Australian Dollar",place:"left",space:!1},BRL:{symbol:"R$",name:"Brazilian Real",place:"left",space:!1},JPY:{symbol:"\xA5",name:"Japanese Yen",place:"left",space:!1}};var F={node:{label:"Node.js / Docker",hint:"long-running runtime - Render, Fly.io, Railway, Coolify, Dokploy, VPS",edgeRuntime:!1},vercel:{label:"Vercel",hint:"serverless functions",edgeRuntime:!0}},x={postgres:{label:"PostgreSQL (self-hosted)",hint:"local Docker, drizzle-orm/node-postgres",managed:!1,envVars:[{key:"DATABASE_URL",defaultValue:"postgres://postgres:postgres@localhost:5432/saas"}]},neon:{label:"Neon",hint:"serverless Postgres",managed:!0,envVars:[{key:"DATABASE_URL",comment:"# TODO: Add your Neon connection string"}]},supabase:{label:"Supabase",hint:"managed Postgres",managed:!0,envVars:[{key:"DATABASE_URL",comment:"# TODO: Add your Supabase connection string"}]}},B={redis:{label:"Redis (self-hosted)",hint:"local Docker, ioredis",managed:!1,envVars:[{key:"REDIS_URL",defaultValue:"redis://localhost:6379"}]},upstash:{label:"Upstash",hint:"serverless Redis",managed:!0,envVars:[{key:"UPSTASH_REDIS_REST_URL",comment:"# TODO: Add your Upstash REST URL"},{key:"UPSTASH_REDIS_REST_TOKEN",comment:"# TODO: Add your Upstash REST token"}]}},Ce=[{target:"vercel",provider:"redis",reason:"Vercel serverless cannot maintain persistent Redis connections. Consider Upstash."}],Ne=[{architecture:"separate",target:"vercel",reason:"Standalone backends need a long-running runtime. Vercel's per-function TypeScript check conflicts with pnpm's isolated install. Use --architecture fullstack for serverless, or deploy the standalone backend to a long-running runtime (Render, Fly.io, Railway, Coolify, Dokploy, or your own VPS via Docker)."}],Gt=["Local file storage (sharp, geoip-lite)","SMTP email (use Resend or SES instead)","Content API git integration"];function He(e){let t=x[e.databaseProvider].managed,r=B[e.cacheProvider].managed;return e.dockerServices.some(i=>!(i==="postgres"&&t||i==="redis"&&r))}var Y={google:{label:"Google",envVars:[{name:"GOOGLE_CLIENT_ID",secret:!1},{name:"GOOGLE_CLIENT_SECRET",secret:!0}]},github:{label:"GitHub",envVars:[{name:"GITHUB_CLIENT_ID",secret:!1},{name:"GITHUB_CLIENT_SECRET",secret:!0}]},facebook:{label:"Facebook",envVars:[{name:"FACEBOOK_CLIENT_ID",secret:!1},{name:"FACEBOOK_CLIENT_SECRET",secret:!0}]},discord:{label:"Discord",envVars:[{name:"DISCORD_CLIENT_ID",secret:!1},{name:"DISCORD_CLIENT_SECRET",secret:!0}]},x:{label:"X",envVars:[{name:"TWITTER_CLIENT_ID",secret:!1},{name:"TWITTER_CLIENT_SECRET",secret:!0}]}};var Le=["nextjs","nuxt"],Ye=["fullstack","separate"],Je=["stripe","polar","none"],qe=["smtp","ses","resend"],We=["postgres","redis","inngest","mailpit"],Xe=["claude-code","cursor","codex","gemini-cli","windsurf"],Ze=["user","organization"],oe=["USD","EUR","GBP","CAD","AUD","BRL","JPY"],se=["node","vercel"],ae=["postgres","neon","supabase"],ce=["redis","upstash"],Qe=["google","github","facebook","discord","x"];function et(e){return e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function tt(e){return/^[a-z][a-z0-9-]*$/.test(e)}function I(e){return e instanceof Error?e.message:String(e)}function w(e){u.isCancel(e)&&(u.cancel("Setup cancelled."),process.exit(0))}function St(e){let t=[];e.databaseProvider==="neon"&&t.push({key:"DATABASE_URL",message:"Neon connection string (optional):",placeholder:"postgres://...",secret:!0}),e.databaseProvider==="supabase"&&t.push({key:"DATABASE_URL",message:"Supabase connection string (optional):",placeholder:"postgres://...",secret:!0}),e.cacheProvider==="upstash"&&(t.push({key:"UPSTASH_REDIS_REST_URL",message:"Upstash REST URL (optional):",placeholder:"https://...",secret:!1}),t.push({key:"UPSTASH_REDIS_REST_TOKEN",message:"Upstash REST token (optional):",secret:!0})),e.paymentProvider==="stripe"&&(t.push({key:"STRIPE_SECRET_KEY",message:"Stripe secret key (optional):",placeholder:"sk_test_...",secret:!0}),t.push({key:"STRIPE_WEBHOOK_SECRET",message:"Stripe webhook secret (optional):",placeholder:"whsec_...",secret:!0})),e.paymentProvider==="polar"&&(t.push({key:"POLAR_ACCESS_TOKEN",message:"Polar access token (optional):",secret:!0}),t.push({key:"POLAR_WEBHOOK_SECRET",message:"Polar webhook secret (optional):",secret:!0})),e.emailProvider==="resend"&&t.push({key:"RESEND_API_KEY",message:"Resend API key (optional):",placeholder:"re_...",secret:!0}),e.emailProvider==="ses"&&(t.push({key:"AMAZON_SES_REGION",message:"Amazon SES region (optional):",placeholder:"us-east-1",secret:!1}),t.push({key:"AMAZON_SES_KEY",message:"Amazon SES access key (optional):",secret:!0}),t.push({key:"AMAZON_SES_SECRET",message:"Amazon SES secret (optional):",secret:!0}));for(let r of e.socialProviders){let i=Y[r];for(let n of i.envVars)t.push({key:n.name,message:`${n.name} (${i.label}, optional):`,secret:n.secret})}return e.demo&&t.push({key:"TURNSTILE_SECRET_KEY",message:"Cloudflare Turnstile secret key (optional):",secret:!0}),t}async function Kt(e){let t=!1;u.log.info(f.bold("Project"));let r=e?.projectName??await(async()=>{t=!0;let c=await u.text({message:"Project name:",placeholder:"my-saas",validate:p=>{if(!p?.trim())return"Project name is required.";if(!tt(p))return"Use lowercase letters, numbers, and hyphens only. Must start with a letter."}});return w(c),c})(),i=e?.appName??await(async()=>{t=!0;let c=await u.text({message:"App name:",initialValue:et(r),validate:p=>{if(!p?.trim())return"App name is required."}});return w(c),c})(),n=e?.projectDir??await(async()=>{t=!0;let c=await u.text({message:"Project location:",initialValue:`./${r}`});return w(c),c==="."?process.cwd():c})(),o=e?.frontend??await(async()=>{t=!0;let c=Object.keys(Oe),p=await u.select({message:"Frontend framework:",options:c.map(y=>({value:y,label:Oe[y].label,hint:Oe[y].hint}))});return w(p),p})();u.log.info(f.bold("Infrastructure"));let s=e?.deploymentTarget??"node";if(e?.deploymentTarget===void 0){t=!0;let c=await u.select({message:"Deployment target:",options:se.map(p=>({value:p,label:F[p].label,hint:F[p].hint}))});w(c),s=c}let a=e?.architecture?Ne.find(c=>c.architecture===e.architecture&&c.target===s):void 0;if(a)throw new Error(`Incompatible: --architecture ${a.architecture} + --deploy ${a.target}. ${a.reason}`);let d=new Set(Ne.filter(c=>c.target===s).map(c=>c.architecture)),h=Ye.filter(c=>!d.has(c)),g=e?.architecture??await(async()=>{if(h.length===1){let p=h[0];return u.log.info(`Auto-selected ${De[p].label} architecture (only compatible option for ${F[s].label}).`),p}t=!0;let c=await u.select({message:"Architecture:",options:h.map(p=>({value:p,label:De[p].label,hint:De[p].hint}))});return w(c),c})(),m=e?.databaseProvider??await(async()=>{t=!0;let c=ae.filter(y=>!Ce.some(O=>O.target===s&&O.provider===y));if(c.length===1){let y=c[0];return u.log.info(`Auto-selected ${x[y].label} (only compatible option for ${F[s].label}).`),y}let p=await u.select({message:"Database provider:",options:c.map(y=>({value:y,label:x[y].label,hint:x[y].hint}))});return w(p),p})(),v=e?.cacheProvider??await(async()=>{t=!0;let c=ce.filter(y=>!Ce.some(O=>O.target===s&&O.provider===y));if(c.length===1){let y=c[0];return u.log.info(`Auto-selected ${B[y].label} (only compatible option for ${F[s].label}).`),y}let p=await u.select({message:"Cache provider:",options:c.map(y=>({value:y,label:B[y].label,hint:B[y].hint}))});return w(p),p})();if(F[s]?.edgeRuntime){let c=Gt.map(p=>` - ${p}`).join(`
|
|
3
|
+
`);u.note(c,"Unavailable on edge runtime")}u.log.info(f.bold("Features"));let b=e?.paymentProvider??await(async()=>{t=!0;let c=await u.select({message:"Payment provider:",options:Je.map(p=>({value:p,label:Ge[p].label,hint:Ge[p].hint}))});return w(c),c})(),H=e?.defaultCurrency??await(async()=>{if(b==="none")return"USD";t=!0;let c=await u.select({message:"Default currency:",options:oe.map(p=>({value:p,label:p,hint:ie[p].name}))});return w(c),c})(),R=e?.emailProvider??await(async()=>{t=!0;let c=await u.select({message:"Email provider:",options:qe.map(p=>({value:p,label:Ke[p].label,hint:Ke[p].hint}))});return w(c),c})(),te=e?.multiTenancy??await(async()=>{t=!0;let c=await u.confirm({message:"Enable multi-tenancy (organizations)?",initialValue:!1});return w(c),c})(),re=e?.billingScope??"user";if(te&&e?.billingScope===void 0){t=!0;let c=await u.select({message:"Billing scope:",options:Ze.map(p=>({value:p,label:ze[p].label,hint:ze[p].hint}))});w(c),re=c}let A=e?.blog??await(async()=>{t=!0;let c=await u.confirm({message:"Enable blog?",initialValue:!0});return w(c),c})(),S=e?.docs??await(async()=>{t=!0;let c=await u.confirm({message:"Include docs app? (self-hosted Fumadocs documentation site)",initialValue:!1});return w(c),c})(),P=e?.revenueSharing??await(async()=>{t=!0;let c=await u.confirm({message:"Enable revenue sharing? (opt-in MRR leaderboard with dofollow backlinks)",initialValue:!1});return w(c),c})(),_e=b==="none"?!1:e?.credits??await(async()=>{t=!0;let c=await u.confirm({message:"Enable credits? (metered usage on top of subscription plans)",initialValue:!0});return w(c),c})(),he=e?.socialProviders??await(async()=>{t=!0;let c=Qe.map(y=>({value:y,label:Y[y].label,hint:`requires ${Y[y].envVars.map(O=>O.name).join(" / ")}`})),p=await u.multiselect({message:"Which social login providers should the sign-in screen show?",options:c,initialValues:[],required:!1});return w(p),p})();u.log.info(f.bold("Tooling"));let gt=e?.dockerServices??await(async()=>{t=!0;let c=[...We].filter(D=>D!=="mailpit");R==="smtp"&&c.push("mailpit");let p=c.map(D=>({value:D,label:ye[D].label,hint:ye[D].hint})),y=p.map(D=>D.value).filter(D=>!(D==="postgres"&&(m==="neon"||m==="supabase")||D==="redis"&&v==="upstash")),O=await u.multiselect({message:"Which services should we set up in Docker for you?",options:p,initialValues:y,required:!1});return w(O),O})(),ht=e?.aiTools??await(async()=>{t=!0;let c=Xe.map(y=>({value:y,label:xe[y].label})),p=await u.multiselect({message:"Which AI coding tools do you use?",options:c,initialValues:[],required:!1});return w(p),p})(),yt=e?.demo,Fe=St({databaseProvider:m,cacheProvider:v,paymentProvider:b,emailProvider:R,socialProviders:he,demo:yt}),Re={};if(Fe.length>0&&t){u.log.info(f.bold("Credentials")+f.dim(" all optional - press Enter to skip, fill in .env later"));for(let c of Fe)if(t=!0,c.secret){let p=await u.password({message:c.message,mask:"*"});w(p),typeof p=="string"&&p.trim()&&(Re[c.key]=p.trim())}else{let p=await u.text({message:c.message,placeholder:c.placeholder});w(p),typeof p=="string"&&p.trim()&&(Re[c.key]=p.trim())}}if(t){let c=[` Name: ${f.cyan(r)}`,` App name: ${f.cyan(i)}`,` Location: ${f.cyan(n)}`,` Frontend: ${f.cyan(Oe[o].label)}`,` Architecture: ${f.cyan(De[g].label)}`].join(`
|
|
4
|
+
`),p=[` Deploy target: ${f.cyan(F[s]?.label??"Node.js / Docker")}`,` Database: ${f.cyan(x[m].label)}`,` Cache: ${f.cyan(B[v].label)}`,gt.length>0?` Docker: ${f.cyan(gt.map(ne=>ye[ne].label).join(", "))}`:` Docker: ${f.dim("none")}`].filter(Boolean).join(`
|
|
5
|
+
`),y=[b!=="none"?` Payment: ${f.cyan(Ge[b].label)} (${H})`:` Payment: ${f.dim("none")}`,` Credits: ${_e?f.cyan("Yes"):f.dim("No")}`,` Email: ${f.cyan(Ke[R].label)}`,` Multi-tenancy: ${te?f.cyan("Yes")+` (billing: ${ze[re].label})`:f.dim("No")}`,` Blog: ${A?f.cyan("Yes"):f.dim("No")}`,` Docs app: ${S?f.cyan("Yes"):f.dim("No")}`,` Rev. sharing: ${P?f.cyan("Yes"):f.dim("No")}`,he.length>0?` Social login: ${f.cyan(he.map(ne=>Y[ne].label).join(", "))}`:` Social login: ${f.dim("none")}`,ht.length>0?` AI tools: ${f.cyan(ht.map(ne=>xe[ne].label).join(", "))}`:` AI tools: ${f.dim("none")}`].join(`
|
|
6
|
+
`),O=[f.bold("Project"),c,"",f.bold("Infrastructure"),p,"",f.bold("Features"),y];if(Fe.length>0){let ne=Fe.map(Vt=>{let wn=Re[Vt.key]?f.green("provided"):f.dim("skipped");return` ${Vt.key}: ${wn}`}).join(`
|
|
7
|
+
`);O.push("",f.bold("Credentials"),ne)}u.note(O.join(`
|
|
8
|
+
`),"Summary");let D=await u.confirm({message:"Proceed with these settings?"});(u.isCancel(D)||!D)&&(u.cancel("Setup cancelled."),process.exit(0))}return{projectName:r,appName:i,projectDir:n,frontend:o,architecture:g,deploymentTarget:s,databaseProvider:m,cacheProvider:v,paymentProvider:b,emailProvider:R,multiTenancy:te,billingScope:re,blog:A,docs:S,revenueSharing:P,credits:_e,dockerServices:gt,aiTools:ht,socialProviders:he,defaultCurrency:H,...Object.keys(Re).length>0?{credentials:Re}:{},...e?.baseUrl!==void 0?{baseUrl:e.baseUrl}:{},...yt!==void 0?{demo:yt}:{}}}import{createReadStream as On}from"fs";import{mkdir as Dn}from"fs/promises";import{Readable as xn}from"stream";import{pipeline as Qt}from"stream/promises";import{extract as Cn}from"tar";import{join as le}from"path";import{homedir as bn}from"os";var rt=process.env.GENERATESAAS_API_URL??"https://cli.generatesaas.com",U=".generatesaas",W=le(U,"manifest.json"),zt=le(U,"hashes.json"),nt=le(U,"template-hashes.json"),it=le(U,"template"),Ht=le(U,"staging"),Yt=le(U,"staging.json"),J=le(bn(),".generatesaas");var _=class extends Error{constructor(r,i){super(i);this.status=r}status;name="ApiError"};function q(e){return{apiKey:e,baseUrl:rt}}async function X(e,t,r){let i=`${e.baseUrl}${t}`,n=await fetch(i,{...r,headers:{...r?.headers,Authorization:`Bearer ${e.apiKey}`,"User-Agent":"generatesaas-cli"}});if(!n.ok){let o;try{o=(await n.json()).error??`API ${n.status}: ${t}`}catch{o=`API ${n.status}: ${t}`}throw new _(n.status,o)}return n}import{existsSync as Tn,readFileSync as In,writeFileSync as An,mkdirSync as kn}from"fs";import{dirname as Pn}from"path";import*as Z from"@clack/prompts";function Et(){if(!Tn(J))return null;try{let e=JSON.parse(In(J,"utf-8"));return e.apiKey?e.apiKey:(e.token&&!e.apiKey&&Z.log.warning(`Found old GitHub token in ${J}. Run 'generatesaas init' to set up your API key.`),null)}catch{return null}}function pe(e){kn(Pn(J),{recursive:!0}),An(J,JSON.stringify({apiKey:e},null," ")+`
|
|
9
|
+
`,{mode:384})}async function ve(e){if(e?.apiKey)return e.apiKey;let t=process.env.GENERATESAAS_API_KEY;if(t)return t;let r=Et();if(r)return r;if(!e?.prompt)throw new Error("API key not found. Set GENERATESAAS_API_KEY or run 'generatesaas init' to configure.");return Ue()}async function Ue(){let e=await Z.text({message:"Enter your GenerateSaaS API key:",placeholder:"gs_live_...",validate:t=>{if(!t?.trim())return"API key is required."}});return Z.isCancel(e)&&(Z.cancel("Setup cancelled."),process.exit(0)),e.trim()}async function Q(e){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{latest:"0.0.0-ci",versions:[{version:"0.0.0-ci",date:new Date().toISOString(),breaking:!1}]}:await(await X(e,"/versions")).json()}async function Jt(e,t){try{return await(await X(e,`/changelog/${encodeURIComponent(t)}`)).text()}catch(r){if(r instanceof _&&r.status===404)return null;throw r}}async function qt(e,t){return await(await X(e,`/skill/${encodeURIComponent(t)}`)).json()}async function Wt(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{token:"offline-test-token",licenseId:"offline-test-license-id"}:await(await X(e,"/license/sign",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function Xt(e,t){return await(await X(e,"/license/refresh",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function Zt(e,t){let r=await fetch(`${e}/license/verify`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({token:t})});if(!r.ok)throw new Error(`Verification service returned ${r.status}`);return await r.json()}var wt=new Set([".git","node_modules",".pnpm-store",".env",".env.test",".turbo",".nuxt",".output",".data","dist",".next",".svelte-kit",".devcontainer","playwright-report","test-results"]),_n=new Set(["data","mksaas","references","scripts",".cursor",".agents",".codex",".generatesaas",".vscode",".mcp.json","AGENTS.md","CLAUDE.md","README.md","TODO.md","OVERVIEW.md"]),Rn=["docs/superpowers","packages/cli","packages/cli-api","infra/docker-compose.yml",".claude/commands",".claude/skills/web-next-port",".claude/skills/web-next-port-workspace",".claude/settings.local.json",".claude/worktrees"];function Se(e){let t=e.split("/");for(let r of t)if(wt.has(r))return!0;if(_n.has(t[0]))return!0;for(let r of Rn)if(e===r||e.startsWith(r+"/"))return!0;return!1}async function ot(e,t,r){await Dn(r,{recursive:!0});let i=process.env.GENERATESAAS_TEMPLATE_TARBALL;if(i){await Qt(On(i),er(r));return}let n=await X(e,`/template/${encodeURIComponent(t)}`);if(!n.body)throw new Error("Empty response body");let o=xn.fromWeb(n.body);await Qt(o,er(r))}function er(e){return Cn({cwd:e,strip:1,filter:t=>{let r=t.replace(/^[^/]+\//,"");return r?!Se(r):!0},sync:!1})}import{readFile as Nn,rm as tr,writeFile as Ln}from"fs/promises";import{join as bt}from"path";var Un=["apps/web-nuxt/public/images/blog","apps/web-next/public/images/blog"];async function rr(e){await Promise.all(Un.map(t=>tr(bt(e,t),{recursive:!0,force:!0})))}async function nr(e,t){t.includes("claude-code")||await tr(bt(e,".claude"),{recursive:!0,force:!0})}async function ir(e,t){let r=bt(e,".claude","settings.json"),i;try{i=await Nn(r,"utf8")}catch{return}let n=JSON.parse(i);delete n.alwaysThinkingEnabled,delete n.enableAllProjectMcpServers,n.env&&(delete n.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS,Object.keys(n.env).length===0&&delete n.env),n.permissions?.allow&&(n.permissions.allow=n.permissions.allow.filter(o=>$n(o,t))),await Ln(r,JSON.stringify(n,null," ")+`
|
|
10
|
+
`)}function $n(e,t){return!(e.startsWith("mcp__")||t!=="nuxt"&&e.includes("nuxt"))}import{join as zn}from"path";import{mkdir as jn,readdir as Mn,rm as Vn,rmdir as Fn,writeFile as Bn}from"fs/promises";import{dirname as st,join as Gn,relative as Kn}from"path";async function at(e){await jn(e,{recursive:!0})}async function l(e,t){await at(st(e)),await Bn(e,t,"utf-8")}async function Tt(e,t){await Vn(e,{force:!0});let r=st(e);for(;r!==t&&r!==st(r);){try{await Fn(r)}catch{return}r=st(r)}}async function de(e,t,r){let i=[],n=await Mn(e,{withFileTypes:!0});for(let o of n){let s=Gn(e,o.name),a=Kn(t,s);r(a)||(o.isDirectory()?i.push(...await de(s,t,r)):o.isFile()&&i.push(s))}return i}var Hn={postgres:"Postgres",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"},Yn={resend:"Resend",ses:"Amazon SES",smtp:"SMTP"},Jn={redis:"Redis",upstash:"Upstash Redis"},qn={node:"Node.js / Docker",vercel:"Vercel"},Wn={stripe:"Stripe",polar:"Polar"};function Xn(e){let t=e.frontend==="nuxt",r=t?"Nuxt 4":"Next.js 16",i=t?"apps/web-nuxt":"apps/web-next",n=t?"`app/` pages + components + composables":"`app/` routes, `components/`, `lib/`",o=e.architecture==="fullstack",s=o?"(fullstack - Hono API mounted inside the app)":"(separate - standalone Hono backend)",a=o?`Mounted inside \`${i}\`. A standalone \`apps/backend\` is also kept (inert) so you can switch to separate later.`:"Runs from `apps/backend`; the frontend reaches it over HTTP.",d=Jn[e.cacheProvider],h=qn[e.deploymentTarget],g=e.paymentProvider==="none"?"":`
|
|
11
|
+
- **Payments:** ${Wn[e.paymentProvider]}`,m=t?"`$t('key')` in templates (global helper); `useI18n()` from `vue-i18n` in `<script setup>` for `locale`/`setLocale`/`t()`.":"`useTranslations()` from `next-intl` in components; messages are loaded in `apps/web-next/i18n/request.ts`.",v=t?"**Navigation:** always use `localePath()` for paths (hardcoded paths break non-default locales); `await navigateTo()` in SSR.":"**Navigation:** `next/link` for links; `redirect()` from `next/navigation` for programmatic redirects in Server Components.";return`# AGENTS.md
|
|
12
12
|
|
|
13
13
|
Guidelines for AI coding agents (Claude Code, Codex, Cursor, \u2026) in this project.
|
|
14
|
-
Keep this file tight: add a rule only when it prevents a recurring mistake
|
|
14
|
+
Keep this file tight: add a rule only when it prevents a recurring mistake - too
|
|
15
15
|
much standing context makes the agent rigid and stops it checking the real code.
|
|
16
16
|
|
|
17
17
|
## Before you build anything (read this first)
|
|
@@ -20,11 +20,11 @@ This boilerplate already ships ~30 features, every one config-gated and wired en
|
|
|
20
20
|
end. Before writing a new file, route, table, or component, assume it ALREADY EXISTS
|
|
21
21
|
and go find it:
|
|
22
22
|
|
|
23
|
-
1. \`docs/${t?"nuxt":"next"}/index.mdx\`
|
|
24
|
-
2. \`packages/config/src/index.ts\`
|
|
23
|
+
1. \`docs/${t?"nuxt":"next"}/index.mdx\` - the catalog of every shipped feature and its config flag.
|
|
24
|
+
2. \`packages/config/src/index.ts\` - the flag that turns the feature on/off (check it before rendering).
|
|
25
25
|
3. Search \`packages/\` and \`${i}/\` for the name before creating anything.
|
|
26
26
|
|
|
27
|
-
Already built
|
|
27
|
+
Already built - extend these, never re-implement: auth (email / OAuth / 2FA / passkeys),
|
|
28
28
|
billing & subscriptions, credits, organizations & teams, notifications, email, SMS,
|
|
29
29
|
storage & uploads, admin panel, user settings, audit logs, API keys, onboarding,
|
|
30
30
|
waitlist, blog, banners, i18n, theming, dashboard shell, marketing site, background jobs.
|
|
@@ -38,37 +38,37 @@ flag, route, or translation is the most common and most costly mistake in this r
|
|
|
38
38
|
- **API:** Hono, RPC-typed. ${a}
|
|
39
39
|
- **Database:** Drizzle ORM + ${Hn[e.databaseProvider]}
|
|
40
40
|
- **Cache + jobs:** ${d} + Inngest
|
|
41
|
-
- **Auth:** Better Auth${
|
|
41
|
+
- **Auth:** Better Auth${g}
|
|
42
42
|
- **Email:** ${Yn[e.emailProvider]}
|
|
43
|
-
- **Deploy:** ${
|
|
43
|
+
- **Deploy:** ${h}
|
|
44
44
|
|
|
45
|
-
## Where things live (extend these
|
|
45
|
+
## Where things live (extend these - don't reinvent)
|
|
46
46
|
|
|
47
|
-
- \`packages/config/src\`
|
|
48
|
-
- \`packages/api/src\`
|
|
49
|
-
- \`packages/database/src\`
|
|
50
|
-
- \`packages/auth/src/config.ts\`
|
|
51
|
-
- \`packages/runtime/src/env.ts\`
|
|
52
|
-
- \`packages/{payments,mail,sms,storage,notifications}\`
|
|
53
|
-
- \`${i}\`
|
|
54
|
-
- \`docs/${t?"nuxt":"next"}/\`
|
|
47
|
+
- \`packages/config/src\` - feature flags, routes, site/pricing config. **Check the flag before building or rendering a toggleable feature.**
|
|
48
|
+
- \`packages/api/src\` - Hono routes (\`routes/\`), business logic (\`services/\`), background jobs (\`functions/\`, Inngest).
|
|
49
|
+
- \`packages/database/src\` - Drizzle schema + queries (\`db/auth.ts\` is generated - see *Don't modify*).
|
|
50
|
+
- \`packages/auth/src/config.ts\` - Better Auth config.
|
|
51
|
+
- \`packages/runtime/src/env.ts\` - the validated (Zod) env schema. New env var \u2192 add it here **and** to \`.env.example\` (the committed reference); set the local value in \`.env\`.
|
|
52
|
+
- \`packages/{payments,mail,sms,storage,notifications}\` - config-gated integrations. Every provider's files stay even when its feature is off, so flipping a flag is enough to enable it.
|
|
53
|
+
- \`${i}\` - the ${r} app (${n}).
|
|
54
|
+
- \`docs/${t?"nuxt":"next"}/\` - feature & architecture documentation for this stack (Markdown). Consult it before searching from scratch; it cites real config keys, package names, and file paths you can act on.
|
|
55
55
|
|
|
56
56
|
## Code style
|
|
57
57
|
|
|
58
|
-
- TypeScript strict
|
|
58
|
+
- TypeScript strict - no \`any\`, no unsafe casts (\`as any\`, \`as unknown as\`).
|
|
59
59
|
- JSDoc on exported functions/composables/utilities; no inline comments unless asked.
|
|
60
|
-
- Reach for the existing libs (Better Auth, Drizzle, Hono) before hand-rolling
|
|
60
|
+
- Reach for the existing libs (Better Auth, Drizzle, Hono) before hand-rolling - check their docs first.
|
|
61
61
|
|
|
62
62
|
## Don't modify
|
|
63
63
|
|
|
64
|
-
- \`pnpm-lock.yaml\` (you own lockfile changes intentionally
|
|
65
|
-
- \`packages/database/src/db/auth.ts\`
|
|
64
|
+
- \`pnpm-lock.yaml\` (you own lockfile changes intentionally - use \`pnpm add\`/\`pnpm remove\`, not hand edits) and don't hand-edit \`package.json\` deps.
|
|
65
|
+
- \`packages/database/src/db/auth.ts\` - regenerated by \`pnpm auth:generate\`. Add user fields via \`additionalFields\` in \`packages/auth/src/config.ts\`, never here.
|
|
66
66
|
|
|
67
67
|
## Gotchas (where agents trip)
|
|
68
68
|
|
|
69
|
-
- **Hono routes:** keep the method chain (\`.get().post()\`)
|
|
70
|
-
- **Feature flags:** respect \`config.*\`
|
|
71
|
-
- **i18n:** strings live in \`packages/i18n/translations/{locale}/{scope}.json\`; edit \`en/\` only, keep keys generic. ${
|
|
69
|
+
- **Hono routes:** keep the method chain (\`.get().post()\`) - RPC type inference depends on it. Validate with \`sValidator\` from \`@hono/standard-validator\`.
|
|
70
|
+
- **Feature flags:** respect \`config.*\` - hide/skip a feature when its flag is off (the files stay so you can flip it later).
|
|
71
|
+
- **i18n:** strings live in \`packages/i18n/translations/{locale}/{scope}.json\`; edit \`en/\` only, keep keys generic. ${m} A pre-commit hook runs \`pnpm translate\` (needs \`OPENROUTER_API_KEY\`) to sync other locales from \`en\`; without the key it skips.
|
|
72
72
|
- ${v}
|
|
73
73
|
- **Routes:** use \`config.routes.*\`, never hardcoded path strings.
|
|
74
74
|
- **Secrets:** never send them to an external service; generate tokens/QR codes client-side.
|
|
@@ -83,10 +83,10 @@ Scaffolded from the GenerateSaaS boilerplate. To pull upstream boilerplate updat
|
|
|
83
83
|
`}async function or(e){await l(zn(e.projectDir,"AGENTS.md"),Xn(e))}import{join as Zn}from"path";var Qn={postgres:"Postgres (self-hosted)",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"};function ei(e){let t=e.appName.trim()||e.projectName,r=e.frontend==="nuxt",i=r?"Nuxt 4":"Next.js 16",n=r?"apps/web-nuxt":"apps/web-next",o=Qn[e.databaseProvider],s=He(e),a=e.architecture==="fullstack"?`${i} app at \`${n}/\` with the Hono API mounted inside it. A standalone \`apps/backend/\` is also included (inert in this fullstack setup) so you can split the API into a separate service later without re-scaffolding.`:`${i} app at \`${n}/\` and a separate Hono backend at \`apps/backend/\`.`,d=e.architecture==="fullstack"?`- App + API: http://localhost:3000
|
|
84
84
|
- Inngest dev server: http://127.0.0.1:8288`:`- App: http://localhost:3000
|
|
85
85
|
- API: http://localhost:3010
|
|
86
|
-
- Inngest dev server: http://127.0.0.1:8288`,
|
|
87
|
-
`:"",
|
|
86
|
+
- Inngest dev server: http://127.0.0.1:8288`,h=s?`pnpm infra # optional: starts local Docker services (Postgres / Redis / Inngest / Mailpit)
|
|
87
|
+
`:"",g=e.deploymentTarget==="vercel"?"### Deployment\n\nDeploy to Vercel: `vercel deploy` (or connect the repo in the Vercel dashboard). Required environment variables are listed in `.env`.":`### Deployment
|
|
88
88
|
|
|
89
|
-
This project ships with Dockerfiles for each app. Build images with \`docker build\` and deploy to your runtime of choice (Render / Fly.io / Railway / Coolify / Dokploy / your own VPS).${s?"\n\nThe `infra/` directory ships a Docker Compose file for the local-only services (Postgres / Redis / Inngest / Mailpit, filtered by your provider choices).":""}`,
|
|
89
|
+
This project ships with Dockerfiles for each app. Build images with \`docker build\` and deploy to your runtime of choice (Render / Fly.io / Railway / Coolify / Dokploy / your own VPS).${s?"\n\nThe `infra/` directory ships a Docker Compose file for the local-only services (Postgres / Redis / Inngest / Mailpit, filtered by your provider choices).":""}`,m=e.aiTools.length>0?"To pull the latest boilerplate changes into this project, open it in your AI coding agent and ask: `update my GenerateSaaS project`.":"To pull the latest boilerplate changes into this project, install an AI coding agent (Claude Code / Cursor / Codex / Gemini CLI / Windsurf) and ask: `update my GenerateSaaS project`. The skill bundle that drives the update lives under each tool's skill root.";return`# ${t}
|
|
90
90
|
|
|
91
91
|
${a}
|
|
92
92
|
|
|
@@ -103,10 +103,10 @@ ${a}
|
|
|
103
103
|
|
|
104
104
|
\`\`\`bash
|
|
105
105
|
pnpm install
|
|
106
|
-
# A ready-to-run \`.env\` was generated for you
|
|
106
|
+
# A ready-to-run \`.env\` was generated for you - open it and fill in the
|
|
107
107
|
# values marked \`# TODO\` (provider API keys). \`.env.example\` is the committed
|
|
108
108
|
# reference. All apps load the single root \`.env\`.
|
|
109
|
-
${
|
|
109
|
+
${h}pnpm dev
|
|
110
110
|
\`\`\`
|
|
111
111
|
|
|
112
112
|
${d}
|
|
@@ -124,7 +124,7 @@ pnpm -F @repo/database studio # open Drizzle Studio
|
|
|
124
124
|
pnpm auth:generate # regenerate Better Auth schema after config changes
|
|
125
125
|
\`\`\`
|
|
126
126
|
|
|
127
|
-
${
|
|
127
|
+
${g}
|
|
128
128
|
|
|
129
129
|
## Removing the GenerateSaaS license
|
|
130
130
|
|
|
@@ -136,12 +136,12 @@ pnpm dlx generatesaas eject
|
|
|
136
136
|
|
|
137
137
|
## Updates
|
|
138
138
|
|
|
139
|
-
${
|
|
139
|
+
${m}
|
|
140
140
|
`}async function sr(e){await l(Zn(e.projectDir,"README.md"),ei(e))}function ti(e){let t=e.split(".");return t.length>=3?t.slice(1).join("."):e}async function ar(e){let t=e.appName.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),r=e.paymentProvider!=="none",i=e.baseUrl??"http://localhost:3000",n=e.baseUrl?new URL(e.baseUrl).hostname:"example.com",o=ti(n),s=e.demo?"false":"true",a=e.demo?`
|
|
141
141
|
support: {
|
|
142
142
|
enableInDev: true,
|
|
143
143
|
crisp: { websiteId: "7e221cec-ed61-46b7-b1b4-8cbc16557cca" }
|
|
144
|
-
},`:"",d=e.frontend==="nextjs"&&e.architecture==="fullstack"?"false":"true",
|
|
144
|
+
},`:"",d=e.frontend==="nextjs"&&e.architecture==="fullstack"?"false":"true",h=`import type { AppConfig } from "@repo/config/types";
|
|
145
145
|
|
|
146
146
|
const trustedOrigins = process.env.TRUSTED_ORIGINS?.split(",").map((s) => s.trim()).filter(Boolean);
|
|
147
147
|
|
|
@@ -255,7 +255,7 @@ export const config: AppConfig = {
|
|
|
255
255
|
}`:`{
|
|
256
256
|
base: "${e.defaultCurrency}",
|
|
257
257
|
list: [
|
|
258
|
-
{ symbol: "${
|
|
258
|
+
{ symbol: "${ie[e.defaultCurrency].symbol}", name: "${ie[e.defaultCurrency].name}", code: "${e.defaultCurrency}", place: "${ie[e.defaultCurrency].place}", space: ${ie[e.defaultCurrency].space} }
|
|
259
259
|
],
|
|
260
260
|
countryMap: {
|
|
261
261
|
default: "${e.defaultCurrency}"
|
|
@@ -308,8 +308,8 @@ export * from "./pricing";
|
|
|
308
308
|
export * from "./roles";
|
|
309
309
|
export * from "./section-tabs";
|
|
310
310
|
export * from "./tenancy";
|
|
311
|
-
`,
|
|
312
|
-
`)}async function cr(e){let t=`${e.projectDir}/packages/config/src/pricing.ts`,r=e.defaultCurrency;if(e.paymentProvider==="none"){let
|
|
311
|
+
`,g=`${e.projectDir}/packages/config/src/index.ts`;await l(g,h)}function ri(e){return e==="stripe"?' stripePriceId: "",':' polarProductId: "",'}function It(e){let t=[];return e.withCredits&&(t.push(` credits: ${e.credits},`),t.push(" creditInterval: 30,")),t.push(` apiRateLimit: { maxRequests: ${e.rateLimit} }`),t.join(`
|
|
312
|
+
`)}async function cr(e){let t=`${e.projectDir}/packages/config/src/pricing.ts`,r=e.defaultCurrency;if(e.paymentProvider==="none"){let m=`import type { PricingConfig } from "@repo/config/types";
|
|
313
313
|
|
|
314
314
|
export const pricingConfig: PricingConfig = {
|
|
315
315
|
defaultPlan: "free",
|
|
@@ -338,7 +338,7 @@ export const pricingConfig: PricingConfig = {
|
|
|
338
338
|
credits: { enabled: false },
|
|
339
339
|
products: { enabled: false, items: [] }
|
|
340
340
|
};
|
|
341
|
-
`;await l(t,
|
|
341
|
+
`;await l(t,m);return}let i=e.paymentProvider,n=ri(i),o=e.credits,s=It({credits:5,rateLimit:100,withCredits:o}),a=It({credits:10,rateLimit:1e3,withCredits:o}),d=It({credits:50,rateLimit:5e3,withCredits:o}),g=`import type { PricingConfig } from "@repo/config/types";
|
|
342
342
|
|
|
343
343
|
export const pricingConfig: PricingConfig = {
|
|
344
344
|
defaultPlan: "free",
|
|
@@ -428,11 +428,11 @@ ${o?" credits: { enabled: true }":" credits: { enabled: false }"},
|
|
|
428
428
|
items: []
|
|
429
429
|
}
|
|
430
430
|
};
|
|
431
|
-
`;await l(t,
|
|
431
|
+
`;await l(t,g)}var ni={smtp:[{key:"SMTP_HOST",defaultValue:"localhost"},{key:"SMTP_PORT",defaultValue:"1025"}],ses:[{key:"AMAZON_SES_REGION",comment:"# TODO: Configure Amazon SES credentials (e.g. us-east-1)"},{key:"AMAZON_SES_KEY"},{key:"AMAZON_SES_SECRET"}],resend:[{key:"RESEND_API_KEY",comment:"# TODO: Add your Resend API key"}]};function ii(e){let t=Y[e];return t.envVars.map((r,i)=>({key:r.name,...i===0?{comment:`# TODO: Add your ${t.label} OAuth credentials`}:{}}))}var oi={stripe:[{key:"STRIPE_SECRET_KEY",comment:"# TODO: Add your Stripe keys"},{key:"STRIPE_WEBHOOK_SECRET"}],polar:[{key:"POLAR_ACCESS_TOKEN",comment:"# TODO: Add your Polar keys"},{key:"POLAR_WEBHOOK_SECRET"}]};function Ee(e,t){return t?e.map(r=>{let i=t[r.key];return i?{...r,defaultValue:i,comment:void 0}:r}):e}function we(e,t){for(let r of e)r.comment&&t.push(r.comment),r.defaultValue!==void 0?t.push(`${r.key}=${r.defaultValue}`):t.push(`#${r.key}=`)}function At(e){return Array.from(crypto.getRandomValues(new Uint8Array(e))).map(t=>t.toString(16).padStart(2,"0")).join("")}function pr(e){return e.architecture==="fullstack"?{apiUrl:"http://localhost:3000/api",baseUrl:"http://localhost:3000"}:{apiUrl:"http://localhost:3010",baseUrl:"http://localhost:3000"}}function si(e){let{architecture:t,deploymentTarget:r}=e;return t==="fullstack"?r==="vercel"?{frontend:"https://your-app.vercel.app",backend:"https://your-app.vercel.app"}:r==="node"?{frontend:"https://your-app.example.com",backend:"https://your-app.example.com"}:null:{frontend:"https://your-app.example.com",backend:"https://your-app.example.com/api"}}function ct(e,t,r,i){e.push(i==="example"?`${t}=`:`${t}=${r}`)}function lr(e,t){let r=t==="example"?void 0:e.credentials,{apiUrl:i,baseUrl:n}=pr(e),o=[];e.architecture==="separate"?o.push("# API Configuration","# Standalone backend's own URL (the frontend reaches it via the public var above).",`API_URL=${i}`,`BASE_URL=${n}`):o.push("# App","# (API_URL is derived from the frontend's *_PUBLIC_API_URL by the runtime env schema.)",`BASE_URL=${n}`),o.push("","# Database"),we(Ee(x[e.databaseProvider].envVars,r),o),o.push("","# Cache"),we(Ee(B[e.cacheProvider].envVars,r),o),o.push("","# Authentication"),t==="example"&&o.push("# Generate a strong secret, e.g. `openssl rand -hex 32`"),ct(o,"BETTER_AUTH_SECRET",crypto.randomUUID(),t),o.push("","# Content API (random secret; required when contentApi feature is enabled in @repo/config)"),ct(o,"CONTENT_API_KEY",At(32),t),o.push("","# Job Queue - Inngest","INNGEST_APP_ID=api"),ct(o,"INNGEST_EVENT_KEY",At(32),t),ct(o,"INNGEST_SIGNING_KEY",At(32),t),o.push("INNGEST_BASE_URL=http://127.0.0.1:8288"),e.architecture==="separate"&&(o.push("","# API Port (standalone backend)","API_PORT=3010"),o.push("","# CORS + cross-subdomain cookies (production only - leave unset for local dev)","# TRUSTED_ORIGINS=https://your-app.example.com","# AUTH_COOKIE_DOMAIN=.example.com"));let s=ni[e.emailProvider];if(s&&(o.push("","# Email"),we(Ee(s,r),o)),e.paymentProvider!=="none"){let a=oi[e.paymentProvider];a&&(o.push("","# Payment"),we(Ee(a,r),o))}if(e.socialProviders.length>0){o.push("","# Social auth");for(let a of e.socialProviders)we(Ee(ii(a),r),o)}return e.demo&&(o.push("","# Captcha (Cloudflare Turnstile)"),we(Ee([{key:"TURNSTILE_SECRET_KEY",comment:"# TODO: Add your Cloudflare Turnstile secret key"}],r),o)),o.push("","# Translations - OpenRouter (optional)","# Set to auto-translate en/* into your other locales with `pnpm translate`.","# The pre-commit hook runs it on commit; without a key it skips and untranslated","# locales fall back to the default locale. Get a key: https://openrouter.ai/keys","#OPENROUTER_API_KEY="),o.push(""),o.join(`
|
|
432
432
|
`)}function ai(e){let{apiUrl:t}=pr(e),r=e.frontend==="nextjs"?"NEXT_PUBLIC_API_URL":"NUXT_PUBLIC_API_URL",i=["# API Configuration",`${r}=${t}`],n=si(e);return n&&e.architecture==="separate"&&i.push("","# Production (uncomment and replace with your deployed hostnames):",`# ${r}=${n.backend}`),i.push(""),i.join(`
|
|
433
433
|
`)}async function dr(e){let t=ai(e);await l(`${e.projectDir}/.env`,t+`
|
|
434
434
|
`+lr(e,"env")),await l(`${e.projectDir}/.env.example`,t+`
|
|
435
|
-
`+lr(e,"example"))}async function ur(e){let t=[...e.dockerServices];if(x[e.databaseProvider].managed&&(t=t.filter(o=>o!=="postgres")),
|
|
435
|
+
`+lr(e,"example"))}async function ur(e){let t=[...e.dockerServices];if(x[e.databaseProvider].managed&&(t=t.filter(o=>o!=="postgres")),B[e.cacheProvider].managed&&(t=t.filter(o=>o!=="redis")),t.length===0)return!1;let r=[],i=[];t.includes("postgres")&&(r.push(` postgres:
|
|
436
436
|
image: postgres:18-alpine
|
|
437
437
|
ports:
|
|
438
438
|
- "\${POSTGRES_PORT:-5432}:5432"
|
|
@@ -585,7 +585,7 @@ export interface CacheSetOptions {
|
|
|
585
585
|
* Three small helpers extended onto the native \`redis\` client for the SDK
|
|
586
586
|
* methods whose signatures differ between ioredis and Upstash. Use these in
|
|
587
587
|
* your own code when you want a uniform API; everything else on \`redis\` is
|
|
588
|
-
* the native ioredis surface (or Upstash, on that backend)
|
|
588
|
+
* the native ioredis surface (or Upstash, on that backend) - use those
|
|
589
589
|
* directly with their native syntax.
|
|
590
590
|
*/
|
|
591
591
|
export interface BoilerplateRedisHelpers {
|
|
@@ -602,7 +602,7 @@ const ioredis = new Redis(env.REDIS_URL);
|
|
|
602
602
|
/**
|
|
603
603
|
* Native ioredis client + the three boilerplate helpers. Every native
|
|
604
604
|
* ioredis method (\`zadd\`, \`hset\`, \`pubsub\`, \`eval\`, etc.) is available
|
|
605
|
-
* directly on this object
|
|
605
|
+
* directly on this object - see ioredis's docs for usage. The three
|
|
606
606
|
* \`cache*\` helpers cover the SDK calls whose signatures differ between
|
|
607
607
|
* ioredis and Upstash.
|
|
608
608
|
*/
|
|
@@ -724,7 +724,7 @@ export interface CacheSetOptions {
|
|
|
724
724
|
* Three small helpers extended onto the native \`redis\` client for the SDK
|
|
725
725
|
* methods whose signatures differ between ioredis and Upstash. Use these in
|
|
726
726
|
* your own code when you want a uniform API; everything else on \`redis\` is
|
|
727
|
-
* the native Upstash surface (or ioredis, on that backend)
|
|
727
|
+
* the native Upstash surface (or ioredis, on that backend) - use those
|
|
728
728
|
* directly with their native syntax.
|
|
729
729
|
*/
|
|
730
730
|
export interface BoilerplateRedisHelpers {
|
|
@@ -751,7 +751,7 @@ const upstash = new Redis({
|
|
|
751
751
|
/**
|
|
752
752
|
* Native Upstash REST client + the three boilerplate helpers. Every native
|
|
753
753
|
* Upstash method (\`zadd\`, \`hset\`, \`json.*\`, \`eval\`, etc.) is available
|
|
754
|
-
* directly on this object
|
|
754
|
+
* directly on this object - see Upstash's docs for usage. The three
|
|
755
755
|
* \`cache*\` helpers cover the SDK calls whose signatures differ between
|
|
756
756
|
* Upstash and ioredis.
|
|
757
757
|
*/
|
|
@@ -831,7 +831,7 @@ export class MutexTimeoutError extends Error {
|
|
|
831
831
|
|
|
832
832
|
/**
|
|
833
833
|
* Execute \`fn\` while holding a distributed mutex on \`key\`. Backed by
|
|
834
|
-
* \`@upstash/lock\`, Upstash's official distributed-lock library
|
|
834
|
+
* \`@upstash/lock\`, Upstash's official distributed-lock library - uses
|
|
835
835
|
* Lua EVAL for atomic compare-and-delete on release (no TOCTOU race) and
|
|
836
836
|
* exposes \`extend()\` for long-running operations (not wired here; pick a
|
|
837
837
|
* generous \`lockTimeout\` if you need it).
|
|
@@ -961,7 +961,7 @@ ${e.cacheProvider==="upstash"?` UPSTASH_REDIS_REST_URL: z.string(),
|
|
|
961
961
|
export const env = (() => {
|
|
962
962
|
// Compute API_URL fallback BEFORE Zod sees the input. Zod 4.4 ignores
|
|
963
963
|
// \`z.preprocess\` output when the input key is absent from the parent
|
|
964
|
-
// object
|
|
964
|
+
// object - this guarantees the key is always present and avoids the regression.
|
|
965
965
|
const rawEnv = { ...process.env };
|
|
966
966
|
rawEnv.API_URL =
|
|
967
967
|
rawEnv.API_URL ||
|
|
@@ -982,11 +982,11 @@ export const env = (() => {
|
|
|
982
982
|
const parsedApiUrl = new URL(env.API_URL);
|
|
983
983
|
export const apiBasePath = parsedApiUrl.pathname === "/" ? "" : parsedApiUrl.pathname;
|
|
984
984
|
export const apiOrigin = parsedApiUrl.origin;
|
|
985
|
-
`}import{readFile as bi}from"fs/promises";import{join as
|
|
986
|
-
`)}function $e(e,t){for(let r of t)delete e.dependencies?.[r],delete e.devDependencies?.[r]}function
|
|
985
|
+
`}import{readFile as bi}from"fs/promises";import{join as G}from"path";var lt={"@upstash/redis":"^1.37.0","@upstash/lock":"^0.2.1","@neondatabase/serverless":"^1.0.1",postgres:"^3.4.7"};async function Te(e){let t=await bi(e,"utf-8");return JSON.parse(t)}async function Ie(e,t){await l(e,JSON.stringify(t,null," ")+`
|
|
986
|
+
`)}function $e(e,t){for(let r of t)delete e.dependencies?.[r],delete e.devDependencies?.[r]}function be(e,t,r,i=!1){let n=i?"devDependencies":"dependencies";e[n]||(e[n]={}),e[n][t]=r}async function vr(e){await Ti(e),await Ii(e),await Ai(e),await ki(e),e.frontend==="nextjs"?await _i(e):await Pi(e)}async function Ti(e){let t=G(e.projectDir,"packages/api/package.json"),r=await Te(t);$e(r,["sharp","@types/sharp"]),await Ie(t,r)}async function Ii(e){let t=G(e.projectDir,"packages/runtime/package.json"),r=await Te(t);e.cacheProvider==="upstash"&&($e(r,["ioredis","rate-limit-redis","redis-semaphore"]),be(r,"@upstash/redis",lt["@upstash/redis"]),be(r,"@upstash/lock",lt["@upstash/lock"])),await Ie(t,r)}async function Ai(e){let t=G(e.projectDir,"packages/database/package.json"),r=await Te(t);e.databaseProvider==="neon"?($e(r,["pg","@types/pg"]),be(r,"@neondatabase/serverless",lt["@neondatabase/serverless"])):e.databaseProvider==="supabase"&&($e(r,["pg","@types/pg"]),be(r,"postgres",lt.postgres)),await Ie(t,r)}async function ki(e){if(e.architecture!=="separate")return;let t=G(e.projectDir,"apps/backend/package.json"),r=await Te(t);e.deploymentTarget!=="node"&&$e(r,["@hono/node-server"]),await Ie(t,r)}async function Pi(e){if(e.architecture!=="separate")return;let t=G(e.projectDir,"apps/web-nuxt");await Tt(G(t,"server/api/[...paths].ts"),t);let r=G(t,"package.json"),i=await Te(r),n=i.dependencies?.["@repo/api"];n&&(delete i.dependencies?.["@repo/api"],be(i,"@repo/api",n,!0)),await Ie(r,i)}async function _i(e){if(e.architecture!=="separate")return;let t=G(e.projectDir,"apps/web-next");await Tt(G(t,"app/api/[[...rest]]/route.ts"),t);let r=G(t,"package.json"),i=await Te(r),n=i.dependencies?.["@repo/api"];n&&(delete i.dependencies?.["@repo/api"],be(i,"@repo/api",n,!0)),await Ie(r,i)}import{readFile as Er}from"fs/promises";import{join as wr}from"path";async function br(e){let t=wr(e.projectDir,"turbo.json"),r;try{r=await Er(t,"utf-8")}catch{return}let i=JSON.parse(r),n=i.tasks?.build;if(!n)return;let o=e.frontend==="nextjs"?"NUXT_PUBLIC_*":"NEXT_PUBLIC_*",s=e.frontend==="nextjs"?new Set([".nuxt/**",".output/**"]):new Set([".next/**","!.next/cache/**"]),a=!1;if(Array.isArray(n.env)){let d=n.env.filter(h=>h!==o);d.length!==n.env.length&&(n.env=d,a=!0)}if(Array.isArray(n.outputs)){let d=n.outputs.filter(h=>!s.has(h));d.length!==n.outputs.length&&(n.outputs=d,a=!0)}a&&await l(t,JSON.stringify(i,null," ")+`
|
|
987
987
|
`)}var Ri=["base.json","node.json","next.json"],Sr="GenerateSaaS ";async function Tr(e){if(!e.demo)for(let t of Ri){let r=wr(e.projectDir,"tooling/typescript",t),i;try{i=await Er(r,"utf-8")}catch{continue}let n=JSON.parse(i);typeof n.display!="string"||!n.display.startsWith(Sr)||(n.display=n.display.slice(Sr.length),await l(r,JSON.stringify(n,null," ")+`
|
|
988
|
-
`))}}import{readFile as Oi,rm as Di}from"fs/promises";import{existsSync as Ir}from"fs";import{join as Ar}from"path";async function kr(e){if(e.frontend==="nuxt")return;let t=Ar(e.projectDir,"packages/i18n/package.json");if(!Ir(t))throw new Error(`pruneI18nNuxt: expected ${t} to exist
|
|
989
|
-
`);let o=Ar(e.projectDir,"packages/i18n/nuxt");if(i&&!Ir(o))throw new Error(`pruneI18nNuxt: packages/i18n declares a Nuxt export surface but ${o} is missing
|
|
988
|
+
`))}}import{readFile as Oi,rm as Di}from"fs/promises";import{existsSync as Ir}from"fs";import{join as Ar}from"path";async function kr(e){if(e.frontend==="nuxt")return;let t=Ar(e.projectDir,"packages/i18n/package.json");if(!Ir(t))throw new Error(`pruneI18nNuxt: expected ${t} to exist - did the i18n package move?`);let r=JSON.parse(await Oi(t,"utf-8")),i=!!(r.exports?.["./module"]??r.exports?.["./nuxt"]),n=!1;if(r.exports)for(let s of["./module","./nuxt"])s in r.exports&&(delete r.exports[s],n=!0);r.devDependencies&&"@nuxt/kit"in r.devDependencies&&(delete r.devDependencies["@nuxt/kit"],n=!0),n&&await l(t,JSON.stringify(r,null," ")+`
|
|
989
|
+
`);let o=Ar(e.projectDir,"packages/i18n/nuxt");if(i&&!Ir(o))throw new Error(`pruneI18nNuxt: packages/i18n declares a Nuxt export surface but ${o} is missing - did the i18n Nuxt module move?`);await Di(o,{recursive:!0,force:!0})}import{readFile as Pr,rm as xi}from"fs/promises";import{join as Pt}from"path";async function _r(e){e.cacheProvider==="upstash"&&await Promise.all([Ci(e.projectDir),Ni(e.projectDir),xi(Pt(e.projectDir,"packages/runtime/tests/redis.test.ts"),{force:!0})])}async function Ci(e){let t=Pt(e,"packages/runtime/tests/setup.ts"),r;try{r=await Pr(t,"utf-8")}catch{return}let i=r.replace(/\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
990
990
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
991
991
|
`);i!==r&&await l(t,i)}async function Ni(e){let t=Pt(e,"packages/api/tests/setup.ts"),r;try{r=await Pr(t,"utf-8")}catch{return}let i=r;i=i.replace(/\tREDIS_URL:\s*"[^"]*",?\n/g,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
992
992
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
@@ -1009,8 +1009,8 @@ vi.mock("@upstash/lock", () => {
|
|
|
1009
1009
|
return { Lock };
|
|
1010
1010
|
});
|
|
1011
1011
|
|
|
1012
|
-
$1`),i!==r&&await l(t,i)}import{readdir as Li,readFile as Ui,rm as pt}from"fs/promises";import{join as
|
|
1013
|
-
`)}async function Dr(e){let t=e.frontend==="nextjs"?"apps/web-nuxt":"apps/web-next";await pt(
|
|
1012
|
+
$1`),i!==r&&await l(t,i)}import{readdir as Li,readFile as Ui,rm as pt}from"fs/promises";import{join as Ae}from"path";var $i=new Set(["ci.yml"]),ji=["cli","cli:clean","demo:bench","playground:regen","playground:test","playground:test:units"];async function Rr(e){let t=Ae(e.projectDir,".github/workflows"),r=await Li(t).catch(()=>[]);for(let i of r)$i.has(i)||await pt(Ae(t,i),{recursive:!0,force:!0})}async function Or(e){let t=Ae(e.projectDir,"package.json"),r=await Ui(t,"utf-8"),i=JSON.parse(r),n=!1;if(i.scripts){for(let o of ji)o in i.scripts&&(delete i.scripts[o],n=!0);if(!He(e))for(let o of["infra","infra:stop"])o in i.scripts&&(delete i.scripts[o],n=!0)}n&&await l(t,JSON.stringify(i,null," ")+`
|
|
1013
|
+
`)}async function Dr(e){let t=e.frontend==="nextjs"?"apps/web-nuxt":"apps/web-next";await pt(Ae(e.projectDir,t),{recursive:!0,force:!0})}async function xr(e){e.docs||await pt(Ae(e.projectDir,"apps/docs"),{recursive:!0})}async function Cr(e){let t=e.frontend==="nextjs"?"docs/nuxt":"docs/next";await pt(Ae(e.projectDir,t),{recursive:!0,force:!0})}import{join as Mi}from"path";async function Nr(e){let t=Vi(e);await l(Mi(e.projectDir,".github/workflows/ci.yml"),t)}function Vi(e){let t=x[e.databaseProvider].managed,r=e.cacheProvider==="upstash",i=e.frontend==="nuxt",n=t?"":` services:
|
|
1014
1014
|
postgres:
|
|
1015
1015
|
image: postgres:18-alpine
|
|
1016
1016
|
env:
|
|
@@ -1030,7 +1030,7 @@ $1`),i!==r&&await l(t,i)}import{readdir as Li,readFile as Ui,rm as pt}from"fs/pr
|
|
|
1030
1030
|
STRIPE_SECRET_KEY: test
|
|
1031
1031
|
STRIPE_WEBHOOK_SECRET: test`;case"polar":return`
|
|
1032
1032
|
POLAR_ACCESS_TOKEN: test
|
|
1033
|
-
POLAR_WEBHOOK_SECRET: test`;case"none":return"";default:{let
|
|
1033
|
+
POLAR_WEBHOOK_SECRET: test`;case"none":return"";default:{let m=e.paymentProvider;throw new Error(`buildCiYaml: unhandled payment provider "${String(m)}"`)}}})(),d=e.socialProviders.map(m=>Y[m].envVars.map(v=>`
|
|
1034
1034
|
${v.name}: test`).join("")).join("");return`# Deployment is handled by the hosting platform (Vercel, Coolify, etc.)
|
|
1035
1035
|
# which auto-deploys on push. CI runs in parallel as a quality gate.
|
|
1036
1036
|
# For PR-based workflows, enable GitHub branch protection to require CI before merging.
|
|
@@ -1095,36 +1095,36 @@ ${n} env:
|
|
|
1095
1095
|
`))}async function $r(e){let t=Bi(e.demo===!0),r=Gi(e.architecture,e.frontend),i=_t(e.projectDir,"apps",r);switch(e.deploymentTarget){case"node":await Ki(_t(i,"package.json"),"start",t);return;case"vercel":await zi(_t(i,"vercel.json"),t);return;default:{let n=e.deploymentTarget;throw new Error(`generateDeployScripts: unhandled deployment target "${String(n)}"`)}}}import{readFile as Hi}from"fs/promises";import{existsSync as Yi}from"fs";import{join as dt}from"path";var Ji=["stripe","polar"];async function jr(e){let t=dt(e.projectDir,"packages/payments/src"),r=e.paymentProvider,i=`// Active payment provider. To switch, change the path below to
|
|
1096
1096
|
// "./polar/index" or "./none/index" (other folders are kept in place).
|
|
1097
1097
|
export { ops } from "./${r}/index";
|
|
1098
|
-
`;await l(dt(t,"providers/index.ts"),i),await l(dt(t,"index.ts"),await qi(t,r))}async function qi(e,t){let r=dt(e,"index.ts");if(!Yi(r))throw new Error(`generatePaymentBarrel: expected ${r} to exist
|
|
1098
|
+
`;await l(dt(t,"providers/index.ts"),i),await l(dt(t,"index.ts"),await qi(t,r))}async function qi(e,t){let r=dt(e,"index.ts");if(!Yi(r))throw new Error(`generatePaymentBarrel: expected ${r} to exist - did packages/payments move?`);let i=await Hi(r,"utf-8"),n=Ji.filter(s=>s!==t);return i.split(`
|
|
1099
1099
|
`).filter(s=>!n.some(a=>s.includes(`./providers/${a}/`))).join(`
|
|
1100
1100
|
`)}import{readdir as Wi,readFile as Xi}from"fs/promises";import{join as Mr}from"path";async function Vr(e){if(e.demo)return;let t=e.appName.trim()||e.projectName,r=JSON.stringify(t).slice(1,-1),i=Mr(e.projectDir,"packages/i18n/translations"),n;try{n=await Wi(i)}catch{return}for(let o of n){let s=Mr(i,o,"web.json"),a;try{a=await Xi(s,"utf-8")}catch{continue}let d=a.replaceAll("GenerateSaaS",r);d!==a&&await l(s,d)}}import{readFile as Zi}from"fs/promises";import{join as Fr}from"path";var Qi=[".nuxt/",".nuxt",".nitro/",".nitro",".output/",".output","_locales/"],eo=[".next/",".next",".svelte-kit/",".svelte-kit",".wrangler/",".wrangler",".dev.vars"];async function Gr(e){let r=e.frontend==="nuxt"?eo:Qi;await Br(Fr(e.projectDir,".gitignore"),r),await Br(Fr(e.projectDir,".dockerignore"),r)}async function Br(e,t){let r;try{r=await Zi(e,"utf-8")}catch{return}let i=new Set(t),n=r.split(`
|
|
1101
1101
|
`).filter(o=>!i.has(o.trim()));n.length!==r.split(`
|
|
1102
1102
|
`).length&&await l(e,n.join(`
|
|
1103
|
-
`))}async function ut(e){let t=e.projectDir;e.demo||await rr(t),await nr(t,e.aiTools),await ir(t,e.frontend),await or(e),await sr(e),await ar(e),e.demo||await cr(e),await dr(e);let r=await ur(e);return await mr(e),await fr(e),await gr(e),await hr(e),await yr(e),await vr(e),await br(e),await Tr(e),await kr(e),await _r(e),await Rr(e),await Nr(e),await Or(e),await Dr(e),await xr(e),await Cr(e),await $r(e),await jr(e),await Vr(e),await Gr(e),{dockerComposeGenerated:r}}import{basename as zr,join as Hr,relative as ro}from"path";import{createHash as Kr}from"crypto";import{readFile as to}from"fs/promises";async function mt(e){let t=await to(e);return Kr("sha256").update(t).digest("hex")}function Rt(e){return Kr("sha256").update(e).digest("hex")}var no=new Set(["data",
|
|
1103
|
+
`))}async function ut(e){let t=e.projectDir;e.demo||await rr(t),await nr(t,e.aiTools),await ir(t,e.frontend),await or(e),await sr(e),await ar(e),e.demo||await cr(e),await dr(e);let r=await ur(e);return await mr(e),await fr(e),await gr(e),await hr(e),await yr(e),await vr(e),await br(e),await Tr(e),await kr(e),await _r(e),await Rr(e),await Nr(e),await Or(e),await Dr(e),await xr(e),await Cr(e),await $r(e),await jr(e),await Vr(e),await Gr(e),{dockerComposeGenerated:r}}import{basename as zr,join as Hr,relative as ro}from"path";import{createHash as Kr}from"crypto";import{readFile as to}from"fs/promises";async function mt(e){let t=await to(e);return Kr("sha256").update(t).digest("hex")}function Rt(e){return Kr("sha256").update(e).digest("hex")}var no=new Set(["data",U]);function io(e){let t=e.split("/");for(let r of t)if(wt.has(r)||no.has(r)||r.startsWith(".env")&&!r.includes("example"))return!0;return!1}function Yr(e,t){return{projectName:e.projectName??zr(t),appName:e.appName??e.projectName??zr(t),projectDir:t,frontend:e.frontend==="nextjs"?"nextjs":"nuxt",architecture:e.architecture??"fullstack",paymentProvider:e.paymentProvider??"none",emailProvider:e.emailProvider??"smtp",multiTenancy:e.multiTenancy??!1,billingScope:e.billingScope??"user",blog:e.blog??!1,docs:e.docs??!1,revenueSharing:e.revenueSharing??!1,credits:e.credits??!1,dockerServices:e.dockerServices??[],aiTools:e.aiTools??[],socialProviders:e.socialProviders??[],defaultCurrency:e.defaultCurrency??"USD",deploymentTarget:e.deploymentTarget??"node",databaseProvider:e.databaseProvider??"postgres",cacheProvider:e.cacheProvider??"redis",version:e.version,baseUrl:e.baseUrl,credentials:{},demo:!1}}async function Jr(e,t){let i=(await de(e.projectDir,e.projectDir,io)).sort(),n=await Promise.all(i.map(async a=>[ro(e.projectDir,a),await mt(a)])),o=Object.fromEntries(n),s={version:e.version,initialVersion:e.version,repo:"Duzbee/GenerateSaaS",appName:e.appName,projectName:e.projectName,frontend:e.frontend,architecture:e.architecture,paymentProvider:e.paymentProvider,emailProvider:e.emailProvider,multiTenancy:e.multiTenancy,billingScope:e.billingScope,blog:e.blog,docs:e.docs,credits:e.credits,revenueSharing:e.revenueSharing,defaultCurrency:e.defaultCurrency,dockerServices:e.dockerServices,socialProviders:e.socialProviders,deploymentTarget:e.deploymentTarget,databaseProvider:e.databaseProvider,cacheProvider:e.cacheProvider,aiTools:e.aiTools,...e.baseUrl?{baseUrl:e.baseUrl}:{},...t&&{licenseToken:t.token,licenseKeyHash:t.keyHash,installId:t.installId}};await l(Hr(e.projectDir,W),JSON.stringify(s,null," ")+`
|
|
1104
1104
|
`),await l(Hr(e.projectDir,zt),JSON.stringify(o,null," ")+`
|
|
1105
|
-
`)}import{relative as oo}from"path";async function je(e){let r=(await
|
|
1106
|
-
`);o(new Error(
|
|
1107
|
-
${
|
|
1108
|
-
`),$.yellow("Start Development")),t.dockerComposeGenerated){let o=[];o.push(`App ${$.cyan("http://localhost:3000")}`),e.architecture==="separate"&&o.push(`API ${$.cyan("http://localhost:3010")}`),e.dockerServices.includes("mailpit")&&o.push(`Mailpit ${$.cyan("http://localhost:8025")}`),e.dockerServices.includes("inngest")&&o.push(`Inngest ${$.cyan("http://localhost:8288")}`),
|
|
1109
|
-
`),$.yellow("Dev Tools"))}let i=[],n=To(e);n.length>0&&i.push(`Set in production: ${$.dim(n.join(", "))}`),i.push("pnpm db:push # Run database migrations"),i.push(Io(e)),
|
|
1110
|
-
`),$.yellow("Deployment"))}function To(e){let t=["DATABASE_URL","BETTER_AUTH_SECRET"];return e.cacheProvider==="upstash"?t.push("UPSTASH_REDIS_REST_URL","UPSTASH_REDIS_REST_TOKEN"):t.push("REDIS_URL"),e.paymentProvider==="stripe"?t.push("STRIPE_SECRET_KEY","STRIPE_WEBHOOK_SECRET"):e.paymentProvider==="polar"&&t.push("POLAR_ACCESS_TOKEN","POLAR_WEBHOOK_SECRET"),e.emailProvider==="ses"?t.push("AMAZON_SES_REGION","AMAZON_SES_KEY","AMAZON_SES_SECRET"):e.emailProvider==="resend"?t.push("RESEND_API_KEY"):t.push("SMTP_HOST","SMTP_PORT"),t}function Io(e){switch(e.deploymentTarget){case"node":return"Deploy with Docker or your preferred Node.js host";case"vercel":return"vercel deploy # Deploy to Vercel"}}function cn(e){let t={};if(e.name!==void 0){if(!tt(e.name))throw new Error(`Invalid project name "${e.name}". Use lowercase letters, numbers, and hyphens only. Must start with a letter.`);t.projectName=e.name}if(e.appName!==void 0){if(!e.appName.trim())throw new Error("App name cannot be empty.");t.appName=e.appName}if(e.location!==void 0?t.projectDir=e.location==="."?process.cwd():e.location:t.projectName!==void 0&&(t.projectDir=`./${t.projectName}`),e.frontend!==void 0){if(!Ue.includes(e.frontend))throw new Error(`Invalid frontend "${e.frontend}". Valid values: ${Ue.join(", ")}`);t.frontend=e.frontend}if(e.architecture!==void 0&&(t.architecture=e.architecture),e.payment!==void 0&&(t.paymentProvider=e.payment),e.email!==void 0&&(t.emailProvider=e.email),e.org!==void 0&&(t.multiTenancy=e.org),e.billingScope!==void 0){if(e.org===!1)throw new Error("--billing-scope requires --org to be enabled.");t.billingScope=e.billingScope}if(e.blog!==void 0&&(t.blog=e.blog),e.docs!==void 0&&(t.docs=e.docs),e.revenueSharing!==void 0&&(t.revenueSharing=e.revenueSharing),e.credits!==void 0){if(e.credits===!0&&e.payment==="none")throw new Error("--credits requires a payment provider (got --payment none).");t.credits=e.credits}if(e.docker!==void 0&&(t.dockerServices=Lt(e.docker,We,"docker service")),e.aiTools!==void 0&&(t.aiTools=Lt(e.aiTools,Xe,"AI tool")),e.socialProviders!==void 0&&(t.socialProviders=Lt(e.socialProviders,Qe,"social provider")),e.currency!==void 0){if(!ae.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${ae.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!ce.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${ce.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!le.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${le.join(", ")}`);t.databaseProvider=e.database}if(e.cache!==void 0){if(!pe.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${pe.join(", ")}`);t.cacheProvider=e.cache}if(e.demo===!0&&(t.demo=!0),e.baseUrl!==void 0){let r=e.baseUrl.trim();if(r==="")throw new Error("--base-url cannot be empty. Provide an absolute URL like https://example.com.");let i;try{i=new URL(r)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(i.protocol!=="http:"&&i.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${i.protocol}//${i.host}`}return t}var re={projectName:"my-saas",frontend:"nextjs",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,billingScope:"user",blog:!0,docs:!1,revenueSharing:!1,credits:!0,dockerServices:["postgres","redis","inngest"],aiTools:[],socialProviders:[],defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"};function ln(e){let t=e.projectName??re.projectName,r=e.projectDir??`./${t}`,i=e.appName??et(t),n=e.deploymentTarget??re.deploymentTarget,o=B[n]?.edgeRuntime??!1,s=e.databaseProvider??(o?"neon":re.databaseProvider),a=e.cacheProvider??(o?"upstash":re.cacheProvider),d=e.emailProvider??(o?"resend":re.emailProvider),g=e.dockerServices??(o?re.dockerServices.filter(u=>u!=="postgres"&&u!=="redis"):re.dockerServices),h={...re,...e,projectName:t,appName:i,projectDir:r,deploymentTarget:n,databaseProvider:s,cacheProvider:a,emailProvider:d,dockerServices:g};h.paymentProvider==="none"&&(h.credits=!1);for(let u of Ne){if(h.deploymentTarget!==u.target)continue;let v=h.databaseProvider===u.provider?"database":"cache";if(h.databaseProvider===u.provider||h.cacheProvider===u.provider)throw new Error(`Incompatible: --deploy ${u.target} + --${v} ${u.provider}. ${u.reason}`)}for(let u of Le)if(h.architecture===u.architecture&&h.deploymentTarget===u.target)throw new Error(`Incompatible: --architecture ${u.architecture} + --deploy ${u.target}. ${u.reason}`);return h}function Lt(e,t,r){if(e.trim()==="")return[];let i=e.split(",").map(o=>o.trim()).filter(Boolean),n=i.filter(o=>!t.includes(o));if(n.length>0)throw new Error(`Invalid ${r}(s): ${n.join(", ")}. Valid values: ${t.join(", ")}`);return i}import Oo from"picocolors";var Do="c81635e3715dc7274f33a745e24a394d93d3d081a4004408585c3de86e1aac35";function xo(e){if(e===void 0)return;let t=e.trim().replace(/^v/,"");if(!/^\d+\.\d+\.\d+$/.test(t))throw new Error(`Invalid template version "${e}". Use semver like 1.2.3.`);return t}function pn(e){e.command("init").description("Scaffold a new GenerateSaaS project").option("-n, --name <name>","project name (lowercase, hyphens, starts with letter)").option("--app-name <name>","display name for the app").option("-l, --location <path>","project directory (default: ./{name})").addOption(new j("--frontend <type>","frontend framework").choices([...Ue])).addOption(new j("--architecture <type>","fullstack or separate").choices([...Ye])).addOption(new j("--payment <provider>","payment provider").choices([...Je])).addOption(new j("--email <provider>","email provider").choices([...qe])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").addOption(new j("--billing-scope <scope>","billing scope (requires --org)").choices([...Ze])).option("--blog","enable blog").option("--no-blog","disable blog").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--revenue-sharing","enable revenue sharing").option("--no-revenue-sharing","disable revenue sharing").option("--credits","enable credits system").option("--no-credits","disable credits system (subscription-only)").option("--docker <services>","comma-separated: postgres,redis,inngest,mailpit").option("--ai-tools <tools>","comma-separated: claude-code,cursor,codex,gemini-cli,windsurf").option("--social-providers <providers>","comma-separated: google,github,facebook,discord,x").addOption(new j("--currency <code>","default currency for billing").choices([...ae])).addOption(new j("--deploy <target>","deployment target").choices([...ce])).addOption(new j("--database <provider>","database provider").choices([...le])).addOption(new j("--cache <provider>","cache provider").choices([...pe])).option("--template-version <version>","specific template version to scaffold").option("--api-key <key>","API key (skips interactive prompt)").option("--base-url <url>","public base URL (e.g. https://example.com) \u2014 bakes into canonical/og/sitemap").option("-y, --yes","accept defaults for unspecified options (non-interactive)").addOption(new j("--demo","first-party demo build: keep sample content, mark site non-indexable \u2014 requires CI API key").hideHelp()).addOption(new j("--no-db-migration","skip generating the baseline DB migration (internal: demos/CI/playground)").hideHelp()).action(async t=>{await Co(t)})}async function Co(e){let t=performance.now();Ft("1.2.0");let r,i;try{r=cn(e),i=xo(e.templateVersion)}catch(S){E.cancel(I(S)),process.exit(1)}let n=E.spinner(),o;try{o=await Se({apiKey:e.apiKey,prompt:!e.yes})}catch(S){E.cancel(I(S)),process.exit(1)}e.demo&&Rt(o)!==Do&&(E.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let s=U(o),a=async()=>{let S=await K(s),P=S.latest,Re=i??P;if(i&&!S.versions.some(ye=>ye.version===Re))throw new Error(`Template version "${i}" is not available.`);return{latestVersion:P,selectedVersion:Re}};n.start("Verifying access...");let d,g;try{({latestVersion:d,selectedVersion:g}=await a()),n.stop("Access verified."),X(o)}catch(S){if(n.stop("Access verification failed."),S instanceof _&&S.status===401){e.yes&&(E.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),E.log.warning("Invalid API key."),o=await Z(),s=U(o),n.start("Verifying access...");try{({latestVersion:d,selectedVersion:g}=await a()),n.stop("Access verified."),X(o)}catch(P){n.stop("Access verification failed."),E.cancel(P instanceof _&&P.status===401?"Invalid API key.":I(P)),process.exit(1)}}else E.cancel(I(S)),process.exit(1)}E.log.success(`Latest version: ${d}`),g!==d&&E.log.success(`Using template version: ${g}`);let h;e.yes?h=ln(r):h=await Kt(r);let u;n.start("Activating license...");try{let S=crypto.randomUUID();u={token:(await Wt(s,{frontend:h.frontend,version:g,installId:S})).token,keyHash:Rt(o),installId:S},n.stop("License activated.")}catch(S){n.stop("License activation failed."),E.cancel(I(S)),process.exit(1)}let v=Ro(h.projectDir);if(Ao(v)&&ko(v).length>0)if(e.yes)E.log.info(`Directory ${v} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let P=await E.select({message:`Directory ${v} is not empty.`,options:[{value:"merge",label:"Merge",hint:"keep existing files, overwrite conflicts"},{value:"overwrite",label:"Overwrite",hint:"delete everything and start fresh"},{value:"cancel",label:"Cancel"}]});(E.isCancel(P)||P==="cancel")&&(E.cancel("Setup cancelled."),process.exit(0)),P==="overwrite"&&Po(v,{recursive:!0,force:!0})}let b={...h,projectDir:v,version:g,...e.demo?{docs:!1}:{}};n.start("Downloading template...");try{await ot(s,g,v),n.stop("Template downloaded.")}catch(S){n.stop("Download failed."),E.cancel(I(S)),process.exit(1)}let J;n.start("Generating project files...");try{if({dockerComposeGenerated:J}=await ut(b),!e.demo){let S=await je(v);await l(_o(v,nt),JSON.stringify(S,null," ")+`
|
|
1111
|
-
`),await Wr(v,v)}await Qr(v,b.aiTools),await Jr(b,
|
|
1112
|
-
`),k.log.success("License refreshed.")}catch{k.log.warn("License refresh skipped.")}
|
|
1113
|
-
`)}a.stop("Baseline template stored.")}else if(
|
|
1105
|
+
`)}import{relative as oo}from"path";async function je(e){let r=(await de(e,e,Se)).sort(),i=await Promise.all(r.map(async n=>[oo(e,n),await mt(n)]));return Object.fromEntries(i)}import{copyFile as so,mkdir as ao,rm as co}from"fs/promises";import{dirname as lo,join as qr,relative as po}from"path";import{existsSync as uo}from"fs";async function Ot(e,t){uo(t)&&await co(t,{recursive:!0,force:!0});let r=await de(e,e,Se);for(let i of r){let n=po(e,i),o=qr(t,n);await ao(lo(o),{recursive:!0}),await so(i,o)}}async function Wr(e,t){await Ot(e,qr(t,it))}import{existsSync as mo}from"fs";import{readFile as Xr,readdir as fo}from"fs/promises";import{join as K,dirname as go,resolve as ho,sep as yo}from"path";import{fileURLToPath as vo}from"url";var Me={"claude-code":".claude/skills",cursor:".cursor/skills",codex:".agents/skills","gemini-cli":".gemini/skills",windsurf:".windsurf/skills"},ll=Object.values(Me),Dt="generatesaas-update",Zr=go(vo(import.meta.url));function So(){let e=K(Zr,"skill","content");return mo(e)?e:K(Zr,"content")}function xt(e){return!e||e.length===0?[]:e.map(t=>Me[t])}async function Ct(e,t,r,i){let n=xt(i);for(let o of n){let s=K(e,o,Dt),a=K(s,"scripts"),d=K(s,"references");await at(a),await at(d),await l(K(s,"SKILL.md"),t.replaceAll("__SKILL_ROOT__",o)),await l(K(d,".gitkeep"),"");for(let[h,g]of Object.entries(r)){let m=ho(a,h);m.startsWith(a+yo)&&await l(m,g)}}}async function Qr(e,t){let r=So(),i=await Xr(K(r,"SKILL.md"),"utf-8"),n=K(r,"scripts"),o=await fo(n),s={};for(let a of o)a!==".gitkeep"&&(s[a]=await Xr(K(n,a),"utf-8"));await Ct(e,i,s,t)}import{execFile as Eo,execFileSync as wo}from"child_process";import{access as en,readFile as bo}from"fs/promises";import{join as Nt}from"path";import*as T from"@clack/prompts";function me(e){try{let t=process.platform==="win32"?"where":"which";return wo(t,[e],{stdio:"ignore"}),!0}catch{return!1}}function ue(e,t,r,i=3e5){return new Promise((n,o)=>{Eo(e,t,{cwd:r,timeout:i},(s,a,d)=>{if(s){let h=String(a||"").trim(),m=[String(d||"").trim(),h].filter(Boolean).join(`
|
|
1106
|
+
`);o(new Error(m?`${s.message}
|
|
1107
|
+
${m}`:s.message))}else n()})})}async function tn(e){if(!me("pnpm"))return T.log.warn("pnpm not found. Skipping lockfile regeneration."),!1;try{return await ue("pnpm",["install","--lockfile-only","--no-frozen-lockfile","--config.minimumReleaseAge=0"],e),!0}catch(t){let r=t instanceof Error?t.message:String(t);return T.log.warn(`Lockfile regeneration failed: ${r}`),T.log.warn("Deploys using --frozen-lockfile may fail."),!1}}async function rn(e){if(!me("pnpm"))return T.log.warn("pnpm not found. Skipping dependency installation."),T.log.info("Install pnpm: https://pnpm.io/installation"),!1;let t=T.spinner();t.start("Installing dependencies (this may take a minute)...");try{return await ue("pnpm",["install","--config.minimumReleaseAge=0"],e),t.stop("Dependencies installed."),!0}catch(r){t.stop("Dependency installation failed.");let i=r instanceof Error?r.message:String(r);return T.log.warn(`pnpm install failed: ${i}`),T.log.warn("You can run it manually later."),!1}}async function nn(e){if(!me("pnpm"))return!1;let t=T.spinner();t.start("Generating baseline database migration...");try{return await ue("pnpm",["-F","@repo/database","generate"],e),t.stop("Baseline migration generated."),!0}catch(r){t.stop("Baseline migration generation failed.");let i=r instanceof Error?r.message:String(r);return T.log.warn(`Could not generate baseline migration: ${i}`),T.log.warn("Run 'pnpm -F @repo/database generate' before your first deploy."),!1}}async function on(e){try{return await en(Nt(e,".git")),T.log.info("Git repository already exists, skipping init."),!0}catch{}if(!me("git"))return T.log.warn("git not found. Skipping repository initialization."),!1;let t=T.spinner();t.start("Initializing git repository...");try{return await ue("git",["init"],e),await ue("git",["add","-A"],e),await ue("git",["commit","--no-verify","-m","Initial commit from GenerateSaaS"],e),t.stop("Git repository initialized."),!0}catch{return t.stop("Git initialization failed."),T.log.warn("You can run git init manually later."),!1}}async function sn(e){if(!me("pnpm"))return!1;try{await en(Nt(e,".git"))}catch{return!1}try{let t=JSON.parse(await bo(Nt(e,"package.json"),"utf-8")),r=!!t.devDependencies?.["simple-git-hooks"],i=!!t["simple-git-hooks"];if(!r||!i)return!1}catch{return!1}try{return await ue("pnpm",["exec","simple-git-hooks"],e),!0}catch{return T.log.warn("Could not install git hooks. Run 'pnpm exec simple-git-hooks' manually."),!1}}import*as ke from"@clack/prompts";import $ from"picocolors";function an(e,t){t.dockerComposeGenerated&&!t.dockerAvailable&&ke.log.warn("Docker not found. Install Docker to run local services: https://docs.docker.com/get-docker/");let r=[];if(r.push(`cd ${e.projectDir}`),t.pnpmInstalled||r.push("pnpm install"),t.dockerComposeGenerated){let o=e.dockerServices.map(s=>ye[s].label).join(", ");r.push(`pnpm infra ${$.dim(`# ${o}`)}`)}if(r.push(`pnpm dev ${$.dim("# http://localhost:3000")}`),t.skippedCredentials.length>0&&(r.push(""),r.push($.dim("Fill in remaining TODO values in .env"))),ke.note(r.join(`
|
|
1108
|
+
`),$.yellow("Start Development")),t.dockerComposeGenerated){let o=[];o.push(`App ${$.cyan("http://localhost:3000")}`),e.architecture==="separate"&&o.push(`API ${$.cyan("http://localhost:3010")}`),e.dockerServices.includes("mailpit")&&o.push(`Mailpit ${$.cyan("http://localhost:8025")}`),e.dockerServices.includes("inngest")&&o.push(`Inngest ${$.cyan("http://localhost:8288")}`),ke.note(o.join(`
|
|
1109
|
+
`),$.yellow("Dev Tools"))}let i=[],n=To(e);n.length>0&&i.push(`Set in production: ${$.dim(n.join(", "))}`),i.push("pnpm db:push # Run database migrations"),i.push(Io(e)),ke.note(i.join(`
|
|
1110
|
+
`),$.yellow("Deployment"))}function To(e){let t=["DATABASE_URL","BETTER_AUTH_SECRET"];return e.cacheProvider==="upstash"?t.push("UPSTASH_REDIS_REST_URL","UPSTASH_REDIS_REST_TOKEN"):t.push("REDIS_URL"),e.paymentProvider==="stripe"?t.push("STRIPE_SECRET_KEY","STRIPE_WEBHOOK_SECRET"):e.paymentProvider==="polar"&&t.push("POLAR_ACCESS_TOKEN","POLAR_WEBHOOK_SECRET"),e.emailProvider==="ses"?t.push("AMAZON_SES_REGION","AMAZON_SES_KEY","AMAZON_SES_SECRET"):e.emailProvider==="resend"?t.push("RESEND_API_KEY"):t.push("SMTP_HOST","SMTP_PORT"),t}function Io(e){switch(e.deploymentTarget){case"node":return"Deploy with Docker or your preferred Node.js host";case"vercel":return"vercel deploy # Deploy to Vercel"}}function cn(e){let t={};if(e.name!==void 0){if(!tt(e.name))throw new Error(`Invalid project name "${e.name}". Use lowercase letters, numbers, and hyphens only. Must start with a letter.`);t.projectName=e.name}if(e.appName!==void 0){if(!e.appName.trim())throw new Error("App name cannot be empty.");t.appName=e.appName}if(e.location!==void 0?t.projectDir=e.location==="."?process.cwd():e.location:t.projectName!==void 0&&(t.projectDir=`./${t.projectName}`),e.frontend!==void 0){if(!Le.includes(e.frontend))throw new Error(`Invalid frontend "${e.frontend}". Valid values: ${Le.join(", ")}`);t.frontend=e.frontend}if(e.architecture!==void 0&&(t.architecture=e.architecture),e.payment!==void 0&&(t.paymentProvider=e.payment),e.email!==void 0&&(t.emailProvider=e.email),e.org!==void 0&&(t.multiTenancy=e.org),e.billingScope!==void 0){if(e.org===!1)throw new Error("--billing-scope requires --org to be enabled.");t.billingScope=e.billingScope}if(e.blog!==void 0&&(t.blog=e.blog),e.docs!==void 0&&(t.docs=e.docs),e.revenueSharing!==void 0&&(t.revenueSharing=e.revenueSharing),e.credits!==void 0){if(e.credits===!0&&e.payment==="none")throw new Error("--credits requires a payment provider (got --payment none).");t.credits=e.credits}if(e.docker!==void 0&&(t.dockerServices=Lt(e.docker,We,"docker service")),e.aiTools!==void 0&&(t.aiTools=Lt(e.aiTools,Xe,"AI tool")),e.socialProviders!==void 0&&(t.socialProviders=Lt(e.socialProviders,Qe,"social provider")),e.currency!==void 0){if(!oe.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${oe.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!se.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${se.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!ae.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${ae.join(", ")}`);t.databaseProvider=e.database}if(e.cache!==void 0){if(!ce.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${ce.join(", ")}`);t.cacheProvider=e.cache}if(e.demo===!0&&(t.demo=!0),e.baseUrl!==void 0){let r=e.baseUrl.trim();if(r==="")throw new Error("--base-url cannot be empty. Provide an absolute URL like https://example.com.");let i;try{i=new URL(r)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(i.protocol!=="http:"&&i.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${i.protocol}//${i.host}`}return t}var ee={projectName:"my-saas",frontend:"nextjs",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,billingScope:"user",blog:!0,docs:!1,revenueSharing:!1,credits:!0,dockerServices:["postgres","redis","inngest"],aiTools:[],socialProviders:[],defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"};function ln(e){let t=e.projectName??ee.projectName,r=e.projectDir??`./${t}`,i=e.appName??et(t),n=e.deploymentTarget??ee.deploymentTarget,o=F[n]?.edgeRuntime??!1,s=e.databaseProvider??(o?"neon":ee.databaseProvider),a=e.cacheProvider??(o?"upstash":ee.cacheProvider),d=e.emailProvider??(o?"resend":ee.emailProvider),h=e.dockerServices??(o?ee.dockerServices.filter(m=>m!=="postgres"&&m!=="redis"):ee.dockerServices),g={...ee,...e,projectName:t,appName:i,projectDir:r,deploymentTarget:n,databaseProvider:s,cacheProvider:a,emailProvider:d,dockerServices:h};g.paymentProvider==="none"&&(g.credits=!1);for(let m of Ce){if(g.deploymentTarget!==m.target)continue;let v=g.databaseProvider===m.provider?"database":"cache";if(g.databaseProvider===m.provider||g.cacheProvider===m.provider)throw new Error(`Incompatible: --deploy ${m.target} + --${v} ${m.provider}. ${m.reason}`)}for(let m of Ne)if(g.architecture===m.architecture&&g.deploymentTarget===m.target)throw new Error(`Incompatible: --architecture ${m.architecture} + --deploy ${m.target}. ${m.reason}`);return g}function Lt(e,t,r){if(e.trim()==="")return[];let i=e.split(",").map(o=>o.trim()).filter(Boolean),n=i.filter(o=>!t.includes(o));if(n.length>0)throw new Error(`Invalid ${r}(s): ${n.join(", ")}. Valid values: ${t.join(", ")}`);return i}import Oo from"picocolors";var Do="c81635e3715dc7274f33a745e24a394d93d3d081a4004408585c3de86e1aac35";function xo(e){if(e===void 0)return;let t=e.trim().replace(/^v/,"");if(!/^\d+\.\d+\.\d+$/.test(t))throw new Error(`Invalid template version "${e}". Use semver like 1.2.3.`);return t}function pn(e){e.command("init").description("Scaffold a new GenerateSaaS project").option("-n, --name <name>","project name (lowercase, hyphens, starts with letter)").option("--app-name <name>","display name for the app").option("-l, --location <path>","project directory (default: ./{name})").addOption(new j("--frontend <type>","frontend framework").choices([...Le])).addOption(new j("--architecture <type>","fullstack or separate").choices([...Ye])).addOption(new j("--payment <provider>","payment provider").choices([...Je])).addOption(new j("--email <provider>","email provider").choices([...qe])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").addOption(new j("--billing-scope <scope>","billing scope (requires --org)").choices([...Ze])).option("--blog","enable blog").option("--no-blog","disable blog").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--revenue-sharing","enable revenue sharing").option("--no-revenue-sharing","disable revenue sharing").option("--credits","enable credits system").option("--no-credits","disable credits system (subscription-only)").option("--docker <services>","comma-separated: postgres,redis,inngest,mailpit").option("--ai-tools <tools>","comma-separated: claude-code,cursor,codex,gemini-cli,windsurf").option("--social-providers <providers>","comma-separated: google,github,facebook,discord,x").addOption(new j("--currency <code>","default currency for billing").choices([...oe])).addOption(new j("--deploy <target>","deployment target").choices([...se])).addOption(new j("--database <provider>","database provider").choices([...ae])).addOption(new j("--cache <provider>","cache provider").choices([...ce])).option("--template-version <version>","specific template version to scaffold").option("--api-key <key>","API key (skips interactive prompt)").option("--base-url <url>","public base URL (e.g. https://example.com) - bakes into canonical/og/sitemap").option("-y, --yes","accept defaults for unspecified options (non-interactive)").addOption(new j("--demo","first-party demo build: keep sample content, mark site non-indexable - requires CI API key").hideHelp()).addOption(new j("--no-db-migration","skip generating the baseline DB migration (internal: demos/CI/playground)").hideHelp()).action(async t=>{await Co(t)})}async function Co(e){let t=performance.now();Ft("1.2.2");let r,i;try{r=cn(e),i=xo(e.templateVersion)}catch(S){E.cancel(I(S)),process.exit(1)}let n=E.spinner(),o;try{o=await ve({apiKey:e.apiKey,prompt:!e.yes})}catch(S){E.cancel(I(S)),process.exit(1)}e.demo&&Rt(o)!==Do&&(E.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let s=q(o),a=async()=>{let S=await Q(s),P=S.latest,_e=i??P;if(i&&!S.versions.some(he=>he.version===_e))throw new Error(`Template version "${i}" is not available.`);return{latestVersion:P,selectedVersion:_e}};n.start("Verifying access...");let d,h;try{({latestVersion:d,selectedVersion:h}=await a()),n.stop("Access verified."),pe(o)}catch(S){if(n.stop("Access verification failed."),S instanceof _&&S.status===401){e.yes&&(E.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),E.log.warning("Invalid API key."),o=await Ue(),s=q(o),n.start("Verifying access...");try{({latestVersion:d,selectedVersion:h}=await a()),n.stop("Access verified."),pe(o)}catch(P){n.stop("Access verification failed."),E.cancel(P instanceof _&&P.status===401?"Invalid API key.":I(P)),process.exit(1)}}else E.cancel(I(S)),process.exit(1)}E.log.success(`Latest version: ${d}`),h!==d&&E.log.success(`Using template version: ${h}`);let g;e.yes?g=ln(r):g=await Kt(r);let m;n.start("Activating license...");try{let S=crypto.randomUUID();m={token:(await Wt(s,{frontend:g.frontend,version:h,installId:S})).token,keyHash:Rt(o),installId:S},n.stop("License activated.")}catch(S){n.stop("License activation failed."),E.cancel(I(S)),process.exit(1)}let v=Ro(g.projectDir);if(Ao(v)&&ko(v).length>0)if(e.yes)E.log.info(`Directory ${v} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let P=await E.select({message:`Directory ${v} is not empty.`,options:[{value:"merge",label:"Merge",hint:"keep existing files, overwrite conflicts"},{value:"overwrite",label:"Overwrite",hint:"delete everything and start fresh"},{value:"cancel",label:"Cancel"}]});(E.isCancel(P)||P==="cancel")&&(E.cancel("Setup cancelled."),process.exit(0)),P==="overwrite"&&Po(v,{recursive:!0,force:!0})}let b={...g,projectDir:v,version:h,...e.demo?{docs:!1}:{}};n.start("Downloading template...");try{await ot(s,h,v),n.stop("Template downloaded.")}catch(S){n.stop("Download failed."),E.cancel(I(S)),process.exit(1)}let H;n.start("Generating project files...");try{if({dockerComposeGenerated:H}=await ut(b),!e.demo){let S=await je(v);await l(_o(v,nt),JSON.stringify(S,null," ")+`
|
|
1111
|
+
`),await Wr(v,v)}await Qr(v,b.aiTools),await Jr(b,m),n.stop("Project files generated.")}catch(S){n.stop("Generation failed."),E.cancel(I(S)),process.exit(1)}await tn(v);let R=await rn(v);R&&b.demo!==!0&&e.dbMigration!==!1&&await nn(v),await on(v),R&&await sn(v);let te=me("docker"),A=St(b).map(S=>S.key).filter(S=>!b.credentials?.[S]);an(b,{pnpmInstalled:R,dockerComposeGenerated:H,dockerAvailable:te,skippedCredentials:A}),Bt(),E.log.info(Oo.dim(`Done in ${((performance.now()-t)/1e3).toFixed(1)}s`))}import{existsSync as dn}from"fs";import{readFile as jo}from"fs/promises";import{join as Ve,resolve as Mo}from"path";import*as k from"@clack/prompts";import Pe from"picocolors";import{mkdtemp as No,rm as Lo}from"fs/promises";import{tmpdir as Uo}from"os";import{join as $o}from"path";async function Ut(e,t,r,i){let n=await No($o(Uo(),"generatesaas-stage-"));try{await ot(e,t,n),await ut({...r,projectDir:n}),await Ot(n,i)}finally{await Lo(n,{recursive:!0,force:!0})}}function un(e){e.command("update").description("Update AI skill files and stage template updates").option("--cwd <path>","project directory (default: current directory)").action(async t=>{let r=Mo(t.cwd??process.cwd()),i=Ve(r,W),n;try{n=JSON.parse(await jo(i,"utf-8"))}catch{k.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let o;try{o=await ve()}catch(d){k.cancel(I(d)),process.exit(1)}let s=q(o),a=k.spinner();try{a.start("Verifying access...");let d;try{d=await Q(s)}catch(A){throw A instanceof _&&A.status===401?new Error("Your saved API key was rejected. Run `generatesaas auth` to update it, or set GENERATESAAS_API_KEY."):A}a.stop("Access verified."),pe(o),a.start("Fetching latest skill files...");let h=await qt(s,d.latest);await Ct(r,h.skillMd,h.scripts,n.aiTools);let g=xt(n.aiTools);if(a.stop("Skills updated."),k.log.success(`Skill files installed to ${Pe.cyan(g.length.toString())} locations.`),n.version===d.latest){k.log.info(`Already on the latest version (${n.version}).`);return}if(n.licenseToken)try{let A=await Xt(s,{currentToken:n.licenseToken,newVersion:n.version});n.licenseToken=A.token,await l(i,JSON.stringify(n,null," ")+`
|
|
1112
|
+
`),k.log.success("License refreshed.")}catch{k.log.warn("License refresh skipped.")}let m=Yr(n,r),v=Ve(r,Ht);a.start(`Staging v${d.latest} (shaped for your config)...`),await Ut(s,d.latest,m,v),a.stop("Template staged.");let b=await Jt(s,d.latest);b&&k.note(b,`Changelog v${d.latest}`);let H=Ve(r,nt),R=Ve(r,it),te=!dn(R),re=!dn(H);if(te){if(a.start("Building baseline template (one-time migration)..."),await Ut(s,n.version,m,R),re){let A=await je(R);await l(H,JSON.stringify(A,null," ")+`
|
|
1113
|
+
`)}a.stop("Baseline template stored.")}else if(re){a.start("Computing baseline template hashes...");let A=await je(R);await l(H,JSON.stringify(A,null," ")+`
|
|
1114
1114
|
`),a.stop("Baseline hashes computed.")}if(await l(Ve(r,Yt),JSON.stringify({currentVersion:n.version,targetVersion:d.latest,changelog:b,stagedAt:new Date().toISOString()},null," ")+`
|
|
1115
|
-
`),k.log.info(`Update staged: ${
|
|
1116
|
-
`);
|
|
1117
|
-
`),
|
|
1118
|
-
`).map(s=>s.trim()).filter(s=>s&&!s.startsWith("#"));n.length===0&&(
|
|
1115
|
+
`),k.log.info(`Update staged: ${Pe.cyan(n.version)} \u2192 ${Pe.cyan(d.latest)}`),n.aiTools&&n.aiTools.length>0){let A=n.aiTools[0],S=xe[A].label;k.log.info(`Open your project in ${Pe.cyan(S)} and ask: ${Pe.cyan("'update my GenerateSaaS project'")}`)}else k.log.info(`Ask your AI coding assistant to ${Pe.cyan("'update my GenerateSaaS project'")}.`)}catch(d){a.stop("Failed."),k.cancel(`Update failed: ${I(d)}`),process.exit(1)}})}import*as C from"@clack/prompts";import M from"picocolors";import{readFile as Vo}from"fs/promises";import{join as Fo,resolve as Bo}from"path";function mn(e){e.command("status").description("Show project status and check for updates").option("--cwd <path>","project directory (default: current directory)").action(async t=>{let r=Bo(t.cwd??process.cwd()),i=Fo(r,W),n;try{n=JSON.parse(await Vo(i,"utf-8"))}catch{C.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let o=[`Version: ${M.cyan(n.version)}`,`Frontend: ${M.cyan(n.frontend)}`,n.deploymentTarget?`Deploy target: ${M.cyan(n.deploymentTarget)}`:null,n.databaseProvider?`Database: ${M.cyan(n.databaseProvider)}`:null,n.cacheProvider?`Cache: ${M.cyan(n.cacheProvider)}`:null,n.aiTools&&n.aiTools.length>0?`AI tools: ${M.cyan(n.aiTools.join(", "))}`:null].filter(Boolean).join(`
|
|
1116
|
+
`);C.note(o,M.bold("Project Status"));let s=C.spinner();s.start("Checking for updates...");try{let a=await ve(),d=q(a),g=(await Q(d)).latest;n.version===g?(s.stop("Up to date."),C.log.success(`Already on the latest version (${M.green(g)})`)):(s.stop("Update available."),C.log.warning(`Update available: ${M.yellow(n.version)} \u2192 ${M.green(g)}`),C.log.info(`Run ${M.cyan("generatesaas update")} to update skill files, then ask your AI assistant to apply the update.`))}catch(a){s.stop("Check failed."),a instanceof _&&a.status===401?C.log.warning("Invalid API key. Run `generatesaas auth` to update it, or set GENERATESAAS_API_KEY."):C.log.warning(`Could not check for updates: ${I(a)}`)}})}import{readFile as Go}from"fs/promises";import*as N from"@clack/prompts";import z from"picocolors";function Ko(e){let t=e.split(".");if(t.length!==3||!t[1])throw new Error("Invalid JWT format");let r=Buffer.from(t[1],"base64url").toString("utf-8");return JSON.parse(r)}function $t(e){return typeof e!="number"?"unknown":new Date(e*1e3).toISOString().split("T")[0]}function fn(e){N.note([`License ID: ${z.cyan(String(e.lid??"unknown"))}`,`Version: ${z.cyan(String(e.ver??"unknown"))}`,`Init version: ${String(e.iver??"unknown")}`,`Frontend: ${String(e.fe??"unknown")}`,`Created: ${$t(e.pat)}`,`Last updated: ${$t(e.uat)}`,`Expires: ${$t(e.exp)}`,`Install ID: ${String(e.nid??"unknown")}`].join(`
|
|
1117
|
+
`),z.yellow("License Details"))}async function gn(e){let t=N.spinner(),r=e.replace(/\/+$/,"");t.start(`Checking ${r}/license...`);let i;try{let o=await fetch(`${r}/license`);if(!o.ok)return t.stop(`${z.red("Not found")} - ${r}/license returned ${o.status}`),!1;if(i=await o.text(),!i||i.split(".").length!==3)return t.stop(`${z.red("Invalid")} - response is not a JWT`),!1;t.stop(`${z.green("Found")} - license endpoint responded`)}catch(o){return t.stop(`${z.red("Failed")} - ${I(o)}`),!1}let n;try{n=Ko(i)}catch{return N.log.error("Could not decode JWT payload."),!1}t.start("Verifying signature...");try{let o=process.env.GENERATESAAS_API_URL??rt,s=await Zt(o,i);if(s.valid)t.stop(`${z.green("Valid")} - signature verified`);else return t.stop(`${z.red("Invalid")} - ${s.reason}`),!1}catch{return t.stop(`${z.yellow("Skipped")} - could not reach verification service`),N.log.warn("Signature not verified. Displaying unverified claims:"),fn(n),!1}return fn(n),!0}function hn(e){e.command("verify").description("Verify a GenerateSaaS license on a deployed site").argument("[url]","URL of the site to verify (e.g. https://example.com/api)").option("--file <path>","file with URLs to check, one per line").action(async(t,r)=>{if(!t&&!r.file&&(N.cancel("Provide a URL or --file <path>."),process.exit(1)),r.file){let n=(await Go(r.file,"utf-8")).split(`
|
|
1118
|
+
`).map(s=>s.trim()).filter(s=>s&&!s.startsWith("#"));n.length===0&&(N.cancel("No URLs found in file."),process.exit(1));let o=0;for(let s of n)await gn(s)&&o++,N.log.info("");N.log.success(`${o}/${n.length} sites verified.`)}else await gn(t)||process.exit(1)})}import{existsSync as zo,rmSync as Ho}from"fs";import*as V from"@clack/prompts";function yn(e){e.command("auth").description("Set or update your GenerateSaaS API key").option("--clear","remove saved API key").action(async t=>{if(t.clear){zo(J)?(Ho(J),V.log.success("API key removed.")):V.log.info("No API key configured.");return}let r=Et();r?V.log.info(`Current API key: ****${r.slice(-4)}`):V.log.info("No API key configured.");let i=await Ue(),n=q(i),o=V.spinner();o.start("Verifying API key...");try{await Q(n),o.stop("API key verified."),pe(i),V.log.success("API key saved.")}catch(s){o.stop("Verification failed."),s instanceof _&&s.status===401?V.cancel("Invalid API key."):V.cancel(I(s)),process.exit(1)}})}import{existsSync as ft,rmSync as Yo,readFileSync as Mt,writeFileSync as vn}from"fs";import{join as fe}from"path";import*as L from"@clack/prompts";var Jo=["packages/api/src/functions/maintenance/license-heartbeat.ts","packages/api/src/lib/manifest.ts","packages/api/src/routes/internal/license.ts"],qo=[{file:"packages/api/src/routes/inngest.ts",removals:[`import { licenseHeartbeatFunction } from "../functions/maintenance/license-heartbeat";
|
|
1119
1119
|
`,` licenseHeartbeatFunction,
|
|
1120
1120
|
`]},{file:"packages/api/src/routes/internal/index.ts",removals:[`import licenseRoutes from "./license";
|
|
1121
1121
|
`,` .route("/license", licenseRoutes)
|
|
1122
|
-
`]}];function Wo(e){return(e&&e.length>0?e.map(r=>Me[r]):Object.values(Me)).map(r=>
|
|
1122
|
+
`]}];function Wo(e){return(e&&e.length>0?e.map(r=>Me[r]):Object.values(Me)).map(r=>fe(r,Dt))}function jt(e){return ft(e)?(Yo(e,{recursive:!0}),!0):!1}function Xo(e,t){if(!ft(e))return!1;let r=Mt(e,"utf-8"),i=r;for(let n of t)i=i.replace(n,"");return i===r?!1:(vn(e,i,"utf-8"),!0)}function Zo(e){let t=fe(e,".gitignore");if(!ft(t))return!1;let r=Mt(t,"utf-8"),i=r.split(`
|
|
1123
1123
|
`).filter(n=>!n.includes(".generatesaas")).join(`
|
|
1124
|
-
`);return i===r?!1:(vn(t,i,"utf-8"),!0)}function Sn(e){e.command("eject").description("Remove all GenerateSaaS ties
|
|
1124
|
+
`);return i===r?!1:(vn(t,i,"utf-8"),!0)}function Sn(e){e.command("eject").description("Remove all GenerateSaaS ties - manifest, license, heartbeat, skills").action(async()=>{let t=process.cwd(),r=fe(t,W),i;try{i=JSON.parse(Mt(r,"utf-8"))}catch{L.cancel("No GenerateSaaS project found in this directory."),process.exit(1)}let n=await L.text({message:'Type "eject" to confirm (this cannot be undone):',validate:a=>{if(a!=="eject")return'Type "eject" to confirm, or press Ctrl+C to cancel.'}});L.isCancel(n)&&(L.cancel("Eject cancelled."),process.exit(0));let o=[],s=[];for(let a of Wo(i.aiTools))jt(fe(t,a))&&o.push(a);for(let a of Jo)jt(fe(t,a))&&o.push(a);jt(fe(t,U))&&o.push(U+"/");for(let a of qo){let d=fe(t,a.file);Xo(d,a.removals)?s.push(a.file):ft(d)&&L.log.warn(`Could not auto-modify ${a.file} - manually remove license/heartbeat references.`)}Zo(t)&&s.push(".gitignore");for(let a of o)L.log.info(`Deleted ${a}`);for(let a of s)L.log.info(`Modified ${a}`);L.log.success("Ejected successfully. This project is now fully standalone.")})}var ge=new Qo().name("generatesaas").description("CLI for scaffolding and managing GenerateSaaS projects").version("1.2.2").addHelpText("after",`
|
|
1125
1125
|
Examples:
|
|
1126
1126
|
$ generatesaas init Interactive setup
|
|
1127
1127
|
$ generatesaas init -n my-app -y Quick setup with defaults
|
|
1128
1128
|
$ generatesaas status Check for updates
|
|
1129
1129
|
$ generatesaas auth Set or update API key
|
|
1130
|
-
`);pn(
|
|
1130
|
+
`);pn(ge);un(ge);mn(ge);hn(ge);yn(ge);Sn(ge);ge.parseAsync().catch(e=>{En.cancel("An unexpected error occurred."),console.error(e),process.exit(1)});
|