generatesaas 2.1.0 → 2.2.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 +139 -190
- package/dist/skill/content/SKILL.md +3 -3
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -1,29 +1,27 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{Command as qc}from"commander";import*as _i from"@clack/prompts";import{existsSync as cc,readdirSync as pc,rmSync as lc}from"fs";import{join as dc,resolve as uc}from"path";import{Option as W}from"commander";import*as A from"@clack/prompts";import*as $t from"@clack/prompts";import wn from"picocolors";function ur(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";$t.intro(wn.bgYellow(wn.black(t)))}function mr(){$t.outro(wn.yellow("Happy building!"))}import*as m from"@clack/prompts";import f from"picocolors";var yt={nextjs:{label:"Next.js",hint:"React 19 + Next.js 16"},nuxt:{label:"Nuxt",hint:"Vue 3 + Nuxt 4"}},wt={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)"}},Lt={stripe:{label:"Stripe"},polar:{label:"Polar"},none:{label:"None",hint:"disable payments"}},Ut={smtp:{label:"SMTP",hint:"Mailpit for local dev"},ses:{label:"Amazon SES"},resend:{label:"Resend"}},jt={user:{label:"Per user",hint:"each user has their own subscription"},organization:{label:"Per organization",hint:"org subscription shared by members"}},Ye={postgres:{label:"PostgreSQL",hint:"port 5432",port:5432},redis:{label:"Redis",hint:"port 6379",port:6379},inngest:{label:"Inngest",hint:"port 8288",port:8288},mailpit:{label:"Mailpit",hint:"port 1025",port:1025}},vt={"claude-code":{label:"Claude Code"},cursor:{label:"Cursor"},codex:{label:"Codex"},"gemini-cli":{label:"Gemini CLI"},windsurf:{label:"Windsurf"}};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 ie={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}},q={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"}]}},ae={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"}]}},kt=[{target:"vercel",provider:"redis",reason:"Vercel serverless cannot maintain persistent Redis connections. Consider Upstash."}],bt=[{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)."}],fr=["Local file storage (sharp, geoip-lite)","SMTP email (use Resend or SES instead)","Content API git integration"];function Mt(e){let t=q[e.databaseProvider].managed,n=ae[e.cacheProvider].managed;return e.dockerServices.some(r=>!(r==="postgres"&&t||r==="redis"&&n))}var me={google:{label:"Google",envVars:[{name:"GOOGLE_CLIENT_ID",secret:!1},{name:"GOOGLE_CLIENT_SECRET",secret:!0}]},github:{label:"GitHub",envVars:[{name:"GITHUB_CLIENT_ID",secret:!1},{name:"GITHUB_CLIENT_SECRET",secret:!0}]},facebook:{label:"Facebook",envVars:[{name:"FACEBOOK_CLIENT_ID",secret:!1},{name:"FACEBOOK_CLIENT_SECRET",secret:!0}]},discord:{label:"Discord",envVars:[{name:"DISCORD_CLIENT_ID",secret:!1},{name:"DISCORD_CLIENT_SECRET",secret:!0}]},x:{label:"X",envVars:[{name:"TWITTER_CLIENT_ID",secret:!1},{name:"TWITTER_CLIENT_SECRET",secret:!0}]}};var $e=["nextjs","nuxt"],We=["fullstack","separate"],Xe=["stripe","polar","none"],Ze=["smtp","ses","resend"],Qe=["postgres","redis","inngest","mailpit"],et=["claude-code","cursor","codex","gemini-cli","windsurf"],tt=["user","organization"],fe=["USD","EUR","GBP","CAD","AUD","BRL","JPY"],ge=["node","vercel"],he=["postgres","neon","supabase"],ye=["redis","upstash"],nt=["google","github","facebook","discord","x"],Le=["shared","vendored"];function Vt(e,t){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||t}function rt(e){return e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function Ft(e){return/^[a-z][a-z0-9-]*$/.test(e)}function T(e){return e instanceof Error?e.message:String(e)}function Z(e){let t=e?.trim();return t?`${rt(t)} Companion`:"My Companion"}var Ue="https://github.com/Duzbee/OpenCompanion";function se(e){return e.companionSource==="shared"||e.companionSource==="vendored"?e.companionSource:e.companionName?"vendored":"shared"}function gr(e){return e.desktop===!0&&e.ai===!0}function Y(e){if(gr(e)){if(e.companionSource==="shared")throw new Error("A desktop app with AI bundles its own companion daemon, so its companion source must be vendored. Remove the shared companion source, or turn AI off on this project.");return"vendored"}return se(e)}function we(e){return gr(e)?!0:e.companion===!0&&se(e)==="vendored"}function Bt(e){return e.demo===!0&&e.companion===!0?!0:we(e)}function Ee(e){return e.paymentProvider!==void 0&&e.paymentProvider!=="none"}var hr=[{key:"frontend",label:"Frontend framework",hint:"Nuxt (Vue) or Next.js (React).",category:"Project",kind:"enum",default:"nuxt",choices:$e,adoptable:!1,impact:"structural"},{key:"architecture",label:"Architecture",hint:"Fullstack (frontend hosts the API) or a standalone Hono backend.",category:"Infrastructure",kind:"enum",default:"fullstack",choices:We,adoptable:!1,impact:"structural"},{key:"deploymentTarget",label:"Deployment target",hint:"Node.js / Docker or Vercel serverless.",category:"Infrastructure",kind:"enum",default:"node",choices:ge,adoptable:!1,impact:"config"},{key:"databaseProvider",label:"Database provider",hint:"Self-hosted PostgreSQL, Neon, or Supabase.",category:"Infrastructure",kind:"enum",default:"postgres",choices:he,adoptable:!1,impact:"config"},{key:"cacheProvider",label:"Cache provider",hint:"Self-hosted Redis or Upstash.",category:"Infrastructure",kind:"enum",default:"redis",choices:ye,adoptable:!1,impact:"config"},{key:"paymentProvider",label:"Payment provider",hint:"Stripe, Polar, or none.",category:"Features",kind:"enum",default:"none",choices:Xe,adoptable:!1,impact:"structural"},{key:"defaultCurrency",label:"Default currency",hint:"Billing and pricing currency.",category:"Features",kind:"enum",default:"USD",choices:fe,adoptable:!1,impact:"config"},{key:"emailProvider",label:"Email provider",hint:"SMTP, Amazon SES, or Resend.",category:"Features",kind:"enum",default:"smtp",choices:Ze,adoptable:!1,impact:"config"},{key:"multiTenancy",label:"Multi-tenancy (organizations)",hint:"Adds organizations - teams, members, and shared resources.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"billingScope",label:"Billing scope",hint:"Whether subscriptions belong to a user or an organization.",category:"Features",kind:"enum",default:"user",choices:tt,adoptable:!1,impact:"config",requires:e=>e.multiTenancy===!0,requiresLabel:"requires multi-tenancy"},{key:"blog",label:"Blog",hint:"Adds the marketing blog (content collection, list and post pages).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"emailTracking",label:"Email analytics",hint:"Tracks opens and clicks of marketing emails and adds an admin analytics page.",category:"Features",kind:"boolean",default:!0,adoptable:!0,impact:"config"},{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"},{key:"desktop",label:"Desktop app",hint:"Adds the cross-platform desktop app (apps/electron, built with Electron).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"desktopAutoRelease",label:"Desktop auto-release",hint:"Release the desktop app on every CI success (vs manual-only).",category:"Features",kind:"boolean",default:!0,adoptable:!1,impact:"config",requires:e=>e.desktop===!0,requiresLabel:"requires the desktop app"},{key:"ai",label:"AI features",hint:"Adds the AI surface (chat, models, schedules, integrations) and unlocks the companion, MCP server, and BYOK options. On a desktop project it also ships the app's local AI stack and bundles a companion daemon inside the packaged app. Off keeps config.ai.enabled false so the AI nav stays hidden.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"companion",label:"Companion daemon",hint:"Lets your users install a companion daemon that runs their own AI subscriptions (and any device-side work you add) on their hardware. Point it at an existing shared companion like OpenCompanion (default, nothing to maintain), or vendor and publish your own branded daemon.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",requires:e=>e.ai===!0,requiresLabel:"requires AI features"},{key:"companionSource",label:"Companion source",hint:"Point at an existing shared companion repo (like OpenCompanion), or vendor a branded daemon you own and publish yourself.",category:"Features",kind:"enum",default:e=>Y(e),choices:Le,adoptable:!0,impact:"structural",requires:e=>e.companion===!0||e.desktop===!0&&e.ai===!0,requiresLabel:"requires the companion, or a desktop app with AI"},{key:"companionRepoUrl",label:"Companion repo URL",hint:"GitHub repository of the shared companion this project points at. Its brand.json supplies the daemon identity; your users install from its latest release.",category:"Features",kind:"text",default:()=>Ue,adoptable:!0,impact:"config",requires:e=>e.companion===!0&&se(e)==="shared",requiresLabel:"requires a shared-source companion"},{key:"companionLocalPath",label:"Companion local checkout",hint:"Optional path to your local checkout of the shared companion, if you develop it alongside this project. Leave empty otherwise.",category:"Features",kind:"text",default:()=>"",adoptable:!0,impact:"config",requires:e=>e.companion===!0&&se(e)==="shared",requiresLabel:"requires a shared-source companion"},{key:"companionName",label:"Companion name",hint:"What your users install - the display name of your branded companion daemon.",category:"Features",kind:"text",default:e=>Z(e.projectName),adoptable:!0,impact:"config",requires:e=>we(e),requiresLabel:"requires a bundled daemon: a vendored companion, or a desktop app with AI"},{key:"mcpServer",label:"Outward MCP server",hint:"Exposes the app's capability layer to external agents as an authenticated MCP OAuth server.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",requires:e=>e.ai===!0,requiresLabel:"requires AI features"},{key:"aiBuiltin",label:"Built-in AI (credits)",hint:"Your app offers models under its own name via OpenRouter, billed from user credits (which need a payment provider to buy). The only setup is OPENROUTER_API_KEY.",category:"Features",kind:"boolean",default:e=>Ee(e),adoptable:!1,impact:"config",requires:e=>e.ai===!0&&Ee(e),requiresLabel:"requires AI features and a payment provider"},{key:"aiByok",label:"User API keys (BYOK)",hint:"Let end-users connect their own provider API keys; runs on their key never use credits.",category:"Features",kind:"boolean",default:!0,adoptable:!1,impact:"config",requires:e=>e.ai===!0,requiresLabel:"requires AI features"},{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",requires:e=>Ee(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"},{key:"socialProviders",label:"Social login providers",hint:"Which social sign-in buttons the auth screen shows.",category:"Features",kind:"multiselect",default:[],choices:nt,adoptable:!1,impact:"config"},{key:"dockerServices",label:"Docker services",hint:"Local services scaffolded in docker-compose.",category:"Tooling",kind:"multiselect",default:[],choices:Qe,adoptable:!1,impact:"config"},{key:"aiTools",label:"AI coding tools",hint:"Which AI assistants receive the bundled skill files.",category:"Tooling",kind:"multiselect",default:[],choices:et,adoptable:!1,impact:"config"}];function Ci(e,t){return e[t]!==void 0}function yr(e){return hr.filter(t=>t.adoptable&&!Ci(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 wr(e){let t={};for(let n of hr)if(typeof n.default=="function"){if(n.requires&&!n.requires(e))continue;t[n.key]=n.default(e)}else t[n.key]=Array.isArray(n.default)?[...n.default]:n.default;return{...t,...e}}import{readFile as kn}from"fs/promises";import{join as vr}from"path";var vn="GENERATESAAS_COMPANION_BRAND_JSON",Gt=["daemon/brand.json","apps/companion/brand.json"];function ce(e){let t=e.trim(),n;try{n=new URL(t)}catch{throw new Error(`Invalid companion repo URL "${t}". Use a full GitHub URL like https://github.com/owner/repo.`)}if(n.protocol!=="https:"&&n.protocol!=="http:")throw new Error(`Invalid companion repo URL "${t}". Use a full GitHub URL like https://github.com/owner/repo.`);let r=n.hostname.toLowerCase();if(r!=="github.com"&&r!=="www.github.com")throw new Error(`Only GitHub-hosted shared companions are supported right now (got "${n.hostname}"). Host the companion on GitHub, or vendor your own with --companion-source vendored.`);let o=n.pathname.split("/").filter(Boolean),i=o[0],a=o[1]?.replace(/\.git$/,"");if(!i||!a)throw new Error(`"${t}" is missing the owner/repo path. Use a full GitHub URL like https://github.com/owner/repo.`);return{owner:i,repo:a,canonicalUrl:`https://github.com/${i}/${a}`}}function kr(e,t){return e.owner.toLowerCase()===t.owner.toLowerCase()&&e.repo.toLowerCase()===t.repo.toLowerCase()}function Kt(e,t){let n;try{n=JSON.parse(e)}catch{throw new Error(`The companion brand.json from ${t} is not valid JSON.`)}if(typeof n!="object"||n===null)throw new Error(`The companion brand.json from ${t} is not a JSON object.`);let r=n;for(let o of["name","binary","envPrefix"]){let i=r[o];if(typeof i!="string"||i.trim()==="")throw new Error(`The companion brand.json from ${t} is missing a usable "${o}" field. Point at a companion repo built with the GenerateSaaS export pipeline, or vendor your own with --companion-source vendored.`)}return{name:r.name,binary:r.binary,envPrefix:r.envPrefix}}async function Di(e,t){let n=vr(e,"apps/companion/brand.json"),r;try{r=await kn(n,"utf8")}catch(a){if(typeof a=="object"&&a!==null&&"code"in a&&a.code==="ENOENT")return null;throw a}let o;try{o=JSON.parse(r).repoUrl}catch{throw new Error("The template's apps/companion/brand.json is not valid JSON (boilerplate drift).")}if(typeof o!="string"||o.trim()==="")return null;let i;try{i=ce(o)}catch{return null}return kr(i,t)?Kt(r,`the template (${n})`):null}async function Ni(e,t){for(let n of Gt){let r=vr(e,n),o;try{o=await kn(r,"utf8")}catch(s){if(typeof s=="object"&&s!==null&&"code"in s&&s.code==="ENOENT")continue;throw s}let i=Kt(o,r),a=JSON.parse(o).repoUrl;if(typeof a=="string"&&a.trim()!==""){let s;try{s=ce(a)}catch{throw new Error(`The companion checkout at ${r} names an unusable repoUrl ("${a}"), so it cannot be verified against ${t.canonicalUrl}. Fix the checkout's brand.json, or drop --companion-local-path to fetch the identity from GitHub.`)}if(!kr(s,t))throw new Error(`The companion checkout at ${e} belongs to ${s.canonicalUrl}, but the project points at ${t.canonicalUrl}. Point --companion-repo-url and --companion-local-path at the same companion, or drop --companion-local-path to fetch the identity from GitHub.`)}return i}throw new Error(`No brand.json found in ${e} (checked ${Gt.join(" and ")}). Point --companion-local-path at a checkout of the companion repo, or remove it to fetch the identity from GitHub.`)}async function $i(e){for(let t of Gt){let n=`https://raw.githubusercontent.com/${e.owner}/${e.repo}/HEAD/${t}`,r;try{r=await fetch(n)}catch(o){throw new Error(`Could not reach GitHub to read the companion identity (${n}): ${T(o)}. Check your network, or pass --companion-local-path to a local checkout of the companion.`)}if(r.status!==404){if(!r.ok)throw new Error(`GitHub returned ${r.status} for ${n}. Check that ${e.canonicalUrl} exists and is public.`);return Kt(await r.text(),n)}}throw new Error(`No brand.json found in ${e.canonicalUrl} (tried ${Gt.join(" and ")} on the default branch). Point --companion-repo-url at a companion repo built with the GenerateSaaS export pipeline.`)}async function br(e){let t=e.companionRepoUrl?.trim();if(!t)throw new Error("resolveSharedCompanionBrand: companionRepoUrl is missing for a shared-source companion.");let n=ce(t),r=await Di(e.projectDir,n);if(r)return r;let o=e.companionLocalPath?.trim();if(o)return await Ni(o,n);let i=process.env[vn]?.trim();if(i){let a;try{a=await kn(i,"utf8")}catch(s){throw new Error(`Could not read ${vn} (${i}): ${T(s)}.`)}return Kt(a,`${vn} (${i})`)}return await $i(n)}var Sr=["companion","mcpServer"];function Sn(e){if(!Sr.some(n=>e[n]===!0))return e;if(e.ai===!1)throw new Error("--companion / --mcp-server require AI features; remove --no-ai.");return e.ai===void 0&&(e.ai=!0),e}function Er(e){if(e.ai!==!0)return!0;let t=e.aiBuiltin===!0&&Ee(e),n=e.desktop===!0;return t||e.aiByok===!0||e.companion===!0||n}function En(e){if(!Er(e))throw new Error("AI features have no usable model source: built-in AI needs a payment provider (it bills from user credits), user API keys (BYOK) are off, and there is no companion. Enable one - add a payment provider, keep user API keys (drop --no-ai-byok), or add the companion (--companion).")}function Ir(e){return Sr.some(n=>e[n]===!0)&&(e.ai=!0),e}function Ar(e){return e.ai!==!0||(e.aiBuiltin===void 0&&(e.aiBuiltin=e.aiByok===!1),Ee(e)||(e.aiBuiltin=!1),Er(e)||(e.aiByok=!0)),e}function Pr(e){let t=e.desktopAi;e.companion!==!0&&e.companionSource==="shared"&&delete e.companionSource;let n=Li(e,t);return delete e.desktopAi,n.kind!=="shared-source-contradiction"&&In(e),n}function In(e){return we(e)&&(e.companionSource=Y(e),e.companionName===void 0&&(e.companionName=Z(e.projectName))),e}function Li(e,t){return e.desktop!==!0?{kind:"none"}:e.ai===!0&&e.companionSource==="shared"?{kind:"shared-source-contradiction"}:t===!0&&e.ai!==!0?{kind:"legacy-desktop-ai"}:t===!1&&e.ai===!0?{kind:"desktop-gains-ai"}:e.ai===!0&&e.companionName===void 0?{kind:"daemon-materialized"}:{kind:"none"}}function Rr(e){let t={};if(e.name!==void 0){if(!Ft(e.name))throw new Error(`Invalid project name "${e.name}". Use lowercase letters, numbers, and hyphens only. Must start with a letter.`);t.projectName=e.name}if(e.appName!==void 0){if(!e.appName.trim())throw new Error("App name cannot be empty.");t.appName=e.appName}if(e.location!==void 0?t.projectDir=e.location==="."?process.cwd():e.location:t.projectName!==void 0&&(t.projectDir=`./${t.projectName}`),e.frontend!==void 0){if(!$e.includes(e.frontend))throw new Error(`Invalid frontend "${e.frontend}". Valid values: ${$e.join(", ")}`);t.frontend=e.frontend}if(e.architecture!==void 0&&(t.architecture=e.architecture),e.payment!==void 0&&(t.paymentProvider=e.payment),e.email!==void 0&&(t.emailProvider=e.email),e.org!==void 0&&(t.multiTenancy=e.org),e.billingScope!==void 0){if(e.org!==!0)throw new Error("--billing-scope requires --org to be enabled.");t.billingScope=e.billingScope}if(e.blog!==void 0&&(t.blog=e.blog),e.emailTracking!==void 0&&(t.emailTracking=e.emailTracking),e.docs!==void 0&&(t.docs=e.docs),e.desktop!==void 0&&(t.desktop=e.desktop),e.desktopAuto!==void 0&&(t.desktopAutoRelease=e.desktopAuto),e.ai!==void 0&&(t.ai=e.ai),e.companion!==void 0&&(t.companion=e.companion),e.companionSource!==void 0){if(!Le.includes(e.companionSource))throw new Error(`Invalid companion source "${e.companionSource}". Valid values: ${Le.join(", ")}`);if(e.companion===!1)throw new Error("--companion-source requires the companion; remove --no-companion.");t.companionSource=e.companionSource,t.companion===void 0&&(t.companion=!0)}if(e.companionRepoUrl!==void 0){if(e.companion===!1)throw new Error("--companion-repo-url requires the companion; remove --no-companion.");t.companionRepoUrl=ce(e.companionRepoUrl).canonicalUrl,t.companion===void 0&&(t.companion=!0)}if(e.companionLocalPath!==void 0){if(e.companion===!1)throw new Error("--companion-local-path requires the companion; remove --no-companion.");let n=e.companionLocalPath.trim();n!==""&&(t.companionLocalPath=n,t.companion===void 0&&(t.companion=!0))}if(t.companionSource==="vendored"&&(t.companionRepoUrl!==void 0||t.companionLocalPath!==void 0))throw new Error("--companion-repo-url / --companion-local-path apply to a shared companion; remove them or use --companion-source shared.");if(e.mcpServer!==void 0&&(t.mcpServer=e.mcpServer),e.aiBuiltin!==void 0){if(e.aiBuiltin===!0&&e.payment==="none")throw new Error("--ai-builtin requires a payment provider (got --payment none). Built-in AI bills from user credits.");t.aiBuiltin=e.aiBuiltin}if(e.aiByok!==void 0&&(t.aiByok=e.aiByok),Sn(t),e.desktop===!0&&t.ai===!0&&(t.companionRepoUrl!==void 0||t.companionLocalPath!==void 0))throw new Error("--companion-repo-url / --companion-local-path point at a SHARED companion, but a desktop app with AI bundles its own; remove them, or turn AI off with --no-ai.");if(e.revenueSharing!==void 0&&(t.revenueSharing=e.revenueSharing),e.credits!==void 0){if(e.credits===!0&&e.payment==="none")throw new Error("--credits requires a payment provider (got --payment none).");t.credits=e.credits}if(e.docker!==void 0&&(t.dockerServices=bn(e.docker,Qe,"docker service")),e.aiTools!==void 0&&(t.aiTools=bn(e.aiTools,et,"AI tool")),e.socialProviders!==void 0&&(t.socialProviders=bn(e.socialProviders,nt,"social provider")),e.currency!==void 0){if(!fe.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${fe.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!ge.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${ge.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!he.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${he.join(", ")}`);t.databaseProvider=e.database}if(e.cache!==void 0){if(!ye.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${ye.join(", ")}`);t.cacheProvider=e.cache}if(e.demo===!0&&(t.demo=!0),e.baseUrl!==void 0){let n=e.baseUrl.trim();if(n==="")throw new Error("--base-url cannot be empty. Provide an absolute URL like https://example.com.");let r;try{r=new URL(n)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(r.protocol!=="http:"&&r.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${r.protocol}//${r.host}`}return t}var pe={projectName:"my-saas",frontend:"nextjs",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,billingScope:"user",blog:!0,emailTracking:!0,docs:!1,desktop:!1,desktopAutoRelease:!1,ai:!1,companion:!1,mcpServer:!1,aiBuiltin:!0,aiByok:!0,revenueSharing:!1,credits:!0,dockerServices:["postgres","redis","inngest"],aiTools:[],socialProviders:[],defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"};function xr(e){let t=e.projectName??pe.projectName,n=e.projectDir??`./${t}`,r=e.appName??rt(t),o=e.deploymentTarget??pe.deploymentTarget,i=ie[o]?.edgeRuntime??!1,a=e.databaseProvider??(i?"neon":pe.databaseProvider),s=e.cacheProvider??(i?"upstash":pe.cacheProvider),u=e.emailProvider??(i?"resend":pe.emailProvider),g=e.dockerServices??(i?pe.dockerServices.filter(h=>h!=="postgres"&&h!=="redis"):pe.dockerServices),l={...pe,...e,projectName:t,appName:r,projectDir:n,deploymentTarget:o,databaseProvider:a,cacheProvider:s,emailProvider:u,dockerServices:g};l.paymentProvider==="none"&&(l.credits=!1),l.multiTenancy||(l.billingScope="user"),l.ai||(l.aiBuiltin=pe.aiBuiltin,l.aiByok=pe.aiByok),l.paymentProvider==="none"&&(l.aiBuiltin=!1),l.desktop&&l.ai&&(l.companionSource=Y(l)),we(l)&&l.companionName===void 0&&(l.companionName=Z(l.projectName)),l.companion&&(l.companionSource===void 0&&(l.companionSource=se(l)),l.companionSource==="vendored"?l.companionName===void 0&&(l.companionName=Z(l.projectName)):(l.companionRepoUrl===void 0&&(l.companionRepoUrl=Ue),l.companionLocalPath===void 0&&(l.companionLocalPath=""))),En(l);for(let h of kt){if(l.deploymentTarget!==h.target)continue;let y=l.databaseProvider===h.provider?"database":"cache";if(l.databaseProvider===h.provider||l.cacheProvider===h.provider)throw new Error(`Incompatible: --deploy ${h.target} + --${y} ${h.provider}. ${h.reason}`)}for(let h of bt)if(l.architecture===h.architecture&&l.deploymentTarget===h.target)throw new Error(`Incompatible: --architecture ${h.architecture} + --deploy ${h.target}. ${h.reason}`);return l}function bn(e,t,n){if(e.trim()==="")return[];let r=e.split(",").map(i=>i.trim()).filter(Boolean),o=r.filter(i=>!t.includes(i));if(o.length>0)throw new Error(`Invalid ${n}(s): ${o.join(", ")}. Valid values: ${t.join(", ")}`);return r}function E(e){m.isCancel(e)&&(m.cancel("Setup cancelled."),process.exit(0))}function An(e){let t=[];e.databaseProvider==="neon"&&t.push({key:"DATABASE_URL",message:"Neon connection string (optional):",placeholder:"postgres://...",secret:!0}),e.databaseProvider==="supabase"&&t.push({key:"DATABASE_URL",message:"Supabase connection string (optional):",placeholder:"postgres://...",secret:!0}),e.cacheProvider==="upstash"&&(t.push({key:"UPSTASH_REDIS_REST_URL",message:"Upstash REST URL (optional):",placeholder:"https://...",secret:!1}),t.push({key:"UPSTASH_REDIS_REST_TOKEN",message:"Upstash REST token (optional):",secret:!0})),e.paymentProvider==="stripe"&&(t.push({key:"STRIPE_SECRET_KEY",message:"Stripe secret key (optional):",placeholder:"sk_test_...",secret:!0}),t.push({key:"STRIPE_WEBHOOK_SECRET",message:"Stripe webhook secret (optional):",placeholder:"whsec_...",secret:!0})),e.paymentProvider==="polar"&&(t.push({key:"POLAR_ACCESS_TOKEN",message:"Polar access token (optional):",secret:!0}),t.push({key:"POLAR_WEBHOOK_SECRET",message:"Polar webhook secret (optional):",secret:!0})),e.emailProvider==="resend"&&t.push({key:"RESEND_API_KEY",message:"Resend API key (optional):",placeholder:"re_...",secret:!0}),e.emailProvider==="ses"&&(t.push({key:"AMAZON_SES_REGION",message:"Amazon SES region (optional):",placeholder:"us-east-1",secret:!1}),t.push({key:"AMAZON_SES_KEY",message:"Amazon SES access key (optional):",secret:!0}),t.push({key:"AMAZON_SES_SECRET",message:"Amazon SES secret (optional):",secret:!0}));for(let n of e.socialProviders){let r=me[n];for(let o of r.envVars)t.push({key:o.name,message:`${o.name} (${r.label}, optional):`,secret:o.secret})}return e.demo&&t.push({key:"TURNSTILE_SECRET_KEY",message:"Cloudflare Turnstile secret key (optional):",secret:!0}),t}async function Tr(e,t){let n=!1;e&&Sn(e),m.log.info(f.bold("Project"));let r=e?.projectName??await(async()=>{n=!0;let c=await m.text({message:"Project name:",placeholder:"my-saas",validate:d=>{if(!d?.trim())return"Project name is required.";if(!Ft(d))return"Use lowercase letters, numbers, and hyphens only. Must start with a letter."}});return E(c),c})(),o=e?.appName??await(async()=>{n=!0;let c=await m.text({message:"App name:",initialValue:rt(r),validate:d=>{if(!d?.trim())return"App name is required."}});return E(c),c})(),i=e?.projectDir??await(async()=>{n=!0;let c=await m.text({message:"Project location:",initialValue:`./${r}`});return E(c),c==="."?process.cwd():c})(),a=e?.frontend??await(async()=>{n=!0;let c=Object.keys(yt),d=await m.select({message:"Frontend framework:",options:c.map(S=>({value:S,label:yt[S].label,hint:yt[S].hint}))});return E(d),d})();m.log.info(f.bold("Infrastructure"));let s=e?.deploymentTarget??"node";if(e?.deploymentTarget===void 0){n=!0;let c=await m.select({message:"Deployment target:",options:ge.map(d=>({value:d,label:ie[d].label,hint:ie[d].hint}))});E(c),s=c}let u=e?.architecture?bt.find(c=>c.architecture===e.architecture&&c.target===s):void 0;if(u)throw new Error(`Incompatible: --architecture ${u.architecture} + --deploy ${u.target}. ${u.reason}`);let g=new Set(bt.filter(c=>c.target===s).map(c=>c.architecture)),l=We.filter(c=>!g.has(c)),h=e?.architecture??await(async()=>{if(l.length===1){let d=l[0];return m.log.info(`Auto-selected ${wt[d].label} architecture (only compatible option for ${ie[s].label}).`),d}n=!0;let c=await m.select({message:"Architecture:",options:l.map(d=>({value:d,label:wt[d].label,hint:wt[d].hint}))});return E(c),c})(),y=e?.databaseProvider??await(async()=>{n=!0;let c=he.filter(S=>!kt.some(K=>K.target===s&&K.provider===S));if(c.length===1){let S=c[0];return m.log.info(`Auto-selected ${q[S].label} (only compatible option for ${ie[s].label}).`),S}let d=await m.select({message:"Database provider:",options:c.map(S=>({value:S,label:q[S].label,hint:q[S].hint}))});return E(d),d})(),_=e?.cacheProvider??await(async()=>{n=!0;let c=ye.filter(S=>!kt.some(K=>K.target===s&&K.provider===S));if(c.length===1){let S=c[0];return m.log.info(`Auto-selected ${ae[S].label} (only compatible option for ${ie[s].label}).`),S}let d=await m.select({message:"Cache provider:",options:c.map(S=>({value:S,label:ae[S].label,hint:ae[S].hint}))});return E(d),d})();if(ie[s]?.edgeRuntime){let c=fr.map(d=>` - ${d}`).join(`
|
|
3
|
-
`);m.note(c,"Unavailable on edge runtime")}m.log.info(f.bold("Features"));let
|
|
4
|
-
`),d=[` Deploy target: ${f.cyan(
|
|
5
|
-
`),
|
|
6
|
-
`),
|
|
7
|
-
`);
|
|
8
|
-
`),"Summary");let
|
|
9
|
-
`,{mode:384})}async function
|
|
10
|
-
`,scripts:{}}:await(await
|
|
11
|
-
|
|
12
|
-
`)}async function
|
|
13
|
-
`)}function
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
`,"",`${t}
|
|
19
|
-
`,""
|
|
20
|
-
|
|
21
|
-
`)
|
|
22
|
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
25
|
-
- **Companion daemon** - this app points at the shared companion \`${e.companionRepoUrl}\`. A local checkout lives at \`${e.companionLocalPath}\` - edit and commit device-side behavior THERE, not in this repo (clone from the repo URL if the checkout is missing).`:y=`
|
|
26
|
-
- **Companion daemon** - this app points at the shared companion \`${e.companionRepoUrl}\` (your users install it from that repo's releases). It cannot be modified from this repo; to customize device-side behavior, switch \`companionSource\` to \`vendored\` via \`generatesaas update\`.`);let _=t?"`$t('key')` in templates (global helper); `useI18n()` from `vue-i18n` in `<script setup>` for `locale`/`setLocale`/`t()`.":"`useTranslations()` from `next-intl` in components; messages are loaded in `apps/web-next/i18n/request.ts`.",v=t?"**Navigation:** always use `localePath()` for paths (hardcoded paths break non-default locales); `await navigateTo()` in SSR.":"**Navigation:** `next/link` for links; `redirect()` from `next/navigation` for programmatic redirects in Server Components.";return`# AGENTS.md
|
|
2
|
+
import{Command as Pc}from"commander";import*as ii from"@clack/prompts";import{existsSync as Us,readdirSync as Ms,rmSync as Fs}from"fs";import{join as Vs,resolve as Bs}from"path";import{Option as Z}from"commander";import*as k from"@clack/prompts";import*as _t from"@clack/prompts";import rn from"picocolors";function Gn(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";_t.intro(rn.bgYellow(rn.black(t)))}function Kn(){_t.outro(rn.yellow("Happy building!"))}import*as m from"@clack/prompts";import f from"picocolors";var st={nextjs:{label:"Next.js",hint:"React 19 + Next.js 16"},nuxt:{label:"Nuxt",hint:"Vue 3 + Nuxt 4"}},ct={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)"}},xt={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"}},Be={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}},pt={"claude-code":{label:"Claude Code"},cursor:{label:"Cursor"},codex:{label:"Codex"},"gemini-cli":{label:"Gemini CLI"},windsurf:{label:"Windsurf"}};var Ie={USD:{symbol:"$",name:"US Dollar",place:"left",space:!1},EUR:{symbol:"\u20AC",name:"Euro",place:"right",space:!1},GBP:{symbol:"\xA3",name:"British Pound",place:"left",space:!1},CAD:{symbol:"CA$",name:"Canadian Dollar",place:"left",space:!1},AUD:{symbol:"A$",name:"Australian Dollar",place:"left",space:!1},BRL:{symbol:"R$",name:"Brazilian Real",place:"left",space:!1},JPY:{symbol:"\xA5",name:"Japanese Yen",place:"left",space:!1}};var ne={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}},K={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"}]}},re={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"}]}},lt=[{target:"vercel",provider:"redis",reason:"Vercel serverless cannot maintain persistent Redis connections. Consider Upstash."}],dt=[{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)."}],Hn=["Local file storage (sharp, geoip-lite)","SMTP email (use Resend or SES instead)","Content API git integration"];function Dt(e){let t=K[e.databaseProvider].managed,n=re[e.cacheProvider].managed;return e.dockerServices.some(r=>!(r==="postgres"&&t||r==="redis"&&n))}var Re=["nextjs","nuxt"],Ge=["fullstack","separate"],Ke=["stripe","polar","none"],He=["smtp","ses","resend"],ze=["postgres","redis","inngest","mailpit"],Je=["claude-code","cursor","codex","gemini-cli","windsurf"],se=["USD","EUR","GBP","CAD","AUD","BRL","JPY"],ce=["node","vercel"],pe=["postgres","neon","supabase"],le=["redis","upstash"],Pe=["shared","vendored"];function Ct(e,t){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||t}function Ye(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 I(e){return e instanceof Error?e.message:String(e)}function W(e){let t=e?.trim();return t?`${Ye(t)} Companion`:"My Companion"}var Te="https://github.com/Duzbee/OpenCompanion";function de(e){return e.companionSource==="shared"||e.companionSource==="vendored"?e.companionSource:e.companionName?"vendored":"shared"}function zn(e){return e.desktop===!0&&e.ai===!0}function H(e){if(zn(e)){if(e.companionSource==="shared")throw new Error("A desktop app with AI bundles its own companion daemon, so its companion source must be vendored. Remove the shared companion source, or turn AI off on this project.");return"vendored"}return de(e)}function ue(e){return zn(e)?!0:e.companion===!0&&de(e)==="vendored"}function $t(e){return e.demo===!0&&e.companion===!0?!0:ue(e)}function ut(e){return e.paymentProvider!==void 0&&e.paymentProvider!=="none"}var Jn=[{key:"frontend",label:"Frontend framework",hint:"Nuxt (Vue) or Next.js (React).",category:"Project",kind:"enum",default:"nuxt",choices:Re,adoptable:!1,impact:"structural"},{key:"architecture",label:"Architecture",hint:"Fullstack (frontend hosts the API) or a standalone Hono backend.",category:"Infrastructure",kind:"enum",default:"fullstack",choices:Ge,adoptable:!1,impact:"structural"},{key:"deploymentTarget",label:"Deployment target",hint:"Node.js / Docker or Vercel serverless.",category:"Infrastructure",kind:"enum",default:"node",choices:ce,adoptable:!1,impact:"config"},{key:"databaseProvider",label:"Database provider",hint:"Self-hosted PostgreSQL, Neon, or Supabase.",category:"Infrastructure",kind:"enum",default:"postgres",choices:pe,adoptable:!1,impact:"config"},{key:"cacheProvider",label:"Cache provider",hint:"Self-hosted Redis or Upstash.",category:"Infrastructure",kind:"enum",default:"redis",choices:le,adoptable:!1,impact:"config"},{key:"paymentProvider",label:"Payment provider",hint:"Stripe, Polar, or none.",category:"Features",kind:"enum",default:"none",choices:Ke,adoptable:!1,impact:"structural"},{key:"defaultCurrency",label:"Default currency",hint:"Billing and pricing currency.",category:"Features",kind:"enum",default:"USD",choices:se,adoptable:!1,impact:"config"},{key:"emailProvider",label:"Email provider",hint:"SMTP, Amazon SES, or Resend.",category:"Features",kind:"enum",default:"smtp",choices:He,adoptable:!1,impact:"config"},{key:"multiTenancy",label:"Multi-tenancy (organizations)",hint:"Adds organizations - teams, members, and shared resources.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"blog",label:"Blog",hint:"Adds the marketing blog (content collection, list and post pages).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{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"},{key:"desktop",label:"Desktop app",hint:"Adds the cross-platform desktop app (apps/electron, built with Electron).",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"ai",label:"AI features",hint:"Adds the AI surface (chat, models, schedules, integrations) and unlocks the companion option. A desktop project ALWAYS ships the app's local AI stack: this option sets config.desktop.agents.enabled (the runtime gate on those screens) and decides whether a companion daemon is bundled inside the packaged app. Off keeps config.ai.enabled false so the AI nav stays hidden.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural"},{key:"companion",label:"Companion daemon",hint:"Lets your users install a companion daemon that runs their own AI subscriptions (and any device-side work you add) on their hardware. Point it at an existing shared companion like OpenCompanion (default, nothing to maintain), or vendor and publish your own branded daemon.",category:"Features",kind:"boolean",default:!1,adoptable:!0,impact:"structural",requires:e=>e.ai===!0,requiresLabel:"requires AI features"},{key:"companionSource",label:"Companion source",hint:"Point at an existing shared companion repo (like OpenCompanion), or vendor a branded daemon you own and publish yourself.",category:"Features",kind:"enum",default:e=>H(e),choices:Pe,adoptable:!0,impact:"structural",requires:e=>e.companion===!0||e.desktop===!0&&e.ai===!0,requiresLabel:"requires the companion, or a desktop app with AI"},{key:"companionRepoUrl",label:"Companion repo URL",hint:"GitHub repository of the shared companion this project points at. Its brand.json supplies the daemon identity; your users install from its latest release.",category:"Features",kind:"text",default:()=>Te,adoptable:!0,impact:"config",requires:e=>e.companion===!0&&de(e)==="shared",requiresLabel:"requires a shared-source companion"},{key:"companionName",label:"Companion name",hint:"What your users install - the display name of your branded companion daemon.",category:"Features",kind:"text",default:e=>W(e.projectName),adoptable:!0,impact:"config",requires:e=>ue(e),requiresLabel:"requires a bundled daemon: a vendored companion, or a desktop app with AI"},{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",requires:e=>ut(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"},{key:"dockerServices",label:"Docker services",hint:"Local services scaffolded in docker-compose.",category:"Tooling",kind:"multiselect",default:[],choices:ze,adoptable:!1,impact:"config"},{key:"aiTools",label:"AI coding tools",hint:"Which AI assistants receive the bundled skill files.",category:"Tooling",kind:"multiselect",default:[],choices:Je,adoptable:!1,impact:"config"}];function si(e,t){return e[t]!==void 0}function Yn(e){return Jn.filter(t=>t.adoptable&&!si(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 qn(e){let t={};for(let n of Jn)if(typeof n.default=="function"){if(n.requires&&!n.requires(e))continue;t[n.key]=n.default(e)}else t[n.key]=Array.isArray(n.default)?[...n.default]:n.default;return{...t,...e}}import{readFile as Xn}from"fs/promises";import{join as ci}from"path";var qe="GENERATESAAS_COMPANION_BRAND_JSON",Wn=["daemon/brand.json","apps/companion/brand.json"];function oe(e){let t=e.trim(),n;try{n=new URL(t)}catch{throw new Error(`Invalid companion repo URL "${t}". Use a full GitHub URL like https://github.com/owner/repo.`)}if(n.protocol!=="https:"&&n.protocol!=="http:")throw new Error(`Invalid companion repo URL "${t}". Use a full GitHub URL like https://github.com/owner/repo.`);let r=n.hostname.toLowerCase();if(r!=="github.com"&&r!=="www.github.com")throw new Error(`Only GitHub-hosted shared companions are supported right now (got "${n.hostname}"). Host the companion on GitHub, or vendor your own with --companion-source vendored.`);let o=n.pathname.split("/").filter(Boolean),i=o[0],a=o[1]?.replace(/\.git$/,"");if(!i||!a)throw new Error(`"${t}" is missing the owner/repo path. Use a full GitHub URL like https://github.com/owner/repo.`);return{owner:i,repo:a,canonicalUrl:`https://github.com/${i}/${a}`}}function Zn(e,t){return e.owner.toLowerCase()===t.owner.toLowerCase()&&e.repo.toLowerCase()===t.repo.toLowerCase()}function on(e,t){let n;try{n=JSON.parse(e)}catch{throw new Error(`The companion brand.json from ${t} is not valid JSON.`)}if(typeof n!="object"||n===null)throw new Error(`The companion brand.json from ${t} is not a JSON object.`);let r=n;for(let o of["name","binary","envPrefix"]){let i=r[o];if(typeof i!="string"||i.trim()==="")throw new Error(`The companion brand.json from ${t} is missing a usable "${o}" field. Point at a companion repo built with the GenerateSaaS export pipeline, or vendor your own with --companion-source vendored.`)}return{name:r.name,binary:r.binary,envPrefix:r.envPrefix}}function pi(e,t,n){let r=JSON.parse(e).repoUrl;if(typeof r!="string"||r.trim()==="")return;let o;try{o=oe(r)}catch{throw new Error(`The companion brand.json from ${t} names an unusable repoUrl ("${r}"), so it cannot be verified against ${n.canonicalUrl}. Fix that brand.json, or unset ${qe} to fetch the identity from GitHub.`)}if(!Zn(o,n))throw new Error(`The companion brand.json from ${t} belongs to ${o.canonicalUrl}, but the project points at ${n.canonicalUrl}. Point ${qe} and --companion-repo-url at the same companion, or unset ${qe} to fetch the identity from GitHub.`)}async function li(e,t){let n=ci(e,"apps/companion/brand.json"),r;try{r=await Xn(n,"utf8")}catch(a){if(typeof a=="object"&&a!==null&&"code"in a&&a.code==="ENOENT")return null;throw a}let o;try{o=JSON.parse(r).repoUrl}catch{throw new Error("The template's apps/companion/brand.json is not valid JSON (boilerplate drift).")}if(typeof o!="string"||o.trim()==="")return null;let i;try{i=oe(o)}catch{return null}return Zn(i,t)?on(r,`the template (${n})`):null}async function di(e){for(let t of Wn){let n=`https://raw.githubusercontent.com/${e.owner}/${e.repo}/HEAD/${t}`,r;try{r=await fetch(n)}catch(o){throw new Error(`Could not reach GitHub to read the companion identity (${n}): ${I(o)}. Check your network, or set GENERATESAAS_COMPANION_BRAND_JSON to a local brand.json.`)}if(r.status!==404){if(!r.ok)throw new Error(`GitHub returned ${r.status} for ${n}. Check that ${e.canonicalUrl} exists and is public.`);return on(await r.text(),n)}}throw new Error(`No brand.json found in ${e.canonicalUrl} (tried ${Wn.join(" and ")} on the default branch). Point --companion-repo-url at a companion repo built with the GenerateSaaS export pipeline.`)}async function Qn(e){let t=e.companionRepoUrl?.trim();if(!t)throw new Error("resolveSharedCompanionBrand: companionRepoUrl is missing for a shared-source companion.");let n=oe(t),r=await li(e.projectDir,n);if(r)return r;let o=process.env[qe]?.trim();if(o){let i;try{i=await Xn(o,"utf8")}catch(u){throw new Error(`Could not read ${qe} (${o}): ${I(u)}.`)}let a=`${qe} (${o})`,s=on(i,a);return pi(i,a,n),s}return await di(n)}var tr=["companion"];function an(e){if(!tr.some(n=>e[n]===!0))return e;if(e.ai===!1)throw new Error("--companion requires AI features; remove --no-ai.");return e.ai===void 0&&(e.ai=!0),e}function nr(e){return tr.some(n=>e[n]===!0)&&(e.ai=!0),e}function rr(e){let t=e.desktopAi;e.companion!==!0&&e.companionSource==="shared"&&delete e.companionSource;let n=ui(e,t);return delete e.desktopAi,n.kind!=="shared-source-contradiction"&&sn(e),n}function sn(e){return ue(e)&&(e.companionSource=H(e),e.companionName===void 0&&(e.companionName=W(e.projectName))),e}function ui(e,t){return e.desktop!==!0?{kind:"none"}:e.ai===!0&&e.companionSource==="shared"?{kind:"shared-source-contradiction"}:t===!0&&e.ai!==!0?{kind:"legacy-desktop-ai"}:t===!1&&e.ai===!0?{kind:"desktop-gains-ai"}:e.ai===!0&&e.companionName===void 0?{kind:"daemon-materialized"}:{kind:"none"}}function or(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.frontend!==void 0){if(!Re.includes(e.frontend))throw new Error(`Invalid frontend "${e.frontend}". Valid values: ${Re.join(", ")}`);t.frontend=e.frontend}if(e.architecture!==void 0&&(t.architecture=e.architecture),e.payment!==void 0&&(t.paymentProvider=e.payment),e.email!==void 0&&(t.emailProvider=e.email),e.org!==void 0&&(t.multiTenancy=e.org),e.blog!==void 0&&(t.blog=e.blog),e.docs!==void 0&&(t.docs=e.docs),e.desktop!==void 0&&(t.desktop=e.desktop),e.ai!==void 0&&(t.ai=e.ai),e.companion!==void 0&&(t.companion=e.companion),e.companionSource!==void 0){if(!Pe.includes(e.companionSource))throw new Error(`Invalid companion source "${e.companionSource}". Valid values: ${Pe.join(", ")}`);if(e.companion===!1)throw new Error("--companion-source requires the companion; remove --no-companion.");t.companionSource=e.companionSource,t.companion===void 0&&(t.companion=!0)}if(e.companionRepoUrl!==void 0){if(e.companion===!1)throw new Error("--companion-repo-url requires the companion; remove --no-companion.");t.companionRepoUrl=oe(e.companionRepoUrl).canonicalUrl,t.companion===void 0&&(t.companion=!0)}if(t.companionSource==="vendored"&&t.companionRepoUrl!==void 0)throw new Error("--companion-repo-url applies to a shared companion; remove it or use --companion-source shared.");if(an(t),e.desktop===!0&&t.ai===!0&&t.companionRepoUrl!==void 0)throw new Error("--companion-repo-url points at a SHARED companion, but a desktop app with AI bundles its own; remove it, or turn AI off with --no-ai.");if(e.revenueSharing!==void 0&&(t.revenueSharing=e.revenueSharing),e.credits!==void 0){if(e.credits===!0&&e.payment==="none")throw new Error("--credits requires a payment provider (got --payment none).");t.credits=e.credits}if(e.docker!==void 0&&(t.dockerServices=er(e.docker,ze,"docker service")),e.aiTools!==void 0&&(t.aiTools=er(e.aiTools,Je,"AI tool")),e.currency!==void 0){if(!se.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${se.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!ce.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${ce.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!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(!le.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${le.join(", ")}`);t.cacheProvider=e.cache}if(e.demo===!0&&(t.demo=!0),e.baseUrl!==void 0){let n=e.baseUrl.trim();if(n==="")throw new Error("--base-url cannot be empty. Provide an absolute URL like https://example.com.");let r;try{r=new URL(n)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(r.protocol!=="http:"&&r.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${r.protocol}//${r.host}`}return t}var ye={projectName:"my-saas",frontend:"nextjs",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,blog:!0,docs:!1,desktop:!1,ai:!1,companion:!1,revenueSharing:!1,credits:!0,dockerServices:["postgres","redis","inngest"],aiTools:[],defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"};function ir(e){let t=e.projectName??ye.projectName,n=e.projectDir??`./${t}`,r=e.appName??Ye(t),o=e.deploymentTarget??ye.deploymentTarget,i=ne[o]?.edgeRuntime??!1,a=e.databaseProvider??(i?"neon":ye.databaseProvider),s=e.cacheProvider??(i?"upstash":ye.cacheProvider),u=e.emailProvider??(i?"resend":ye.emailProvider),g=e.dockerServices??(i?ye.dockerServices.filter(h=>h!=="postgres"&&h!=="redis"):ye.dockerServices),l={...ye,...e,projectName:t,appName:r,projectDir:n,deploymentTarget:o,databaseProvider:a,cacheProvider:s,emailProvider:u,dockerServices:g};l.paymentProvider==="none"&&(l.credits=!1),l.desktop&&l.ai&&(l.companionSource=H(l)),ue(l)&&l.companionName===void 0&&(l.companionName=W(l.projectName)),l.companion&&(l.companionSource===void 0&&(l.companionSource=de(l)),l.companionSource==="vendored"?l.companionName===void 0&&(l.companionName=W(l.projectName)):l.companionRepoUrl===void 0&&(l.companionRepoUrl=Te));for(let h of lt){if(l.deploymentTarget!==h.target)continue;let S=l.databaseProvider===h.provider?"database":"cache";if(l.databaseProvider===h.provider||l.cacheProvider===h.provider)throw new Error(`Incompatible: --deploy ${h.target} + --${S} ${h.provider}. ${h.reason}`)}for(let h of dt)if(l.architecture===h.architecture&&l.deploymentTarget===h.target)throw new Error(`Incompatible: --architecture ${h.architecture} + --deploy ${h.target}. ${h.reason}`);return l}function er(e,t,n){if(e.trim()==="")return[];let r=e.split(",").map(i=>i.trim()).filter(Boolean),o=r.filter(i=>!t.includes(i));if(o.length>0)throw new Error(`Invalid ${n}(s): ${o.join(", ")}. Valid values: ${t.join(", ")}`);return r}function A(e){m.isCancel(e)&&(m.cancel("Setup cancelled."),process.exit(0))}function cn(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 ar(e,t){let n=!1;e&&an(e),m.log.info(f.bold("Project"));let r=e?.projectName??await(async()=>{n=!0;let c=await m.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 A(c),c})(),o=e?.appName??await(async()=>{n=!0;let c=await m.text({message:"App name:",initialValue:Ye(r),validate:d=>{if(!d?.trim())return"App name is required."}});return A(c),c})(),i=e?.projectDir??await(async()=>{n=!0;let c=await m.text({message:"Project location:",initialValue:`./${r}`});return A(c),c==="."?process.cwd():c})(),a=e?.frontend??await(async()=>{n=!0;let c=Object.keys(st),d=await m.select({message:"Frontend framework:",options:c.map(b=>({value:b,label:st[b].label,hint:st[b].hint}))});return A(d),d})();m.log.info(f.bold("Infrastructure"));let s=e?.deploymentTarget??"node";if(e?.deploymentTarget===void 0){n=!0;let c=await m.select({message:"Deployment target:",options:ce.map(d=>({value:d,label:ne[d].label,hint:ne[d].hint}))});A(c),s=c}let u=e?.architecture?dt.find(c=>c.architecture===e.architecture&&c.target===s):void 0;if(u)throw new Error(`Incompatible: --architecture ${u.architecture} + --deploy ${u.target}. ${u.reason}`);let g=new Set(dt.filter(c=>c.target===s).map(c=>c.architecture)),l=Ge.filter(c=>!g.has(c)),h=e?.architecture??await(async()=>{if(l.length===1){let d=l[0];return m.log.info(`Auto-selected ${ct[d].label} architecture (only compatible option for ${ne[s].label}).`),d}n=!0;let c=await m.select({message:"Architecture:",options:l.map(d=>({value:d,label:ct[d].label,hint:ct[d].hint}))});return A(c),c})(),S=e?.databaseProvider??await(async()=>{n=!0;let c=pe.filter(b=>!lt.some(q=>q.target===s&&q.provider===b));if(c.length===1){let b=c[0];return m.log.info(`Auto-selected ${K[b].label} (only compatible option for ${ne[s].label}).`),b}let d=await m.select({message:"Database provider:",options:c.map(b=>({value:b,label:K[b].label,hint:K[b].hint}))});return A(d),d})(),C=e?.cacheProvider??await(async()=>{n=!0;let c=le.filter(b=>!lt.some(q=>q.target===s&&q.provider===b));if(c.length===1){let b=c[0];return m.log.info(`Auto-selected ${re[b].label} (only compatible option for ${ne[s].label}).`),b}let d=await m.select({message:"Cache provider:",options:c.map(b=>({value:b,label:re[b].label,hint:re[b].hint}))});return A(d),d})();if(ne[s]?.edgeRuntime){let c=Hn.map(d=>` - ${d}`).join(`
|
|
3
|
+
`);m.note(c,"Unavailable on edge runtime")}m.log.info(f.bold("Features"));let E=e?.paymentProvider??await(async()=>{n=!0;let c=await m.select({message:"Payment provider:",options:Ke.map(d=>({value:d,label:xt[d].label,hint:xt[d].hint}))});return A(c),c})(),N=e?.defaultCurrency??await(async()=>{if(E==="none")return"USD";n=!0;let c=await m.select({message:"Default currency:",options:se.map(d=>({value:d,label:d,hint:Ie[d].name}))});return A(c),c})(),te=e?.emailProvider??await(async()=>{n=!0;let c=await m.select({message:"Email provider:",options:He.map(d=>({value:d,label:Ot[d].label,hint:Ot[d].hint}))});return A(c),c})(),Fe=e?.multiTenancy??await(async()=>{n=!0;let c=await m.confirm({message:"Enable multi-tenancy (organizations)?",initialValue:!1});return A(c),c})(),ae=e?.blog??await(async()=>{n=!0;let c=await m.confirm({message:"Enable blog?",initialValue:!0});return A(c),c})(),Ee=e?.docs??await(async()=>{n=!0;let c=await m.confirm({message:"Include docs app? (self-hosted Fumadocs documentation site)",initialValue:!1});return A(c),c})(),Ve=t?.desktopAllowed!==!1,he=e?.desktop??(Ve?await(async()=>{n=!0;let c=await m.confirm({message:"Include the desktop app? (apps/electron - cross-platform, built with Electron, device-auth). With AI on, it also runs a local AI stack and bundles its own companion daemon.",initialValue:!1});return A(c),c})():(m.log.info(f.dim("Desktop app: available on the Pro plan and up - skipped.")),!1)),y=e?.ai??await(async()=>{n=!0;let c=await m.confirm({message:"Add AI features? (chat, models, schedules, integrations - and unlocks the companion)",initialValue:!1});return A(c),c})(),O=t?.companionAllowed!==!1,j=y?e?.companion??(O?await(async()=>{n=!0;let c=await m.confirm({message:"Add the companion daemon for your WEB users? A small program they install on their own machine or VPS to run their Claude Code / Codex / OpenCode subscription for this app 24/7 - the AI runs on their hardware, not yours. Off means no install UI and no pairing endpoint on your site; you can adopt it later.",initialValue:!1});return A(c),c})():(m.log.info(f.dim("Companion: available on the Pro plan and up - skipped.")),!1)):!1,Y=he&&y,w=Y?H({desktop:he,ai:y,companion:j,companionSource:e?.companionSource,companionName:e?.companionName}):j?e?.companionSource??await(async()=>{n=!0;let c=await m.select({message:"Companion source:",options:[{value:"shared",label:"Shared companion",hint:"point at an existing companion repo (OpenCompanion by default) - nothing to publish or maintain"},{value:"vendored",label:"Vendored companion",hint:"own a branded daemon: source in this repo, published to your own GitHub repo"}],initialValue:"shared"});return A(c),c})():void 0;Y&&m.log.info(f.dim("Companion source: your desktop app bundles its own daemon, so it is vendored into this repo. Nothing to publish - it ships inside the app."));let M=w!=="shared"?void 0:e?.companionRepoUrl??await(async()=>{n=!0;let c=await m.text({message:"Companion repo URL (GitHub):",initialValue:Te,validate:d=>{if(!d?.trim())return"A companion repo URL is required for a shared companion.";try{oe(d)}catch(b){return I(b)}}});return A(c),oe(c).canonicalUrl})(),Ae=w!=="vendored"?void 0:e?.companionName??await(async()=>{n=!0;let c=await m.text({message:Y&&!j?"Companion name (your app's bundled daemon - names its binary, service and data folder):":"Companion name (what your users install):",initialValue:W(r),validate:d=>{if(!d?.trim())return"Companion name is required."}});return A(c),c})(),ot=e?.revenueSharing??await(async()=>{n=!0;let c=await m.confirm({message:"Enable revenue sharing? (opt-in MRR leaderboard with dofollow backlinks)",initialValue:!1});return A(c),c})(),Vn=E==="none"?!1:e?.credits??await(async()=>{n=!0;let c=await m.confirm({message:"Enable credits? (metered usage on top of subscription plans)",initialValue:!0});return A(c),c})();m.log.info(f.bold("Tooling"));let en=e?.dockerServices??await(async()=>{n=!0;let c=[...ze].filter(F=>F!=="mailpit");te==="smtp"&&c.push("mailpit");let d=c.map(F=>({value:F,label:Be[F].label,hint:Be[F].hint})),b=d.map(F=>F.value).filter(F=>!(F==="postgres"&&(S==="neon"||S==="supabase")||F==="redis"&&C==="upstash")),q=await m.multiselect({message:"Which services should we set up in Docker for you?",options:d,initialValues:b,required:!1});return A(q),q})(),tn=e?.aiTools??await(async()=>{n=!0;let c=Je.map(b=>({value:b,label:pt[b].label})),d=await m.multiselect({message:"Which AI coding tools do you use?",options:c,initialValues:[],required:!1});return A(d),d})(),nn=e?.demo,Tt=cn({databaseProvider:S,cacheProvider:C,paymentProvider:E,emailProvider:te,demo:nn}),it={};if(Tt.length>0&&n){m.log.info(f.bold("Credentials")+f.dim(" all optional - press Enter to skip, fill in .env later"));for(let c of Tt)if(n=!0,c.secret){let d=await m.password({message:c.message,mask:"*"});A(d),typeof d=="string"&&d.trim()&&(it[c.key]=d.trim())}else{let d=await m.text({message:c.message,placeholder:c.placeholder});A(d),typeof d=="string"&&d.trim()&&(it[c.key]=d.trim())}}if(n){let c=[` Name: ${f.cyan(r)}`,` App name: ${f.cyan(o)}`,` Location: ${f.cyan(i)}`,` Frontend: ${f.cyan(st[a].label)}`,` Architecture: ${f.cyan(ct[h].label)}`].join(`
|
|
4
|
+
`),d=[` Deploy target: ${f.cyan(ne[s]?.label??"Node.js / Docker")}`,` Database: ${f.cyan(K[S].label)}`,` Cache: ${f.cyan(re[C].label)}`,en.length>0?` Docker: ${f.cyan(en.map(at=>Be[at].label).join(", "))}`:` Docker: ${f.dim("none")}`].filter(Boolean).join(`
|
|
5
|
+
`),b=[E!=="none"?` Payment: ${f.cyan(xt[E].label)} (${N})`:` Payment: ${f.dim("none")}`,` Credits: ${Vn?f.cyan("Yes"):f.dim("No")}`,` AI features: ${y?f.cyan("Yes"):f.dim("No")}`,...y?[` Companion: ${j?f.cyan("Yes"):f.dim("No")}`,...j?[` Comp. source: ${f.cyan(w==="shared"?"Shared":"Vendored")}`,w==="shared"?` Comp. repo: ${f.cyan(M??"")}`:` Comp. name: ${f.cyan(Ae??"")}`]:[]]:[],` Email: ${f.cyan(Ot[te].label)}`,` Multi-tenancy: ${Fe?f.cyan("Yes"):f.dim("No")}`,` Blog: ${ae?f.cyan("Yes"):f.dim("No")}`,` Docs app: ${Ee?f.cyan("Yes"):f.dim("No")}`,` Desktop app: ${he?f.cyan("Yes"):f.dim("No")}`,...Y&&!j?[` Desktop AI: ${f.cyan("Yes")} (bundles ${Ae??""})`]:[],` Rev. sharing: ${ot?f.cyan("Yes"):f.dim("No")}`,tn.length>0?` AI tools: ${f.cyan(tn.map(at=>pt[at].label).join(", "))}`:` AI tools: ${f.dim("none")}`].join(`
|
|
6
|
+
`),q=[f.bold("Project"),c,"",f.bold("Infrastructure"),d,"",f.bold("Features"),b];if(Tt.length>0){let at=Tt.map(Bn=>{let ai=it[Bn.key]?f.green("provided"):f.dim("skipped");return` ${Bn.key}: ${ai}`}).join(`
|
|
7
|
+
`);q.push("",f.bold("Credentials"),at)}m.note(q.join(`
|
|
8
|
+
`),"Summary");let F=await m.confirm({message:"Proceed with these settings?"});(m.isCancel(F)||!F)&&(m.cancel("Setup cancelled."),process.exit(0))}return{projectName:r,appName:o,projectDir:i,frontend:a,architecture:h,deploymentTarget:s,databaseProvider:S,cacheProvider:C,paymentProvider:E,emailProvider:te,multiTenancy:Fe,blog:ae,docs:Ee,desktop:he,ai:y,companion:j,...Ae!==void 0?{companionName:Ae}:{},...w!==void 0?{companionSource:w}:{},...M!==void 0?{companionRepoUrl:M}:{},revenueSharing:ot,credits:Vn,dockerServices:en,aiTools:tn,defaultCurrency:N,...Object.keys(it).length>0?{credentials:it}:{},...e?.baseUrl!==void 0?{baseUrl:e.baseUrl}:{},...nn!==void 0?{demo:nn}:{}}}import{createReadStream as fr,existsSync as Ai}from"fs";import{mkdir as Ii}from"fs/promises";import{join as Ri}from"path";import{Readable as Pi}from"stream";import{pipeline as gn}from"stream/promises";import{extract as Ti}from"tar";import{join as _e}from"path";import{homedir as mi}from"os";var mt=process.env.GENERATESAAS_API_URL??"https://cli.generatesaas.com",V=".generatesaas",we=_e(V,"manifest.json"),sr=_e(V,"hashes.json"),Lt=_e(V,"template-hashes.json"),jt=_e(V,"template"),cr=_e(V,"staging"),pr=_e(V,"staging.json"),me=_e(mi(),".generatesaas");var $=class extends Error{constructor(n,r,o){super(r);this.status=n;this.body=o}status;body;name="ApiError"};function fe(e){return{apiKey:e,baseUrl:mt}}async function ve(e,t,n){let r=`${e.baseUrl}${t}`,o=await fetch(r,{...n,headers:{...n?.headers,Authorization:`Bearer ${e.apiKey}`,"User-Agent":"generatesaas-cli/2.2.0"}});if(!o.ok){let i,a;try{a=await o.json(),i=a.error??`API ${o.status}: ${t}`}catch{i=`API ${o.status}: ${t}`}throw new $(o.status,i,a)}return o}import{existsSync as fi,readFileSync as gi,writeFileSync as hi,mkdirSync as yi}from"fs";import{dirname as wi}from"path";import*as ke from"@clack/prompts";function ft(){if(!fi(me))return null;try{let e=JSON.parse(gi(me,"utf-8"));return e.apiKey?e.apiKey:(e.token&&!e.apiKey&&ke.log.warning(`Found old GitHub token in ${me}. Run 'generatesaas init' to set up your API key.`),null)}catch{return null}}function xe(e){yi(wi(me),{recursive:!0}),hi(me,JSON.stringify({apiKey:e},null," ")+`
|
|
9
|
+
`,{mode:384})}async function We(e){if(e?.apiKey)return e.apiKey;let t=process.env.GENERATESAAS_API_KEY;if(t)return t;let n=ft();if(n)return n;if(!e?.prompt)throw new Error("API key not found. Set GENERATESAAS_API_KEY or run 'generatesaas init' to configure.");return gt()}async function gt(){let e=await ke.text({message:"Enter your GenerateSaaS API key:",placeholder:"gs_live_...",validate:t=>{if(!t?.trim())return"API key is required."}});return ke.isCancel(e)&&(ke.cancel("Setup cancelled."),process.exit(0)),e.trim()}import{readFile as vi}from"fs/promises";async function be(e){let t=process.env.GENERATESAAS_VERSION_INDEX;return t?JSON.parse(await vi(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 ve(e,"/versions")).json()}async function pn(e,t){if(process.env.GENERATESAAS_OFFLINE_LICENSE==="1")return null;try{return await(await ve(e,`/changelog/${encodeURIComponent(t)}`)).text()}catch(n){if(n instanceof $&&n.status===404)return null;throw n}}async function lr(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{skillMd:`# Offline skill stub
|
|
10
|
+
`,scripts:{}}:await(await ve(e,`/skill/${encodeURIComponent(t)}`)).json()}function Ut(e){if(!(e instanceof $)||e.status!==403)return null;let t=e.body;return!t||t.code!=="update_window_expired"?null:{message:e.message,lastAllowedVersion:t.lastAllowedVersion??null}}function dr(e){return{frontend:e.frontend,architecture:e.architecture,deployTarget:e.deploymentTarget,database:e.databaseProvider,cache:e.cacheProvider,payment:e.paymentProvider,email:e.emailProvider,multiTenancy:e.multiTenancy,blog:e.blog,docs:e.docs,desktop:e.desktop,companion:e.companion,credits:e.credits,revenueSharing:e.revenueSharing,aiTools:e.aiTools,currency:e.defaultCurrency}}async function ln(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{token:"offline-test-token",licenseId:"offline-test-license-id",installId:t.installId}:await(await ve(e,"/license/sign",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function ur(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{token:t.currentToken}:await(await ve(e,"/license/refresh",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function dn(e,t){let n=await fetch(`${e}/license/verify`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!n.ok)throw new Error(`Verification service returned ${n.status}`);return await n.json()}async function mr(e,t,n){let r=await fetch(`${e}/license/inspect`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t}`},body:JSON.stringify(n)});if(!r.ok){let o=await r.json().catch(()=>null);throw new Error(o?.error??`Inspect endpoint returned ${r.status}`)}return await r.json()}var un=new Set([".git","node_modules",".pnpm-store",".env",".env.test",".turbo",".nuxt",".output",".data","dist",".next",".svelte-kit",".wrangler",".devcontainer","playwright-report","test-results"]),mn=new Set(["pnpm-lock.yaml"]);function Xe(e){if(fn(e))return!0;for(let t of e.split("/"))if(mn.has(t))return!0;return!1}var ki=new Set(["data","mksaas","references","scripts",".cursor",".agents",".codex",".generatesaas",".vscode",".mcp.json","README.md","TODO.md","OVERVIEW.md"]),bi=["scripts/docs-lint.ts"],Si=["scripts/companion-export/"],Ei=["docs/superpowers","packages/cli","packages/cli-api","docs/opencompanion","infra/docker-compose.yml",".claude/commands",".claude/skills/web-next-port",".claude/skills/web-next-port-workspace",".claude/settings.local.json",".claude/worktrees"];function fn(e){let t=e.split("/");for(let n of t)if(un.has(n))return!0;if(bi.includes(e))return!1;for(let n of Si)if(e.startsWith(n)||`${e}/`===n)return!1;if(ki.has(t[0]))return!0;for(let n of Ei)if(e===n||e.startsWith(n+"/"))return!0;return!1}async function Mt(e,t,n){await Ii(n,{recursive:!0});let r=process.env.GENERATESAAS_TEMPLATE_TARBALL_DIR;if(r){let s=Ri(r,`v${t}.tar.gz`);if(!Ai(s))throw new Error(`GENERATESAAS_TEMPLATE_TARBALL_DIR is set but ${s} does not exist.`);await gn(fr(s),hn(n));return}let o=process.env.GENERATESAAS_TEMPLATE_TARBALL;if(o){await gn(fr(o),hn(n));return}let i=await ve(e,`/template/${encodeURIComponent(t)}`);if(!i.body)throw new Error("Empty response body");let a=Pi.fromWeb(i.body);await gn(a,hn(n))}function hn(e){return Ti({cwd:e,strip:1,filter:t=>{let n=t.replace(/^[^/]+\//,"");return n?!fn(n):!0},sync:!1})}import{readdir as Vi,readFile as vt,rm as yn,writeFile as kt}from"fs/promises";import{join as ge}from"path";import{readFile as wt,rm as ji}from"fs/promises";import{join as yt}from"path";import{mkdir as _i,readdir as xi,rm as Oi,rmdir as Di,writeFile as Ci}from"fs/promises";import{dirname as Ft,join as Ni,relative as $i,sep as Li}from"path";function Oe(e){return e.split(Li).join("/")}async function Vt(e){await _i(e,{recursive:!0})}async function p(e,t){await Vt(Ft(e)),await Ci(e,t,"utf-8")}async function ht(e,t){await Oi(e,{force:!0});let n=Ft(e);for(;n!==t&&n!==Ft(n);){try{await Di(n)}catch{return}n=Ft(n)}}async function De(e,t,n){let r=[],o=await xi(e,{withFileTypes:!0});for(let i of o){let a=Ni(e,i.name),s=Oe($i(t,a));n(s)||(i.isDirectory()?r.push(...await De(a,t,n)):i.isFile()&&r.push(a))}return r}function Ui(e){return new RegExp(`^[ \\t]*(?:\\/\\/|\\{\\/\\*|\\*) gsaas:${e}-start(?: \\*\\/\\})?[ \\t]*\\r?\\n[\\s\\S]*?^[ \\t]*(?:\\/\\/|\\{\\/\\*|\\*) gsaas:${e}-end(?: \\*\\/\\})?[ \\t]*\\r?\\n`,"gm")}function Se(e,t,n,r){let o=Ui(n);if(e.match(o)===null)throw new Error(`${r}: expected gsaas ${n} markers in ${t}, but found none (boilerplate drift).`);let i=e.replace(o,"");if(i.includes(`gsaas:${n}-start`)||i.includes(`gsaas:${n}-end`))throw new Error(`${r}: an unbalanced gsaas ${n} marker is left in ${t} (boilerplate drift).`);return i.replace(/\n{3,}/g,`
|
|
11
|
+
|
|
12
|
+
`)}async function B(e,t,n,r,o){let i=await wt(e,"utf-8"),a=i.indexOf(t);if(a===-1)throw new Error(`${o}: expected to find the ${r} seam, but it was missing (boilerplate drift).`);if(i.indexOf(t,a+t.length)!==-1)throw new Error(`${o}: the ${r} seam appears more than once (boilerplate drift).`);await p(e,i.slice(0,a)+n+i.slice(a+t.length))}async function Bt(e,t,n,r){let o=/\n([\t ]+)"/.exec(await wt(e,"utf-8"))?.[1];if(o!==n){let i=a=>a===" "?"tab":`${a.length}-space`;throw new Error(`${r}: expected ${e} to be ${i(n)}-indented, but it is ${o===void 0?"not indented":i(o)}-indented (boilerplate drift). Re-serializing it with the wrong indent would reformat the whole file.`)}await p(e,`${JSON.stringify(t,null,n)}
|
|
13
|
+
`)}function Gt(e){return e.frontend==="nextjs"?"next":"nuxt"}async function Mi(e,t,n,r){let o=yt(e,"ai.mdx"),a=(await wt(o,"utf-8")).split(`
|
|
14
|
+
`).find(s=>s.includes(`href="${n}"`));if(a===void 0)throw new Error(`${r}: expected the ai.mdx card linking to ${n} (boilerplate drift).`);await B(o,`${a}
|
|
15
|
+
`,"",`${t} ai.mdx ${n} card`,r)}async function Fi(e,t,n,r){let o=yt(e,"ai.mdx"),i=`| **${n}** |`,s=(await wt(o,"utf-8")).split(`
|
|
16
|
+
`).find(u=>u.startsWith(i));if(s===void 0)throw new Error(`${r}: expected the ai.mdx "${n}" hub-table row (boilerplate drift).`);await B(o,`${s}
|
|
17
|
+
`,"",`${t} ai.mdx ${n} hub-table row`,r)}async function gr(e,t,n,r,o,i){let a=yt(e,"docs",t);await ji(yt(a,n),{recursive:!0}),await B(yt(a,"meta.json"),` "${n}",
|
|
18
|
+
`,"",`${t} meta.json ${n} nav entry`,o);for(let s of r)await Mi(a,t,s,o);i!==void 0&&await Fi(a,t,i,o)}async function hr(e){let t=`import { config } from "@repo/config";
|
|
19
|
+
`,n=await wt(e,"utf-8");if(!n.includes(t))return;let r=n.replace(t,""),o=r.replace(/\/\*[\s\S]*?\*\//g,"").replace(/\/\/[^\n]*/g,"").replace(/"(?:\\.|[^"\\])*"/g,'""').replace(/'(?:\\.|[^'\\])*'/g,"''").replace(/`(?:\\.|[^`\\])*`/g,"``");/\bconfig\b/.test(o)||await p(e,r)}var Bi=["apps/web-nuxt/public/images/blog","apps/web-next/public/images/blog","packages/content/en/blog","packages/content/ro/blog"];async function wr(e){await Promise.all(Bi.map(t=>yn(ge(e,t),{recursive:!0,force:!0})))}var Gi=["apps/electron/src/renderer/router.tsx","apps/electron/src/renderer/config/sidebar.ts"];async function vr(e){let t="removeDesktopDemoScreen";await yn(ge(e,"apps/electron/src/renderer/screens/demo"),{recursive:!0});for(let n of Gi){let r=ge(e,n);await kt(r,Se(await vt(r,"utf-8"),n,"demo",t))}}var Ki="packages/config/src/blog.ts";async function kr(e){let t=ge(e,Ki),n=await vt(t,"utf-8"),r=yr(yr(n,"blogCategories",t),"blogAuthors",t);await kt(t,r)}function yr(e,t,n){let r=new RegExp(`(export const ${t}\\b[^=]*=\\s*)\\[[\\s\\S]*?\\];`);if(!r.test(e))throw new Error(`emptyBlogConfig: could not find the \`export const ${t} = [...]\` declaration in ${n}. The boilerplate blog config may have been renamed or restructured; update the CLI strip in cleanup.ts.`);return e.replace(r,"$1[];")}async function br(e){let t=ge(e,"packages/i18n/translations"),n;try{n=await Vi(t)}catch{return}for(let r of n){let o=ge(t,r,"web.json"),i;try{i=await vt(o,"utf-8")}catch{continue}let a=JSON.parse(i);!a.blog||a.blog.categories===void 0||(a.blog.categories={},await kt(o,JSON.stringify(a,null," ")+`
|
|
20
|
+
`))}}var Hi="packages/config/src/ai/tasks.ts";async function Sr(e){let t=ge(e,Hi),n=await vt(t,"utf-8"),r=n.replace(/\n?[\t ]*\/\/ gsaas:demo-ai-task-start[\s\S]*?\/\/ gsaas:demo-ai-task-end/,"");if(r===n)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.`);await kt(t,r)}async function Er(e,t){t.includes("claude-code")||await yn(ge(e,".claude"),{recursive:!0,force:!0})}async function Ar(e,t){let n=ge(e,".claude","settings.json"),r;try{r=await vt(n,"utf8")}catch{return}let o=JSON.parse(r);delete o.alwaysThinkingEnabled,delete o.enableAllProjectMcpServers,o.env&&(delete o.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS,Object.keys(o.env).length===0&&delete o.env),o.permissions?.allow&&(o.permissions.allow=o.permissions.allow.filter(i=>zi(i,t))),await kt(n,JSON.stringify(o,null," ")+`
|
|
21
|
+
`)}function zi(e,t){return!(e.startsWith("mcp__")||t!=="nuxt"&&e.includes("nuxt"))}import{join as Ir}from"path";var Ji={postgres:"Postgres",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"},Yi={resend:"Resend",ses:"Amazon SES",smtp:"SMTP"},qi={redis:"Redis",upstash:"Upstash Redis"},Wi={node:"Node.js / Docker",vercel:"Vercel"},Xi={stripe:"Stripe",polar:"Polar"};function Zi(e){let t=e.frontend==="nuxt",n=t?"Nuxt 4":"Next.js 16",r=t?"apps/web-nuxt":"apps/web-next",o=t?"`app/` pages + components + composables":"`app/` routes, `components/`, `lib/`",i=e.architecture==="fullstack",a=i?"(fullstack - Hono API mounted inside the app)":"(separate - standalone Hono backend)",s=i?`Mounted inside \`${r}\`. 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.",u=qi[e.cacheProvider],g=Wi[e.deploymentTarget],l=e.paymentProvider==="none"?"":`
|
|
22
|
+
- **Payments:** ${Xi[e.paymentProvider]}`,h=e.desktop?", and the desktop app (built with Electron) under `docs/desktop/`":"",S="";e.companion&&(de(e)==="vendored"?S=`
|
|
23
|
+
- \`apps/companion\` - the source of **${e.companionName??W(e.projectName)}**, the branded companion daemon your users install. Publish releases with \`pnpm companion:publish\`; \`generatesaas update\` flags when a re-release is due.`:S=`
|
|
24
|
+
- **Companion daemon** - this app points at the shared companion \`${e.companionRepoUrl}\` (your users install it from that repo's releases). It cannot be modified from this repo; to customize device-side behavior, switch \`companionSource\` to \`vendored\` via \`generatesaas update\`.`);let C=t?"`$t('key')` in templates (global helper); `useI18n()` from `vue-i18n` in `<script setup>` for `locale`/`setLocale`/`t()`.":"`useTranslations()` from `next-intl` in components; messages are loaded in `apps/web-next/i18n/request.ts`.",E=t?"**Navigation:** always use `localePath()` for paths (hardcoded paths break non-default locales); `await navigateTo()` in SSR.":"**Navigation:** `next/link` for links; `redirect()` from `next/navigation` for programmatic redirects in Server Components.";return`# AGENTS.md
|
|
27
25
|
|
|
28
26
|
Guidelines for AI coding agents (Claude Code, Codex, Cursor, \u2026) in this project.
|
|
29
27
|
Keep this file tight: add a rule only when it prevents a recurring mistake - too
|
|
@@ -51,10 +49,10 @@ flag, route, or translation is the most common and most costly mistake in this r
|
|
|
51
49
|
|
|
52
50
|
- **Frontend:** ${n} ${a}
|
|
53
51
|
- **API:** Hono, RPC-typed. ${s}
|
|
54
|
-
- **Database:** Drizzle ORM + ${
|
|
52
|
+
- **Database:** Drizzle ORM + ${Ji[e.databaseProvider]}
|
|
55
53
|
- **Cache + jobs:** ${u} + Inngest
|
|
56
54
|
- **Auth:** Better Auth${l}
|
|
57
|
-
- **Email:** ${
|
|
55
|
+
- **Email:** ${Yi[e.emailProvider]}
|
|
58
56
|
- **Deploy:** ${g}
|
|
59
57
|
|
|
60
58
|
## Where things live (extend these - don't reinvent)
|
|
@@ -65,7 +63,7 @@ flag, route, or translation is the most common and most costly mistake in this r
|
|
|
65
63
|
- \`packages/auth/src/config.ts\` - Better Auth config.
|
|
66
64
|
- \`packages/runtime/src/env.ts\` - the validated (Zod) env schema. New env var \u2192 add it here **and** to \`.env.example\` (the committed reference); set the local value in \`.env\`.
|
|
67
65
|
- \`packages/{payments,mail,sms,storage,notifications}\` - config-gated integrations. Every provider's files stay even when its feature is off, so flipping a flag is enough to enable it.
|
|
68
|
-
- \`${r}\` - the ${n} app (${o}).${
|
|
66
|
+
- \`${r}\` - the ${n} app (${o}).${S}
|
|
69
67
|
- \`docs/${t?"nuxt":"next"}/\` - feature & architecture documentation for this stack (Markdown). Consult it before searching from scratch; it cites real config keys, package names, and file paths you can act on. The GenerateSaaS CLI lives under \`docs/cli/\`${h}.
|
|
70
68
|
|
|
71
69
|
## Code style
|
|
@@ -83,8 +81,8 @@ flag, route, or translation is the most common and most costly mistake in this r
|
|
|
83
81
|
|
|
84
82
|
- **Hono routes:** keep the method chain (\`.get().post()\`) - RPC type inference depends on it. Validate with \`sValidator\` from \`@hono/standard-validator\`.
|
|
85
83
|
- **Feature flags:** respect \`config.*\` - hide/skip a feature when its flag is off (the files stay so you can flip it later).
|
|
86
|
-
- **i18n:** strings live in \`packages/i18n/translations/{locale}/{scope}.json\`; edit \`en/\` only, keep keys generic. ${
|
|
87
|
-
- ${
|
|
84
|
+
- **i18n:** strings live in \`packages/i18n/translations/{locale}/{scope}.json\`; edit \`en/\` only, keep keys generic. ${C} A pre-commit hook runs \`pnpm translate\` (needs \`OPENROUTER_API_KEY\`) to sync other locales from \`en\`; without the key it skips.
|
|
85
|
+
- ${E}
|
|
88
86
|
- **Routes:** use \`config.routes.*\`, never hardcoded path strings.
|
|
89
87
|
- **Secrets:** never send them to an external service; generate tokens/QR codes client-side.
|
|
90
88
|
|
|
@@ -95,8 +93,8 @@ In \`@repo/*\` backend packages prefer web-standard APIs: \`crypto.randomUUID()\
|
|
|
95
93
|
## This project
|
|
96
94
|
|
|
97
95
|
Scaffolded from the GenerateSaaS boilerplate. To pull upstream boilerplate updates, ask your agent to **"update my GenerateSaaS project"**. To remove the license heartbeat + manifest: \`pnpm dlx generatesaas eject\`.
|
|
98
|
-
`}async function
|
|
99
|
-
`)}import{join as
|
|
96
|
+
`}async function Rr(e){await p(Ir(e.projectDir,"AGENTS.md"),Zi(e)),await p(Ir(e.projectDir,"CLAUDE.md"),`@AGENTS.md
|
|
97
|
+
`)}import{join as Qi}from"path";var ea={postgres:"Postgres (self-hosted)",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"};function ta(e){let t=e.appName.trim()||e.projectName,n=e.frontend==="nuxt",r=n?"Nuxt 4":"Next.js 16",o=n?"apps/web-nuxt":"apps/web-next",i=ea[e.databaseProvider],a=Dt(e),s=e.architecture==="fullstack"?`${r} app at \`${o}/\` 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.`:`${r} app at \`${o}/\` and a separate Hono backend at \`apps/backend/\`.`,u=e.architecture==="fullstack"?`- App + API: http://localhost:3000
|
|
100
98
|
- Inngest dev server: http://127.0.0.1:8288`:`- App: http://localhost:3000
|
|
101
99
|
- API: http://localhost:3010
|
|
102
100
|
- Inngest dev server: http://127.0.0.1:8288`,g=a?`pnpm infra # optional: starts local Docker services (Postgres / Redis / Inngest / Mailpit)
|
|
@@ -159,19 +157,20 @@ pnpm dlx generatesaas eject
|
|
|
159
157
|
## Updates
|
|
160
158
|
|
|
161
159
|
${h}
|
|
162
|
-
`}async function
|
|
163
|
-
`)}async function
|
|
160
|
+
`}async function Pr(e){await p(Qi(e.projectDir,"README.md"),ta(e))}import{access as ra,readFile as oa}from"fs/promises";import{join as Ce}from"path";import{join as na}from"path";function wn(e,t){let n=Ct(e,"companion"),r=t?new URL(t).hostname.split(".").reverse().join("."):"com",o=n.toUpperCase().replace(/-/g,"_");return{name:e,binary:n,scope:`@${n}`,serviceLabel:`${r}.${n}`,appDirName:n,envPrefix:/^[0-9]/.test(o)?`_${o}`:o,docsUrl:"",repoUrl:"",installBase:""}}async function Tr(e){if(!ue(e)||e.demo||H(e)==="shared")return;if(!e.companionName)throw new Error("generateCompanionBrand: this project ships a companion daemon but options.companionName is missing.");let t=wn(e.companionName,e.baseUrl);await p(na(e.projectDir,"apps/companion/brand.json"),JSON.stringify(t,null,2)+`
|
|
161
|
+
`)}async function ia(e,t,n){let r=Ce(e,"apps/electron/dev-app-update.yml");try{await ra(r)}catch{throw new Error(`Cannot neutralize the desktop dev update feed: ${r} is missing (boilerplate drift).`)}await p(r,`provider: generic
|
|
164
162
|
url: ${t}
|
|
165
163
|
updaterCacheDirName: ${n}
|
|
166
|
-
`)}function
|
|
167
|
-
`)}async function
|
|
164
|
+
`)}function aa(e){let t=e.split(".");return t.length>=3?t.slice(1).join("."):e}function sa(e,t){let n=Ct(e,"app");return{appId:`${t.split(".").reverse().join(".")}.${n.replace(/-/g,"")}`,productName:e,protocol:n}}async function ca(e){if(!e.companion&&!ue(e))return'{ enabled: false, clientId: "companion" }';let t;if(e.demo)t=JSON.parse(await oa(Ce(e.projectDir,"apps/companion/brand.json"),"utf8"));else if(H(e)==="shared"){let r=await Qn(e),o=oe(e.companionRepoUrl??"").canonicalUrl;t={name:r.name,binary:r.binary,envPrefix:r.envPrefix,repoUrl:o,installBase:`${o}/releases/latest/download`}}else{if(!e.companionName)throw new Error("generateConfig: this project ships a companion daemon but options.companionName is missing.");t=wn(e.companionName,e.baseUrl)}let n={name:t.name,binary:t.binary,envPrefix:t.envPrefix,repoUrl:t.repoUrl,installBase:t.installBase};return["{",` enabled: ${e.companion},`,' clientId: "companion",'," daemon: {",` name: ${JSON.stringify(n.name)},`,` binary: ${JSON.stringify(n.binary)},`,` envPrefix: ${JSON.stringify(n.envPrefix)},`,` repoUrl: ${JSON.stringify(n.repoUrl)},`,` installBase: ${JSON.stringify(n.installBase)}`," }"," }"].join(`
|
|
165
|
+
`)}async function _r(e){let t=e.appName.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),n=e.paymentProvider!=="none",r=e.baseUrl??"http://localhost:3000",o=e.baseUrl?new URL(e.baseUrl).hostname:"example.com",i=aa(o),a=e.demo?"false":"true",s=e.demo?`{
|
|
168
166
|
enableInDev: true,
|
|
169
167
|
chatwoot: {
|
|
170
168
|
baseUrl: "https://support.alexchelan.com",
|
|
171
169
|
websiteToken: "1uWvJLHkhWLihkK2bxLaj2Fg"
|
|
172
170
|
}
|
|
173
|
-
}`:"{}",u=e.frontend==="nextjs"&&e.architecture==="fullstack"?"false":"true",g=
|
|
171
|
+
}`:"{}",u=e.frontend==="nextjs"&&e.architecture==="fullstack"?"false":"true",g=sa(t,i),l=`https://cdn.${i}/desktop`,h=await ca(e),S=`import type { AppConfig } from "@repo/config/types";
|
|
174
172
|
import { desktopConfig } from "./desktop.mjs";
|
|
173
|
+
import { observabilityConfig } from "./observability.mjs";
|
|
175
174
|
import { supportConfig } from "./support.mjs";
|
|
176
175
|
import { tenancyConfig } from "./tenancy-flags.mjs";
|
|
177
176
|
|
|
@@ -199,7 +198,7 @@ export const config: AppConfig = {
|
|
|
199
198
|
cookieBanner: "auto",
|
|
200
199
|
consentPolicy: "gdpr-and-unknown",
|
|
201
200
|
auth: {
|
|
202
|
-
socialProviders: ${
|
|
201
|
+
socialProviders: ${e.demo?'["google"]':"[]"}
|
|
203
202
|
},
|
|
204
203
|
social: {},
|
|
205
204
|
email: {
|
|
@@ -222,7 +221,7 @@ export const config: AppConfig = {
|
|
|
222
221
|
},
|
|
223
222
|
inactiveEmailSchedule: [7, 30, 90],
|
|
224
223
|
tracking: {
|
|
225
|
-
enabled:
|
|
224
|
+
enabled: true,
|
|
226
225
|
retentionDays: 90
|
|
227
226
|
}
|
|
228
227
|
},
|
|
@@ -245,6 +244,7 @@ export const config: AppConfig = {
|
|
|
245
244
|
},
|
|
246
245
|
apiDocs: true,
|
|
247
246
|
performanceMonitor: { enabled: ${u} },
|
|
247
|
+
observability: observabilityConfig,
|
|
248
248
|
notifications: {
|
|
249
249
|
enabled: true,
|
|
250
250
|
maxPerUser: 100,
|
|
@@ -283,7 +283,7 @@ export const config: AppConfig = {
|
|
|
283
283
|
}`:`{
|
|
284
284
|
base: "${e.defaultCurrency}",
|
|
285
285
|
list: [
|
|
286
|
-
{ symbol: "${
|
|
286
|
+
{ symbol: "${Ie[e.defaultCurrency].symbol}", name: "${Ie[e.defaultCurrency].name}", code: "${e.defaultCurrency}", place: "${Ie[e.defaultCurrency].place}", space: ${Ie[e.defaultCurrency].space} }
|
|
287
287
|
],
|
|
288
288
|
countryMap: {
|
|
289
289
|
default: "${e.defaultCurrency}"
|
|
@@ -307,11 +307,12 @@ export const config: AppConfig = {
|
|
|
307
307
|
},
|
|
308
308
|
ai: {
|
|
309
309
|
enabled: ${e.ai},
|
|
310
|
-
// Built-in AI: your app offers models under its OWN name, billed from user credits
|
|
311
|
-
//
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
310
|
+
// Built-in AI: your app offers models under its OWN name, billed from user credits (which need a
|
|
311
|
+
// payment provider to buy), so it is generated on exactly when a payment provider exists. Powered by
|
|
312
|
+
// OpenRouter - set OPENROUTER_API_KEY in your env, that is the whole setup. Flip this to change it.
|
|
313
|
+
builtin: ${n},
|
|
314
|
+
// Let users connect their own provider API keys; flip to false to disable.
|
|
315
|
+
byok: true,
|
|
315
316
|
// What every user starts on (their own choice, once made, always wins). Plain
|
|
316
317
|
// OpenRouter model ids.
|
|
317
318
|
defaults: { model: "anthropic/claude-opus-4.8" },
|
|
@@ -332,8 +333,9 @@ export const config: AppConfig = {
|
|
|
332
333
|
desktop: desktopConfig,
|
|
333
334
|
// Companion: your vendored companion daemon (apps/companion) that your users install to run their own subscription CLIs. Off by default.
|
|
334
335
|
companion: ${h},
|
|
335
|
-
// Outward MCP server exposing the capability layer to external agents.
|
|
336
|
-
|
|
336
|
+
// Outward MCP server exposing the capability layer to external agents. Its code ships with every
|
|
337
|
+
// project, so \`enabled\` alone controls the /mcp endpoint and the MCP settings tab.
|
|
338
|
+
mcpServer: { enabled: ${e.demo?"true":"false"} },
|
|
337
339
|
seo: {
|
|
338
340
|
description: "Production-ready SaaS application",
|
|
339
341
|
foundingDate: "${new Date().getFullYear()}-01-01"
|
|
@@ -374,7 +376,7 @@ export * from "./pricing";
|
|
|
374
376
|
export * from "./roles";
|
|
375
377
|
export * from "./section-tabs";
|
|
376
378
|
export * from "./tenancy";
|
|
377
|
-
`,
|
|
379
|
+
`,C=Ce(e.projectDir,"packages/config/src/index.ts");await p(C,S),await p(Ce(e.projectDir,"packages/config/src/desktop.mjs"),`// Plain-JS desktop app identity. NO env reads, so tooling that cannot import the
|
|
378
380
|
// TypeScript config index reads it directly: the Electron main + renderer bundles,
|
|
379
381
|
// the CSP policy builder, and the electron-builder packaging config. Edit these
|
|
380
382
|
// values once to rebrand - they are the same in dev and production, so they live in
|
|
@@ -421,23 +423,41 @@ export const desktopConfig = {
|
|
|
421
423
|
connectionLock: false
|
|
422
424
|
}
|
|
423
425
|
};
|
|
424
|
-
`),await p(
|
|
426
|
+
`),await p(Ce(e.projectDir,"packages/config/src/tenancy-flags.mjs"),`// Plain-JS tenancy flags. NO env reads, so tooling that cannot import the
|
|
425
427
|
// TypeScript config index reads it directly (the Electron main + renderer). Mirrors the
|
|
426
428
|
// desktop.mjs pattern. The config index re-exports this as config.tenancy.
|
|
427
429
|
|
|
428
430
|
export const tenancyConfig = ${e.multiTenancy?`{
|
|
429
431
|
multiTenant: true,
|
|
430
432
|
organizationLimit: 5,
|
|
431
|
-
billingScope: "${e.
|
|
433
|
+
billingScope: "${e.demo?"organization":"user"}"
|
|
432
434
|
}`:"{ multiTenant: false }"};
|
|
433
|
-
`),await p(
|
|
435
|
+
`),await p(Ce(e.projectDir,"packages/config/src/support.mjs"),`// Plain-JS support (live chat) config. NO env reads, so tooling that cannot import
|
|
434
436
|
// the TypeScript config index reads it directly (the Electron main + renderer and
|
|
435
437
|
// the desktop CSP policy builder). Mirrors the desktop.mjs pattern. The config
|
|
436
438
|
// index re-exports this as config.support.
|
|
437
439
|
|
|
438
440
|
export const supportConfig = ${s};
|
|
439
|
-
`),
|
|
440
|
-
|
|
441
|
+
`),await p(Ce(e.projectDir,"packages/config/src/observability.mjs"),`// Plain-JS observability (error reporting) config. NO env reads, so tooling that
|
|
442
|
+
// cannot import the TypeScript config index reads it directly (the Electron main +
|
|
443
|
+
// renderer, which have no env at all once packaged). Mirrors the support.mjs
|
|
444
|
+
// pattern. The config index re-exports this as config.observability.
|
|
445
|
+
//
|
|
446
|
+
// Off by default and off costs nothing: every surface checks \`sentry.enabled\` and a
|
|
447
|
+
// non-empty \`dsn\` before it dynamically imports the SDK, so nothing ships to your
|
|
448
|
+
// users' browsers and nothing loads on your server. Turn it on by flipping \`enabled\`
|
|
449
|
+
// and pasting your project DSN (Sentry: Settings -> Projects -> Client Keys) - the DSN
|
|
450
|
+
// is public by design (it only authorizes sending events, never reading them), which is
|
|
451
|
+
// why it lives here rather than in env. Server-side, SENTRY_DSN overrides it.
|
|
452
|
+
|
|
453
|
+
export const observabilityConfig = {
|
|
454
|
+
sentry: {
|
|
455
|
+
enabled: false,
|
|
456
|
+
dsn: ""
|
|
457
|
+
}
|
|
458
|
+
};
|
|
459
|
+
`),e.desktop&&await ia(e.projectDir,l,`${g.protocol}-updater`)}import{join as pa}from"path";function la(e){return e==="stripe"?' stripePriceId: "",':' polarProductId: "",'}function vn(e){let t=[];return e.withCredits&&(t.push(` credits: ${e.credits},`),t.push(" creditInterval: 30,")),e.maxSchedules!==void 0?(t.push(` apiRateLimit: { maxRequests: ${e.rateLimit} },`),t.push(` maxSchedules: ${e.maxSchedules}`)):t.push(` apiRateLimit: { maxRequests: ${e.rateLimit} }`),t.join(`
|
|
460
|
+
`)}async function xr(e){let t=pa(e.projectDir,"packages/config/src/pricing.ts"),n=e.defaultCurrency;if(e.paymentProvider==="none"){let C=`import type { PricingConfig } from "@repo/config/types";
|
|
441
461
|
|
|
442
462
|
export const pricingConfig: PricingConfig = {
|
|
443
463
|
defaultPlan: "free",
|
|
@@ -466,7 +486,7 @@ export const pricingConfig: PricingConfig = {
|
|
|
466
486
|
credits: { enabled: false },
|
|
467
487
|
products: { enabled: false, items: [] }
|
|
468
488
|
};
|
|
469
|
-
`;await p(t,
|
|
489
|
+
`;await p(t,C);return}let r=e.paymentProvider,o=la(r),i=e.credits,a=!!e.ai,s=vn({credits:5,rateLimit:100,withCredits:i,...a&&{maxSchedules:3}}),u=vn({credits:10,rateLimit:1e3,withCredits:i,...a&&{maxSchedules:10}}),g=vn({credits:50,rateLimit:5e3,withCredits:i}),l=n==="USD"?"":` // !! ${n} pricing WARNING: creditsPerUsd anchors credit cost to USD (AI providers bill in
|
|
470
490
|
// !! USD), but your plan prices and credit purchases are denominated in ${n}. Verify that the
|
|
471
491
|
// !! ${n} amounts above cover the USD cost per credit (~0.42 USD at creditsPerUsd 2 with the
|
|
472
492
|
// !! 20% markup) - and raise prices or creditsPerUsd if they do not.
|
|
@@ -480,7 +500,7 @@ export const pricingConfig: PricingConfig = {
|
|
|
480
500
|
// external APIs, your own features). Sanity-check whenever you change plan credits, prices, or
|
|
481
501
|
// the markup: each plan's credits / creditsPerUsd * (1 + markup) must stay BELOW its price, or
|
|
482
502
|
// full utilization runs you at a loss.
|
|
483
|
-
${l} credits: { enabled: true, creditsPerUsd: 2, markupPercent: 20 }`:" credits: { enabled: false }",
|
|
503
|
+
${l} credits: { enabled: true, creditsPerUsd: 2, markupPercent: 20 }`:" credits: { enabled: false }",S=`import type { PricingConfig } from "@repo/config/types";
|
|
484
504
|
|
|
485
505
|
export const pricingConfig: PricingConfig = {
|
|
486
506
|
defaultPlan: "free",
|
|
@@ -570,11 +590,11 @@ ${h},
|
|
|
570
590
|
items: []
|
|
571
591
|
}
|
|
572
592
|
};
|
|
573
|
-
`;await p(t,
|
|
574
|
-
`)}function
|
|
575
|
-
`)}async function
|
|
576
|
-
`+
|
|
577
|
-
`+
|
|
593
|
+
`;await p(t,S)}var da={smtp:[{key:"SMTP_HOST",defaultValue:"localhost"},{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"}],resend:[{key:"RESEND_API_KEY",comment:"# TODO: Add your Resend API key"}]},ua={stripe:[{key:"STRIPE_SECRET_KEY",comment:"# TODO: Add your Stripe keys"},{key:"STRIPE_WEBHOOK_SECRET"}],polar:[{key:"POLAR_ACCESS_TOKEN",comment:"# TODO: Add your Polar keys"},{key:"POLAR_WEBHOOK_SECRET"}]};function bt(e,t){return t?e.map(n=>{let r=t[n.key];return r?{...n,defaultValue:r,comment:void 0}:n}):e}function St(e,t){for(let n of e)n.comment&&t.push(n.comment),n.defaultValue!==void 0?t.push(`${n.key}=${n.defaultValue}`):t.push(`#${n.key}=`)}function kn(e){return Array.from(crypto.getRandomValues(new Uint8Array(e))).map(t=>t.toString(16).padStart(2,"0")).join("")}function Dr(e){return e.architecture==="fullstack"?{apiUrl:"http://localhost:3000/api",baseUrl:"http://localhost:3000"}:{apiUrl:"http://localhost:3010",baseUrl:"http://localhost:3000"}}function ma(e){let{architecture:t,deploymentTarget:n}=e;return t==="fullstack"?n==="vercel"?{frontend:"https://your-app.vercel.app",backend:"https://your-app.vercel.app"}:n==="node"?{frontend:"https://your-app.example.com",backend:"https://your-app.example.com"}:null:{frontend:"https://your-app.example.com",backend:"https://your-app.example.com/api"}}function Kt(e,t,n,r){e.push(r==="example"?`${t}=`:`${t}=${n}`)}function Or(e,t){let n=t==="example"?void 0:e.credentials,{apiUrl:r,baseUrl:o}=Dr(e),i=[];e.architecture==="separate"?i.push("# API Configuration","# Standalone backend's own URL (the frontend reaches it via the public var above).",`API_URL=${r}`,`BASE_URL=${o}`):i.push("# App","# (API_URL is derived from the frontend's *_PUBLIC_API_URL by the runtime env schema.)",`BASE_URL=${o}`),i.push("","# Database"),St(bt(K[e.databaseProvider].envVars,n),i),i.push("","# Cache"),St(bt(re[e.cacheProvider].envVars,n),i),i.push("","# Authentication"),t==="example"&&i.push("# Generate a strong secret, e.g. `openssl rand -hex 32`"),Kt(i,"BETTER_AUTH_SECRET",crypto.randomUUID(),t),i.push("","# Content API (random secret; required when contentApi feature is enabled in @repo/config)"),Kt(i,"CONTENT_API_KEY",kn(32),t),i.push("","# Job Queue - Inngest","INNGEST_APP_ID=api"),Kt(i,"INNGEST_EVENT_KEY",kn(32),t),Kt(i,"INNGEST_SIGNING_KEY",kn(32),t),i.push("INNGEST_BASE_URL=http://127.0.0.1:8288"),e.architecture==="separate"&&(i.push("","# API Port (standalone backend)","API_PORT=3010"),i.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 a=da[e.emailProvider];if(a&&(i.push("","# Email"),St(bt(a,n),i)),e.paymentProvider!=="none"){let s=ua[e.paymentProvider];s&&(i.push("","# Payment"),St(bt(s,n),i))}return e.demo&&(i.push("","# Captcha (Cloudflare Turnstile)"),St(bt([{key:"TURNSTILE_SECRET_KEY",comment:"# TODO: Add your Cloudflare Turnstile secret key"}],n),i)),i.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="),i.push("","# AI base - provider API keys (optional)","# Enable config.ai in packages/config and set the key for your chosen provider.","# OPENROUTER_API_KEY above also works as an AI provider key.","#ANTHROPIC_API_KEY=","#OPENAI_API_KEY="),i.push(""),i.join(`
|
|
594
|
+
`)}function fa(e){let{apiUrl:t}=Dr(e),n=e.frontend==="nextjs"?"NEXT_PUBLIC_API_URL":"NUXT_PUBLIC_API_URL",r=["# API Configuration",`${n}=${t}`],o=ma(e);return o&&e.architecture==="separate"&&r.push("","# Production (uncomment and replace with your deployed hostnames):",`# ${n}=${o.backend}`),r.push(""),r.join(`
|
|
595
|
+
`)}async function Cr(e){let t=fa(e);await p(`${e.projectDir}/.env`,t+`
|
|
596
|
+
`+Or(e,"env")),await p(`${e.projectDir}/.env.example`,t+`
|
|
597
|
+
`+Or(e,"example"))}import{join as ga}from"path";async function Nr(e){let t=[...e.dockerServices];if(K[e.databaseProvider].managed&&(t=t.filter(i=>i!=="postgres")),re[e.cacheProvider].managed&&(t=t.filter(i=>i!=="redis")),t.length===0)return!1;let n=[],r=[];t.includes("postgres")&&(n.push(` postgres:
|
|
578
598
|
image: postgres:18-alpine
|
|
579
599
|
ports:
|
|
580
600
|
- "\${POSTGRES_PORT:-5432}:5432"
|
|
@@ -618,8 +638,8 @@ ${n.join(`
|
|
|
618
638
|
volumes:
|
|
619
639
|
${r.join(`
|
|
620
640
|
`)}
|
|
621
|
-
`),await p(
|
|
622
|
-
`)}import{join as
|
|
641
|
+
`),await p(ga(e.projectDir,"infra/docker-compose.yml"),o),!0}import{join as ha}from"path";function ya(e){let t=[];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"}});let n=e.frontend==="nextjs"?"Next.js":"Nuxt";if(t.push({type:"node-terminal",request:"launch",name:n,command:"pnpm dev",cwd:`\${workspaceFolder}/apps/web-${e.frontend==="nextjs"?"next":"nuxt"}`,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/electron",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 wa(e){let t=e.frontend==="nextjs"?"Next.js":"Nuxt",n=[];return e.architecture==="separate"?n.push({name:`Dev (${t} + Backend + Inngest)`,configurations:["Backend",t,"Inngest"]}):n.push({name:`Dev (${t} + Inngest)`,configurations:[t,"Inngest"]}),n}async function $r(e){let t={version:"0.2.0",configurations:ya(e),compounds:wa(e)};await p(ha(e.projectDir,".vscode/launch.json"),JSON.stringify(t,null," ")+`
|
|
642
|
+
`)}import{join as va}from"path";async function Lr(e){if(e.architecture!=="separate")return;await p(va(e.projectDir,"apps/backend/src/index.ts"),`import { serve } from "@hono/node-server";
|
|
623
643
|
import app from "@repo/api";
|
|
624
644
|
import { closeRedis, env, logger } from "@repo/runtime";
|
|
625
645
|
|
|
@@ -650,12 +670,12 @@ bootstrap().catch((error) => {
|
|
|
650
670
|
logger.error("[Backend] Fatal error", error);
|
|
651
671
|
process.exit(1);
|
|
652
672
|
});
|
|
653
|
-
`)}import{readFile as
|
|
654
|
-
export const pool = db.$client;`,
|
|
673
|
+
`)}import{readFile as ka}from"fs/promises";import{join as ba}from"path";var bn='import { drizzle } from "drizzle-orm/node-postgres";',Sn=`export const db = drizzle(parsed.data.DATABASE_URL, { schema });
|
|
674
|
+
export const pool = db.$client;`,Sa={postgres:{importLine:bn,instantiation:Sn},neon:{importLine:`import { neon } from "@neondatabase/serverless";
|
|
655
675
|
import { drizzle } from "drizzle-orm/neon-http";`,instantiation:`const sql = neon(parsed.data.DATABASE_URL);
|
|
656
676
|
export const db = drizzle(sql, { schema });`},supabase:{importLine:`import { drizzle } from "drizzle-orm/postgres-js";
|
|
657
677
|
import postgres from "postgres";`,instantiation:`const client = postgres(parsed.data.DATABASE_URL);
|
|
658
|
-
export const db = drizzle(client, { schema });`}};async function
|
|
678
|
+
export const db = drizzle(client, { schema });`}};async function jr(e){let t=ba(e.projectDir,"packages/database/src/index.ts"),n=await ka(t,"utf-8");if(!n.includes(bn)||!n.includes(Sn))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 r=Sa[e.databaseProvider],o=n.replace(bn,r.importLine).replace(Sn,r.instantiation);await p(t,o)}import{join as Ht}from"path";async function Ur(e){switch(e.cacheProvider){case"redis":await Ea(e),await Aa(e);break;case"upstash":await Ia(e),await Ra(e);break}}async function Ea(e){await p(Ht(e.projectDir,"packages/runtime/src/redis.ts"),`import type { Store } from "hono-rate-limiter";
|
|
659
679
|
import { Redis } from "ioredis";
|
|
660
680
|
import { RedisStore, type RedisReply } from "rate-limit-redis";
|
|
661
681
|
import { env } from "./env";
|
|
@@ -784,7 +804,7 @@ export async function closeRedis() {
|
|
|
784
804
|
closed = true;
|
|
785
805
|
}
|
|
786
806
|
}
|
|
787
|
-
`)}async function
|
|
807
|
+
`)}async function Aa(e){await p(Ht(e.projectDir,"packages/runtime/src/mutex.ts"),`import { Mutex } from "redis-semaphore";
|
|
788
808
|
import { redis } from "./redis";
|
|
789
809
|
|
|
790
810
|
export class MutexTimeoutError extends Error {
|
|
@@ -821,7 +841,7 @@ export async function withMutex<T>(
|
|
|
821
841
|
await mutex.release();
|
|
822
842
|
}
|
|
823
843
|
}
|
|
824
|
-
`)}async function
|
|
844
|
+
`)}async function Ia(e){await p(Ht(e.projectDir,"packages/runtime/src/redis.ts"),`import { Redis } from "@upstash/redis";
|
|
825
845
|
import type { Store } from "hono-rate-limiter";
|
|
826
846
|
import { env } from "./env";
|
|
827
847
|
|
|
@@ -939,7 +959,7 @@ export const limiterStore: Store = createLimiterStore();
|
|
|
939
959
|
|
|
940
960
|
/** No persistent connection to close with Upstash REST. */
|
|
941
961
|
export async function closeRedis(): Promise<void> {}
|
|
942
|
-
`)}async function
|
|
962
|
+
`)}async function Ra(e){await p(Ht(e.projectDir,"packages/runtime/src/mutex.ts"),`import { Lock } from "@upstash/lock";
|
|
943
963
|
import { redis } from "./redis";
|
|
944
964
|
|
|
945
965
|
export class MutexTimeoutError extends Error {
|
|
@@ -984,7 +1004,7 @@ export async function withMutex<T>(
|
|
|
984
1004
|
await lock.release();
|
|
985
1005
|
}
|
|
986
1006
|
}
|
|
987
|
-
`)}async function
|
|
1007
|
+
`)}async function Mr(e){await p(`${e.projectDir}/packages/runtime/src/env.ts`,Pa(e))}function Pa(e){return`import { z } from "zod";
|
|
988
1008
|
|
|
989
1009
|
const EnvSchema = z.object({
|
|
990
1010
|
NODE_ENV: z.enum(["development", "production"]).default("development"),
|
|
@@ -1081,7 +1101,10 @@ ${e.cacheProvider==="upstash"?` UPSTASH_REDIS_REST_URL: z.string(),
|
|
|
1081
1101
|
OPENAI_API_KEY: z.string().optional(),
|
|
1082
1102
|
OPENROUTER_API_KEY: z.string().optional(),
|
|
1083
1103
|
|
|
1084
|
-
MASTRA_TELEMETRY_DISABLED: z.string().optional()
|
|
1104
|
+
MASTRA_TELEMETRY_DISABLED: z.string().optional(),
|
|
1105
|
+
|
|
1106
|
+
/** Server-side override for \`config.observability.sentry.dsn\`. Optional: the committed config value is the default. */
|
|
1107
|
+
SENTRY_DSN: z.string().optional()
|
|
1085
1108
|
});
|
|
1086
1109
|
|
|
1087
1110
|
export const env = (() => {
|
|
@@ -1108,13 +1131,13 @@ export const env = (() => {
|
|
|
1108
1131
|
const parsedApiUrl = new URL(env.API_URL);
|
|
1109
1132
|
export const apiBasePath = parsedApiUrl.pathname === "/" ? "" : parsedApiUrl.pathname;
|
|
1110
1133
|
export const apiOrigin = parsedApiUrl.origin;
|
|
1111
|
-
`}import{readFile as
|
|
1112
|
-
`)}function
|
|
1113
|
-
`)}var
|
|
1114
|
-
`))}}import{readFile as
|
|
1115
|
-
`);let i=
|
|
1134
|
+
`}import{readFile as Ta}from"fs/promises";import{join as z}from"path";var zt={"@upstash/redis":"^1.37.0","@upstash/lock":"^0.2.1","@neondatabase/serverless":"^1.0.1",postgres:"^3.4.7"};async function Qe(e){let t=await Ta(e,"utf-8");return JSON.parse(t)}async function et(e,t){await p(e,JSON.stringify(t,null," ")+`
|
|
1135
|
+
`)}function Et(e,t){for(let n of t)delete e.dependencies?.[n],delete e.devDependencies?.[n]}function Ze(e,t,n,r=!1){let o=r?"devDependencies":"dependencies";e[o]||(e[o]={}),e[o][t]=n}async function Fr(e){await _a(e),await xa(e),await Oa(e),await Da(e),e.frontend==="nextjs"?await La(e):await $a(e)}async function _a(e){let t=z(e.projectDir,"packages/api/package.json"),n=await Qe(t);Et(n,["sharp","@types/sharp"]),await et(t,n)}async function xa(e){let t=z(e.projectDir,"packages/runtime/package.json"),n=await Qe(t);e.cacheProvider==="upstash"&&(Et(n,["ioredis","rate-limit-redis","redis-semaphore"]),Ze(n,"@upstash/redis",zt["@upstash/redis"]),Ze(n,"@upstash/lock",zt["@upstash/lock"])),await et(t,n)}async function Oa(e){let t=z(e.projectDir,"packages/database/package.json"),n=await Qe(t);e.databaseProvider==="neon"?(Et(n,["pg","@types/pg"]),Ze(n,"@neondatabase/serverless",zt["@neondatabase/serverless"])):e.databaseProvider==="supabase"&&(Et(n,["pg","@types/pg"]),Ze(n,"postgres",zt.postgres)),await et(t,n)}async function Da(e){if(e.architecture!=="separate")return;let t=z(e.projectDir,"apps/backend/package.json"),n=await Qe(t);e.deploymentTarget!=="node"&&Et(n,["@hono/node-server"]),await et(t,n)}var Ca=["server/routes/.well-known/oauth-authorization-server/[...path].ts","server/routes/.well-known/oauth-protected-resource/[...path].ts","server/routes/.well-known/oauth-authorization-server.ts","server/routes/.well-known/oauth-protected-resource.ts"],Na=["app/.well-known/oauth-authorization-server/[[...path]]/route.ts","app/.well-known/oauth-protected-resource/[[...path]]/route.ts"];async function $a(e){if(e.architecture!=="separate")return;let t=z(e.projectDir,"apps/web-nuxt");await ht(z(t,"server/api/[...paths].ts"),t);for(let i of Ca)await ht(z(t,i),t);let n=z(t,"package.json"),r=await Qe(n),o=r.dependencies?.["@repo/api"];o&&(delete r.dependencies?.["@repo/api"],Ze(r,"@repo/api",o,!0)),await et(n,r)}async function La(e){if(e.architecture!=="separate")return;let t=z(e.projectDir,"apps/web-next");await ht(z(t,"app/api/[[...rest]]/route.ts"),t);for(let i of Na)await ht(z(t,i),t);let n=z(t,"package.json"),r=await Qe(n),o=r.dependencies?.["@repo/api"];o&&(delete r.dependencies?.["@repo/api"],Ze(r,"@repo/api",o,!0)),await et(n,r)}import{readFile as Br}from"fs/promises";import{join as Gr}from"path";async function Kr(e){let t=Gr(e.projectDir,"turbo.json"),n;try{n=await Br(t,"utf-8")}catch{return}let r=JSON.parse(n),o=r.tasks?.build;if(!o)return;let i=e.frontend==="nextjs"?"NUXT_PUBLIC_*":"NEXT_PUBLIC_*",a=e.frontend==="nextjs"?new Set([".nuxt/**",".output/**"]):new Set([".next/**","!.next/cache/**"]),s=!1;if(Array.isArray(o.env)){let u=o.env.filter(g=>g!==i);u.length!==o.env.length&&(o.env=u,s=!0)}if(Array.isArray(o.outputs)){let u=o.outputs.filter(g=>!a.has(g));u.length!==o.outputs.length&&(o.outputs=u,s=!0)}s&&await p(t,JSON.stringify(r,null," ")+`
|
|
1136
|
+
`)}var ja=["base.json","node.json","next.json"],Vr="GenerateSaaS ";async function Hr(e){if(!e.demo)for(let t of ja){let n=Gr(e.projectDir,"tooling/typescript",t),r;try{r=await Br(n,"utf-8")}catch{continue}let o=JSON.parse(r);typeof o.display!="string"||!o.display.startsWith(Vr)||(o.display=o.display.slice(Vr.length),await p(n,JSON.stringify(o,null," ")+`
|
|
1137
|
+
`))}}import{readFile as Ua,rm as Ma}from"fs/promises";import{existsSync as zr}from"fs";import{join as Jr}from"path";async function Yr(e){if(e.frontend==="nuxt")return;let t=Jr(e.projectDir,"packages/i18n/package.json");if(!zr(t))throw new Error(`pruneI18nNuxt: expected ${t} to exist - did the i18n package move?`);let n=JSON.parse(await Ua(t,"utf-8")),r=!!(n.exports?.["./module"]??n.exports?.["./nuxt"]),o=!1;if(n.exports)for(let a of["./module","./nuxt"])a in n.exports&&(delete n.exports[a],o=!0);n.devDependencies&&"@nuxt/kit"in n.devDependencies&&(delete n.devDependencies["@nuxt/kit"],o=!0),o&&await p(t,JSON.stringify(n,null," ")+`
|
|
1138
|
+
`);let i=Jr(e.projectDir,"packages/i18n/nuxt");if(r&&!zr(i))throw new Error(`pruneI18nNuxt: packages/i18n declares a Nuxt export surface but ${i} is missing - did the i18n Nuxt module move?`);await Ma(i,{recursive:!0,force:!0})}import{readFile as Wr,rm as Fa}from"fs/promises";import{join as Jt}from"path";async function Xr(e){e.cacheProvider==="upstash"&&await Promise.all([qr(Jt(e.projectDir,"packages/runtime/tests/setup.ts")),qr(Jt(e.projectDir,"packages/mail/tests/setup.ts")),Va(e.projectDir),Fa(Jt(e.projectDir,"packages/runtime/tests/redis.test.ts"),{force:!0})])}async function qr(e){let t;try{t=await Wr(e,"utf-8")}catch{throw new Error(`pruneCacheTests: expected ${e} for the Upstash cache swap (boilerplate drift).`)}let n=t.replace(/\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
1116
1139
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
1117
|
-
`);n!==t&&await p(e,n)}async function
|
|
1140
|
+
`);n!==t&&await p(e,n)}async function Va(e){let t=Jt(e,"packages/api/tests/setup.ts"),n;try{n=await Wr(t,"utf-8")}catch{throw new Error(`pruneCacheTests: expected ${t} for the Upstash cache swap (boilerplate drift).`)}let r=n;r=r.replace(/\tREDIS_URL:\s*"[^"]*",?\n/g,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
1118
1141
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
1119
1142
|
`),r=r.replace(/vi\.mock\("ioredis"[\s\S]*?\n\}\);\n\n?/,""),r=r.replace(/vi\.mock\("rate-limit-redis"[\s\S]*?\n\}\);\n\n?/,""),r=r.replace(/\t\t\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
1120
1143
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
@@ -1135,100 +1158,25 @@ vi.mock("@upstash/lock", () => {
|
|
|
1135
1158
|
return { Lock };
|
|
1136
1159
|
});
|
|
1137
1160
|
|
|
1138
|
-
$1`),r!==n&&await p(t,r)}import{readdir as
|
|
1139
|
-
|
|
1140
|
-
`,"","api
|
|
1141
|
-
|
|
1142
|
-
|
|
1143
|
-
// RFC 9728). A standalone backend serves them at its origin directly, and each web frontend
|
|
1144
|
-
// forwards its root \`/.well-known/oauth-*\` paths to this app. Gated like the \`/mcp\` endpoint
|
|
1145
|
-
// itself, so the routes are absent entirely when the feature is off.
|
|
1146
|
-
if (config.mcpServer?.enabled) {
|
|
1147
|
-
app.route("/", mcpDiscoveryRoutes);
|
|
1148
|
-
}
|
|
1149
|
-
`,"","api index mcp discovery mount",n);let s=B(t,"packages/auth/src/config.ts");await I(s,` magicLink,
|
|
1150
|
-
mcp,
|
|
1151
|
-
organization,`,` magicLink,
|
|
1152
|
-
organization,`,"auth config mcp plugin import",n),await I(s,` // Outward MCP server: turns Better Auth into an OAuth 2.1 provider so an
|
|
1153
|
-
// external agent (Hermes/OpenClaw) can authenticate and drive the app's
|
|
1154
|
-
// capability layer over MCP. Brings the oauthApplication/oauthAccessToken/
|
|
1155
|
-
// oauthConsent tables (run \`pnpm auth:generate\` after toggling).
|
|
1156
|
-
...(config.mcpServer?.enabled
|
|
1157
|
-
? [mcp({ loginPage: \`\${config.baseUrl}\${config.routes.auth}/login\` })]
|
|
1158
|
-
: []),
|
|
1159
|
-
`,"","auth config mcp plugin block",n);let u=B(t,"packages/auth/package.json"),g=JSON.parse(await Ao(u,"utf-8"));if(!g.exports)throw new Error(`${n}: expected an exports map in packages/auth/package.json (boilerplate drift).`);Zt(g.exports,"./mcp",'the "./mcp" export in packages/auth/package.json',n),await p(u,JSON.stringify(g,null," ")+`
|
|
1160
|
-
`);let l=B(t,"packages/api/package.json"),h=JSON.parse(await Ao(l,"utf-8"));if(!h.dependencies)throw new Error(`${n}: expected dependencies in packages/api/package.json (boilerplate drift).`);Zt(h.dependencies,"@mastra/mcp","@mastra/mcp in packages/api dependencies",n),Zt(h.dependencies,"@modelcontextprotocol/sdk","@modelcontextprotocol/sdk in packages/api dependencies",n),await p(l,JSON.stringify(h,null," ")+`
|
|
1161
|
-
`);let y=at(e);if(await Mr(t,y,"companion-agent-mcp",`/${y}/companion-agent-mcp`,n,"MCP"),await I(B(t,`docs/${y}/configuration.mdx`),`| \`mcpServer.enabled\` | \`false\` (requires \`ai\`) | Outward MCP server URL + the **MCP** settings tab - see [external agent (MCP)](/${y}/companion-agent-mcp) |
|
|
1162
|
-
`,"","configuration.mdx mcpServer config-table row",n),e.companion){let _=B(t,`docs/${y}/companion/index.mdx`);await I(_,`It is the user-owned counterpart to the [external agent (MCP)](/${y}/companion-agent-mcp): the MCP server lets a third-party agent reach into your app, while the companion daemon runs on the user's own hardware and reaches out to your app over authenticated HTTP.
|
|
1163
|
-
|
|
1164
|
-
`,"","companion index.mdx MCP counterpart paragraph",n),await I(_,` <Card title="External Agent (MCP)" href="/${y}/companion-agent-mcp" description="The other side - expose your app's capabilities to an external always-on agent over MCP." />
|
|
1165
|
-
`,"","companion index.mdx MCP card",n)}}import{readFile as Ro,rm as O}from"fs/promises";import{join as R}from"path";import{readFile as on}from"fs/promises";import{join as Tt}from"path";async function Po(e,t){let n=Tt(e,"packages/api/src/routes/internal/index.ts");await p(n,C(await on(n,"utf-8"),"internal router","companion",t)),await Qt(n);let r=Tt(e,"packages/api/src/ai/schedule-runner.ts");await p(r,C(await on(r,"utf-8"),"schedule-runner.ts","companion",t));for(let a of["packages/api/src/routes/internal/notifications.ts","packages/api/src/routes/internal/ai/index.ts","packages/api/src/routes/internal/ai/chat-router.ts","packages/api/src/routes/internal/ai/schedules-router.ts","packages/api/src/ai/byok.ts","packages/api/tests/ai/schedules.test.ts","packages/api/tests/ai/schedules-runs-route.test.ts","packages/api/tests/routes/ai.test.ts"]){let s=Tt(e,a);await p(s,C(await on(s,"utf-8"),a,"companion",t))}let o=Tt(e,"packages/api/src/ai/settings-store.ts");await I(o,`import { parseCompanionKey } from "../relay/companion-key";
|
|
1166
|
-
|
|
1167
|
-
`,"","settings-store.ts relay import",t),await I(o," * - COMPANION (when `config.companion.enabled`): a well-formed companion key\n * `<connectionId>@<deviceId>[@<modelId>]` persists as-is (the run path resolves it, and the\n * daemon handles an offline device).\n","","settings-store.ts COMPANION docstring bullet",t),await I(o,` if (config.companion?.enabled === true && parseCompanionKey(key) !== null) {
|
|
1168
|
-
return key;
|
|
1169
|
-
}
|
|
1170
|
-
`,"","settings-store.ts companion-key branch",t);let i=Tt(e,"packages/api/tests/ai/settings-store.test.ts");await p(i,C(await on(i,"utf-8"),"settings-store.test.ts","companion",t))}var ps=["companion:export","companion:verify","companion:publish"];async function Bn(e){if(e.companion)return;let t=e.projectDir,n="stripCompanion";await O(R(t,"packages/api/src/relay"),{recursive:!0}),await O(R(t,"packages/api/src/companion"),{recursive:!0}),await O(R(t,"packages/api/src/ai/companion-model.ts")),await O(R(t,"packages/api/tests/relay"),{recursive:!0}),await O(R(t,"packages/api/tests/companion"),{recursive:!0}),await O(R(t,"packages/api/src/routes/internal/companion.ts")),await O(R(t,"packages/api/src/routes/internal/companion-transport.ts")),await O(R(t,"packages/api/tests/routes/companion.test.ts")),await O(R(t,"packages/api/tests/routes/companion-transport-harness.ts")),await O(R(t,"packages/api/tests/routes/companion-transport-connect.test.ts")),await O(R(t,"packages/api/tests/routes/companion-transport-poll.test.ts")),await O(R(t,"packages/api/tests/routes/companion-transport-events.test.ts")),await O(R(t,"packages/api/tests/ai/schedule-coalesce.test.ts")),await O(R(t,"packages/api/tests/ai/schedules-lazy-expiry.test.ts")),await O(R(t,"packages/api/tests/ai/companion-model.test.ts")),await O(R(t,"packages/api/tests/ai/companion-chat.test.ts")),await O(R(t,"packages/api/tests/ai/web-tool-manifest.test.ts")),await O(R(t,"packages/api/tests/helpers/redis-mock.ts"));let r=R(t,"packages/api/package.json"),o=JSON.parse(await Ro(r,"utf-8"));if(!o.exports?.["./companion"])throw new Error(`${n}: expected packages/api/package.json to carry the ./companion export`);delete o.exports["./companion"],await Xt(r,o," ",n),await Po(t,n);let i=at(e);await Br(t,i,"companion",[`/${i}/companion`,`/${i}/companion/publishing`],n,"Companions"),await I(R(t,`docs/${i}/ai.mdx`),`Runs on a paired [companion](/${i}/companion) CLI are never metered either - the user's own subscription executes them. `,"","ai.mdx companion metering sentence",n),await I(R(t,`docs/${i}/configuration.mdx`),`| \`companion.enabled\` | \`false\` (requires \`ai\`) | Companion daemon pairing + the **Companions** settings tab - see [companion](/${i}/companion) |
|
|
1171
|
-
`,"","configuration.mdx companion config-table row",n)}async function Gn(e){if(Bt(e))return;let t=e.projectDir;await O(R(t,"apps/companion"),{recursive:!0}),await O(R(t,"scripts/companion-export"),{recursive:!0}),await ls(t)}async function Kn(e){if(!e.desktop||e.ai)return;let t=e.projectDir,n="stripDesktopCompanionDoc";await O(R(t,"docs/desktop/companion.mdx"));let r=R(t,"docs/desktop/meta.json"),o=JSON.parse(await Ro(r,"utf-8"));if(!o.pages.includes("companion"))throw new Error(`${n}: expected the desktop meta.json companion nav entry, but it was missing (boilerplate drift).`);o.pages=o.pages.filter(i=>i!=="companion"),await p(r,`${JSON.stringify(o,null,2)}
|
|
1172
|
-
`),await I(R(t,"docs/desktop/index.mdx"),` <Card href="/desktop/companion" title="Companion setup" description="The companion ships inside the app and runs as a local daemon, consent-first - no separate install, and pairing is optional." />
|
|
1173
|
-
`,"","desktop index companion card",n)}async function ls(e){await Hn(e,ps)}var ds=new Set(["ci.yml","desktop-release.yml"]),us={nextjs:["apps/web-next/app/[locale]/(marketing)/download","apps/web-next/tests/routes/download-page.test.tsx"],nuxt:["apps/web-nuxt/app/pages/download.vue","apps/web-nuxt/app/middleware/desktop.ts","apps/web-nuxt/server/api/desktop-releases.get.ts","apps/web-nuxt/tests/pages/download.test.ts"]},ms=["@repo/ai","@repo/agent-core","@repo/agent-core-types","ai","@ai-sdk/react","@homebridge/node-pty-prebuilt-multiarch","@xterm/xterm","@xterm/addon-fit"],fs=["cli","cli:clean","demo:bench","playground:regen","playground:test","playground:test:repo","playground:test:audit","playground:test:units","playground:test:build","playground:test:companion","ai:parity"];async function xo(e){let t=w(e.projectDir,".github/workflows"),n=await zn(t).catch(()=>[]);for(let r of n)ds.has(r)||await U(w(t,r),{recursive:!0,force:!0})}async function Hn(e,t){let n=w(e,"package.json"),r=JSON.parse(await V(n,"utf-8"));if(!r.scripts)return!1;let o=!1;for(let i of t)i in r.scripts&&(delete r.scripts[i],o=!0);return o&&await p(n,JSON.stringify(r,null," ")+`
|
|
1174
|
-
`),o}async function To(e){let t=[...fs];Mt(e)||t.push("infra","infra:stop"),await Hn(e.projectDir,t)}async function _o(e){let t=w(e.projectDir,"package.json"),n=await V(t,"utf-8"),r=JSON.parse(n);!r.scripts||!("dev"in r.scripts)||(r.scripts.dev=e.architecture==="separate"?"turbo run dev --continue":"turbo run dev --continue --filter=!backend",await p(t,JSON.stringify(r,null," ")+`
|
|
1175
|
-
`))}async function Oo(e){let t=e.frontend==="nextjs"?"apps/web-nuxt":"apps/web-next";await U(w(e.projectDir,t),{recursive:!0,force:!0})}async function Co(e){e.docs||await U(w(e.projectDir,"apps/docs"),{recursive:!0})}async function Do(e){let t=e.frontend==="nextjs"?"docs/nuxt":"docs/next";if(await U(w(e.projectDir,t),{recursive:!0,force:!0}),await U(w(e.projectDir,"docs/index.mdx")),!e.desktop)await U(w(e.projectDir,"docs/desktop"),{recursive:!0,force:!0});else if(!(e.desktop&&e.ai)){await U(w(e.projectDir,"docs/desktop/ai"),{recursive:!0,force:!0});let n=w(e.projectDir,"docs/desktop/meta.json"),r=JSON.parse(await V(n,"utf-8"));r.pages=r.pages.filter(o=>o!=="ai"),await p(n,`${JSON.stringify(r,null,2)}
|
|
1176
|
-
`)}await gs(e)}async function gs(e){let t=e.projectDir,n="stripUnusedDocsSilo",r=at(e),o=w(t,`docs/${r}/configuration.mdx`),i=e.desktop&&e.ai;e.desktop||(await I(o,"| Desktop app + device sign-in - see [desktop app](/desktop) |","| Desktop app + device sign-in |","configuration.mdx desktop config-table link",n),await I(o,"<Callout>\n**Shipping the [desktop app](/desktop)?** It needs no entry in `TRUSTED_ORIGINS`: its main process makes every backend call - dev and packaged alike - with no `Origin` header, so the backend treats it as a native client and never CORS-checks it. `TRUSTED_ORIGINS` governs your web frontends.\n</Callout>\n\n","","configuration.mdx desktop TRUSTED_ORIGINS callout",n),await I(w(t,"docs/cli/init.mdx"),"the [desktop app](/desktop), AI features","the desktop app, AI features","cli init.mdx desktop app link",n)),i||(await I(o,"The desktop app's AI orchestration gates on `config.desktop.agents.enabled`, which a desktop project derives from your AI option (not a separate switch) - see [desktop AI](/desktop/ai).\n\n","","configuration.mdx desktop-AI paragraph",n),e.companion&&(await I(w(t,`docs/${r}/companion/index.mdx`),`## Set up from the desktop app
|
|
1161
|
+
$1`),r!==n&&await p(t,r)}import{readdir as eo,readFile as Rn,rm as G}from"fs/promises";import{join as P}from"path";import{readFile as Qr,rm as T}from"fs/promises";import{join as R}from"path";import{readFile as At}from"fs/promises";import{join as It}from"path";async function Zr(e,t){let n=It(e,"packages/api/src/routes/internal/index.ts");await p(n,Se(await At(n,"utf-8"),"internal router","companion",t)),await hr(n);let r=It(e,"packages/api/src/ai/schedule-runner.ts");await p(r,Se(await At(r,"utf-8"),"schedule-runner.ts","companion",t));for(let a of["packages/api/src/routes/internal/notifications.ts","packages/api/src/routes/internal/ai/index.ts","packages/api/src/routes/internal/ai/chat-router.ts","packages/api/src/routes/internal/ai/schedules-router.ts","packages/api/src/ai/byok.ts","packages/api/tests/ai/schedules.test.ts","packages/api/tests/ai/schedules-runs-route.test.ts","packages/api/tests/routes/ai.test.ts"]){let s=It(e,a);await p(s,Se(await At(s,"utf-8"),a,"companion",t))}let o=It(e,"packages/api/src/ai/settings-store.ts");await p(o,Se(await At(o,"utf-8"),"settings-store.ts","companion",t));let i=It(e,"packages/api/tests/ai/settings-store.test.ts");await p(i,Se(await At(i,"utf-8"),"settings-store.test.ts","companion",t))}var Ba=["companion:export","companion:verify","companion:publish"];async function En(e){if(e.companion)return;let t=e.projectDir,n="stripCompanion";await T(R(t,"packages/api/src/relay"),{recursive:!0}),await T(R(t,"packages/api/src/companion"),{recursive:!0}),await T(R(t,"packages/api/src/ai/companion-model.ts")),await T(R(t,"packages/api/tests/relay"),{recursive:!0}),await T(R(t,"packages/api/tests/companion"),{recursive:!0}),await T(R(t,"packages/api/src/routes/internal/companion.ts")),await T(R(t,"packages/api/src/routes/internal/companion-transport.ts")),await T(R(t,"packages/api/tests/routes/companion.test.ts")),await T(R(t,"packages/api/tests/routes/companion-transport-harness.ts")),await T(R(t,"packages/api/tests/routes/companion-transport-connect.test.ts")),await T(R(t,"packages/api/tests/routes/companion-transport-poll.test.ts")),await T(R(t,"packages/api/tests/routes/companion-transport-events.test.ts")),await T(R(t,"packages/api/tests/ai/schedule-coalesce.test.ts")),await T(R(t,"packages/api/tests/ai/schedules-lazy-expiry.test.ts")),await T(R(t,"packages/api/tests/ai/companion-model.test.ts")),await T(R(t,"packages/api/tests/ai/companion-chat.test.ts")),await T(R(t,"packages/api/tests/ai/web-tool-manifest.test.ts")),await T(R(t,"packages/api/tests/helpers/redis-mock.ts"));let r=R(t,"packages/api/package.json"),o=JSON.parse(await Qr(r,"utf-8"));if(!o.exports?.["./companion"])throw new Error(`${n}: expected packages/api/package.json to carry the ./companion export`);delete o.exports["./companion"],await Bt(r,o," ",n),await Zr(t,n);let i=Gt(e);await gr(t,i,"companion",[`/${i}/companion`,`/${i}/companion/publishing`],n,"Companions"),await B(R(t,`docs/${i}/ai.mdx`),`Runs on a paired [companion](/${i}/companion) CLI are never metered either - the user's own subscription executes them. `,"","ai.mdx companion metering sentence",n);let a=R(t,`docs/${i}/configuration.mdx`),s="| `companion.enabled` |",u=(await Qr(a,"utf-8")).split(`
|
|
1162
|
+
`).find(g=>g.startsWith(s));if(u===void 0)throw new Error(`${n}: expected the ${i} configuration.mdx \`companion.enabled\` row (boilerplate drift).`);await B(a,`${u}
|
|
1163
|
+
`,"","configuration.mdx companion config-table row",n)}async function An(e){if($t(e))return;let t=e.projectDir;await T(R(t,"apps/companion"),{recursive:!0}),await T(R(t,"scripts/companion-export"),{recursive:!0}),await Ga(t)}async function Ga(e){await In(e,Ba)}var Ka=new Set(["ci.yml","desktop-release.yml"]),Ha={nextjs:["apps/web-next/app/[locale]/(marketing)/download","apps/web-next/tests/routes/download-page.test.tsx"],nuxt:["apps/web-nuxt/app/pages/download.vue","apps/web-nuxt/app/middleware/desktop.ts","apps/web-nuxt/server/api/desktop-releases.get.ts","apps/web-nuxt/tests/pages/download.test.ts"]},za=["cli","cli:clean","demo:bench","playground:regen","playground:test","playground:test:repo","playground:test:audit","playground:test:units","playground:test:build","playground:test:companion","ai:parity"];async function to(e){let t=P(e.projectDir,".github/workflows"),n=await eo(t).catch(()=>[]);for(let r of n)Ka.has(r)||await G(P(t,r),{recursive:!0,force:!0})}async function In(e,t){let n=P(e,"package.json"),r=JSON.parse(await Rn(n,"utf-8"));if(!r.scripts)return!1;let o=!1;for(let i of t)i in r.scripts&&(delete r.scripts[i],o=!0);return o&&await p(n,JSON.stringify(r,null," ")+`
|
|
1164
|
+
`),o}async function no(e){let t=[...za];Dt(e)||t.push("infra","infra:stop"),await In(e.projectDir,t)}async function ro(e){let t=P(e.projectDir,"package.json"),n=await Rn(t,"utf-8"),r=JSON.parse(n);!r.scripts||!("dev"in r.scripts)||(r.scripts.dev=e.architecture==="separate"?"turbo run dev --continue":"turbo run dev --continue --filter=!backend",await p(t,JSON.stringify(r,null," ")+`
|
|
1165
|
+
`))}async function oo(e){let t=e.frontend==="nextjs"?"apps/web-nuxt":"apps/web-next";await G(P(e.projectDir,t),{recursive:!0,force:!0})}async function io(e){e.docs||await G(P(e.projectDir,"apps/docs"),{recursive:!0})}async function ao(e){let t=e.frontend==="nextjs"?"docs/nuxt":"docs/next";await G(P(e.projectDir,t),{recursive:!0,force:!0}),await G(P(e.projectDir,"docs/index.mdx")),e.desktop||await G(P(e.projectDir,"docs/desktop"),{recursive:!0,force:!0}),await Ja(e)}async function Ja(e){let t=e.projectDir,n="stripUnusedDocsSilo",r=Gt(e),o=P(t,`docs/${r}/configuration.mdx`),i=e.desktop,a=e.desktop&&e.ai;e.desktop||(await B(o,"| Desktop app + device sign-in - see [desktop app](/desktop) |","| Desktop app + device sign-in |","configuration.mdx desktop config-table link",n),await B(o,"<Callout>\n**Shipping the [desktop app](/desktop)?** It needs no entry in `TRUSTED_ORIGINS`: its main process makes every backend call - dev and packaged alike - with no `Origin` header, so the backend treats it as a native client and never CORS-checks it. `TRUSTED_ORIGINS` governs your web frontends.\n</Callout>\n\n","","configuration.mdx desktop TRUSTED_ORIGINS callout",n),await B(P(t,"docs/cli/init.mdx"),"the [desktop app](/desktop), AI features","the desktop app, AI features","cli init.mdx desktop app link",n)),i||await B(o,"The desktop app's AI orchestration gates on `config.desktop.agents.enabled`, which a desktop project derives from your AI option (not a separate switch). The app always ships that AI source, so flipping the flag on turns the screens back on - but the bundled companion daemon is **not** runtime-toggleable: a project generated without AI never received `apps/companion`. Leaving the flag off costs nothing (the staging step skips itself and the app packages fine); it is turning it on that requires re-running the CLI with AI on first - see [desktop AI](/desktop/ai).\n\n","","configuration.mdx desktop-AI paragraph",n),!a&&e.companion&&(await B(P(t,`docs/${r}/companion/index.mdx`),`## Set up from the desktop app
|
|
1177
1166
|
|
|
1178
1167
|
If your product also ships the [desktop app](/desktop), it runs the companion for each user as a local daemon on their own machine - consent-first, with no terminal, no pairing, and no code to copy. It attaches to any daemon already serving the machine - including the user's own always-on service - and starts its own only when none is running, so one daemon serves both the app and any paired backend. It supervises that daemon while the app is open and, on quit, stops only the one it started - never the user's service. See [Companion setup](/desktop/companion).
|
|
1179
1168
|
|
|
1180
|
-
`,"","companion index.mdx desktop-setup section",n),await
|
|
1169
|
+
`,"","companion index.mdx desktop-setup section",n),await B(P(t,`docs/${r}/companion/terminal.mdx`),`## In the desktop app
|
|
1181
1170
|
|
|
1182
1171
|
If your product ships the [desktop app](/desktop), its **Terminal** side-panel tab is this same session, in an embedded terminal: the app spawns the daemon's \`terminal\` command in a real pty, and its folder picker **grants** the folder it picked (the durable, per-app grant above) before the session opens. See [Terminal and side panel](/desktop/ai/terminal).
|
|
1183
1172
|
|
|
1184
|
-
`,"","companion terminal.mdx desktop-panel section",n)))
|
|
1185
|
-
`,"","desktop index.mdx AI card",n)}async function No(e){if(e.desktop)return;await U(w(e.projectDir,"apps/electron"),{recursive:!0});let t=w(e.projectDir,"packages/i18n/translations");for(let o of await zn(t,{withFileTypes:!0}))o.isDirectory()&&await U(w(t,o.name,"desktop.json"),{force:!0});await U(w(e.projectDir,".github/workflows/desktop-release.yml"));for(let o of us[e.frontend])await U(w(e.projectDir,o),{recursive:!0});await U(w(e.projectDir,"packages/utils/src/desktop-download.ts")),await U(w(e.projectDir,"packages/utils/tests/desktop-download.test.ts"));let n=w(e.projectDir,"packages/utils/package.json"),r=JSON.parse(await V(n,"utf-8"));if(!r.exports?.["./desktop-download"])throw new Error("stripDesktopApp: expected packages/utils/package.json to carry the ./desktop-download export");delete r.exports["./desktop-download"],await Xt(n,r," ","stripDesktopApp")}async function $o(e){Bt(e)||await U(w(e.projectDir,"packages/agent-core"),{recursive:!0})}function _t(e,t,n,r){let o=e.indexOf(t);if(o===-1)throw new Error(`stripDesktopAi: expected to find the ${r} seam, but it was missing (boilerplate drift).`);if(e.indexOf(t,o+t.length)!==-1)throw new Error(`stripDesktopAi: the ${r} seam appears more than once (boilerplate drift).`);return e.slice(0,o)+n+e.slice(o+t.length)}async function Lo(e){if(!e.desktop||e.ai)return;let t=e.projectDir,n="apps/electron";for(let a of[`${n}/src/renderer/screens/agents`,`${n}/src/renderer/screens/chat.tsx`,`${n}/src/renderer/screens/schedules.tsx`,`${n}/src/renderer/screens/settings/models.tsx`,`${n}/src/renderer/screens/settings/tasks.tsx`,`${n}/src/renderer/screens/settings/mcp.tsx`,`${n}/src/renderer/screens/settings/integrations.tsx`,`${n}/src/renderer/screens/settings/integration-add-dialog.tsx`,`${n}/src/renderer/screens/settings/integration-types.ts`,`${n}/src/renderer/screens/settings/settings-tabs.tsx`,`${n}/src/renderer/screens/settings/settings-tab-ids.ts`,`${n}/src/renderer/screens/settings/connected-cache.ts`,`${n}/src/renderer/components/section-tabs.tsx`,`${n}/src/renderer/hooks/use-ai-terminal.ts`,`${n}/src/renderer/hooks/use-xterm.ts`,`${n}/src/renderer/hooks/use-automation-lifecycle.ts`,`${n}/src/renderer/lib/companion`,`${n}/src/renderer/hooks/use-chat-controller.ts`,`${n}/src/renderer/hooks/use-local-run.ts`,`${n}/src/renderer/hooks/use-local-model-options.ts`,`${n}/src/renderer/lib/drive-chat-store.ts`,`${n}/src/renderer/lib/local-drive.ts`,`${n}/src/renderer/hooks/use-mounted.ts`,`${n}/src/renderer/lib/ai`,`${n}/src/renderer/lib/side-panel-state.ts`,`${n}/src/renderer/components/side-panel-dock.tsx`,`${n}/src/renderer/components/side-panel.tsx`,`${n}/src/renderer/config/side-panels.tsx`,`${n}/src/renderer/components/command-palette/command-palette-ai-commands.tsx`])await U(w(t,a),{recursive:!0});for(let a of[`${n}/src/preload/api-contract.ts`,`${n}/src/main/drive-transport.ts`,`${n}/src/main/companion.ts`,`${n}/src/main/companion-state.ts`,`${n}/src/main/companion-parsers.ts`,`${n}/src/main/companion-paths.ts`,`${n}/src/main/companion-drive.ts`,`${n}/src/main/companion-staging.ts`,`${n}/src/main/companion-stderr-tail.ts`,`${n}/src/main/companion-commands-pure.ts`,`${n}/src/main/companion-shared.ts`,`${n}/src/main/companion-commands.ts`,`${n}/src/main/terminal.ts`,`${n}/src/main/terminal-state.ts`])await U(w(t,a));await U(w(t,`${n}/scripts/stage-companion.mjs`));for(let a of[`${n}/tests/ai-import-boundary.test.ts`,`${n}/tests/renderer/settings-tab-ids.test.ts`,`${n}/tests/renderer/connected-cache.test.ts`,`${n}/tests/renderer/router-redirects.test.ts`,`${n}/tests/renderer/lib/side-panel-state.test.ts`,`${n}/tests/renderer/schedules-view.test.ts`,`${n}/tests/renderer/automation-status.test.ts`,`${n}/tests/renderer/consent-dialog.test.ts`,`${n}/tests/renderer/background-mode.test.ts`,`${n}/tests/renderer/connection-state.test.ts`,`${n}/tests/renderer/models-empty-view.test.ts`,`${n}/tests/renderer/models-default-reset.test.ts`,`${n}/tests/renderer/cli-catalog.test.ts`,`${n}/tests/renderer/connect-flow.test.ts`,`${n}/tests/renderer/terminal-settings-view.test.ts`,`${n}/tests/renderer/mcp-section-i18n.test.ts`,`${n}/tests/renderer/reload-on-companion-ready.test.ts`,`${n}/tests/renderer/schedule-merge.test.ts`,`${n}/tests/renderer/terminal-tools.test.ts`,`${n}/tests/renderer/terminal-hint-interpolation.test.ts`,`${n}/tests/renderer/lib/companion/consent.test.ts`,`${n}/tests/renderer/lib/companion/ensure.test.ts`,`${n}/tests/renderer/lib/companion/pairing.test.ts`,`${n}/tests/renderer/lib/companion/ensure-unpublished-brand.test.ts`,`${n}/tests/renderer/lib/companion/terminal.test.ts`,`${n}/tests/renderer/lib/companion/terminal-unpublished-brand.test.ts`,`${n}/tests/task-overrides.test.ts`,`${n}/tests/local-drive.test.ts`,`${n}/tests/drive-chat-store.test.ts`,`${n}/tests/use-local-run.test.ts`,`${n}/tests/use-local-model-options.test.ts`,`${n}/tests/renderer/chat-controller-local-seed.test.ts`,`${n}/tests/main/companion-state.test.ts`,`${n}/tests/main/companion-commands.test.ts`,`${n}/tests/main/companion-supervisor.test.ts`,`${n}/tests/main/companion-restage.test.ts`,`${n}/tests/main/companion-teardown.process.test.ts`,`${n}/tests/stage-companion.test.ts`,`${n}/tests/main/drive-preload-stream.test.ts`,`${n}/tests/main/drive-transport.test.ts`,`${n}/tests/main/ipc.test.ts`,`${n}/tests/main/terminal-cli-allowlist.test.ts`,`${n}/tests/main/terminal-manager.process.test.ts`,`${n}/tests/main/terminal-state.test.ts`,`${n}/tests/main/terminal-teardown.process.test.ts`,`${n}/tests/renderer/api-consumer-fixture.ts`])await U(w(t,a));let r=w(t,`${n}/package.json`),o=JSON.parse(await V(r,"utf-8"));for(let a of ms){if(!o.dependencies||!(a in o.dependencies))throw new Error(`stripDesktopAi: expected ${a} in ${n} dependencies (boilerplate drift).`);delete o.dependencies[a]}if(!o.scripts||!("rebuild:electron"in o.scripts))throw new Error(`stripDesktopAi: expected the rebuild:electron script in ${n} package.json (boilerplate drift).`);delete o.scripts["rebuild:electron"],hs(o,"stage:companion",n),await p(r,JSON.stringify(o,null,2)+`
|
|
1186
|
-
`),await ys(t,n);let i=w(t,"packages/i18n/translations");for(let a of await zn(i,{withFileTypes:!0})){if(!a.isDirectory())continue;let s=w(i,a.name,"desktop.json"),u=await V(s,"utf-8").catch(()=>null);if(u===null)continue;let g=JSON.parse(u),l=!1;for(let h of["agents","ai_hub","schedules","integrations"])h in g&&(delete g[h],l=!0);l&&await p(s,JSON.stringify(g,null," ")+`
|
|
1187
|
-
`)}}function hs(e,t,n){if(!e.scripts||!(t in e.scripts))throw new Error(`stripDesktopAi: expected the ${t} script in ${n} package.json (boilerplate drift).`);delete e.scripts[t];let r=`pnpm run ${t} && `;for(let o of["build:unpack","build:win","build:mac","build:linux","release"]){let i=e.scripts[o];if(i===void 0||!i.startsWith(r))throw new Error(`stripDesktopAi: expected ${o} to begin with "${r}" in ${n} package.json (boilerplate drift).`);e.scripts[o]=i.slice(r.length)}}async function ys(e,t){let n=w(e,`${t}/src/renderer/components/shell.tsx`);await p(n,C(await V(n,"utf-8"),"components/shell.tsx"));let r=w(e,`${t}/src/renderer/components/auth-gate.tsx`);await p(r,C(await V(r,"utf-8"),"components/auth-gate.tsx")),await I(r,` // The chat shell owns the ONE chat controller above the router, so a run keeps streaming as the user
|
|
1188
|
-
// moves between the \`/chat\` screen and the side-panel chat tab. Stripped to a bare RouterProvider when
|
|
1189
|
-
// the agents feature is off.
|
|
1190
|
-
return (
|
|
1191
|
-
<ChatShellProvider>
|
|
1192
|
-
<RouterProvider router={router} />
|
|
1193
|
-
</ChatShellProvider>
|
|
1194
|
-
)
|
|
1195
|
-
`,` return <RouterProvider router={router} />
|
|
1196
|
-
`,"auth-gate chat shell wrapper","stripDesktopAi");let o=w(e,`${t}/src/renderer/config/sidebar.ts`),i=C(await V(o,"utf-8"),"config/sidebar.ts");i=_t(i,`import {
|
|
1197
|
-
BuildingsIcon,
|
|
1198
|
-
ChatCircleIcon,
|
|
1199
|
-
ClockCountdownIcon,
|
|
1200
|
-
GearIcon,
|
|
1201
|
-
HouseIcon,
|
|
1202
|
-
UserCircleIcon
|
|
1203
|
-
} from '@phosphor-icons/react'`,"import { BuildingsIcon, GearIcon, HouseIcon, UserCircleIcon } from '@phosphor-icons/react'","sidebar icon imports"),await p(o,i);let a=w(e,`${t}/src/renderer/lib/config.ts`),s=C(await V(a,"utf-8"),"lib/config.ts");s=s.replace(/,(\n\} as const)/,"$1"),await p(a,s);let u=w(e,`${t}/src/renderer/lib/sidebar-flags.ts`);await p(u,C(await V(u,"utf-8"),"lib/sidebar-flags.ts"));let g=w(e,`${t}/src/renderer/router.tsx`),l=C(await V(g,"utf-8"),"router.tsx");l=_t(l,`import { clientConfig } from '@/lib/config'
|
|
1204
|
-
`,"","router clientConfig import"),l=_t(l,` createRouter,
|
|
1205
|
-
redirect
|
|
1206
|
-
} from '@tanstack/react-router'`,` createRouter
|
|
1207
|
-
} from '@tanstack/react-router'`,"router redirect import specifier"),l=_t(l,`import { ChatScreen } from '@/screens/chat'
|
|
1208
|
-
import { SchedulesScreen } from '@/screens/schedules'
|
|
1209
|
-
import { ModelsSettingsScreen } from '@/screens/settings/models'
|
|
1210
|
-
import { TasksSettingsScreen } from '@/screens/settings/tasks'
|
|
1211
|
-
import { McpSettingsScreen } from '@/screens/settings/mcp'
|
|
1212
|
-
import { IntegrationsSettingsScreen } from '@/screens/settings/integrations'
|
|
1213
|
-
`,"","router AI screen imports"),l=_t(l,` ...(clientConfig.agentsEnabled ? aiRoutes : []),
|
|
1214
|
-
`,"","router ai route spread"),await p(g,l);let h=w(e,`${t}/src/renderer/screens/settings/index.tsx`);await p(h,C(await V(h,"utf-8"),"screens/settings/index.tsx"));let y=w(e,`${t}/src/main/ipc.ts`);await p(y,C(await V(y,"utf-8"),"src/main/ipc.ts"));let _=w(e,`${t}/src/main/index.ts`);await p(_,C(await V(_,"utf-8"),"src/main/index.ts"));let v=w(e,`${t}/src/preload/index.ts`);await p(v,C(await V(v,"utf-8"),"src/preload/index.ts"));let $=w(e,`${t}/electron-builder.mjs`);await p($,C(await V($,"utf-8"),"electron-builder.mjs"))}import{readFile as ws}from"fs/promises";import{join as vs}from"path";var Uo=`on:
|
|
1173
|
+
`,"","companion terminal.mdx desktop-panel section",n))}async function so(e){if(e.desktop)return;await G(P(e.projectDir,"apps/electron"),{recursive:!0});let t=P(e.projectDir,"packages/i18n/translations");for(let o of await eo(t,{withFileTypes:!0}))o.isDirectory()&&await G(P(t,o.name,"desktop.json"),{force:!0});await G(P(e.projectDir,".github/workflows/desktop-release.yml"));for(let o of Ha[e.frontend])await G(P(e.projectDir,o),{recursive:!0});await G(P(e.projectDir,"packages/utils/src/desktop-download.ts")),await G(P(e.projectDir,"packages/utils/tests/desktop-download.test.ts"));let n=P(e.projectDir,"packages/utils/package.json"),r=JSON.parse(await Rn(n,"utf-8"));if(!r.exports?.["./desktop-download"])throw new Error("stripDesktopApp: expected packages/utils/package.json to carry the ./desktop-download export");delete r.exports["./desktop-download"],await Bt(n,r," ","stripDesktopApp")}function Ya(e){return $t(e)||e.desktop}async function co(e){Ya(e)||await G(P(e.projectDir,"packages/agent-core"),{recursive:!0})}import{readFile as qa}from"fs/promises";import{join as Wa}from"path";var po=`on:
|
|
1215
1174
|
workflow_run:
|
|
1216
1175
|
workflows: ["Tag Release"]
|
|
1217
1176
|
branches: [main]
|
|
1218
1177
|
types: [completed]
|
|
1219
|
-
workflow_dispatch:`,
|
|
1220
|
-
workflow_run:
|
|
1221
|
-
workflows: ["CI"]
|
|
1222
|
-
branches: [main]
|
|
1223
|
-
types: [completed]
|
|
1224
|
-
workflow_dispatch:`,bs=`on:
|
|
1225
|
-
# Automatic release on CI success is disabled for this project to conserve
|
|
1226
|
-
# GitHub Actions minutes. Re-enable by uncommenting the workflow_run trigger.
|
|
1227
|
-
# workflow_run:
|
|
1228
|
-
# workflows: ["CI"]
|
|
1229
|
-
# branches: [main]
|
|
1230
|
-
# types: [completed]
|
|
1231
|
-
workflow_dispatch:`;async function jo(e){if(!e.desktop)return;let t=vs(e.projectDir,".github/workflows/desktop-release.yml"),n=await ws(t,"utf8");if(!n.includes(Uo))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.`);let r=e.desktopAutoRelease?ks:bs;await p(t,n.replace(Uo,r))}import{join as Ss}from"path";async function Mo(e){let t=Es(e);await p(Ss(e.projectDir,".github/workflows/ci.yml"),t)}function Es(e){let t=q[e.databaseProvider].managed,n=e.cacheProvider==="upstash",r=e.frontend==="nuxt",o=t?"":` services:
|
|
1178
|
+
workflow_dispatch:`,Xa=`on:
|
|
1179
|
+
workflow_dispatch:`;async function lo(e){if(!e.desktop)return;let t=Wa(e.projectDir,".github/workflows/desktop-release.yml"),n=await qa(t,"utf8");if(!n.includes(po))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 p(t,n.replace(po,Xa))}import{join as Za}from"path";async function uo(e){let t=Qa(e);await p(Za(e.projectDir,".github/workflows/ci.yml"),t)}function Qa(e){let t=K[e.databaseProvider].managed,n=e.cacheProvider==="upstash",r=e.frontend==="nuxt",o=t?"":` services:
|
|
1232
1180
|
postgres:
|
|
1233
1181
|
image: postgres:18-alpine
|
|
1234
1182
|
env:
|
|
@@ -1248,8 +1196,7 @@ import { IntegrationsSettingsScreen } from '@/screens/settings/integrations'
|
|
|
1248
1196
|
STRIPE_SECRET_KEY: test
|
|
1249
1197
|
STRIPE_WEBHOOK_SECRET: test`;case"polar":return`
|
|
1250
1198
|
POLAR_ACCESS_TOKEN: test
|
|
1251
|
-
POLAR_WEBHOOK_SECRET: test`;case"none":return"";default:{let
|
|
1252
|
-
${y.name}: test`).join("")).join("");return`# Deployment is handled by the hosting platform (Vercel, Coolify, etc.)
|
|
1199
|
+
POLAR_WEBHOOK_SECRET: test`;case"none":return"";default:{let l=e.paymentProvider;throw new Error(`buildCiYaml: unhandled payment provider "${String(l)}"`)}}})();return`# Deployment is handled by the hosting platform (Vercel, Coolify, etc.)
|
|
1253
1200
|
# which auto-deploys on push. CI runs in parallel as a quality gate.
|
|
1254
1201
|
# For PR-based workflows, enable GitHub branch protection to require CI before merging.
|
|
1255
1202
|
|
|
@@ -1274,7 +1221,7 @@ jobs:
|
|
|
1274
1221
|
runs-on: ubuntu-latest
|
|
1275
1222
|
timeout-minutes: 20
|
|
1276
1223
|
${o} env:
|
|
1277
|
-
CONTENT_API_KEY: test-contentapi-key-16chars${a}${s}
|
|
1224
|
+
CONTENT_API_KEY: test-contentapi-key-16chars${a}${s}
|
|
1278
1225
|
STORAGE_REGION: test
|
|
1279
1226
|
STORAGE_ENDPOINT: http://test
|
|
1280
1227
|
STORAGE_ACCESS_KEY_ID: test
|
|
@@ -1298,48 +1245,50 @@ ${r?` # vue-tsc on web-nuxt OOMs on the GitHub runner's default heap once
|
|
|
1298
1245
|
run: echo "DATABASE_URL=${i}" > .env
|
|
1299
1246
|
|
|
1300
1247
|
- run: pnpm test
|
|
1301
|
-
`}import{readFile as
|
|
1302
|
-
`))}async function
|
|
1303
|
-
`))}async function
|
|
1248
|
+
`}import{readFile as mo}from"fs/promises";import{existsSync as es}from"fs";import{join as Pn}from"path";var fo="@repo/database";function ts(e){return e?"pnpm -F @repo/database reset && pnpm -F @repo/database run deploy -- --push":"pnpm -F @repo/database run deploy"}function ns(e,t){switch(e){case"fullstack":return t==="nextjs"?"web-next":"web-nuxt";case"separate":return"backend";default:{let n=e;throw new Error(`schemaOwnerApp: unhandled architecture "${String(n)}"`)}}}async function rs(e,t,n){let r=await mo(e,"utf-8"),o=JSON.parse(r),i=o.scripts?.[t];if(!i)throw new Error(`Cannot prepend to missing script "${t}" in ${e}`);i.includes(fo)||(o.scripts={...o.scripts,[t]:`${n} && ${i}`},await p(e,JSON.stringify(o,null," ")+`
|
|
1249
|
+
`))}async function os(e,t){let n=es(e)?JSON.parse(await mo(e,"utf-8")):{$schema:"https://openapi.vercel.sh/vercel.json"},r=n.buildCommand?.trim()||"pnpm build";r.includes(fo)||(n.buildCommand=`${t} && ${r}`,await p(e,JSON.stringify(n,null," ")+`
|
|
1250
|
+
`))}async function go(e){let t=ts(e.demo===!0),n=ns(e.architecture,e.frontend),r=Pn(e.projectDir,"apps",n);switch(e.deploymentTarget){case"node":await rs(Pn(r,"package.json"),"start",t);return;case"vercel":await os(Pn(r,"vercel.json"),t);return;default:{let o=e.deploymentTarget;throw new Error(`generateDeployScripts: unhandled deployment target "${String(o)}"`)}}}import{readFile as is}from"fs/promises";import{existsSync as as}from"fs";import{join as Yt}from"path";var ss=["stripe","polar"];async function ho(e){let t=Yt(e.projectDir,"packages/payments/src"),n=e.paymentProvider,r=`// Active payment provider. To switch, change the path below to
|
|
1304
1251
|
// "./polar/index" or "./none/index" (other folders are kept in place).
|
|
1305
1252
|
export { ops } from "./${n}/index";
|
|
1306
|
-
`;await p(
|
|
1253
|
+
`;await p(Yt(t,"providers/index.ts"),r),await p(Yt(t,"index.ts"),await cs(t,n))}async function cs(e,t){let n=Yt(e,"index.ts");if(!as(n))throw new Error(`generatePaymentBarrel: expected ${n} to exist - did packages/payments move?`);let r=await is(n,"utf-8"),o=ss.filter(a=>a!==t);return r.split(`
|
|
1307
1254
|
`).filter(a=>!o.some(s=>a.includes(`./providers/${s}/`))).join(`
|
|
1308
|
-
`)}import{readdir as
|
|
1255
|
+
`)}import{readdir as ps,readFile as ls}from"fs/promises";import{join as yo}from"path";async function wo(e){if(e.demo)return;let t=e.appName.trim()||e.projectName,n=JSON.stringify(t).slice(1,-1),r=yo(e.projectDir,"packages/i18n/translations"),o;try{o=await ps(r)}catch{return}for(let i of o){let a=yo(r,i,"web.json"),s;try{s=await ls(a,"utf-8")}catch{continue}let u=s.replaceAll("GenerateSaaS",n);u!==s&&await p(a,u)}}import{readFile as ds}from"fs/promises";import{join as vo}from"path";var us=[".nuxt/",".nuxt",".nitro/",".nitro",".output/",".output","_locales/"],ms=[".next/",".next",".svelte-kit/",".svelte-kit",".wrangler/",".wrangler",".dev.vars"];async function bo(e){let n=e.frontend==="nuxt"?ms:us;await ko(vo(e.projectDir,".gitignore"),n),await ko(vo(e.projectDir,".dockerignore"),n)}async function ko(e,t){let n;try{n=await ds(e,"utf-8")}catch{return}let r=new Set(t),o=n.split(`
|
|
1309
1256
|
`).filter(i=>!r.has(i.trim()));o.length!==n.split(`
|
|
1310
1257
|
`).length&&await p(e,o.join(`
|
|
1311
|
-
`))}async function
|
|
1312
|
-
`),await p(
|
|
1313
|
-
`)}import{relative as
|
|
1258
|
+
`))}async function qt(e){let t=e.projectDir;e.demo||(await wr(t),await kr(t),await br(t),await Sr(t),e.desktop&&await vr(t)),await Er(t,e.aiTools),await Ar(t,e.frontend),await Rr(e),await Pr(e),await _r(e),await Tr(e),e.demo||await xr(e),await Cr(e);let n=await Nr(e);return await $r(e),await Lr(e),await jr(e),await Ur(e),await Mr(e),await Fr(e),await Kr(e),await Hr(e),await Yr(e),await Xr(e),await to(e),await uo(e),await no(e),await ro(e),await oo(e),await io(e),await ao(e),await so(e),await co(e),await lo(e),await En(e),await An(e),await go(e),await ho(e),await wo(e),await bo(e),{dockerComposeGenerated:n}}import{basename as Eo,join as Ao,relative as gs}from"path";import{createHash as So}from"crypto";import{readFile as fs}from"fs/promises";async function Wt(e){let t=await fs(e);return So("sha256").update(t).digest("hex")}function Tn(e){return So("sha256").update(e).digest("hex")}var hs=new Set(["data",V]);function ys(e){let t=e.split("/");for(let n of t)if(un.has(n)||mn.has(n)||hs.has(n)||n.startsWith(".env")&&!n.includes("example"))return!0;return!1}function Io(e,t){return{projectName:e.projectName??Eo(t),appName:e.appName??e.projectName??Eo(t),projectDir:t,frontend:e.frontend==="nextjs"?"nextjs":"nuxt",architecture:e.architecture??"fullstack",paymentProvider:e.paymentProvider??"none",emailProvider:e.emailProvider??"smtp",multiTenancy:e.multiTenancy??!1,blog:e.blog??!1,docs:e.docs??!1,desktop:e.desktop??!1,ai:e.ai??!1,companion:e.companion??!1,companionSource:H(e),companionRepoUrl:e.companionRepoUrl??Te,companionName:e.companionName??W(e.projectName),revenueSharing:e.revenueSharing??!1,credits:e.credits??!1,dockerServices:e.dockerServices??[],aiTools:e.aiTools??[],defaultCurrency:e.defaultCurrency??"USD",deploymentTarget:e.deploymentTarget??"node",databaseProvider:e.databaseProvider??"postgres",cacheProvider:e.cacheProvider??"redis",version:e.version,baseUrl:e.baseUrl,credentials:{},demo:!1}}function ws(e,t){return{version:e.version,initialVersion:e.version,repo:"Duzbee/GenerateSaaS",appName:e.appName,projectName:e.projectName,frontend:e.frontend,architecture:e.architecture,paymentProvider:e.paymentProvider,emailProvider:e.emailProvider,multiTenancy:e.multiTenancy,blog:e.blog,docs:e.docs,desktop:e.desktop,ai:e.ai,companion:e.companion,...e.companionName?{companionName:e.companionName}:{},...e.companionSource?{companionSource:e.companionSource}:{},...e.companionRepoUrl?{companionRepoUrl:e.companionRepoUrl}:{},credits:e.credits,revenueSharing:e.revenueSharing,defaultCurrency:e.defaultCurrency,dockerServices:e.dockerServices,deploymentTarget:e.deploymentTarget,databaseProvider:e.databaseProvider,cacheProvider:e.cacheProvider,aiTools:e.aiTools,...e.baseUrl?{baseUrl:e.baseUrl}:{},...t&&{licenseToken:t.token,licenseKeyHash:t.keyHash,installId:t.installId}}}async function Ro(e,t){let r=(await De(e.projectDir,e.projectDir,ys)).sort(),o=await Promise.all(r.map(async s=>[Oe(gs(e.projectDir,s)),await Wt(s)])),i=Object.fromEntries(o),a=ws(e,t);await p(Ao(e.projectDir,we),JSON.stringify(a,null," ")+`
|
|
1259
|
+
`),await p(Ao(e.projectDir,sr),JSON.stringify(i,null," ")+`
|
|
1260
|
+
`)}import{relative as vs}from"path";async function Ne(e){let n=(await De(e,e,Xe)).sort(),r=await Promise.all(n.map(async o=>[Oe(vs(e,o)),await Wt(o)]));return Object.fromEntries(r)}import{copyFile as ks,mkdir as bs,rm as Ss}from"fs/promises";import{dirname as Es,join as Po,relative as As}from"path";import{existsSync as Is}from"fs";async function _n(e,t){Is(t)&&await Ss(t,{recursive:!0,force:!0});let n=await De(e,e,Xe);for(let r of n){let o=Oe(As(e,r)),i=Po(t,o);await bs(Es(i),{recursive:!0}),await ks(r,i)}}async function To(e,t){await _n(e,Po(t,jt))}import{existsSync as Rs}from"fs";import{readFile as _o,readdir as Ps}from"fs/promises";import{join as ie,dirname as Ts,resolve as _s,sep as xs}from"path";import{fileURLToPath as Os}from"url";var Rt={"claude-code":".claude/skills",cursor:".cursor/skills",codex:".agents/skills","gemini-cli":".gemini/skills",windsurf:".windsurf/skills"},Vu=Object.values(Rt),xn="generatesaas-update",xo=Ts(Os(import.meta.url));function Ds(){let e=ie(xo,"skill","content");return Rs(e)?e:ie(xo,"content")}function On(e){return!e||e.length===0?[]:e.map(t=>Rt[t])}async function Dn(e,t,n,r){let o=On(r);for(let i of o){let a=ie(e,i,xn),s=ie(a,"scripts"),u=ie(a,"references");await Vt(s),await Vt(u),await p(ie(a,"SKILL.md"),t.replaceAll("__SKILL_ROOT__",i)),await p(ie(u,".gitkeep"),"");for(let[g,l]of Object.entries(n)){let h=_s(s,g);h.startsWith(s+xs)&&await p(h,l)}}}async function Oo(e,t){let n=Ds(),r=await _o(ie(n,"SKILL.md"),"utf-8"),o=ie(n,"scripts"),i=await Ps(o),a={};for(let s of i)s!==".gitkeep"&&(a[s]=await _o(ie(o,s),"utf-8"));await Dn(e,r,a,t)}import{execFile as Cs,execFileSync as Ns}from"child_process";import{access as Do,readFile as $s}from"fs/promises";import{join as Cn}from"path";import*as D from"@clack/prompts";function Le(e){try{let t=process.platform==="win32"?"where":"which";return Ns(t,[e],{stdio:"ignore"}),!0}catch{return!1}}function $e(e,t,n,r=3e5){return new Promise((o,i)=>{Cs(e,t,{cwd:n,timeout:r,maxBuffer:50*1024*1024},(a,s,u)=>{if(a){let g=String(s||"").trim(),h=[String(u||"").trim(),g].filter(Boolean).join(`
|
|
1314
1261
|
`);i(new Error(h?`${a.message}
|
|
1315
|
-
${h}`:a.message))}else o()})})}async function
|
|
1316
|
-
`),
|
|
1317
|
-
`),
|
|
1318
|
-
`),Q.yellow("Deployment"))}function ac(e){let t=["DATABASE_URL","BETTER_AUTH_SECRET"];return e.cacheProvider==="upstash"?t.push("UPSTASH_REDIS_REST_URL","UPSTASH_REDIS_REST_TOKEN"):t.push("REDIS_URL"),e.paymentProvider==="stripe"?t.push("STRIPE_SECRET_KEY","STRIPE_WEBHOOK_SECRET"):e.paymentProvider==="polar"&&t.push("POLAR_ACCESS_TOKEN","POLAR_WEBHOOK_SECRET"),e.emailProvider==="ses"?t.push("AMAZON_SES_REGION","AMAZON_SES_KEY","AMAZON_SES_SECRET"):e.emailProvider==="resend"?t.push("RESEND_API_KEY"):t.push("SMTP_HOST","SMTP_PORT"),t}function sc(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 ft(e){let n=(e.startsWith("v")?e.slice(1):e).match(/^(\d+)\.(\d+)\.(\d+)$/);return n?[Number(n[1]),Number(n[2]),Number(n[3])]:null}function He(e,t){let n=ft(e),r=ft(t);if(!n||!r)return 0;for(let o=0;o<3;o++)if(n[o]!==r[o])return n[o]-r[o];return 0}function pn(e,t){return e.versions.find(n=>n.version===t)?.cli}function ui(e){return process.env.GENERATESAAS_TEMPLATE_TARBALL||process.env.GENERATESAAS_TEMPLATE_TARBALL_DIR||process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?!0:ft(e)===null}function ln(e,t,n="2.1.0"){if(ui(n))return{ok:!0};let r=pn(e,e.latest);return!r||ft(r)===null?{ok:!0}:He(n,r)>=0?{ok:!0}:{ok:!1,message:`Your installed generatesaas CLI (v${n}) is too old for template v${e.latest}, which needs CLI v${r} 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 mi(e,t,n="2.1.0"){if(ui(n))return{ok:!0};let r=pn(e,t);return!r||ft(r)===null?{ok:!0}:He(n,r)===0?{ok:!0}:{ok:!1,message:`Template v${t} must be scaffolded by CLI v${r} exactly (the CLI whose generators produced that release). Run npx generatesaas@${r} init.`}}import mc from"picocolors";var fc="a10a6fb9d7cadde32e37dad52059d17b5d2b916b08c76d8fbcc99982e9a3d87f";async function gc(e){let t=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(`generatesaas-demo:${e}`)),n=[...new Uint8Array(t).subarray(0,16)].map(r=>r.toString(16).padStart(2,"0")).join("");return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20,32)}`}function fi(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 W("--frontend <type>","frontend framework").choices([...$e])).addOption(new W("--architecture <type>","fullstack or separate").choices([...We])).addOption(new W("--payment <provider>","payment provider").choices([...Xe])).addOption(new W("--email <provider>","email provider").choices([...Ze])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").addOption(new W("--billing-scope <scope>","billing scope (requires --org)").choices([...tt])).option("--blog","enable blog").option("--no-blog","disable blog").option("--email-tracking","enable email analytics (open/click tracking + admin analytics page)").option("--no-email-tracking","disable email analytics").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--desktop","include the desktop app (apps/electron, built with Electron)").option("--no-desktop","exclude the desktop app").option("--desktop-auto","auto-trigger the desktop release workflow on CI success (default: manual-only)").option("--no-desktop-auto","manual-only desktop releases (workflow_dispatch)").option("--ai","include the AI features (chat, models, schedules, integrations); unlocks the companion + MCP server").option("--no-ai","exclude the AI features").option("--companion","include the companion feature - a daemon your users install to run their own AI subscriptions for this app (shared repo or vendored)").option("--no-companion","exclude the backend companion feature").addOption(new W("--companion-source <source>","companion source: point at an existing shared companion repo, or vendor your own branded daemon").choices([...Le])).option("--companion-repo-url <url>","GitHub URL of the shared companion repo (with --companion-source shared; default: OpenCompanion)").option("--companion-local-path <path>","path to your local checkout of the shared companion (optional, for developing it alongside)").option("--mcp-server","include the outward MCP server (the /mcp route + Better Auth mcp() provider)").option("--no-mcp-server","exclude the outward MCP server").option("--ai-builtin","built-in AI: models under your app's name via OpenRouter, billed from credits (default)").option("--no-ai-builtin","no built-in AI").option("--ai-byok","let end-users connect their own provider API keys (default)").option("--no-ai-byok","no user-supplied API keys").option("--revenue-sharing","enable revenue sharing").option("--no-revenue-sharing","disable revenue sharing").option("--credits","enable credits system").option("--no-credits","disable credits system (subscription-only)").option("--docker <services>","comma-separated: postgres,redis,inngest,mailpit").option("--ai-tools <tools>","comma-separated: claude-code,cursor,codex,gemini-cli,windsurf").option("--social-providers <providers>","comma-separated: google,github,facebook,discord,x").addOption(new W("--currency <code>","default currency for billing").choices([...fe])).addOption(new W("--deploy <target>","deployment target").choices([...ge])).addOption(new W("--database <provider>","database provider").choices([...he])).addOption(new W("--cache <provider>","cache provider").choices([...ye])).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 W("--demo","first-party demo build: keep sample content, mark site non-indexable - requires CI API key").hideHelp()).addOption(new W("--no-db-migration","skip generating the baseline DB migration (internal: demos/CI/playground)").hideHelp()).action(async(t,n)=>{await hc(t?{...n,apiKey:t}:n)})}async function hc(e){let t=performance.now();ur("2.1.0");let n;try{n=Rr(e)}catch(k){A.cancel(T(k)),process.exit(1)}let r=A.spinner(),o;try{o=await ot({apiKey:e.apiKey,prompt:!e.yes})}catch(k){A.cancel(T(k)),process.exit(1)}e.demo&&qn(o)!==fc&&(A.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let i=ke(o),a,s=async()=>{a=await Re(i);let k=ln(a,"init");if(!k.ok)throw new Error(k.message);return{latestVersion:a.latest,selectedVersion:a.latest,desktopAllowed:a.entitlements?.desktopAllowed??!0,companionAllowed:a.entitlements?.companionAllowed??!0}};r.start("Verifying access...");let u,g,l=!0,h=!0;try{({latestVersion:u,selectedVersion:g,desktopAllowed:l,companionAllowed:h}=await s()),r.stop("Access verified."),Me(o)}catch(k){if(r.stop("Access verification failed."),k instanceof F&&k.status===401){e.yes&&(A.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),A.log.warning("Invalid API key."),o=await It(),i=ke(o),r.start("Verifying access...");try{({latestVersion:u,selectedVersion:g,desktopAllowed:l,companionAllowed:h}=await s()),r.stop("Access verified."),Me(o)}catch(x){r.stop("Access verification failed."),A.cancel(x instanceof F&&x.status===401?"Invalid API key.":T(x)),process.exit(1)}}else A.cancel(T(k)),process.exit(1)}A.log.success(`Latest version: ${u}`),n.desktop===!0&&!l&&(A.cancel("The desktop app is available on the Pro plan and up. Upgrade your plan at generatesaas.com."),process.exit(1)),n.companion===!0&&!h&&(A.cancel("The companion is available on the Pro plan and up. Upgrade your plan at generatesaas.com."),process.exit(1));let y;e.yes?y=xr({...n,...l?{}:{desktop:!1},...h?{}:{companion:!1}}):y=await Tr(n,{desktopAllowed:l,companionAllowed:h});let _;r.start("Activating license...");try{let k=e.demo&&y.baseUrl?await gc(y.baseUrl):crypto.randomUUID(),x=()=>({frontend:y.frontend,version:g,installId:k,projectName:y.projectName,options:Nr(y)}),ue;try{ue=await Rn(i,x())}catch(M){let b=Jt(M);if(!b?.lastAllowedVersion||!a)throw M;r.stop("License activation failed.");let L=mi(a,b.lastAllowedVersion);if(L.ok||(A.cancel(`${b.message} ${L.message}`),process.exit(1)),e.yes){let oe=pn(a,b.lastAllowedVersion);A.cancel(`${b.message} Re-run ${oe?`npx generatesaas@${oe} init`:"init"} without --yes to continue with v${b.lastAllowedVersion} (the last version your license covers).`),process.exit(1)}let Ce=await A.confirm({message:`Your update window has ended. Continue with v${b.lastAllowedVersion} (the last version your license covers)?`});(A.isCancel(Ce)||!Ce)&&(A.cancel("Setup cancelled."),process.exit(0)),g=b.lastAllowedVersion,r.start(`Activating license for v${g}...`),ue=await Rn(i,x())}_={token:ue.token,keyHash:qn(o),installId:ue.installId??k},r.stop("License activated.")}catch(k){r.stop("License activation failed."),A.cancel(T(k)),process.exit(1)}let v=uc(y.projectDir);if(cc(v)&&pc(v).length>0)if(e.yes)A.log.info(`Directory ${v} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let x=await A.select({message:`Directory ${v} is not empty.`,options:[{value:"merge",label:"Merge",hint:"keep existing files, overwrite conflicts"},{value:"overwrite",label:"Overwrite",hint:"delete everything and start fresh"},{value:"cancel",label:"Cancel"}]});(A.isCancel(x)||x==="cancel")&&(A.cancel("Setup cancelled."),process.exit(0)),x==="overwrite"&&lc(v,{recursive:!0,force:!0})}let $={...y,projectDir:v,version:g,...e.demo?{docs:!1}:{}};r.start("Downloading template...");try{await qt(i,g,v),r.stop("Template downloaded.")}catch(k){r.stop("Download failed."),A.cancel(T(k)),process.exit(1)}let ne;r.start("Generating project files...");try{if({dockerComposeGenerated:ne}=await sn($),!e.demo){let k=await Be(v);await p(dc(v,Ht),JSON.stringify(k,null," ")+`
|
|
1319
|
-
`),await
|
|
1320
|
-
`),
|
|
1321
|
-
`);let
|
|
1322
|
-
`)}if(g.stop("Baseline template stored."),!
|
|
1323
|
-
`),g.stop("Baseline hashes computed.")}if(await p(
|
|
1324
|
-
`),
|
|
1325
|
-
|
|
1326
|
-
This is a decision only you can make, so an unattended update will not guess it. Run ${
|
|
1262
|
+
${h}`:a.message))}else o()})})}async function Co(e){if(!Le("pnpm"))return D.log.warn("pnpm not found. Skipping lockfile regeneration."),!1;try{return await $e("pnpm",["install","--lockfile-only","--no-frozen-lockfile","--config.minimumReleaseAge=0"],e),!0}catch(t){let n=t instanceof Error?t.message:String(t);return D.log.warn(`Lockfile regeneration failed: ${n}`),D.log.warn("Deploys using --frozen-lockfile may fail."),!1}}async function No(e){if(!Le("pnpm"))return D.log.warn("pnpm not found. Skipping dependency installation."),D.log.info("Install pnpm: https://pnpm.io/installation"),!1;let t=D.spinner();t.start("Installing dependencies (this may take a minute)...");try{return await $e("pnpm",["install","--config.minimumReleaseAge=0"],e),t.stop("Dependencies installed."),!0}catch(n){t.stop("Dependency installation failed.");let r=n instanceof Error?n.message:String(n);return D.log.warn(`pnpm install failed: ${r}`),D.log.warn("You can run it manually later."),!1}}async function $o(e){if(!Le("pnpm"))return!1;let t=D.spinner();t.start("Generating baseline database migration...");try{return await $e("pnpm",["-F","@repo/database","generate"],e),t.stop("Baseline migration generated."),!0}catch(n){t.stop("Baseline migration generation failed.");let r=n instanceof Error?n.message:String(n);return D.log.warn(`Could not generate baseline migration: ${r}`),D.log.warn("Run 'pnpm -F @repo/database generate' before your first deploy."),!1}}async function Lo(e){try{return await Do(Cn(e,".git")),D.log.info("Git repository already exists, skipping init."),!0}catch{}if(!Le("git"))return D.log.warn("git not found. Skipping repository initialization."),!1;let t=D.spinner();t.start("Initializing git repository...");try{return await $e("git",["init"],e),await $e("git",["add","-A"],e),await $e("git",["commit","--no-verify","-m","Initial commit from GenerateSaaS"],e),t.stop("Git repository initialized."),!0}catch{return t.stop("Git initialization failed."),D.log.warn("You can run git init manually later."),!1}}async function jo(e){if(!Le("pnpm"))return!1;try{await Do(Cn(e,".git"))}catch{return!1}try{let t=JSON.parse(await $s(Cn(e,"package.json"),"utf-8")),n=!!t.devDependencies?.["simple-git-hooks"],r=!!t["simple-git-hooks"];if(!n||!r)return!1}catch{return!1}try{return await $e("pnpm",["exec","simple-git-hooks"],e),!0}catch{return D.log.warn("Could not install git hooks. Run 'pnpm exec simple-git-hooks' manually."),!1}}import*as tt from"@clack/prompts";import X from"picocolors";function Uo(e,t){t.dockerComposeGenerated&&!t.dockerAvailable&&tt.log.warn("Docker not found. Install Docker to run local services: https://docs.docker.com/get-docker/");let n=[];if(n.push(`cd ${e.projectDir}`),t.pnpmInstalled||n.push("pnpm install"),t.dockerComposeGenerated){let i=e.dockerServices.map(a=>Be[a].label).join(", ");n.push(`pnpm infra ${X.dim(`# ${i}`)}`)}if(n.push(`pnpm dev ${X.dim("# http://localhost:3000")}`),t.skippedCredentials.length>0&&(n.push(""),n.push(X.dim("Fill in remaining TODO values in .env"))),tt.note(n.join(`
|
|
1263
|
+
`),X.yellow("Start Development")),t.dockerComposeGenerated){let i=[];i.push(`App ${X.cyan("http://localhost:3000")}`),e.architecture==="separate"&&i.push(`API ${X.cyan("http://localhost:3010")}`),e.dockerServices.includes("mailpit")&&i.push(`Mailpit ${X.cyan("http://localhost:8025")}`),e.dockerServices.includes("inngest")&&i.push(`Inngest ${X.cyan("http://localhost:8288")}`),tt.note(i.join(`
|
|
1264
|
+
`),X.yellow("Dev Tools"))}let r=[],o=Ls(e);o.length>0&&r.push(`Set in production: ${X.dim(o.join(", "))}`),r.push("pnpm db:setup # Apply the database schema"),r.push(js(e)),tt.note(r.join(`
|
|
1265
|
+
`),X.yellow("Deployment"))}function Ls(e){let t=["DATABASE_URL","BETTER_AUTH_SECRET"];return e.cacheProvider==="upstash"?t.push("UPSTASH_REDIS_REST_URL","UPSTASH_REDIS_REST_TOKEN"):t.push("REDIS_URL"),e.paymentProvider==="stripe"?t.push("STRIPE_SECRET_KEY","STRIPE_WEBHOOK_SECRET"):e.paymentProvider==="polar"&&t.push("POLAR_ACCESS_TOKEN","POLAR_WEBHOOK_SECRET"),e.emailProvider==="ses"?t.push("AMAZON_SES_REGION","AMAZON_SES_KEY","AMAZON_SES_SECRET"):e.emailProvider==="resend"?t.push("RESEND_API_KEY"):t.push("SMTP_HOST","SMTP_PORT"),t}function js(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 nt(e){let n=(e.startsWith("v")?e.slice(1):e).match(/^(\d+)\.(\d+)\.(\d+)$/);return n?[Number(n[1]),Number(n[2]),Number(n[3])]:null}function je(e,t){let n=nt(e),r=nt(t);if(!n||!r)return 0;for(let o=0;o<3;o++)if(n[o]!==r[o])return n[o]-r[o];return 0}function Xt(e,t){return e.versions.find(n=>n.version===t)?.cli}function Mo(e){return process.env.GENERATESAAS_TEMPLATE_TARBALL||process.env.GENERATESAAS_TEMPLATE_TARBALL_DIR||process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?!0:nt(e)===null}function Zt(e,t,n="2.2.0"){if(Mo(n))return{ok:!0};let r=Xt(e,e.latest);return!r||nt(r)===null?{ok:!0}:je(n,r)>=0?{ok:!0}:{ok:!1,message:`Your installed generatesaas CLI (v${n}) is too old for template v${e.latest}, which needs CLI v${r} 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 Fo(e,t,n="2.2.0"){if(Mo(n))return{ok:!0};let r=Xt(e,t);return!r||nt(r)===null?{ok:!0}:je(n,r)===0?{ok:!0}:{ok:!1,message:`Template v${t} must be scaffolded by CLI v${r} exactly (the CLI whose generators produced that release). Run npx generatesaas@${r} init.`}}import Gs from"picocolors";var Ks="a10a6fb9d7cadde32e37dad52059d17b5d2b916b08c76d8fbcc99982e9a3d87f";async function Hs(e){let t=await crypto.subtle.digest("SHA-256",new TextEncoder().encode(`generatesaas-demo:${e}`)),n=[...new Uint8Array(t).subarray(0,16)].map(r=>r.toString(16).padStart(2,"0")).join("");return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20,32)}`}function Vo(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 Z("--frontend <type>","frontend framework").choices([...Re])).addOption(new Z("--architecture <type>","fullstack or separate").choices([...Ge])).addOption(new Z("--payment <provider>","payment provider").choices([...Ke])).addOption(new Z("--email <provider>","email provider").choices([...He])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").option("--blog","enable blog").option("--no-blog","disable blog").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--desktop","include the desktop app (apps/electron, built with Electron)").option("--no-desktop","exclude the desktop app").option("--ai","include the AI features (chat, models, schedules, integrations); unlocks the companion").option("--no-ai","exclude the AI features").option("--companion","include the companion feature - a daemon your users install to run their own AI subscriptions for this app (shared repo or vendored)").option("--no-companion","exclude the backend companion feature").addOption(new Z("--companion-source <source>","companion source: point at an existing shared companion repo, or vendor your own branded daemon").choices([...Pe])).option("--companion-repo-url <url>","GitHub URL of the shared companion repo (with --companion-source shared; default: OpenCompanion)").option("--revenue-sharing","enable revenue sharing").option("--no-revenue-sharing","disable revenue sharing").option("--credits","enable credits system").option("--no-credits","disable credits system (subscription-only)").option("--docker <services>","comma-separated: postgres,redis,inngest,mailpit").option("--ai-tools <tools>","comma-separated: claude-code,cursor,codex,gemini-cli,windsurf").addOption(new Z("--currency <code>","default currency for billing").choices([...se])).addOption(new Z("--deploy <target>","deployment target").choices([...ce])).addOption(new Z("--database <provider>","database provider").choices([...pe])).addOption(new Z("--cache <provider>","cache provider").choices([...le])).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 Z("--demo","first-party demo build: keep sample content, mark site non-indexable - requires CI API key").hideHelp()).addOption(new Z("--no-db-migration","skip generating the baseline DB migration (internal: demos/CI/playground)").hideHelp()).action(async(t,n)=>{await zs(t?{...n,apiKey:t}:n)})}async function zs(e){let t=performance.now();Gn("2.2.0");let n;try{n=or(e)}catch(y){k.cancel(I(y)),process.exit(1)}let r=k.spinner(),o;try{o=await We({apiKey:e.apiKey,prompt:!e.yes})}catch(y){k.cancel(I(y)),process.exit(1)}e.demo&&Tn(o)!==Ks&&(k.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let i=fe(o),a,s=async()=>{a=await be(i);let y=Zt(a,"init");if(!y.ok)throw new Error(y.message);return{latestVersion:a.latest,selectedVersion:a.latest,desktopAllowed:a.entitlements?.desktopAllowed??!0,companionAllowed:a.entitlements?.companionAllowed??!0}};r.start("Verifying access...");let u,g,l=!0,h=!0;try{({latestVersion:u,selectedVersion:g,desktopAllowed:l,companionAllowed:h}=await s()),r.stop("Access verified."),xe(o)}catch(y){if(r.stop("Access verification failed."),y instanceof $&&y.status===401){e.yes&&(k.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),k.log.warning("Invalid API key."),o=await gt(),i=fe(o),r.start("Verifying access...");try{({latestVersion:u,selectedVersion:g,desktopAllowed:l,companionAllowed:h}=await s()),r.stop("Access verified."),xe(o)}catch(O){r.stop("Access verification failed."),k.cancel(O instanceof $&&O.status===401?"Invalid API key.":I(O)),process.exit(1)}}else k.cancel(I(y)),process.exit(1)}k.log.success(`Latest version: ${u}`),n.desktop===!0&&!l&&(k.cancel("The desktop app is available on the Pro plan and up. Upgrade your plan at generatesaas.com."),process.exit(1)),n.companion===!0&&!h&&(k.cancel("The companion is available on the Pro plan and up. Upgrade your plan at generatesaas.com."),process.exit(1));let S;e.yes?S=ir({...n,...l?{}:{desktop:!1},...h?{}:{companion:!1}}):S=await ar(n,{desktopAllowed:l,companionAllowed:h});let C;r.start("Activating license...");try{let y=e.demo&&S.baseUrl?await Hs(S.baseUrl):crypto.randomUUID(),O=()=>({frontend:S.frontend,version:g,installId:y,projectName:S.projectName,options:dr(S)}),j;try{j=await ln(i,O())}catch(Y){let w=Ut(Y);if(!w?.lastAllowedVersion||!a)throw Y;r.stop("License activation failed.");let M=Fo(a,w.lastAllowedVersion);if(M.ok||(k.cancel(`${w.message} ${M.message}`),process.exit(1)),e.yes){let ot=Xt(a,w.lastAllowedVersion);k.cancel(`${w.message} Re-run ${ot?`npx generatesaas@${ot} init`:"init"} without --yes to continue with v${w.lastAllowedVersion} (the last version your license covers).`),process.exit(1)}let Ae=await k.confirm({message:`Your update window has ended. Continue with v${w.lastAllowedVersion} (the last version your license covers)?`});(k.isCancel(Ae)||!Ae)&&(k.cancel("Setup cancelled."),process.exit(0)),g=w.lastAllowedVersion,r.start(`Activating license for v${g}...`),j=await ln(i,O())}C={token:j.token,keyHash:Tn(o),installId:j.installId??y},r.stop("License activated.")}catch(y){r.stop("License activation failed."),k.cancel(I(y)),process.exit(1)}let E=Bs(S.projectDir);if(Us(E)&&Ms(E).length>0)if(e.yes)k.log.info(`Directory ${E} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let O=await k.select({message:`Directory ${E} 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"}]});(k.isCancel(O)||O==="cancel")&&(k.cancel("Setup cancelled."),process.exit(0)),O==="overwrite"&&Fs(E,{recursive:!0,force:!0})}let N={...S,projectDir:E,version:g,...e.demo?{docs:!1}:{}};r.start("Downloading template...");try{await Mt(i,g,E),r.stop("Template downloaded.")}catch(y){r.stop("Download failed."),k.cancel(I(y)),process.exit(1)}let te;r.start("Generating project files...");try{if({dockerComposeGenerated:te}=await qt(N),!e.demo){let y=await Ne(E);await p(Vs(E,Lt),JSON.stringify(y,null," ")+`
|
|
1266
|
+
`),await To(E,E)}await Oo(E,N.aiTools),await Ro(N,C),r.stop("Project files generated.")}catch(y){r.stop("Generation failed."),k.cancel(I(y)),process.exit(1)}!await Co(E)&&N.demo===!0&&(k.cancel("Lockfile regeneration failed on a demo build - refusing to ship a stale lockfile."),process.exit(1));let ae=await No(E);ae&&N.demo!==!0&&e.dbMigration!==!1&&await $o(E),await Lo(E),ae&&await jo(E);let Ee=Le("docker"),he=cn(N).map(y=>y.key).filter(y=>!N.credentials?.[y]);Uo(N,{pnpmInstalled:ae,dockerComposeGenerated:te,dockerAvailable:Ee,skippedCredentials:he}),Kn(),k.log.info(Gs.dim(`Done in ${((performance.now()-t)/1e3).toFixed(1)}s`))}import{existsSync as Ln}from"fs";import{readFile as jn}from"fs/promises";import{join as rt,resolve as tc}from"path";import*as v from"@clack/prompts";import L from"picocolors";import{mkdtemp as Js,rm as Ys}from"fs/promises";import{tmpdir as qs}from"os";import{join as Ws}from"path";async function Nn(e,t,n,r){let o=await Js(Ws(qs(),"generatesaas-stage-"));try{await Mt(e,t,o),await qt({...n,projectDir:o}),await _n(o,r)}finally{await Ys(o,{recursive:!0,force:!0})}}function Bo(e){return e?"ON":"OFF"}var Pt="packages/config/src/index.ts",Xs=[{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, but it is now a plain config value generated as `user`. Applying this update as-is bills the individual member instead of the organization: new checkouts create member-scoped subscriptions and org-level entitlements stop resolving. Put it back with `billingScope: "organization"` in `packages/config/src/tenancy-flags.mjs`. 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 ${Pt} 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 ${Pt} 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 ${Pt}. How should this update proceed?`},{key:"aiBuiltin",severity:"warn",normalize:e=>{e.aiBuiltin===void 0&&(e.aiBuiltin=e.aiByok===!1)},applies:e=>e.ai===!0,preserved:e=>e.aiBuiltin===ut(e),describe:e=>`Retired option \`aiBuiltin\`: your project recorded built-in AI models ${Bo(e.aiBuiltin)}, but it is now a plain config value generated ${Bo(ut(e))} for a project ${ut(e)?"with":"without"} a payment provider. Set \`config.ai.builtin\` to \`${String(e.aiBuiltin===!0)}\` in ${Pt} 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 ${Pt} to keep it off.`},{key:"companionLocalPath",severity:"warn",preserved:e=>(e.companionLocalPath??"").trim()==="",describe:e=>`Retired option \`companionLocalPath\`: your project recorded a local companion checkout at ${e.companionLocalPath}. The option is gone; point the \`GENERATESAAS_COMPANION_BRAND_JSON\` env var at that checkout's \`brand.json\` instead.`}];function Go(e){let t=[];for(let n of Xs){if(n.normalize?.(e),e[n.key]===void 0)continue;(!n.applies||n.applies(e))&&!n.preserved(e)&&t.push({key:n.key,message:n.describe(e),severity:n.severity}),delete e[n.key]}return t}import{readFile as Zs,rm as Qs}from"fs/promises";import{join as $n}from"path";var Ko=$n(V,"companion-release.json"),ec=["apps/companion/","packages/companion-protocol/","packages/agent-core-types/","packages/agent-core/","scripts/companion-export/"];async function Ho(e){let t;try{t=await Zs($n(e,Ko),"utf-8")}catch(r){if(typeof r=="object"&&r!==null&&"code"in r&&r.code==="ENOENT")return null;throw r}let n=JSON.parse(t);return typeof n=="object"&&n!==null&&"version"in n&&typeof n.version=="string"&&n.version.length>0?{version:n.version}:null}async function zo(e){try{return await Qs($n(e,Ko)),!0}catch(t){if(typeof t=="object"&&t!==null&&"code"in t&&t.code==="ENOENT")return!1;throw t}}function Jo(e){return e.some(t=>ec.some(n=>t.startsWith(n)))}function qo(e){e.command("update").description("Update AI skill files and stage template updates").argument("[mode]","pass 'auto' to mark the staged update for unattended apply by your AI assistant").option("--cwd <path>","project directory (default: current directory)").action(async(t,n)=>{let r=t==="auto"?"auto":void 0,o=tc(n.cwd??process.cwd()),i=rt(o,we),a;try{a=JSON.parse(await jn(i,"utf-8"))}catch{v.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let s;try{s=await We()}catch(l){v.cancel(I(l)),process.exit(1)}let u=fe(s),g=v.spinner();try{g.start("Verifying access...");let l;try{l=await be(u)}catch(w){throw w instanceof $&&w.status===401?new Error("Your saved API key was rejected. Run `generatesaas auth` to update it, or set GENERATESAAS_API_KEY."):w}let h=Zt(l,"update");if(!h.ok)throw new Error(h.message);g.stop("Access verified."),xe(s),g.start("Fetching latest skill files...");let S=await lr(u,l.latest);await Dn(o,S.skillMd,S.scripts,a.aiTools);let C=On(a.aiTools);if(g.stop("Skills updated."),v.log.success(`Skill files installed to ${L.cyan(C.length.toString())} locations.`),a.version===l.latest){v.log.info(`Already on the latest version (${a.version}).`);return}let E=JSON.stringify(a);nr(a),await nc(a,rr(a),r),await oc(Go(a),r);let N=Yn(a),te=qn(a),Fe=JSON.stringify(te)!==E;if(a=te,a.licenseToken)try{let w=await ur(u,{currentToken:a.licenseToken,newVersion:l.latest});a.licenseToken=w.token,w.licenseKeyHash&&(a.licenseKeyHash=w.licenseKeyHash),await p(i,JSON.stringify(a,null," ")+`
|
|
1267
|
+
`),Fe=!1,v.log.success("License refreshed.")}catch(w){let M=Ut(w);M&&(v.cancel(M.message),process.exit(1)),v.log.warn("License refresh skipped.")}Fe&&await p(i,JSON.stringify(a,null," ")+`
|
|
1268
|
+
`);let ae=Io(a,o),Ee=rt(o,cr);g.start(`Staging v${l.latest} (shaped for your config)...`),await Nn(u,l.latest,ae,Ee),g.stop("Template staged.");let{text:Ve,title:he}=await ac(u,l,a.version);Ve&&v.note(Ve,he);let y=rt(o,Lt),O=rt(o,jt),j=!Ln(O),Y=!Ln(y);if(j){if(g.start("Building baseline template (one-time migration)..."),await Nn(u,a.version,ae,O),Y){let w=await Ne(O);await p(y,JSON.stringify(w,null," ")+`
|
|
1269
|
+
`)}if(g.stop("Baseline template stored."),!Y){let w=await cc(y,O);w>0&&v.log.warn(`Rebuilt baseline differs from the original for ${w} 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(Y){g.start("Computing baseline template hashes...");let w=await Ne(O);await p(y,JSON.stringify(w,null," ")+`
|
|
1270
|
+
`),g.stop("Baseline hashes computed.")}if(await p(rt(o,pr),JSON.stringify({currentVersion:a.version,targetVersion:l.latest,changelog:Ve,stagedAt:new Date().toISOString(),...N.length>0?{newOptions:N}:{},...r?{mode:r}:{}},null," ")+`
|
|
1271
|
+
`),v.log.info(`Update staged: ${L.cyan(a.version)} \u2192 ${L.cyan(l.latest)}`),a.aiTools&&a.aiTools.length>0){let w=a.aiTools[0],M=pt[w].label;v.log.info(`Open your project in ${L.cyan(M)} and ask: ${L.cyan("'update my GenerateSaaS project'")}`)}else v.log.info(`Ask your AI coding assistant to ${L.cyan("'update my GenerateSaaS project'")}.`);if(a.companion===!0)try{if(de(a)==="vendored"){let w=await Ho(o);if(w){let M=await sc(y,Ee);Jo(M)&&v.log.warn(`Companion: vendored daemon changed since your published v${w.version} - run pnpm companion:publish (your users auto-update once tagged)`)}}else await zo(o)&&v.log.info("Companion: removed the stale vendored publish state (.generatesaas/companion-release.json) - this project points at a shared companion.")}catch(w){v.log.warn(`Companion re-release check skipped: ${I(w)}`)}a.desktop===!0&&Ln(rt(o,"apps/tauri"))&&v.log.warn(`Desktop: the app moved to an Electron shell (${L.cyan("apps/electron")}). Your project still has the old Tauri shell (${L.cyan("apps/tauri")}) - remove it after verifying the Electron app builds and runs. See ${L.cyan("/desktop/updates")}.`)}catch(l){g.stop("Failed."),v.cancel(`Update failed: ${I(l)}`),process.exit(1)}})}async function nc(e,t,n){if(t.kind==="none")return;if(t.kind==="daemon-materialized"){v.log.info(`Desktop: your app now bundles its own companion daemon. This update adds its source to your repo (${L.cyan("apps/companion")}, branded ${L.cyan(e.companionName??"")}) and about 106MB to each packaged build. Nothing to publish - it ships inside the app.`);return}let r=ic[t.kind];n==="auto"&&(v.cancel(`${r.message}
|
|
1272
|
+
|
|
1273
|
+
This is a decision only you can make, so an unattended update will not guess it. Run ${L.cyan("generatesaas update")} without ${L.cyan("auto")} and answer it.`),process.exit(1));let o=await v.select({message:r.message,options:r.options});v.isCancel(o)&&(v.cancel("Update cancelled. Nothing was changed or staged."),process.exit(1)),o.apply(e),sn(e)}var rc={billingScope:[{value:"stage",label:"Stage it - I will put the scope back myself",hint:'set `billingScope: "organization"` in packages/config/src/tenancy-flags.mjs before taking new checkouts'},{value:"stop",label:"Stop, and stage nothing",hint:"edit packages/config/src/tenancy-flags.mjs first, then re-run update - a file you have edited is walked as a 3-way merge instead of being replaced"}],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 oc(e,t){let n=[];for(let r of e){let o=r.severity==="ask"?rc[r.key]:void 0;if(!o){v.log.warn(r.message);continue}n.push({notice:r,answers:o})}for(let{notice:r,answers:o}of n){t==="auto"&&(v.cancel(`${r.message}
|
|
1274
|
+
|
|
1275
|
+
This is a decision only you can make, so an unattended update will not guess it. Run ${L.cyan("generatesaas update")} without ${L.cyan("auto")} and answer it.`),process.exit(1));let i=await v.select({message:r.message,options:o});(v.isCancel(i)||i==="stop")&&(v.cancel("Update cancelled. Nothing was changed or staged."),process.exit(1))}}function Yo(e){e.desktop=!1}var ic={"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?",options:[{value:{apply:e=>{e.ai=!0}},label:"Turn AI on, keep the desktop AI stack",hint:"also adds the companion daemon's source to your repo (apps/companion, ~106MB per packaged build) and makes your website's AI surface available - keep it hidden with config.ai.enabled: false"},{value:{apply:e=>{e.ai=!1}},label:"Turn desktop AI off",hint:"your desktop app becomes a client shell: no AI, no Terminal, no bundled daemon"}]},"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 and bundles a companion daemon. Keep it?",options:[{value:{apply:()=>{}},label:"Keep AI - the desktop app gains the AI stack",hint:"adds the local AI stack, the Terminal, and the bundled companion daemon (apps/companion, ~106MB per packaged build)"},{value:{apply:e=>{e.ai=!1,e.companion=!1}},label:"Drop AI",hint:"your website's AI surface hides, and this also drops the web companion - it requires AI"},{value:{apply:Yo},label:"Drop the desktop app",hint:"your website keeps its AI surface exactly as it is today"}]},"shared-source-contradiction":{message:"Your desktop app bundles a companion daemon, but your project points its web install flow at a shared companion. A bundled app needs its own daemon. How should this resolve?",options:[{value:{apply:e=>{e.companionSource="vendored"}},label:"Vendor your own companion",hint:"its source moves into your repo (apps/companion) and your web install UI switches to it - your users install yours, not the shared one"},{value:{apply:Yo},label:"Drop the desktop app",hint:"your website keeps its AI surface and its shared companion exactly as they are today"}]}};async function ac(e,t,n){let r=t.latest,o=t.versions.filter(a=>je(a.version,n)>0&&je(a.version,r)<=0).sort((a,s)=>je(a.version,s.version));if(o.length<=1)return{text:await pn(e,r),title:`Changelog v${r}`};let i=[];for(let a of o){let s=null;try{s=await pn(e,a.version)}catch{s=null}let u=a.date?` (${a.date.slice(0,10)})`:"",g=a.breaking?" [BREAKING]":"";i.push(`# v${a.version}${u}${g}
|
|
1327
1276
|
|
|
1328
1277
|
${s??"_No changelog available for this release._"}`)}return{text:i.join(`
|
|
1329
1278
|
|
|
1330
|
-
`),title:`Changelog v${n} \u2192 v${r}`}}async function
|
|
1331
|
-
`);
|
|
1332
|
-
`),
|
|
1333
|
-
`).map(a=>a.trim()).filter(a=>a&&!a.startsWith("#"));o.length===0&&(
|
|
1279
|
+
`),title:`Changelog v${n} \u2192 v${r}`}}async function sc(e,t){let n=JSON.parse(await jn(e,"utf-8")),r=await Ne(t),o=[];for(let[i,a]of Object.entries(r))n[i]!==a&&o.push(i);for(let i of Object.keys(n))i in r||o.push(i);return o}async function cc(e,t){let n=JSON.parse(await jn(e,"utf-8")),r=await Ne(t),o=0;for(let[i,a]of Object.entries(n))Xe(i)||r[i]!==a&&o++;for(let i of Object.keys(r))i in n||o++;return o}import*as J from"@clack/prompts";import Q from"picocolors";import{readFile as pc}from"fs/promises";import{join as lc,resolve as dc}from"path";function Wo(e){e.command("status").description("Show project status and check for updates").option("--cwd <path>","project directory (default: current directory)").action(async t=>{let n=dc(t.cwd??process.cwd()),r=lc(n,we),o;try{o=JSON.parse(await pc(r,"utf-8"))}catch{J.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let i=[`Version: ${Q.cyan(o.version)}`,`Frontend: ${Q.cyan(o.frontend)}`,o.deploymentTarget?`Deploy target: ${Q.cyan(o.deploymentTarget)}`:null,o.databaseProvider?`Database: ${Q.cyan(o.databaseProvider)}`:null,o.cacheProvider?`Cache: ${Q.cyan(o.cacheProvider)}`:null,o.aiTools&&o.aiTools.length>0?`AI tools: ${Q.cyan(o.aiTools.join(", "))}`:null].filter(Boolean).join(`
|
|
1280
|
+
`);J.note(i,Q.bold("Project Status"));let a=J.spinner();a.start("Checking for updates...");try{let s=await We(),u=fe(s),l=(await be(u)).latest;o.version===l?(a.stop("Up to date."),J.log.success(`Already on the latest version (${Q.green(l)})`)):(a.stop("Update available."),J.log.warning(`Update available: ${Q.yellow(o.version)} \u2192 ${Q.green(l)}`),J.log.info(`Open this project in your AI coding agent and ask it to ${Q.cyan("update my GenerateSaaS project")} - it fetches and applies the update for you.`))}catch(s){a.stop("Check failed."),s instanceof $&&s.status===401?J.log.warning("Invalid API key. Run `generatesaas auth` to update it, or set GENERATESAAS_API_KEY."):J.log.warning(`Could not check for updates: ${I(s)}`)}})}import{readFile as uc}from"fs/promises";import*as x from"@clack/prompts";import _ from"picocolors";function mc(){return process.env.GENERATESAAS_API_KEY??ft()}function fc(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 gc(e){return{verdict:e.verdict??"unknown",ejectedAt:e.ejectedAt??null}}function hc(e){switch(e.verdict){case"licensed":return x.log.success(`${_.green("LICENSED")} - resolves to an account with an active${e.plan?` ${e.plan}`:""} license.`),!0;case"ejected":return x.log.success(`${_.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 x.log.error(`${_.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 x.log.error(`${_.red("LEAKED TOKEN")} - this license belongs to a different deployment${e.mismatchDomain?` (${_.cyan(e.mismatchDomain)})`:""}, not this site. The token was copied from a licensed project.`),!1;case"no_license_history":return x.log.error(`${_.red("NO LICENSE HISTORY")} - no license has ever been associated with this site. If it runs GenerateSaaS, treat it as unlicensed.`),!1;default:return x.log.warn(`${_.yellow("UNKNOWN")} - could not cross-reference the records right now. Try again shortly.`),!1}}async function Xo(e,t){let n=process.env.GENERATESAAS_API_URL??mt,r=mc();e.start("Cross-referencing license records...");try{let o=r?fc(await mr(n,r,{lkh:t.lkh,nid:t.nid,domain:t.domain})):gc(await dn(n,{token:t.token,domain:t.domain}));return e.stop(`${_.green("Checked")} - records cross-referenced`),hc(o)}catch(o){return e.stop(`${_.yellow("Skipped")} - ${I(o)}`),null}}function yc(e){let t=e.split(".");if(t.length!==3||!t[1])throw new Error("Invalid JWT format");let n=Buffer.from(t[1],"base64url").toString("utf-8");return JSON.parse(n)}function Un(e){return typeof e!="number"?"unknown":new Date(e*1e3).toISOString().split("T")[0]}function Zo(e){x.note([`License ID: ${_.cyan(String(e.lid??"unknown"))}`,`Version: ${_.cyan(String(e.ver??"unknown"))}`,`Init version: ${String(e.iver??"unknown")}`,`Frontend: ${String(e.fe??"unknown")}`,`Created: ${Un(e.pat)}`,`Last updated: ${Un(e.uat)}`,`Expires: ${Un(e.exp)}`,`Install ID: ${String(e.nid??"unknown")}`].join(`
|
|
1281
|
+
`),_.yellow("License Details"))}function wc(e){let n=(/^https?:\/\//i.test(e)?e:`https://${e}`).replace(/\/+$/,"");if(n.endsWith("/api"))return[`${n}/license`];try{if(new URL(n).pathname!=="/")return[`${n}/license`]}catch{return[`${n}/license`]}return[`${n}/api/license`,`${n}/license`]}async function Qo(e){let t=x.spinner(),n=null,r="no candidates";for(let a of wc(e)){t.start(`Checking ${a}...`);try{let s=await fetch(a);if(!s.ok){r=`${a} returned ${s.status}`,t.stop(`${_.yellow("Not here")} - ${r}`);continue}let u=(await s.text()).trim();if(!u||u.split(".").length!==3){r=`${a} did not return a JWT`,t.stop(`${_.yellow("Not here")} - ${r}`);continue}n=u,t.stop(`${_.green("Found")} - license endpoint responded`);break}catch(s){r=`${a}: ${I(s)}`,t.stop(`${_.yellow("Unreachable")} - ${r}`)}}if(n===null){x.log.warn(`No license endpoint found (last: ${r}). The site may be ejected, not a GenerateSaaS app, or serving its API elsewhere.`);let a=ei(e);return a?await Xo(t,{domain:a})??!1:!1}let o;try{o=yc(n)}catch{return x.log.error("Could not decode JWT payload."),!1}t.start("Verifying signature...");try{let a=process.env.GENERATESAAS_API_URL??mt,s=await dn(a,{token:n});if(s.valid)t.stop(`${_.green("Valid")} - signature verified`);else return t.stop(`${_.red("Invalid")} - ${s.reason}`),!1}catch{return t.stop(`${_.yellow("Skipped")} - could not reach verification service`),x.log.warn("Signature not verified. Displaying unverified claims:"),Zo(o),!1}return Zo(o),await Xo(t,{token:n,lkh:typeof o.lkh=="string"?o.lkh:void 0,nid:typeof o.nid=="string"?o.nid:void 0,domain:ei(e)})??!0}function ei(e){try{return new URL(/^https?:\/\//i.test(e)?e:`https://${e}`).hostname}catch{return}}function ti(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,n)=>{if(!t&&!n.file&&(x.cancel("Provide a URL or --file <path>."),process.exit(1)),n.file){let o=(await uc(n.file,"utf-8")).split(`
|
|
1282
|
+
`).map(a=>a.trim()).filter(a=>a&&!a.startsWith("#"));o.length===0&&(x.cancel("No URLs found in file."),process.exit(1));let i=0;for(let a of o)await Qo(a)&&i++,x.log.info("");x.log.success(`${i}/${o.length} sites verified.`)}else await Qo(t)||process.exit(1)})}import{existsSync as vc,rmSync as kc}from"fs";import*as ee from"@clack/prompts";function ni(e){e.command("auth").description("Set or update your GenerateSaaS API key").option("--clear","remove saved API key").action(async t=>{if(t.clear){vc(me)?(kc(me),ee.log.success("API key removed.")):ee.log.info("No API key configured.");return}let n=ft();n?ee.log.info(`Current API key: ****${n.slice(-4)}`):ee.log.info("No API key configured.");let r=await gt(),o=fe(r),i=ee.spinner();i.start("Verifying API key...");try{await be(o),i.stop("API key verified."),xe(r),ee.log.success("API key saved.")}catch(a){i.stop("Verification failed."),a instanceof $&&a.status===401?ee.cancel("Invalid API key."):ee.cancel(I(a)),process.exit(1)}})}import{existsSync as Qt,rmSync as bc,readFileSync as Fn,writeFileSync as ri}from"fs";import{join as Ue}from"path";import*as U from"@clack/prompts";var Sc=["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"],Ec=[{file:"packages/api/src/routes/inngest.ts",removals:[`import { licenseHeartbeatFunction } from "../functions/maintenance/license-heartbeat";
|
|
1334
1283
|
`,` licenseHeartbeatFunction,
|
|
1335
1284
|
`]},{file:"packages/api/src/routes/internal/index.ts",removals:[`import licenseRoutes from "./license";
|
|
1336
1285
|
`,` .route("/license", licenseRoutes)
|
|
1337
|
-
`]}];function
|
|
1286
|
+
`]}];function Ac(e){return(e&&e.length>0?e.map(n=>Rt[n]):Object.values(Rt)).map(n=>Ue(n,xn))}function Mn(e){return Qt(e)?(bc(e,{recursive:!0}),!0):!1}function Ic(e,t){if(!Qt(e))return!1;let n=Fn(e,"utf-8"),r=n;for(let o of t)r=r.replace(o,"");return r===n?!1:(ri(e,r,"utf-8"),!0)}function Rc(e){let t=Ue(e,".gitignore");if(!Qt(t))return!1;let n=Fn(t,"utf-8"),r=n.split(`
|
|
1338
1287
|
`).filter(o=>!o.includes(".generatesaas")).join(`
|
|
1339
|
-
`);return r===n?!1:(
|
|
1288
|
+
`);return r===n?!1:(ri(t,r,"utf-8"),!0)}function oi(e){e.command("eject").description("Remove all GenerateSaaS ties - manifest, license, heartbeat, skills").action(async()=>{let t=process.cwd(),n=Ue(t,we),r;try{r=JSON.parse(Fn(n,"utf-8"))}catch{U.cancel("No GenerateSaaS project found in this directory."),process.exit(1)}let o=await U.text({message:'Type "eject" to confirm (this cannot be undone):',validate:s=>{if(s!=="eject")return'Type "eject" to confirm, or press Ctrl+C to cancel.'}});if(U.isCancel(o)&&(U.cancel("Eject cancelled."),process.exit(0)),r.licenseToken)try{await fetch("https://generatesaas.com/api/v1/heartbeat",{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${r.licenseToken}`},body:JSON.stringify({event:"eject",version:r.version,frontend:r.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 i=[],a=[];for(let s of Ac(r.aiTools))Mn(Ue(t,s))&&i.push(s);for(let s of Sc)Mn(Ue(t,s))&&i.push(s);Mn(Ue(t,V))&&i.push(V+"/");for(let s of Ec){let u=Ue(t,s.file);Ic(u,s.removals)?a.push(s.file):Qt(u)&&U.log.warn(`Could not auto-modify ${s.file} - manually remove license/heartbeat references.`)}Rc(t)&&a.push(".gitignore");for(let s of i)U.log.info(`Deleted ${s}`);for(let s of a)U.log.info(`Modified ${s}`);U.log.success("Ejected successfully. This project is now fully standalone.")})}var Me=new Pc().name("generatesaas").description("CLI for scaffolding and managing GenerateSaaS projects").version("2.2.0").addHelpText("after",`
|
|
1340
1289
|
Examples:
|
|
1341
1290
|
$ generatesaas init Interactive setup
|
|
1342
1291
|
$ generatesaas init -n my-app -y Quick setup with defaults
|
|
1343
1292
|
$ generatesaas status Check for updates
|
|
1344
1293
|
$ generatesaas auth Set or update API key
|
|
1345
|
-
`);
|
|
1294
|
+
`);Vo(Me);qo(Me);Wo(Me);ti(Me);ni(Me);oi(Me);Me.parseAsync().catch(e=>{ii.cancel("An unexpected error occurred."),console.error(e),process.exit(1)});
|