generatesaas 3.31.0 → 3.32.0
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 +184 -179
- package/dist/skill/content/generatesaas-update/SKILL.md +1 -1
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{Command as $p}from"commander";import*as Ps from"@clack/prompts";import{existsSync as ql,readdirSync as Jl,rmSync as Xl}from"fs";import{join as Zl,resolve as Ql}from"path";import{Option as ee}from"commander";import*as S from"@clack/prompts";import*as At from"@clack/prompts";import er from"picocolors";function Kr(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";At.intro(er.bgYellow(er.black(t)))}function Gr(){At.outro(er.yellow("Happy building!"))}import*as f from"@clack/prompts";import y from"picocolors";var mt={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)"}},It={stripe:{label:"Stripe"},polar:{label:"Polar"},none:{label:"None",hint:"disable payments"}},Tt={smtp:{label:"SMTP",hint:"Mailpit for local dev"},ses:{label:"Amazon SES"},resend:{label:"Resend"}},Rt={sentry:{label:"Sentry",hint:"web, server and desktop - release health, tracing, alerting"},posthog:{label:"PostHog",hint:"web and server, plus LLM analytics - no Electron SDK, so a desktop build reports nothing"}},Hr={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}};var De={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 re={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}},Ne={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"}]}},Ce={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"}]}},Ze=[{target:"vercel",provider:"redis",reason:"Vercel serverless cannot maintain persistent Redis connections. Consider Upstash."},{target:"vercel",provider:"postgres",reason:"Vercel serverless cannot pool connections to a self-hosted Postgres. Use Neon or Supabase - both are managed, connection-pooled Postgres."}],Qe=[{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)."}],ce={serverless:{label:"Serverless",hint:"Vercel + Neon + Upstash",values:{deploymentTarget:"vercel",databaseProvider:"neon",cacheProvider:"upstash"}},selfhost:{label:"Self-host",hint:"Docker or Node + Postgres + Redis",values:{deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"}}},Le=Object.keys(ce);function tr(e){let t=[];for(let r of Ze)if(e.deploymentTarget===r.target&&(e.databaseProvider===r.provider||e.cacheProvider===r.provider)){let n=e.databaseProvider===r.provider?"databaseProvider":"cacheProvider";t.push(`\`${n}: "${r.provider}"\` with \`deploymentTarget: "${r.target}"\` - ${r.reason}`)}for(let r of Qe)e.deploymentTarget===r.target&&e.architecture===r.architecture&&t.push(`\`architecture: "${r.architecture}"\` with \`deploymentTarget: "${r.target}"\` - ${r.reason}`);return t}var Yr=["Local file storage (sharp, geoip-lite)","SMTP email (use Resend or SES instead)","Content API git integration"];function et(e){let t=[];return e.databaseProvider==="postgres"&&t.push("postgres"),e.cacheProvider==="redis"&&t.push("redis"),e.emailProvider==="smtp"&&t.push("mailpit"),t.push("inngest"),t}var tt=["fullstack","separate"],rt=["stripe","polar","none"],nt=["smtp","ses","resend"];var Wr=["claude-code","cursor","codex","gemini-cli","windsurf"],le=["USD","EUR","GBP","CAD","AUD","BRL","JPY"],pe=["node","vercel"],de=["postgres","neon","supabase"],ue=["redis","upstash"],K=["sentry","posthog"],$e=["revenuecat","none"];function ne(e){return e.paymentProvider!==void 0&&e.paymentProvider!=="none"}var rr=[{key:"architecture",label:"Architecture",hint:"Fullstack (frontend hosts the API) or a standalone Hono backend.",category:"Infrastructure",kind:"enum",default:"fullstack",choices:tt,adoptable:!1,impact:"structural",shapesTree:!0},{key:"deploymentTarget",label:"Deployment target",hint:"Node.js / Docker or Vercel serverless.",category:"Infrastructure",kind:"enum",default:"node",choices:pe,adoptable:!1,impact:"config",shapesTree:!0},{key:"databaseProvider",label:"Database provider",hint:"Self-hosted PostgreSQL, Neon, or Supabase.",category:"Infrastructure",kind:"enum",default:"postgres",choices:de,adoptable:!1,impact:"config",shapesTree:!0},{key:"cacheProvider",label:"Cache provider",hint:"Self-hosted Redis or Upstash.",category:"Infrastructure",kind:"enum",default:"redis",choices:ue,adoptable:!1,impact:"config",shapesTree:!0},{key:"paymentProvider",label:"Payment provider",hint:"Stripe, Polar, or none.",category:"Features",kind:"enum",default:"none",choices:rt,adoptable:!1,impact:"structural",shapesTree:!0},{key:"defaultCurrency",label:"Default currency",hint:"Billing and pricing currency.",category:"Features",kind:"enum",default:"USD",choices:le,adoptable:!1,impact:"config",shapesTree:!1},{key:"emailProvider",label:"Email provider",hint:"SMTP, Amazon SES, or Resend.",category:"Features",kind:"enum",default:"smtp",choices:nt,adoptable:!1,impact:"config",shapesTree:!1},{key:"observability",label:"Observability",hint:"Which services receive your app's errors, and on PostHog its LLM analytics. Pick any combination - anything you do not pick costs nothing, since its SDK and its adapter are never generated.",category:"Features",kind:"multiselect",default:[],choices:K,adoptable:!0,impact:"config",shapesTree:!0},{key:"multiTenancy",label:"Multi-tenancy (organizations)",hint:"Adds organizations - teams, members, and shared resources.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!1},{key:"projects",label:"Projects",hint:"Adds projects - a switcher that scopes a user's work inside their account or organization.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"config",shapesTree:!1},{key:"docs",label:"Docs app",hint:"Adds the self-hosted Fumadocs documentation site (apps/docs).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"desktop",label:"Desktop app",hint:"Adds the cross-platform desktop app (apps/desktop, built with Electron).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"mobile",label:"Mobile app",hint:"Adds the cross-platform mobile app (apps/mobile, built with Expo).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"mobilePurchases",label:"Mobile store purchases",hint:"In-app purchases in the mobile app, through RevenueCat. Store purchases sit ON TOP of your web payment provider - a subscriber who buys in the app is the same account, billed by Apple or Google instead of by you. Off keeps the app on web billing, where the plan card says the subscription is managed on your website.",category:"Features",kind:"enum",default:()=>"none",choices:$e,adoptable:!0,impact:"structural",shapesTree:!0,requires:e=>e.mobile===!0&&ne(e),requiresLabel:"requires the mobile app and a web payment provider - store purchases are additive to the web lane, never a replacement"},{key:"ai",label:"AI features",hint:"Adds the AI surface (chat, models, automations, integrations). A desktop project ALWAYS ships the app's local AI stack: this option sets config.desktop.agents.enabled (the runtime gate on those screens). Off keeps config.ai.enabled false so the AI nav stays hidden - the AI packages still ship, because packages/translate depends on @repo/ai for the i18n pipeline every project uses; off drops only the MCP widgets (packages/mcp-widgets).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"webAi",label:"AI in the web app",hint:"Whether the WEB app shows the AI surfaces - chat, automations, model and integration settings, and their nav entries. Off is the app-first shape: your desktop or mobile app is where your AI product lives and the website keeps account, billing and licensing only. The AI SERVICE is untouched either way (config.ai.enabled, the /api/ai routes and the desktop agents all stay exactly as your AI option set them), so both apps keep talking to the same backend. Only meaningful with AI features and at least one app - the desktop app or the mobile app.",category:"Features",kind:"boolean",default:!0,adoptable:!0,impact:"config",shapesTree:!1,requires:e=>e.ai===!0&&(e.desktop===!0||e.mobile===!0),requiresLabel:"requires AI features and an app to host them (the desktop app or the mobile app)"},{key:"credits",label:"Metered credits",hint:"Adds metered usage credits on top of subscription plans.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"config",shapesTree:!1,requires:e=>ne(e),requiresLabel:"requires a payment provider"},{key:"revenueSharing",label:"Revenue sharing",hint:"Opt-in MRR leaderboard with dofollow backlinks.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"config",shapesTree:!1}];function Is(e,t){return e[t]!==void 0}function zr(e){return rr.filter(t=>t.adoptable&&!Is(e,t.key)&&(t.requires?t.requires(e):!0)).map(t=>({key:t.key,label:t.label,hint:t.hint,kind:t.kind,default:typeof t.default=="function"?t.default(e):t.default,...t.choices?{choices:t.choices}:{},impact:t.impact,...t.requiresLabel?{requiresLabel:t.requiresLabel}:{}}))}function Ts(e,t){switch(e.kind){case"boolean":return typeof t=="boolean";case"enum":return typeof t=="string"&&(e.choices??[]).includes(t);case"multiselect":return Array.isArray(t)&&t.every(r=>typeof r=="string"&&(e.choices??[]).includes(r))}}function Rs(e){let t=(e.choices??[]).map(r=>JSON.stringify(r)).join(", ");switch(e.kind){case"boolean":return"true or false";case"enum":return`one of ${t}`;case"multiselect":return`an array of ${t}`}}function qr(e){let t=[];for(let r of rr){let n=e[r.key];n!==void 0&&(Ts(r,n)||t.push(`\`${r.key}\` is ${JSON.stringify(n)}, but it must be ${Rs(r)}.`))}return t}function Jr(e){let t={};for(let r of rr)if(typeof r.default=="function"){if(r.requires&&!r.requires(e))continue;t[r.key]=r.default(e)}else t[r.key]=Array.isArray(r.default)?[...r.default]:r.default;return{...t,...e}}function nr(e,t){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||t}function _t(e){return e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function Ot(e){return/^[a-z][a-z0-9-]*$/.test(e)}function N(e){return e instanceof Error?e.message:String(e)}function ht(e){if(e.mobilePurchases!=="revenuecat")return e;if(e.mobile===!1)throw new Error("--mobile-purchases revenuecat requires the mobile app; remove --no-mobile.");if(e.paymentProvider==="none")throw new Error("--mobile-purchases revenuecat requires a payment provider (got --payment none): store purchases are additive to your web billing, never a replacement.");return e.mobile===void 0&&(e.mobile=!0),e}function ft(e){if(e.webAi!==!1)return e;if(e.ai===!1)throw new Error("--no-web-ai requires --ai (the desktop and mobile apps are where AI lives when the web surface is off).");if(e.desktop===!1&&e.mobile===!1)throw new Error("--no-web-ai requires --desktop or --mobile - with the web AI surface off, the desktop and mobile apps are the only places your AI features exist.");return e}function Xr(e){if(e.webAi!==!1)return[];let t=[];return e.desktop!==!0&&e.mobile!==!0&&t.push("neither `desktop` nor `mobile` is true, so this project has no desktop or mobile app - and with the web AI surface off, those apps are the only places its AI features would exist."),t}function Zr(e){if(e.mobilePurchases!=="revenuecat")return[];let t=[];return e.mobile!==!0&&t.push("`mobile` is not true, so this project has no app to sell in - the store lane's paywall, purchase and restore surfaces all live in `apps/mobile`."),ne(e)||t.push('`paymentProvider` is absent or `"none"`, and store purchases are additive to your web billing - there is nothing here for them to sit on top of.'),t}function Qr(e){let t=_s(e,e.desktopAi);return delete e.desktopAi,t}function _s(e,t){return e.desktop!==!0?{kind:"none"}:t===!0&&e.ai!==!0?{kind:"legacy-desktop-ai"}:t===!1&&e.ai===!0?{kind:"desktop-gains-ai"}:{kind:"none"}}function en(e){let t={};if(e.name!==void 0){if(!Ot(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.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.projects!==void 0&&(t.projects=e.projects),e.docs!==void 0&&(t.docs=e.docs),e.desktop!==void 0&&(t.desktop=e.desktop),e.mobile!==void 0&&(t.mobile=e.mobile),e.mobilePurchases!==void 0){if(!$e.includes(e.mobilePurchases))throw new Error(`Invalid mobile purchases "${e.mobilePurchases}". Valid values: ${$e.join(", ")}`);t.mobilePurchases=e.mobilePurchases}if(e.ai!==void 0&&(t.ai=e.ai),e.webAi!==void 0&&(t.webAi=e.webAi),ht(t),ft(t),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.currency!==void 0){if(!le.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${le.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!pe.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${pe.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!de.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${de.join(", ")}`);t.databaseProvider=e.database}if(e.cache!==void 0){if(!ue.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${ue.join(", ")}`);t.cacheProvider=e.cache}if(e.observability!==void 0){let r=e.observability.split(",").map(i=>i.trim()).filter(Boolean),n=r.filter(i=>!K.includes(i));if(n.length>0)throw new Error(`Invalid observability provider ${JSON.stringify(n.join(", "))}. Valid values: ${K.join(", ")}`);t.observability=r}if(e.preset!==void 0){if(!Le.includes(e.preset))throw new Error(`Invalid preset "${e.preset}". Valid values: ${Le.join(", ")}`);let r=ce[e.preset].values;t.deploymentTarget??=r.deploymentTarget,t.databaseProvider??=r.databaseProvider,t.cacheProvider??=r.cacheProvider}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 n;try{n=new URL(r)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${n.protocol}//${n.host}`}return t}var it={projectName:"my-saas",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,projects:!1,docs:!1,desktop:!1,mobile:!1,mobilePurchases:"none",ai:!1,webAi:!0,revenueSharing:!1,credits:!0,defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis",observability:[]};function tn(e){let t=e.projectName??it.projectName,r=e.projectDir??`./${t}`,n=e.appName??_t(t),i=e.deploymentTarget??it.deploymentTarget,o=re[i]?.edgeRuntime??!1,s=e.databaseProvider??(o?"neon":it.databaseProvider),a=e.cacheProvider??(o?"upstash":it.cacheProvider),d=e.emailProvider??(o?"resend":it.emailProvider),h={...it,...e,projectName:t,appName:n,projectDir:r,deploymentTarget:i,databaseProvider:s,cacheProvider:a,emailProvider:d};h.paymentProvider==="none"&&(h.credits=!1),(!h.mobile||h.paymentProvider==="none")&&(h.mobilePurchases="none"),ht(h);for(let g of Ze){if(h.deploymentTarget!==g.target)continue;let E=h.databaseProvider===g.provider?"database":"cache";if(h.databaseProvider===g.provider||h.cacheProvider===g.provider)throw new Error(`Incompatible: --deploy ${g.target} + --${E} ${g.provider}. ${g.reason}`)}for(let g of Qe)if(h.architecture===g.architecture&&h.deploymentTarget===g.target)throw new Error(`Incompatible: --architecture ${g.architecture} + --deploy ${g.target}. ${g.reason}`);return ft(h),h}function T(e){f.isCancel(e)&&(f.cancel("Setup cancelled."),process.exit(0))}function ir(e){let t=[];return 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})),e.demo&&t.push({key:"TURNSTILE_SECRET_KEY",message:"Cloudflare Turnstile secret key (optional):",secret:!0}),t}async function rn(e,t){let r=!1;e&&ht(e),e&&ft(e),f.log.info(y.bold("Project"));let n=e?.projectName??await(async()=>{r=!0;let c=await f.text({message:"Project name:",placeholder:"my-saas",validate:u=>{if(!u?.trim())return"Project name is required.";if(!Ot(u))return"Use lowercase letters, numbers, and hyphens only. Must start with a letter."}});return T(c),c})(),i=e?.appName??await(async()=>{r=!0;let c=await f.text({message:"App name:",initialValue:_t(n),validate:u=>{if(!u?.trim())return"App name is required."}});return T(c),c})(),o=e?.projectDir??await(async()=>{r=!0;let c=await f.text({message:"Project location:",initialValue:`./${n}`});return T(c),c==="."?process.cwd():c})();f.log.info(y.bold("Infrastructure"));let s={};if(e?.deploymentTarget===void 0&&e?.databaseProvider===void 0&&e?.cacheProvider===void 0){r=!0;let c=await f.select({message:"Infrastructure:",options:[...Le.map(u=>({value:u,label:ce[u].label,hint:ce[u].hint})),{value:"custom",label:"Customize",hint:"choose each piece yourself"}]});if(T(c),c!=="custom"){let u=ce[c].values;s.deploymentTarget=u.deploymentTarget,s.databaseProvider=u.databaseProvider,s.cacheProvider=u.cacheProvider,f.log.info(`${ce[c].label}: ${ce[c].hint}.`)}}let a=e?.deploymentTarget??s.deploymentTarget??"node";if(e?.deploymentTarget===void 0&&s.deploymentTarget===void 0){r=!0;let c=await f.select({message:"Deployment target:",options:pe.map(u=>({value:u,label:re[u].label,hint:re[u].hint}))});T(c),a=c}let d=e?.architecture?Qe.find(c=>c.architecture===e.architecture&&c.target===a):void 0;if(d)throw new Error(`Incompatible: --architecture ${d.architecture} + --deploy ${d.target}. ${d.reason}`);let h=new Set(Qe.filter(c=>c.target===a).map(c=>c.architecture)),g=tt.filter(c=>!h.has(c)),E=e?.architecture??await(async()=>{if(g.length===1){let u=g[0];return f.log.info(`Auto-selected ${mt[u].label} architecture (only compatible option for ${re[a].label}).`),u}r=!0;let c=await f.select({message:"Architecture:",options:g.map(u=>({value:u,label:mt[u].label,hint:mt[u].hint}))});return T(c),c})(),w=e?.databaseProvider??s.databaseProvider??await(async()=>{r=!0;let c=de.filter(R=>!Ze.some(Ee=>Ee.target===a&&Ee.provider===R));if(c.length===1){let R=c[0];return f.log.info(`Auto-selected ${Ne[R].label} (only compatible option for ${re[a].label}).`),R}let u=await f.select({message:"Database provider:",options:c.map(R=>({value:R,label:Ne[R].label,hint:Ne[R].hint}))});return T(u),u})(),P=e?.cacheProvider??s.cacheProvider??await(async()=>{r=!0;let c=ue.filter(R=>!Ze.some(Ee=>Ee.target===a&&Ee.provider===R));if(c.length===1){let R=c[0];return f.log.info(`Auto-selected ${Ce[R].label} (only compatible option for ${re[a].label}).`),R}let u=await f.select({message:"Cache provider:",options:c.map(R=>({value:R,label:Ce[R].label,hint:Ce[R].hint}))});return T(u),u})();if(re[a]?.edgeRuntime){let c=Yr.map(u=>` - ${u}`).join(`
|
|
3
|
-
`);f.note(c,"Unavailable on edge runtime")}f.log.info(y.bold("Features"));let
|
|
4
|
-
`),
|
|
5
|
-
`),R=[
|
|
6
|
-
`),Ee=[y.bold("Project"),c,"",y.bold("Infrastructure"),
|
|
7
|
-
`);Ee.push("",y.bold("Credentials"),
|
|
8
|
-
`),"Summary");let
|
|
9
|
-
`,{mode:384})}async function
|
|
10
|
-
`,scripts:{},references:{}}}}:await(await Se(e,`/skills/${encodeURIComponent(t)}`)).json()}function
|
|
11
|
-
`)}var
|
|
12
|
-
`))}}var
|
|
13
|
-
`)}function
|
|
14
|
-
- **Payments:** ${
|
|
2
|
+
import{Command as Yp}from"commander";import*as xs from"@clack/prompts";import{existsSync as sp,readdirSync as op,rmSync as ap}from"fs";import{join as cp,resolve as lp}from"path";import{Option as Q}from"commander";import*as E from"@clack/prompts";import*as Rt from"@clack/prompts";import ir from"picocolors";function qr(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";Rt.intro(ir.bgYellow(ir.black(t)))}function Jr(){Rt.outro(ir.yellow("Happy building!"))}import*as f from"@clack/prompts";import y from"picocolors";var gt={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)"}},_t={stripe:{label:"Stripe"},polar:{label:"Polar"},none:{label:"None",hint:"disable payments"}},Ot={smtp:{label:"SMTP",hint:"Mailpit for local dev"},ses:{label:"Amazon SES"},resend:{label:"Resend"}},xt={sentry:{label:"Sentry",hint:"web, server and desktop - release health, tracing, alerting"},posthog:{label:"PostHog",hint:"web and server, plus LLM analytics - no Electron SDK, so a desktop build reports nothing"}},Xr={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}};var Ne={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 te={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}},Ce={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"}]}},Le={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"}]}},et=[{target:"vercel",provider:"redis",reason:"Vercel serverless cannot maintain persistent Redis connections. Consider Upstash."},{target:"vercel",provider:"postgres",reason:"Vercel serverless cannot pool connections to a self-hosted Postgres. Use Neon or Supabase - both are managed, connection-pooled Postgres."}],tt=[{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)."}],ae={serverless:{label:"Serverless",hint:"Vercel + Neon + Upstash",values:{deploymentTarget:"vercel",databaseProvider:"neon",cacheProvider:"upstash"}},selfhost:{label:"Self-host",hint:"Docker or Node + Postgres + Redis",values:{deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"}}},$e=Object.keys(ae);function sr(e){let t=[];for(let r of et)if(e.deploymentTarget===r.target&&(e.databaseProvider===r.provider||e.cacheProvider===r.provider)){let n=e.databaseProvider===r.provider?"databaseProvider":"cacheProvider";t.push(`\`${n}: "${r.provider}"\` with \`deploymentTarget: "${r.target}"\` - ${r.reason}`)}for(let r of tt)e.deploymentTarget===r.target&&e.architecture===r.architecture&&t.push(`\`architecture: "${r.architecture}"\` with \`deploymentTarget: "${r.target}"\` - ${r.reason}`);return t}var Zr=["Local file storage (sharp, geoip-lite)","SMTP email (use Resend or SES instead)","Content API git integration"];function rt(e){let t=[];return e.databaseProvider==="postgres"&&t.push("postgres"),e.cacheProvider==="redis"&&t.push("redis"),e.emailProvider==="smtp"&&t.push("mailpit"),t.push("inngest"),t}var nt=["fullstack","separate"],it=["stripe","polar","none"],st=["smtp","ses","resend"];var Qr=["claude-code","cursor","codex","gemini-cli","windsurf"],ce=["USD","EUR","GBP","CAD","AUD","BRL","JPY"],le=["node","vercel"],pe=["postgres","neon","supabase"],de=["redis","upstash"],K=["sentry","posthog"],je=["revenuecat","none"];function re(e){return e.paymentProvider!==void 0&&e.paymentProvider!=="none"}var or=[{key:"architecture",label:"Architecture",hint:"Fullstack (frontend hosts the API) or a standalone Hono backend.",category:"Infrastructure",kind:"enum",default:"fullstack",choices:nt,adoptable:!1,impact:"structural",shapesTree:!0},{key:"deploymentTarget",label:"Deployment target",hint:"Node.js / Docker or Vercel serverless.",category:"Infrastructure",kind:"enum",default:"node",choices:le,adoptable:!1,impact:"config",shapesTree:!0},{key:"databaseProvider",label:"Database provider",hint:"Self-hosted PostgreSQL, Neon, or Supabase.",category:"Infrastructure",kind:"enum",default:"postgres",choices:pe,adoptable:!1,impact:"config",shapesTree:!0},{key:"cacheProvider",label:"Cache provider",hint:"Self-hosted Redis or Upstash.",category:"Infrastructure",kind:"enum",default:"redis",choices:de,adoptable:!1,impact:"config",shapesTree:!0},{key:"paymentProvider",label:"Payment provider",hint:"Stripe, Polar, or none.",category:"Features",kind:"enum",default:"none",choices:it,adoptable:!1,impact:"structural",shapesTree:!0},{key:"defaultCurrency",label:"Default currency",hint:"Billing and pricing currency.",category:"Features",kind:"enum",default:"USD",choices:ce,adoptable:!1,impact:"config",shapesTree:!1},{key:"emailProvider",label:"Email provider",hint:"SMTP, Amazon SES, or Resend.",category:"Features",kind:"enum",default:"smtp",choices:st,adoptable:!1,impact:"config",shapesTree:!1},{key:"observability",label:"Observability",hint:"Which services receive your app's errors, and on PostHog its LLM analytics. Pick any combination - anything you do not pick costs nothing, since its SDK and its adapter are never generated.",category:"Features",kind:"multiselect",default:[],choices:K,adoptable:!0,impact:"config",shapesTree:!0},{key:"multiTenancy",label:"Multi-tenancy (organizations)",hint:"Adds organizations - teams, members, and shared resources.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!1},{key:"projects",label:"Projects",hint:"Adds projects - a switcher that scopes a user's work inside their account or organization.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"config",shapesTree:!1},{key:"docs",label:"Docs app",hint:"Adds the self-hosted Fumadocs documentation site (apps/docs).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"desktop",label:"Desktop app",hint:"Adds the cross-platform desktop app (apps/desktop, built with Electron).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"mobile",label:"Mobile app",hint:"Adds the cross-platform mobile app (apps/mobile, built with Expo).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"mobilePurchases",label:"Mobile store purchases",hint:"In-app purchases in the mobile app, through RevenueCat. Store purchases sit ON TOP of your web payment provider - a subscriber who buys in the app is the same account, billed by Apple or Google instead of by you. Off keeps the app on web billing, where the plan card says the subscription is managed on your website.",category:"Features",kind:"enum",default:()=>"none",choices:je,adoptable:!0,impact:"structural",shapesTree:!0,requires:e=>e.mobile===!0&&re(e),requiresLabel:"requires the mobile app and a web payment provider - store purchases are additive to the web lane, never a replacement"},{key:"ai",label:"AI features",hint:"Adds the AI surface (chat, models, automations, integrations). A desktop project ALWAYS ships the app's local AI stack: this option sets config.desktop.agents.enabled (the runtime gate on those screens). Off keeps config.ai.enabled false so the AI nav stays hidden - the AI packages still ship, because packages/translate depends on @repo/ai for the i18n pipeline every project uses; off drops only the MCP widgets (packages/mcp-widgets).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",shapesTree:!0},{key:"webAi",label:"AI in the web app",hint:"Whether the WEB app shows the AI surfaces - chat, automations, model and integration settings, and their nav entries. Off is the app-first shape: your desktop or mobile app is where your AI product lives and the website keeps account, billing and licensing only. The AI SERVICE is untouched either way (config.ai.enabled, the /api/ai routes and the desktop agents all stay exactly as your AI option set them), so both apps keep talking to the same backend. Only meaningful with AI features and at least one app - the desktop app or the mobile app.",category:"Features",kind:"boolean",default:!0,adoptable:!0,impact:"config",shapesTree:!1,requires:e=>e.ai===!0&&(e.desktop===!0||e.mobile===!0),requiresLabel:"requires AI features and an app to host them (the desktop app or the mobile app)"},{key:"credits",label:"Metered credits",hint:"Adds metered usage credits on top of subscription plans.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"config",shapesTree:!1,requires:e=>re(e),requiresLabel:"requires a payment provider"},{key:"revenueSharing",label:"Revenue sharing",hint:"Opt-in MRR leaderboard with dofollow backlinks.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"config",shapesTree:!1}];function Ns(e,t){return e[t]!==void 0}function en(e){return or.filter(t=>t.adoptable&&!Ns(e,t.key)&&(t.requires?t.requires(e):!0)).map(t=>({key:t.key,label:t.label,hint:t.hint,kind:t.kind,default:typeof t.default=="function"?t.default(e):t.default,...t.choices?{choices:t.choices}:{},impact:t.impact,...t.requiresLabel?{requiresLabel:t.requiresLabel}:{}}))}function Cs(e,t){switch(e.kind){case"boolean":return typeof t=="boolean";case"enum":return typeof t=="string"&&(e.choices??[]).includes(t);case"multiselect":return Array.isArray(t)&&t.every(r=>typeof r=="string"&&(e.choices??[]).includes(r))}}function Ls(e){let t=(e.choices??[]).map(r=>JSON.stringify(r)).join(", ");switch(e.kind){case"boolean":return"true or false";case"enum":return`one of ${t}`;case"multiselect":return`an array of ${t}`}}function tn(e){let t=[];for(let r of or){let n=e[r.key];n!==void 0&&(Cs(r,n)||t.push(`\`${r.key}\` is ${JSON.stringify(n)}, but it must be ${Ls(r)}.`))}return t}function rn(e){let t={};for(let r of or)if(typeof r.default=="function"){if(r.requires&&!r.requires(e))continue;t[r.key]=r.default(e)}else t[r.key]=Array.isArray(r.default)?[...r.default]:r.default;return{...t,...e}}function ar(e,t){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||t}function Dt(e){return e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function Nt(e){return/^[a-z][a-z0-9-]*$/.test(e)}function N(e){return e instanceof Error?e.message:String(e)}function yt(e){if(e.mobilePurchases!=="revenuecat")return e;if(e.mobile===!1)throw new Error("--mobile-purchases revenuecat requires the mobile app; remove --no-mobile.");if(e.paymentProvider==="none")throw new Error("--mobile-purchases revenuecat requires a payment provider (got --payment none): store purchases are additive to your web billing, never a replacement.");return e.mobile===void 0&&(e.mobile=!0),e}function bt(e){if(e.webAi!==!1)return e;if(e.ai===!1)throw new Error("--no-web-ai requires --ai (the desktop and mobile apps are where AI lives when the web surface is off).");if(e.desktop===!1&&e.mobile===!1)throw new Error("--no-web-ai requires --desktop or --mobile - with the web AI surface off, the desktop and mobile apps are the only places your AI features exist.");return e}function nn(e){if(e.webAi!==!1)return[];let t=[];return e.desktop!==!0&&e.mobile!==!0&&t.push("neither `desktop` nor `mobile` is true, so this project has no desktop or mobile app - and with the web AI surface off, those apps are the only places its AI features would exist."),t}function sn(e){if(e.mobilePurchases!=="revenuecat")return[];let t=[];return e.mobile!==!0&&t.push("`mobile` is not true, so this project has no app to sell in - the store lane's paywall, purchase and restore surfaces all live in `apps/mobile`."),re(e)||t.push('`paymentProvider` is absent or `"none"`, and store purchases are additive to your web billing - there is nothing here for them to sit on top of.'),t}function on(e){let t=$s(e,e.desktopAi);return delete e.desktopAi,t}function $s(e,t){return e.desktop!==!0?{kind:"none"}:t===!0&&e.ai!==!0?{kind:"legacy-desktop-ai"}:t===!1&&e.ai===!0?{kind:"desktop-gains-ai"}:{kind:"none"}}function an(e){let t={};if(e.name!==void 0){if(!Nt(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.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.projects!==void 0&&(t.projects=e.projects),e.docs!==void 0&&(t.docs=e.docs),e.desktop!==void 0&&(t.desktop=e.desktop),e.mobile!==void 0&&(t.mobile=e.mobile),e.mobilePurchases!==void 0){if(!je.includes(e.mobilePurchases))throw new Error(`Invalid mobile purchases "${e.mobilePurchases}". Valid values: ${je.join(", ")}`);t.mobilePurchases=e.mobilePurchases}if(e.ai!==void 0&&(t.ai=e.ai),e.webAi!==void 0&&(t.webAi=e.webAi),yt(t),bt(t),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.currency!==void 0){if(!ce.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${ce.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!le.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${le.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!pe.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${pe.join(", ")}`);t.databaseProvider=e.database}if(e.cache!==void 0){if(!de.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${de.join(", ")}`);t.cacheProvider=e.cache}if(e.observability!==void 0){let r=e.observability.split(",").map(i=>i.trim()).filter(Boolean),n=r.filter(i=>!K.includes(i));if(n.length>0)throw new Error(`Invalid observability provider ${JSON.stringify(n.join(", "))}. Valid values: ${K.join(", ")}`);t.observability=r}if(e.preset!==void 0){if(!$e.includes(e.preset))throw new Error(`Invalid preset "${e.preset}". Valid values: ${$e.join(", ")}`);let r=ae[e.preset].values;t.deploymentTarget??=r.deploymentTarget,t.databaseProvider??=r.databaseProvider,t.cacheProvider??=r.cacheProvider}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 n;try{n=new URL(r)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${n.protocol}//${n.host}`}return t}var ot={projectName:"my-saas",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,projects:!1,docs:!1,desktop:!1,mobile:!1,mobilePurchases:"none",ai:!1,webAi:!0,revenueSharing:!1,credits:!0,defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis",observability:[]};function cn(e){let t=e.projectName??ot.projectName,r=e.projectDir??`./${t}`,n=e.appName??Dt(t),i=e.deploymentTarget??ot.deploymentTarget,o=te[i]?.edgeRuntime??!1,s=e.databaseProvider??(o?"neon":ot.databaseProvider),a=e.cacheProvider??(o?"upstash":ot.cacheProvider),p=e.emailProvider??(o?"resend":ot.emailProvider),h={...ot,...e,projectName:t,appName:n,projectDir:r,deploymentTarget:i,databaseProvider:s,cacheProvider:a,emailProvider:p};h.paymentProvider==="none"&&(h.credits=!1),(!h.mobile||h.paymentProvider==="none")&&(h.mobilePurchases="none"),yt(h);for(let g of et){if(h.deploymentTarget!==g.target)continue;let k=h.databaseProvider===g.provider?"database":"cache";if(h.databaseProvider===g.provider||h.cacheProvider===g.provider)throw new Error(`Incompatible: --deploy ${g.target} + --${k} ${g.provider}. ${g.reason}`)}for(let g of tt)if(h.architecture===g.architecture&&h.deploymentTarget===g.target)throw new Error(`Incompatible: --architecture ${g.architecture} + --deploy ${g.target}. ${g.reason}`);return bt(h),h}function I(e){f.isCancel(e)&&(f.cancel("Setup cancelled."),process.exit(0))}function cr(e){let t=[];return 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})),e.demo&&t.push({key:"TURNSTILE_SECRET_KEY",message:"Cloudflare Turnstile secret key (optional):",secret:!0}),t}async function ln(e,t){let r=!1;e&&yt(e),e&&bt(e),f.log.info(y.bold("Project"));let n=e?.projectName??await(async()=>{r=!0;let c=await f.text({message:"Project name:",placeholder:"my-saas",validate:d=>{if(!d?.trim())return"Project name is required.";if(!Nt(d))return"Use lowercase letters, numbers, and hyphens only. Must start with a letter."}});return I(c),c})(),i=e?.appName??await(async()=>{r=!0;let c=await f.text({message:"App name:",initialValue:Dt(n),validate:d=>{if(!d?.trim())return"App name is required."}});return I(c),c})(),o=e?.projectDir??await(async()=>{r=!0;let c=await f.text({message:"Project location:",initialValue:`./${n}`});return I(c),c==="."?process.cwd():c})();f.log.info(y.bold("Infrastructure"));let s={};if(e?.deploymentTarget===void 0&&e?.databaseProvider===void 0&&e?.cacheProvider===void 0){r=!0;let c=await f.select({message:"Infrastructure:",options:[...$e.map(d=>({value:d,label:ae[d].label,hint:ae[d].hint})),{value:"custom",label:"Customize",hint:"choose each piece yourself"}]});if(I(c),c!=="custom"){let d=ae[c].values;s.deploymentTarget=d.deploymentTarget,s.databaseProvider=d.databaseProvider,s.cacheProvider=d.cacheProvider,f.log.info(`${ae[c].label}: ${ae[c].hint}.`)}}let a=e?.deploymentTarget??s.deploymentTarget??"node";if(e?.deploymentTarget===void 0&&s.deploymentTarget===void 0){r=!0;let c=await f.select({message:"Deployment target:",options:le.map(d=>({value:d,label:te[d].label,hint:te[d].hint}))});I(c),a=c}let p=e?.architecture?tt.find(c=>c.architecture===e.architecture&&c.target===a):void 0;if(p)throw new Error(`Incompatible: --architecture ${p.architecture} + --deploy ${p.target}. ${p.reason}`);let h=new Set(tt.filter(c=>c.target===a).map(c=>c.architecture)),g=nt.filter(c=>!h.has(c)),k=e?.architecture??await(async()=>{if(g.length===1){let d=g[0];return f.log.info(`Auto-selected ${gt[d].label} architecture (only compatible option for ${te[a].label}).`),d}r=!0;let c=await f.select({message:"Architecture:",options:g.map(d=>({value:d,label:gt[d].label,hint:gt[d].hint}))});return I(c),c})(),w=e?.databaseProvider??s.databaseProvider??await(async()=>{r=!0;let c=pe.filter(R=>!et.some(Ee=>Ee.target===a&&Ee.provider===R));if(c.length===1){let R=c[0];return f.log.info(`Auto-selected ${Ce[R].label} (only compatible option for ${te[a].label}).`),R}let d=await f.select({message:"Database provider:",options:c.map(R=>({value:R,label:Ce[R].label,hint:Ce[R].hint}))});return I(d),d})(),P=e?.cacheProvider??s.cacheProvider??await(async()=>{r=!0;let c=de.filter(R=>!et.some(Ee=>Ee.target===a&&Ee.provider===R));if(c.length===1){let R=c[0];return f.log.info(`Auto-selected ${Le[R].label} (only compatible option for ${te[a].label}).`),R}let d=await f.select({message:"Cache provider:",options:c.map(R=>({value:R,label:Le[R].label,hint:Le[R].hint}))});return I(d),d})();if(te[a]?.edgeRuntime){let c=Zr.map(d=>` - ${d}`).join(`
|
|
3
|
+
`);f.note(c,"Unavailable on edge runtime")}f.log.info(y.bold("Features"));let u=e?.paymentProvider??await(async()=>{r=!0;let c=await f.select({message:"Payment provider:",options:it.map(d=>({value:d,label:_t[d].label,hint:_t[d].hint}))});return I(c),c})(),O=e?.defaultCurrency??await(async()=>{if(u==="none")return"USD";r=!0;let c=await f.select({message:"Default currency:",options:ce.map(d=>({value:d,label:d,hint:Ne[d].name}))});return I(c),c})(),be=e?.emailProvider??await(async()=>{r=!0;let c=await f.select({message:"Email provider:",options:st.map(d=>({value:d,label:Ot[d].label,hint:Ot[d].hint}))});return I(c),c})(),B=e?.observability??await(async()=>{r=!0;let c=await f.multiselect({message:"Observability (space to select, enter to confirm):",required:!1,initialValues:[],options:K.map(d=>({value:d,label:xt[d].label,hint:xt[d].hint}))});return I(c),c})(),oe=e?.multiTenancy??await(async()=>{r=!0;let c=await f.confirm({message:"Enable multi-tenancy (organizations)?",initialValue:!1});return I(c),c})(),Oe=e?.projects??await(async()=>{r=!0;let c=await f.confirm({message:"Enable projects (a switcher that scopes a user's work)?",initialValue:!1});return I(c),c})(),xe=e?.docs??await(async()=>{r=!0;let c=await f.confirm({message:"Include docs app? (self-hosted Fumadocs documentation site)",initialValue:!1});return I(c),c})(),De=t?.desktopAllowed!==!1,we=e?.desktop??(De?await(async()=>{r=!0;let c=await f.confirm({message:"Include the desktop app? (apps/desktop - cross-platform, built with Electron, device-auth). With AI on, it also runs a local AI stack.",initialValue:!1});return I(c),c})():(f.log.info(y.dim("Desktop app: available on the Pro plan and up - skipped.")),!1)),Qe=t?.mobileAllowed!==!1,v=e?.mobile??(Qe?await(async()=>{r=!0;let c=await f.confirm({message:"Include the mobile app? (apps/mobile - iOS and Android, built with Expo, with push notifications and universal links)",initialValue:!1});return I(c),c})():(f.log.info(y.dim("Mobile app: available on the Pro plan and up - skipped.")),!1)),L=!v||u==="none"?"none":e?.mobilePurchases??await(async()=>{r=!0;let R=await f.select({message:"Mobile in-app purchases?",options:[{value:"revenuecat",label:"RevenueCat",hint:"store billing on top of your web provider - Apple and Google charge, your app grants"},{value:"none",label:"None",hint:"web billing only; the app shows the plan, never a paywall"}],initialValue:"none"});return I(R),R})();yt({mobile:v,mobilePurchases:L,paymentProvider:u});let F=e?.ai??await(async()=>{r=!0;let c=await f.confirm({message:"Add AI features? (chat, models, automations, integrations)",initialValue:!1});return I(c),c})(),ve=e?.webAi??((we||v)&&F?await(async()=>{r=!0;let c=await f.confirm({message:"Show the AI surfaces in the web app? (No: app-first - your desktop or mobile app is where your AI product lives, and the web keeps account, billing, and licensing only)",initialValue:!0});return I(c),c})():!0);bt({webAi:ve,ai:F,desktop:we,mobile:v});let $=e?.revenueSharing??await(async()=>{r=!0;let c=await f.confirm({message:"Enable revenue sharing? (opt-in MRR leaderboard with dofollow backlinks)",initialValue:!1});return I(c),c})(),W=u==="none"?!1:e?.credits??await(async()=>{r=!0;let c=await f.confirm({message:"Enable credits? (metered usage on top of subscription plans)",initialValue:!0});return I(c),c})(),ke=e?.demo,z=cr({databaseProvider:w,cacheProvider:P,paymentProvider:u,emailProvider:be,demo:ke}),T={};if(z.length>0&&r){f.log.info(y.bold("Credentials")+y.dim(" all optional - press Enter to skip, fill in .env later"));for(let c of z)if(r=!0,c.secret){let d=await f.password({message:c.message,mask:"*"});I(d),typeof d=="string"&&d.trim()&&(T[c.key]=d.trim())}else{let d=await f.text({message:c.message,placeholder:c.placeholder});I(d),typeof d=="string"&&d.trim()&&(T[c.key]=d.trim())}}if(r){let c=[` Name: ${y.cyan(n)}`,` App name: ${y.cyan(i)}`,` Location: ${y.cyan(o)}`,` Architecture: ${y.cyan(gt[k].label)}`].join(`
|
|
4
|
+
`),d=[` Deploy target: ${y.cyan(te[a]?.label??"Node.js / Docker")}`,` Database: ${y.cyan(Ce[w].label)}`,` Cache: ${y.cyan(Le[P].label)}`].filter(Boolean).join(`
|
|
5
|
+
`),R=[u!=="none"?` Payment: ${y.cyan(_t[u].label)} (${O})`:` Payment: ${y.dim("none")}`,` Credits: ${W?y.cyan("Yes"):y.dim("No")}`,` AI features: ${F?y.cyan("Yes"):y.dim("No")}`,...ve?[]:[` Web AI: ${y.dim("No")} (app-first)`],` Email: ${y.cyan(Ot[be].label)}`,` Observability: ${B.length===0?y.dim("none"):y.cyan(B.map(nr=>xt[nr].label).join(", "))}`,` Multi-tenancy: ${oe?y.cyan("Yes"):y.dim("No")}`,` Projects: ${Oe?y.cyan("Yes"):y.dim("No")}`,` Docs app: ${xe?y.cyan("Yes"):y.dim("No")}`,` Desktop app: ${we?y.cyan("Yes"):y.dim("No")}`,` Mobile app: ${v?y.cyan("Yes"):y.dim("No")}`,...L==="none"?[]:[` In-app purch.: ${y.cyan("RevenueCat")}`],` Rev. sharing: ${$?y.cyan("Yes"):y.dim("No")}`].join(`
|
|
6
|
+
`),Ee=[y.bold("Project"),c,"",y.bold("Infrastructure"),d,"",y.bold("Features"),R];if(z.length>0){let nr=z.map(zr=>{let Ds=T[zr.key]?y.green("provided"):y.dim("skipped");return` ${zr.key}: ${Ds}`}).join(`
|
|
7
|
+
`);Ee.push("",y.bold("Credentials"),nr)}f.note(Ee.join(`
|
|
8
|
+
`),"Summary");let Wr=await f.confirm({message:"Proceed with these settings?"});(f.isCancel(Wr)||!Wr)&&(f.cancel("Setup cancelled."),process.exit(0))}return{projectName:n,appName:i,projectDir:o,architecture:k,deploymentTarget:a,databaseProvider:w,cacheProvider:P,paymentProvider:u,emailProvider:be,observability:B,multiTenancy:oe,projects:Oe,docs:xe,desktop:we,mobile:v,mobilePurchases:L,ai:F,webAi:ve,revenueSharing:$,credits:W,defaultCurrency:O,...Object.keys(T).length>0?{credentials:T}:{},...e?.baseUrl!==void 0?{baseUrl:e.baseUrl}:{},...ke!==void 0?{demo:ke}:{}}}import{createReadStream as vn,existsSync as Ys}from"fs";import{mkdir as Ws}from"fs/promises";import{join as zs}from"path";import{Readable as qs}from"stream";import{pipeline as yr}from"stream/promises";import{extract as Js}from"tar";import{join as Me}from"path";import{homedir as js}from"os";var wt=process.env.GENERATESAAS_API_URL??"https://cli.generatesaas.com",q=".generatesaas",ue=Me(q,"manifest.json"),pn="nextjs",lr="nuxt",pr="2.4.1",dn=Me(q,"hashes.json"),Ct=Me(q,"template-hashes.json"),Lt=Me(q,"template"),un=Me(q,"staging"),mn=Me(q,"staging.json"),me=Me(js(),".generatesaas");var j=class extends Error{constructor(r,n,i){super(n);this.status=r;this.body=i}status;body;name="ApiError"};function he(e){return{apiKey:e,baseUrl:wt}}async function Se(e,t,r){let n=`${e.baseUrl}${t}`,i=await fetch(n,{...r,headers:{...r?.headers,Authorization:`Bearer ${e.apiKey}`,"User-Agent":"generatesaas-cli/3.32.0"}});if(!i.ok){let o,s;try{s=await i.json(),o=s.error??`API ${i.status}: ${t}`}catch{o=`API ${i.status}: ${t}`}throw new j(i.status,o,s)}return i}import{existsSync as Ms,mkdirSync as Us,readFileSync as Fs,writeFileSync as Vs}from"fs";import{dirname as Bs}from"path";import*as Pe from"@clack/prompts";function vt(){if(!Ms(me))return null;try{let e=JSON.parse(Fs(me,"utf-8"));return e.apiKey?e.apiKey:(e.token&&!e.apiKey&&Pe.log.warning(`Found old GitHub token in ${me}. Run 'generatesaas init' to set up your API key.`),null)}catch{return null}}function Ue(e){Us(Bs(me),{recursive:!0}),Vs(me,`${JSON.stringify({apiKey:e},null," ")}
|
|
9
|
+
`,{mode:384})}async function at(e){if(e?.apiKey)return e.apiKey;let t=process.env.GENERATESAAS_API_KEY;if(t)return t;let r=vt();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 kt()}async function kt(){let e=await Pe.text({message:"Enter your GenerateSaaS API key:",placeholder:"gs_live_...",validate:t=>{if(!t?.trim())return"API key is required."}});return Pe.isCancel(e)&&(Pe.cancel("Setup cancelled."),process.exit(0)),e.trim()}import{readFile as Ks}from"fs/promises";async function Ae(e){let t=process.env.GENERATESAAS_VERSION_INDEX;return t?JSON.parse(await Ks(t,"utf-8")):process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{latest:"0.0.0-ci",versions:[{version:"0.0.0-ci",date:new Date().toISOString(),breaking:!1}],entitlements:null}:await(await Se(e,"/versions")).json()}async function hn(e,t){if(process.env.GENERATESAAS_OFFLINE_LICENSE==="1")return null;try{return await(await Se(e,`/changelog/${encodeURIComponent(t)}`)).text()}catch(r){if(r instanceof j&&r.status===404)return null;throw r}}async function fn(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{skills:{"generatesaas-update":{skillMd:`# Offline skill stub
|
|
10
|
+
`,scripts:{},references:{}}}}:await(await Se(e,`/skills/${encodeURIComponent(t)}`)).json()}function $t(e){if(!(e instanceof j)||e.status!==403)return null;let t=e.body;return!t||t.code!=="update_window_expired"?null:{message:e.message,lastAllowedVersion:t.lastAllowedVersion??null}}var dr="nextjs";function gn(e){return{frontend:dr,architecture:e.architecture,deployTarget:e.deploymentTarget,database:e.databaseProvider,cache:e.cacheProvider,payment:e.paymentProvider,email:e.emailProvider,multiTenancy:e.multiTenancy,blog:!0,docs:e.docs,desktop:e.desktop,mobile:e.mobile,runner:!1,credits:e.credits,revenueSharing:e.revenueSharing,currency:e.defaultCurrency}}async function ur(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{token:"offline-test-token",licenseId:"offline-test-license-id",installId:t.installId}:await(await Se(e,"/license/sign",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function yn(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{token:t.currentToken}:await(await Se(e,"/license/refresh",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function mr(e,t){let r=await fetch(`${e}/license/verify`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!r.ok)throw new Error(`Verification service returned ${r.status}`);return await r.json()}async function bn(e,t,r){let n=await fetch(`${e}/license/inspect`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify(r)});if(!n.ok){let i=await n.json().catch(()=>null);throw new Error(i?.error??`Inspect endpoint returned ${n.status}`)}return await n.json()}var hr=new Set([".git","node_modules",".pnpm-store",".env",".env.test",".turbo",".data","dist",".next",".next-e2e-web",".next-e2e-desktop",".svelte-kit",".wrangler",".devcontainer","playwright-report","test-results",".drive-out",".mastra"]),fr=new Set(["pnpm-lock.yaml","widget-documents.generated.ts"]);function ct(e){if(gr(e))return!0;for(let t of e.split("/"))if(fr.has(t))return!0;return!1}var Gs=new Set(["data","mksaas","references","scripts",".cursor",".agents",".codex",".generatesaas",".vscode",".mcp.json","vitest.config.ts","README.md","TODO.md","OVERVIEW.md","HANDOFF.md"]),wn=["scripts/docs-lint.ts"],Hs=["docs/superpowers","packages/cli","packages/cli-api","packages/database/tests/no-migration-history.test.ts","infra/docker-compose.yml",".claude/commands",".claude/skills/web-port",".claude/skills/web-port-workspace",".claude/settings.local.json",".claude/worktrees"];function gr(e){let t=e.split("/");for(let r of t)if(hr.has(r))return!0;if(wn.includes(e)||wn.some(r=>r.startsWith(`${e}/`)))return!1;if(Gs.has(t[0]))return!0;for(let r of Hs)if(e===r||e.startsWith(`${r}/`))return!0;return!1}async function jt(e,t,r){await Ws(r,{recursive:!0});let n=process.env.GENERATESAAS_TEMPLATE_TARBALL_DIR;if(n){let a=zs(n,`v${t}.tar.gz`);if(!Ys(a))throw new Error(`GENERATESAAS_TEMPLATE_TARBALL_DIR is set but ${a} does not exist.`);await yr(vn(a),br(r));return}let i=process.env.GENERATESAAS_TEMPLATE_TARBALL;if(i){await yr(vn(i),br(r));return}let o=await Se(e,`/template/${encodeURIComponent(t)}`);if(!o.body)throw new Error("Empty response body");let s=qs.fromWeb(o.body);await yr(s,br(r))}function br(e){return Js({cwd:e,strip:1,filter:t=>{let r=t.replace(/^[^/]+\//,"");return r?!gr(r):!0},sync:!1})}import{readdir as Mt,readFile as lt,rm as En,rmdir as Xs,writeFile as Et}from"fs/promises";import{join as G}from"path";async function Sn(e){let t;try{t=await Mt(e,{withFileTypes:!0})}catch{return!1}let r=!1;for(let n of t){let i=G(e,n.name);if(n.isDirectory()){await Sn(i)&&(r=!0);continue}if(n.name.startsWith("_")){r=!0;continue}await En(i,{force:!0})}return r||await Xs(e).catch(()=>{}),r}async function Pn(e){let t=G(e,"packages/content"),r=[];try{r=(await Mt(t,{withFileTypes:!0})).filter(s=>s.isDirectory()).map(s=>s.name)}catch{return}let n=new Set;for(let s of r){let a=G(t,s),p;try{p=(await Mt(a,{withFileTypes:!0})).filter(h=>h.isDirectory())}catch{continue}for(let h of p)n.add(h.name),await Sn(G(a,h.name))}let i=await to(e),o=new Set([...n].filter(s=>i===void 0||i.has(s)));await Promise.all([...o].map(s=>En(G(e,"apps/web/public/images",s),{recursive:!0,force:!0}))),await no(e,o)}var Zs="packages/config/src/index.ts",Qs=/\bcontent:\s*\{[\s\S]*?\bsections:\s*\[([\s\S]*?)\]/,eo=/\bslug:\s*"([^"]+)"/g;async function to(e){let t;try{t=await lt(G(e,Zs),"utf-8")}catch{return}let r=Qs.exec(t)?.[1];if(r===void 0)return;let n=[...r.matchAll(eo)].map(i=>i[1]).filter(i=>i!==void 0);return n.length>0?new Set(n):void 0}var ro="packages/translate/.meta/mdx-translation-meta.json";async function no(e,t){if(t.size===0)return;let r=G(e,ro),n;try{n=JSON.parse(await lt(r,"utf-8"))}catch{return}if(typeof n!="object"||n===null)return;let i=n;if(typeof i.locales!="object"||i.locales===null)return;let o={};for(let[s,a]of Object.entries(i.locales)){if(typeof a!="object"||a===null)continue;let p={};for(let[h,g]of Object.entries(a)){let k=h.split("/"),w=k.length>1?k[0]:void 0,P=k[k.length-1]?.startsWith("_")===!0;w!==void 0&&t.has(w)&&!P||(p[h]=g)}o[s]=p}await Et(r,`${JSON.stringify({...i,locales:o},null," ")}
|
|
11
|
+
`)}var io="packages/config/src/blog.ts";async function An(e){let t=G(e,io),r=await lt(t,"utf-8"),n=kn(kn(r,"blogCategories",t),"blogAuthors",t);await Et(t,n)}function kn(e,t,r){let n=new RegExp(`(export const ${t}\\b[^=]*=\\s*)\\[[\\s\\S]*?\\];`);if(!n.test(e))throw new Error(`emptyBlogConfig: could not find the \`export const ${t} = [...]\` declaration in ${r}. The boilerplate blog config may have been renamed or restructured; update the CLI strip in cleanup.ts.`);return e.replace(n,"$1[];")}async function In(e){let t=G(e,"packages/i18n/translations"),r;try{r=await Mt(t)}catch{return}for(let n of r){let i=G(t,n,"web.json"),o;try{o=await lt(i,"utf-8")}catch{continue}let s=JSON.parse(o);!s.content?.categories||s.content.categories.blog===void 0||(s.content.categories.blog={},await Et(i,`${JSON.stringify(s,null," ")}
|
|
12
|
+
`))}}var so="packages/config/src/ai/tasks.ts",oo="The array carries a SINGLE INERT DEMO task: the CLI strips it for buyer builds (leaving an empty\n * `aiTasks`, which hides the Tasks tab) and keeps it for `--demo` builds.",ao="The array starts EMPTY, which hides the Tasks tab until you declare your first task.";async function Tn(e){let t=G(e,so),r=await lt(t,"utf-8"),n=r.replace(/\n?[\t ]*\/\/ gsaas:demo-ai-task-start[\s\S]*?\/\/ gsaas:demo-ai-task-end/,"");if(n===r)throw new Error(`removeDemoAiTasks: could not find the \`gsaas:demo-ai-task\` markers in ${t}. The boilerplate AI tasks config may have been renamed or restructured; update the CLI strip in cleanup.ts.`);let i=n.replace(oo,ao);if(i===n)throw new Error(`removeDemoAiTasks: the demo-task paragraph in ${t} did not match, so the shipped file would describe a demo task it no longer carries (boilerplate drift).`);await Et(t,i)}async function Rn(e){let t=G(e,".claude","settings.json"),r;try{r=await lt(t,"utf8")}catch{return}let n=JSON.parse(r);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(co)),await Et(t,`${JSON.stringify(n,null," ")}
|
|
13
|
+
`)}function co(e){return!(e.startsWith("mcp__")||e.includes("nuxt"))}import{readFileSync as wo}from"fs";import{dirname as vo,join as On}from"path";import{fileURLToPath as ko}from"url";import{existsSync as lo}from"fs";import{join as _n}from"path";function Ut(e,t,r){let n=_n(e,...t);return lo(n)?n:_n(e,r)}import{mkdir as po,writeFile as uo,readdir as mo,rm as ho,rmdir as fo}from"fs/promises";import{dirname as Ft,join as go,relative as yo,sep as bo}from"path";function Fe(e){return e.split(bo).join("/")}async function Vt(e){await po(e,{recursive:!0})}async function l(e,t){await Vt(Ft(e)),await uo(e,t,"utf-8")}async function Ve(e,t){await ho(e,{force:!0});let r=Ft(e);for(;r!==t&&r!==Ft(r);){try{await fo(r)}catch{return}r=Ft(r)}}async function J(e,t,r,n){let i=[],o=await mo(e,{withFileTypes:!0});for(let s of o){let a=go(e,s.name),p=Fe(yo(t,a));r(p)||(s.isDirectory()?i.push(...await J(a,t,r,n)):s.isFile()&&(n===void 0||n(p))&&i.push(a))}return i}var Eo={postgres:"Postgres",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"},So={resend:"Resend",ses:"Amazon SES",smtp:"SMTP"},Po={redis:"Redis",upstash:"Upstash Redis"},Ao={node:"Node.js / Docker",vercel:"Vercel"},wr="apps/web",Io="Next.js 16",To="`app/` routes, `components/`, `lib/`",Ro={stripe:"Stripe",polar:"Polar"};function _o(e){let t=e.architecture==="fullstack",r=t?"(fullstack - Hono API mounted inside the app)":"(separate - standalone Hono backend)",n=t?`Mounted inside \`${wr}\`. 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.",i=Po[e.cacheProvider],o=Ao[e.deploymentTarget],s=e.paymentProvider==="none"?"":`
|
|
14
|
+
- **Payments:** ${Ro[e.paymentProvider]}`,a=e.desktop?e.mobile?", the desktop app (built with Electron) under `docs/desktop/` and the mobile app (built with Expo) under `docs/mobile/`":", and the desktop app (built with Electron) under `docs/desktop/`":e.mobile?", and the mobile app (built with Expo) under `docs/mobile/`":"",p=e.desktop?" With the desktop app on, both shells render the same body, so one change lands in both.":"",h=`\`useTranslations()\` from \`next-intl\` in components; messages are loaded in \`${wr}/i18n/request.ts\`.`;return xo({archSuffix:r,apiLocation:n,databaseName:Eo[e.databaseProvider],cacheName:i,paymentLine:s,emailName:So[e.emailProvider],deployName:o,appDocsRef:a,sharedScreensBothShells:p,i18nRule:h,webAppDir:wr,webAppName:Io,webAppLayout:To})}function Oo(){return Ut(vo(ko(import.meta.url)),["generators","content"],"content")}function xo(e){let t=wo(On(Oo(),"AGENTS.template.md"),"utf-8"),r=new Map(Object.entries(e)),n=t.replace(/\{\{(\w+)\}\}/g,(o,s)=>{let a=r.get(s);if(a===void 0)throw new Error(`AGENTS.template.md uses unknown token {{${s}}}`);return a}),i=/\{\{[^}]*\}\}/.exec(n);if(i)throw new Error(`AGENTS.template.md carries an unrendered token: ${i[0]}`);return n}async function xn(e){await l(On(e.projectDir,"AGENTS.md"),_o(e))}import{join as Do}from"path";var Dn="apps/web",vr="Next.js 16",No={postgres:"Postgres (self-hosted)",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"};function Co(e){let t=e.appName.trim()||e.projectName,r=No[e.databaseProvider],n=e.architecture==="fullstack"?`${vr} app at \`${Dn}/\` 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.`:`${vr} app at \`${Dn}/\` and a separate Hono backend at \`apps/backend/\`.`,i=e.architecture==="fullstack"?`- App + API: http://localhost:3000
|
|
15
15
|
- Inngest dev server: http://127.0.0.1:8288`:`- App: http://localhost:3000
|
|
16
16
|
- API: http://localhost:3010
|
|
17
17
|
- Inngest dev server: http://127.0.0.1:8288`,o=e.ai?`pnpm mastra:studio # optional: inspect the AI assistant and its memory (localhost:4111)
|
|
@@ -22,7 +22,7 @@ ${n}
|
|
|
22
22
|
|
|
23
23
|
## Stack
|
|
24
24
|
|
|
25
|
-
- **Frontend:** ${
|
|
25
|
+
- **Frontend:** ${vr}
|
|
26
26
|
- **Backend:** Hono (TypeScript, RPC-typed)
|
|
27
27
|
- **Auth:** Better Auth
|
|
28
28
|
- **ORM / DB:** Drizzle + ${r}
|
|
@@ -74,27 +74,27 @@ pnpm dlx generatesaas eject
|
|
|
74
74
|
## Updates
|
|
75
75
|
|
|
76
76
|
To pull the latest boilerplate changes into this project, open it in your AI coding agent and ask: \`update my GenerateSaaS project\`.
|
|
77
|
-
`}async function
|
|
77
|
+
`}async function Nn(e){await l(Do(e.projectDir,"README.md"),Co(e))}import{access as Lo}from"fs/promises";import{join as St}from"path";async function $o(e,t,r){let n=St(e,"apps/desktop/dev-app-update.yml");try{await Lo(n)}catch{throw new Error(`Cannot neutralize the desktop dev update feed: ${n} is missing (boilerplate drift).`)}await l(n,`provider: generic
|
|
78
78
|
url: ${t}
|
|
79
79
|
updaterCacheDirName: ${r}
|
|
80
|
-
`)}function
|
|
80
|
+
`)}function jo(e){let t=e.split(".");return t.length>=3?t.slice(1).join("."):e}function Mo(e,t){let r=ar(e,"app");return{appId:`${t.split(".").reverse().join(".")}.${r.replace(/-/g,"")}`,productName:e,protocol:r}}function Uo(e){let t=e.toLowerCase().replace(/[^a-z0-9_]/g,"");return/^[a-z]/.test(t)?t:`app${t}`}function Fo(e,t){let r=ar(e,"app");return{appName:e,slug:r,bundleId:[...t.split(".").reverse(),r.replace(/-/g,"")].map(Uo).join("."),scheme:/^[a-z]/.test(r)?r:`app-${r}`}}function Vo(e){let t=[" // PRESENCE IS THE SWITCH: reporting runs as soon as the credential below is non-empty. There"," // is no separate `enabled` flag to remember - pasting the key IS turning it on, and clearing it"," // is turning it off. These are PUBLISHABLE credentials: they only authorize SENDING events,"," // never reading them, which is why they live here rather than in env and why a packaged desktop"," // app can carry them. Server-side, SENTRY_DSN and POSTHOG_API_KEY override them."].join(`
|
|
81
81
|
`),r=[];return e.includes("sentry")&&r.push(' sentry: { dsn: "" }'),e.includes("posthog")&&r.push([" // llmContent sends your users' prompts and completions to PostHog. Every number (tokens,"," // cost, latency, errors) is captured either way - turn it on only if your privacy policy"," // covers sending their message text to a third party.",' posthog: { publicKey: "", host: "https://us.i.posthog.com", llmContent: false }'].join(`
|
|
82
82
|
`)),r.length===0?[" // Error and product reporting is OFF: no provider was selected at init, so neither adapter",' // nor SDK was generated. To turn one on, add `"sentry"`, `"posthog"` or both to the'," // `observability` array in `.generatesaas/manifest.json`, then run `generatesaas update` -"," // which re-shapes the project and installs what it needs. Note that update stages nothing"," // while you are already on the latest version, so take the upgrade first if it reports no"," // changes."," observability: {},"].join(`
|
|
83
83
|
`):`${t}
|
|
84
84
|
observability: {
|
|
85
85
|
${r.join(`,
|
|
86
86
|
`)}
|
|
87
|
-
},`}async function
|
|
87
|
+
},`}async function Cn(e){let t=e.appName.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),r=e.paymentProvider!=="none",n=e.baseUrl??"http://localhost:3000",i=e.baseUrl?new URL(e.baseUrl).hostname:"example.com",o=jo(i),s=e.demo?"false":"true",a=e.multiTenancy?`{
|
|
88
88
|
multiTenant: true,
|
|
89
89
|
organizationLimit: 5,
|
|
90
90
|
defaultOrganizationName: "{name}'s workspace"
|
|
91
|
-
}`:"{ multiTenant: false }",
|
|
91
|
+
}`:"{ multiTenant: false }",p=e.projects?"{ enabled: true, seedDefault: true }":"{ enabled: false, seedDefault: true }",h=Vo(e.observability),g=e.demo?`{
|
|
92
92
|
enableInDev: true,
|
|
93
93
|
chatwoot: {
|
|
94
94
|
baseUrl: "https://support.alexchelan.com",
|
|
95
95
|
websiteToken: "1uWvJLHkhWLihkK2bxLaj2Fg"
|
|
96
96
|
}
|
|
97
|
-
}`:"{}",
|
|
97
|
+
}`:"{}",k=e.architecture==="fullstack"?"false":"true",w=Mo(t,o),P=`https://cdn.${o}/desktop`,u=Fo(t,o),O=` // Store purchases (RevenueCat) for the mobile app - ADDITIVE to the web provider, never a
|
|
98
98
|
// replacement: store rules require digital goods to be sold through in-app purchase.
|
|
99
99
|
mobile: {
|
|
100
100
|
enabled: ${e.mobilePurchases==="revenuecat"},
|
|
@@ -140,7 +140,7 @@ export const config: AppConfig = {
|
|
|
140
140
|
origins: ["http://localhost:3000", "http://localhost:5173"],
|
|
141
141
|
waitlist: false,
|
|
142
142
|
tenancy: ${a},
|
|
143
|
-
projects: ${
|
|
143
|
+
projects: ${p},
|
|
144
144
|
theme: {
|
|
145
145
|
default: "system",
|
|
146
146
|
switcher: true,
|
|
@@ -201,7 +201,7 @@ ${O}
|
|
|
201
201
|
maxCreatesPerDay: 20
|
|
202
202
|
},
|
|
203
203
|
apiDocs: true,
|
|
204
|
-
performanceMonitor: { enabled: ${
|
|
204
|
+
performanceMonitor: { enabled: ${k} },
|
|
205
205
|
// Open pages re-read what changed elsewhere, over one coalesced signal; see docs/live-updates.
|
|
206
206
|
liveUpdates: { enabled: true },
|
|
207
207
|
${h}
|
|
@@ -222,6 +222,10 @@ ${h}
|
|
|
222
222
|
// itself on only when its own env var is set.
|
|
223
223
|
enabled: ${e.demo?"false":"true"}
|
|
224
224
|
},
|
|
225
|
+
// Product feedback from the account menu and the \`feedback_submit\` AI tool, read under Admin ->
|
|
226
|
+
// Feedback. False hides the menu entry, the tool, the route and the admin page. The hourly and daily
|
|
227
|
+
// limits are \`cacheConfig.feedbackRateLimit\` in ./cache.ts.
|
|
228
|
+
feedback: { enabled: true },
|
|
225
229
|
// OFF everywhere, demos included. A demo could only run Turnstile on the always-passes TEST
|
|
226
230
|
// site key - a real one is domain-locked to the deployment that owns it - and that key paints a
|
|
227
231
|
// "For testing only. If seen, report to site owner" banner across the sign-in form, which reads
|
|
@@ -248,7 +252,7 @@ ${h}
|
|
|
248
252
|
}`:`{
|
|
249
253
|
base: "${e.defaultCurrency}",
|
|
250
254
|
list: [
|
|
251
|
-
{ symbol: "${
|
|
255
|
+
{ symbol: "${Ne[e.defaultCurrency].symbol}", name: "${Ne[e.defaultCurrency].name}", code: "${e.defaultCurrency}", place: "${Ne[e.defaultCurrency].place}", space: ${Ne[e.defaultCurrency].space} }
|
|
252
256
|
],
|
|
253
257
|
countryMap: {
|
|
254
258
|
default: "${e.defaultCurrency}"
|
|
@@ -327,7 +331,7 @@ ${h}
|
|
|
327
331
|
// What every user starts on (their own choice, once made, always wins). Plain
|
|
328
332
|
// OpenRouter model ids.
|
|
329
333
|
defaults: {
|
|
330
|
-
model: "
|
|
334
|
+
model: "z-ai/glm-5.3-flash"
|
|
331
335
|
},
|
|
332
336
|
// The model that NAMES each conversation, per lane - your decision, never a user setting.
|
|
333
337
|
// Every entry is the cheapest sensible model its provider offers: naming fires on every
|
|
@@ -336,20 +340,20 @@ ${h}
|
|
|
336
340
|
// names THROUGH that CLI on the user's own subscription. Remove an entry to keep prefix titles
|
|
337
341
|
// on that lane.
|
|
338
342
|
titles: {
|
|
339
|
-
builtin: "
|
|
343
|
+
builtin: "z-ai/glm-5.3-flash",
|
|
340
344
|
byok: {
|
|
341
|
-
openrouter: "
|
|
342
|
-
anthropic: "claude-haiku-
|
|
343
|
-
openai: "gpt-
|
|
345
|
+
openrouter: "z-ai/glm-5.3-flash",
|
|
346
|
+
anthropic: "claude-haiku-5-5",
|
|
347
|
+
openai: "gpt-6-luna",
|
|
344
348
|
google: "gemini-3.5-flash-lite"
|
|
345
349
|
},
|
|
346
350
|
cli: {
|
|
347
351
|
// "haiku" is Claude Code's rolling alias for the newest Haiku.
|
|
348
352
|
"claude-code": { model: "haiku" },
|
|
349
|
-
codex: { model: "gpt-
|
|
350
|
-
// grok's SUBSCRIPTION logins serve only the current
|
|
351
|
-
grok: { model: "grok-4.
|
|
352
|
-
opencode: { model: "opencode/
|
|
353
|
+
codex: { model: "gpt-6-luna", effort: "none" },
|
|
354
|
+
// grok's SUBSCRIPTION logins serve only the current models; 4.7 is the current default.
|
|
355
|
+
grok: { model: "grok-4.7", effort: "low" },
|
|
356
|
+
opencode: { model: "opencode/glm-5.3-flash-free", effort: "low" }
|
|
353
357
|
}
|
|
354
358
|
},
|
|
355
359
|
// The model each coding CLI's interactive TERMINAL session STARTS on, by CLI id - the user
|
|
@@ -450,6 +454,7 @@ export * from "./blog";
|
|
|
450
454
|
export * from "./cache";
|
|
451
455
|
export * from "./content";
|
|
452
456
|
export * from "./credit-price";
|
|
457
|
+
export * from "./feedback";
|
|
453
458
|
export * from "./footer";
|
|
454
459
|
export * from "./i18n";
|
|
455
460
|
export * from "./landing";
|
|
@@ -462,7 +467,7 @@ export * from "./robots";
|
|
|
462
467
|
export * from "./roles";
|
|
463
468
|
export * from "./section-tabs";
|
|
464
469
|
export * from "./tenancy";
|
|
465
|
-
`,B=
|
|
470
|
+
`,B=St(e.projectDir,"packages/config/src/index.ts");await l(B,be),await l(St(e.projectDir,"packages/config/src/support.ts"),`import type { SupportConfig } from "@repo/config/types";
|
|
466
471
|
|
|
467
472
|
/**
|
|
468
473
|
* Live-chat (support widget) configuration, re-exported by the config index as
|
|
@@ -475,7 +480,7 @@ export * from "./tenancy";
|
|
|
475
480
|
* import here type-only.
|
|
476
481
|
*/
|
|
477
482
|
export const supportConfig: SupportConfig = ${g};
|
|
478
|
-
`),await l(
|
|
483
|
+
`),await l(St(e.projectDir,"packages/config/src/desktop.mjs"),`// Plain-JS desktop app identity. NO env reads, so tooling that cannot import the
|
|
479
484
|
// TypeScript config index reads it directly: the Electron main + renderer bundles,
|
|
480
485
|
// the CSP policy builder, and the electron-builder packaging config. Edit these
|
|
481
486
|
// values once to rebrand - they are the same in dev and production, so they live in
|
|
@@ -526,7 +531,7 @@ export const desktopConfig = {
|
|
|
526
531
|
background: false
|
|
527
532
|
}
|
|
528
533
|
};
|
|
529
|
-
`),await l(
|
|
534
|
+
`),await l(St(e.projectDir,"packages/config/src/mobile.mjs"),`// Plain-JS mobile app identity. NO env reads, so tooling that cannot import the
|
|
530
535
|
// TypeScript config index reads it directly: app.config.ts, the EAS build config,
|
|
531
536
|
// Metro, and the app bundle itself (\`+native-intent\` reads UNIVERSAL_LINK_PATHS).
|
|
532
537
|
// The CLI wrote these values from your app name + domain at init; edit them here
|
|
@@ -539,14 +544,14 @@ import { NOTIFICATIONS_ENABLED } from "./notifications-flag.mjs";
|
|
|
539
544
|
export const mobileConfig = {
|
|
540
545
|
enabled: ${e.mobile},
|
|
541
546
|
// Home-screen and store display name.
|
|
542
|
-
appName: "${
|
|
547
|
+
appName: "${u.appName}",
|
|
543
548
|
// Expo slug, EAS project name, and the prefix the auth client namespaces its
|
|
544
549
|
// stored session under.
|
|
545
|
-
slug: "${
|
|
550
|
+
slug: "${u.slug}",
|
|
546
551
|
// iOS bundle id and Android application id.
|
|
547
|
-
bundleId: "${
|
|
552
|
+
bundleId: "${u.bundleId}",
|
|
548
553
|
// Deep-link scheme, with NO \`://\` - the code appends the separator it needs.
|
|
549
|
-
scheme: "${
|
|
554
|
+
scheme: "${u.scheme}",
|
|
550
555
|
// The web host whose /.well-known files claim this app's universal links. Your
|
|
551
556
|
// PROJECT domain, subdomain included: it must match the host your links carry.
|
|
552
557
|
universalLinks: { host: "${i}" },
|
|
@@ -639,9 +644,9 @@ export const SETTINGS_PRIVACY_PATH = "/settings/privacy";
|
|
|
639
644
|
export const SETTINGS_APP_LOCK_PATH = "/settings/app-lock";
|
|
640
645
|
/** app/(app)/settings/about.tsx - version, legal links and support. */
|
|
641
646
|
export const SETTINGS_ABOUT_PATH = "/settings/about";
|
|
642
|
-
`),e.desktop&&await
|
|
643
|
-
`)}function
|
|
644
|
-
`)}async function
|
|
647
|
+
`),e.desktop&&await $o(e.projectDir,P,`${w.protocol}-updater`)}import{join as Bo}from"path";function Ko(e,t){let r=[e==="stripe"?' stripePriceId: "",':' polarProductId: "",'];return t&&r.push(' appleProductId: "",',' googleProductId: "",'," storeAmounts: {},"),r.join(`
|
|
648
|
+
`)}function kr(e){let t=[];return e.withCredits&&(t.push(`credits: ${e.credits}`),e.recurring!==!1&&t.push("creditInterval: 30")),t.push(`apiRateLimit: { maxRequests: ${e.rateLimit} }`),e.maxConcurrentRuns!==void 0&&t.push(`maxConcurrentRuns: ${e.maxConcurrentRuns}`),e.automationMinutesPerMonth!==void 0&&t.push(`automationMinutesPerMonth: ${e.automationMinutesPerMonth}`),t.map(r=>` ${r}`).join(`,
|
|
649
|
+
`)}async function Ln(e){let t=Bo(e.projectDir,"packages/config/src/pricing.ts"),r=e.defaultCurrency;if(e.paymentProvider==="none"){let P=`import type { PricingConfig } from "@repo/config/types";
|
|
645
650
|
|
|
646
651
|
export const pricingConfig: PricingConfig = {
|
|
647
652
|
defaultPlan: "free",
|
|
@@ -670,7 +675,7 @@ export const pricingConfig: PricingConfig = {
|
|
|
670
675
|
credits: { enabled: false },
|
|
671
676
|
products: { enabled: false, items: [] }
|
|
672
677
|
};
|
|
673
|
-
`;await l(t,P);return}let n=e.paymentProvider,i
|
|
678
|
+
`;await l(t,P);return}let n=e.paymentProvider,i=Ko(n,e.mobilePurchases==="revenuecat"),o=e.credits,s=!!e.ai,a=kr({credits:5,rateLimit:100,withCredits:o,recurring:!1,...s&&{maxConcurrentRuns:2,automationMinutesPerMonth:60}}),p=kr({credits:10,rateLimit:1e3,withCredits:o,...s&&{maxConcurrentRuns:5,automationMinutesPerMonth:600}}),h=kr({credits:40,rateLimit:5e3,withCredits:o,...s&&{maxConcurrentRuns:10,automationMinutesPerMonth:3e3}}),g=r==="USD"?"":` // !! ${r} pricing WARNING: creditsPerUsd anchors credit cost to USD (AI providers bill in
|
|
674
679
|
// !! USD), but your plan prices and credit purchases are denominated in ${r}. Verify that the
|
|
675
680
|
// !! ${r} amounts above cover the USD cost per credit (~0.50 USD at creditsPerUsd 1 with the
|
|
676
681
|
// !! 100% markup) - and raise prices or creditsPerUsd if they do not.
|
|
@@ -679,7 +684,7 @@ export const pricingConfig: PricingConfig = {
|
|
|
679
684
|
!! plan prices and credit purchases are denominated in ${r}. At the shipped economics 1 credit
|
|
680
685
|
!! carries ~0.50 USD of AI cost - verify every ${r} price still covers it (see the comment on the
|
|
681
686
|
!! credits block in packages/config/src/pricing.ts), or raise prices / creditsPerUsd.
|
|
682
|
-
`);let
|
|
687
|
+
`);let k=o?` // creditsPerUsd scales USD cost -> credits (1 = 1 credit carries ~0.50 USD of cost after the
|
|
683
688
|
// 100% markup); markupPercent is the DEFAULT margin for everything that debits credits (AI,
|
|
684
689
|
// external APIs, your own features), and credits.markupByCategory overrides it per metered
|
|
685
690
|
// service ("ai", "webSearch", "webExtract"). Two optional knobs shape each debit's size:
|
|
@@ -748,7 +753,7 @@ ${i}
|
|
|
748
753
|
anchorAmounts: { ${r}: 109 }
|
|
749
754
|
}
|
|
750
755
|
],
|
|
751
|
-
${
|
|
756
|
+
${p}
|
|
752
757
|
},
|
|
753
758
|
{
|
|
754
759
|
id: "pro",
|
|
@@ -782,22 +787,22 @@ ${i}
|
|
|
782
787
|
${h}
|
|
783
788
|
}
|
|
784
789
|
],
|
|
785
|
-
${
|
|
790
|
+
${k},
|
|
786
791
|
products: {
|
|
787
792
|
enabled: false,
|
|
788
793
|
items: []
|
|
789
794
|
}
|
|
790
795
|
};
|
|
791
|
-
`;await l(t,w)}var
|
|
796
|
+
`;await l(t,w)}var Go={smtp:[{key:"SMTP_HOST",defaultValue:"127.0.0.1"},{key:"SMTP_PORT",defaultValue:"1025"},{key:"SMTP_USER"},{key:"SMTP_PASSWORD"}],ses:[{key:"AMAZON_SES_REGION",comment:"# TODO: Configure Amazon SES credentials (e.g. us-east-1)"},{key:"AMAZON_SES_KEY"},{key:"AMAZON_SES_SECRET"},{key:"AMAZON_SES_CONFIGURATION_SET",comment:"# Delivery events: configuration set -> SNS topic -> /webhooks/email/ses (see docs: Email)"},{key:"AMAZON_SES_SNS_TOPIC_ARN"}],resend:[{key:"RESEND_API_KEY",comment:"# TODO: Add your Resend API key"},{key:"RESEND_WEBHOOK_SECRET",comment:"# Delivery events: Resend webhook -> /webhooks/email/resend (see docs: Email)"}]},Ho={stripe:[{key:"STRIPE_SECRET_KEY",comment:"# TODO: Add your Stripe keys"},{key:"STRIPE_WEBHOOK_SECRET"},{key:"STRIPE_API_BASE",comment:"# Point the Stripe SDK at another host - a local mock, or a proxy of your own. Unset means api.stripe.com."},{key:"STRIPE_PORTAL_GENERATION",comment:"# A number your deploy sets higher on every release (build timestamp, pipeline run number), so a new release retires the Stripe portal configurations an older one created. Unset, none are retired."}],polar:[{key:"POLAR_ACCESS_TOKEN",comment:"# TODO: Add your Polar keys"},{key:"POLAR_WEBHOOK_SECRET"}]};function Bt(e,t){return t?e.map(r=>{let n=t[r.key];return n?{...r,defaultValue:n,comment:void 0}:r}):e}function Pt(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 Er(e){return Array.from(crypto.getRandomValues(new Uint8Array(e))).map(t=>t.toString(16).padStart(2,"0")).join("")}function Sr(e){return e.architecture==="fullstack"?{apiUrl:"http://localhost:3000/api",baseUrl:"http://localhost:3000"}:{apiUrl:"http://localhost:3010",baseUrl:"http://localhost:3000"}}var Yo="https://your-app.example.com/api";function Kt(e,t,r,n){e.push(n==="example"?`${t}=`:`${t}=${r}`)}function $n(e,t){let r=t==="example"?void 0:e.credentials,{apiUrl:n,baseUrl:i}=Sr(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=${n}`,`BASE_URL=${i}`):o.push("# App","# (API_URL is derived from the frontend's *_PUBLIC_API_URL by the runtime env schema.)",`BASE_URL=${i}`),o.push("","# Client IP (production)","# The backend rate-limits by client IP and stamps it on audit entries. YOU ALMOST","# CERTAINLY DO NOT NEED THIS: it detects Vercel, Fly.io, Render, Railway, Netlify and","# Coolify from their own env vars, and treats a private connection peer (Docker, compose,","# Kubernetes, Dokploy, an nginx/Traefik/Caddy on the same host) as proof that something is","# forwarding to it. A forwarded header is trusted only in those cases, never on a server","# exposed directly - there, a caller could have sent it themselves."),e.architecture==="fullstack"?o.push("# This build runs the API in the frontend's route handler, which has no connection","# address, so on a host the backend does not recognise there is nothing to fall back on","# and every caller shares ONE rate-limit bucket: the 10/min sign-in limit applies to","# your whole app rather than per person, and audit entries record no address."):o.push("# This build reads the connection peer, so a server exposed directly identifies its","# callers correctly with nothing set here."),o.push("# SET IT when nothing above can see your topology - the common case is a CDN in front of a","# directly exposed server, where connections arrive from a public CDN address:","# Cloudflare -> TRUSTED_PROXY=cf-connecting-ip","# another proxy in front -> TRUSTED_PROXY=1 (the number of proxies)","# Whatever you set wins over detection; `false` turns detection off and trusts nothing.","# TRUSTED_PROXY=1"),o.push("","# Auth rate limits","# Raises every Better Auth rate limit by a whole number (1-50). Unset = 1 = the","# shipped limits. No value disables them: 0, empty or unparseable fails at boot.","# You almost certainly want the default. The reason to raise it is an automated suite,","# which drives ONE address and so shares one bucket - and the e2e config already sets","# its own value, so it needs nothing here.","# AUTH_RATE_LIMIT_MULTIPLIER=1"),o.push("","# Database"),Pt(Bt(Ce[e.databaseProvider].envVars,r),o),o.push("","# Cache"),Pt(Bt(Le[e.cacheProvider].envVars,r),o),e.cacheProvider==="redis"&&o.push("# Optional prefix on every Redis key the app writes. Set it when several deployments share","# one Redis instance, or to keep a load test out of the live keyspace.","# Set it once, before first boot. Changing it on a running deployment orphans in-flight","# auto-top-up claims and distributed locks (autotopup:pending:*, withMutex) - drain or use","# a maintenance window first.","#REDIS_KEY_PREFIX="),o.push("","# Authentication"),t==="example"&&o.push("# Generate a strong secret, e.g. `openssl rand -hex 32`"),Kt(o,"BETTER_AUTH_SECRET",crypto.randomUUID(),t),o.push("","# Content API (random secret; required when contentApi feature is enabled in @repo/config)"),Kt(o,"CONTENT_API_KEY",Er(32),t),o.push("","# Job Queue - Inngest","INNGEST_APP_ID=api"),Kt(o,"INNGEST_EVENT_KEY",Er(32),t),o.push("# REQUIRED in production: it is how the /inngest endpoint tells Inngest from anyone else who","# finds the URL. The app refuses to boot without it unless INNGEST_DEV is set (local dev server).","# Take the real value from the Inngest dashboard."),Kt(o,"INNGEST_SIGNING_KEY",Er(32),t),o.push("# The local Inngest dev server (pnpm dev:inngest). In production on Inngest Cloud leave this UNSET:","# Cloud takes events and registration on two hosts, which no single URL can name. Set it only for a","# self-hosted Inngest, to its one host.","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=Go[e.emailProvider];if(s&&(o.push("","# Email"),Pt(Bt(s,r),o)),e.paymentProvider!=="none"){let p=Ho[e.paymentProvider];p&&(o.push("","# Payment"),Pt(Bt(p,r),o))}o.push("","# Storage - S3 Compatible (required for uploads: avatars, files)","# Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services.","# Uploads fail until these are set - storage is enabled in @repo/config by default.","#STORAGE_REGION=us-east-1","#STORAGE_ENDPOINT=https://your-account.r2.cloudflarestorage.com","#STORAGE_ACCESS_KEY_ID=","#STORAGE_SECRET_ACCESS_KEY=","# Two buckets: one publicly readable (avatars, assets), one credentials-only (private","# uploads served through the app). The bucket boundary is the privacy guarantee.","#STORAGE_PUBLIC_BUCKET=","#STORAGE_PRIVATE_BUCKET=",'# Public base URL for the public bucket. Public file URLs are STORAGE_PUBLIC_URL + "/" + key.',"#STORAGE_PUBLIC_URL=https://cdn.example.com","","# Storage - Local Filesystem (optional overrides)","# Defaults work out of the box; override for Docker volume mounts.","#STORAGE_LOCAL_PATH=/data","#STORAGE_LOCAL_PUBLIC_URL=https://cdn.example.com/files"),o.push("","# Admin Notifications (optional)","# Real-time notifications when business events occur (signups, purchases, etc.).","# Each provider is auto-enabled when its env vars are set.","#DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...","#SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...","#TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz","#TELEGRAM_CHAT_ID=-1001234567890","#TELEGRAM_TOPIC_ID=123"),o.push("","# Social sign-in (optional)","# Enable the matching provider in @repo/config, then set its pair here.","#GOOGLE_CLIENT_ID=","#GOOGLE_CLIENT_SECRET=","#GITHUB_CLIENT_ID=","#GITHUB_CLIENT_SECRET=","# Apple: APPLE_TEAM_ID + APPLE_KEY_ID + APPLE_PRIVATE_KEY are the signing key. Add APPLE_CLIENT_ID",'# (a Service ID) for the web button, and list "apple" in config.auth.socialProviders.',"#APPLE_CLIENT_ID=","#APPLE_TEAM_ID=","#APPLE_KEY_ID=","#APPLE_PRIVATE_KEY="),o.push("","# SMS - Twilio (optional)","#TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","#TWILIO_AUTH_TOKEN=","#TWILIO_PHONE_NUMBER=+1234567890"),o.push("","# Newsletter (optional)","#RESEND_AUDIENCE_ID=","#LISTMONK_URL=https://listmonk.yourdomain.com","#LISTMONK_API_USER=admin","#LISTMONK_API_TOKEN=","#LISTMONK_LIST_ID=1"),e.demo&&o.push("","# Support chat - Chatwoot identity validation (optional)","# The website inbox's HMAC token (Inbox -> Settings -> Configuration -> Identity validation).","# Server-only: the backend signs the signed-in user's id with it so the inbox can enforce","# identity validation. Never expose it to the browser.","#CHATWOOT_HMAC_TOKEN="),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=");let a=[];return e.observability.includes("sentry")&&a.push({key:"SENTRY_DSN",comment:"# Overrides config.observability.sentry.dsn for the server only."}),e.observability.includes("posthog")&&a.push({key:"POSTHOG_API_KEY",comment:`# Overrides config.observability.posthog.publicKey for the server only (host stays in config).
|
|
792
797
|
# Set but EMPTY switches every server-side PostHog report off (the e2e harness does this). Leave it
|
|
793
|
-
# unset in production: the committed key is used, and only the deployment reports.`}),a.length>0&&(o.push("","# Error and product reporting (optional)"),
|
|
794
|
-
`)}var
|
|
795
|
-
`)}function
|
|
796
|
-
`)}async function
|
|
797
|
-
${
|
|
798
|
-
${
|
|
798
|
+
# unset in production: the committed key is used, and only the deployment reports.`}),a.length>0&&(o.push("","# Error and product reporting (optional)"),Pt(a,o)),o.push("","# Release (optional)","# The release this deployment runs (a version, tag or commit), set by your deploy pipeline.","# Product feedback records it beside each item. Unset records none.","#APP_VERSION="),o.push("","# AI base (optional)","# Enable config.ai in packages/config. Built-in AI resolves through OpenRouter only,","# so OPENROUTER_API_KEY above is the only MODEL provider key the backend reads.","# BYOK is per-user and never an env var: users paste their own key in the app and it","# is stored encrypted in the database.","# Override the OpenRouter API base - a gateway or a proxy of your own. It must carry the","# /api/v1 suffix. Unset uses the hosted API.","#OPENROUTER_BASE_URL=https://openrouter.ai/api/v1","","# AI web tools (optional)","# Give the assistant its own web access, on chat (on by default), the desktop app-tools","# lane, automations and the MCP server. A key's presence is the whole switch: set one","# and the model gets its tools, set none and chat is unchanged. config.ai.webSearch:","# false switches every lane off.","# ANY one key alone covers both capabilities. With several set, auto-detection takes the","# CHEAPEST first - TinyFish, then Firecrawl, then Parallel - per capability; naming","# config.ai.webTools.searchEngine or .extractEngine wins over that order, and a named","# engine whose key is missing ships no tool at all.","# WHAT A CALL COSTS THE USER: the vendor price x credits.creditsPerUsd x the","# webSearch/webExtract markup (shipped at 100, so twice cost). Override the vendor price","# with config.ai.webTools.searchCostUsd / .extractCostUsd.","# TinyFish (the auto-detect default) - both tools at a $0 list price, so a call debits","# nothing, writes no ledger row and is never refused for an empty balance. Rate-limited","# instead (30 searches and 150 pages a minute per API key by default, shared by every","# user), so set a price on a busy app. Note its terms include a license to train on","# submitted content.","# https://agent.tinyfish.ai/","#TINYFISH_API_KEY=","# Firecrawl (the recommended PAID engine) - `web_search` AND `web_extract` (reads one","# page) from one signup, and the only vendor here whose terms carry no license over what","# you submit.","# https://firecrawl.dev/","#FIRECRAWL_API_KEY=","# Parallel (optional) - both tools, cheaper than Firecrawl on each, at high quality;","# extract is slower on a page it has not already indexed. Note its customer terms","# include a license to train on submitted queries.","# https://platform.parallel.ai/","#PARALLEL_API_KEY="),e.desktop&&o.push("","# Desktop app (optional)","# Base URL the marketing download page reads the release feed from.","# Unset uses config.desktop.autoUpdate.url.","#DESKTOP_FEED_BASE_URL="),e.mobile&&(o.push("","# Mobile app","# The bundle identifier the native Sign in with Apple token is issued to - it joins","# APPLE_CLIENT_ID in the audience the backend accepts. With the three Apple signing values","# and no APPLE_CLIENT_ID, it alone turns on native-only Sign in with Apple: the iOS app shows","# Apple beside Google (it reads that at runtime) and the web shows no Apple button.","#APPLE_APP_BUNDLE_IDENTIFIER=","# Comma-separated Android signing certificate SHA-256 fingerprints. They feed","# .well-known/assetlinks.json (which verifies your universal links) and the passkey","# Android origins.","#MOBILE_ANDROID_SHA256_FINGERPRINTS=","# Optional. An Expo access token turns on enhanced security for push sends.","#EXPO_ACCESS_TOKEN="),e.mobilePurchases==="revenuecat"&&o.push("","# Mobile store purchases - RevenueCat (server)","# The first two verify incoming webhooks; the third is read by the sync route and the","# nightly reconcile pass.","#REVENUECAT_WEBHOOK_SECRET=","#REVENUECAT_AUTH_HEADER=","#REVENUECAT_API_KEY=")),o.push("","# Build output (optional)","# Next's distDir for apps/web. Unset uses .next; the e2e harness sets its own so a test","# build never overwrites a dev server's.","#NEXT_DIST_DIR="),o.push(""),o.join(`
|
|
799
|
+
`)}var jn="NEXT_PUBLIC_API_URL";function Wo(e){let{apiUrl:t}=Sr(e),r=["# API Configuration",`${jn}=${t}`];return e.architecture==="separate"&&r.push("","# Production (uncomment and replace with your deployed hostnames):",`# ${jn}=${Yo}`),r.push(""),r.join(`
|
|
800
|
+
`)}function zo(e){let{apiUrl:t,baseUrl:r}=Sr(e),n=["# Expo reads env from THIS directory, never the monorepo root.","# Every EXPO_PUBLIC_* value is inlined into the app bundle - never put a secret here.","# Android emulator: replace localhost with 10.0.2.2; a physical device needs your machine's LAN IP","# EXPO_PUBLIC_API_URL is the value to fill first - without it the app throws at launch and names it.",`EXPO_PUBLIC_API_URL=${t}`,`EXPO_PUBLIC_WEB_URL=${r}`,"","# Native Google sign-in (optional)","#EXPO_PUBLIC_GOOGLE_WEB_CLIENT_ID=","#EXPO_PUBLIC_GOOGLE_IOS_CLIENT_ID="];e.mobilePurchases==="revenuecat"&&n.push("","# RevenueCat public SDK keys (optional until you create your products)","#EXPO_PUBLIC_REVENUECAT_IOS_KEY=","#EXPO_PUBLIC_REVENUECAT_ANDROID_KEY=");let i=[];return e.observability.includes("sentry")&&i.push("#EXPO_PUBLIC_SENTRY_DSN="),e.observability.includes("posthog")&&i.push("#EXPO_PUBLIC_POSTHOG_KEY="),i.length>0&&n.push("","# Observability (optional)",...i),n.push(""),n.join(`
|
|
801
|
+
`)}async function Mn(e){let t=Wo(e);if(await l(`${e.projectDir}/.env`,`${t}
|
|
802
|
+
${$n(e,"env")}`),await l(`${e.projectDir}/.env.example`,`${t}
|
|
803
|
+
${$n(e,"example")}`),e.mobile){let r=zo(e);await l(`${e.projectDir}/apps/mobile/.env`,r),await l(`${e.projectDir}/apps/mobile/.env.example`,r)}}import{join as qo}from"path";var Jo=`# Every port is published on 127.0.0.1 only: these development services run with fixed credentials
|
|
799
804
|
# or none, so nothing else on your network should reach them.
|
|
800
|
-
`;async function
|
|
805
|
+
`;async function Un(e){let t=rt(e),r=[],n=[];if(t.includes("postgres")&&(r.push(` postgres:
|
|
801
806
|
image: postgres:18-alpine
|
|
802
807
|
restart: unless-stopped
|
|
803
808
|
ports:
|
|
@@ -856,7 +861,7 @@ ${On(e,"example")}`),e.mobile){let r=Vo(e);await l(`${e.projectDir}/apps/mobile/
|
|
|
856
861
|
extra_hosts:
|
|
857
862
|
- "host.docker.internal:host-gateway"`)}let o=`name: ${`${e.projectName}-infra`}
|
|
858
863
|
|
|
859
|
-
${
|
|
864
|
+
${Jo}services:
|
|
860
865
|
${r.join(`
|
|
861
866
|
|
|
862
867
|
`)}
|
|
@@ -864,22 +869,22 @@ ${r.join(`
|
|
|
864
869
|
volumes:
|
|
865
870
|
${n.join(`
|
|
866
871
|
`)}
|
|
867
|
-
`),await l(
|
|
868
|
-
`)}import{readFile as
|
|
869
|
-
export const pool = db.$client;`,
|
|
872
|
+
`),await l(qo(e.projectDir,"infra/docker-compose.yml"),o)}import{join as Xo}from"path";var At="Next.js";function Zo(e){let t=[];if(t.push({type:"node-terminal",request:"launch",name:"Dev",command:"pnpm dev",cwd:"${workspaceFolder}",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development"}}),e.architecture==="separate"&&t.push({type:"node-terminal",request:"launch",name:"Backend",command:"pnpm dev",cwd:"${workspaceFolder}/apps/backend",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development"}}),t.push({type:"node-terminal",request:"launch",name:At,command:"pnpm dev",cwd:"${workspaceFolder}/apps/web",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development"}}),e.docs&&t.push({type:"node-terminal",request:"launch",name:"Docs",command:"pnpm dev",cwd:"${workspaceFolder}/apps/docs",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development"}}),e.desktop){let r=e.architecture==="separate"?"http://localhost:3010":"http://localhost:3000/api";t.push({type:"node-terminal",request:"launch",name:"Desktop",command:"pnpm dev",cwd:"${workspaceFolder}/apps/desktop",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development",BASE_URL:"http://localhost:3000",PUBLIC_API_URL:r}})}if(t.push({type:"node-terminal",request:"launch",name:"Inngest",command:"pnpm dev:inngest",cwd:"${workspaceFolder}",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development"}}),t.push({type:"node-terminal",request:"launch",name:"Mail",command:"pnpm dev:mail",cwd:"${workspaceFolder}",skipFiles:["<node_internals>/**"],env:{NODE_ENV:"development"}}),e.paymentProvider==="stripe"){let r=e.architecture==="separate"?"localhost:3010/auth/stripe/webhook":"localhost:3000/api/auth/stripe/webhook";t.push({type:"node-terminal",request:"launch",name:"Stripe",command:`stripe listen --forward-to ${r}`,cwd:"${workspaceFolder}",skipFiles:["<node_internals>/**"]})}return t}function Qo(e){let t=[];return e.architecture==="separate"?t.push({name:`Dev (${At} + Backend + Inngest)`,configurations:["Backend",At,"Inngest"]}):t.push({name:`Dev (${At} + Inngest)`,configurations:[At,"Inngest"]}),t}async function Fn(e){let t={version:"0.2.0",configurations:Zo(e),compounds:Qo(e)};await l(Xo(e.projectDir,".vscode/launch.json"),`${JSON.stringify(t,null," ")}
|
|
873
|
+
`)}import{readFile as Bn}from"fs/promises";import{join as Kn}from"path";var Pr='import { drizzle } from "drizzle-orm/node-postgres";',Ar=`export const db = drizzle(parsed.data.DATABASE_URL, { schema });
|
|
874
|
+
export const pool = db.$client;`,ea={postgres:{importLine:Pr,instantiation:Ar},neon:{importLine:`import { Pool } from "@neondatabase/serverless";
|
|
870
875
|
import { drizzle } from "drizzle-orm/neon-serverless";`,instantiation:`const pool = new Pool({ connectionString: parsed.data.DATABASE_URL });
|
|
871
876
|
export const db = drizzle(pool, { schema });`},supabase:{importLine:`import { drizzle } from "drizzle-orm/postgres-js";
|
|
872
877
|
import postgres from "postgres";`,instantiation:`const client = postgres(parsed.data.DATABASE_URL);
|
|
873
|
-
export const db = drizzle(client, { schema });`}};async function
|
|
878
|
+
export const db = drizzle(client, { schema });`}};async function Gn(e){let t=Kn(e.projectDir,"packages/database/src/index.ts"),r=await Bn(t,"utf-8");if(!r.includes(Pr)||!r.includes(Ar))throw new Error("generateDbDriver: boilerplate packages/database/src/index.ts is missing the node-postgres driver anchors (the import line or the `db` instantiation block); the boilerplate drifted.");let n=ea[e.databaseProvider],i=r.replace(Pr,n.importLine).replace(Ar,n.instantiation);await l(t,i),await ra(e)}var Vn='import { Client } from "pg";',Ir=` const client = new Client({ connectionString });
|
|
874
879
|
await client.connect();
|
|
875
880
|
return {
|
|
876
881
|
query: async (text) => ({ rows: (await client.query<LiveColumnRow>(text)).rows }),
|
|
877
882
|
end: () => client.end()
|
|
878
|
-
};`,
|
|
883
|
+
};`,ta={postgres:null,neon:{importLine:'import { Client } from "@neondatabase/serverless";',open:Ir},supabase:{importLine:'import postgres from "postgres";',open:` const sql = postgres(connectionString, { prepare: false });
|
|
879
884
|
return {
|
|
880
885
|
query: async (text) => ({ rows: await sql.unsafe(text) }),
|
|
881
886
|
end: () => sql.end()
|
|
882
|
-
};`}};async function
|
|
887
|
+
};`}};async function ra(e){let t=ta[e.databaseProvider];if(!t)return;let r=Kn(e.projectDir,"packages/database/src/db-verify.ts"),n=await Bn(r,"utf-8");if(!n.includes(Vn)||!n.includes(Ir))throw new Error("generateDbDriver: boilerplate packages/database/src/db-verify.ts is missing the node-postgres verifier anchors (the import line or the openVerifyClient body); the boilerplate drifted.");await l(r,n.replace(Vn,t.importLine).replace(Ir,t.open))}import{join as Hn}from"path";async function Yn(e){e.cacheProvider==="upstash"&&(await na(e),await ia(e))}async function na(e){await l(Hn(e.projectDir,"packages/runtime/src/redis.ts"),`import { Redis } from "@upstash/redis";
|
|
883
888
|
import type { Store } from "hono-rate-limiter";
|
|
884
889
|
import { env } from "./env";
|
|
885
890
|
|
|
@@ -1091,7 +1096,7 @@ export function subscribeRedisChannel(
|
|
|
1091
1096
|
|
|
1092
1097
|
/** No persistent connection to close with Upstash REST. */
|
|
1093
1098
|
export async function closeRedis(): Promise<void> {}
|
|
1094
|
-
`)}async function
|
|
1099
|
+
`)}async function ia(e){await l(Hn(e.projectDir,"packages/runtime/src/mutex.ts"),`import { Lock } from "@upstash/lock";
|
|
1095
1100
|
import { redis } from "./redis";
|
|
1096
1101
|
|
|
1097
1102
|
export class MutexTimeoutError extends Error {
|
|
@@ -1169,18 +1174,18 @@ export async function withMutex<T>(
|
|
|
1169
1174
|
});
|
|
1170
1175
|
}
|
|
1171
1176
|
}
|
|
1172
|
-
`)}import{readFile as
|
|
1173
|
-
UPSTASH_REDIS_REST_TOKEN: z.string(),`;async function
|
|
1177
|
+
`)}import{readFile as sa}from"fs/promises";import{join as oa}from"path";var Wn=" REDIS_URL: z.string(),",aa=` UPSTASH_REDIS_REST_URL: z.string(),
|
|
1178
|
+
UPSTASH_REDIS_REST_TOKEN: z.string(),`;async function zn(e){let t=oa(e.projectDir,"packages/runtime/src/env.ts"),r=await sa(t,"utf-8");if(!r.includes(Wn))throw new Error("generateEnvSchema: boilerplate packages/runtime/src/env.ts is missing the REDIS_URL cache binding anchor; the boilerplate drifted.");let n=e.cacheProvider==="upstash"?r.replace(Wn,aa):r;await l(t,n)}import{readFile as ti}from"fs/promises";import{join as M}from"path";import{readFile as _r,rm as ma}from"fs/promises";import{join as He}from"path";import{AsyncLocalStorage as ca}from"async_hooks";import{existsSync as qn}from"fs";import{readFile as Tr,rm as la}from"fs/promises";import{join as pa}from"path";var Rr=new ca;async function Jn(e){let t=[];return await Rr.run(t,e),t}async function Be(e,t){let r=Rr.getStore();if(!r)return t();try{await t()}catch(n){r.push(`${e}: ${n instanceof Error?n.message:String(n)}`)}}function pt(e,t,r){let n=Rr.getStore();if(!n)throw new Error(r);n.push(`${e}: ${t}`)}async function S(e,t,r){let n=pa(e,t);if(!qn(n)){pt(r,t,`${r}: expected ${t} to exist, but it was missing (boilerplate drift).`);return}await la(n,{recursive:!0})}async function Gt(e,t,r){return qn(e)?Tr(e,"utf-8"):(pt(r,t,`${r}: expected ${e} to carry the ${t} seam, but the file is missing (boilerplate drift).`),null)}function da(e){return new RegExp(`^[ \\t]*(?:\\/\\/|\\{\\/\\*|\\*) gsaas:${e}-start(?: \\*\\/\\})?[ \\t]*\\r?\\n[\\s\\S]*?^[ \\t]*(?:\\/\\/|\\{\\/\\*|\\*) gsaas:${e}-end(?: \\*\\/\\})?[ \\t]*\\r?\\n`,"gm")}function Ke(e,t,r,n){let i=da(r);if(e.match(i)===null)return pt(n,`${r} markers in ${t}`,`${n}: expected gsaas ${r} markers in ${t}, but found none (boilerplate drift).`),e;let o=e.replace(i,"");if(o.includes(`gsaas:${r}-start`)||o.includes(`gsaas:${r}-end`))throw new Error(`${n}: an unbalanced gsaas ${r} marker is left in ${t} (boilerplate drift).`);return o.replace(/\n{3,}/g,`
|
|
1174
1179
|
|
|
1175
|
-
`).replace(/,(\r?\n[ \t]*[\]})])/g,"$1")}async function A(e,t,r,n,i){let o=await
|
|
1176
|
-
`)}function
|
|
1180
|
+
`).replace(/,(\r?\n[ \t]*[\]})])/g,"$1")}async function A(e,t,r,n,i){let o=await Gt(e,n,i);if(o===null)return;let s=o.indexOf(t);if(s===-1){pt(i,n,`${i}: expected to find the ${n} seam, but it was missing (boilerplate drift).`);return}if(o.includes(t,s+t.length))throw new Error(`${i}: the ${n} seam appears more than once (boilerplate drift).`);await l(e,o.slice(0,s)+r+o.slice(s+t.length))}async function Ge(e,t,r,n){let i=/\n([\t ]+)"/.exec(await Tr(e,"utf-8"))?.[1];if(i!==r){let o=s=>s===" "?"tab":`${s.length}-space`;throw new Error(`${n}: expected ${e} to be ${o(r)}-indented, but it is ${i===void 0?"not indented":o(i)}-indented (boilerplate drift). Re-serializing it with the wrong indent would reformat the whole file.`)}await l(e,`${JSON.stringify(t,null,r)}
|
|
1181
|
+
`)}function ua(e){let t="",r=0;for(;r<e.length;){let n=e[r],i=e[r+1];if(n==="/"&&i==="/"){for(;r<e.length&&e[r]!==`
|
|
1177
1182
|
`;)r++;continue}if(n==="/"&&i==="*"){for(r+=2;r<e.length&&!(e[r]==="*"&&e[r+1]==="/");)e[r]===`
|
|
1178
1183
|
`&&(t+=`
|
|
1179
1184
|
`),r++;r+=2;continue}if(n==='"'||n==="'"||n==="`"){let o=n;for(r++;r<e.length&&e[r]!==o;)e[r]==="\\"?r++:e[r]===`
|
|
1180
1185
|
`&&(t+=`
|
|
1181
|
-
`),r++;r++;continue}t+=n,r++}return t}async function
|
|
1182
|
-
`,r=await
|
|
1183
|
-
...sentryExpoPlugin()`,
|
|
1186
|
+
`),r++;r++;continue}t+=n,r++}return t}async function Xn(e){let t=`import { config } from "@repo/config";
|
|
1187
|
+
`,r=await Tr(e,"utf-8");if(!r.includes(t))return;let n=r.replace(t,""),i=ua(n);/\bconfig\b/.test(i)||await l(e,n)}var Ye="stripMobileObservability",Zn=["apps/mobile/lib/observability.ts","apps/mobile/types/env.d.ts","apps/mobile/tests/settings-privacy-screen.test.tsx"],Qn="apps/mobile/tests/observability.test.ts",ha="mobile-obs-any",fa=["apps/mobile/tests/settings-privacy-screen.test.tsx"],Ht={sentry:["@sentry/react-native","@sentry/cli"],posthog:["posthog-react-native"]},ga=`,
|
|
1188
|
+
...sentryExpoPlugin()`,ya=["apps/mobile/app.config.ts"],ba="|@sentry/react-native",wa=` * DUAL-PROVIDER, the way \`packages/observability\` is. This repo carries the Sentry and the PostHog
|
|
1184
1189
|
* halves at once so dev and the test suite exercise both. A generated project carries only the
|
|
1185
1190
|
* providers its \`observability\` manifest option names: the CLI removes the other one's marked region
|
|
1186
1191
|
* from this file, its SDK from \`apps/mobile/package.json\` and, for Sentry, its Expo config plugin
|
|
@@ -1191,7 +1196,7 @@ export async function withMutex<T>(
|
|
|
1191
1196
|
* cross-provider \`{@link}\` and every paragraph about one provider's credentials sits INSIDE that
|
|
1192
1197
|
* provider's own region, and what is left between them is provider-neutral - the {@link PROVIDERS}
|
|
1193
1198
|
* list and the two exported entry points that walk it, which is what a project generated with
|
|
1194
|
-
* \`observability: []\` keeps and starts nothing with.`,
|
|
1199
|
+
* \`observability: []\` keeps and starts nothing with.`,va='import { readPrivacySettings, type PrivacySettings } from "@/lib/privacy";',ka='import type { PrivacySettings } from "@/lib/privacy";';function Ea(e){let t=e.map(n=>n==="sentry"?"Sentry":"PostHog").join(" and ");return`${e.length===0?` * Your project was generated with observability OFF, so this app received no reporting adapter
|
|
1195
1200
|
* and no reporting SDK: {@link PROVIDERS} is empty, and both functions below are no-ops that load
|
|
1196
1201
|
* nothing and send nothing.`:` * This app reports to ${t}. No other provider's start, SDK or Expo config plugin was
|
|
1197
1202
|
* generated, so there is nothing here for Metro to fold away and nothing for pnpm to install.`}
|
|
@@ -1199,9 +1204,9 @@ export async function withMutex<T>(
|
|
|
1199
1204
|
* To change providers, edit \`observability\` in .generatesaas/manifest.json and run
|
|
1200
1205
|
* \`generatesaas update\`: re-shaping brings that provider's half of this file, its SDK and its env
|
|
1201
1206
|
* key back. Pasting the other provider's credential into \`config.observability\` on its own cannot -
|
|
1202
|
-
* the start it would need is not here.`}async function
|
|
1203
|
-
`)}function X(e,t){for(let r of t)delete e.dependencies?.[r],delete e.devDependencies?.[r]}function
|
|
1204
|
-
`))}}import{readFile as
|
|
1207
|
+
* the start it would need is not here.`}async function ei(e){if(!e.mobile)return;let t=e.projectDir,r=["sentry","posthog"].filter(o=>!e.observability.includes(o));e.observability.length===0&&await ma(He(t,Qn),{force:!0});let n=e.observability.length===0?Zn:[...Zn,Qn];for(let o of r)for(let s of n){let a=He(t,s);await l(a,Ke(await _r(a,"utf-8"),s,`mobile-obs-${o}`,Ye))}if(e.observability.length===0)for(let o of fa){let s=He(t,o);await l(s,Ke(await _r(s,"utf-8"),o,ha,Ye))}if(r.includes("sentry")){for(let o of ya){let s=He(t,o);await l(s,Ke(await _r(s,"utf-8"),o,"mobile-obs-sentry",Ye))}await A(He(t,"apps/mobile/app.config.ts"),ga,"","app.config.ts Sentry Expo plugin",Ye),await A(He(t,"apps/mobile/jest.config.js"),ba,"","jest.config.js Sentry transform allowance",Ye)}let i=He(t,"apps/mobile/lib/observability.ts");await A(i,wa,Ea(e.observability),"lib/observability.ts dual-provider note",Ye),e.observability.length===0&&(await A(i,va,ka,"lib/observability.ts privacy import",Ye),await Xn(i))}var dt={"@upstash/redis":"^1.37.0","@upstash/lock":"^0.2.1","@neondatabase/serverless":"^1.0.1",postgres:"^3.4.7"};async function ne(e){let t=await ti(e,"utf-8");return JSON.parse(t)}async function ie(e,t){let r=/\n([\t ]+)"/.exec(await ti(e,"utf-8"))?.[1]??" ";await l(e,`${JSON.stringify(t,null,r)}
|
|
1208
|
+
`)}function X(e,t){for(let r of t)delete e.dependencies?.[r],delete e.devDependencies?.[r]}function Sa(e){e.dependencies&&Object.keys(e.dependencies).length===0&&delete e.dependencies,e.devDependencies&&Object.keys(e.devDependencies).length===0&&delete e.devDependencies}function We(e,t,r,n=!1){let i=n?"devDependencies":"dependencies";e[i]||(e[i]={}),e[i][t]=r}async function ri(e){await Aa(e),await Ia(e),await Ta(e),await xa(e),await Da(e),await ja(e),await Pa(e)}async function Pa(e){if(!e.mobile){let t=M(e.projectDir,"packages/auth/package.json"),r=await ne(t);X(r,["@better-auth/expo"]),await ie(t,r);let n=M(e.projectDir,"tooling/styles/package.json"),i=await ne(n);X(i,["tsx"]),Sa(i),await ie(n,i)}if(e.mobile&&e.mobilePurchases!=="revenuecat"){let t=M(e.projectDir,"apps/mobile/package.json"),r=await ne(t);X(r,["react-native-purchases","react-native-purchases-ui"]),await ie(t,r)}}async function Aa(e){let t=M(e.projectDir,"packages/api/package.json"),r=await ne(t);X(r,["sharp","@types/sharp"]),e.cacheProvider==="upstash"&&(X(r,["ioredis"]),We(r,"@upstash/redis",dt["@upstash/redis"],!0),We(r,"@upstash/lock",dt["@upstash/lock"],!0)),await ie(t,r)}async function Ia(e){let t=M(e.projectDir,"apps/web/package.json"),r=await ne(t);X(r,["@upstash/ratelimit","@upstash/redis"]),await ie(t,r)}async function Ta(e){let t=M(e.projectDir,"packages/runtime/package.json"),r=await ne(t);e.cacheProvider==="upstash"&&(X(r,["ioredis","rate-limit-redis","redis-semaphore"]),We(r,"@upstash/redis",dt["@upstash/redis"]),We(r,"@upstash/lock",dt["@upstash/lock"])),await ie(t,r)}var Or={sentry:["@sentry/node","@sentry/browser","@sentry/electron"],posthog:["posthog-node","posthog-js"]},Ra=["@sentry/electron"],_a=[...Or.sentry,...Or.posthog],Oa=[...Ht.sentry,...Ht.posthog];async function xa(e){let t=M(e.projectDir,"packages/observability/package.json"),r=await ne(t),n=new Set(e.observability.flatMap(a=>Or[a]));if(!e.desktop)for(let a of Ra)n.delete(a);if(X(r,_a.filter(a=>!n.has(a))),await ie(t,r),!e.mobile)return;let i=M(e.projectDir,"apps/mobile/package.json"),o=await ne(i),s=new Set(e.observability.flatMap(a=>Ht[a]));X(o,Oa.filter(a=>!s.has(a))),await ie(i,o)}async function Da(e){let t=M(e.projectDir,"packages/database/package.json"),r=await ne(t);e.databaseProvider==="neon"?(X(r,["pg","@types/pg"]),We(r,"@neondatabase/serverless",dt["@neondatabase/serverless"])):e.databaseProvider==="supabase"&&(X(r,["pg","@types/pg"]),We(r,"postgres",dt.postgres)),await ie(t,r)}var Na=["app/.well-known/oauth-authorization-server/[[...path]]/route.ts","app/.well-known/oauth-protected-resource/[[...path]]/route.ts"];async function Ca(e){let t=await ne(e),r=t.dependencies?.["@repo/api"];r&&(delete t.dependencies?.["@repo/api"],We(t,"@repo/api",r,!0),await ie(e,t))}var La=["instrumentation.ts","tests/instrumentation.test.ts"],$a="tests/api-trailing-slash.test.ts";async function ja(e){if(e.architecture!=="separate")return;let t=M(e.projectDir,"apps/web");await Ve(M(t,"app/api/[[...rest]]/route.ts"),t),await Ve(M(t,$a),t);for(let r of Na)await Ve(M(t,r),t);for(let r of La)await Ve(M(t,r),t);await Ca(M(t,"package.json"))}import{readFile as Ma}from"fs/promises";import{join as Ua}from"path";var Fa=["base.json","node.json","next.json"],ni="GenerateSaaS ";async function ii(e){if(!e.demo)for(let t of Fa){let r=Ua(e.projectDir,"tooling/typescript",t),n;try{n=await Ma(r,"utf-8")}catch{continue}let i=JSON.parse(n);typeof i.display!="string"||!i.display.startsWith(ni)||(i.display=i.display.slice(ni.length),await l(r,`${JSON.stringify(i,null," ")}
|
|
1209
|
+
`))}}import{readFile as ai,rm as Va}from"fs/promises";import{join as It}from"path";async function ci(e){e.cacheProvider==="upstash"&&(await Promise.all([si(It(e.projectDir,"packages/runtime/tests/setup.ts")),si(It(e.projectDir,"packages/mail/tests/setup.ts")),Ka(e.projectDir),Va(It(e.projectDir,"packages/runtime/tests/redis.test.ts"),{force:!0})]),await Ba(e.projectDir))}async function Ba(e){await l(It(e,"packages/runtime/tests/redis.test.ts"),`import { beforeEach, describe, expect, it, vi } from "vitest";
|
|
1205
1210
|
|
|
1206
1211
|
/**
|
|
1207
1212
|
* Regression guards for the Upstash-backed cache layer in src/redis.ts.
|
|
@@ -1334,9 +1339,9 @@ describe("pub/sub", () => {
|
|
|
1334
1339
|
expect(() => stop()).not.toThrow();
|
|
1335
1340
|
});
|
|
1336
1341
|
});
|
|
1337
|
-
`)}async function
|
|
1342
|
+
`)}async function si(e){let t;try{t=await ai(e,"utf-8")}catch{throw new Error(`pruneCacheTests: expected ${e} for the Upstash cache swap (boilerplate drift).`)}let r=t.replace(/\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
1338
1343
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
1339
|
-
`);if(r===t){if(t.includes("UPSTASH_REDIS_REST_URL"))return;throw new Error(`pruneCacheTests: found no REDIS_URL default to swap in ${e} (boilerplate drift).`)}await l(e,r)}var
|
|
1344
|
+
`);if(r===t){if(t.includes("UPSTASH_REDIS_REST_URL"))return;throw new Error(`pruneCacheTests: found no REDIS_URL default to swap in ${e} (boilerplate drift).`)}await l(e,r)}var fe="ioredisCounters",oi="COUNT_UNDER_LIMIT_SCRIPT";async function Ka(e){let t=It(e,"packages/api/tests/setup.ts"),r;try{r=await ai(t,"utf-8")}catch{throw new Error(`pruneCacheTests: expected ${t} for the Upstash cache swap (boilerplate drift).`)}let n=r;n=n.replace(/\tREDIS_URL:\s*"[^"]*",?\n/g,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
1340
1345
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
1341
1346
|
`),n=n.replace(/vi\.mock\("ioredis"[\s\S]*?\n\}\);\n\n?/,""),n=n.replace(/vi\.mock\("rate-limit-redis"[\s\S]*?\n\}\);\n\n?/,""),n=n.replace(/\t\t\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
1342
1347
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
@@ -1345,15 +1350,15 @@ describe("pub/sub", () => {
|
|
|
1345
1350
|
get = vi.fn().mockResolvedValue(null);
|
|
1346
1351
|
mget = vi.fn().mockResolvedValue([]);
|
|
1347
1352
|
set = vi.fn().mockResolvedValue("OK");
|
|
1348
|
-
del = vi.fn(async (key: string) => (${
|
|
1353
|
+
del = vi.fn(async (key: string) => (${fe}.delete(key) ? 1 : 0));
|
|
1349
1354
|
incr = vi.fn(async (key: string) => {
|
|
1350
|
-
const next = (${
|
|
1351
|
-
${
|
|
1355
|
+
const next = (${fe}.get(key) ?? 0) + 1;
|
|
1356
|
+
${fe}.set(key, next);
|
|
1352
1357
|
return next;
|
|
1353
1358
|
});
|
|
1354
1359
|
decr = vi.fn(async (key: string) => {
|
|
1355
|
-
const next = (${
|
|
1356
|
-
${
|
|
1360
|
+
const next = (${fe}.get(key) ?? 0) - 1;
|
|
1361
|
+
${fe}.set(key, next);
|
|
1357
1362
|
return next;
|
|
1358
1363
|
});
|
|
1359
1364
|
expire = vi.fn().mockResolvedValue(1);
|
|
@@ -1361,12 +1366,12 @@ describe("pub/sub", () => {
|
|
|
1361
1366
|
pttl = vi.fn().mockResolvedValue(-1);
|
|
1362
1367
|
scan = vi.fn().mockResolvedValue(["0", []]);
|
|
1363
1368
|
eval = vi.fn(async (script: string, keys: string[], args: (string | number)[]) => {
|
|
1364
|
-
if (script !== ${
|
|
1369
|
+
if (script !== ${oi}) return null;
|
|
1365
1370
|
const key = String(keys[0]);
|
|
1366
1371
|
const limit = Number(args[0]);
|
|
1367
|
-
const next = (${
|
|
1372
|
+
const next = (${fe}.get(key) ?? 0) + 1;
|
|
1368
1373
|
if (next > limit) return -1;
|
|
1369
|
-
${
|
|
1374
|
+
${fe}.set(key, next);
|
|
1370
1375
|
return next;
|
|
1371
1376
|
});
|
|
1372
1377
|
}
|
|
@@ -1381,33 +1386,33 @@ vi.mock("@upstash/lock", () => {
|
|
|
1381
1386
|
return { Lock };
|
|
1382
1387
|
});
|
|
1383
1388
|
|
|
1384
|
-
`;if(n=n.replace(/(^vi\.mock\("@repo\/runtime")/m,`${i}$1`),n===r){if(r.includes("UPSTASH_REDIS_REST_URL"))return;throw new Error(`pruneCacheTests: nothing to rewrite in ${t} for the Upstash swap (boilerplate drift).`)}for(let o of['vi.mock("ioredis"','vi.mock("rate-limit-redis"',"REDIS_URL:"])if(n.includes(o))throw new Error(`pruneCacheTests: ${t} still contains ${o} after the Upstash swap (boilerplate drift).`);for(let o of[`const ${
|
|
1385
|
-
`),
|
|
1389
|
+
`;if(n=n.replace(/(^vi\.mock\("@repo\/runtime")/m,`${i}$1`),n===r){if(r.includes("UPSTASH_REDIS_REST_URL"))return;throw new Error(`pruneCacheTests: nothing to rewrite in ${t} for the Upstash swap (boilerplate drift).`)}for(let o of['vi.mock("ioredis"','vi.mock("rate-limit-redis"',"REDIS_URL:"])if(n.includes(o))throw new Error(`pruneCacheTests: ${t} still contains ${o} after the Upstash swap (boilerplate drift).`);for(let o of[`const ${fe} = new Map`,`${oi},`,`${fe}.clear()`])if(!n.includes(o))throw new Error(`pruneCacheTests: ${t} no longer contains ${o}, which the Upstash mock relies on (boilerplate drift).`);await l(t,n)}import{readFile as Ga}from"fs/promises";var Ha=/^[ \t]*(?:\/\/|\{\/\*|\*) gsaas:[a-z0-9-]+-(?:start|end)(?: \*\/\})?[ \t]*\r?\n/gm,Ya=new Set([".ts",".tsx",".vue",".mjs",".js",".jsx",".md",".mdx"]),li=32;function Wa(e){let t=e.lastIndexOf(".");return t>=0&&Ya.has(e.slice(t))}async function za(e){let t=await Ga(e,"utf-8");if(!t.includes("gsaas:"))return;let r=t.replace(Ha,"");r!==t&&await l(e,r)}async function pi(e){let t=await J(e.projectDir,e.projectDir,r=>r==="node_modules"||r.startsWith("node_modules/")||r===".git"||r.startsWith(".git/"),Wa);for(let r=0;r<t.length;r+=li)await Promise.all(t.slice(r,r+li).map(za))}import{existsSync as qa}from"fs";import{readdir as ut,readFile as ge,rm as Ie}from"fs/promises";import{join as m}from"path";var Ja=new Set(["ci.yml","desktop-release.yml","mobile-release.yml"]),Xa=["apps/web/app/.well-known/apple-app-site-association/route.ts","apps/web/app/.well-known/assetlinks.json/route.ts","apps/web/tests/routes/apple-app-site-association.test.ts","apps/web/tests/routes/assetlinks.test.ts"],Za=["packages/auth/src/config.ts","packages/api/src/routes/internal/index.ts","packages/api/src/index.ts"],Qa=["packages/api/src/routes/internal/index.ts","packages/api/src/routes/inngest.ts","packages/notifications/src/index.ts","packages/config/src/cache.ts"],ec=["packages/notifications/src/push","packages/notifications/tests/push","packages/api/src/routes/internal/push.ts","packages/api/tests/routes/push.test.ts","packages/api/src/functions/notifications/push-dispatch.ts","packages/api/src/functions/notifications/push-receipts.ts","packages/api/src/functions/notifications/push-sink.ts","packages/api/tests/functions/push-dispatch.test.ts","packages/api/tests/functions/push-receipts.test.ts","packages/api/tests/functions/push-sink.test.ts","packages/api/tests/unit/push-store.test.ts","packages/api/tests/routes/push-registry.test.ts","packages/config/tests/push-cache-keys.test.ts"],tc=["packages/payments/src/store","packages/payments/tests/store","packages/payments/tests/helpers/clock.ts","packages/payments/tests/lib/store-claim-ids.test.ts","packages/api/src/routes/internal/webhooks/revenuecat.ts","packages/api/tests/routes/revenuecat-webhook.test.ts","packages/api/tests/routes/revenuecat-webhook-limiter.test.ts","packages/api/tests/routes/revenuecat-interleavings.test.ts","packages/api/tests/lib/revenuecat-claim-recovery.test.ts","packages/api/src/routes/internal/billing-mobile.ts","packages/api/tests/routes/billing-mobile-sync.test.ts","packages/api/tests/routes/billing-mobile-mount.test.ts","packages/api/src/functions/billing/revenuecat-reconcile.ts","packages/api/src/functions/billing/revenuecat-reconcile-entity.ts","packages/api/tests/functions/revenuecat-reconcile.test.ts"],rc=["packages/api/src/routes/internal/index.ts","packages/api/src/routes/inngest.ts","packages/api/src/index.ts","packages/payments/src/index.ts","packages/config/src/cache.ts"],nc=["apps/mobile/lib/purchases","apps/mobile/app/(app)/settings/billing/paywall.tsx","apps/mobile/e2e/flows/billing-paywall.yaml","apps/mobile/e2e/flows/billing-purchase.yaml","apps/mobile/e2e/flows/billing-restore.yaml"],ic=[{dir:"apps/mobile/components/billing",prefixes:["paywall","credit-packs","store-"]},{dir:"apps/mobile/tests",prefixes:["purchases-"]}],sc=["apps/mobile/app.config.ts","apps/mobile/app/_layout.tsx","apps/mobile/app/delete-account.tsx","apps/mobile/app/(app)/settings/billing/index.tsx","apps/mobile/components/home/plan-cards.tsx","apps/mobile/lib/api-client.ts","apps/mobile/lib/auth/sign-out.ts","apps/mobile/types/env.d.ts","apps/mobile/tests/api-client.test.ts","apps/mobile/tests/feature-seams.test.ts","apps/mobile/tests/root-layout.test.tsx","apps/mobile/tests/route-manifest.test.ts","apps/mobile/tests/sign-out.test.ts"],oc=[","," {",' file: "billing-paywall.yaml",',' tags: ["purchases"],',' title: "The paywall renders sandbox offerings"'," },"," {",' file: "billing-purchase.yaml",',' tags: ["purchases"],',' title: "A sandbox purchase updates the plan card through the sync route"'," },",' { file: "billing-restore.yaml", tags: ["purchases"], title: "Restore purchases" }',""].join(`
|
|
1390
|
+
`),ac=[["## Billing (store purchases)","","#### Paywall (`billing-paywall.yaml`)","","| `testID` | Element | Flow |","| --- | --- | --- |","| `settings-paywall-screen` | The paywall route's screen root | `billing-paywall.yaml` |","| `billing-paywall-loading` | The offering read's skeleton | `billing-paywall.yaml` |","| `billing-paywall-status-error` | The offering read failed | `billing-paywall.yaml` |","| `billing-paywall-status-retry` | Retry the offering read | `billing-paywall.yaml` |","| `billing-paywall-list` | The list of purchasable packages | `billing-paywall.yaml` |","| `billing-paywall-row-<productId>` | One package row, keyed by store product id | `billing-paywall.yaml` |","| `billing-paywall-row-<productId>-action` | That row's buy control | `billing-purchase.yaml` |","| `billing-paywall-restore` | Restore purchases, from the paywall | `billing-restore.yaml` |","",""].join(`
|
|
1386
1391
|
`),["#### Purchase and restore controls (`billing-purchase.yaml`, `billing-restore.yaml`)","","| `testID` | Element | Flow |","| --- | --- | --- |",'| `billing-upgrade` | The plan card\'s "See plans" link into the paywall | `billing-purchase.yaml` |',"| `billing-restore` | Restore purchases, on the billing page | `billing-restore.yaml` |",'| `billing-restore-lead` | The "Already subscribed?" lead beside it | `billing-restore.yaml` |',"| `billing-manage` | Manage subscription (Customer Center or the store page) | `billing-purchase.yaml` |","| `billing-external-link` | The external purchase link, when the disclosure sheet ships | `billing-purchase.yaml` |","| `billing-external-link-disclosure` | That link's disclosure sheet | `billing-purchase.yaml` |","",""].join(`
|
|
1387
1392
|
`),["#### Credit packs (`billing-purchase.yaml`)","","| `testID` | Element | Flow |","| --- | --- | --- |","| `billing-credit-packs` | The credit packs card | `billing-purchase.yaml` |","| `billing-credit-packs-list` | The pack list | `billing-purchase.yaml` |","| `billing-credit-packs-row-<storeProductId>` | One pack row | `billing-purchase.yaml` |","| `billing-credit-packs-row-<storeProductId>-action` | That pack's buy control | `billing-purchase.yaml` |","| `billing-credit-packs-empty` | No pack is available on this plan | `billing-purchase.yaml` |","| `billing-credit-packs-unavailable` | The store listed none of the configured ids | `billing-purchase.yaml` |","",""].join(`
|
|
1388
|
-
`)],
|
|
1389
|
-
`)}async function
|
|
1390
|
-
`))}async function
|
|
1391
|
-
`)}async function
|
|
1392
|
-
`,"","index.mdx desktop app card",r),await V(
|
|
1393
|
-
`,"","platform meta.json mcp-widgets entry",t),await V(
|
|
1394
|
-
`,"","index.mdx mobile app card",r),await A(
|
|
1395
|
-
`,"","client-architecture.mdx mobile app card",r),await A(
|
|
1396
|
-
`,"","payments index.mdx mobile store billing card",r),await
|
|
1397
|
-
`,"","mobile index.mdx billing card",r),await V(
|
|
1398
|
-
`,"e2e tags.ts purchases inventory entries","stripMobilePurchases")}}import{readFile as
|
|
1393
|
+
`)],cc=["apps/web/app/[locale]/(marketing)/download","apps/web/tests/routes/download-page.test.tsx"],lc=["cli","cli:clean","demo:bench","playground:regen","playground:test","playground:test:repo","playground:test:audit","playground:test:units","playground:test:e2e","playground:test:build","playground:test:mobile","check-types:scripts","ai:parity"];async function di(e){let t=m(e.projectDir,".github/workflows"),r=await ut(t).catch(()=>[]);for(let n of r)Ja.has(n)||await Ie(m(t,n),{recursive:!0,force:!0})}async function pc(e,t){let r=m(e,"package.json"),n=JSON.parse(await ge(r,"utf-8"));if(!n.scripts)return;let i=!1;for(let s of t)s in n.scripts&&(delete n.scripts[s],i=!0);if(!i)return;let o=/\n([\t ]+)"/.exec(await ge(r,"utf-8"))?.[1]??" ";await l(r,`${JSON.stringify(n,null,o)}
|
|
1394
|
+
`)}async function ui(e){await pc(e.projectDir,[...lc])}async function mi(e){let t=m(e.projectDir,"package.json"),r=await ge(t,"utf-8"),n=JSON.parse(r);!n.scripts||!("dev"in n.scripts)||(n.scripts.dev=e.architecture==="separate"?"turbo run dev --continue":"turbo run dev --continue --filter=!backend",await l(t,`${JSON.stringify(n,null," ")}
|
|
1395
|
+
`))}async function hi(e){let t=m(e.projectDir,"package.json"),r=JSON.parse(await ge(t,"utf-8")),n=r.scripts?.test;if(n!=="turbo run test --concurrency=4 && vitest run")throw new Error(`rewriteRootTestScript: expected the root test script to be "turbo run test --concurrency=4 && vitest run", got ${JSON.stringify(n)} (boilerplate drift).`);r.scripts.test="turbo run test --concurrency=4",await l(t,`${JSON.stringify(r,null," ")}
|
|
1396
|
+
`)}async function fi(e){e.docs||await S(e.projectDir,"apps/docs","stripDocsApp")}async function gi(e){let t=m(e.projectDir,"docs/(platform)/meta.json"),r=JSON.parse(await ge(t,"utf-8"));if(r.title!=="GenerateSaaS")throw new Error(`stripUnusedDocsSilo: expected the feature-page group to be titled "GenerateSaaS", found ${JSON.stringify(r.title)} (boilerplate drift).`);r.title=e.appName,await Ge(t,r," ","stripUnusedDocsSilo"),e.desktop||await Ie(m(e.projectDir,"docs/desktop"),{recursive:!0,force:!0}),e.mobile||await Ie(m(e.projectDir,"docs/mobile"),{recursive:!0,force:!0}),await dc(e),await gc(e)}async function V(e,t,r,n){let i=await Gt(e,t,n);i!==null&&await l(e,Ke(i,t,r,n))}async function dc(e){let t=e.projectDir,r="stripUnusedDocsSilo",n=m(t,"docs/(platform)/configuration.mdx"),i=e.desktop;e.desktop||(await A(n,"| Desktop app + device sign-in - see [desktop app](/desktop) |","| Desktop app + device sign-in |","configuration.mdx desktop config-table link",r),await V(n,"configuration.mdx desktop TRUSTED_ORIGINS callout","desktop-origins-docs",r),await A(m(t,"docs/cli/init.mdx"),"the [desktop app](/desktop), AI features","the desktop app, AI features","cli init.mdx desktop app link",r),await V(m(t,"docs/(platform)/payments/organizations.mdx"),"payments organizations.mdx desktop tenancy callout","desktop-tenancy-docs",r),await V(m(t,"docs/(platform)/projects.mdx"),"projects.mdx desktop scoping callout","desktop-projects-docs",r),await V(m(t,"docs/(platform)/client-architecture.mdx"),"client-architecture.mdx desktop card","desktop-architecture-docs",r),await V(m(t,"docs/(platform)/screens.mdx"),"screens.mdx desktop halves","screens-desktop-docs",r),await V(m(t,"docs/(platform)/testing/e2e.mdx"),"testing/e2e.mdx desktop e2e callout","desktop-testing-docs",r),await A(m(t,"docs/(platform)/index.mdx"),` <Card href="/desktop" title="Desktop app" description="Cross-platform desktop app with device sign-in and AI agents." />
|
|
1397
|
+
`,"","index.mdx desktop app card",r),await V(m(t,"docs/(platform)/ai.mdx"),"ai.mdx automation lanes row + section","desktop-lanes-docs",r),await A(m(t,"docs/(platform)/ai.mdx"),"| Creating or changing an automation on the user's computer (desktop) | `create_local_automation`, an `update_local_automation` beyond a rename or a pause, `delete_local_automation` ([how](/desktop/ai#what-runs-and-where)) | No |\n","","ai.mdx device-automation approval row",r)),i||(await V(n,"configuration.mdx desktop-AI paragraph","desktop-ai-docs",r),await A(m(t,"docs/(platform)/navigation.mdx"),"gates the desktop app's Chat and Automations, see [desktop AI](/desktop/ai) |","gates the desktop app's Chat and Automations |","navigation.mdx sidebar-flag agents-row link",r))}async function yi(e){if(e.desktop)return;await S(e.projectDir,"apps/desktop","stripDesktopApp");let t=m(e.projectDir,"packages/i18n/translations");for(let i of await ut(t,{withFileTypes:!0}))i.isDirectory()&&await Ie(m(t,i.name,"desktop.json"),{force:!0});await S(e.projectDir,".github/workflows/desktop-release.yml","stripDesktopApp");for(let i of cc)await S(e.projectDir,i,"stripDesktopApp");await S(e.projectDir,"packages/utils/src/desktop-download.ts","stripDesktopApp"),await S(e.projectDir,"packages/utils/tests/desktop-download.test.ts","stripDesktopApp");let r=m(e.projectDir,"packages/utils/package.json"),n=JSON.parse(await ge(r,"utf-8"));if(!n.exports?.["./desktop-download"])throw new Error("stripDesktopApp: expected packages/utils/package.json to carry the ./desktop-download export");delete n.exports["./desktop-download"],await Ge(r,n," ","stripDesktopApp")}function uc(e){return e.desktop}async function bi(e){uc(e)||await S(e.projectDir,"packages/agent-core","stripDesktopAiRuntimePackages")}var mc=["packages/mcp-widgets","packages/api/src/ai/mcp-apps","packages/api/src/routes/internal/ai/widgets-router.ts","packages/api/tests/routes/mcp-apps.test.ts","packages/api/tests/ai/organization-widgets.test.ts","packages/api/tests/routes/widgets-router.test.ts","packages/app-core/src/mcp-app","packages/app-core/src/test-support/mcp-fake-host.ts","packages/app-core/tests/mcp-app","packages/ui/src/components/mcp-widgets","packages/ui/src/lib/mcp-widgets","packages/ui/src/components/ai/tool-widget.tsx","packages/ui/src/components/ai/tool-widget.test.tsx","packages/ui/src/components/ai/tool-widget-split.test.tsx","docs/(platform)/mcp-widgets.mdx"],xr="gsaas:mcp-apps-start";async function hc(e){let t=[];for(let r of await ut(m(e,"packages"),{withFileTypes:!0}))if(r.isDirectory())for(let n of["src","tests"]){let i=m(e,"packages",r.name,n);if(!qa(i))continue;let o=await J(i,i,s=>s.split("/").includes("node_modules"),s=>/\.(?:ts|tsx)$/.test(s));for(let s of o)(await ge(s,"utf-8")).includes(xr)&&t.push(s)}return t.sort()}async function wi(e){if(e.ai)return;let t="stripMcpApps",r=e.projectDir;for(let o of mc)await S(r,o,"stripMcpApps");let n=await hc(r);n.length===0&&pt(t,`${xr} regions`,`${t}: expected ${xr} regions under packages/<name>/src or tests, but found none (boilerplate drift).`);for(let o of n)await Tt(o,o,"mcp-apps",t);let i=m(r,"packages/i18n/translations");await S(r,"packages/i18n/translations/en/mcp-widgets.json","stripMcpApps");for(let o of await ut(i,{withFileTypes:!0}))o.isDirectory()&&await Ie(m(i,o.name,"mcp-widgets.json"),{force:!0});await A(m(r,"docs/(platform)/meta.json"),` "mcp-widgets",
|
|
1398
|
+
`,"","platform meta.json mcp-widgets entry",t),await V(m(r,"docs/(platform)/external-agent-mcp.mdx"),"external-agent-mcp.mdx widgets paragraph","mcp-apps-docs",t),await V(m(r,"docs/(platform)/ai.mdx"),"ai.mdx widgets under tool rows section","mcp-apps-docs",t)}async function fc(e,t,r,n){let i=await ut(e);for(let o of t){let s=i.filter(a=>a.startsWith(o));if(s.length===0)throw new Error(`${n}: expected ${r} to hold at least one ${o}* entry`);for(let a of s)await Ie(m(e,a),{recursive:!0})}}async function Tt(e,t,r,n){let i=await Gt(e,t,n);i!==null&&await l(e,Ke(i,t,r,n))}async function gc(e){let t=e.projectDir,r="stripUnusedDocsSilo",n=e.mobile&&e.mobilePurchases==="revenuecat";e.mobile||(await A(m(t,"docs/(platform)/index.mdx"),` <Card href="/mobile" title="Mobile app" description="Cross-platform iOS and Android app with push, universal links, and store billing." />
|
|
1399
|
+
`,"","index.mdx mobile app card",r),await A(m(t,"docs/(platform)/configuration.mdx")," - see [mobile app](/mobile)","","configuration.mdx mobile config-table link",r),await A(m(t,"docs/(platform)/client-architecture.mdx"),` <Card href="/mobile" title="Mobile app">The Expo app - the third surface this client core serves.</Card>
|
|
1400
|
+
`,"","client-architecture.mdx mobile app card",r),await A(m(t,"docs/cli/init.mdx"),"The [mobile app](/mobile) (`apps/mobile`, built with Expo)","The mobile app (`apps/mobile`, built with Expo)","cli init.mdx mobile app link",r),await A(m(t,"docs/(platform)/notifications.mdx"),"- **On a phone too.** With the [mobile app](/mobile) shipped and `config.mobile.push.enabled` on, the same notification is delivered to the user's registered devices as a push - see [mobile notifications](/mobile/notifications).\n\n","","notifications.mdx mobile push bullet",r),await A(m(t,"docs/(platform)/authentication/social-oauth.mdx")," - the native flow adds `APPLE_APP_BUNDLE_IDENTIFIER`; without `APPLE_CLIENT_ID` it runs native-only (no web button), see [mobile auth](/mobile/auth) |"," |","social-oauth.mdx Apple native-flow tail",r),await A(m(t,"docs/(platform)/authentication/two-factor-and-passkeys.mdx"),"- **On the [mobile app](/mobile/auth)**, passkeys use the platform's own biometrics and are claimed by the same `.well-known` association files. The app's biometric **App lock** is a separate device gate, never a second factor.\n\n","","two-factor-and-passkeys.mdx mobile passkeys bullet",r),await A(m(t,"docs/(platform)/project-structure.mdx"),"the web, desktop and mobile apps","the web and desktop apps","project-structure.mdx surface list",r),await V(m(t,"docs/(platform)/testing/e2e.mdx"),"testing e2e.mdx mobile Maestro section","mobile-testing-docs",r),await V(m(t,"docs/(platform)/environment-variables/index.mdx"),"environment-variables mobile section","mobile-env-docs",r)),n||(await A(m(t,"docs/(platform)/payments/meta.json"),', "mobile-billing"',"","payments meta.json mobile-billing entry",r),await A(m(t,"docs/(platform)/payments/index.mdx"),` <Card href="/payments/mobile-billing" title="Mobile store billing" description="In-app purchases through RevenueCat, additive to your web provider." />
|
|
1401
|
+
`,"","payments index.mdx mobile store billing card",r),await S(t,"docs/(platform)/payments/mobile-billing.mdx",r)),e.mobile&&!n&&(await A(m(t,"docs/mobile/meta.json"),', "billing"',"","mobile meta.json billing entry",r),await A(m(t,"docs/mobile/index.mdx"),` <Card href="/mobile/billing" title="Billing" description="Store purchases through RevenueCat, and the web-billing shape." />
|
|
1402
|
+
`,"","mobile index.mdx billing card",r),await V(m(t,"docs/mobile/index.mdx"),"mobile index.mdx store-purchases block","mobile-purchases-docs",r),await Ie(m(t,"docs/mobile/billing"),{recursive:!0,force:!0}))}async function vi(e){if(e.mobile)return;await S(e.projectDir,"apps/mobile","stripMobileApp");let t=m(e.projectDir,"packages/i18n/translations");for(let i of await ut(t,{withFileTypes:!0}))i.isDirectory()&&await Ie(m(t,i.name,"mobile.json"),{force:!0});await S(e.projectDir,"packages/i18n/tests/mobile-notification-labels.test.ts","stripMobileApp"),await S(e.projectDir,"packages/i18n/tests/mobile-brand-literals.test.ts","stripMobileApp"),await S(e.projectDir,"packages/i18n/tests/mobile-shared-merge.test.ts","stripMobileApp"),await S(e.projectDir,"packages/auth/tests/expo-plugin.test.ts","stripMobileApp"),await S(e.projectDir,"packages/auth/tests/expo-authorization-allowlist.test.ts","stripMobileApp"),await S(e.projectDir,"packages/auth/src/expo-authorization-allowlist.ts","stripMobileApp"),await S(e.projectDir,".github/workflows/mobile-release.yml","stripMobileApp"),await S(e.projectDir,"tooling/styles/scripts/build-mobile-css.ts","stripMobileApp");let r=m(e.projectDir,"tooling/styles/package.json"),n=JSON.parse(await ge(r,"utf-8"));if(!n.scripts?.["mobile-css"])throw new Error("stripMobileApp: expected tooling/styles/package.json to carry the mobile-css script");delete n.scripts["mobile-css"],Object.keys(n.scripts).length===0&&delete n.scripts,await Ge(r,n," ","stripMobileApp");for(let i of Xa)await Ve(m(e.projectDir,i),m(e.projectDir,"apps/web"));await S(e.projectDir,"packages/api/src/routes/internal/well-known.ts","stripMobileApp"),await S(e.projectDir,"packages/api/tests/routes/well-known-mobile.test.ts","stripMobileApp"),await S(e.projectDir,"packages/api/src/routes/internal/mobile-auth.ts","stripMobileApp"),await S(e.projectDir,"packages/api/tests/routes/mobile-auth.test.ts","stripMobileApp"),await S(e.projectDir,"apps/web/public/images/stores","stripMobileApp");for(let i of Za)await Tt(m(e.projectDir,i),i,"mobile-auth","stripMobileApp");for(let i of Qa)await Tt(m(e.projectDir,i),i,"mobile-push","stripMobileApp");for(let i of ec)await S(e.projectDir,i,"stripMobileApp")}async function ki(e){if(e.mobile&&e.mobilePurchases==="revenuecat")return;for(let n of tc)await S(e.projectDir,n,"stripMobilePurchases");let t=m(e.projectDir,"packages/payments/package.json"),r=JSON.parse(await ge(t,"utf-8"));if(!r.sideEffects?.includes("./src/store/revenuecat/index.ts"))throw new Error("stripMobilePurchases: expected packages/payments/package.json to list the store lane in sideEffects");r.sideEffects=r.sideEffects.filter(n=>n!=="./src/store/revenuecat/index.ts"),await Ge(t,r," ","stripMobilePurchases");for(let n of rc)await Tt(m(e.projectDir,n),n,"mobile-purchases","stripMobilePurchases");if(e.mobile){for(let n of nc)await S(e.projectDir,n,"stripMobilePurchases");for(let{dir:n,prefixes:i}of ic)await fc(m(e.projectDir,n),i,n,"stripMobilePurchases");for(let n of sc)await Tt(m(e.projectDir,n),n,"mobile-purchases","stripMobilePurchases");for(let n of ac)await A(m(e.projectDir,"apps/mobile/e2e/README.md"),n,"","e2e README purchases row block","stripMobilePurchases");await A(m(e.projectDir,"apps/mobile/e2e/tags.ts"),oc,`
|
|
1403
|
+
`,"e2e tags.ts purchases inventory entries","stripMobilePurchases")}}import{readFile as yc}from"fs/promises";import{join as bc}from"path";var Ei=`on:
|
|
1399
1404
|
workflow_run:
|
|
1400
1405
|
workflows: ["Tag Release"]
|
|
1401
1406
|
branches: [main]
|
|
1402
1407
|
types: [completed]
|
|
1403
|
-
workflow_dispatch:`,
|
|
1404
|
-
workflow_dispatch:`;async function
|
|
1408
|
+
workflow_dispatch:`,wc=`on:
|
|
1409
|
+
workflow_dispatch:`;async function Si(e){if(!e.desktop)return;let t=bc(e.projectDir,".github/workflows/desktop-release.yml"),r=await yc(t,"utf8");if(!r.includes(Ei))throw new Error(`Cannot configure the desktop release trigger: the expected workflow_run block was not found in ${t}. The boilerplate workflow may have drifted.`);await l(t,r.replace(Ei,wc))}import{readFile as vc}from"fs/promises";import{join as kc}from"path";var Pi=`on:
|
|
1405
1410
|
workflow_run:
|
|
1406
1411
|
workflows: ["Tag Release"]
|
|
1407
1412
|
branches: [main]
|
|
1408
1413
|
types: [completed]
|
|
1409
|
-
workflow_dispatch:`,
|
|
1410
|
-
workflow_dispatch:`;async function
|
|
1414
|
+
workflow_dispatch:`,Ec=`on:
|
|
1415
|
+
workflow_dispatch:`;async function Ai(e){if(!e.mobile)return;let t=kc(e.projectDir,".github/workflows/mobile-release.yml"),r=await vc(t,"utf8");if(!r.includes(Pi))throw new Error(`Cannot configure the mobile release trigger: the expected workflow_run block was not found in ${t}. The boilerplate workflow may have drifted.`);await l(t,r.replace(Pi,Ec))}import{join as Sc}from"path";async function Ri(e){let t=Pc(e);await l(Sc(e.projectDir,".github/workflows/ci.yml"),t)}function Ii(e){return e.databaseProvider!=="neon"&&e.cacheProvider!=="upstash"}function Ti(e,t,r){return` - uses: actions/upload-artifact@v4
|
|
1411
1416
|
if: \${{ ${r} }}
|
|
1412
1417
|
with:
|
|
1413
1418
|
name: playwright-report-${e}
|
|
@@ -1416,7 +1421,7 @@ vi.mock("@upstash/lock", () => {
|
|
|
1416
1421
|
${t}/test-results
|
|
1417
1422
|
if-no-files-found: ignore
|
|
1418
1423
|
retention-days: 7
|
|
1419
|
-
`}function
|
|
1424
|
+
`}function Pc(e){let t=e.cacheProvider==="upstash",r=t?"":` redis:
|
|
1420
1425
|
image: redis:8-alpine
|
|
1421
1426
|
ports:
|
|
1422
1427
|
- 6379:6379
|
|
@@ -1460,7 +1465,7 @@ ${r} mailpit:
|
|
|
1460
1465
|
# suite's port is derived per checkout - a baked URL would name a port nothing serves.
|
|
1461
1466
|
- name: Start Inngest
|
|
1462
1467
|
run: docker run -d --name inngest --network host inngest/inngest:v1.46.0 inngest dev
|
|
1463
|
-
`,
|
|
1468
|
+
`,p=Ii(e)?`
|
|
1464
1469
|
# The end-to-end suite, on a manual "Run workflow" dispatch only - it builds the app in production
|
|
1465
1470
|
# mode and drives it with Playwright, too slow to pay for on every PR. It needs no keys and no
|
|
1466
1471
|
# internet: the harness preflights the services below, builds and starts the app itself, provisions
|
|
@@ -1495,7 +1500,7 @@ ${a}
|
|
|
1495
1500
|
env:
|
|
1496
1501
|
NODE_OPTIONS: --max-old-space-size=6144
|
|
1497
1502
|
|
|
1498
|
-
${
|
|
1503
|
+
${Ti("web","apps/web","!cancelled()")}`:"\n # No end-to-end job: this project's stack cannot run one in CI without credentials.\n # - a `neon` database talks over a serverless websocket that only reaches a managed endpoint,\n # so a Postgres service container is unreachable from the app;\n # - an `upstash` cache is a hosted REST endpoint, and this file carries no secrets.\n # The suite itself works locally: `pnpm infra` for a project on self-hosted Postgres and Redis,\n # then `pnpm e2e:ci`. To run it here, add a job with those services plus your own credentials as\n # repository secrets, or point a second CI environment at a disposable managed instance.\n",g=e.desktop&&Ii(e)?`
|
|
1499
1504
|
# The DESKTOP end-to-end suite, on a manual "Run workflow" dispatch only: it builds the Electron
|
|
1500
1505
|
# bundles AND a Next production build, which is too slow to pay for on every push. It has its own
|
|
1501
1506
|
# port and its own build directory, so it can never collide with the web job above.
|
|
@@ -1529,7 +1534,7 @@ ${a}
|
|
|
1529
1534
|
env:
|
|
1530
1535
|
NODE_OPTIONS: --max-old-space-size=6144
|
|
1531
1536
|
|
|
1532
|
-
${
|
|
1537
|
+
${Ti("desktop","apps/desktop","failure()")}`:"",k=e.databaseProvider==="neon"?`
|
|
1533
1538
|
# Required for neon: the api suite's embedded Postgres is TCP-only and the neon
|
|
1534
1539
|
# websocket driver cannot reach it. Add this repository secret (any Postgres this
|
|
1535
1540
|
# suite may CREATE DATABASE on - a Neon branch works).
|
|
@@ -1574,7 +1579,7 @@ jobs:
|
|
|
1574
1579
|
# "cancelled", which reads as a mystery rather than as a timeout. 40 is roughly double that.
|
|
1575
1580
|
timeout-minutes: 40
|
|
1576
1581
|
${n} env:
|
|
1577
|
-
CONTENT_API_KEY: test-contentapi-key-16chars${
|
|
1582
|
+
CONTENT_API_KEY: test-contentapi-key-16chars${k}${w}${P}
|
|
1578
1583
|
STORAGE_REGION: test
|
|
1579
1584
|
STORAGE_ENDPOINT: http://test
|
|
1580
1585
|
STORAGE_ACCESS_KEY_ID: test
|
|
@@ -1590,22 +1595,22 @@ ${n} env:
|
|
|
1590
1595
|
- run: pnpm check-types
|
|
1591
1596
|
|
|
1592
1597
|
- run: pnpm test
|
|
1593
|
-
${
|
|
1594
|
-
`))}async function
|
|
1595
|
-
`))}async function
|
|
1596
|
-
// ${
|
|
1598
|
+
${p}${g}`}import{readFile as _i}from"fs/promises";import{existsSync as Ac}from"fs";import{join as Dr}from"path";var Oi="@repo/database";function Ic(e){return e?"pnpm -F @repo/database reset && pnpm -F @repo/database run deploy -- --push":"pnpm -F @repo/database run deploy"}function Tc(e){switch(e){case"fullstack":return"web";case"separate":return"backend";default:{let t=e;throw new Error(`schemaOwnerApp: unhandled architecture "${String(t)}"`)}}}async function Rc(e,t,r){let n=await _i(e,"utf-8"),i=JSON.parse(n),o=i.scripts?.[t];if(!o)throw new Error(`Cannot prepend to missing script "${t}" in ${e}`);o.includes(Oi)||(i.scripts={...i.scripts,[t]:`${r} && ${o}`},await l(e,`${JSON.stringify(i,null," ")}
|
|
1599
|
+
`))}async function _c(e,t){let r=Ac(e)?JSON.parse(await _i(e,"utf-8")):{$schema:"https://openapi.vercel.sh/vercel.json"},n=r.buildCommand?.trim()||"pnpm build";n.includes(Oi)||(r.buildCommand=`${t} && ${n}`,await l(e,`${JSON.stringify(r,null," ")}
|
|
1600
|
+
`))}async function xi(e){let t=Ic(e.demo===!0),r=Tc(e.architecture),n=Dr(e.projectDir,"apps",r);switch(e.deploymentTarget){case"node":await Rc(Dr(n,"package.json"),"start",t);return;case"vercel":await _c(Dr(n,"vercel.json"),t);return;default:{let i=e.deploymentTarget;throw new Error(`generateDeployScripts: unhandled deployment target "${String(i)}"`)}}}import{readFile as Oc}from"fs/promises";import{existsSync as xc}from"fs";import{join as Yt}from"path";var Di=["stripe","polar"],Dc=[...Di,"none"];async function Ni(e){let t=Yt(e.projectDir,"packages/payments/src"),r=e.paymentProvider,i=`// Active payment provider. To switch, change the path below to
|
|
1601
|
+
// ${Dc.filter(o=>o!==r).map(o=>`"./${o}/index"`).join(" or ")} (other folders are kept in place).
|
|
1597
1602
|
export { ops } from "./${r}/index";
|
|
1598
|
-
`;await l(
|
|
1603
|
+
`;await l(Yt(t,"providers/index.ts"),i),await l(Yt(t,"index.ts"),await Nc(t,r))}async function Nc(e,t){let r=Yt(e,"index.ts");if(!xc(r))throw new Error(`generatePaymentBarrel: expected ${r} to exist - did packages/payments move?`);let n=await Oc(r,"utf-8"),i=Di.filter(s=>s!==t);return n.split(`
|
|
1599
1604
|
`).filter(s=>!i.some(a=>s.includes(`./providers/${a}/`))).join(`
|
|
1600
|
-
`)}import{access as
|
|
1605
|
+
`)}import{access as Cc,readFile as qt,rm as Wt}from"fs/promises";import{join as Z}from"path";var Mi=["sentry","posthog"],Nr={sentry:"src/providers/sentry",posthog:"src/providers/posthog"},zt={sentry:["tests/sentry-load-guard.test.ts","tests/sentry-browser-scrub.test.ts"],posthog:["tests/posthog-load-guard.test.ts","tests/llm-analytics.test.ts"]},Lc=["tests/resolution.test.ts","tests/export-isolation.test.ts"],$c=["src/providers/sentry/desktop-main.ts","src/providers/sentry/desktop-renderer.ts","src/resolve-desktop-main.ts","src/resolve-desktop-renderer.ts"],jc=["./desktop-main","./desktop-renderer"],Mc=[`vi.mock("@sentry/electron/main", sdk.factories["@sentry/electron/main"]);
|
|
1601
1606
|
`,`vi.mock("@sentry/electron/renderer", sdk.factories["@sentry/electron/renderer"]);
|
|
1602
|
-
`],
|
|
1607
|
+
`],Uc=[' describeGate("desktop main", "electronMain", async () => {',' describeGate("desktop renderer", "electronRenderer", async () => {',' describe("the desktop main init options", () => {',' describe("the desktop renderer init", () => {'],Ci=`
|
|
1603
1608
|
});
|
|
1604
|
-
`,
|
|
1605
|
-
`).find(a=>a.trim().length>0&&!a.startsWith(`${
|
|
1606
|
-
`&&(s+=1),e.slice(0,n)+e.slice(s)}function
|
|
1609
|
+
`,Fc=" ";async function Ui(e){let t=Z(e.projectDir,"packages/observability");await Li(t,"packages/observability");let r=e.observability,n=r.filter(s=>!K.includes(s));if(n.length>0)throw new Error(`observability names ${JSON.stringify(n)}, which is not a reporting provider. Every entry must be one of: ${K.join(", ")}. Shaping stops here so the project is not left half-stripped.`);for(let s of r)await Li(Z(t,Nr[s]),`packages/observability/${Nr[s]}`);let i=e.desktop?[...ji,...Dl]:ji,o=new Map;for(let s of i)o.set(s.file,await qt(Z(t,s.file),"utf-8"));for(let s of Jc(r,e.desktop))await Xc(t,s);for(let s of Mi)if(!r.includes(s)){await Wt(Z(t,Nr[s]),{recursive:!0,force:!0});for(let a of zt[s])await Wt(Z(t,a),{force:!0})}for(let s of Lc)await Wt(Z(t,s),{force:!0});e.desktop||await Vc(t,r);for(let s of i){let a=o.get(s.file);a!==void 0&&await l(Z(t,s.file),Gc(a,s,r))}}async function Li(e,t){try{await Cc(e)}catch{throw new Error(`generateObservabilityProvider: expected ${t} to exist - did the observability package move?`)}}async function Vc(e,t){for(let i of $c)await Wt(Z(e,i),{force:!0});t.includes("sentry")&&await Bc(e);let r=Z(e,"package.json"),n=JSON.parse(await qt(r,"utf-8"));for(let i of jc){if(!n.exports?.[i])throw new Error(`generateObservabilityProvider: expected packages/observability/package.json to carry the ${i} export`);delete n.exports[i]}await Ge(r,n," ","generateObservabilityProvider")}async function Bc(e){let t=Z(e,zt.sentry[0]),r=await qt(t,"utf-8");r=Cr(r,Mc.map(n=>({find:n,replace:""})),zt.sentry[0]);for(let n of Uc)r=Kc(r,n,zt.sentry[0]);await l(t,r)}function Kc(e,t,r){let n=e.indexOf(t),i=n===-1?-1:e.indexOf(Ci,n);if(n===-1||i===-1)throw new Error(`generateObservabilityProvider: ${r} no longer contains the block this strip removes - re-point the anchor. Missing: ${t.trim()}`);if(e.includes(t,n+t.length))throw new Error(`generateObservabilityProvider: ${r} now opens more than one block with the same line, so this strip cannot tell which one to remove - re-point the anchor. Block: ${t.trim()}`);let o=e.slice(n+t.length,i).split(`
|
|
1610
|
+
`).find(a=>a.trim().length>0&&!a.startsWith(`${Fc} `));if(o!==void 0)throw new Error(`generateObservabilityProvider: ${r} no longer closes the block this strip removes at its own indent - re-point the anchor. Block: ${t.trim()}; first line inside it that is not part of its body: ${o.trim()}`);let s=i+Ci.length;return e[s]===`
|
|
1611
|
+
`&&(s+=1),e.slice(0,n)+e.slice(s)}function Gc(e,t,r){let n=Mi.filter(s=>!r.includes(s)),i=e,o=[];for(let s of n){let a=Hc(i,s);i=a.source,o.push(...a.bindings)}t.dualMode!==!1&&(i=Cr(i,[{find:Wc,replace:zc(r)}],t.file)),i=Cr(i,t.edits(r),t.file);for(let s of n)if(i.includes(`./providers/${s}`))throw new Error(`generateObservabilityProvider: ${t.file} still reaches providers/${s} after the strip - the boilerplate grew an import shape the drop does not know.`);for(let s of o)if(new RegExp(String.raw`\b${s}\b`).test(i))throw new Error(`generateObservabilityProvider: ${t.file} still names ${s}, whose import the strip removed - the boilerplate grew a use the pinned rewrites do not cover.`);return i}function Cr(e,t,r){let n=e;for(let i of t){let o=n.indexOf(i.find);if(o===-1)throw new Error(`generateObservabilityProvider: ${r} no longer contains the text this strip rewrites - re-point the anchor. Missing: ${i.find.split(`
|
|
1607
1612
|
`)[0]}`);if(i.all!==!0&&n.includes(i.find,o+i.find.length))throw new Error(`generateObservabilityProvider: ${r} now contains the text this strip rewrites more than once, so rewriting the first would leave the rest in the buyer's copy - make the anchor unique or mark the edit \`all\`. Ambiguous: ${i.find.split(`
|
|
1608
|
-
`)[0]}`);n=i.all===!0?n.replaceAll(i.find,i.replace):n.replace(i.find,i.replace)}return n}function
|
|
1613
|
+
`)[0]}`);n=i.all===!0?n.replaceAll(i.find,i.replace):n.replace(i.find,i.replace)}return n}function Hc(e,t){let r=new RegExp(String.raw`^import[^;]*?from "\./providers/${t}/[^"]*";\n`,"gm"),n=[];return{source:e.replace(r,o=>(n.push(...Yc(o)),"")),bindings:n}}function Yc(e){let t=/^import\s+(?:type\s+)?(\S(?:[\s\S]*?\S)?)\s+from\s/.exec(e)?.[1]??"",r=[],n=/\{([\s\S]*?)\}/.exec(t);n?.[1]&&r.push(...n[1].split(",").map(s=>s.trim().replace(/^type\s+/,"")).map(s=>s.split(/\s+as\s+/).at(-1)??"").filter(s=>s.length>0));let i=t.replace(/\{[\s\S]*?\}/,"").replace(/,/g," ").trim(),o=/^\*\s+as\s+([A-Za-z_$][\w$]*)$/.exec(i);return o?.[1]?r.push(o[1]):/^[A-Z_$][\w$]*$/i.test(i)&&r.push(i),r}var Wc=" * DUAL-MODE, exactly as `packages/payments/src/providers/index.ts` does it. This repo resolves the\n * provider at RUNTIME so dev and the test suite exercise every one of them. A generated project has\n * exactly one provider, so the CLI overwrites this file with a direct re-export of it and the rest\n * become unreachable and are pruned; the generator is the observability twin of\n * `packages/cli/src/generators/payment-barrel.ts` and lands with the manifest option.";function zc(e){let t=e.map(n=>n==="sentry"?"Sentry":"PostHog").join(" and ");return`${e.length===0?` * Your project was generated with observability OFF, so no provider adapter and no reporting
|
|
1609
1614
|
* SDK were shipped: this file is the whole layer, and every call is a no-op that loads nothing.`:` * Your project reports to ${t}. No other provider's adapter or SDK was generated, so
|
|
1610
1615
|
* there is nothing here for a bundler to fold away and nothing for pnpm to install.`}
|
|
1611
1616
|
*
|
|
@@ -1613,28 +1618,28 @@ export { ops } from "./${r}/index";
|
|
|
1613
1618
|
* run \`generatesaas update\`: re-shaping brings that provider's adapter and its dependency back. The
|
|
1614
1619
|
* update stages nothing while you are already on the latest version, so the switch lands with the
|
|
1615
1620
|
* next release. Pasting the other provider's credential into \`config.observability\` on its own
|
|
1616
|
-
* cannot: the adapter it would need is not here.`}var
|
|
1621
|
+
* cannot: the adapter it would need is not here.`}var $i={source:"src/providers/sentry/browser.ts",name:"SentryBrowserInitOptions",fields:["environment: string;"]},qc={source:"src/providers/sentry/desktop-main.ts",name:"SentryDesktopMainInitOptions",fields:["environment: string;","appIsReady: boolean;"]};function Jc(e,t){return e.includes("sentry")?[]:t?[$i,qc]:[$i]}async function Xc(e,t){let r=await qt(Z(e,t.source),"utf-8"),n=`export interface ${t.name} {
|
|
1617
1622
|
`,i=r.indexOf(n),o=r.indexOf(`
|
|
1618
1623
|
}
|
|
1619
1624
|
`,i);if(i===-1||o===-1)throw new Error(`generateObservabilityProvider: ${t.source} no longer exports ${t.name} - the stand-in this strip emits for a project without Sentry has nothing left to track.`);let s=r.slice(i+n.length,o).split(`
|
|
1620
|
-
`).map(a=>a.trim()).filter(a=>/^[A-Z_$][\w$]*\??: .+;$/i.test(a));if(s.join(" ")!==t.fields.join(" "))throw new Error(`generateObservabilityProvider: ${t.name} now declares [${s.join(" ")}] but the stand-in emitted for a project without Sentry declares [${t.fields.join(" ")}] - update the stand-in so switching providers on an update cannot break a buyer's call site.`)}var
|
|
1621
|
-
`,
|
|
1625
|
+
`).map(a=>a.trim()).filter(a=>/^[A-Z_$][\w$]*\??: .+;$/i.test(a));if(s.join(" ")!==t.fields.join(" "))throw new Error(`generateObservabilityProvider: ${t.name} now declares [${s.join(" ")}] but the stand-in emitted for a project without Sentry declares [${t.fields.join(" ")}] - update the stand-in so switching providers on an update cannot break a buyer's call site.`)}var Zc=" into every browser bundle. `tests/export-isolation.test.ts` walks the real module graph to keep\n * that from ever landing quietly.",Qc=` if (resolveSentryDsn(observability, process.env.SENTRY_DSN)) ops.push(sentryServerOps);
|
|
1626
|
+
`,el=` if (resolveServerPosthogCredentials(observability, process.env)) {
|
|
1622
1627
|
ops.push(posthogServerOps);
|
|
1623
1628
|
}
|
|
1624
|
-
`,
|
|
1629
|
+
`,tl=` if (resolveSentryDsn(config.observability, process.env.SENTRY_DSN)) {
|
|
1625
1630
|
await initSentryServer();
|
|
1626
1631
|
}
|
|
1627
|
-
`,
|
|
1628
|
-
`,
|
|
1629
|
-
`,
|
|
1630
|
-
`,
|
|
1632
|
+
`,rl=` if (observability?.sentry?.dsn) ops.push(sentryBrowserOps);
|
|
1633
|
+
`,nl=` if (observability?.posthog?.publicKey) ops.push(posthogBrowserOps);
|
|
1634
|
+
`,il=` if (config.observability?.sentry?.dsn) await initSentryBrowser(options);
|
|
1635
|
+
`,sl=` if (observability?.posthog?.publicKey && !observability?.sentry?.dsn) {
|
|
1631
1636
|
announceMissingDesktopSdk("posthog");
|
|
1632
1637
|
}
|
|
1633
|
-
`,
|
|
1638
|
+
`,ol=` // PostHog ships no desktop SDK, so a project configured ONLY for PostHog reports nothing here -
|
|
1634
1639
|
// announced rather than silent, because a desktop build that quietly drops every error looks
|
|
1635
1640
|
// identical to one with reporting off.
|
|
1636
|
-
`,
|
|
1637
|
-
`,
|
|
1641
|
+
`,al=`import { createProviderGapAnnouncer } from "./announce";
|
|
1642
|
+
`,cl=`/**
|
|
1638
1643
|
* Say once that the selected provider cannot report from the desktop main process.
|
|
1639
1644
|
*
|
|
1640
1645
|
* A WARNING and never an error: PostHog ships no Electron SDK, and a buyer running PostHog on the
|
|
@@ -1652,7 +1657,7 @@ const announceMissingDesktopSdk = createProviderGapAnnouncer({
|
|
|
1652
1657
|
remedy: "Select sentry to report errors from the desktop app."
|
|
1653
1658
|
});
|
|
1654
1659
|
|
|
1655
|
-
`,
|
|
1660
|
+
`,ll=`/**
|
|
1656
1661
|
* Say once that the selected provider cannot report from the desktop renderer.
|
|
1657
1662
|
*
|
|
1658
1663
|
* A WARNING and never an error: PostHog ships no Electron SDK, and a buyer running PostHog on the
|
|
@@ -1666,33 +1671,33 @@ const announceMissingDesktopSdk = createProviderGapAnnouncer({
|
|
|
1666
1671
|
remedy: "Select sentry to report errors from the desktop app."
|
|
1667
1672
|
});
|
|
1668
1673
|
|
|
1669
|
-
`,
|
|
1670
|
-
`,
|
|
1671
|
-
`,
|
|
1672
|
-
`,
|
|
1674
|
+
`,pl=` const observability = config.observability;
|
|
1675
|
+
`,dl=`import { config } from "@repo/config";
|
|
1676
|
+
`,ul=` // No error-reporting adapter was generated for this project, so there is nothing to arm.
|
|
1677
|
+
`,ml="export type BrowserReportingOptions = SentryBrowserInitOptions;",hl=`export interface BrowserReportingOptions {
|
|
1673
1678
|
/** The deployment environment reports are tagged with. */
|
|
1674
1679
|
environment: string;
|
|
1675
|
-
}`,
|
|
1676
|
-
`,
|
|
1677
|
-
`,
|
|
1680
|
+
}`,fl=` return observability?.sentry?.dsn ? [sentryDesktopMainOps] : [];
|
|
1681
|
+
`,gl=` if (observability?.sentry?.dsn) await initSentryDesktopMain(options);
|
|
1682
|
+
`,yl="export type DesktopMainReportingOptions = SentryDesktopMainInitOptions;",bl=`export interface DesktopMainReportingOptions {
|
|
1678
1683
|
/** The deployment environment reports are tagged with. */
|
|
1679
1684
|
environment: string;
|
|
1680
1685
|
/** Whether Electron's \`app\` has emitted \`ready\` yet. */
|
|
1681
1686
|
appIsReady: boolean;
|
|
1682
|
-
}`,
|
|
1683
|
-
`,
|
|
1684
|
-
`;function
|
|
1685
|
-
`},{find:
|
|
1686
|
-
`},{find:
|
|
1687
|
+
}`,wl=` return observability?.sentry?.dsn ? [sentryDesktopRendererOps] : [];
|
|
1688
|
+
`,vl=` if (observability?.sentry?.dsn) await initSentryDesktopRenderer();
|
|
1689
|
+
`;function Fi(e,t){let r=[];return e.includes("sentry")||r.push({find:t.sentry,replace:""}),e.includes("posthog")||r.push({find:t.posthog,replace:""}),r}function kl(e){let t=[{find:Zc,replace:" into every browser bundle."},...Fi(e,{sentry:Qc,posthog:el})];return e.includes("sentry")||t.push({find:tl,replace:""}),t}function El(e){let t=[...Fi(e,{sentry:rl,posthog:nl})];return e.includes("sentry")||t.push({find:il,replace:""},Sl),t}var Sl={find:ml,replace:hl};function Pl(e){let t=[...Vi(e,cl)];return e.includes("sentry")||t.push({find:fl,replace:` return [];
|
|
1690
|
+
`},{find:gl,replace:Ki(e)},{find:yl,replace:bl}),t.push(...Bi(e)),t}function Al(e){let t=[...Vi(e,ll)];return e.includes("sentry")||t.push({find:wl,replace:` return [];
|
|
1691
|
+
`},{find:vl,replace:Ki(e)}),t.push(...Bi(e)),t}function Vi(e,t){return e.includes("posthog")?[]:[{find:ol,replace:""},{find:sl,replace:"",all:!0},{find:t,replace:""},{find:al,replace:""}]}function Bi(e){return e.length>0?[]:[{find:pl,replace:"",all:!0},{find:dl,replace:""}]}function Ki(e){return e.length>0?"":ul}var Il=` if (!posthogConfigured()) return;
|
|
1687
1692
|
try {
|
|
1688
1693
|
const { captureAiGeneration: capture } = await import("./providers/posthog/llm");
|
|
1689
1694
|
await capture(event);
|
|
1690
1695
|
} catch (reportingError) {
|
|
1691
1696
|
logReportingFailure("[observability] failed to report an AI generation", reportingError);
|
|
1692
1697
|
}
|
|
1693
|
-
`,
|
|
1694
|
-
`,
|
|
1695
|
-
`,
|
|
1698
|
+
`,Tl=` // No PostHog adapter was generated for this project, so there is nothing to report to.
|
|
1699
|
+
`,Rl=` // No PostHog adapter was generated for this project, so there is nothing queued to drain.
|
|
1700
|
+
`,_l=`/**
|
|
1696
1701
|
* Whether PostHog is configured on this server AND this process is the deployment, without touching
|
|
1697
1702
|
* the PostHog folder. The second half is the same \`serverReportingAllowed\` the adapter's own gate
|
|
1698
1703
|
* asks, so a test run or a local build never even loads the SDK to find out it must stay silent.
|
|
@@ -1704,59 +1709,59 @@ function posthogConfigured(): boolean {
|
|
|
1704
1709
|
return Boolean(process.env.POSTHOG_API_KEY || config.observability?.posthog?.publicKey);
|
|
1705
1710
|
}
|
|
1706
1711
|
|
|
1707
|
-
`,
|
|
1712
|
+
`,Ol=` if (!posthogConfigured()) return;
|
|
1708
1713
|
try {
|
|
1709
1714
|
const { flushAiGenerations: flush } = await import("./providers/posthog/llm");
|
|
1710
1715
|
await flush();
|
|
1711
1716
|
} catch (reportingError) {
|
|
1712
1717
|
logReportingFailure("[observability] failed to flush queued AI generations", reportingError);
|
|
1713
1718
|
}
|
|
1714
|
-
`;function
|
|
1719
|
+
`;function xl(e){return e.includes("posthog")?[]:[{find:Il,replace:Tl},{find:Ol,replace:Rl},{find:_l,replace:""},{find:`import { logReportingFailure } from "./logger";
|
|
1715
1720
|
`,replace:""},{find:`import { config } from "@repo/config";
|
|
1716
1721
|
`,replace:""},{find:`import { serverReportingAllowed } from "@repo/utils/reporting";
|
|
1717
|
-
`,replace:""},{find:"export async function captureAiGeneration(event: AiGenerationEvent): Promise<void> {",replace:"export async function captureAiGeneration(_event: AiGenerationEvent): Promise<void> {"},{find:" * @param event - The call to record.",replace:" * @param _event - Ignored: no PostHog adapter was generated for this project."}]}var
|
|
1718
|
-
`),await l(
|
|
1719
|
-
`)}import{relative as
|
|
1720
|
-
`);o(new Error(
|
|
1721
|
-
${
|
|
1722
|
-
`),H.yellow("Start Development"));let i=[];i.push(`App ${H.cyan("http://localhost:3000")}`),e.architecture==="separate"&&i.push(`API ${H.cyan("http://localhost:3010")}`),r.includes("mailpit")&&i.push(`Mailpit ${H.cyan("http://localhost:8025")}`),r.includes("inngest")&&i.push(`Inngest ${H.cyan("http://localhost:8288")}`),
|
|
1723
|
-
`),H.yellow("Dev Tools"));let o=[],s=
|
|
1724
|
-
`),H.yellow("Deployment"))}function
|
|
1725
|
-
`),await Hi(m,m)}await zi(m),await Ki(O,P),n.stop("Project files generated.")}catch(v){n.stop("Generation failed."),S.cancel(N(v)),process.exit(1)}!await qi(m)&&O.demo===!0&&(S.cancel("Lockfile regeneration failed on a demo build - refusing to ship a stale lockfile."),process.exit(1));let B=await Ji(m),ae=O.demo!==!0&&e.dbMigration!==!1,_e=!1;ae&&B&&(await Xi(m),_e=!0);let Oe=B?await Zi(m):!1;await Qi(m),B&&await es(m);let xe=Te("docker"),Xe=ir(O).map(v=>v.key).filter(v=>!O.credentials?.[v]);ts(O,{pnpmInstalled:B,dockerAvailable:xe,skippedCredentials:Xe,baselineMigrationMissing:ae&&!_e,mcpWidgetsUnbuilt:O.ai&&!Oe}),Gr(),S.log.info(ep.dim(`Done in ${((performance.now()-t)/1e3).toFixed(1)}s`))}import{existsSync as Xt}from"fs";import{readFile as ps}from"fs/promises";import{join as ze,resolve as cp}from"path";import*as b from"@clack/prompts";import C from"picocolors";import{mkdtemp as ip,rm as sp}from"fs/promises";import{tmpdir as op}from"os";import{join as ap}from"path";async function $r(e,t,r,n){let i=await ip(ap(op(),"generatesaas-stage-"));try{await Ct(e,t,i),await Yt({...r,projectDir:i}),await Or(i,n)}finally{await sp(i,{recursive:!0,force:!0})}}function ss(e){return e?"ON":"OFF"}var ut="packages/config/src/index.ts";function os(e){let t=e.databaseProvider!==void 0&&e.databaseProvider!=="postgres",r=e.cacheProvider!==void 0&&e.cacheProvider!=="redis";return[...e.dockerServices??[]].filter(n=>!(n==="postgres"&&t)&&!(n==="redis"&&r)).sort()}function as(e){return[...et({databaseProvider:e.databaseProvider??"postgres",cacheProvider:e.cacheProvider??"redis",emailProvider:e.emailProvider??"smtp"})].sort()}var jr=[{key:"errorTracking",severity:"warn",normalize:e=>{e.errorTracking===void 0||e.observability!==void 0||(e.observability=e.errorTracking==="none"?[]:[e.errorTracking])},preserved:()=>!0,describe:()=>"Retired option `errorTracking`: it is now `observability`, an array, because a project may run more than one provider at once. Your recorded choice was migrated across automatically."},{key:"companion",severity:"warn",normalize:e=>{e.companion===void 0||e.runner!==void 0||(e.runner=e.companion)},preserved:()=>!0,describe:()=>"Retired option `companion`: it was renamed to `runner`, and that lane has since been removed. Your recorded choice was migrated across automatically so the removal is reported under one name."},{key:"runner",severity:"warn",preserved:e=>e.runner!==!0,describe:()=>"Retired option `runner`: your project recorded the runner ON, and the paired-device lane is GONE - not moved to config, removed. This update deletes the pairing endpoint, the dispatch transport, the relay, the `/runner/*` routes and the Runners page from your project, so machines your users had paired are no longer reachable from it. Chat and automations keep running on your app's own AI backend (`config.ai`); nothing else about them changes."},{key:"companionSource",severity:"warn",preserved:()=>!1,describe:e=>`Retired option \`companionSource\`: your project recorded a \`${String(e.companionSource)}\` daemon source. The paired-device lane that daemon served has been removed from your project, so there is no daemon left to source.`},{key:"companionName",severity:"warn",preserved:()=>!1,describe:e=>`Retired option \`companionName\`: your project recorded a branded daemon called ${e.companionName}. The paired-device lane is gone, so your project no longer ships an install flow to brand. An existing install on a user's machine keeps running; it has nothing left to pair with here.`},{key:"companionRepoUrl",severity:"warn",preserved:()=>!1,describe:e=>`Retired option \`companionRepoUrl\`: your project pointed its install flow at ${e.companionRepoUrl}. The paired-device lane is gone, so there is no install flow left to point anywhere.`},{key:"companionLocalPath",severity:"warn",preserved:e=>(e.companionLocalPath??"").trim()==="",describe:e=>`Retired option \`companionLocalPath\`: your project recorded a local daemon checkout at ${e.companionLocalPath}. The option is gone, and so is the paired-device lane behind it - nothing in your project is built from a local daemon checkout any more.`},{key:"desktopAutoRelease",severity:"warn",applies:e=>e.desktop===!0,preserved:e=>e.desktopAutoRelease!==!0,describe:()=>"Retired option `desktopAutoRelease`: your project recorded automatic desktop releases, but the release trigger is no longer an option - cutting a release publishes signed installers from your repository and spends your Actions minutes, so it is always deliberate now. The staged `.github/workflows/desktop-release.yml` runs on `workflow_dispatch` only (the Actions tab). Add a `workflow_run` block to it if you want the CI-chained trigger back."},{key:"billingScope",severity:"ask",applies:e=>e.multiTenancy===!0,preserved:e=>e.billingScope!=="organization",describe:()=>"Retired option `billingScope`: your project recorded organization-scoped billing, and organization billing is GONE - not moved to config, removed. Money now lives only on a USER: an organization has no balance, no plan and no payment-provider customer of its own, and a workspace is funded by that organization's OWNER, whose personal balance every credit spent in it is drawn from. Payments already in flight are safe - a webhook arriving with old organization metadata is credited to that organization's owner rather than dropped - but a STORED balance is not: the `credits` and `plan` columns an organization holds them in are going away, and this update does NOT migrate them for you. MOVE every paying organization's credits and plan onto its owner BEFORE you take new checkouts, or that balance goes with the columns. How should this update proceed?"},{key:"socialProviders",severity:"warn",preserved:e=>(e.socialProviders??[]).length===0,describe:e=>`Retired option \`socialProviders\`: your project recorded ${(e.socialProviders??[]).join(", ")}, but it is now a plain config value that starts empty. Add those IDs back to \`config.auth.socialProviders\` in ${ut} or their sign-in buttons stop rendering.`},{key:"mcpServer",severity:"warn",preserved:e=>e.mcpServer!==!0,describe:()=>`Retired option \`mcpServer\`: your project recorded the outward MCP server ON, but its code now ships to every project behind a config gate generated OFF. Set \`config.mcpServer.enabled\` to \`true\` in ${ut} to keep your /mcp endpoint and its settings tab.`},{key:"emailTracking",severity:"ask",preserved:e=>e.emailTracking!==!1,describe:()=>`Retired option \`emailTracking\`: your project recorded email open/click tracking OFF, but it is now a plain config value generated ON. Applying this update as-is starts tracking opens and clicks for every user you mail. Put it back by setting \`config.email.tracking.enabled\` to \`false\` in ${ut}. How should this update proceed?`},{key:"aiBuiltin",severity:"warn",normalize:e=>{e.aiBuiltin===void 0&&e.aiByok!==void 0&&(e.aiBuiltin=e.aiByok===!1)},applies:e=>e.ai===!0,preserved:e=>e.aiBuiltin===ne(e),describe:e=>`Retired option \`aiBuiltin\`: your project recorded built-in AI models ${ss(e.aiBuiltin)}, but it is now a plain config value generated ${ss(ne(e))} for a project ${ne(e)?"with":"without"} a payment provider. Set \`config.ai.builtin\` to \`${String(e.aiBuiltin===!0)}\` in ${ut} to keep your choice.`},{key:"aiByok",severity:"warn",applies:e=>e.ai===!0,preserved:e=>e.aiByok!==!1,describe:()=>`Retired option \`aiByok\`: your project recorded bring-your-own-key AI OFF, but it is now a plain config value generated ON. Set \`config.ai.byok\` to \`false\` in ${ut} to keep it off.`},{key:"dockerServices",severity:"warn",preserved:e=>os(e).join(",")===as(e).join(","),describe:e=>`Retired option \`dockerServices\`: your project recorded ${os(e).join(", ")||"no services"}, but the local Docker services are now DERIVED from your stack - postgres when you self-host Postgres, redis when you self-host Redis, mailpit on SMTP, inngest always - so an inconsistent selection is no longer possible. Your regenerated \`infra/docker-compose.yml\` will contain ${as(e).join(", ")}. Add any extra service back by hand; the file is yours to edit.`},{key:"aiTools",severity:"warn",preserved:e=>(e.aiTools??[]).length===Wr.length,describe:e=>`Retired option \`aiTools\`: your project recorded ${(e.aiTools??[]).join(", ")||"no AI tools"}, but the \`generatesaas-update\` skill bundle now ships to every AI-tool root (${Ye.join(", ")}) so it is there whichever assistant you switch to. Delete the roots you do not use - they are plain text files with no runtime path.`},{key:"blog",severity:"warn",preserved:e=>e.blog!==!1,describe:()=>`Retired option \`blog\`: your project recorded the blog OFF, but content is no longer an option. This update adds the \`/blog\`, \`/alternatives\` and \`/compare\` route code to your project; every one of them 404s until you add a file under \`packages/content/{locale}/{section}/\`, and none of them appears in your navbar, footer, sitemap or llms.txt while it is empty. Delete an entry from \`config.content.sections\` in ${ut} to drop a section for good.`}],Af=jr.map(e=>e.key);function cs(e){for(let t of jr)t.normalize?.(e)}function ls(e){let t=[];for(let r of jr){if(r.normalize?.(e),e[r.key]===void 0)continue;(!r.applies||r.applies(e))&&!r.preserved(e)&&t.push({key:r.key,message:r.describe(e),severity:r.severity}),delete e[r.key]}return t}function ds(e){e.command("update").description("Update AI skill files and stage template updates").allowExcessArguments(!0).option("--cwd <path>","project directory (default: current directory)").option("--answer <id=choice>","answer a question that would otherwise prompt (repeatable), e.g. --answer desktop-migration=keep-ai",lp,[]).action(async(t,r)=>{r.args.length>0&&b.log.warn("`auto` is now the default and the argument is ignored.");let n=pp(t.answer),i=cp(t.cwd??process.cwd()),o=ze(i,me),s;try{s=JSON.parse(await ps(o,"utf-8"))}catch{b.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}s.frontend===sr&&(b.cancel(`This project was generated on the Nuxt frontend (\`.generatesaas/manifest.json\` records \`frontend: "${sr}"\`).
|
|
1722
|
+
`,replace:""},{find:"export async function captureAiGeneration(event: AiGenerationEvent): Promise<void> {",replace:"export async function captureAiGeneration(_event: AiGenerationEvent): Promise<void> {"},{find:" * @param event - The call to record.",replace:" * @param _event - Ignored: no PostHog adapter was generated for this project."}]}var ji=[{file:"src/resolve-server.ts",edits:kl},{file:"src/resolve-browser.ts",edits:El},{file:"src/llm-analytics.ts",edits:xl,dualMode:!1}],Dl=[{file:"src/resolve-desktop-main.ts",edits:Pl},{file:"src/resolve-desktop-renderer.ts",edits:Al}];import{readdir as Nl,readFile as Cl}from"fs/promises";import{join as Gi}from"path";async function Hi(e){if(e.demo)return;let t=e.appName.trim()||e.projectName,r=JSON.stringify(t).slice(1,-1),n=Gi(e.projectDir,"packages/i18n/translations"),i;try{i=await Nl(n)}catch{return}for(let o of i){let s=Gi(n,o,"web.json"),a;try{a=await Cl(s,"utf-8")}catch{continue}let p=a.replaceAll("GenerateSaaS",()=>r);p!==a&&await l(s,p)}}async function Jt(e){let t=e.projectDir,r=n=>Be(n.name,()=>n(e));e.demo||(await Be("removeSampleContent",()=>Pn(t)),await Be("emptyBlogConfig",()=>An(t)),await Be("pruneBlogCategoryTranslations",()=>In(t)),await Be("removeDemoAiTasks",()=>Tn(t))),await Be("sanitizeClaudeSettings",()=>Rn(t)),await r(xn),await r(Nn),await r(Cn),e.demo||await r(Ln),await r(Mn),await r(Un),await r(Fn),await r(Gn),await r(Yn),await r(zn),await r(ri),await r(ii),await r(ci),await r(di),await r(Ri),await r(ui),await r(mi),await r(hi),await r(fi),await r(gi),await r(yi),await r(bi),await r(wi),await r(Si),await r(vi),await r(ki),await r(Ai),await r(xi),await r(Ni),await r(Ui),await r(ei),await r(Hi),await r(pi)}import{basename as Wi,join as zi,relative as $l}from"path";import{createHash as Yi}from"crypto";import{readFile as Ll}from"fs/promises";async function Xt(e){let t=await Ll(e);return Yi("sha256").update(t).digest("hex")}function Lr(e){return Yi("sha256").update(e).digest("hex")}var jl=new Set(["data",q]);function Ml(e){let t=e.split("/");for(let r of t)if(hr.has(r)||fr.has(r)||jl.has(r)||r.startsWith(".env")&&!r.includes("example"))return!0;return!1}function qi(e,t){return{projectName:e.projectName??Wi(t),appName:e.appName??e.projectName??Wi(t),projectDir:t,architecture:e.architecture??"fullstack",paymentProvider:e.paymentProvider??"none",emailProvider:e.emailProvider??"smtp",multiTenancy:e.multiTenancy??!1,projects:e.projects??!1,docs:e.docs??!1,desktop:e.desktop??!1,mobile:e.mobile??!1,mobilePurchases:e.mobilePurchases??"none",ai:e.ai??!1,webAi:e.webAi??!0,revenueSharing:e.revenueSharing??!1,credits:e.credits??!1,defaultCurrency:e.defaultCurrency??"USD",deploymentTarget:e.deploymentTarget??"node",databaseProvider:e.databaseProvider??"postgres",cacheProvider:e.cacheProvider??"redis",observability:e.observability??[],version:e.version,baseUrl:e.baseUrl,credentials:{},demo:!1}}function Ul(e,t){return{version:e.version,initialVersion:e.version,appName:e.appName,projectName:e.projectName,frontend:pn,architecture:e.architecture,paymentProvider:e.paymentProvider,emailProvider:e.emailProvider,multiTenancy:e.multiTenancy,projects:e.projects,docs:e.docs,desktop:e.desktop,mobile:e.mobile,...e.mobile&&re(e)?{mobilePurchases:e.mobilePurchases}:{},ai:e.ai,webAi:e.webAi,credits:e.credits,revenueSharing:e.revenueSharing,defaultCurrency:e.defaultCurrency,deploymentTarget:e.deploymentTarget,databaseProvider:e.databaseProvider,cacheProvider:e.cacheProvider,observability:e.observability,...e.baseUrl?{baseUrl:e.baseUrl}:{},...t&&{licenseToken:t.token,licenseKeyHash:t.keyHash,installId:t.installId}}}async function Ji(e,t){let n=(await J(e.projectDir,e.projectDir,Ml)).sort(),i=await Promise.all(n.map(async a=>[Fe($l(e.projectDir,a)),await Xt(a)])),o=Object.fromEntries(i),s=Ul(e,t);await l(zi(e.projectDir,ue),`${JSON.stringify(s,null," ")}
|
|
1723
|
+
`),await l(zi(e.projectDir,dn),`${JSON.stringify(o,null," ")}
|
|
1724
|
+
`)}import{relative as Fl}from"path";async function mt(e){let r=(await J(e,e,ct)).sort(),n=await Promise.all(r.map(async i=>[Fe(Fl(e,i)),await Xt(i)]));return Object.fromEntries(n)}import{copyFile as Vl,mkdir as Bl,rm as Kl}from"fs/promises";import{dirname as Gl,join as Xi,relative as Hl}from"path";import{existsSync as Yl}from"fs";async function $r(e,t){Yl(t)&&await Kl(t,{recursive:!0,force:!0});let n=(await J(e,e,ct)).map(i=>({file:i,dest:Xi(t,Fe(Hl(e,i)))}));await Promise.all([...new Set(n.map(({dest:i})=>Gl(i)))].map(i=>Bl(i,{recursive:!0}))),await Promise.all(n.map(({file:i,dest:o})=>Vl(i,o)))}async function Zi(e,t){await $r(e,Xi(t,Lt))}import{readdir as Wl,readFile as es}from"fs/promises";import{existsSync as zl}from"fs";import{dirname as ql,join as se,resolve as jr,sep as Mr}from"path";import{fileURLToPath as Jl}from"url";var Xl={"claude-code":".claude/skills",cursor:".cursor/skills",codex:".agents/skills","gemini-cli":".gemini/skills",windsurf:".windsurf/skills"},ze=Object.values(Xl),Ur=["generatesaas-update","generatesaas-translate","generatesaas-og-image","generatesaas-landing-animations"],Zl=ql(Jl(import.meta.url));function Ql(){return Ut(Zl,["skill","content"],"content")}async function Fr(e,t){for(let r of ze){let n=se(e,r);for(let[i,o]of Object.entries(t)){let s=jr(n,i);if(!s.startsWith(n+Mr))continue;let a=se(s,"scripts"),p=se(s,"references");await Vt(a),await Vt(p),await l(se(s,"SKILL.md"),o.skillMd.replaceAll("__SKILL_ROOT__",r));for(let[g,k]of Object.entries(o.scripts)){let w=jr(a,g);w.startsWith(a+Mr)&&await l(w,k)}let h=Object.entries(o.references);h.length===0&&await l(se(p,".gitkeep"),"");for(let[g,k]of h){let w=jr(p,g);w.startsWith(p+Mr)&&await l(w,k)}}}}async function Qi(e){if(!zl(e))return{};let t={};for(let r of await Wl(e))r!==".gitkeep"&&(t[r]=await es(se(e,r),"utf-8"));return t}async function ts(e){let t=Ql(),r={};for(let n of Ur){let i=se(t,n);r[n]={skillMd:await es(se(i,"SKILL.md"),"utf-8"),scripts:await Qi(se(i,"scripts")),references:await Qi(se(i,"references"))}}await Fr(e,r)}import{execFile as ep,execFileSync as tp}from"child_process";import{access as Vr,readFile as rp}from"fs/promises";import{join as Zt}from"path";import*as _ from"@clack/prompts";function Re(e){try{let t=process.platform==="win32"?"where":"which";return tp(t,[e],{stdio:"ignore"}),!0}catch{return!1}}function Te(e,t,r,n=3e5){return new Promise((i,o)=>{ep(e,t,{cwd:r,timeout:n,maxBuffer:50*1024*1024},(s,a,p)=>{if(s){let h=String(a||"").trim(),k=[String(p||"").trim(),h].filter(Boolean).join(`
|
|
1725
|
+
`);o(new Error(k?`${s.message}
|
|
1726
|
+
${k}`:s.message))}else i()})})}async function rs(e){if(!Re("pnpm"))return _.log.warn("pnpm not found. Skipping lockfile regeneration."),!1;try{return await Te("pnpm",["install","--lockfile-only","--no-frozen-lockfile"],e),!0}catch(t){let r=t instanceof Error?t.message:String(t);return _.log.warn(`Lockfile regeneration failed: ${r}`),_.log.warn("Deploys using --frozen-lockfile may fail."),!1}}async function ns(e){if(!Re("pnpm"))return _.log.warn("pnpm not found. Skipping dependency installation."),_.log.info("Install pnpm: https://pnpm.io/installation"),!1;let t=_.spinner();t.start("Installing dependencies (this may take a minute)...");try{return await Te("pnpm",["install"],e),t.stop("Dependencies installed."),!0}catch(r){t.stop("Dependency installation failed.");let n=r instanceof Error?r.message:String(r);return _.log.warn(`pnpm install failed: ${n}`),_.log.warn("You can run it manually later."),!1}}async function is(e){if(!Re("pnpm"))return!1;let t=_.spinner();t.start("Generating baseline database migration...");try{return await Te("pnpm",["-F","@repo/database","generate"],e),t.stop("Baseline migration generated."),!0}catch(r){t.stop("Baseline migration generation failed.");let n=r instanceof Error?r.message:String(r);return _.log.warn(`Could not generate baseline migration: ${n}`),_.log.warn("Run 'pnpm -F @repo/database generate' before your first deploy."),!1}}async function ss(e){if(!Re("pnpm"))return!1;try{await Vr(Zt(e,"packages/mcp-widgets"))}catch{return!1}let t=_.spinner();t.start("Building the MCP widgets...");try{return await Te("pnpm",["-F","@repo/mcp-widgets","widgets:build"],e),t.stop("MCP widgets built."),!0}catch(r){t.stop("MCP widget build failed.");let n=r instanceof Error?r.message:String(r);return _.log.warn(`Could not build the MCP widgets: ${n}`),_.log.warn("Run 'pnpm -F @repo/mcp-widgets widgets:build' and commit the result."),!1}}async function os(e){try{return await Vr(Zt(e,".git")),_.log.info("Git repository already exists, skipping init."),!0}catch{}if(!Re("git"))return _.log.warn("git not found. Skipping repository initialization."),!1;let t=_.spinner();t.start("Initializing git repository...");try{return await Te("git",["init"],e),await Te("git",["add","-A"],e),await Te("git",["commit","--no-verify","-m","Initial commit from GenerateSaaS"],e),t.stop("Git repository initialized."),!0}catch{return t.stop("Git initialization failed."),_.log.warn("You can run git init manually later."),!1}}async function as(e){if(!Re("pnpm"))return!1;try{await Vr(Zt(e,".git"))}catch{return!1}try{let t=JSON.parse(await rp(Zt(e,"package.json"),"utf-8")),r=!!t.devDependencies?.["simple-git-hooks"],n=!!t["simple-git-hooks"];if(!r||!n)return!1}catch{return!1}try{return await Te("pnpm",["exec","simple-git-hooks"],e),!0}catch{return _.log.warn("Could not install git hooks. Run 'pnpm exec simple-git-hooks' manually."),!1}}import*as qe from"@clack/prompts";import H from"picocolors";function cs(e,t){let r=rt(e);t.dockerAvailable||qe.log.warn("Docker not found. Install Docker to run local services: https://docs.docker.com/get-docker/"),t.baselineMigrationMissing&&qe.log.warn("No database migration was generated (the install did not complete). Run `pnpm install` then `pnpm --filter @repo/database generate` and commit the result BEFORE deploying - otherwise your first deploy pushes the schema untracked.");let n=[];n.push(`cd ${e.projectDir}`),t.pnpmInstalled||n.push("pnpm install"),t.mcpWidgetsUnbuilt&&n.push(`pnpm -F @repo/mcp-widgets widgets:build ${H.dim("# then commit the rebuilt widget document")}`),n.push(`pnpm infra ${H.dim(`# ${r.map(a=>Xr[a].label).join(", ")}`)}`),n.push(`pnpm dev ${H.dim("# http://localhost:3000")}`),t.skippedCredentials.length>0&&(n.push(""),n.push(H.dim("Fill in remaining TODO values in .env"))),qe.note(n.join(`
|
|
1727
|
+
`),H.yellow("Start Development"));let i=[];i.push(`App ${H.cyan("http://localhost:3000")}`),e.architecture==="separate"&&i.push(`API ${H.cyan("http://localhost:3010")}`),r.includes("mailpit")&&i.push(`Mailpit ${H.cyan("http://localhost:8025")}`),r.includes("inngest")&&i.push(`Inngest ${H.cyan("http://localhost:8288")}`),qe.note(i.join(`
|
|
1728
|
+
`),H.yellow("Dev Tools"));let o=[],s=np(e);s.length>0&&o.push(`Set in production: ${H.dim(s.join(", "))}`),o.push("pnpm db:setup # Apply the database schema"),o.push(ip(e)),qe.note(o.join(`
|
|
1729
|
+
`),H.yellow("Deployment"))}function np(e){let t=["DATABASE_URL","BETTER_AUTH_SECRET","INNGEST_APP_ID","INNGEST_EVENT_KEY","INNGEST_SIGNING_KEY"];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 ip(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 ht(e){let r=(e.startsWith("v")?e.slice(1):e).match(/^(\d+)\.(\d+)\.(\d+)$/);return r?[Number(r[1]),Number(r[2]),Number(r[3])]:null}function _e(e,t){let r=ht(e),n=ht(t);if(!r||!n)return 0;for(let i=0;i<3;i++)if(r[i]!==n[i])return r[i]-n[i];return 0}function Qt(e,t){return e.versions.find(r=>r.version===t)?.cli}function ls(e){return process.env.GENERATESAAS_TEMPLATE_TARBALL||process.env.GENERATESAAS_TEMPLATE_TARBALL_DIR||process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?!0:ht(e)===null}function er(e,t,r="3.32.0"){if(ls(r))return{ok:!0};let n=Qt(e,e.latest);return!n||ht(n)===null?{ok:!0}:_e(r,n)>=0?{ok:!0}:{ok:!1,message:`Your installed generatesaas CLI (v${r}) is too old for template v${e.latest}, which needs CLI v${n} or newer. Run npx generatesaas@latest ${t} so npm fetches the current CLI. If the release happened minutes ago, npm may still be propagating it - retry shortly.`}}function ps(e,t,r="3.32.0"){if(ls(r))return{ok:!0};let n=Qt(e,t);return!n||ht(n)===null?{ok:!0}:_e(r,n)===0?{ok:!0}:{ok:!1,message:`Template v${t} must be scaffolded by CLI v${n} exactly (the CLI whose generators produced that release). Run npx generatesaas@${n} init.`}}import pp from"picocolors";var dp="a10a6fb9d7cadde32e37dad52059d17b5d2b916b08c76d8fbcc99982e9a3d87f";async function up(e){let t=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(`generatesaas-demo:${e}`)),r=[...new Uint8Array(t).subarray(0,16)].map(n=>n.toString(16).padStart(2,"0")).join("");return`${r.slice(0,8)}-${r.slice(8,12)}-${r.slice(12,16)}-${r.slice(16,20)}-${r.slice(20,32)}`}function ds(e){e.command("init").description("Scaffold a new GenerateSaaS project").argument("[apiKey]","license key (same as --api-key)").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 Q("--architecture <type>","fullstack or separate").choices([...nt])).addOption(new Q("--payment <provider>","payment provider").choices([...it])).addOption(new Q("--email <provider>","email provider").choices([...st])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").option("--projects","enable projects (a switcher that scopes a user's work)").option("--no-projects","disable projects").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--desktop","include the desktop app (apps/desktop, built with Electron)").option("--no-desktop","exclude the desktop app").option("--mobile","include the mobile app (apps/mobile, built with Expo)").option("--no-mobile","exclude the mobile app").addOption(new Q("--mobile-purchases <lane>","in-app purchases in the mobile app: revenuecat adds the store billing lane on top of your web payment provider, none keeps web billing only").choices([...je])).option("--ai","include the AI features (chat, models, automations, integrations)").option("--no-ai","exclude the AI features").option("--web-ai","show the AI features in the web app (the default)").option("--no-web-ai","desktop-first: keep the AI features out of the web app, which is reduced to account, login and billing - the desktop or mobile app is the AI product. Requires --desktop or --mobile, plus --ai").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)").addOption(new Q("--currency <code>","default currency for billing").choices([...ce])).addOption(new Q("--preset <preset>","infrastructure preset: serverless (Vercel + Neon + Upstash) or selfhost (Docker or Node + Postgres + Redis); --deploy/--database/--cache override it piecewise").choices([...$e])).addOption(new Q("--deploy <target>","deployment target").choices([...le])).addOption(new Q("--database <provider>","database provider").choices([...pe])).addOption(new Q("--cache <provider>","cache provider").choices([...de])).option("--observability <providers>",`comma-separated observability providers (${K.join(", ")}); anything unselected ships no SDK`).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 Q("--demo","first-party demo build: keep sample content, mark site non-indexable - requires CI API key").hideHelp()).addOption(new Q("--no-db-migration","skip generating the baseline DB migration (internal: demos/CI/playground)").hideHelp()).action(async(t,r)=>{await mp(t?{...r,apiKey:t}:r)})}async function mp(e){let t=performance.now();qr("3.32.0");let r;try{r=an(e)}catch(v){E.cancel(N(v)),process.exit(1)}let n=E.spinner(),i;try{i=await at({apiKey:e.apiKey,prompt:!e.yes})}catch(v){E.cancel(N(v)),process.exit(1)}e.demo&&Lr(i)!==dp&&(E.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let o=he(i),s,a=async()=>{s=await Ae(o);let v=er(s,"init");if(!v.ok)throw new Error(v.message);return{latestVersion:s.latest,selectedVersion:s.latest,desktopAllowed:s.entitlements?.desktopAllowed??!0,mobileAllowed:s.entitlements?.mobileAllowed??!0}};n.start("Verifying access...");let p,h,g=!0,k=!0;try{({latestVersion:p,selectedVersion:h,desktopAllowed:g,mobileAllowed:k}=await a()),n.stop("Access verified."),Ue(i)}catch(v){if(n.stop("Access verification failed."),v instanceof j&&v.status===401){e.yes&&(E.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),E.log.warning("Invalid API key."),i=await kt(),o=he(i),n.start("Verifying access...");try{({latestVersion:p,selectedVersion:h,desktopAllowed:g,mobileAllowed:k}=await a()),n.stop("Access verified."),Ue(i)}catch(L){n.stop("Access verification failed."),E.cancel(L instanceof j&&L.status===401?"Invalid API key.":N(L)),process.exit(1)}}else E.cancel(N(v)),process.exit(1)}E.log.success(`Latest version: ${p}`),r.desktop===!0&&!g&&(E.cancel("The desktop app is available on the Pro plan and up. Upgrade your plan at generatesaas.com."),process.exit(1)),r.mobile===!0&&!k&&(E.cancel("The mobile app is available on the Pro plan and up. Upgrade your plan at generatesaas.com."),process.exit(1));let w;e.yes?w=cn({...r,...g?{}:{desktop:!1},...k?{}:{mobile:!1}}):w=await ln(r,{desktopAllowed:g,mobileAllowed:k});let P;n.start("Activating license...");try{let v=e.demo&&w.baseUrl?await up(w.baseUrl):crypto.randomUUID(),L=()=>({frontend:dr,version:h,installId:v,projectName:w.projectName,options:gn(w)}),F;try{F=await ur(o,L())}catch(ve){let $=$t(ve);if(!$?.lastAllowedVersion||!s)throw ve;n.stop("License activation failed.");let W=ps(s,$.lastAllowedVersion);if(W.ok||(E.cancel(`${$.message} ${W.message}`),process.exit(1)),e.yes){let z=Qt(s,$.lastAllowedVersion);E.cancel(`${$.message} Re-run ${z?`npx generatesaas@${z} init`:"init"} without --yes to continue with v${$.lastAllowedVersion} (the last version your license covers).`),process.exit(1)}let ke=await E.confirm({message:`Your update window has ended. Continue with v${$.lastAllowedVersion} (the last version your license covers)?`});(E.isCancel(ke)||!ke)&&(E.cancel("Setup cancelled."),process.exit(0)),h=$.lastAllowedVersion,n.start(`Activating license for v${h}...`),F=await ur(o,L())}P={token:F.token,keyHash:Lr(i),installId:F.installId??v},n.stop("License activated.")}catch(v){n.stop("License activation failed."),E.cancel(N(v)),process.exit(1)}let u=lp(w.projectDir);if(sp(u)&&op(u).length>0)if(e.yes)E.log.info(`Directory ${u} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let L=await E.select({message:`Directory ${u} 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(L)||L==="cancel")&&(E.cancel("Setup cancelled."),process.exit(0)),L==="overwrite"&&ap(u,{recursive:!0,force:!0})}let O={...w,projectDir:u,version:h,...e.demo?{docs:!1}:{}};n.start("Downloading template...");try{await jt(o,h,u),n.stop("Template downloaded.")}catch(v){n.stop("Download failed."),E.cancel(N(v)),process.exit(1)}n.start("Generating project files...");try{if(await Jt(O),!e.demo){let v=await mt(u);await l(cp(u,Ct),`${JSON.stringify(v,null," ")}
|
|
1730
|
+
`),await Zi(u,u)}await ts(u),await Ji(O,P),n.stop("Project files generated.")}catch(v){n.stop("Generation failed."),E.cancel(N(v)),process.exit(1)}!await rs(u)&&O.demo===!0&&(E.cancel("Lockfile regeneration failed on a demo build - refusing to ship a stale lockfile."),process.exit(1));let B=await ns(u),oe=O.demo!==!0&&e.dbMigration!==!1,Oe=!1;oe&&B&&(await is(u),Oe=!0);let xe=B?await ss(u):!1;await os(u),B&&await as(u);let De=Re("docker"),Qe=cr(O).map(v=>v.key).filter(v=>!O.credentials?.[v]);cs(O,{pnpmInstalled:B,dockerAvailable:De,skippedCredentials:Qe,baselineMigrationMissing:oe&&!Oe,mcpWidgetsUnbuilt:O.ai&&!xe}),Jr(),E.log.info(pp.dim(`Done in ${((performance.now()-t)/1e3).toFixed(1)}s`))}import{existsSync as tr}from"fs";import{readFile as ys}from"fs/promises";import{join as Je,resolve as bp}from"path";import*as b from"@clack/prompts";import C from"picocolors";import{mkdtemp as hp,rm as fp}from"fs/promises";import{tmpdir as gp}from"os";import{join as yp}from"path";async function Br(e,t,r,n,{olderRelease:i=!1}={}){let o=await hp(yp(gp(),"generatesaas-stage-"));try{await jt(e,t,o);let s=()=>Jt({...r,projectDir:o}),a=[];return i?a=await Jn(s):await s(),await $r(o,n),a}finally{await fp(o,{recursive:!0,force:!0})}}function us(e){return e?"ON":"OFF"}var ft="packages/config/src/index.ts";function ms(e){let t=e.databaseProvider!==void 0&&e.databaseProvider!=="postgres",r=e.cacheProvider!==void 0&&e.cacheProvider!=="redis";return[...e.dockerServices??[]].filter(n=>!(n==="postgres"&&t)&&!(n==="redis"&&r)).sort()}function hs(e){return[...rt({databaseProvider:e.databaseProvider??"postgres",cacheProvider:e.cacheProvider??"redis",emailProvider:e.emailProvider??"smtp"})].sort()}var Kr=[{key:"errorTracking",severity:"warn",normalize:e=>{e.errorTracking===void 0||e.observability!==void 0||(e.observability=e.errorTracking==="none"?[]:[e.errorTracking])},preserved:()=>!0,describe:()=>"Retired option `errorTracking`: it is now `observability`, an array, because a project may run more than one provider at once. Your recorded choice was migrated across automatically."},{key:"companion",severity:"warn",normalize:e=>{e.companion===void 0||e.runner!==void 0||(e.runner=e.companion)},preserved:()=>!0,describe:()=>"Retired option `companion`: it was renamed to `runner`, and that lane has since been removed. Your recorded choice was migrated across automatically so the removal is reported under one name."},{key:"runner",severity:"warn",preserved:e=>e.runner!==!0,describe:()=>"Retired option `runner`: your project recorded the runner ON, and the paired-device lane is GONE - not moved to config, removed. This update deletes the pairing endpoint, the dispatch transport, the relay, the `/runner/*` routes and the Runners page from your project, so machines your users had paired are no longer reachable from it. Chat and automations keep running on your app's own AI backend (`config.ai`); nothing else about them changes."},{key:"companionSource",severity:"warn",preserved:()=>!1,describe:e=>`Retired option \`companionSource\`: your project recorded a \`${String(e.companionSource)}\` daemon source. The paired-device lane that daemon served has been removed from your project, so there is no daemon left to source.`},{key:"companionName",severity:"warn",preserved:()=>!1,describe:e=>`Retired option \`companionName\`: your project recorded a branded daemon called ${e.companionName}. The paired-device lane is gone, so your project no longer ships an install flow to brand. An existing install on a user's machine keeps running; it has nothing left to pair with here.`},{key:"companionRepoUrl",severity:"warn",preserved:()=>!1,describe:e=>`Retired option \`companionRepoUrl\`: your project pointed its install flow at ${e.companionRepoUrl}. The paired-device lane is gone, so there is no install flow left to point anywhere.`},{key:"companionLocalPath",severity:"warn",preserved:e=>(e.companionLocalPath??"").trim()==="",describe:e=>`Retired option \`companionLocalPath\`: your project recorded a local daemon checkout at ${e.companionLocalPath}. The option is gone, and so is the paired-device lane behind it - nothing in your project is built from a local daemon checkout any more.`},{key:"desktopAutoRelease",severity:"warn",applies:e=>e.desktop===!0,preserved:e=>e.desktopAutoRelease!==!0,describe:()=>"Retired option `desktopAutoRelease`: your project recorded automatic desktop releases, but the release trigger is no longer an option - cutting a release publishes signed installers from your repository and spends your Actions minutes, so it is always deliberate now. The staged `.github/workflows/desktop-release.yml` runs on `workflow_dispatch` only (the Actions tab). Add a `workflow_run` block to it if you want the CI-chained trigger back."},{key:"billingScope",severity:"ask",applies:e=>e.multiTenancy===!0,preserved:e=>e.billingScope!=="organization",describe:()=>"Retired option `billingScope`: your project recorded organization-scoped billing, and organization billing is GONE - not moved to config, removed. Money now lives only on a USER: an organization has no balance, no plan and no payment-provider customer of its own, and a workspace is funded by that organization's OWNER, whose personal balance every credit spent in it is drawn from. Payments already in flight are safe - a webhook arriving with old organization metadata is credited to that organization's owner rather than dropped - but a STORED balance is not: the `credits` and `plan` columns an organization holds them in are going away, and this update does NOT migrate them for you. MOVE every paying organization's credits and plan onto its owner BEFORE you take new checkouts, or that balance goes with the columns. How should this update proceed?"},{key:"socialProviders",severity:"warn",preserved:e=>(e.socialProviders??[]).length===0,describe:e=>`Retired option \`socialProviders\`: your project recorded ${(e.socialProviders??[]).join(", ")}, but it is now a plain config value that starts empty. Add those IDs back to \`config.auth.socialProviders\` in ${ft} or their sign-in buttons stop rendering.`},{key:"mcpServer",severity:"warn",preserved:e=>e.mcpServer!==!0,describe:()=>`Retired option \`mcpServer\`: your project recorded the outward MCP server ON, but its code now ships to every project behind a config gate generated OFF. Set \`config.mcpServer.enabled\` to \`true\` in ${ft} to keep your /mcp endpoint and its settings tab.`},{key:"emailTracking",severity:"ask",preserved:e=>e.emailTracking!==!1,describe:()=>`Retired option \`emailTracking\`: your project recorded email open/click tracking OFF, but it is now a plain config value generated ON. Applying this update as-is starts tracking opens and clicks for every user you mail. Put it back by setting \`config.email.tracking.enabled\` to \`false\` in ${ft}. How should this update proceed?`},{key:"aiBuiltin",severity:"warn",normalize:e=>{e.aiBuiltin===void 0&&e.aiByok!==void 0&&(e.aiBuiltin=e.aiByok===!1)},applies:e=>e.ai===!0,preserved:e=>e.aiBuiltin===re(e),describe:e=>`Retired option \`aiBuiltin\`: your project recorded built-in AI models ${us(e.aiBuiltin)}, but it is now a plain config value generated ${us(re(e))} for a project ${re(e)?"with":"without"} a payment provider. Set \`config.ai.builtin\` to \`${String(e.aiBuiltin===!0)}\` in ${ft} to keep your choice.`},{key:"aiByok",severity:"warn",applies:e=>e.ai===!0,preserved:e=>e.aiByok!==!1,describe:()=>`Retired option \`aiByok\`: your project recorded bring-your-own-key AI OFF, but it is now a plain config value generated ON. Set \`config.ai.byok\` to \`false\` in ${ft} to keep it off.`},{key:"dockerServices",severity:"warn",preserved:e=>ms(e).join(",")===hs(e).join(","),describe:e=>`Retired option \`dockerServices\`: your project recorded ${ms(e).join(", ")||"no services"}, but the local Docker services are now DERIVED from your stack - postgres when you self-host Postgres, redis when you self-host Redis, mailpit on SMTP, inngest always - so an inconsistent selection is no longer possible. Your regenerated \`infra/docker-compose.yml\` will contain ${hs(e).join(", ")}. Add any extra service back by hand; the file is yours to edit.`},{key:"aiTools",severity:"warn",preserved:e=>(e.aiTools??[]).length===Qr.length,describe:e=>`Retired option \`aiTools\`: your project recorded ${(e.aiTools??[]).join(", ")||"no AI tools"}, but the \`generatesaas-update\` skill bundle now ships to every AI-tool root (${ze.join(", ")}) so it is there whichever assistant you switch to. Delete the roots you do not use - they are plain text files with no runtime path.`},{key:"blog",severity:"warn",preserved:e=>e.blog!==!1,describe:()=>`Retired option \`blog\`: your project recorded the blog OFF, but content is no longer an option. This update adds the \`/blog\`, \`/alternatives\` and \`/compare\` route code to your project; every one of them 404s until you add a file under \`packages/content/{locale}/{section}/\`, and none of them appears in your navbar, footer, sitemap or llms.txt while it is empty. Delete an entry from \`config.content.sections\` in ${ft} to drop a section for good.`}],Ff=Kr.map(e=>e.key);function fs(e){for(let t of Kr)t.normalize?.(e)}function gs(e){let t=[];for(let r of Kr){if(r.normalize?.(e),e[r.key]===void 0)continue;(!r.applies||r.applies(e))&&!r.preserved(e)&&t.push({key:r.key,message:r.describe(e),severity:r.severity}),delete e[r.key]}return t}function bs(e){e.command("update").description("Update AI skill files and stage template updates").allowExcessArguments(!0).option("--cwd <path>","project directory (default: current directory)").option("--answer <id=choice>","answer a question that would otherwise prompt (repeatable), e.g. --answer desktop-migration=keep-ai",wp,[]).action(async(t,r)=>{r.args.length>0&&b.log.warn("`auto` is now the default and the argument is ignored.");let n=vp(t.answer),i=bp(t.cwd??process.cwd()),o=Je(i,ue),s;try{s=JSON.parse(await ys(o,"utf-8"))}catch{b.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}s.frontend===lr&&(b.cancel(`This project was generated on the Nuxt frontend (\`.generatesaas/manifest.json\` records \`frontend: "${lr}"\`).
|
|
1726
1731
|
|
|
1727
|
-
v${
|
|
1732
|
+
v${pr} is the last release that ships a Nuxt frontend, and this CLI cannot update or migrate a Nuxt project to Next.js.
|
|
1728
1733
|
|
|
1729
|
-
Your project keeps working exactly as it is - stay on v${
|
|
1734
|
+
Your project keeps working exactly as it is - stay on v${pr}, or start a fresh project on Next.js with ${C.cyan("generatesaas init")} when you are ready to move.`),process.exit(1));let a=tn(s);a.length>0&&(b.cancel(`.generatesaas/manifest.json carries a value this CLI cannot shape a project from:
|
|
1730
1735
|
|
|
1731
|
-
${a.map(
|
|
1736
|
+
${a.map(u=>` - ${u}`).join(`
|
|
1732
1737
|
`)}
|
|
1733
1738
|
|
|
1734
|
-
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1)),
|
|
1739
|
+
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1)),fs(s);let p=sr(s);p.length>0&&(b.cancel(`.generatesaas/manifest.json records a combination this project cannot run:
|
|
1735
1740
|
|
|
1736
|
-
${
|
|
1741
|
+
${p.map(u=>` - ${u}`).join(`
|
|
1737
1742
|
`)}
|
|
1738
1743
|
|
|
1739
|
-
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let h=
|
|
1744
|
+
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let h=nn(s);h.length>0&&(b.cancel(`.generatesaas/manifest.json turns the web AI surface off (\`webAi: false\`) in a project that cannot run without it:
|
|
1740
1745
|
|
|
1741
|
-
${h.map(
|
|
1746
|
+
${h.map(u=>` - ${u}`).join(`
|
|
1742
1747
|
`)}
|
|
1743
1748
|
|
|
1744
|
-
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let g=
|
|
1749
|
+
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let g=sn(s);g.length>0&&(b.cancel(`.generatesaas/manifest.json turns on mobile store purchases (\`mobilePurchases: "revenuecat"\`) in a project that cannot run them:
|
|
1745
1750
|
|
|
1746
|
-
${g.map(
|
|
1751
|
+
${g.map(u=>` - ${u}`).join(`
|
|
1747
1752
|
`)}
|
|
1748
1753
|
|
|
1749
|
-
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let
|
|
1754
|
+
Correct it there, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let k;try{k=await at()}catch(u){b.cancel(N(u)),process.exit(1)}let w=he(k),P=b.spinner();try{P.start("Verifying access...");let u;try{u=await Ae(w)}catch(T){throw T instanceof j&&T.status===401?new Error("Your saved API key was rejected. Run `generatesaas auth` to update it, or set GENERATESAAS_API_KEY."):T}let O=er(u,"update");if(!O.ok)throw new Error(O.message);P.stop("Access verified."),Ue(k),P.start("Fetching latest skill files...");let be=await fn(w,u.latest);await Fr(i,be.skills);let B=ze;if(P.stop("Skills updated."),b.log.success(`Skill files installed to ${C.cyan(B.length.toString())} locations.`),s.version===u.latest){b.log.info(`Already on the latest version (${s.version}).`);return}_e(s.version,u.latest)>0&&(b.cancel(`This project is on ${s.version}, which is newer than the latest release (${u.latest}). Updating would stage the older template over it. Check that your API key points at the right account, or correct \`version\` in ${ue}.`),process.exit(1));let oe=u.entitlements;oe&&(s.desktop&&!oe.desktopAllowed&&(b.cancel("This project includes the desktop app, which is available on the Pro plan and up. Upgrade your plan at generatesaas.com to keep updating it."),process.exit(1)),s.mobile&&oe.mobileAllowed===!1&&(b.cancel("This project includes the mobile app, which is available on the Pro plan and up. Upgrade your plan at generatesaas.com to keep updating it."),process.exit(1)));let Oe=JSON.stringify(s);await kp(s,on(s),n),await Ep(gs(s),n);let xe=en(s),De=rn(s),we=sr(De);we.length>0&&(b.cancel(`.generatesaas/manifest.json is missing a provider key, and its default would create a combination this project cannot run:
|
|
1750
1755
|
|
|
1751
|
-
${we.map(
|
|
1756
|
+
${we.map(T=>` - ${T}`).join(`
|
|
1752
1757
|
`)}
|
|
1753
1758
|
|
|
1754
|
-
Add the key to .generatesaas/manifest.json with a value your deployment target supports, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let
|
|
1755
|
-
`),
|
|
1756
|
-
`);let v=
|
|
1757
|
-
`)}if(P.stop("Baseline template stored."),!z){let
|
|
1758
|
-
`),P.stop("Baseline hashes computed.")}await l(
|
|
1759
|
-
`),b.log.info(`Update staged: ${C.cyan(s.version)} \u2192 ${C.cyan(
|
|
1759
|
+
Add the key to .generatesaas/manifest.json with a value your deployment target supports, then run ${C.cyan("generatesaas update")} again.`),process.exit(1));let Qe=JSON.stringify(De)!==Oe;if(s=De,s.licenseToken)try{let T=await yn(w,{currentToken:s.licenseToken,newVersion:u.latest});s.licenseToken=T.token,T.licenseKeyHash&&(s.licenseKeyHash=T.licenseKeyHash),await l(o,`${JSON.stringify(s,null," ")}
|
|
1760
|
+
`),Qe=!1,b.log.success("License refreshed.")}catch(T){let c=$t(T);c&&(b.cancel(c.message),process.exit(1)),b.log.warn("License refresh skipped.")}Qe&&await l(o,`${JSON.stringify(s,null," ")}
|
|
1761
|
+
`);let v=qi(s,i),L=Je(i,un);P.start(`Staging v${u.latest} (shaped for your config)...`),await Br(w,u.latest,v,L),P.stop("Template staged.");let{text:F,title:ve}=await Ap(w,u,s.version);F&&b.note(F,ve);let $=Je(i,Ct),W=Je(i,Lt),ke=!tr(W),z=!tr($);if(ke){P.start("Building baseline template (one-time migration)...");let T=await Br(w,s.version,v,W,{olderRelease:!0});if(z){let c=await mt(W);await l($,`${JSON.stringify(c,null," ")}
|
|
1762
|
+
`)}if(P.stop("Baseline template stored."),T.length>0&&b.log.info(`v${s.version} predates ${T.length} strip seam(s) of this CLI, so the rebuilt baseline keeps those parts as v${s.version} shipped them.`),!z){let c=await Ip($,W);c>0&&b.log.warn(`Rebuilt baseline differs from the original for ${c} file(s) (the CLI's shaping evolved since this project was scaffolded). Classification still follows the committed template-hashes.json; upstream diffs for those files may include unrelated noise.`)}}else if(z){P.start("Computing baseline template hashes...");let T=await mt(W);await l($,`${JSON.stringify(T,null," ")}
|
|
1763
|
+
`),P.stop("Baseline hashes computed.")}await l(Je(i,mn),`${JSON.stringify({currentVersion:s.version,targetVersion:u.latest,changelog:F,stagedAt:new Date().toISOString(),...xe.length>0?{newOptions:xe}:{}},null," ")}
|
|
1764
|
+
`),b.log.info(`Update staged: ${C.cyan(s.version)} \u2192 ${C.cyan(u.latest)}`),b.log.info(`Ask your AI coding assistant to ${C.cyan("'update my GenerateSaaS project'")}.`),s.desktop===!0&&tr(Je(i,"apps/tauri"))&&b.log.warn(`Desktop: the app moved to an Electron shell (${C.cyan("apps/desktop")}). Your project still has the old Tauri shell (${C.cyan("apps/tauri")}) - remove it after verifying the Electron app builds and runs. See ${C.cyan("/desktop/updates")}.`),s.desktop===!0&&tr(Je(i,"apps/electron"))&&b.log.warn(`Desktop: the app now lives at ${C.cyan("apps/desktop")}. Your project still has the old ${C.cyan("apps/electron")} directory - move your local changes across, remove it, then run ${C.cyan("pnpm install")}. See ${C.cyan("/desktop/updates")}.`)}catch(u){P.stop("Failed."),b.cancel(`Update failed: ${N(u)}`),process.exit(1)}})}var ws="desktop-migration";function wp(e,t){return t.push(e),t}function vp(e){let t=new Set([ws,...Object.keys(ks).map(n=>`retired:${n}`)]),r=new Map;for(let n of e){let i=n.indexOf("=");(i<=0||i===n.length-1)&&(b.cancel(`\`--answer ${n}\` is malformed. Use \`--answer <id>=<choice>\`.`),process.exit(1));let o=n.slice(0,i);t.has(o)||(b.cancel(`\`--answer ${n}\` names a question this update does not ask. Valid ids: ${[...t].join(", ")}.`),process.exit(1)),r.set(o,n.slice(i+1))}return r}async function vs(e,t){let r=t.get(e.id);if(r!==void 0){let n=e.choices.find(i=>i.id===r);return n||(b.cancel(`\`--answer ${e.id}=${r}\` is not a valid choice. Valid choices: ${e.choices.map(i=>i.id).join(", ")}.`),process.exit(1)),n}if(process.stdin.isTTY){let n=await b.select({message:e.message,options:e.choices.map(o=>({value:o.id,label:o.label,...o.hint?{hint:o.hint}:{}}))});b.isCancel(n)&&(b.cancel("Update cancelled. Nothing was changed or staged."),process.exit(1));let i=e.choices.find(o=>o.id===n);return i||(b.cancel("Update cancelled. Nothing was changed or staged."),process.exit(1)),i}b.cancel(`${e.message}
|
|
1760
1765
|
|
|
1761
1766
|
This update is running without an interactive terminal, so it cannot ask you directly. Answer the question \`${e.id}\` and re-run, for example:
|
|
1762
1767
|
|
|
@@ -1764,24 +1769,24 @@ This update is running without an interactive terminal, so it cannot ask you dir
|
|
|
1764
1769
|
|
|
1765
1770
|
Choices:
|
|
1766
1771
|
${e.choices.map(n=>` - ${n.id}: ${n.label}${n.hint?` (${n.hint})`:""}`).join(`
|
|
1767
|
-
`)}`),process.exit(1)}async function
|
|
1772
|
+
`)}`),process.exit(1)}async function kp(e,t,r){if(t.kind==="none")return;let n=Pp[t.kind];(await vs({id:ws,message:n.message,choices:n.choices},r)).apply(e)}var ks={billingScope:[{value:"stage",label:"Stage it - I will move each organization's balance to its owner myself",hint:"move every paying organization's credits and plan onto its owner before you take new checkouts - the columns holding them are going away, and a stored balance is not migrated for you"},{value:"stop",label:"Stop, and stage nothing",hint:"migrate those balances in your database first, then re-run update - this is buyer DATA, not a config line, so nothing the update stages can put it back"}],emailTracking:[{value:"stage",label:"Stage it - I will turn tracking back off myself",hint:"set `config.email.tracking.enabled` to false in packages/config/src/index.ts before your next send"},{value:"stop",label:"Stop, and stage nothing",hint:"edit packages/config/src/index.ts first, then re-run update - a file you have edited is walked as a 3-way merge instead of being replaced"}]};async function Ep(e,t){let r=[];for(let n of e){let i=n.severity==="ask"?ks[n.key]:void 0;if(!i){b.log.warn(n.message);continue}r.push({notice:n,answers:i})}for(let{notice:n,answers:i}of r)(await vs({id:`retired:${n.key}`,message:n.message,choices:i.map(s=>({id:s.value,label:s.label,hint:s.hint}))},t)).id==="stop"&&(b.cancel("Update cancelled. Nothing was changed or staged."),process.exit(1))}function Sp(e){e.desktop=!1}var Pp={"legacy-desktop-ai":{message:"Your desktop app runs the local AI stack through the retired desktop-AI option. Desktop AI now follows the AI option. Keep it?",choices:[{id:"keep-ai",label:"Turn AI on, keep the desktop AI stack",hint:"also makes your website's AI surface available - keep it hidden with config.ai.enabled: false",apply:e=>{e.ai=!0}},{id:"drop-ai",label:"Turn desktop AI off",hint:"your desktop app becomes a client shell: no AI, no Terminal",apply:e=>{e.ai=!1}}]},"desktop-gains-ai":{message:"Your desktop app has no AI today, but your project has the AI option on. With the desktop-AI option retired, AI on a desktop project now ships the app's local AI stack. Keep it?",choices:[{id:"keep-ai",label:"Keep AI - the desktop app gains the AI stack",hint:"adds the local AI stack and the Terminal to your desktop app",apply:()=>{}},{id:"drop-ai",label:"Drop AI",hint:"your website's AI surface hides",apply:e=>{e.ai=!1}},{id:"drop-desktop",label:"Drop the desktop app",hint:"your website keeps its AI surface exactly as it is today",apply:Sp}]}};async function Ap(e,t,r){let n=t.latest,i=t.versions.filter(p=>_e(p.version,r)>0&&_e(p.version,n)<=0).sort((p,h)=>_e(p.version,h.version)),o=async p=>{try{return await hn(e,p)}catch{return null}};if(i.length<=1)return{text:await o(n),title:`Changelog v${n}`};let s=await Promise.all(i.map(p=>o(p.version)));return{text:i.map((p,h)=>{let g=p.date?` (${p.date.slice(0,10)})`:"",k=s[h]??"_No changelog available for this release._";return`# v${p.version}${g}
|
|
1768
1773
|
|
|
1769
|
-
${
|
|
1774
|
+
${k}`}).join(`
|
|
1770
1775
|
|
|
1771
|
-
`),title:`Changelog v${r} \u2192 v${n}`}}async function
|
|
1772
|
-
`);Y.note(o,ye.bold("Project Status"));let s=Y.spinner();s.start("Checking for updates...");try{let a=await
|
|
1773
|
-
`),x.yellow("License Details"))}function
|
|
1774
|
-
`).map(s=>s.trim()).filter(s=>s&&!s.startsWith("#"));i.length===0&&(D.cancel("No URLs found in file."),process.exit(1));let o=0;for(let s of i)await
|
|
1776
|
+
`),title:`Changelog v${r} \u2192 v${n}`}}async function Ip(e,t){let r=JSON.parse(await ys(e,"utf-8")),n=await mt(t),i=0;for(let[o,s]of Object.entries(r))ct(o)||n[o]!==s&&i++;for(let o of Object.keys(n))o in r||i++;return i}import*as Y from"@clack/prompts";import ye from"picocolors";import{readFile as Tp}from"fs/promises";import{join as Rp,resolve as _p}from"path";function Es(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=_p(t.cwd??process.cwd()),n=Rp(r,ue),i;try{i=JSON.parse(await Tp(n,"utf-8"))}catch{Y.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let o=[`Version: ${ye.cyan(i.version)}`,i.deploymentTarget?`Deploy target: ${ye.cyan(i.deploymentTarget)}`:null,i.databaseProvider?`Database: ${ye.cyan(i.databaseProvider)}`:null,i.cacheProvider?`Cache: ${ye.cyan(i.cacheProvider)}`:null].filter(Boolean).join(`
|
|
1777
|
+
`);Y.note(o,ye.bold("Project Status"));let s=Y.spinner();s.start("Checking for updates...");try{let a=await at(),p=he(a),g=(await Ae(p)).latest;i.version===g?(s.stop("Up to date."),Y.log.success(`Already on the latest version (${ye.green(g)})`)):(s.stop("Update available."),Y.log.warning(`Update available: ${ye.yellow(i.version)} \u2192 ${ye.green(g)}`),Y.log.info(`Open this project in your AI coding agent and ask it to ${ye.cyan("update my GenerateSaaS project")} - it fetches and applies the update for you.`))}catch(a){s.stop("Check failed."),a instanceof j&&a.status===401?Y.log.warning("Invalid API key. Run `generatesaas auth` to update it, or set GENERATESAAS_API_KEY."):Y.log.warning(`Could not check for updates: ${N(a)}`)}})}import{Buffer as Op}from"buffer";import{readFile as xp}from"fs/promises";import*as D from"@clack/prompts";import x from"picocolors";function Dp(){return process.env.GENERATESAAS_API_KEY??vt()}function Np(e){return{verdict:e.verdict,plan:e.license?.plan??e.domainInstalls.find(t=>t.ownerPlan)?.ownerPlan??null,mismatchDomain:e.install?.domain??null,ejectedAt:e.install?.ejectedAt??e.domainInstalls.find(t=>t.ejectedAt)?.ejectedAt??null}}function Cp(e){return{verdict:e.verdict??"unknown",ejectedAt:e.ejectedAt??null}}function Lp(e){switch(e.verdict){case"licensed":return D.log.success(`${x.green("LICENSED")} - resolves to an account with an active${e.plan?` ${e.plan}`:""} license.`),!0;case"ejected":return D.log.success(`${x.green("EJECTED")} - a licensed buyer opted this install out of telemetry${e.ejectedAt?` on ${e.ejectedAt.slice(0,10)}`:""}. The site is legitimate.`),!0;case"revoked":return D.log.error(`${x.red("REVOKED")} - the owning account no longer holds a plan (refund or chargeback). This deployment is no longer licensed.`),!1;case"token_domain_mismatch":return D.log.error(`${x.red("LEAKED TOKEN")} - this license belongs to a different deployment${e.mismatchDomain?` (${x.cyan(e.mismatchDomain)})`:""}, not this site. The token was copied from a licensed project.`),!1;case"no_license_history":return D.log.error(`${x.red("NO LICENSE HISTORY")} - no license has ever been associated with this site. If it runs GenerateSaaS, treat it as unlicensed.`),!1;default:return D.log.warn(`${x.yellow("UNKNOWN")} - could not cross-reference the records right now. Try again shortly.`),!1}}async function Ss(e,t){let r=process.env.GENERATESAAS_API_URL??wt,n=Dp();e.start("Cross-referencing license records...");try{let i=n?Np(await bn(r,n,{lkh:t.lkh,nid:t.nid,domain:t.domain})):Cp(await mr(r,{token:t.token,domain:t.domain}));return e.stop(`${x.green("Checked")} - records cross-referenced`),Lp(i)}catch(i){return e.stop(`${x.yellow("Skipped")} - ${N(i)}`),null}}function $p(e){let t=e.split(".");if(t.length!==3||!t[1])throw new Error("Invalid JWT format");let r=Op.from(t[1],"base64url").toString("utf-8");return JSON.parse(r)}function Gr(e){return typeof e!="number"?"unknown":new Date(e*1e3).toISOString().split("T")[0]}function Ps(e){D.note([`License ID: ${x.cyan(String(e.lid??"unknown"))}`,`Version: ${x.cyan(String(e.ver??"unknown"))}`,`Init version: ${String(e.iver??"unknown")}`,`Frontend: ${String(e.fe??"unknown")}`,`Created: ${Gr(e.pat)}`,`Last updated: ${Gr(e.uat)}`,`Expires: ${Gr(e.exp)}`,`Install ID: ${String(e.nid??"unknown")}`].join(`
|
|
1778
|
+
`),x.yellow("License Details"))}function jp(e){let r=(/^https?:\/\//i.test(e)?e:`https://${e}`).replace(/\/+$/,"");if(r.endsWith("/api"))return[`${r}/license`];try{if(new URL(r).pathname!=="/")return[`${r}/license`]}catch{return[`${r}/license`]}return[`${r}/api/license`,`${r}/license`]}async function As(e){let t=D.spinner(),r=null,n="no candidates";for(let s of jp(e)){t.start(`Checking ${s}...`);try{let a=await fetch(s);if(!a.ok){n=`${s} returned ${a.status}`,t.stop(`${x.yellow("Not here")} - ${n}`);continue}let p=(await a.text()).trim();if(!p||p.split(".").length!==3){n=`${s} did not return a JWT`,t.stop(`${x.yellow("Not here")} - ${n}`);continue}r=p,t.stop(`${x.green("Found")} - license endpoint responded`);break}catch(a){n=`${s}: ${N(a)}`,t.stop(`${x.yellow("Unreachable")} - ${n}`)}}if(r===null){D.log.warn(`No license endpoint found (last: ${n}). The site may be ejected, not a GenerateSaaS app, or serving its API elsewhere.`);let s=Is(e);return s?await Ss(t,{domain:s})??!1:!1}let i;try{i=$p(r)}catch{return D.log.error("Could not decode JWT payload."),!1}t.start("Verifying signature...");try{let s=process.env.GENERATESAAS_API_URL??wt,a=await mr(s,{token:r});if(a.valid)t.stop(`${x.green("Valid")} - signature verified`);else return t.stop(`${x.red("Invalid")} - ${a.reason}`),!1}catch{return t.stop(`${x.yellow("Skipped")} - could not reach verification service`),D.log.warn("Signature not verified. Displaying unverified claims:"),Ps(i),!1}return Ps(i),await Ss(t,{token:r,lkh:typeof i.lkh=="string"?i.lkh:void 0,nid:typeof i.nid=="string"?i.nid:void 0,domain:Is(e)})??!0}function Is(e){try{return new URL(/^https?:\/\//i.test(e)?e:`https://${e}`).hostname}catch{return}}function Ts(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 or https://example.com/api)").option("--file <path>","file with URLs to check, one per line").action(async(t,r)=>{if(!t&&!r.file&&(D.cancel("Provide a URL or --file <path>."),process.exit(1)),r.file){let i=(await xp(r.file,"utf-8")).split(`
|
|
1779
|
+
`).map(s=>s.trim()).filter(s=>s&&!s.startsWith("#"));i.length===0&&(D.cancel("No URLs found in file."),process.exit(1));let o=0;for(let s of i)await As(s)&&o++,D.log.info("");D.log.success(`${o}/${i.length} sites verified.`)}else await As(t)||process.exit(1)})}import{existsSync as Mp,rmSync as Up}from"fs";import*as ee from"@clack/prompts";function Rs(e){e.command("auth").description("Set or update your GenerateSaaS API key").option("--clear","remove saved API key").action(async t=>{if(t.clear){Mp(me)?(Up(me),ee.log.success("API key removed.")):ee.log.info("No API key configured.");return}let r=vt();r?ee.log.info(`Current API key: ****${r.slice(-4)}`):ee.log.info("No API key configured.");let n=await kt(),i=he(n),o=ee.spinner();o.start("Verifying API key...");try{await Ae(i),o.stop("API key verified."),Ue(n),ee.log.success("API key saved.")}catch(s){o.stop("Verification failed."),s instanceof j&&s.status===401?ee.cancel("Invalid API key."):ee.cancel(N(s)),process.exit(1)}})}import{existsSync as rr,readFileSync as Yr,rmSync as Fp,writeFileSync as _s}from"fs";import{join as Xe}from"path";import*as U from"@clack/prompts";var Vp=["packages/api/src/functions/maintenance/license-heartbeat.ts","packages/api/src/lib/cron-spread.ts","packages/api/src/lib/manifest.ts","packages/api/src/routes/internal/license.ts","packages/api/tests/functions/license-heartbeat.test.ts","packages/api/tests/lib/cron-spread.test.ts"],Bp=[{file:"packages/api/src/routes/inngest.ts",removals:[`import { licenseHeartbeatFunction } from "../functions/maintenance/license-heartbeat";
|
|
1775
1780
|
`,` licenseHeartbeatFunction,
|
|
1776
1781
|
`]},{file:"packages/api/src/routes/internal/index.ts",removals:[`import licenseRoutes from "./license";
|
|
1777
1782
|
`,` .route("/license", licenseRoutes)
|
|
1778
1783
|
`]},{file:"packages/api/src/routes/public/v1/health.ts",removals:[`import { manifest } from "../../../lib/manifest";
|
|
1779
|
-
`],replacements:[{from:'c.json({ status: "success" as const, version: manifest?.version })',to:'c.json({ status: "success" as const })'}]}];function
|
|
1784
|
+
`],replacements:[{from:'c.json({ status: "success" as const, version: manifest?.version })',to:'c.json({ status: "success" as const })'}]}];function Kp(){return ze.flatMap(e=>Ur.map(t=>Xe(e,t)))}function Hr(e){return rr(e)?(Fp(e,{recursive:!0}),!0):!1}function Gp(e,t,r=[]){if(!rr(e))return!1;let n=Yr(e,"utf-8"),i=n;for(let o of t)i=i.replace(o,"");for(let{from:o,to:s}of r)i=i.replace(o,s);return i===n?!1:(_s(e,i,"utf-8"),!0)}function Hp(e){let t=Xe(e,".gitignore");if(!rr(t))return!1;let r=Yr(t,"utf-8"),n=r.split(`
|
|
1780
1785
|
`).filter(i=>!i.includes(".generatesaas")).join(`
|
|
1781
|
-
`);return n===r?!1:(
|
|
1786
|
+
`);return n===r?!1:(_s(t,n,"utf-8"),!0)}function Os(e){e.command("eject").description("Remove all GenerateSaaS ties - manifest, license, heartbeat, skills").action(async()=>{let t=process.cwd(),r=Xe(t,ue),n;try{n=JSON.parse(Yr(r,"utf-8"))}catch{U.cancel("No GenerateSaaS project found in this directory."),process.exit(1)}let i=await U.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.'}});if(U.isCancel(i)&&(U.cancel("Eject cancelled."),process.exit(0)),n.licenseToken)try{await fetch("https://generatesaas.com/api/v1/heartbeat",{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${n.licenseToken}`},body:JSON.stringify({event:"eject",version:n.version,frontend:n.frontend}),signal:AbortSignal.timeout(5e3)}),U.log.info("Recorded the opt-out with generatesaas.com (final event - nothing is sent after this).")}catch{U.log.warn("Could not reach generatesaas.com to record the opt-out. Ejecting anyway.")}let o=[],s=[];for(let a of Kp())Hr(Xe(t,a))&&o.push(a);for(let a of Vp)Hr(Xe(t,a))&&o.push(a);Hr(Xe(t,q))&&o.push(`${q}/`);for(let a of Bp){let p=Xe(t,a.file);Gp(p,a.removals,a.replacements)?s.push(a.file):rr(p)&&U.log.warn(`Could not auto-modify ${a.file} - manually remove license/heartbeat references.`)}Hp(t)&&s.push(".gitignore");for(let a of o)U.log.info(`Deleted ${a}`);for(let a of s)U.log.info(`Modified ${a}`);U.log.success("Ejected successfully. This project is now fully standalone.")})}var Ze=new Yp().name("generatesaas").description("CLI for scaffolding and managing GenerateSaaS projects").version("3.32.0").addHelpText("after",`
|
|
1782
1787
|
Examples:
|
|
1783
1788
|
$ generatesaas init Interactive setup
|
|
1784
1789
|
$ generatesaas init -n my-app -y Quick setup with defaults
|
|
1785
1790
|
$ generatesaas status Check for updates
|
|
1786
1791
|
$ generatesaas auth Set or update API key
|
|
1787
|
-
`);
|
|
1792
|
+
`);ds(Ze);bs(Ze);Es(Ze);Ts(Ze);Rs(Ze);Os(Ze);Ze.parseAsync().catch(e=>{xs.cancel("An unexpected error occurred."),console.error(e),process.exit(1)});
|