generatesaas 1.0.1 → 1.1.1
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
CHANGED
|
@@ -1,312 +1,14 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{Command as
|
|
3
|
-
`);m.note(c,"Unavailable on edge runtime")}m.log.info(
|
|
4
|
-
`),p=[` Deploy target: ${
|
|
5
|
-
`),
|
|
6
|
-
`),
|
|
7
|
-
`);
|
|
8
|
-
`),"Summary");let O=await m.confirm({message:"Proceed with these settings?"});(m.isCancel(O)||!O)&&(m.cancel("Setup cancelled."),process.exit(0))}return{projectName:r,appName:
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
import { RedisStore, type RedisReply } from "rate-limit-redis";
|
|
13
|
-
import { env } from "./env";
|
|
14
|
-
|
|
15
|
-
/** Options for \`redis.cacheSet\`. */
|
|
16
|
-
export interface CacheSetOptions {
|
|
17
|
-
/** TTL in seconds (SET EX). Mutually exclusive with \`ttlMilliseconds\`. */
|
|
18
|
-
ttlSeconds?: number;
|
|
19
|
-
/** TTL in milliseconds (SET PX). Mutually exclusive with \`ttlSeconds\`. */
|
|
20
|
-
ttlMilliseconds?: number;
|
|
21
|
-
/** Only set if the key does not already exist (SET NX). */
|
|
22
|
-
ifNotExists?: boolean;
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* Three small helpers extended onto the native \`redis\` client for the SDK
|
|
27
|
-
* methods whose signatures differ between ioredis and Upstash. Use these in
|
|
28
|
-
* your own code when you want a uniform API; everything else on \`redis\` is
|
|
29
|
-
* the native ioredis surface (or Upstash, on that backend) \u2014 use those
|
|
30
|
-
* directly with their native syntax.
|
|
31
|
-
*/
|
|
32
|
-
export interface BoilerplateRedisHelpers {
|
|
33
|
-
/** SET with optional TTL and NX in one call. Returns \`true\` if stored, \`false\` only when \`ifNotExists\` was set and the key already existed. */
|
|
34
|
-
cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean>;
|
|
35
|
-
/** GET typed as \`string | null\`. (On Upstash this also disables auto-deserialization for consistent string round-trip.) */
|
|
36
|
-
cacheGet(key: string): Promise<string | null>;
|
|
37
|
-
/** Iterate keys matching a glob pattern via SCAN. Yields each key as it's discovered. */
|
|
38
|
-
cacheScan(opts: { match: string; count?: number }): AsyncIterable<string>;
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
const ioredis = new Redis(env.REDIS_URL);
|
|
42
|
-
|
|
43
|
-
/**
|
|
44
|
-
* Native ioredis client + the three boilerplate helpers. Every native
|
|
45
|
-
* ioredis method (\`zadd\`, \`hset\`, \`pubsub\`, \`eval\`, etc.) is available
|
|
46
|
-
* directly on this object \u2014 see ioredis's docs for usage. The three
|
|
47
|
-
* \`cache*\` helpers cover the SDK calls whose signatures differ between
|
|
48
|
-
* ioredis and Upstash.
|
|
49
|
-
*/
|
|
50
|
-
export const redis: Redis & BoilerplateRedisHelpers = Object.assign(ioredis, {
|
|
51
|
-
async cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean> {
|
|
52
|
-
const args: (string | number)[] = [key, value];
|
|
53
|
-
if (opts?.ttlSeconds !== undefined) args.push("EX", opts.ttlSeconds);
|
|
54
|
-
if (opts?.ttlMilliseconds !== undefined) args.push("PX", opts.ttlMilliseconds);
|
|
55
|
-
if (opts?.ifNotExists) args.push("NX");
|
|
56
|
-
const result = await ioredis.call("SET", ...args);
|
|
57
|
-
return result === "OK";
|
|
58
|
-
},
|
|
59
|
-
async cacheGet(key: string): Promise<string | null> {
|
|
60
|
-
return ioredis.get(key);
|
|
61
|
-
},
|
|
62
|
-
async *cacheScan(opts: { match: string; count?: number }): AsyncIterable<string> {
|
|
63
|
-
let cursor = "0";
|
|
64
|
-
do {
|
|
65
|
-
const [next, keys] =
|
|
66
|
-
opts.count !== undefined
|
|
67
|
-
? await ioredis.scan(cursor, "MATCH", opts.match, "COUNT", opts.count)
|
|
68
|
-
: await ioredis.scan(cursor, "MATCH", opts.match);
|
|
69
|
-
for (const k of keys) yield k;
|
|
70
|
-
cursor = next;
|
|
71
|
-
} while (cursor !== "0");
|
|
72
|
-
}
|
|
73
|
-
});
|
|
74
|
-
|
|
75
|
-
/**
|
|
76
|
-
* Build a \`hono-rate-limiter\`-compatible store backed by \`rate-limit-redis\`.
|
|
77
|
-
* Wraps RedisStore in an adapter exposing only the methods the middleware uses
|
|
78
|
-
* so we don't need an unsafe cross-package type cast.
|
|
79
|
-
*/
|
|
80
|
-
function createLimiterStore(): Store {
|
|
81
|
-
const inner = new RedisStore({
|
|
82
|
-
sendCommand: (command: string, ...args: string[]) =>
|
|
83
|
-
ioredis.call(command, ...args) as Promise<RedisReply>
|
|
84
|
-
});
|
|
85
|
-
return {
|
|
86
|
-
init(options) {
|
|
87
|
-
// rate-limit-redis's init reads only windowMs from its options shape,
|
|
88
|
-
// so the express-rate-limit / hono-rate-limiter shape difference is irrelevant at runtime.
|
|
89
|
-
inner.init({ windowMs: options.windowMs } as Parameters<typeof inner.init>[0]);
|
|
90
|
-
},
|
|
91
|
-
increment: (key) => inner.increment(key),
|
|
92
|
-
decrement: (key) => inner.decrement(key),
|
|
93
|
-
resetKey: (key) => inner.resetKey(key)
|
|
94
|
-
};
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
export const limiterStore: Store = createLimiterStore();
|
|
98
|
-
|
|
99
|
-
let closed = false;
|
|
100
|
-
|
|
101
|
-
/** Gracefully close the Redis connection; idempotent. Falls back to disconnect() on error. */
|
|
102
|
-
export async function closeRedis() {
|
|
103
|
-
if (closed) return;
|
|
104
|
-
try {
|
|
105
|
-
await ioredis.quit();
|
|
106
|
-
} catch (error) {
|
|
107
|
-
ioredis.disconnect();
|
|
108
|
-
throw error;
|
|
109
|
-
} finally {
|
|
110
|
-
closed = true;
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
`)}async function Fn(e){await l(`${e.projectDir}/packages/runtime/src/mutex.ts`,`import { Mutex } from "redis-semaphore";
|
|
114
|
-
import { redis } from "./redis";
|
|
115
|
-
|
|
116
|
-
export class MutexTimeoutError extends Error {
|
|
117
|
-
constructor(key: string) {
|
|
118
|
-
super(\`Failed to acquire mutex for key: \${key}\`);
|
|
119
|
-
this.name = "MutexTimeoutError";
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
/**
|
|
124
|
-
* Execute \`fn\` while holding a distributed mutex on \`key\`. Backed by
|
|
125
|
-
* \`redis-semaphore\`, which uses Lua scripts for atomic compare-and-delete
|
|
126
|
-
* on release and supports lock refresh for long-running operations.
|
|
127
|
-
*/
|
|
128
|
-
export async function withMutex<T>(
|
|
129
|
-
key: string,
|
|
130
|
-
fn: () => Promise<T>,
|
|
131
|
-
options?: { lockTimeout?: number; acquireTimeout?: number }
|
|
132
|
-
): Promise<T> {
|
|
133
|
-
const mutex = new Mutex(redis, key, {
|
|
134
|
-
lockTimeout: options?.lockTimeout ?? 10_000,
|
|
135
|
-
acquireAttemptsLimit: 10,
|
|
136
|
-
retryInterval: 500
|
|
137
|
-
});
|
|
138
|
-
|
|
139
|
-
const acquired = await mutex.tryAcquire();
|
|
140
|
-
if (!acquired) {
|
|
141
|
-
throw new MutexTimeoutError(key);
|
|
142
|
-
}
|
|
143
|
-
|
|
144
|
-
try {
|
|
145
|
-
return await fn();
|
|
146
|
-
} finally {
|
|
147
|
-
await mutex.release();
|
|
148
|
-
}
|
|
149
|
-
}
|
|
150
|
-
`)}async function Bn(e){await l(`${e.projectDir}/packages/runtime/src/redis.ts`,`import { Redis } from "@upstash/redis";
|
|
151
|
-
import type { Store } from "hono-rate-limiter";
|
|
152
|
-
import { env } from "./env";
|
|
153
|
-
|
|
154
|
-
/** Options for \`redis.cacheSet\`. */
|
|
155
|
-
export interface CacheSetOptions {
|
|
156
|
-
/** TTL in seconds (SET EX). Mutually exclusive with \`ttlMilliseconds\`. */
|
|
157
|
-
ttlSeconds?: number;
|
|
158
|
-
/** TTL in milliseconds (SET PX). Mutually exclusive with \`ttlSeconds\`. */
|
|
159
|
-
ttlMilliseconds?: number;
|
|
160
|
-
/** Only set if the key does not already exist (SET NX). */
|
|
161
|
-
ifNotExists?: boolean;
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
/**
|
|
165
|
-
* Three small helpers extended onto the native \`redis\` client for the SDK
|
|
166
|
-
* methods whose signatures differ between ioredis and Upstash. Use these in
|
|
167
|
-
* your own code when you want a uniform API; everything else on \`redis\` is
|
|
168
|
-
* the native Upstash surface (or ioredis, on that backend) \u2014 use those
|
|
169
|
-
* directly with their native syntax.
|
|
170
|
-
*/
|
|
171
|
-
export interface BoilerplateRedisHelpers {
|
|
172
|
-
/** SET with optional TTL and NX in one call. Returns \`true\` if stored, \`false\` only when \`ifNotExists\` was set and the key already existed. */
|
|
173
|
-
cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean>;
|
|
174
|
-
/** GET typed as \`string | null\`. Pairs with \`automaticDeserialization: false\` for consistent string round-trip. */
|
|
175
|
-
cacheGet(key: string): Promise<string | null>;
|
|
176
|
-
/** Iterate keys matching a glob pattern via SCAN. Yields each key as it's discovered. */
|
|
177
|
-
cacheScan(opts: { match: string; count?: number }): AsyncIterable<string>;
|
|
178
|
-
}
|
|
179
|
-
|
|
180
|
-
/**
|
|
181
|
-
* \`automaticDeserialization: false\` makes get/set round-trip raw strings so
|
|
182
|
-
* the boilerplate's \`JSON.stringify(...)\` / \`JSON.parse(...)\` pattern works
|
|
183
|
-
* the same way it does on ioredis. Flip this to \`true\` (the SDK default) if
|
|
184
|
-
* you want Upstash to auto-parse JSON values on \`get\`.
|
|
185
|
-
*/
|
|
186
|
-
const upstash = new Redis({
|
|
187
|
-
url: env.UPSTASH_REDIS_REST_URL,
|
|
188
|
-
token: env.UPSTASH_REDIS_REST_TOKEN,
|
|
189
|
-
automaticDeserialization: false
|
|
190
|
-
});
|
|
191
|
-
|
|
192
|
-
/**
|
|
193
|
-
* Native Upstash REST client + the three boilerplate helpers. Every native
|
|
194
|
-
* Upstash method (\`zadd\`, \`hset\`, \`json.*\`, \`eval\`, etc.) is available
|
|
195
|
-
* directly on this object \u2014 see Upstash's docs for usage. The three
|
|
196
|
-
* \`cache*\` helpers cover the SDK calls whose signatures differ between
|
|
197
|
-
* Upstash and ioredis.
|
|
198
|
-
*/
|
|
199
|
-
export const redis: Redis & BoilerplateRedisHelpers = Object.assign(upstash, {
|
|
200
|
-
async cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean> {
|
|
201
|
-
if (!opts) {
|
|
202
|
-
const result = await upstash.set(key, value);
|
|
203
|
-
return result === "OK";
|
|
204
|
-
}
|
|
205
|
-
const upstashOpts: Record<string, unknown> = {};
|
|
206
|
-
if (opts.ttlSeconds !== undefined) upstashOpts.ex = opts.ttlSeconds;
|
|
207
|
-
if (opts.ttlMilliseconds !== undefined) upstashOpts.px = opts.ttlMilliseconds;
|
|
208
|
-
if (opts.ifNotExists) upstashOpts.nx = true;
|
|
209
|
-
const result =
|
|
210
|
-
Object.keys(upstashOpts).length === 0
|
|
211
|
-
? await upstash.set(key, value)
|
|
212
|
-
: await upstash.set(key, value, upstashOpts);
|
|
213
|
-
return result === "OK";
|
|
214
|
-
},
|
|
215
|
-
async cacheGet(key: string): Promise<string | null> {
|
|
216
|
-
return upstash.get<string>(key);
|
|
217
|
-
},
|
|
218
|
-
async *cacheScan(opts: { match: string; count?: number }): AsyncIterable<string> {
|
|
219
|
-
let cursor = "0";
|
|
220
|
-
do {
|
|
221
|
-
const [next, keys] = await upstash.scan(cursor, opts);
|
|
222
|
-
for (const k of keys) yield k;
|
|
223
|
-
cursor = next;
|
|
224
|
-
} while (cursor !== "0");
|
|
225
|
-
}
|
|
226
|
-
});
|
|
227
|
-
|
|
228
|
-
/**
|
|
229
|
-
* Rate-limit store compatible with \`hono-rate-limiter\`, backed by Upstash Redis.
|
|
230
|
-
* Uses atomic INCR + PEXPIRE for a simple sliding-window counter. Returned as
|
|
231
|
-
* a plain object matching \`Store\` so no unsafe type cast is needed.
|
|
232
|
-
*/
|
|
233
|
-
function createLimiterStore(): Store {
|
|
234
|
-
let windowMs = 60_000;
|
|
235
|
-
return {
|
|
236
|
-
init(options: { windowMs: number }): void {
|
|
237
|
-
windowMs = options.windowMs;
|
|
238
|
-
},
|
|
239
|
-
async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {
|
|
240
|
-
const totalHits = await upstash.incr(key);
|
|
241
|
-
if (totalHits === 1) {
|
|
242
|
-
await upstash.pexpire(key, windowMs);
|
|
243
|
-
}
|
|
244
|
-
const ttl = await upstash.pttl(key);
|
|
245
|
-
return {
|
|
246
|
-
totalHits,
|
|
247
|
-
resetTime: new Date(Date.now() + Math.max(0, ttl))
|
|
248
|
-
};
|
|
249
|
-
},
|
|
250
|
-
async decrement(key: string): Promise<void> {
|
|
251
|
-
await upstash.decr(key);
|
|
252
|
-
},
|
|
253
|
-
async resetKey(key: string): Promise<void> {
|
|
254
|
-
await upstash.del(key);
|
|
255
|
-
}
|
|
256
|
-
};
|
|
257
|
-
}
|
|
258
|
-
|
|
259
|
-
export const limiterStore: Store = createLimiterStore();
|
|
260
|
-
|
|
261
|
-
/** No persistent connection to close with Upstash REST. */
|
|
262
|
-
export async function closeRedis(): Promise<void> {}
|
|
263
|
-
`)}async function Gn(e){await l(`${e.projectDir}/packages/runtime/src/mutex.ts`,`import { Lock } from "@upstash/lock";
|
|
264
|
-
import { redis } from "./redis";
|
|
265
|
-
|
|
266
|
-
export class MutexTimeoutError extends Error {
|
|
267
|
-
constructor(key: string) {
|
|
268
|
-
super(\`Failed to acquire mutex for key: \${key}\`);
|
|
269
|
-
this.name = "MutexTimeoutError";
|
|
270
|
-
}
|
|
271
|
-
}
|
|
272
|
-
|
|
273
|
-
/**
|
|
274
|
-
* Execute \`fn\` while holding a distributed mutex on \`key\`. Backed by
|
|
275
|
-
* \`@upstash/lock\`, Upstash's official distributed-lock library \u2014 uses
|
|
276
|
-
* Lua EVAL for atomic compare-and-delete on release (no TOCTOU race) and
|
|
277
|
-
* exposes \`extend()\` for long-running operations (not wired here; pick a
|
|
278
|
-
* generous \`lockTimeout\` if you need it).
|
|
279
|
-
*/
|
|
280
|
-
export async function withMutex<T>(
|
|
281
|
-
key: string,
|
|
282
|
-
fn: () => Promise<T>,
|
|
283
|
-
options?: { lockTimeout?: number; acquireTimeout?: number }
|
|
284
|
-
): Promise<T> {
|
|
285
|
-
const lockTimeout = options?.lockTimeout ?? 10_000;
|
|
286
|
-
const acquireTimeout = options?.acquireTimeout ?? 5_000;
|
|
287
|
-
const retryDelay = 500;
|
|
288
|
-
const attempts = Math.max(1, Math.ceil(acquireTimeout / retryDelay));
|
|
289
|
-
|
|
290
|
-
const lock = new Lock({
|
|
291
|
-
id: \`mutex:\${key}\`,
|
|
292
|
-
lease: lockTimeout,
|
|
293
|
-
redis,
|
|
294
|
-
retry: { attempts, delay: retryDelay }
|
|
295
|
-
});
|
|
296
|
-
|
|
297
|
-
const acquired = await lock.acquire();
|
|
298
|
-
if (!acquired) {
|
|
299
|
-
throw new MutexTimeoutError(key);
|
|
300
|
-
}
|
|
301
|
-
|
|
302
|
-
try {
|
|
303
|
-
return await fn();
|
|
304
|
-
} finally {
|
|
305
|
-
await lock.release();
|
|
306
|
-
}
|
|
307
|
-
}
|
|
308
|
-
`)}import{join as Kn}from"path";var zn={postgres:"Postgres",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"},Hn={resend:"Resend",ses:"Amazon SES",smtp:"SMTP"},Yn={redis:"Redis",upstash:"Upstash Redis"},Jn={node:"Node.js / Docker",vercel:"Vercel"},qn={stripe:"Stripe",polar:"Polar"};function Wn(e){let t=e.frontend==="nuxt",r=t?"Nuxt 4":"Next.js 16",n=t?"apps/web-nuxt":"apps/web-next",i=t?"`app/` pages + components + composables":"`app/` routes, `components/`, `lib/`",o=e.architecture==="fullstack",s=o?"(fullstack \u2014 Hono API mounted inside the app)":"(separate \u2014 standalone Hono backend)",a=o?`Mounted inside \`${n}\`. A standalone \`apps/backend\` is also kept (inert) so you can switch to separate later.`:"Runs from `apps/backend`; the frontend reaches it over HTTP.",d=Yn[e.cacheProvider],h=Jn[e.deploymentTarget],y=e.paymentProvider==="none"?"":`
|
|
309
|
-
- **Payments:** ${qn[e.paymentProvider]}`,u=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 Qo}from"commander";import*as En from"@clack/prompts";import{existsSync as Ao,readdirSync as ko,rmSync as Po}from"fs";import{join as _o,resolve as Ro}from"path";import{Option as H}from"commander";import*as E from"@clack/prompts";import*as Be from"@clack/prompts";import vt from"picocolors";function Ft(e){let t=e?` GenerateSaaS v${e} `:" GenerateSaaS ";Be.intro(vt.bgYellow(vt.black(t)))}function Bt(){Be.outro(vt.yellow("Happy building!"))}import*as m from"@clack/prompts";import f from"picocolors";var De={nextjs:{label:"Next.js",hint:"React 19 + Next.js 16"},nuxt:{label:"Nuxt",hint:"Vue 3 + Nuxt 4"}},xe={fullstack:{label:"Fullstack",hint:"Frontend hosts the API \u2014 works on serverless or long-running"},separate:{label:"Separate",hint:"Standalone Hono backend \u2014 long-running runtimes only (Docker, Render, Fly.io, Railway, Coolify, Dokploy)"}},Ge={stripe:{label:"Stripe"},polar:{label:"Polar"},none:{label:"None",hint:"disable payments"}},Ke={smtp:{label:"SMTP",hint:"Mailpit for local dev"},ses:{label:"Amazon SES"},resend:{label:"Resend"}},ze={user:{label:"Per user",hint:"each user has their own subscription"},organization:{label:"Per organization",hint:"org subscription shared by members"}},ye={postgres:{label:"PostgreSQL",hint:"port 5432",port:5432},redis:{label:"Redis",hint:"port 6379",port:6379},inngest:{label:"Inngest",hint:"port 8288",port:8288},mailpit:{label:"Mailpit",hint:"port 1025",port:1025}},Ce={"claude-code":{label:"Claude Code"},cursor:{label:"Cursor"},codex:{label:"Codex"},"gemini-cli":{label:"Gemini CLI"},windsurf:{label:"Windsurf"}};var se={USD:{symbol:"$",name:"US Dollar",place:"left",space:!1},EUR:{symbol:"\u20AC",name:"Euro",place:"right",space:!1},GBP:{symbol:"\xA3",name:"British Pound",place:"left",space:!1},CAD:{symbol:"CA$",name:"Canadian Dollar",place:"left",space:!1},AUD:{symbol:"A$",name:"Australian Dollar",place:"left",space:!1},BRL:{symbol:"R$",name:"Brazilian Real",place:"left",space:!1},JPY:{symbol:"\xA5",name:"Japanese Yen",place:"left",space:!1}};var F={node:{label:"Node.js / Docker",hint:"long-running runtime \u2014 Render, Fly.io, Railway, Coolify, Dokploy, VPS",edgeRuntime:!1},vercel:{label:"Vercel",hint:"serverless functions",edgeRuntime:!0}},x={postgres:{label:"PostgreSQL (self-hosted)",hint:"local Docker, drizzle-orm/node-postgres",managed:!1,envVars:[{key:"DATABASE_URL",defaultValue:"postgres://postgres:postgres@localhost:5432/saas"}]},neon:{label:"Neon",hint:"serverless Postgres",managed:!0,envVars:[{key:"DATABASE_URL",comment:"# TODO: Add your Neon connection string"}]},supabase:{label:"Supabase",hint:"managed Postgres",managed:!0,envVars:[{key:"DATABASE_URL",comment:"# TODO: Add your Supabase connection string"}]}},B={redis:{label:"Redis (self-hosted)",hint:"local Docker, ioredis",managed:!1,envVars:[{key:"REDIS_URL",defaultValue:"redis://localhost:6379"}]},upstash:{label:"Upstash",hint:"serverless Redis",managed:!0,envVars:[{key:"UPSTASH_REDIS_REST_URL",comment:"# TODO: Add your Upstash REST URL"},{key:"UPSTASH_REDIS_REST_TOKEN",comment:"# TODO: Add your Upstash REST token"}]}},Ne=[{target:"vercel",provider:"redis",reason:"Vercel serverless cannot maintain persistent Redis connections. Consider Upstash."}],Le=[{architecture:"separate",target:"vercel",reason:"Standalone backends need a long-running runtime. Vercel's per-function TypeScript check conflicts with pnpm's isolated install. Use --architecture fullstack for serverless, or deploy the standalone backend to a long-running runtime (Render, Fly.io, Railway, Coolify, Dokploy, or your own VPS via Docker)."}],Gt=["Local file storage (sharp, geoip-lite)","SMTP email (use Resend or SES instead)","Content API git integration"];function He(e){let t=x[e.databaseProvider].managed,r=B[e.cacheProvider].managed;return e.dockerServices.some(i=>!(i==="postgres"&&t||i==="redis"&&r))}var q={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"],Ye=["fullstack","separate"],Je=["stripe","polar","none"],qe=["smtp","ses","resend"],We=["postgres","redis","inngest","mailpit"],Xe=["claude-code","cursor","codex","gemini-cli","windsurf"],Ze=["user","organization"],ae=["USD","EUR","GBP","CAD","AUD","BRL","JPY"],ce=["node","vercel"],le=["postgres","neon","supabase"],pe=["redis","upstash"],Qe=["google","github","facebook","discord","x"];function et(e){return e.split("-").map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function tt(e){return/^[a-z][a-z0-9-]*$/.test(e)}function T(e){return e instanceof Error?e.message:String(e)}function w(e){m.isCancel(e)&&(m.cancel("Setup cancelled."),process.exit(0))}function St(e){let t=[];e.databaseProvider==="neon"&&t.push({key:"DATABASE_URL",message:"Neon connection string (optional):",placeholder:"postgres://...",secret:!0}),e.databaseProvider==="supabase"&&t.push({key:"DATABASE_URL",message:"Supabase connection string (optional):",placeholder:"postgres://...",secret:!0}),e.cacheProvider==="upstash"&&(t.push({key:"UPSTASH_REDIS_REST_URL",message:"Upstash REST URL (optional):",placeholder:"https://...",secret:!1}),t.push({key:"UPSTASH_REDIS_REST_TOKEN",message:"Upstash REST token (optional):",secret:!0})),e.paymentProvider==="stripe"&&(t.push({key:"STRIPE_SECRET_KEY",message:"Stripe secret key (optional):",placeholder:"sk_test_...",secret:!0}),t.push({key:"STRIPE_WEBHOOK_SECRET",message:"Stripe webhook secret (optional):",placeholder:"whsec_...",secret:!0})),e.paymentProvider==="polar"&&(t.push({key:"POLAR_ACCESS_TOKEN",message:"Polar access token (optional):",secret:!0}),t.push({key:"POLAR_WEBHOOK_SECRET",message:"Polar webhook secret (optional):",secret:!0})),e.emailProvider==="resend"&&t.push({key:"RESEND_API_KEY",message:"Resend API key (optional):",placeholder:"re_...",secret:!0}),e.emailProvider==="ses"&&(t.push({key:"AMAZON_SES_REGION",message:"Amazon SES region (optional):",placeholder:"us-east-1",secret:!1}),t.push({key:"AMAZON_SES_KEY",message:"Amazon SES access key (optional):",secret:!0}),t.push({key:"AMAZON_SES_SECRET",message:"Amazon SES secret (optional):",secret:!0}));for(let r of e.socialProviders){let i=q[r];for(let n of i.envVars)t.push({key:n.name,message:`${n.name} (${i.label}, optional):`,secret:n.secret})}return e.demo&&t.push({key:"TURNSTILE_SECRET_KEY",message:"Cloudflare Turnstile secret key (optional):",secret:!0}),t}async function Kt(e){let t=!1;m.log.info(f.bold("Project"));let r=e?.projectName??await(async()=>{t=!0;let c=await m.text({message:"Project name:",placeholder:"my-saas",validate:p=>{if(!p?.trim())return"Project name is required.";if(!tt(p))return"Use lowercase letters, numbers, and hyphens only. Must start with a letter."}});return w(c),c})(),i=e?.appName??await(async()=>{t=!0;let c=await m.text({message:"App name:",initialValue:et(r),validate:p=>{if(!p?.trim())return"App name is required."}});return w(c),c})(),n=e?.projectDir??await(async()=>{t=!0;let c=await m.text({message:"Project location:",initialValue:`./${r}`});return w(c),c==="."?process.cwd():c})(),o=e?.frontend??await(async()=>{t=!0;let c=Object.keys(De),p=await m.select({message:"Frontend framework:",options:c.map(y=>({value:y,label:De[y].label,hint:De[y].hint}))});return w(p),p})();m.log.info(f.bold("Infrastructure"));let s=e?.deploymentTarget??"node";if(e?.deploymentTarget===void 0){t=!0;let c=await m.select({message:"Deployment target:",options:ce.map(p=>({value:p,label:F[p].label,hint:F[p].hint}))});w(c),s=c}let a=e?.architecture?Le.find(c=>c.architecture===e.architecture&&c.target===s):void 0;if(a)throw new Error(`Incompatible: --architecture ${a.architecture} + --deploy ${a.target}. ${a.reason}`);let d=new Set(Le.filter(c=>c.target===s).map(c=>c.architecture)),g=Ye.filter(c=>!d.has(c)),h=e?.architecture??await(async()=>{if(g.length===1){let p=g[0];return m.log.info(`Auto-selected ${xe[p].label} architecture (only compatible option for ${F[s].label}).`),p}t=!0;let c=await m.select({message:"Architecture:",options:g.map(p=>({value:p,label:xe[p].label,hint:xe[p].hint}))});return w(c),c})(),u=e?.databaseProvider??await(async()=>{t=!0;let c=le.filter(y=>!Ne.some(R=>R.target===s&&R.provider===y));if(c.length===1){let y=c[0];return m.log.info(`Auto-selected ${x[y].label} (only compatible option for ${F[s].label}).`),y}let p=await m.select({message:"Database provider:",options:c.map(y=>({value:y,label:x[y].label,hint:x[y].hint}))});return w(p),p})(),S=e?.cacheProvider??await(async()=>{t=!0;let c=pe.filter(y=>!Ne.some(R=>R.target===s&&R.provider===y));if(c.length===1){let y=c[0];return m.log.info(`Auto-selected ${B[y].label} (only compatible option for ${F[s].label}).`),y}let p=await m.select({message:"Cache provider:",options:c.map(y=>({value:y,label:B[y].label,hint:B[y].hint}))});return w(p),p})();if(F[s]?.edgeRuntime){let c=Gt.map(p=>` - ${p}`).join(`
|
|
3
|
+
`);m.note(c,"Unavailable on edge runtime")}m.log.info(f.bold("Features"));let b=e?.paymentProvider??await(async()=>{t=!0;let c=await m.select({message:"Payment provider:",options:Je.map(p=>({value:p,label:Ge[p].label,hint:Ge[p].hint}))});return w(c),c})(),J=e?.defaultCurrency??await(async()=>{if(b==="none")return"USD";t=!0;let c=await m.select({message:"Default currency:",options:ae.map(p=>({value:p,label:p,hint:se[p].name}))});return w(c),c})(),D=e?.emailProvider??await(async()=>{t=!0;let c=await m.select({message:"Email provider:",options:qe.map(p=>({value:p,label:Ke[p].label,hint:Ke[p].hint}))});return w(c),c})(),ne=e?.multiTenancy??await(async()=>{t=!0;let c=await m.confirm({message:"Enable multi-tenancy (organizations)?",initialValue:!1});return w(c),c})(),ie=e?.billingScope??"user";if(ne&&e?.billingScope===void 0){t=!0;let c=await m.select({message:"Billing scope:",options:Ze.map(p=>({value:p,label:ze[p].label,hint:ze[p].hint}))});w(c),ie=c}let I=e?.blog??await(async()=>{t=!0;let c=await m.confirm({message:"Enable blog?",initialValue:!0});return w(c),c})(),v=e?.docs??await(async()=>{t=!0;let c=await m.confirm({message:"Include docs app? (self-hosted Fumadocs documentation site)",initialValue:!1});return w(c),c})(),P=e?.revenueSharing??await(async()=>{t=!0;let c=await m.confirm({message:"Enable revenue sharing? (opt-in MRR leaderboard with dofollow backlinks)",initialValue:!1});return w(c),c})(),Re=b==="none"?!1:e?.credits??await(async()=>{t=!0;let c=await m.confirm({message:"Enable credits? (metered usage on top of subscription plans)",initialValue:!0});return w(c),c})(),he=e?.socialProviders??await(async()=>{t=!0;let c=Qe.map(y=>({value:y,label:q[y].label,hint:`requires ${q[y].envVars.map(R=>R.name).join(" / ")}`})),p=await m.multiselect({message:"Which social login providers should the sign-in screen show?",options:c,initialValues:[],required:!1});return w(p),p})();m.log.info(f.bold("Tooling"));let gt=e?.dockerServices??await(async()=>{t=!0;let c=[...We].filter(O=>O!=="mailpit");D==="smtp"&&c.push("mailpit");let p=c.map(O=>({value:O,label:ye[O].label,hint:ye[O].hint})),y=p.map(O=>O.value).filter(O=>!(O==="postgres"&&(u==="neon"||u==="supabase")||O==="redis"&&S==="upstash")),R=await m.multiselect({message:"Which services should we set up in Docker for you?",options:p,initialValues:y,required:!1});return w(R),R})(),ht=e?.aiTools??await(async()=>{t=!0;let c=Xe.map(y=>({value:y,label:Ce[y].label})),p=await m.multiselect({message:"Which AI coding tools do you use?",options:c,initialValues:[],required:!1});return w(p),p})(),yt=e?.demo,Fe=St({databaseProvider:u,cacheProvider:S,paymentProvider:b,emailProvider:D,socialProviders:he,demo:yt}),Oe={};if(Fe.length>0&&t){m.log.info(f.bold("Credentials")+f.dim(" all optional \u2014 press Enter to skip, fill in .env later"));for(let c of Fe)if(t=!0,c.secret){let p=await m.password({message:c.message,mask:"*"});w(p),typeof p=="string"&&p.trim()&&(Oe[c.key]=p.trim())}else{let p=await m.text({message:c.message,placeholder:c.placeholder});w(p),typeof p=="string"&&p.trim()&&(Oe[c.key]=p.trim())}}if(t){let c=[` Name: ${f.cyan(r)}`,` App name: ${f.cyan(i)}`,` Location: ${f.cyan(n)}`,` Frontend: ${f.cyan(De[o].label)}`,` Architecture: ${f.cyan(xe[h].label)}`].join(`
|
|
4
|
+
`),p=[` Deploy target: ${f.cyan(F[s]?.label??"Node.js / Docker")}`,` Database: ${f.cyan(x[u].label)}`,` Cache: ${f.cyan(B[S].label)}`,gt.length>0?` Docker: ${f.cyan(gt.map(oe=>ye[oe].label).join(", "))}`:` Docker: ${f.dim("none")}`].filter(Boolean).join(`
|
|
5
|
+
`),y=[b!=="none"?` Payment: ${f.cyan(Ge[b].label)} (${J})`:` Payment: ${f.dim("none")}`,` Credits: ${Re?f.cyan("Yes"):f.dim("No")}`,` Email: ${f.cyan(Ke[D].label)}`,` Multi-tenancy: ${ne?f.cyan("Yes")+` (billing: ${ze[ie].label})`:f.dim("No")}`,` Blog: ${I?f.cyan("Yes"):f.dim("No")}`,` Docs app: ${v?f.cyan("Yes"):f.dim("No")}`,` Rev. sharing: ${P?f.cyan("Yes"):f.dim("No")}`,he.length>0?` Social login: ${f.cyan(he.map(oe=>q[oe].label).join(", "))}`:` Social login: ${f.dim("none")}`,ht.length>0?` AI tools: ${f.cyan(ht.map(oe=>Ce[oe].label).join(", "))}`:` AI tools: ${f.dim("none")}`].join(`
|
|
6
|
+
`),R=[f.bold("Project"),c,"",f.bold("Infrastructure"),p,"",f.bold("Features"),y];if(Fe.length>0){let oe=Fe.map(Vt=>{let wn=Oe[Vt.key]?f.green("provided"):f.dim("skipped");return` ${Vt.key}: ${wn}`}).join(`
|
|
7
|
+
`);R.push("",f.bold("Credentials"),oe)}m.note(R.join(`
|
|
8
|
+
`),"Summary");let O=await m.confirm({message:"Proceed with these settings?"});(m.isCancel(O)||!O)&&(m.cancel("Setup cancelled."),process.exit(0))}return{projectName:r,appName:i,projectDir:n,frontend:o,architecture:h,deploymentTarget:s,databaseProvider:u,cacheProvider:S,paymentProvider:b,emailProvider:D,multiTenancy:ne,billingScope:ie,blog:I,docs:v,revenueSharing:P,credits:Re,dockerServices:gt,aiTools:ht,socialProviders:he,defaultCurrency:J,...Object.keys(Oe).length>0?{credentials:Oe}:{},...e?.baseUrl!==void 0?{baseUrl:e.baseUrl}:{},...yt!==void 0?{demo:yt}:{}}}import{createReadStream as On}from"fs";import{mkdir as Dn}from"fs/promises";import{Readable as xn}from"stream";import{pipeline as Qt}from"stream/promises";import{extract as Cn}from"tar";import{join as de}from"path";import{homedir as bn}from"os";var rt=process.env.GENERATESAAS_API_URL??"https://cli.generatesaas.com",L=".generatesaas",Q=de(L,"manifest.json"),zt=de(L,"hashes.json"),nt=de(L,"template-hashes.json"),it=de(L,"template"),Ht=de(L,"staging"),Yt=de(L,"staging.json"),W=de(bn(),".generatesaas");var _=class extends Error{constructor(r,i){super(i);this.status=r}status;name="ApiError"};function $(e){return{apiKey:e,baseUrl:rt}}async function ee(e,t,r){let i=`${e.baseUrl}${t}`,n=await fetch(i,{...r,headers:{...r?.headers,Authorization:`Bearer ${e.apiKey}`,"User-Agent":"generatesaas-cli"}});if(!n.ok){let o;try{o=(await n.json()).error??`API ${n.status}: ${t}`}catch{o=`API ${n.status}: ${t}`}throw new _(n.status,o)}return n}import{existsSync as Tn,readFileSync as In,writeFileSync as An,mkdirSync as kn}from"fs";import{dirname as Pn}from"path";import*as te from"@clack/prompts";function Et(){if(!Tn(W))return null;try{let e=JSON.parse(In(W,"utf-8"));return e.apiKey?e.apiKey:(e.token&&!e.apiKey&&te.log.warning(`Found old GitHub token in ${W}. Run 'generatesaas init' to set up your API key.`),null)}catch{return null}}function X(e){kn(Pn(W),{recursive:!0}),An(W,JSON.stringify({apiKey:e},null," ")+`
|
|
9
|
+
`,{mode:384})}async function ve(e){if(e?.apiKey)return e.apiKey;let t=process.env.GENERATESAAS_API_KEY;if(t)return t;let r=Et();if(r)return r;if(!e?.prompt)throw new Error("API key not found. Set GENERATESAAS_API_KEY or run 'generatesaas init' to configure.");return Z()}async function Z(){let e=await te.text({message:"Enter your GenerateSaaS API key:",placeholder:"gs_live_...",validate:t=>{if(!t?.trim())return"API key is required."}});return te.isCancel(e)&&(te.cancel("Setup cancelled."),process.exit(0)),e.trim()}async function G(e){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{latest:"0.0.0-ci",versions:[{version:"0.0.0-ci",date:new Date().toISOString(),breaking:!1}]}:await(await ee(e,"/versions")).json()}async function Jt(e,t){try{return await(await ee(e,`/changelog/${encodeURIComponent(t)}`)).text()}catch(r){if(r instanceof _&&r.status===404)return null;throw r}}async function qt(e,t){return await(await ee(e,`/skill/${encodeURIComponent(t)}`)).json()}async function Wt(e,t){return process.env.GENERATESAAS_OFFLINE_LICENSE==="1"?{token:"offline-test-token",licenseId:"offline-test-license-id"}:await(await ee(e,"/license/sign",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function Xt(e,t){return await(await ee(e,"/license/refresh",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)})).json()}async function Zt(e,t){let r=await fetch(`${e}/license/verify`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({token:t})});if(!r.ok)throw new Error(`Verification service returned ${r.status}`);return await r.json()}var wt=new Set([".git","node_modules",".pnpm-store",".env",".env.test",".turbo",".nuxt",".output",".data","dist",".next",".svelte-kit",".devcontainer","playwright-report","test-results"]),_n=new Set(["data","mksaas","references","scripts",".cursor",".agents",".codex",".generatesaas",".vscode",".mcp.json","AGENTS.md","CLAUDE.md","README.md","TODO.md","OVERVIEW.md"]),Rn=["docs/superpowers","packages/cli","packages/cli-api","packages/translate","infra/docker-compose.yml",".claude/commands",".claude/skills/web-next-port",".claude/skills/web-next-port-workspace",".claude/settings.local.json",".claude/worktrees"];function Se(e){let t=e.split("/");for(let r of t)if(wt.has(r))return!0;if(_n.has(t[0]))return!0;for(let r of Rn)if(e===r||e.startsWith(r+"/"))return!0;return!1}async function ot(e,t,r){await Dn(r,{recursive:!0});let i=process.env.GENERATESAAS_TEMPLATE_TARBALL;if(i){await Qt(On(i),er(r));return}let n=await ee(e,`/template/${encodeURIComponent(t)}`);if(!n.body)throw new Error("Empty response body");let o=xn.fromWeb(n.body);await Qt(o,er(r))}function er(e){return Cn({cwd:e,strip:1,filter:t=>{let r=t.replace(/^[^/]+\//,"");return r?!Se(r):!0},sync:!1})}import{readFile as Nn,rm as tr,writeFile as Ln}from"fs/promises";import{join as bt}from"path";var $n=["apps/web-nuxt/public/images/blog","apps/web-next/public/images/blog"];async function rr(e){await Promise.all($n.map(t=>tr(bt(e,t),{recursive:!0,force:!0})))}async function nr(e,t){t.includes("claude-code")||await tr(bt(e,".claude"),{recursive:!0,force:!0})}async function ir(e,t){let r=bt(e,".claude","settings.json"),i;try{i=await Nn(r,"utf8")}catch{return}let n=JSON.parse(i);delete n.alwaysThinkingEnabled,delete n.enableAllProjectMcpServers,n.env&&(delete n.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS,Object.keys(n.env).length===0&&delete n.env),n.permissions?.allow&&(n.permissions.allow=n.permissions.allow.filter(o=>Un(o,t))),await Ln(r,JSON.stringify(n,null," ")+`
|
|
10
|
+
`)}function Un(e,t){return!(e.startsWith("mcp__")||t!=="nuxt"&&e.includes("nuxt"))}import{join as zn}from"path";import{mkdir as jn,readdir as Mn,rm as Vn,rmdir as Fn,writeFile as Bn}from"fs/promises";import{dirname as st,join as Gn,relative as Kn}from"path";async function at(e){await jn(e,{recursive:!0})}async function l(e,t){await at(st(e)),await Bn(e,t,"utf-8")}async function Tt(e,t){await Vn(e,{force:!0});let r=st(e);for(;r!==t&&r!==st(r);){try{await Fn(r)}catch{return}r=st(r)}}async function ue(e,t,r){let i=[],n=await Mn(e,{withFileTypes:!0});for(let o of n){let s=Gn(e,o.name),a=Kn(t,s);r(a)||(o.isDirectory()?i.push(...await ue(s,t,r)):o.isFile()&&i.push(s))}return i}var Hn={postgres:"Postgres",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"},Yn={resend:"Resend",ses:"Amazon SES",smtp:"SMTP"},Jn={redis:"Redis",upstash:"Upstash Redis"},qn={node:"Node.js / Docker",vercel:"Vercel"},Wn={stripe:"Stripe",polar:"Polar"};function Xn(e){let t=e.frontend==="nuxt",r=t?"Nuxt 4":"Next.js 16",i=t?"apps/web-nuxt":"apps/web-next",n=t?"`app/` pages + components + composables":"`app/` routes, `components/`, `lib/`",o=e.architecture==="fullstack",s=o?"(fullstack \u2014 Hono API mounted inside the app)":"(separate \u2014 standalone Hono backend)",a=o?`Mounted inside \`${i}\`. A standalone \`apps/backend\` is also kept (inert) so you can switch to separate later.`:"Runs from `apps/backend`; the frontend reaches it over HTTP.",d=Jn[e.cacheProvider],g=qn[e.deploymentTarget],h=e.paymentProvider==="none"?"":`
|
|
11
|
+
- **Payments:** ${Wn[e.paymentProvider]}`,u=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`.",S=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
|
|
310
12
|
|
|
311
13
|
Guidelines for AI coding agents (Claude Code, Codex, Cursor, \u2026) in this project.
|
|
312
14
|
Keep this file tight: add a rule only when it prevents a recurring mistake \u2014 too
|
|
@@ -316,11 +18,11 @@ much standing context makes the agent rigid and stops it checking the real code.
|
|
|
316
18
|
|
|
317
19
|
- **Frontend:** ${r} ${s}
|
|
318
20
|
- **API:** Hono, RPC-typed. ${a}
|
|
319
|
-
- **Database:** Drizzle ORM + ${
|
|
21
|
+
- **Database:** Drizzle ORM + ${Hn[e.databaseProvider]}
|
|
320
22
|
- **Cache + jobs:** ${d} + Inngest
|
|
321
|
-
- **Auth:** Better Auth${
|
|
322
|
-
- **Email:** ${
|
|
323
|
-
- **Deploy:** ${
|
|
23
|
+
- **Auth:** Better Auth${h}
|
|
24
|
+
- **Email:** ${Yn[e.emailProvider]}
|
|
25
|
+
- **Deploy:** ${g}
|
|
324
26
|
|
|
325
27
|
## Where things live (extend these \u2014 don't reinvent)
|
|
326
28
|
|
|
@@ -330,7 +32,7 @@ much standing context makes the agent rigid and stops it checking the real code.
|
|
|
330
32
|
- \`packages/auth/src/config.ts\` \u2014 Better Auth config.
|
|
331
33
|
- \`packages/runtime/src/env.ts\` \u2014 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\`.
|
|
332
34
|
- \`packages/{payments,mail,sms,storage,notifications}\` \u2014 config-gated integrations. Every provider's files stay even when its feature is off, so flipping a flag is enough to enable it.
|
|
333
|
-
- \`${
|
|
35
|
+
- \`${i}\` \u2014 the ${r} app (${n}).
|
|
334
36
|
- \`docs/${t?"nuxt":"next"}/\` \u2014 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.
|
|
335
37
|
|
|
336
38
|
## Code style
|
|
@@ -349,7 +51,7 @@ much standing context makes the agent rigid and stops it checking the real code.
|
|
|
349
51
|
- **Hono routes:** keep the method chain (\`.get().post()\`) \u2014 RPC type inference depends on it. Validate with \`sValidator\` from \`@hono/standard-validator\`.
|
|
350
52
|
- **Feature flags:** respect \`config.*\` \u2014 hide/skip a feature when its flag is off (the files stay so you can flip it later).
|
|
351
53
|
- **i18n:** strings live in \`packages/i18n/translations/{locale}/{scope}.json\`; keep keys generic. ${u}
|
|
352
|
-
- ${
|
|
54
|
+
- ${S}
|
|
353
55
|
- **Routes:** use \`config.routes.*\`, never hardcoded path strings.
|
|
354
56
|
- **Secrets:** never send them to an external service; generate tokens/QR codes client-side.
|
|
355
57
|
|
|
@@ -360,19 +62,76 @@ In \`@repo/*\` backend packages prefer web-standard APIs: \`crypto.randomUUID()\
|
|
|
360
62
|
## This project
|
|
361
63
|
|
|
362
64
|
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\`.
|
|
363
|
-
`}async function
|
|
65
|
+
`}async function or(e){await l(zn(e.projectDir,"AGENTS.md"),Xn(e))}import{join as Zn}from"path";var Qn={postgres:"Postgres (self-hosted)",neon:"Neon (managed Postgres)",supabase:"Supabase (managed Postgres)"};function ei(e){let t=e.appName.trim()||e.projectName,r=e.frontend==="nuxt",i=r?"Nuxt 4":"Next.js 16",n=r?"apps/web-nuxt":"apps/web-next",o=Qn[e.databaseProvider],s=He(e),a=e.architecture==="fullstack"?`${i} app at \`${n}/\` with the Hono API mounted inside it. A standalone \`apps/backend/\` is also included (inert in this fullstack setup) so you can split the API into a separate service later without re-scaffolding.`:`${i} app at \`${n}/\` and a separate Hono backend at \`apps/backend/\`.`,d=e.architecture==="fullstack"?`- App + API: http://localhost:3000
|
|
66
|
+
- Inngest dev server: http://127.0.0.1:8288`:`- App: http://localhost:3000
|
|
67
|
+
- API: http://localhost:3010
|
|
68
|
+
- Inngest dev server: http://127.0.0.1:8288`,g=s?`pnpm infra # optional: starts local Docker services (Postgres / Redis / Inngest / Mailpit)
|
|
69
|
+
`:"",h=e.deploymentTarget==="vercel"?"### Deployment\n\nDeploy to Vercel: `vercel deploy` (or connect the repo in the Vercel dashboard). Required environment variables are listed in `.env`.":`### Deployment
|
|
70
|
+
|
|
71
|
+
This project ships with Dockerfiles for each app. Build images with \`docker build\` and deploy to your runtime of choice (Render / Fly.io / Railway / Coolify / Dokploy / your own VPS).${s?"\n\nThe `infra/` directory ships a Docker Compose file for the local-only services (Postgres / Redis / Inngest / Mailpit, filtered by your provider choices).":""}`,u=e.aiTools.length>0?"To pull the latest boilerplate changes into this project, open it in your AI coding agent and ask: `update my GenerateSaaS project`.":"To pull the latest boilerplate changes into this project, install an AI coding agent (Claude Code / Cursor / Codex / Gemini CLI / Windsurf) and ask: `update my GenerateSaaS project`. The skill bundle that drives the update lives under each tool's skill root.";return`# ${t}
|
|
72
|
+
|
|
73
|
+
${a}
|
|
74
|
+
|
|
75
|
+
## Stack
|
|
76
|
+
|
|
77
|
+
- **Frontend:** ${i}
|
|
78
|
+
- **Backend:** Hono (TypeScript, RPC-typed)
|
|
79
|
+
- **Auth:** Better Auth
|
|
80
|
+
- **ORM / DB:** Drizzle + ${o}
|
|
81
|
+
- **Background jobs:** Inngest
|
|
82
|
+
- **i18n:** ${r?"@nuxtjs/i18n":"next-intl"}
|
|
83
|
+
|
|
84
|
+
## Development
|
|
85
|
+
|
|
86
|
+
\`\`\`bash
|
|
87
|
+
pnpm install
|
|
88
|
+
# A ready-to-run \`.env\` was generated for you \u2014 open it and fill in the
|
|
89
|
+
# values marked \`# TODO\` (provider API keys). \`.env.example\` is the committed
|
|
90
|
+
# reference. All apps load the single root \`.env\`.
|
|
91
|
+
${g}pnpm dev
|
|
92
|
+
\`\`\`
|
|
93
|
+
|
|
94
|
+
${d}
|
|
95
|
+
|
|
96
|
+
## Configuration
|
|
97
|
+
|
|
98
|
+
App-level configuration lives in \`packages/config/src/index.ts\`. Translation strings live in \`packages/i18n/translations/{locale}/{scope}.json\`. Feature flags and routes are part of the config object.
|
|
99
|
+
|
|
100
|
+
## Database
|
|
101
|
+
|
|
102
|
+
\`\`\`bash
|
|
103
|
+
pnpm -F @repo/database push # push schema changes
|
|
104
|
+
pnpm -F @repo/database migrate # run migrations
|
|
105
|
+
pnpm -F @repo/database studio # open Drizzle Studio
|
|
106
|
+
pnpm auth:generate # regenerate Better Auth schema after config changes
|
|
107
|
+
\`\`\`
|
|
108
|
+
|
|
109
|
+
${h}
|
|
110
|
+
|
|
111
|
+
## Removing the GenerateSaaS license
|
|
112
|
+
|
|
113
|
+
This project includes a daily license-verification heartbeat to confirm the install. To remove all license code, the manifest, and the internal license route:
|
|
114
|
+
|
|
115
|
+
\`\`\`bash
|
|
116
|
+
pnpm dlx generatesaas eject
|
|
117
|
+
\`\`\`
|
|
118
|
+
|
|
119
|
+
## Updates
|
|
120
|
+
|
|
121
|
+
${u}
|
|
122
|
+
`}async function sr(e){await l(Zn(e.projectDir,"README.md"),ei(e))}function ti(e){let t=e.split(".");return t.length>=3?t.slice(1).join("."):e}async function ar(e){let t=e.appName.replace(/\\/g,"\\\\").replace(/"/g,'\\"'),r=e.paymentProvider!=="none",i=e.baseUrl??"http://localhost:3000",n=e.baseUrl?new URL(e.baseUrl).hostname:"example.com",o=ti(n),s=e.demo?"false":"true",a=e.demo?`
|
|
364
123
|
support: {
|
|
365
124
|
enableInDev: true,
|
|
366
125
|
crisp: { websiteId: "7e221cec-ed61-46b7-b1b4-8cbc16557cca" }
|
|
367
|
-
},`:"",d=e.frontend==="nextjs"&&e.architecture==="fullstack"?"false":"true",
|
|
126
|
+
},`:"",d=e.frontend==="nextjs"&&e.architecture==="fullstack"?"false":"true",g=`import type { AppConfig } from "@repo/config/types";
|
|
368
127
|
|
|
369
128
|
const trustedOrigins = process.env.TRUSTED_ORIGINS?.split(",").map((s) => s.trim()).filter(Boolean);
|
|
370
129
|
|
|
371
130
|
export const config: AppConfig = {
|
|
372
131
|
siteName: "${t}",
|
|
373
132
|
fullSiteName: "${t}",
|
|
374
|
-
domain: "${
|
|
375
|
-
baseUrl: process.env.BASE_URL ?? "${
|
|
133
|
+
domain: "${n}",
|
|
134
|
+
baseUrl: process.env.BASE_URL ?? "${i}",
|
|
376
135
|
indexable: ${s},
|
|
377
136
|
logo: {
|
|
378
137
|
main: "/images/logo.svg",
|
|
@@ -478,7 +237,7 @@ export const config: AppConfig = {
|
|
|
478
237
|
}`:`{
|
|
479
238
|
base: "${e.defaultCurrency}",
|
|
480
239
|
list: [
|
|
481
|
-
{ symbol: "${
|
|
240
|
+
{ symbol: "${se[e.defaultCurrency].symbol}", name: "${se[e.defaultCurrency].name}", code: "${e.defaultCurrency}", place: "${se[e.defaultCurrency].place}", space: ${se[e.defaultCurrency].space} }
|
|
482
241
|
],
|
|
483
242
|
countryMap: {
|
|
484
243
|
default: "${e.defaultCurrency}"
|
|
@@ -531,75 +290,218 @@ export * from "./pricing";
|
|
|
531
290
|
export * from "./roles";
|
|
532
291
|
export * from "./section-tabs";
|
|
533
292
|
export * from "./tenancy";
|
|
534
|
-
`,
|
|
535
|
-
|
|
536
|
-
- API: http://localhost:3010
|
|
537
|
-
- Inngest dev server: http://127.0.0.1:8288`,h=s?`pnpm infra # optional: starts local Docker services (Postgres / Redis / Inngest / Mailpit)
|
|
538
|
-
`:"",y=e.deploymentTarget==="vercel"?"### Deployment\n\nDeploy to Vercel: `vercel deploy` (or connect the repo in the Vercel dashboard). Required environment variables are listed in `.env`.":`### Deployment
|
|
293
|
+
`,h=`${e.projectDir}/packages/config/src/index.ts`;await l(h,g)}function ri(e){return e==="stripe"?' stripePriceId: "",':' polarProductId: "",'}function It(e){let t=[];return e.withCredits&&(t.push(` credits: ${e.credits},`),t.push(" creditInterval: 30,")),t.push(` apiRateLimit: { maxRequests: ${e.rateLimit} }`),e.trial&&(t[t.length-1]+=",",t.push(" trialDays: 14"),e.withCredits&&(t[t.length-1]+=",",t.push(" grantCreditsOnTrial: true"))),t.join(`
|
|
294
|
+
`)}async function cr(e){let t=`${e.projectDir}/packages/config/src/pricing.ts`,r=e.defaultCurrency;if(e.paymentProvider==="none"){let u=`import type { PricingConfig } from "@repo/config/types";
|
|
539
295
|
|
|
540
|
-
|
|
296
|
+
export const pricingConfig: PricingConfig = {
|
|
297
|
+
defaultPlan: "free",
|
|
298
|
+
defaultApiRateLimit: { maxRequests: 100 },
|
|
299
|
+
plans: [
|
|
300
|
+
{
|
|
301
|
+
id: "free",
|
|
302
|
+
type: "free",
|
|
303
|
+
name: "pricing.plans.plan_1.name",
|
|
304
|
+
description: "pricing.plans.plan_1.description",
|
|
305
|
+
features: [
|
|
306
|
+
"pricing.plans.plan_1.features.item_1",
|
|
307
|
+
"pricing.plans.plan_1.features.item_2",
|
|
308
|
+
"pricing.plans.plan_1.features.item_3",
|
|
309
|
+
"pricing.plans.plan_1.features.item_4"
|
|
310
|
+
],
|
|
311
|
+
prices: [
|
|
312
|
+
{
|
|
313
|
+
interval: "lifetime",
|
|
314
|
+
amounts: { ${r}: 0 }
|
|
315
|
+
}
|
|
316
|
+
],
|
|
317
|
+
apiRateLimit: { maxRequests: 100 }
|
|
318
|
+
}
|
|
319
|
+
],
|
|
320
|
+
credits: { enabled: false },
|
|
321
|
+
products: { enabled: false, items: [] }
|
|
322
|
+
};
|
|
323
|
+
`;await l(t,u);return}let i=e.paymentProvider,n=ri(i),o=e.credits,s=It({credits:5,rateLimit:100,trial:!1,withCredits:o}),a=It({credits:10,rateLimit:1e3,trial:!0,withCredits:o}),d=It({credits:50,rateLimit:5e3,trial:!0,withCredits:o}),h=`import type { PricingConfig } from "@repo/config/types";
|
|
541
324
|
|
|
325
|
+
export const pricingConfig: PricingConfig = {
|
|
326
|
+
defaultPlan: "free",
|
|
327
|
+
defaultApiRateLimit: { maxRequests: 100 },
|
|
328
|
+
plans: [
|
|
329
|
+
{
|
|
330
|
+
id: "free",
|
|
331
|
+
type: "free",
|
|
332
|
+
name: "pricing.plans.plan_1.name",
|
|
333
|
+
description: "pricing.plans.plan_1.description",
|
|
334
|
+
features: [
|
|
335
|
+
"pricing.plans.plan_1.features.item_1",
|
|
336
|
+
"pricing.plans.plan_1.features.item_2",
|
|
337
|
+
"pricing.plans.plan_1.features.item_3",
|
|
338
|
+
"pricing.plans.plan_1.features.item_4"
|
|
339
|
+
],
|
|
340
|
+
limits: ["pricing.plans.plan_1.limits.item_1", "pricing.plans.plan_1.limits.item_2"],
|
|
341
|
+
prices: [
|
|
342
|
+
{
|
|
343
|
+
interval: "lifetime",
|
|
344
|
+
amounts: { ${r}: 0 }
|
|
345
|
+
}
|
|
346
|
+
],
|
|
347
|
+
${s}
|
|
348
|
+
},
|
|
349
|
+
{
|
|
350
|
+
id: "starter",
|
|
351
|
+
type: "subscription",
|
|
352
|
+
name: "pricing.plans.plan_2.name",
|
|
353
|
+
description: "pricing.plans.plan_2.description",
|
|
354
|
+
features: [
|
|
355
|
+
"pricing.plans.plan_2.features.item_1",
|
|
356
|
+
"pricing.plans.plan_2.features.item_2",
|
|
357
|
+
"pricing.plans.plan_2.features.item_3",
|
|
358
|
+
"pricing.plans.plan_2.features.item_4"
|
|
359
|
+
],
|
|
360
|
+
prices: [
|
|
361
|
+
{
|
|
362
|
+
${n}
|
|
363
|
+
interval: "month",
|
|
364
|
+
amounts: { ${r}: 9 }
|
|
365
|
+
},
|
|
366
|
+
{
|
|
367
|
+
${n}
|
|
368
|
+
interval: "year",
|
|
369
|
+
amounts: { ${r}: 90 },
|
|
370
|
+
anchorAmounts: { ${r}: 109 }
|
|
371
|
+
}
|
|
372
|
+
],
|
|
542
373
|
${a}
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
${
|
|
561
|
-
|
|
562
|
-
|
|
374
|
+
},
|
|
375
|
+
{
|
|
376
|
+
id: "pro",
|
|
377
|
+
type: "subscription",
|
|
378
|
+
name: "pricing.plans.plan_3.name",
|
|
379
|
+
description: "pricing.plans.plan_3.description",
|
|
380
|
+
featured: true,
|
|
381
|
+
features: [
|
|
382
|
+
"pricing.plans.plan_3.features.item_1",
|
|
383
|
+
"pricing.plans.plan_3.features.item_2",
|
|
384
|
+
"pricing.plans.plan_3.features.item_3",
|
|
385
|
+
"pricing.plans.plan_3.features.item_4",
|
|
386
|
+
"pricing.plans.plan_3.features.item_5",
|
|
387
|
+
"pricing.plans.plan_3.features.item_6"
|
|
388
|
+
],
|
|
389
|
+
prices: [
|
|
390
|
+
{
|
|
391
|
+
${n}
|
|
392
|
+
interval: "month",
|
|
393
|
+
amounts: { ${r}: 29 },
|
|
394
|
+
anchorAmounts: { ${r}: 39 },
|
|
395
|
+
featured: true
|
|
396
|
+
},
|
|
397
|
+
{
|
|
398
|
+
${n}
|
|
399
|
+
interval: "year",
|
|
400
|
+
amounts: { ${r}: 290 },
|
|
401
|
+
anchorAmounts: { ${r}: 349 }
|
|
402
|
+
}
|
|
403
|
+
],
|
|
563
404
|
${d}
|
|
405
|
+
}
|
|
406
|
+
],
|
|
407
|
+
${o?" credits: { enabled: true }":" credits: { enabled: false }"},
|
|
408
|
+
products: {
|
|
409
|
+
enabled: false,
|
|
410
|
+
items: []
|
|
411
|
+
}
|
|
412
|
+
};
|
|
413
|
+
`;await l(t,h)}var ni={smtp:[{key:"SMTP_HOST",defaultValue:"localhost"},{key:"SMTP_PORT",defaultValue:"1025"}],ses:[{key:"AMAZON_SES_REGION",comment:"# TODO: Configure Amazon SES credentials (e.g. us-east-1)"},{key:"AMAZON_SES_KEY"},{key:"AMAZON_SES_SECRET"}],resend:[{key:"RESEND_API_KEY",comment:"# TODO: Add your Resend API key"}]};function ii(e){let t=q[e];return t.envVars.map((r,i)=>({key:r.name,...i===0?{comment:`# TODO: Add your ${t.label} OAuth credentials`}:{}}))}var oi={stripe:[{key:"STRIPE_SECRET_KEY",comment:"# TODO: Add your Stripe keys"},{key:"STRIPE_WEBHOOK_SECRET"}],polar:[{key:"POLAR_ACCESS_TOKEN",comment:"# TODO: Add your Polar keys"},{key:"POLAR_WEBHOOK_SECRET"}]};function Ee(e,t){return t?e.map(r=>{let i=t[r.key];return i?{...r,defaultValue:i,comment:void 0}:r}):e}function we(e,t){for(let r of e)r.comment&&t.push(r.comment),r.defaultValue!==void 0?t.push(`${r.key}=${r.defaultValue}`):t.push(`#${r.key}=`)}function At(e){return Array.from(crypto.getRandomValues(new Uint8Array(e))).map(t=>t.toString(16).padStart(2,"0")).join("")}function pr(e){return e.architecture==="fullstack"?{apiUrl:"http://localhost:3000/api",baseUrl:"http://localhost:3000"}:{apiUrl:"http://localhost:3010",baseUrl:"http://localhost:3000"}}function si(e){let{architecture:t,deploymentTarget:r}=e;return t==="fullstack"?r==="vercel"?{frontend:"https://your-app.vercel.app",backend:"https://your-app.vercel.app"}:r==="node"?{frontend:"https://your-app.example.com",backend:"https://your-app.example.com"}:null:{frontend:"https://your-app.example.com",backend:"https://your-app.example.com/api"}}function ct(e,t,r,i){e.push(i==="example"?`${t}=`:`${t}=${r}`)}function lr(e,t){let r=t==="example"?void 0:e.credentials,{apiUrl:i,baseUrl:n}=pr(e),o=["# API Configuration",`API_URL=${i}`,`BASE_URL=${n}`];o.push("","# Database"),we(Ee(x[e.databaseProvider].envVars,r),o),o.push("","# Cache"),we(Ee(B[e.cacheProvider].envVars,r),o),o.push("","# Authentication"),t==="example"&&o.push("# Generate a strong secret, e.g. `openssl rand -hex 32`"),ct(o,"BETTER_AUTH_SECRET",crypto.randomUUID(),t),o.push("","# Content API (random secret; required when contentApi feature is enabled in @repo/config)"),ct(o,"CONTENT_API_KEY",At(32),t),o.push("","# Job Queue - Inngest","INNGEST_APP_ID=api"),ct(o,"INNGEST_EVENT_KEY",At(32),t),ct(o,"INNGEST_SIGNING_KEY",At(32),t),o.push("INNGEST_BASE_URL=http://127.0.0.1:8288"),e.architecture==="separate"&&(o.push("","# API Port (standalone backend)","API_PORT=3010"),o.push("","# CORS + cross-subdomain cookies (production only \u2014 leave unset for local dev)","# TRUSTED_ORIGINS=https://your-app.example.com","# AUTH_COOKIE_DOMAIN=.example.com"));let s=ni[e.emailProvider];if(s&&(o.push("","# Email"),we(Ee(s,r),o)),e.paymentProvider!=="none"){let a=oi[e.paymentProvider];a&&(o.push("","# Payment"),we(Ee(a,r),o))}if(e.socialProviders.length>0){o.push("","# Social auth");for(let a of e.socialProviders)we(Ee(ii(a),r),o)}return e.demo&&(o.push("","# Captcha (Cloudflare Turnstile)"),we(Ee([{key:"TURNSTILE_SECRET_KEY",comment:"# TODO: Add your Cloudflare Turnstile secret key"}],r),o)),o.push(""),o.join(`
|
|
414
|
+
`)}function ai(e){let{apiUrl:t}=pr(e),r=e.frontend==="nextjs"?"NEXT_PUBLIC_API_URL":"NUXT_PUBLIC_API_URL",i=["# API Configuration",`${r}=${t}`],n=si(e);return n&&e.architecture==="separate"&&i.push("","# Production (uncomment and replace with your deployed hostnames):",`# ${r}=${n.backend}`),i.push(""),i.join(`
|
|
415
|
+
`)}async function dr(e){let t=ai(e);await l(`${e.projectDir}/.env`,t+`
|
|
416
|
+
`+lr(e,"env")),await l(`${e.projectDir}/.env.example`,t+`
|
|
417
|
+
`+lr(e,"example"))}async function ur(e){let t=[...e.dockerServices];if(x[e.databaseProvider].managed&&(t=t.filter(o=>o!=="postgres")),B[e.cacheProvider].managed&&(t=t.filter(o=>o!=="redis")),t.length===0)return!1;let r=[],i=[];t.includes("postgres")&&(r.push(` postgres:
|
|
418
|
+
image: postgres:18-alpine
|
|
419
|
+
ports:
|
|
420
|
+
- "\${POSTGRES_PORT:-5432}:5432"
|
|
421
|
+
environment:
|
|
422
|
+
POSTGRES_USER: postgres
|
|
423
|
+
POSTGRES_PASSWORD: postgres
|
|
424
|
+
POSTGRES_DB: saas
|
|
425
|
+
PGDATA: /var/lib/postgresql/data
|
|
426
|
+
volumes:
|
|
427
|
+
- postgres_data:/var/lib/postgresql/data
|
|
428
|
+
healthcheck:
|
|
429
|
+
test: ["CMD-SHELL", "pg_isready -U postgres"]
|
|
430
|
+
interval: 5s
|
|
431
|
+
timeout: 5s
|
|
432
|
+
retries: 5`),i.push(" postgres_data:")),t.includes("redis")&&(r.push(` redis:
|
|
433
|
+
image: redis:8-alpine
|
|
434
|
+
ports:
|
|
435
|
+
- "\${REDIS_PORT:-6379}:6379"
|
|
436
|
+
volumes:
|
|
437
|
+
- redis_data:/data
|
|
438
|
+
healthcheck:
|
|
439
|
+
test: ["CMD", "redis-cli", "ping"]
|
|
440
|
+
interval: 5s
|
|
441
|
+
timeout: 5s
|
|
442
|
+
retries: 5`),i.push(" redis_data:")),t.includes("mailpit")&&r.push(` mailpit:
|
|
443
|
+
image: axllent/mailpit
|
|
444
|
+
ports:
|
|
445
|
+
- "\${MAILPIT_SMTP_PORT:-1025}:1025"
|
|
446
|
+
- "\${MAILPIT_UI_PORT:-8025}:8025"
|
|
447
|
+
environment:
|
|
448
|
+
MP_SMTP_AUTH_ACCEPT_ANY: 1
|
|
449
|
+
MP_SMTP_AUTH_ALLOW_INSECURE: 1`),t.includes("inngest")&&r.push(` inngest:
|
|
450
|
+
image: inngest/inngest:v1.17.4
|
|
451
|
+
ports:
|
|
452
|
+
- "\${INNGEST_PORT:-8288}:8288"
|
|
453
|
+
command: inngest dev`);let n=`services:
|
|
454
|
+
${r.join(`
|
|
564
455
|
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
pnpm -F @repo/database studio # open Drizzle Studio
|
|
575
|
-
pnpm auth:generate # regenerate Better Auth schema after config changes
|
|
576
|
-
\`\`\`
|
|
577
|
-
|
|
578
|
-
${y}
|
|
579
|
-
|
|
580
|
-
## Removing the GenerateSaaS license
|
|
456
|
+
`)}
|
|
457
|
+
`;return i.length>0&&(n+=`
|
|
458
|
+
volumes:
|
|
459
|
+
${i.join(`
|
|
460
|
+
`)}
|
|
461
|
+
`),await l(`${e.projectDir}/infra/docker-compose.yml`,n),!0}function ci(e){let t=[];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 r=e.frontend==="nextjs"?"Next.js":"Nuxt";if(t.push({type:"node-terminal",request:"launch",name:r,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"}}),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 i=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 ${i}`,cwd:"${workspaceFolder}",skipFiles:["<node_internals>/**"]})}return t}function li(e){let t=e.frontend==="nextjs"?"Next.js":"Nuxt",r=[];return e.architecture==="separate"?r.push({name:`Dev (${t} + Backend + Inngest)`,configurations:["Backend",t,"Inngest"]}):r.push({name:`Dev (${t} + Inngest)`,configurations:[t,"Inngest"]}),r}async function mr(e){let t={version:"0.2.0",configurations:ci(e),compounds:li(e)};await l(`${e.projectDir}/.vscode/launch.json`,JSON.stringify(t,null," ")+`
|
|
462
|
+
`)}async function fr(e){if(e.architecture!=="separate")return;await l(`${e.projectDir}/apps/backend/src/index.ts`,`import { serve } from "@hono/node-server";
|
|
463
|
+
import app from "@repo/api";
|
|
464
|
+
import { closeRedis, env, logger } from "@repo/runtime";
|
|
581
465
|
|
|
582
|
-
|
|
466
|
+
async function bootstrap() {
|
|
467
|
+
const apiServer = serve({
|
|
468
|
+
fetch: app.fetch,
|
|
469
|
+
port: env.API_PORT,
|
|
470
|
+
});
|
|
471
|
+
logger.info(\`[API] Listening on port \${env.API_PORT}\`);
|
|
583
472
|
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
473
|
+
const shutdown = async (signal: string) => {
|
|
474
|
+
logger.info("[Backend] Shutting down", { signal });
|
|
475
|
+
try {
|
|
476
|
+
await closeRedis();
|
|
477
|
+
} catch (err) {
|
|
478
|
+
logger.error("[Backend] Redis close error during shutdown", err);
|
|
479
|
+
}
|
|
480
|
+
apiServer.close(() => {
|
|
481
|
+
process.exit(0);
|
|
482
|
+
});
|
|
483
|
+
};
|
|
587
484
|
|
|
588
|
-
|
|
485
|
+
process.on("SIGINT", () => void shutdown("SIGINT"));
|
|
486
|
+
process.on("SIGTERM", () => void shutdown("SIGTERM"));
|
|
487
|
+
}
|
|
589
488
|
|
|
590
|
-
|
|
591
|
-
|
|
489
|
+
bootstrap().catch((error) => {
|
|
490
|
+
logger.error("[Backend] Fatal error", error);
|
|
491
|
+
process.exit(1);
|
|
492
|
+
});
|
|
493
|
+
`)}import{readFile as pi}from"fs/promises";import{join as di}from"path";var ui=`export * from "./db/auth";
|
|
592
494
|
export * from "./db/schema";
|
|
593
|
-
export type { User, Account, Organization, Member } from "./db/auth";`;async function
|
|
594
|
-
`).filter(
|
|
595
|
-
`)}var
|
|
495
|
+
export type { User, Account, Organization, Member } from "./db/auth";`;async function gr(e){let t=di(e.projectDir,"packages/database/src/index.ts"),r=ui;try{let n=await pi(t,"utf-8"),o=mi(n);o&&(r=o)}catch{}let i;switch(e.databaseProvider){case"postgres":i=fi(r);break;case"neon":i=gi(r);break;case"supabase":i=hi(r);break}await l(t,i)}function mi(e){return e.split(`
|
|
496
|
+
`).filter(i=>i.startsWith("export type ")||i.startsWith("export * from")).join(`
|
|
497
|
+
`)}var kt=`
|
|
596
498
|
/** Extract affected-row count from a delete/update result (works for pg + postgres-js). */
|
|
597
499
|
export function affectedRowCount(result: unknown): number {
|
|
598
500
|
if (typeof result !== "object" || result === null) return 0;
|
|
599
501
|
const r = result as { rowCount?: number; count?: number };
|
|
600
502
|
return r.rowCount ?? r.count ?? 0;
|
|
601
503
|
}
|
|
602
|
-
`;function
|
|
504
|
+
`;function fi(e){return`import { drizzle } from "drizzle-orm/node-postgres";
|
|
603
505
|
import { z } from "zod";
|
|
604
506
|
import * as authSchema from "./db/auth";
|
|
605
507
|
import * as appSchema from "./db/schema";
|
|
@@ -614,7 +516,7 @@ export const db = drizzle(parsed.data.DATABASE_URL, { schema });
|
|
|
614
516
|
export const pool = db.$client;
|
|
615
517
|
|
|
616
518
|
${e}
|
|
617
|
-
${
|
|
519
|
+
${kt}`}function gi(e){return`import { neon } from "@neondatabase/serverless";
|
|
618
520
|
import { drizzle } from "drizzle-orm/neon-http";
|
|
619
521
|
import { z } from "zod";
|
|
620
522
|
import * as authSchema from "./db/auth";
|
|
@@ -630,110 +532,321 @@ const sql = neon(parsed.data.DATABASE_URL);
|
|
|
630
532
|
export const db = drizzle(sql, { schema });
|
|
631
533
|
|
|
632
534
|
${e}
|
|
633
|
-
${
|
|
535
|
+
${kt}`}function hi(e){return`import { drizzle } from "drizzle-orm/postgres-js";
|
|
634
536
|
import postgres from "postgres";
|
|
635
537
|
import { z } from "zod";
|
|
636
538
|
import * as authSchema from "./db/auth";
|
|
637
539
|
import * as appSchema from "./db/schema";
|
|
638
540
|
|
|
639
|
-
const schema = { ...authSchema, ...appSchema };
|
|
640
|
-
export { schema };
|
|
541
|
+
const schema = { ...authSchema, ...appSchema };
|
|
542
|
+
export { schema };
|
|
543
|
+
|
|
544
|
+
const parsed = z.object({ DATABASE_URL: z.url() }).safeParse({ DATABASE_URL: process.env.DATABASE_URL });
|
|
545
|
+
if (!parsed.success) throw new Error("DATABASE_URL is not set or invalid");
|
|
546
|
+
|
|
547
|
+
const client = postgres(parsed.data.DATABASE_URL);
|
|
548
|
+
export const db = drizzle(client, { schema });
|
|
549
|
+
|
|
550
|
+
${e}
|
|
551
|
+
${kt}`}async function hr(e){switch(e.cacheProvider){case"redis":await yi(e),await vi(e);break;case"upstash":await Si(e),await Ei(e);break}}async function yi(e){await l(`${e.projectDir}/packages/runtime/src/redis.ts`,`import type { Store } from "hono-rate-limiter";
|
|
552
|
+
import { Redis } from "ioredis";
|
|
553
|
+
import { RedisStore, type RedisReply } from "rate-limit-redis";
|
|
554
|
+
import { env } from "./env";
|
|
555
|
+
|
|
556
|
+
/** Options for \`redis.cacheSet\`. */
|
|
557
|
+
export interface CacheSetOptions {
|
|
558
|
+
/** TTL in seconds (SET EX). Mutually exclusive with \`ttlMilliseconds\`. */
|
|
559
|
+
ttlSeconds?: number;
|
|
560
|
+
/** TTL in milliseconds (SET PX). Mutually exclusive with \`ttlSeconds\`. */
|
|
561
|
+
ttlMilliseconds?: number;
|
|
562
|
+
/** Only set if the key does not already exist (SET NX). */
|
|
563
|
+
ifNotExists?: boolean;
|
|
564
|
+
}
|
|
565
|
+
|
|
566
|
+
/**
|
|
567
|
+
* Three small helpers extended onto the native \`redis\` client for the SDK
|
|
568
|
+
* methods whose signatures differ between ioredis and Upstash. Use these in
|
|
569
|
+
* your own code when you want a uniform API; everything else on \`redis\` is
|
|
570
|
+
* the native ioredis surface (or Upstash, on that backend) \u2014 use those
|
|
571
|
+
* directly with their native syntax.
|
|
572
|
+
*/
|
|
573
|
+
export interface BoilerplateRedisHelpers {
|
|
574
|
+
/** SET with optional TTL and NX in one call. Returns \`true\` if stored, \`false\` only when \`ifNotExists\` was set and the key already existed. */
|
|
575
|
+
cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean>;
|
|
576
|
+
/** GET typed as \`string | null\`. (On Upstash this also disables auto-deserialization for consistent string round-trip.) */
|
|
577
|
+
cacheGet(key: string): Promise<string | null>;
|
|
578
|
+
/** Iterate keys matching a glob pattern via SCAN. Yields each key as it's discovered. */
|
|
579
|
+
cacheScan(opts: { match: string; count?: number }): AsyncIterable<string>;
|
|
580
|
+
}
|
|
581
|
+
|
|
582
|
+
const ioredis = new Redis(env.REDIS_URL);
|
|
583
|
+
|
|
584
|
+
/**
|
|
585
|
+
* Native ioredis client + the three boilerplate helpers. Every native
|
|
586
|
+
* ioredis method (\`zadd\`, \`hset\`, \`pubsub\`, \`eval\`, etc.) is available
|
|
587
|
+
* directly on this object \u2014 see ioredis's docs for usage. The three
|
|
588
|
+
* \`cache*\` helpers cover the SDK calls whose signatures differ between
|
|
589
|
+
* ioredis and Upstash.
|
|
590
|
+
*/
|
|
591
|
+
export const redis: Redis & BoilerplateRedisHelpers = Object.assign(ioredis, {
|
|
592
|
+
async cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean> {
|
|
593
|
+
const args: (string | number)[] = [key, value];
|
|
594
|
+
if (opts?.ttlSeconds !== undefined) args.push("EX", opts.ttlSeconds);
|
|
595
|
+
if (opts?.ttlMilliseconds !== undefined) args.push("PX", opts.ttlMilliseconds);
|
|
596
|
+
if (opts?.ifNotExists) args.push("NX");
|
|
597
|
+
const result = await ioredis.call("SET", ...args);
|
|
598
|
+
return result === "OK";
|
|
599
|
+
},
|
|
600
|
+
async cacheGet(key: string): Promise<string | null> {
|
|
601
|
+
return ioredis.get(key);
|
|
602
|
+
},
|
|
603
|
+
async *cacheScan(opts: { match: string; count?: number }): AsyncIterable<string> {
|
|
604
|
+
let cursor = "0";
|
|
605
|
+
do {
|
|
606
|
+
const [next, keys] =
|
|
607
|
+
opts.count !== undefined
|
|
608
|
+
? await ioredis.scan(cursor, "MATCH", opts.match, "COUNT", opts.count)
|
|
609
|
+
: await ioredis.scan(cursor, "MATCH", opts.match);
|
|
610
|
+
for (const k of keys) yield k;
|
|
611
|
+
cursor = next;
|
|
612
|
+
} while (cursor !== "0");
|
|
613
|
+
}
|
|
614
|
+
});
|
|
615
|
+
|
|
616
|
+
/**
|
|
617
|
+
* Build a \`hono-rate-limiter\`-compatible store backed by \`rate-limit-redis\`.
|
|
618
|
+
* Wraps RedisStore in an adapter exposing only the methods the middleware uses
|
|
619
|
+
* so we don't need an unsafe cross-package type cast.
|
|
620
|
+
*/
|
|
621
|
+
function createLimiterStore(): Store {
|
|
622
|
+
const inner = new RedisStore({
|
|
623
|
+
sendCommand: (command: string, ...args: string[]) =>
|
|
624
|
+
ioredis.call(command, ...args) as Promise<RedisReply>
|
|
625
|
+
});
|
|
626
|
+
return {
|
|
627
|
+
init(options) {
|
|
628
|
+
// rate-limit-redis's init reads only windowMs from its options shape,
|
|
629
|
+
// so the express-rate-limit / hono-rate-limiter shape difference is irrelevant at runtime.
|
|
630
|
+
inner.init({ windowMs: options.windowMs } as Parameters<typeof inner.init>[0]);
|
|
631
|
+
},
|
|
632
|
+
increment: (key) => inner.increment(key),
|
|
633
|
+
decrement: (key) => inner.decrement(key),
|
|
634
|
+
resetKey: (key) => inner.resetKey(key)
|
|
635
|
+
};
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
export const limiterStore: Store = createLimiterStore();
|
|
639
|
+
|
|
640
|
+
let closed = false;
|
|
641
|
+
|
|
642
|
+
/** Gracefully close the Redis connection; idempotent. Falls back to disconnect() on error. */
|
|
643
|
+
export async function closeRedis() {
|
|
644
|
+
if (closed) return;
|
|
645
|
+
try {
|
|
646
|
+
await ioredis.quit();
|
|
647
|
+
} catch (error) {
|
|
648
|
+
ioredis.disconnect();
|
|
649
|
+
throw error;
|
|
650
|
+
} finally {
|
|
651
|
+
closed = true;
|
|
652
|
+
}
|
|
653
|
+
}
|
|
654
|
+
`)}async function vi(e){await l(`${e.projectDir}/packages/runtime/src/mutex.ts`,`import { Mutex } from "redis-semaphore";
|
|
655
|
+
import { redis } from "./redis";
|
|
656
|
+
|
|
657
|
+
export class MutexTimeoutError extends Error {
|
|
658
|
+
constructor(key: string) {
|
|
659
|
+
super(\`Failed to acquire mutex for key: \${key}\`);
|
|
660
|
+
this.name = "MutexTimeoutError";
|
|
661
|
+
}
|
|
662
|
+
}
|
|
663
|
+
|
|
664
|
+
/**
|
|
665
|
+
* Execute \`fn\` while holding a distributed mutex on \`key\`. Backed by
|
|
666
|
+
* \`redis-semaphore\`, which uses Lua scripts for atomic compare-and-delete
|
|
667
|
+
* on release and supports lock refresh for long-running operations.
|
|
668
|
+
*/
|
|
669
|
+
export async function withMutex<T>(
|
|
670
|
+
key: string,
|
|
671
|
+
fn: () => Promise<T>,
|
|
672
|
+
options?: { lockTimeout?: number; acquireTimeout?: number }
|
|
673
|
+
): Promise<T> {
|
|
674
|
+
const mutex = new Mutex(redis, key, {
|
|
675
|
+
lockTimeout: options?.lockTimeout ?? 10_000,
|
|
676
|
+
acquireAttemptsLimit: 10,
|
|
677
|
+
retryInterval: 500
|
|
678
|
+
});
|
|
679
|
+
|
|
680
|
+
const acquired = await mutex.tryAcquire();
|
|
681
|
+
if (!acquired) {
|
|
682
|
+
throw new MutexTimeoutError(key);
|
|
683
|
+
}
|
|
684
|
+
|
|
685
|
+
try {
|
|
686
|
+
return await fn();
|
|
687
|
+
} finally {
|
|
688
|
+
await mutex.release();
|
|
689
|
+
}
|
|
690
|
+
}
|
|
691
|
+
`)}async function Si(e){await l(`${e.projectDir}/packages/runtime/src/redis.ts`,`import { Redis } from "@upstash/redis";
|
|
692
|
+
import type { Store } from "hono-rate-limiter";
|
|
693
|
+
import { env } from "./env";
|
|
694
|
+
|
|
695
|
+
/** Options for \`redis.cacheSet\`. */
|
|
696
|
+
export interface CacheSetOptions {
|
|
697
|
+
/** TTL in seconds (SET EX). Mutually exclusive with \`ttlMilliseconds\`. */
|
|
698
|
+
ttlSeconds?: number;
|
|
699
|
+
/** TTL in milliseconds (SET PX). Mutually exclusive with \`ttlSeconds\`. */
|
|
700
|
+
ttlMilliseconds?: number;
|
|
701
|
+
/** Only set if the key does not already exist (SET NX). */
|
|
702
|
+
ifNotExists?: boolean;
|
|
703
|
+
}
|
|
704
|
+
|
|
705
|
+
/**
|
|
706
|
+
* Three small helpers extended onto the native \`redis\` client for the SDK
|
|
707
|
+
* methods whose signatures differ between ioredis and Upstash. Use these in
|
|
708
|
+
* your own code when you want a uniform API; everything else on \`redis\` is
|
|
709
|
+
* the native Upstash surface (or ioredis, on that backend) \u2014 use those
|
|
710
|
+
* directly with their native syntax.
|
|
711
|
+
*/
|
|
712
|
+
export interface BoilerplateRedisHelpers {
|
|
713
|
+
/** SET with optional TTL and NX in one call. Returns \`true\` if stored, \`false\` only when \`ifNotExists\` was set and the key already existed. */
|
|
714
|
+
cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean>;
|
|
715
|
+
/** GET typed as \`string | null\`. Pairs with \`automaticDeserialization: false\` for consistent string round-trip. */
|
|
716
|
+
cacheGet(key: string): Promise<string | null>;
|
|
717
|
+
/** Iterate keys matching a glob pattern via SCAN. Yields each key as it's discovered. */
|
|
718
|
+
cacheScan(opts: { match: string; count?: number }): AsyncIterable<string>;
|
|
719
|
+
}
|
|
720
|
+
|
|
721
|
+
/**
|
|
722
|
+
* \`automaticDeserialization: false\` makes get/set round-trip raw strings so
|
|
723
|
+
* the boilerplate's \`JSON.stringify(...)\` / \`JSON.parse(...)\` pattern works
|
|
724
|
+
* the same way it does on ioredis. Flip this to \`true\` (the SDK default) if
|
|
725
|
+
* you want Upstash to auto-parse JSON values on \`get\`.
|
|
726
|
+
*/
|
|
727
|
+
const upstash = new Redis({
|
|
728
|
+
url: env.UPSTASH_REDIS_REST_URL,
|
|
729
|
+
token: env.UPSTASH_REDIS_REST_TOKEN,
|
|
730
|
+
automaticDeserialization: false
|
|
731
|
+
});
|
|
732
|
+
|
|
733
|
+
/**
|
|
734
|
+
* Native Upstash REST client + the three boilerplate helpers. Every native
|
|
735
|
+
* Upstash method (\`zadd\`, \`hset\`, \`json.*\`, \`eval\`, etc.) is available
|
|
736
|
+
* directly on this object \u2014 see Upstash's docs for usage. The three
|
|
737
|
+
* \`cache*\` helpers cover the SDK calls whose signatures differ between
|
|
738
|
+
* Upstash and ioredis.
|
|
739
|
+
*/
|
|
740
|
+
export const redis: Redis & BoilerplateRedisHelpers = Object.assign(upstash, {
|
|
741
|
+
async cacheSet(key: string, value: string, opts?: CacheSetOptions): Promise<boolean> {
|
|
742
|
+
if (!opts) {
|
|
743
|
+
const result = await upstash.set(key, value);
|
|
744
|
+
return result === "OK";
|
|
745
|
+
}
|
|
746
|
+
const upstashOpts: Record<string, unknown> = {};
|
|
747
|
+
if (opts.ttlSeconds !== undefined) upstashOpts.ex = opts.ttlSeconds;
|
|
748
|
+
if (opts.ttlMilliseconds !== undefined) upstashOpts.px = opts.ttlMilliseconds;
|
|
749
|
+
if (opts.ifNotExists) upstashOpts.nx = true;
|
|
750
|
+
const result =
|
|
751
|
+
Object.keys(upstashOpts).length === 0
|
|
752
|
+
? await upstash.set(key, value)
|
|
753
|
+
: await upstash.set(key, value, upstashOpts);
|
|
754
|
+
return result === "OK";
|
|
755
|
+
},
|
|
756
|
+
async cacheGet(key: string): Promise<string | null> {
|
|
757
|
+
return upstash.get<string>(key);
|
|
758
|
+
},
|
|
759
|
+
async *cacheScan(opts: { match: string; count?: number }): AsyncIterable<string> {
|
|
760
|
+
let cursor = "0";
|
|
761
|
+
do {
|
|
762
|
+
const [next, keys] = await upstash.scan(cursor, opts);
|
|
763
|
+
for (const k of keys) yield k;
|
|
764
|
+
cursor = next;
|
|
765
|
+
} while (cursor !== "0");
|
|
766
|
+
}
|
|
767
|
+
});
|
|
768
|
+
|
|
769
|
+
/**
|
|
770
|
+
* Rate-limit store compatible with \`hono-rate-limiter\`, backed by Upstash Redis.
|
|
771
|
+
* Uses atomic INCR + PEXPIRE for a simple sliding-window counter. Returned as
|
|
772
|
+
* a plain object matching \`Store\` so no unsafe type cast is needed.
|
|
773
|
+
*/
|
|
774
|
+
function createLimiterStore(): Store {
|
|
775
|
+
let windowMs = 60_000;
|
|
776
|
+
return {
|
|
777
|
+
init(options: { windowMs: number }): void {
|
|
778
|
+
windowMs = options.windowMs;
|
|
779
|
+
},
|
|
780
|
+
async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {
|
|
781
|
+
const totalHits = await upstash.incr(key);
|
|
782
|
+
if (totalHits === 1) {
|
|
783
|
+
await upstash.pexpire(key, windowMs);
|
|
784
|
+
}
|
|
785
|
+
const ttl = await upstash.pttl(key);
|
|
786
|
+
return {
|
|
787
|
+
totalHits,
|
|
788
|
+
resetTime: new Date(Date.now() + Math.max(0, ttl))
|
|
789
|
+
};
|
|
790
|
+
},
|
|
791
|
+
async decrement(key: string): Promise<void> {
|
|
792
|
+
await upstash.decr(key);
|
|
793
|
+
},
|
|
794
|
+
async resetKey(key: string): Promise<void> {
|
|
795
|
+
await upstash.del(key);
|
|
796
|
+
}
|
|
797
|
+
};
|
|
798
|
+
}
|
|
641
799
|
|
|
642
|
-
const
|
|
643
|
-
if (!parsed.success) throw new Error("DATABASE_URL is not set or invalid");
|
|
800
|
+
export const limiterStore: Store = createLimiterStore();
|
|
644
801
|
|
|
645
|
-
|
|
646
|
-
export
|
|
802
|
+
/** No persistent connection to close with Upstash REST. */
|
|
803
|
+
export async function closeRedis(): Promise<void> {}
|
|
804
|
+
`)}async function Ei(e){await l(`${e.projectDir}/packages/runtime/src/mutex.ts`,`import { Lock } from "@upstash/lock";
|
|
805
|
+
import { redis } from "./redis";
|
|
647
806
|
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
POSTGRES_USER: postgres
|
|
655
|
-
POSTGRES_PASSWORD: postgres
|
|
656
|
-
POSTGRES_DB: saas
|
|
657
|
-
PGDATA: /var/lib/postgresql/data
|
|
658
|
-
volumes:
|
|
659
|
-
- postgres_data:/var/lib/postgresql/data
|
|
660
|
-
healthcheck:
|
|
661
|
-
test: ["CMD-SHELL", "pg_isready -U postgres"]
|
|
662
|
-
interval: 5s
|
|
663
|
-
timeout: 5s
|
|
664
|
-
retries: 5`),n.push(" postgres_data:")),t.includes("redis")&&(r.push(` redis:
|
|
665
|
-
image: redis:8-alpine
|
|
666
|
-
ports:
|
|
667
|
-
- "\${REDIS_PORT:-6379}:6379"
|
|
668
|
-
volumes:
|
|
669
|
-
- redis_data:/data
|
|
670
|
-
healthcheck:
|
|
671
|
-
test: ["CMD", "redis-cli", "ping"]
|
|
672
|
-
interval: 5s
|
|
673
|
-
timeout: 5s
|
|
674
|
-
retries: 5`),n.push(" redis_data:")),t.includes("mailpit")&&r.push(` mailpit:
|
|
675
|
-
image: axllent/mailpit
|
|
676
|
-
ports:
|
|
677
|
-
- "\${MAILPIT_SMTP_PORT:-1025}:1025"
|
|
678
|
-
- "\${MAILPIT_UI_PORT:-8025}:8025"
|
|
679
|
-
environment:
|
|
680
|
-
MP_SMTP_AUTH_ACCEPT_ANY: 1
|
|
681
|
-
MP_SMTP_AUTH_ALLOW_INSECURE: 1`),t.includes("inngest")&&r.push(` inngest:
|
|
682
|
-
image: inngest/inngest:v1.17.4
|
|
683
|
-
ports:
|
|
684
|
-
- "\${INNGEST_PORT:-8288}:8288"
|
|
685
|
-
command: inngest dev`);let i=`services:
|
|
686
|
-
${r.join(`
|
|
807
|
+
export class MutexTimeoutError extends Error {
|
|
808
|
+
constructor(key: string) {
|
|
809
|
+
super(\`Failed to acquire mutex for key: \${key}\`);
|
|
810
|
+
this.name = "MutexTimeoutError";
|
|
811
|
+
}
|
|
812
|
+
}
|
|
687
813
|
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
814
|
+
/**
|
|
815
|
+
* Execute \`fn\` while holding a distributed mutex on \`key\`. Backed by
|
|
816
|
+
* \`@upstash/lock\`, Upstash's official distributed-lock library \u2014 uses
|
|
817
|
+
* Lua EVAL for atomic compare-and-delete on release (no TOCTOU race) and
|
|
818
|
+
* exposes \`extend()\` for long-running operations (not wired here; pick a
|
|
819
|
+
* generous \`lockTimeout\` if you need it).
|
|
820
|
+
*/
|
|
821
|
+
export async function withMutex<T>(
|
|
822
|
+
key: string,
|
|
823
|
+
fn: () => Promise<T>,
|
|
824
|
+
options?: { lockTimeout?: number; acquireTimeout?: number }
|
|
825
|
+
): Promise<T> {
|
|
826
|
+
const lockTimeout = options?.lockTimeout ?? 10_000;
|
|
827
|
+
const acquireTimeout = options?.acquireTimeout ?? 5_000;
|
|
828
|
+
const retryDelay = 500;
|
|
829
|
+
const attempts = Math.max(1, Math.ceil(acquireTimeout / retryDelay));
|
|
696
830
|
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
831
|
+
const lock = new Lock({
|
|
832
|
+
id: \`mutex:\${key}\`,
|
|
833
|
+
lease: lockTimeout,
|
|
834
|
+
redis,
|
|
835
|
+
retry: { attempts, delay: retryDelay }
|
|
701
836
|
});
|
|
702
|
-
logger.info(\`[API] Listening on port \${env.API_PORT}\`);
|
|
703
837
|
|
|
704
|
-
const
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
} catch (err) {
|
|
709
|
-
logger.error("[Backend] Redis close error during shutdown", err);
|
|
710
|
-
}
|
|
711
|
-
apiServer.close(() => {
|
|
712
|
-
process.exit(0);
|
|
713
|
-
});
|
|
714
|
-
};
|
|
838
|
+
const acquired = await lock.acquire();
|
|
839
|
+
if (!acquired) {
|
|
840
|
+
throw new MutexTimeoutError(key);
|
|
841
|
+
}
|
|
715
842
|
|
|
716
|
-
|
|
717
|
-
|
|
843
|
+
try {
|
|
844
|
+
return await fn();
|
|
845
|
+
} finally {
|
|
846
|
+
await lock.release();
|
|
847
|
+
}
|
|
718
848
|
}
|
|
719
|
-
|
|
720
|
-
bootstrap().catch((error) => {
|
|
721
|
-
logger.error("[Backend] Fatal error", error);
|
|
722
|
-
process.exit(1);
|
|
723
|
-
});
|
|
724
|
-
`)}var ci={smtp:[{key:"SMTP_HOST",defaultValue:"localhost"},{key:"SMTP_PORT",defaultValue:"1025"}],ses:[{key:"AMAZON_SES_REGION",comment:"# TODO: Configure Amazon SES credentials (e.g. us-east-1)"},{key:"AMAZON_SES_KEY"},{key:"AMAZON_SES_SECRET"}],resend:[{key:"RESEND_API_KEY",comment:"# TODO: Add your Resend API key"}]};function li(e){let t=q[e];return t.envVars.map((r,n)=>({key:r.name,...n===0?{comment:`# TODO: Add your ${t.label} OAuth credentials`}:{}}))}var pi={stripe:[{key:"STRIPE_SECRET_KEY",comment:"# TODO: Add your Stripe keys"},{key:"STRIPE_WEBHOOK_SECRET"}],polar:[{key:"POLAR_ACCESS_TOKEN",comment:"# TODO: Add your Polar keys"},{key:"POLAR_WEBHOOK_SECRET"}]};function Ee(e,t){return t?e.map(r=>{let n=t[r.key];return n?{...r,defaultValue:n,comment:void 0}:r}):e}function we(e,t){for(let r of e)r.comment&&t.push(r.comment),r.defaultValue!==void 0?t.push(`${r.key}=${r.defaultValue}`):t.push(`#${r.key}=`)}function Tt(e){return Array.from(crypto.getRandomValues(new Uint8Array(e))).map(t=>t.toString(16).padStart(2,"0")).join("")}function pr(e){return e.architecture==="fullstack"?{apiUrl:"http://localhost:3000/api",baseUrl:"http://localhost:3000"}:{apiUrl:"http://localhost:3010",baseUrl:"http://localhost:3000"}}function di(e){let{architecture:t,deploymentTarget:r}=e;return t==="fullstack"?r==="vercel"?{frontend:"https://your-app.vercel.app",backend:"https://your-app.vercel.app"}:r==="node"?{frontend:"https://your-app.example.com",backend:"https://your-app.example.com"}:null:{frontend:"https://your-app.example.com",backend:"https://your-app.example.com/api"}}function ct(e,t,r,n){e.push(n==="example"?`${t}=`:`${t}=${r}`)}function lr(e,t){let r=t==="example"?void 0:e.credentials,{apiUrl:n,baseUrl:i}=pr(e),o=["# API Configuration",`API_URL=${n}`,`BASE_URL=${i}`];o.push("","# Database"),we(Ee(D[e.databaseProvider].envVars,r),o),o.push("","# Cache"),we(Ee(B[e.cacheProvider].envVars,r),o),o.push("","# Authentication"),t==="example"&&o.push("# Generate a strong secret, e.g. `openssl rand -hex 32`"),ct(o,"BETTER_AUTH_SECRET",crypto.randomUUID(),t),o.push("","# Content API (random secret; required when contentApi feature is enabled in @repo/config)"),ct(o,"CONTENT_API_KEY",Tt(32),t),o.push("","# Job Queue - Inngest","INNGEST_APP_ID=api"),ct(o,"INNGEST_EVENT_KEY",Tt(32),t),ct(o,"INNGEST_SIGNING_KEY",Tt(32),t),o.push("INNGEST_BASE_URL=http://127.0.0.1:8288"),e.architecture==="separate"&&(o.push("","# API Port (standalone backend)","API_PORT=3010"),o.push("","# CORS + cross-subdomain cookies (production only \u2014 leave unset for local dev)","# TRUSTED_ORIGINS=https://your-app.example.com","# AUTH_COOKIE_DOMAIN=.example.com"));let s=ci[e.emailProvider];if(s&&(o.push("","# Email"),we(Ee(s,r),o)),e.paymentProvider!=="none"){let a=pi[e.paymentProvider];a&&(o.push("","# Payment"),we(Ee(a,r),o))}if(e.socialProviders.length>0){o.push("","# Social auth");for(let a of e.socialProviders)we(Ee(li(a),r),o)}return e.demo&&(o.push("","# Captcha (Cloudflare Turnstile)"),we(Ee([{key:"TURNSTILE_SECRET_KEY",comment:"# TODO: Add your Cloudflare Turnstile secret key"}],r),o)),o.push(""),o.join(`
|
|
725
|
-
`)}function ui(e){let{apiUrl:t}=pr(e),r=e.frontend==="nextjs"?"NEXT_PUBLIC_API_URL":"NUXT_PUBLIC_API_URL",n=["# API Configuration",`${r}=${t}`],i=di(e);return i&&e.architecture==="separate"&&n.push("","# Production (uncomment and replace with your deployed hostnames):",`# ${r}=${i.backend}`),n.push(""),n.join(`
|
|
726
|
-
`)}async function dr(e){let t=ui(e);await l(`${e.projectDir}/.env`,t+`
|
|
727
|
-
`+lr(e,"env")),await l(`${e.projectDir}/.env.example`,t+`
|
|
728
|
-
`+lr(e,"example"))}import{join as mr,relative as fi}from"path";import{createHash as ur}from"crypto";import{readFile as mi}from"fs/promises";async function lt(e){let t=await mi(e);return ur("sha256").update(t).digest("hex")}function At(e){return ur("sha256").update(e).digest("hex")}var gi=new Set(["data",N]);function hi(e){let t=e.split("/");for(let r of t)if(wt.has(r)||gi.has(r)||r.startsWith(".env")&&!r.includes("example"))return!0;return!1}async function fr(e,t){let n=(await de(e.projectDir,e.projectDir,hi)).sort(),i=await Promise.all(n.map(async a=>[fi(e.projectDir,a),await lt(a)])),o=Object.fromEntries(i),s={version:e.version,initialVersion:e.version,repo:"Duzbee/GenerateSaaS",frontend:e.frontend,architecture:e.architecture,aiTools:e.aiTools,deploymentTarget:e.deploymentTarget,databaseProvider:e.databaseProvider,cacheProvider:e.cacheProvider,revenueSharing:e.revenueSharing,...t&&{licenseToken:t.token,licenseKeyHash:t.keyHash,installId:t.installId}};await l(mr(e.projectDir,ee),JSON.stringify(s,null," ")+`
|
|
729
|
-
`),await l(mr(e.projectDir,Ht),JSON.stringify(o,null," ")+`
|
|
730
|
-
`)}import{readFile as yi}from"fs/promises";import{join as K}from"path";var pt={"@upstash/redis":"^1.37.0","@upstash/lock":"^0.2.1","@neondatabase/serverless":"^1.0.1",postgres:"^3.4.7"};async function Ie(e){let t=await yi(e,"utf-8");return JSON.parse(t)}async function Te(e,t){await l(e,JSON.stringify(t,null," ")+`
|
|
731
|
-
`)}function je(e,t){for(let r of t)delete e.dependencies?.[r],delete e.devDependencies?.[r]}function be(e,t,r,n=!1){let i=n?"devDependencies":"dependencies";e[i]||(e[i]={}),e[i][t]=r}async function gr(e){await vi(e),await Si(e),await Ei(e),await wi(e),e.frontend==="nextjs"?await Ii(e):await bi(e)}async function vi(e){let t=K(e.projectDir,"packages/api/package.json"),r=await Ie(t);je(r,["sharp","@types/sharp"]),await Te(t,r)}async function Si(e){let t=K(e.projectDir,"packages/runtime/package.json"),r=await Ie(t);e.cacheProvider==="upstash"&&(je(r,["ioredis","rate-limit-redis","redis-semaphore"]),be(r,"@upstash/redis",pt["@upstash/redis"]),be(r,"@upstash/lock",pt["@upstash/lock"])),await Te(t,r)}async function Ei(e){let t=K(e.projectDir,"packages/database/package.json"),r=await Ie(t);e.databaseProvider==="neon"?(je(r,["pg","@types/pg"]),be(r,"@neondatabase/serverless",pt["@neondatabase/serverless"])):e.databaseProvider==="supabase"&&(je(r,["pg","@types/pg"]),be(r,"postgres",pt.postgres)),await Te(t,r)}async function wi(e){if(e.architecture!=="separate")return;let t=K(e.projectDir,"apps/backend/package.json"),r=await Ie(t);e.deploymentTarget!=="node"&&je(r,["@hono/node-server"]),await Te(t,r)}async function bi(e){if(e.architecture!=="separate")return;let t=K(e.projectDir,"apps/web-nuxt");await bt(K(t,"server/api/[...paths].ts"),t);let r=K(t,"package.json"),n=await Ie(r),i=n.dependencies?.["@repo/api"];i&&(delete n.dependencies?.["@repo/api"],be(n,"@repo/api",i,!0)),await Te(r,n)}async function Ii(e){if(e.architecture!=="separate")return;let t=K(e.projectDir,"apps/web-next");await bt(K(t,"app/api/[[...rest]]/route.ts"),t);let r=K(t,"package.json"),n=await Ie(r),i=n.dependencies?.["@repo/api"];i&&(delete n.dependencies?.["@repo/api"],be(n,"@repo/api",i,!0)),await Te(r,n)}import{readdir as Ti,readFile as hr,rm as dt}from"fs/promises";import{join as ue}from"path";var Ai=new Set(["ci.yml"]),ki=["cli","cli:clean","translate","demo:bench","playground:regen","playground:test","playground:test:units"];async function yr(e){let t=ue(e.projectDir,".github/workflows"),r=await Ti(t).catch(()=>[]);for(let n of r)Ai.has(n)||await dt(ue(t,n),{recursive:!0,force:!0})}async function vr(e){let t=ue(e.projectDir,"package.json"),r=await hr(t,"utf-8"),n=JSON.parse(r),i=!1;if(n.scripts){for(let o of ki)o in n.scripts&&(delete n.scripts[o],i=!0);if(n.scripts.prepare==="simple-git-hooks"&&(delete n.scripts.prepare,i=!0),!Ye(e))for(let o of["infra","infra:stop"])o in n.scripts&&(delete n.scripts[o],i=!0)}n["simple-git-hooks"]&&(delete n["simple-git-hooks"],i=!0),n.devDependencies?.["simple-git-hooks"]&&(delete n.devDependencies["simple-git-hooks"],i=!0),i&&await l(t,JSON.stringify(n,null," ")+`
|
|
732
|
-
`),await _i(e.projectDir)}async function _i(e){let t=ue(e,"pnpm-workspace.yaml"),r;try{r=await hr(t,"utf-8")}catch{return}let n=r.split(`
|
|
733
|
-
`),i=n.filter(o=>!/^\s*['"]?simple-git-hooks['"]?\s*:/.test(o));i.length!==n.length&&await l(t,i.join(`
|
|
734
|
-
`))}async function Sr(e){let t=e.frontend==="nextjs"?"apps/web-nuxt":"apps/web-next";await dt(ue(e.projectDir,t),{recursive:!0,force:!0})}async function Er(e){e.docs||await dt(ue(e.projectDir,"apps/docs"),{recursive:!0})}async function wr(e){let t=e.frontend==="nextjs"?"docs/nuxt":"docs/next";await dt(ue(e.projectDir,t),{recursive:!0,force:!0})}import{readFile as br}from"fs/promises";import{existsSync as Ri}from"fs";import{join as kt}from"path";var Ir="@repo/database";function Pi(e){return e?"pnpm -F @repo/database reset && pnpm -F @repo/database push --force":"pnpm -F @repo/database migrate"}function Oi(e,t){switch(e){case"fullstack":return t==="nextjs"?"web-next":"web-nuxt";case"separate":return"backend";default:{let r=e;throw new Error(`schemaOwnerApp: unhandled architecture "${String(r)}"`)}}}async function Di(e,t,r){let n=await br(e,"utf-8"),i=JSON.parse(n),o=i.scripts?.[t];if(!o)throw new Error(`Cannot prepend to missing script "${t}" in ${e}`);o.includes(Ir)||(i.scripts={...i.scripts,[t]:`${r} && ${o}`},await l(e,JSON.stringify(i,null," ")+`
|
|
735
|
-
`))}async function xi(e,t){let r=Ri(e)?JSON.parse(await br(e,"utf-8")):{$schema:"https://openapi.vercel.sh/vercel.json"},n=r.buildCommand?.trim()||"pnpm build";n.includes(Ir)||(r.buildCommand=`${t} && ${n}`,await l(e,JSON.stringify(r,null," ")+`
|
|
736
|
-
`))}async function Tr(e){let t=Pi(e.demo===!0),r=Oi(e.architecture,e.frontend),n=kt(e.projectDir,"apps",r);switch(e.deploymentTarget){case"node":await Di(kt(n,"package.json"),"start",t);return;case"vercel":await xi(kt(n,"vercel.json"),t);return;default:{let i=e.deploymentTarget;throw new Error(`generateDeployScripts: unhandled deployment target "${String(i)}"`)}}}async function Ar(e){await l(`${e.projectDir}/packages/runtime/src/env.ts`,Ci(e))}function Ci(e){return`import { z } from "zod";
|
|
849
|
+
`)}async function yr(e){await l(`${e.projectDir}/packages/runtime/src/env.ts`,wi(e))}function wi(e){return`import { z } from "zod";
|
|
737
850
|
|
|
738
851
|
const EnvSchema = z.object({
|
|
739
852
|
NODE_ENV: z.enum(["development", "production"]).default("development"),
|
|
@@ -851,14 +964,17 @@ export const env = (() => {
|
|
|
851
964
|
const parsedApiUrl = new URL(env.API_URL);
|
|
852
965
|
export const apiBasePath = parsedApiUrl.pathname === "/" ? "" : parsedApiUrl.pathname;
|
|
853
966
|
export const apiOrigin = parsedApiUrl.origin;
|
|
854
|
-
`}import{readFile as
|
|
855
|
-
`);let
|
|
967
|
+
`}import{readFile as bi}from"fs/promises";import{join as K}from"path";var lt={"@upstash/redis":"^1.37.0","@upstash/lock":"^0.2.1","@neondatabase/serverless":"^1.0.1",postgres:"^3.4.7"};async function Te(e){let t=await bi(e,"utf-8");return JSON.parse(t)}async function Ie(e,t){await l(e,JSON.stringify(t,null," ")+`
|
|
968
|
+
`)}function Ue(e,t){for(let r of t)delete e.dependencies?.[r],delete e.devDependencies?.[r]}function be(e,t,r,i=!1){let n=i?"devDependencies":"dependencies";e[n]||(e[n]={}),e[n][t]=r}async function vr(e){await Ti(e),await Ii(e),await Ai(e),await ki(e),e.frontend==="nextjs"?await _i(e):await Pi(e)}async function Ti(e){let t=K(e.projectDir,"packages/api/package.json"),r=await Te(t);Ue(r,["sharp","@types/sharp"]),await Ie(t,r)}async function Ii(e){let t=K(e.projectDir,"packages/runtime/package.json"),r=await Te(t);e.cacheProvider==="upstash"&&(Ue(r,["ioredis","rate-limit-redis","redis-semaphore"]),be(r,"@upstash/redis",lt["@upstash/redis"]),be(r,"@upstash/lock",lt["@upstash/lock"])),await Ie(t,r)}async function Ai(e){let t=K(e.projectDir,"packages/database/package.json"),r=await Te(t);e.databaseProvider==="neon"?(Ue(r,["pg","@types/pg"]),be(r,"@neondatabase/serverless",lt["@neondatabase/serverless"])):e.databaseProvider==="supabase"&&(Ue(r,["pg","@types/pg"]),be(r,"postgres",lt.postgres)),await Ie(t,r)}async function ki(e){if(e.architecture!=="separate")return;let t=K(e.projectDir,"apps/backend/package.json"),r=await Te(t);e.deploymentTarget!=="node"&&Ue(r,["@hono/node-server"]),await Ie(t,r)}async function Pi(e){if(e.architecture!=="separate")return;let t=K(e.projectDir,"apps/web-nuxt");await Tt(K(t,"server/api/[...paths].ts"),t);let r=K(t,"package.json"),i=await Te(r),n=i.dependencies?.["@repo/api"];n&&(delete i.dependencies?.["@repo/api"],be(i,"@repo/api",n,!0)),await Ie(r,i)}async function _i(e){if(e.architecture!=="separate")return;let t=K(e.projectDir,"apps/web-next");await Tt(K(t,"app/api/[[...rest]]/route.ts"),t);let r=K(t,"package.json"),i=await Te(r),n=i.dependencies?.["@repo/api"];n&&(delete i.dependencies?.["@repo/api"],be(i,"@repo/api",n,!0)),await Ie(r,i)}import{readFile as Er}from"fs/promises";import{join as wr}from"path";async function br(e){let t=wr(e.projectDir,"turbo.json"),r;try{r=await Er(t,"utf-8")}catch{return}let i=JSON.parse(r),n=i.tasks?.build;if(!n)return;let o=e.frontend==="nextjs"?"NUXT_PUBLIC_*":"NEXT_PUBLIC_*",s=e.frontend==="nextjs"?new Set([".nuxt/**",".output/**"]):new Set([".next/**","!.next/cache/**"]),a=!1;if(Array.isArray(n.env)){let d=n.env.filter(g=>g!==o);d.length!==n.env.length&&(n.env=d,a=!0)}if(Array.isArray(n.outputs)){let d=n.outputs.filter(g=>!s.has(g));d.length!==n.outputs.length&&(n.outputs=d,a=!0)}a&&await l(t,JSON.stringify(i,null," ")+`
|
|
969
|
+
`)}var Ri=["base.json","node.json","next.json"],Sr="GenerateSaaS ";async function Tr(e){if(!e.demo)for(let t of Ri){let r=wr(e.projectDir,"tooling/typescript",t),i;try{i=await Er(r,"utf-8")}catch{continue}let n=JSON.parse(i);typeof n.display!="string"||!n.display.startsWith(Sr)||(n.display=n.display.slice(Sr.length),await l(r,JSON.stringify(n,null," ")+`
|
|
970
|
+
`))}}import{readFile as Oi,rm as Di}from"fs/promises";import{existsSync as Ir}from"fs";import{join as Ar}from"path";async function kr(e){if(e.frontend==="nuxt")return;let t=Ar(e.projectDir,"packages/i18n/package.json");if(!Ir(t))throw new Error(`pruneI18nNuxt: expected ${t} to exist \u2014 did the i18n package move?`);let r=JSON.parse(await Oi(t,"utf-8")),i=!!(r.exports?.["./module"]??r.exports?.["./nuxt"]),n=!1;if(r.exports)for(let s of["./module","./nuxt"])s in r.exports&&(delete r.exports[s],n=!0);r.devDependencies&&"@nuxt/kit"in r.devDependencies&&(delete r.devDependencies["@nuxt/kit"],n=!0),n&&await l(t,JSON.stringify(r,null," ")+`
|
|
971
|
+
`);let o=Ar(e.projectDir,"packages/i18n/nuxt");if(i&&!Ir(o))throw new Error(`pruneI18nNuxt: packages/i18n declares a Nuxt export surface but ${o} is missing \u2014 did the i18n Nuxt module move?`);await Di(o,{recursive:!0,force:!0})}import{readFile as Pr,rm as xi}from"fs/promises";import{join as Pt}from"path";async function _r(e){e.cacheProvider==="upstash"&&await Promise.all([Ci(e.projectDir),Ni(e.projectDir),xi(Pt(e.projectDir,"packages/runtime/tests/redis.test.ts"),{force:!0})])}async function Ci(e){let t=Pt(e,"packages/runtime/tests/setup.ts"),r;try{r=await Pr(t,"utf-8")}catch{return}let i=r.replace(/\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
856
972
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
857
|
-
`);
|
|
973
|
+
`);i!==r&&await l(t,i)}async function Ni(e){let t=Pt(e,"packages/api/tests/setup.ts"),r;try{r=await Pr(t,"utf-8")}catch{return}let i=r;i=i.replace(/\tREDIS_URL:\s*"[^"]*",?\n/g,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
858
974
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
859
|
-
`),
|
|
975
|
+
`),i=i.replace(/vi\.mock\("ioredis"[\s\S]*?\n\}\);\n\n?/,""),i=i.replace(/vi\.mock\("rate-limit-redis"[\s\S]*?\n\}\);\n\n?/,""),i=i.replace(/\t\t\tREDIS_URL:\s*"[^"]*",?\n/,` UPSTASH_REDIS_REST_URL: "https://test.upstash.io",
|
|
860
976
|
UPSTASH_REDIS_REST_TOKEN: "test-token",
|
|
861
|
-
`),
|
|
977
|
+
`),i=i.replace(/(^vi\.mock\("@repo\/runtime")/m,`vi.mock("@upstash/redis", () => {
|
|
862
978
|
class Redis {
|
|
863
979
|
get = vi.fn().mockResolvedValue(null);
|
|
864
980
|
set = vi.fn().mockResolvedValue("OK");
|
|
@@ -875,7 +991,10 @@ vi.mock("@upstash/lock", () => {
|
|
|
875
991
|
return { Lock };
|
|
876
992
|
});
|
|
877
993
|
|
|
878
|
-
$1`),
|
|
994
|
+
$1`),i!==r&&await l(t,i)}import{readdir as Li,readFile as Rr,rm as pt}from"fs/promises";import{join as me}from"path";var $i=new Set(["ci.yml"]),Ui=["cli","cli:clean","translate","demo:bench","playground:regen","playground:test","playground:test:units"];async function Or(e){let t=me(e.projectDir,".github/workflows"),r=await Li(t).catch(()=>[]);for(let i of r)$i.has(i)||await pt(me(t,i),{recursive:!0,force:!0})}async function Dr(e){let t=me(e.projectDir,"package.json"),r=await Rr(t,"utf-8"),i=JSON.parse(r),n=!1;if(i.scripts){for(let o of Ui)o in i.scripts&&(delete i.scripts[o],n=!0);if(i.scripts.prepare==="simple-git-hooks"&&(delete i.scripts.prepare,n=!0),!He(e))for(let o of["infra","infra:stop"])o in i.scripts&&(delete i.scripts[o],n=!0)}i["simple-git-hooks"]&&(delete i["simple-git-hooks"],n=!0),i.devDependencies?.["simple-git-hooks"]&&(delete i.devDependencies["simple-git-hooks"],n=!0),n&&await l(t,JSON.stringify(i,null," ")+`
|
|
995
|
+
`),await ji(e.projectDir)}async function ji(e){let t=me(e,"pnpm-workspace.yaml"),r;try{r=await Rr(t,"utf-8")}catch{return}let i=r.split(`
|
|
996
|
+
`),n=i.filter(o=>!/^\s*['"]?simple-git-hooks['"]?\s*:/.test(o));n.length!==i.length&&await l(t,n.join(`
|
|
997
|
+
`))}async function xr(e){let t=e.frontend==="nextjs"?"apps/web-nuxt":"apps/web-next";await pt(me(e.projectDir,t),{recursive:!0,force:!0})}async function Cr(e){e.docs||await pt(me(e.projectDir,"apps/docs"),{recursive:!0})}async function Nr(e){let t=e.frontend==="nextjs"?"docs/nuxt":"docs/next";await pt(me(e.projectDir,t),{recursive:!0,force:!0})}import{join as Mi}from"path";async function Lr(e){let t=Vi(e);await l(Mi(e.projectDir,".github/workflows/ci.yml"),t)}function Vi(e){let t=x[e.databaseProvider].managed,r=e.cacheProvider==="upstash",i=e.frontend==="nuxt",n=t?"":` services:
|
|
879
998
|
postgres:
|
|
880
999
|
image: postgres:18-alpine
|
|
881
1000
|
env:
|
|
@@ -895,8 +1014,8 @@ $1`),n!==r&&await l(t,n)}import{join as Mi}from"path";async function Dr(e){let t
|
|
|
895
1014
|
STRIPE_SECRET_KEY: test
|
|
896
1015
|
STRIPE_WEBHOOK_SECRET: test`;case"polar":return`
|
|
897
1016
|
POLAR_ACCESS_TOKEN: test
|
|
898
|
-
POLAR_WEBHOOK_SECRET: test`;case"none":return"";default:{let u=e.paymentProvider;throw new Error(`buildCiYaml: unhandled payment provider "${String(u)}"`)}}})(),d=e.socialProviders.map(u=>q[u].envVars.map(
|
|
899
|
-
${
|
|
1017
|
+
POLAR_WEBHOOK_SECRET: test`;case"none":return"";default:{let u=e.paymentProvider;throw new Error(`buildCiYaml: unhandled payment provider "${String(u)}"`)}}})(),d=e.socialProviders.map(u=>q[u].envVars.map(S=>`
|
|
1018
|
+
${S.name}: test`).join("")).join("");return`# Deployment is handled by the hosting platform (Vercel, Coolify, etc.)
|
|
900
1019
|
# which auto-deploys on push. CI runs in parallel as a quality gate.
|
|
901
1020
|
# For PR-based workflows, enable GitHub branch protection to require CI before merging.
|
|
902
1021
|
|
|
@@ -929,7 +1048,7 @@ jobs:
|
|
|
929
1048
|
steps:
|
|
930
1049
|
- uses: actions/checkout@v6
|
|
931
1050
|
- uses: ./.github/actions/setup
|
|
932
|
-
${
|
|
1051
|
+
${i?` # vue-tsc on web-nuxt OOMs on the GitHub runner's default heap once
|
|
933
1052
|
# the type graph (Nuxt + Pinia + vue-i18n + content collections)
|
|
934
1053
|
# crosses a threshold. Bump to 6 GB; ubuntu-latest has ~7 GB RAM.
|
|
935
1054
|
- run: pnpm check-types
|
|
@@ -940,7 +1059,7 @@ ${n?` # vue-tsc on web-nuxt OOMs on the GitHub runner's default heap once
|
|
|
940
1059
|
name: Test
|
|
941
1060
|
runs-on: ubuntu-latest
|
|
942
1061
|
timeout-minutes: 10
|
|
943
|
-
${
|
|
1062
|
+
${n} env:
|
|
944
1063
|
CONTENT_API_KEY: test-contentapi-key-16chars${s}${a}${d}
|
|
945
1064
|
STORAGE_REGION: test
|
|
946
1065
|
STORAGE_ENDPOINT: http://test
|
|
@@ -955,160 +1074,41 @@ ${i} env:
|
|
|
955
1074
|
run: echo "DATABASE_URL=${o}" > .env
|
|
956
1075
|
|
|
957
1076
|
- run: pnpm test
|
|
958
|
-
`}import{
|
|
959
|
-
`)
|
|
960
|
-
`).
|
|
961
|
-
`))}import{readFile as Hi}from"fs/promises";import{existsSync as Yi}from"fs";import{join as ut}from"path";var Ji=["stripe","polar"];async function Ur(e){let t=ut(e.projectDir,"packages/payments/src"),r=e.paymentProvider,n=`// Active payment provider. To switch, change the path below to
|
|
1077
|
+
`}import{readFile as $r}from"fs/promises";import{existsSync as Fi}from"fs";import{join as _t}from"path";var Ur="@repo/database";function Bi(e){return e?"pnpm -F @repo/database reset && pnpm -F @repo/database push --force":"pnpm -F @repo/database migrate"}function Gi(e,t){switch(e){case"fullstack":return t==="nextjs"?"web-next":"web-nuxt";case"separate":return"backend";default:{let r=e;throw new Error(`schemaOwnerApp: unhandled architecture "${String(r)}"`)}}}async function Ki(e,t,r){let i=await $r(e,"utf-8"),n=JSON.parse(i),o=n.scripts?.[t];if(!o)throw new Error(`Cannot prepend to missing script "${t}" in ${e}`);o.includes(Ur)||(n.scripts={...n.scripts,[t]:`${r} && ${o}`},await l(e,JSON.stringify(n,null," ")+`
|
|
1078
|
+
`))}async function zi(e,t){let r=Fi(e)?JSON.parse(await $r(e,"utf-8")):{$schema:"https://openapi.vercel.sh/vercel.json"},i=r.buildCommand?.trim()||"pnpm build";i.includes(Ur)||(r.buildCommand=`${t} && ${i}`,await l(e,JSON.stringify(r,null," ")+`
|
|
1079
|
+
`))}async function jr(e){let t=Bi(e.demo===!0),r=Gi(e.architecture,e.frontend),i=_t(e.projectDir,"apps",r);switch(e.deploymentTarget){case"node":await Ki(_t(i,"package.json"),"start",t);return;case"vercel":await zi(_t(i,"vercel.json"),t);return;default:{let n=e.deploymentTarget;throw new Error(`generateDeployScripts: unhandled deployment target "${String(n)}"`)}}}import{readFile as Hi}from"fs/promises";import{existsSync as Yi}from"fs";import{join as dt}from"path";var Ji=["stripe","polar"];async function Mr(e){let t=dt(e.projectDir,"packages/payments/src"),r=e.paymentProvider,i=`// Active payment provider. To switch, change the path below to
|
|
962
1080
|
// "./polar/index" or "./none/index" (other folders are kept in place).
|
|
963
1081
|
export { ops } from "./${r}/index";
|
|
964
|
-
`;await l(
|
|
965
|
-
`).filter(s=>!
|
|
966
|
-
`)}
|
|
967
|
-
`)
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
plans: [
|
|
973
|
-
{
|
|
974
|
-
id: "free",
|
|
975
|
-
type: "free",
|
|
976
|
-
name: "pricing.plans.plan_1.name",
|
|
977
|
-
description: "pricing.plans.plan_1.description",
|
|
978
|
-
features: [
|
|
979
|
-
"pricing.plans.plan_1.features.item_1",
|
|
980
|
-
"pricing.plans.plan_1.features.item_2",
|
|
981
|
-
"pricing.plans.plan_1.features.item_3",
|
|
982
|
-
"pricing.plans.plan_1.features.item_4"
|
|
983
|
-
],
|
|
984
|
-
prices: [
|
|
985
|
-
{
|
|
986
|
-
interval: "lifetime",
|
|
987
|
-
amounts: { ${r}: 0 }
|
|
988
|
-
}
|
|
989
|
-
],
|
|
990
|
-
apiRateLimit: { maxRequests: 100 }
|
|
991
|
-
}
|
|
992
|
-
],
|
|
993
|
-
credits: { enabled: false },
|
|
994
|
-
products: { enabled: false, items: [] }
|
|
995
|
-
};
|
|
996
|
-
`;await l(t,u);return}let n=e.paymentProvider,i=Wi(n),o=e.credits,s=Rt({credits:5,rateLimit:100,trial:!1,withCredits:o}),a=Rt({credits:10,rateLimit:1e3,trial:!0,withCredits:o}),d=Rt({credits:50,rateLimit:5e3,trial:!0,withCredits:o}),y=`import type { PricingConfig } from "@repo/config/types";
|
|
997
|
-
|
|
998
|
-
export const pricingConfig: PricingConfig = {
|
|
999
|
-
defaultPlan: "free",
|
|
1000
|
-
defaultApiRateLimit: { maxRequests: 100 },
|
|
1001
|
-
plans: [
|
|
1002
|
-
{
|
|
1003
|
-
id: "free",
|
|
1004
|
-
type: "free",
|
|
1005
|
-
name: "pricing.plans.plan_1.name",
|
|
1006
|
-
description: "pricing.plans.plan_1.description",
|
|
1007
|
-
features: [
|
|
1008
|
-
"pricing.plans.plan_1.features.item_1",
|
|
1009
|
-
"pricing.plans.plan_1.features.item_2",
|
|
1010
|
-
"pricing.plans.plan_1.features.item_3",
|
|
1011
|
-
"pricing.plans.plan_1.features.item_4"
|
|
1012
|
-
],
|
|
1013
|
-
limits: ["pricing.plans.plan_1.limits.item_1", "pricing.plans.plan_1.limits.item_2"],
|
|
1014
|
-
prices: [
|
|
1015
|
-
{
|
|
1016
|
-
interval: "lifetime",
|
|
1017
|
-
amounts: { ${r}: 0 }
|
|
1018
|
-
}
|
|
1019
|
-
],
|
|
1020
|
-
${s}
|
|
1021
|
-
},
|
|
1022
|
-
{
|
|
1023
|
-
id: "starter",
|
|
1024
|
-
type: "subscription",
|
|
1025
|
-
name: "pricing.plans.plan_2.name",
|
|
1026
|
-
description: "pricing.plans.plan_2.description",
|
|
1027
|
-
features: [
|
|
1028
|
-
"pricing.plans.plan_2.features.item_1",
|
|
1029
|
-
"pricing.plans.plan_2.features.item_2",
|
|
1030
|
-
"pricing.plans.plan_2.features.item_3",
|
|
1031
|
-
"pricing.plans.plan_2.features.item_4"
|
|
1032
|
-
],
|
|
1033
|
-
prices: [
|
|
1034
|
-
{
|
|
1035
|
-
${i}
|
|
1036
|
-
interval: "month",
|
|
1037
|
-
amounts: { ${r}: 9 }
|
|
1038
|
-
},
|
|
1039
|
-
{
|
|
1040
|
-
${i}
|
|
1041
|
-
interval: "year",
|
|
1042
|
-
amounts: { ${r}: 90 },
|
|
1043
|
-
anchorAmounts: { ${r}: 109 }
|
|
1044
|
-
}
|
|
1045
|
-
],
|
|
1046
|
-
${a}
|
|
1047
|
-
},
|
|
1048
|
-
{
|
|
1049
|
-
id: "pro",
|
|
1050
|
-
type: "subscription",
|
|
1051
|
-
name: "pricing.plans.plan_3.name",
|
|
1052
|
-
description: "pricing.plans.plan_3.description",
|
|
1053
|
-
featured: true,
|
|
1054
|
-
features: [
|
|
1055
|
-
"pricing.plans.plan_3.features.item_1",
|
|
1056
|
-
"pricing.plans.plan_3.features.item_2",
|
|
1057
|
-
"pricing.plans.plan_3.features.item_3",
|
|
1058
|
-
"pricing.plans.plan_3.features.item_4",
|
|
1059
|
-
"pricing.plans.plan_3.features.item_5",
|
|
1060
|
-
"pricing.plans.plan_3.features.item_6"
|
|
1061
|
-
],
|
|
1062
|
-
prices: [
|
|
1063
|
-
{
|
|
1064
|
-
${i}
|
|
1065
|
-
interval: "month",
|
|
1066
|
-
amounts: { ${r}: 29 },
|
|
1067
|
-
anchorAmounts: { ${r}: 39 },
|
|
1068
|
-
featured: true
|
|
1069
|
-
},
|
|
1070
|
-
{
|
|
1071
|
-
${i}
|
|
1072
|
-
interval: "year",
|
|
1073
|
-
amounts: { ${r}: 290 },
|
|
1074
|
-
anchorAmounts: { ${r}: 349 }
|
|
1075
|
-
}
|
|
1076
|
-
],
|
|
1077
|
-
${d}
|
|
1078
|
-
}
|
|
1079
|
-
],
|
|
1080
|
-
${o?" credits: { enabled: true }":" credits: { enabled: false }"},
|
|
1081
|
-
products: {
|
|
1082
|
-
enabled: false,
|
|
1083
|
-
items: []
|
|
1084
|
-
}
|
|
1085
|
-
};
|
|
1086
|
-
`;await l(t,y)}import{readFile as Vr}from"fs/promises";import{join as Fr}from"path";async function Br(e){let t=Fr(e.projectDir,"turbo.json"),r;try{r=await Vr(t,"utf-8")}catch{return}let n=JSON.parse(r),i=n.tasks?.build;if(!i)return;let o=e.frontend==="nextjs"?"NUXT_PUBLIC_*":"NEXT_PUBLIC_*",s=e.frontend==="nextjs"?new Set([".nuxt/**",".output/**"]):new Set([".next/**","!.next/cache/**"]),a=!1;if(Array.isArray(i.env)){let d=i.env.filter(h=>h!==o);d.length!==i.env.length&&(i.env=d,a=!0)}if(Array.isArray(i.outputs)){let d=i.outputs.filter(h=>!s.has(h));d.length!==i.outputs.length&&(i.outputs=d,a=!0)}a&&await l(t,JSON.stringify(n,null," ")+`
|
|
1087
|
-
`)}var Xi=["base.json","node.json","next.json"],Mr="GenerateSaaS ";async function Gr(e){if(!e.demo)for(let t of Xi){let r=Fr(e.projectDir,"tooling/typescript",t),n;try{n=await Vr(r,"utf-8")}catch{continue}let i=JSON.parse(n);typeof i.display!="string"||!i.display.startsWith(Mr)||(i.display=i.display.slice(Mr.length),await l(r,JSON.stringify(i,null," ")+`
|
|
1088
|
-
`))}}function Zi(e){let t=[];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 r=e.frontend==="nextjs"?"Next.js":"Nuxt";if(t.push({type:"node-terminal",request:"launch",name:r,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"}}),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 n=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 ${n}`,cwd:"${workspaceFolder}",skipFiles:["<node_internals>/**"]})}return t}function Qi(e){let t=e.frontend==="nextjs"?"Next.js":"Nuxt",r=[];return e.architecture==="separate"?r.push({name:`Dev (${t} + Backend + Inngest)`,configurations:["Backend",t,"Inngest"]}):r.push({name:`Dev (${t} + Inngest)`,configurations:[t,"Inngest"]}),r}async function Kr(e){let t={version:"0.2.0",configurations:Zi(e),compounds:Qi(e)};await l(`${e.projectDir}/.vscode/launch.json`,JSON.stringify(t,null," ")+`
|
|
1089
|
-
`)}import{relative as eo}from"path";async function Me(e){let r=(await de(e,e,Se)).sort(),n=await Promise.all(r.map(async i=>[eo(e,i),await lt(i)]));return Object.fromEntries(n)}import{copyFile as to,mkdir as ro,rm as no}from"fs/promises";import{dirname as io,join as zr,relative as oo}from"path";import{existsSync as so}from"fs";async function Hr(e,t){let r=zr(t,ot);so(r)&&await no(r,{recursive:!0,force:!0});let n=await de(e,e,Se);for(let i of n){let o=oo(e,i),s=zr(r,o);await ro(io(s),{recursive:!0}),await to(i,s)}}import{existsSync as ao}from"fs";import{readFile as Yr,readdir as co}from"fs/promises";import{join as z,dirname as lo,resolve as po,sep as uo}from"path";import{fileURLToPath as mo}from"url";var Ve={"claude-code":".claude/skills",cursor:".cursor/skills",codex:".agents/skills","gemini-cli":".gemini/skills",windsurf:".windsurf/skills"},Dc=Object.values(Ve),Pt="generatesaas-update",Jr=lo(mo(import.meta.url));function fo(){let e=z(Jr,"skill","content");return ao(e)?e:z(Jr,"content")}function Ot(e){return!e||e.length===0?[]:e.map(t=>Ve[t])}async function Dt(e,t,r,n){let i=Ot(n);for(let o of i){let s=z(e,o,Pt),a=z(s,"scripts"),d=z(s,"references");await at(a),await at(d),await l(z(s,"SKILL.md"),t.replaceAll("__SKILL_ROOT__",o)),await l(z(d,".gitkeep"),"");for(let[h,y]of Object.entries(r)){let u=po(a,h);u.startsWith(a+uo)&&await l(u,y)}}}async function qr(e,t){let r=fo(),n=await Yr(z(r,"SKILL.md"),"utf-8"),i=z(r,"scripts"),o=await co(i),s={};for(let a of o)a!==".gitkeep"&&(s[a]=await Yr(z(i,a),"utf-8"));await Dt(e,n,s,t)}import{execFile as go,execFileSync as ho}from"child_process";import{access as Wr,readFile as yo}from"fs/promises";import{join as xt}from"path";import*as k from"@clack/prompts";function ke(e){try{let t=process.platform==="win32"?"where":"which";return ho(t,[e],{stdio:"ignore"}),!0}catch{return!1}}function Ae(e,t,r,n=3e5){return new Promise((i,o)=>{go(e,t,{cwd:r,timeout:n},(s,a,d)=>{if(s){let h=String(a||"").trim(),u=[String(d||"").trim(),h].filter(Boolean).join(`
|
|
1082
|
+
`;await l(dt(t,"providers/index.ts"),i),await l(dt(t,"index.ts"),await qi(t,r))}async function qi(e,t){let r=dt(e,"index.ts");if(!Yi(r))throw new Error(`generatePaymentBarrel: expected ${r} to exist \u2014 did packages/payments move?`);let i=await Hi(r,"utf-8"),n=Ji.filter(s=>s!==t);return i.split(`
|
|
1083
|
+
`).filter(s=>!n.some(a=>s.includes(`./providers/${a}/`))).join(`
|
|
1084
|
+
`)}import{readdir as Wi,readFile as Xi}from"fs/promises";import{join as Vr}from"path";async function Fr(e){if(e.demo)return;let t=e.appName.trim()||e.projectName,r=JSON.stringify(t).slice(1,-1),i=Vr(e.projectDir,"packages/i18n/translations"),n;try{n=await Wi(i)}catch{return}for(let o of n){let s=Vr(i,o,"web.json"),a;try{a=await Xi(s,"utf-8")}catch{continue}let d=a.replaceAll("GenerateSaaS",r);d!==a&&await l(s,d)}}import{readFile as Zi}from"fs/promises";import{join as Br}from"path";var Qi=[".nuxt/",".nuxt",".nitro/",".nitro",".output/",".output","_locales/"],eo=[".next/",".next",".svelte-kit/",".svelte-kit",".wrangler/",".wrangler",".dev.vars"];async function Kr(e){let r=e.frontend==="nuxt"?eo:Qi;await Gr(Br(e.projectDir,".gitignore"),r),await Gr(Br(e.projectDir,".dockerignore"),r)}async function Gr(e,t){let r;try{r=await Zi(e,"utf-8")}catch{return}let i=new Set(t),n=r.split(`
|
|
1085
|
+
`).filter(o=>!i.has(o.trim()));n.length!==r.split(`
|
|
1086
|
+
`).length&&await l(e,n.join(`
|
|
1087
|
+
`))}async function ut(e){let t=e.projectDir;e.demo||await rr(t),await nr(t,e.aiTools),await ir(t,e.frontend),await or(e),await sr(e),await ar(e),e.demo||await cr(e),await dr(e);let r=await ur(e);return await mr(e),await fr(e),await gr(e),await hr(e),await yr(e),await vr(e),await br(e),await Tr(e),await kr(e),await _r(e),await Or(e),await Lr(e),await Dr(e),await xr(e),await Cr(e),await Nr(e),await jr(e),await Mr(e),await Fr(e),await Kr(e),{dockerComposeGenerated:r}}import{basename as Hr,join as Yr,relative as ro}from"path";import{createHash as zr}from"crypto";import{readFile as to}from"fs/promises";async function mt(e){let t=await to(e);return zr("sha256").update(t).digest("hex")}function Rt(e){return zr("sha256").update(e).digest("hex")}var no=new Set(["data",L]);function io(e){let t=e.split("/");for(let r of t)if(wt.has(r)||no.has(r)||r.startsWith(".env")&&!r.includes("example"))return!0;return!1}function Jr(e,t){return{projectName:e.projectName??Hr(t),appName:e.appName??e.projectName??Hr(t),projectDir:t,frontend:e.frontend==="nextjs"?"nextjs":"nuxt",architecture:e.architecture??"fullstack",paymentProvider:e.paymentProvider??"none",emailProvider:e.emailProvider??"smtp",multiTenancy:e.multiTenancy??!1,billingScope:e.billingScope??"user",blog:e.blog??!1,docs:e.docs??!1,revenueSharing:e.revenueSharing??!1,credits:e.credits??!1,dockerServices:e.dockerServices??[],aiTools:e.aiTools??[],socialProviders:e.socialProviders??[],defaultCurrency:e.defaultCurrency??"USD",deploymentTarget:e.deploymentTarget??"node",databaseProvider:e.databaseProvider??"postgres",cacheProvider:e.cacheProvider??"redis",version:e.version,baseUrl:e.baseUrl,credentials:{},demo:!1}}async function qr(e,t){let i=(await ue(e.projectDir,e.projectDir,io)).sort(),n=await Promise.all(i.map(async a=>[ro(e.projectDir,a),await mt(a)])),o=Object.fromEntries(n),s={version:e.version,initialVersion:e.version,repo:"Duzbee/GenerateSaaS",appName:e.appName,projectName:e.projectName,frontend:e.frontend,architecture:e.architecture,paymentProvider:e.paymentProvider,emailProvider:e.emailProvider,multiTenancy:e.multiTenancy,billingScope:e.billingScope,blog:e.blog,docs:e.docs,credits:e.credits,revenueSharing:e.revenueSharing,defaultCurrency:e.defaultCurrency,dockerServices:e.dockerServices,socialProviders:e.socialProviders,deploymentTarget:e.deploymentTarget,databaseProvider:e.databaseProvider,cacheProvider:e.cacheProvider,aiTools:e.aiTools,...e.baseUrl?{baseUrl:e.baseUrl}:{},...t&&{licenseToken:t.token,licenseKeyHash:t.keyHash,installId:t.installId}};await l(Yr(e.projectDir,Q),JSON.stringify(s,null," ")+`
|
|
1088
|
+
`),await l(Yr(e.projectDir,zt),JSON.stringify(o,null," ")+`
|
|
1089
|
+
`)}import{relative as oo}from"path";async function je(e){let r=(await ue(e,e,Se)).sort(),i=await Promise.all(r.map(async n=>[oo(e,n),await mt(n)]));return Object.fromEntries(i)}import{copyFile as so,mkdir as ao,rm as co}from"fs/promises";import{dirname as lo,join as Wr,relative as po}from"path";import{existsSync as uo}from"fs";async function Ot(e,t){uo(t)&&await co(t,{recursive:!0,force:!0});let r=await ue(e,e,Se);for(let i of r){let n=po(e,i),o=Wr(t,n);await ao(lo(o),{recursive:!0}),await so(i,o)}}async function Xr(e,t){await Ot(e,Wr(t,it))}import{existsSync as mo}from"fs";import{readFile as Zr,readdir as fo}from"fs/promises";import{join as z,dirname as go,resolve as ho,sep as yo}from"path";import{fileURLToPath as vo}from"url";var Me={"claude-code":".claude/skills",cursor:".cursor/skills",codex:".agents/skills","gemini-cli":".gemini/skills",windsurf:".windsurf/skills"},ll=Object.values(Me),Dt="generatesaas-update",Qr=go(vo(import.meta.url));function So(){let e=z(Qr,"skill","content");return mo(e)?e:z(Qr,"content")}function xt(e){return!e||e.length===0?[]:e.map(t=>Me[t])}async function Ct(e,t,r,i){let n=xt(i);for(let o of n){let s=z(e,o,Dt),a=z(s,"scripts"),d=z(s,"references");await at(a),await at(d),await l(z(s,"SKILL.md"),t.replaceAll("__SKILL_ROOT__",o)),await l(z(d,".gitkeep"),"");for(let[g,h]of Object.entries(r)){let u=ho(a,g);u.startsWith(a+yo)&&await l(u,h)}}}async function en(e,t){let r=So(),i=await Zr(z(r,"SKILL.md"),"utf-8"),n=z(r,"scripts"),o=await fo(n),s={};for(let a of o)a!==".gitkeep"&&(s[a]=await Zr(z(n,a),"utf-8"));await Ct(e,i,s,t)}import{execFile as Eo,execFileSync as wo}from"child_process";import{access as tn,readFile as bo}from"fs/promises";import{join as Nt}from"path";import*as k from"@clack/prompts";function ke(e){try{let t=process.platform==="win32"?"where":"which";return wo(t,[e],{stdio:"ignore"}),!0}catch{return!1}}function Ae(e,t,r,i=3e5){return new Promise((n,o)=>{Eo(e,t,{cwd:r,timeout:i},(s,a,d)=>{if(s){let g=String(a||"").trim(),u=[String(d||"").trim(),g].filter(Boolean).join(`
|
|
1090
1090
|
`);o(new Error(u?`${s.message}
|
|
1091
|
-
${u}`:s.message))}else
|
|
1092
|
-
`)
|
|
1093
|
-
`)
|
|
1094
|
-
`),$.yellow("Deployment"))}function vo(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 So(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 rn(e){let t={};if(e.name!==void 0){if(!rt(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===!1)throw new Error("--billing-scope requires --org to be enabled.");t.billingScope=e.billingScope}if(e.blog!==void 0&&(t.blog=e.blog),e.docs!==void 0&&(t.docs=e.docs),e.revenueSharing!==void 0&&(t.revenueSharing=e.revenueSharing),e.credits!==void 0){if(e.credits===!0&&e.payment==="none")throw new Error("--credits requires a payment provider (got --payment none).");t.credits=e.credits}if(e.docker!==void 0&&(t.dockerServices=Ct(e.docker,Xe,"docker service")),e.aiTools!==void 0&&(t.aiTools=Ct(e.aiTools,Ze,"AI tool")),e.socialProviders!==void 0&&(t.socialProviders=Ct(e.socialProviders,et,"social provider")),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(!ae.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${ae.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!ce.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${ce.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 r=e.baseUrl.trim();if(r==="")throw new Error("--base-url cannot be empty. Provide an absolute URL like https://example.com.");let n;try{n=new URL(r)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(n.protocol!=="http:"&&n.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${n.protocol}//${n.host}`}return t}var ne={projectName:"my-saas",frontend:"nextjs",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,billingScope:"user",blog:!0,docs:!1,revenueSharing:!1,credits:!0,dockerServices:["postgres","redis","inngest"],aiTools:[],socialProviders:[],defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"};function nn(e){let t=e.projectName??ne.projectName,r=e.projectDir??`./${t}`,n=e.appName??tt(t),i=e.deploymentTarget??ne.deploymentTarget,o=F[i]?.edgeRuntime??!1,s=e.databaseProvider??(o?"neon":ne.databaseProvider),a=e.cacheProvider??(o?"upstash":ne.cacheProvider),d=e.emailProvider??(o?"resend":ne.emailProvider),h=e.dockerServices??(o?ne.dockerServices.filter(u=>u!=="postgres"&&u!=="redis"):ne.dockerServices),y={...ne,...e,projectName:t,appName:n,projectDir:r,deploymentTarget:i,databaseProvider:s,cacheProvider:a,emailProvider:d,dockerServices:h};y.paymentProvider==="none"&&(y.credits=!1);for(let u of Ne){if(y.deploymentTarget!==u.target)continue;let v=y.databaseProvider===u.provider?"database":"cache";if(y.databaseProvider===u.provider||y.cacheProvider===u.provider)throw new Error(`Incompatible: --deploy ${u.target} + --${v} ${u.provider}. ${u.reason}`)}for(let u of Le)if(y.architecture===u.architecture&&y.deploymentTarget===u.target)throw new Error(`Incompatible: --architecture ${u.architecture} + --deploy ${u.target}. ${u.reason}`);return y}function Ct(e,t,r){if(e.trim()==="")return[];let n=e.split(",").map(o=>o.trim()).filter(Boolean),i=n.filter(o=>!t.includes(o));if(i.length>0)throw new Error(`Invalid ${r}(s): ${i.join(", ")}. Valid values: ${t.join(", ")}`);return n}import Ao from"picocolors";var ko="c81635e3715dc7274f33a745e24a394d93d3d081a4004408585c3de86e1aac35";function _o(e){if(e===void 0)return;let t=e.trim().replace(/^v/,"");if(!/^\d+\.\d+\.\d+$/.test(t))throw new Error(`Invalid template version "${e}". Use semver like 1.2.3.`);return t}function on(e){e.command("init").description("Scaffold a new GenerateSaaS project").option("-n, --name <name>","project name (lowercase, hyphens, starts with letter)").option("--app-name <name>","display name for the app").option("-l, --location <path>","project directory (default: ./{name})").addOption(new H("--frontend <type>","frontend framework").choices([...$e])).addOption(new H("--architecture <type>","fullstack or separate").choices([...Je])).addOption(new H("--payment <provider>","payment provider").choices([...qe])).addOption(new H("--email <provider>","email provider").choices([...We])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").addOption(new H("--billing-scope <scope>","billing scope (requires --org)").choices([...Qe])).option("--blog","enable blog").option("--no-blog","disable blog").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--revenue-sharing","enable revenue sharing").option("--no-revenue-sharing","disable revenue sharing").option("--credits","enable credits system").option("--no-credits","disable credits system (subscription-only)").option("--docker <services>","comma-separated: postgres,redis,inngest,mailpit").option("--ai-tools <tools>","comma-separated: claude-code,cursor,codex,gemini-cli,windsurf").option("--social-providers <providers>","comma-separated: google,github,facebook,discord,x").addOption(new H("--currency <code>","default currency for billing").choices([...se])).addOption(new H("--deploy <target>","deployment target").choices([...ae])).addOption(new H("--database <provider>","database provider").choices([...ce])).addOption(new H("--cache <provider>","cache provider").choices([...le])).option("--template-version <version>","specific template version to scaffold").option("--api-key <key>","API key (skips interactive prompt)").option("--base-url <url>","public base URL (e.g. https://example.com) \u2014 bakes into canonical/og/sitemap").option("-y, --yes","accept defaults for unspecified options (non-interactive)").addOption(new H("--demo","first-party demo build: keep sample content, mark site non-indexable \u2014 requires CI API key").hideHelp()).action(async t=>{await Ro(t)})}async function Ro(e){let t=performance.now();jt("1.0.1");let r,n;try{r=rn(e),n=_o(e.templateVersion)}catch(E){w.cancel(I(E)),process.exit(1)}let i=w.spinner(),o;try{o=await ve({apiKey:e.apiKey,prompt:!e.yes})}catch(E){w.cancel(I(E)),process.exit(1)}e.demo&&At(o)!==ko&&(w.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let s=L(o),a=async()=>{let E=await G(s),_=E.latest,Pe=n??_;if(n&&!E.versions.some(he=>he.version===Pe))throw new Error(`Template version "${n}" is not available.`);return{latestVersion:_,selectedVersion:Pe}};i.start("Verifying access...");let d,h;try{({latestVersion:d,selectedVersion:h}=await a()),i.stop("Access verified."),X(o)}catch(E){if(i.stop("Access verification failed."),E instanceof R&&E.status===401){e.yes&&(w.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),w.log.warning("Invalid API key."),o=await Z(),s=L(o),i.start("Verifying access...");try{({latestVersion:d,selectedVersion:h}=await a()),i.stop("Access verified."),X(o)}catch(_){i.stop("Access verification failed."),w.cancel(_ instanceof R&&_.status===401?"Invalid API key.":I(_)),process.exit(1)}}else w.cancel(I(E)),process.exit(1)}w.log.success(`Latest version: ${d}`),h!==d&&w.log.success(`Using template version: ${h}`);let y;e.yes?y=nn(r):y=await Ft(r);let u;i.start("Activating license...");try{let E=crypto.randomUUID();u={token:(await Xt(s,{frontend:y.frontend,version:h,installId:E})).token,keyHash:At(o),installId:E},i.stop("License activated.")}catch(E){i.stop("License activation failed."),w.cancel(I(E)),process.exit(1)}let v=To(y.projectDir);if(Eo(v)&&wo(v).length>0)if(e.yes)w.log.info(`Directory ${v} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let _=await w.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"}]});(w.isCancel(_)||_==="cancel")&&(w.cancel("Setup cancelled."),process.exit(0)),_==="overwrite"&&bo(v,{recursive:!0,force:!0})}let f={...y,projectDir:v,version:h,...e.demo?{docs:!1}:{}};i.start("Downloading template...");try{if(await Ue(s,h,v),!e.demo){let E=await Me(v);await l(Io(v,it),JSON.stringify(E,null," ")+`
|
|
1095
|
-
`),await
|
|
1096
|
-
`),A.log.success("License refreshed.")}catch{A.log.warn("License refresh skipped.")}if(
|
|
1097
|
-
`)}a.stop("Baseline template stored.")}else if(
|
|
1098
|
-
`),a.stop("Baseline hashes computed.")}if(await l(
|
|
1099
|
-
`),A.log.info(`Update staged: ${
|
|
1100
|
-
`);
|
|
1101
|
-
`),Y.yellow("License Details"))}async function
|
|
1102
|
-
`).map(s=>s.trim()).filter(s=>s&&!s.startsWith("#"));
|
|
1091
|
+
${u}`:s.message))}else n()})})}async function rn(e){if(!ke("pnpm"))return k.log.warn("pnpm not found. Skipping lockfile regeneration."),!1;try{return await Ae("pnpm",["install","--lockfile-only","--no-frozen-lockfile","--config.minimumReleaseAge=0"],e),!0}catch(t){let r=t instanceof Error?t.message:String(t);return k.log.warn(`Lockfile regeneration failed: ${r}`),k.log.warn("Deploys using --frozen-lockfile may fail."),!1}}async function nn(e){if(!ke("pnpm"))return k.log.warn("pnpm not found. Skipping dependency installation."),k.log.info("Install pnpm: https://pnpm.io/installation"),!1;let t=k.spinner();t.start("Installing dependencies (this may take a minute)...");try{return await Ae("pnpm",["install","--config.minimumReleaseAge=0"],e),t.stop("Dependencies installed."),!0}catch(r){t.stop("Dependency installation failed.");let i=r instanceof Error?r.message:String(r);return k.log.warn(`pnpm install failed: ${i}`),k.log.warn("You can run it manually later."),!1}}async function on(e){try{return await tn(Nt(e,".git")),k.log.info("Git repository already exists, skipping init."),!0}catch{}if(!ke("git"))return k.log.warn("git not found. Skipping repository initialization."),!1;let t=k.spinner();t.start("Initializing git repository...");try{return await Ae("git",["init"],e),await Ae("git",["add","-A"],e),await Ae("git",["commit","--no-verify","-m","Initial commit from GenerateSaaS"],e),t.stop("Git repository initialized."),!0}catch{return t.stop("Git initialization failed."),k.log.warn("You can run git init manually later."),!1}}async function sn(e){if(!ke("pnpm"))return!1;try{await tn(Nt(e,".git"))}catch{return!1}try{let t=JSON.parse(await bo(Nt(e,"package.json"),"utf-8")),r=!!t.devDependencies?.["simple-git-hooks"],i=!!t["simple-git-hooks"];if(!r||!i)return!1}catch{return!1}try{return await Ae("pnpm",["exec","simple-git-hooks"],e),!0}catch{return k.log.warn("Could not install git hooks. Run 'pnpm exec simple-git-hooks' manually."),!1}}import*as Pe from"@clack/prompts";import U from"picocolors";function an(e,t){t.dockerComposeGenerated&&!t.dockerAvailable&&Pe.log.warn("Docker not found. Install Docker to run local services: https://docs.docker.com/get-docker/");let r=[];if(r.push(`cd ${e.projectDir}`),t.pnpmInstalled||r.push("pnpm install"),t.dockerComposeGenerated){let o=e.dockerServices.map(s=>ye[s].label).join(", ");r.push(`pnpm infra ${U.dim(`# ${o}`)}`)}if(r.push(`pnpm dev ${U.dim("# http://localhost:3000")}`),t.skippedCredentials.length>0&&(r.push(""),r.push(U.dim("Fill in remaining TODO values in .env"))),Pe.note(r.join(`
|
|
1092
|
+
`),U.yellow("Start Development")),t.dockerComposeGenerated){let o=[];o.push(`App ${U.cyan("http://localhost:3000")}`),e.architecture==="separate"&&o.push(`API ${U.cyan("http://localhost:3010")}`),e.dockerServices.includes("mailpit")&&o.push(`Mailpit ${U.cyan("http://localhost:8025")}`),e.dockerServices.includes("inngest")&&o.push(`Inngest ${U.cyan("http://localhost:8288")}`),Pe.note(o.join(`
|
|
1093
|
+
`),U.yellow("Dev Tools"))}let i=[],n=To(e);n.length>0&&i.push(`Set in production: ${U.dim(n.join(", "))}`),i.push("pnpm db:push # Run database migrations"),i.push(Io(e)),Pe.note(i.join(`
|
|
1094
|
+
`),U.yellow("Deployment"))}function To(e){let t=["DATABASE_URL","BETTER_AUTH_SECRET"];return e.cacheProvider==="upstash"?t.push("UPSTASH_REDIS_REST_URL","UPSTASH_REDIS_REST_TOKEN"):t.push("REDIS_URL"),e.paymentProvider==="stripe"?t.push("STRIPE_SECRET_KEY","STRIPE_WEBHOOK_SECRET"):e.paymentProvider==="polar"&&t.push("POLAR_ACCESS_TOKEN","POLAR_WEBHOOK_SECRET"),e.emailProvider==="ses"?t.push("AMAZON_SES_REGION","AMAZON_SES_KEY","AMAZON_SES_SECRET"):e.emailProvider==="resend"?t.push("RESEND_API_KEY"):t.push("SMTP_HOST","SMTP_PORT"),t}function Io(e){switch(e.deploymentTarget){case"node":return"Deploy with Docker or your preferred Node.js host";case"vercel":return"vercel deploy # Deploy to Vercel"}}function cn(e){let t={};if(e.name!==void 0){if(!tt(e.name))throw new Error(`Invalid project name "${e.name}". Use lowercase letters, numbers, and hyphens only. Must start with a letter.`);t.projectName=e.name}if(e.appName!==void 0){if(!e.appName.trim())throw new Error("App name cannot be empty.");t.appName=e.appName}if(e.location!==void 0?t.projectDir=e.location==="."?process.cwd():e.location:t.projectName!==void 0&&(t.projectDir=`./${t.projectName}`),e.frontend!==void 0){if(!$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===!1)throw new Error("--billing-scope requires --org to be enabled.");t.billingScope=e.billingScope}if(e.blog!==void 0&&(t.blog=e.blog),e.docs!==void 0&&(t.docs=e.docs),e.revenueSharing!==void 0&&(t.revenueSharing=e.revenueSharing),e.credits!==void 0){if(e.credits===!0&&e.payment==="none")throw new Error("--credits requires a payment provider (got --payment none).");t.credits=e.credits}if(e.docker!==void 0&&(t.dockerServices=Lt(e.docker,We,"docker service")),e.aiTools!==void 0&&(t.aiTools=Lt(e.aiTools,Xe,"AI tool")),e.socialProviders!==void 0&&(t.socialProviders=Lt(e.socialProviders,Qe,"social provider")),e.currency!==void 0){if(!ae.includes(e.currency))throw new Error(`Invalid currency "${e.currency}". Valid values: ${ae.join(", ")}`);t.defaultCurrency=e.currency}if(e.deploy!==void 0){if(!ce.includes(e.deploy))throw new Error(`Invalid deployment target "${e.deploy}". Valid values: ${ce.join(", ")}`);t.deploymentTarget=e.deploy}if(e.database!==void 0){if(!le.includes(e.database))throw new Error(`Invalid database provider "${e.database}". Valid values: ${le.join(", ")}`);t.databaseProvider=e.database}if(e.cache!==void 0){if(!pe.includes(e.cache))throw new Error(`Invalid cache provider "${e.cache}". Valid values: ${pe.join(", ")}`);t.cacheProvider=e.cache}if(e.demo===!0&&(t.demo=!0),e.baseUrl!==void 0){let r=e.baseUrl.trim();if(r==="")throw new Error("--base-url cannot be empty. Provide an absolute URL like https://example.com.");let i;try{i=new URL(r)}catch{throw new Error(`Invalid --base-url "${e.baseUrl}". Must be an absolute URL like https://example.com.`)}if(i.protocol!=="http:"&&i.protocol!=="https:")throw new Error(`Invalid --base-url "${e.baseUrl}". Must use http or https.`);t.baseUrl=`${i.protocol}//${i.host}`}return t}var re={projectName:"my-saas",frontend:"nextjs",architecture:"fullstack",paymentProvider:"stripe",emailProvider:"smtp",multiTenancy:!1,billingScope:"user",blog:!0,docs:!1,revenueSharing:!1,credits:!0,dockerServices:["postgres","redis","inngest"],aiTools:[],socialProviders:[],defaultCurrency:"USD",deploymentTarget:"node",databaseProvider:"postgres",cacheProvider:"redis"};function ln(e){let t=e.projectName??re.projectName,r=e.projectDir??`./${t}`,i=e.appName??et(t),n=e.deploymentTarget??re.deploymentTarget,o=F[n]?.edgeRuntime??!1,s=e.databaseProvider??(o?"neon":re.databaseProvider),a=e.cacheProvider??(o?"upstash":re.cacheProvider),d=e.emailProvider??(o?"resend":re.emailProvider),g=e.dockerServices??(o?re.dockerServices.filter(u=>u!=="postgres"&&u!=="redis"):re.dockerServices),h={...re,...e,projectName:t,appName:i,projectDir:r,deploymentTarget:n,databaseProvider:s,cacheProvider:a,emailProvider:d,dockerServices:g};h.paymentProvider==="none"&&(h.credits=!1);for(let u of Ne){if(h.deploymentTarget!==u.target)continue;let S=h.databaseProvider===u.provider?"database":"cache";if(h.databaseProvider===u.provider||h.cacheProvider===u.provider)throw new Error(`Incompatible: --deploy ${u.target} + --${S} ${u.provider}. ${u.reason}`)}for(let u of Le)if(h.architecture===u.architecture&&h.deploymentTarget===u.target)throw new Error(`Incompatible: --architecture ${u.architecture} + --deploy ${u.target}. ${u.reason}`);return h}function Lt(e,t,r){if(e.trim()==="")return[];let i=e.split(",").map(o=>o.trim()).filter(Boolean),n=i.filter(o=>!t.includes(o));if(n.length>0)throw new Error(`Invalid ${r}(s): ${n.join(", ")}. Valid values: ${t.join(", ")}`);return i}import Oo from"picocolors";var Do="c81635e3715dc7274f33a745e24a394d93d3d081a4004408585c3de86e1aac35";function xo(e){if(e===void 0)return;let t=e.trim().replace(/^v/,"");if(!/^\d+\.\d+\.\d+$/.test(t))throw new Error(`Invalid template version "${e}". Use semver like 1.2.3.`);return t}function pn(e){e.command("init").description("Scaffold a new GenerateSaaS project").option("-n, --name <name>","project name (lowercase, hyphens, starts with letter)").option("--app-name <name>","display name for the app").option("-l, --location <path>","project directory (default: ./{name})").addOption(new H("--frontend <type>","frontend framework").choices([...$e])).addOption(new H("--architecture <type>","fullstack or separate").choices([...Ye])).addOption(new H("--payment <provider>","payment provider").choices([...Je])).addOption(new H("--email <provider>","email provider").choices([...qe])).option("--org","enable multi-tenancy (organizations)").option("--no-org","disable multi-tenancy").addOption(new H("--billing-scope <scope>","billing scope (requires --org)").choices([...Ze])).option("--blog","enable blog").option("--no-blog","disable blog").option("--docs","include the docs app (apps/docs, Fumadocs)").option("--no-docs","exclude the docs app").option("--revenue-sharing","enable revenue sharing").option("--no-revenue-sharing","disable revenue sharing").option("--credits","enable credits system").option("--no-credits","disable credits system (subscription-only)").option("--docker <services>","comma-separated: postgres,redis,inngest,mailpit").option("--ai-tools <tools>","comma-separated: claude-code,cursor,codex,gemini-cli,windsurf").option("--social-providers <providers>","comma-separated: google,github,facebook,discord,x").addOption(new H("--currency <code>","default currency for billing").choices([...ae])).addOption(new H("--deploy <target>","deployment target").choices([...ce])).addOption(new H("--database <provider>","database provider").choices([...le])).addOption(new H("--cache <provider>","cache provider").choices([...pe])).option("--template-version <version>","specific template version to scaffold").option("--api-key <key>","API key (skips interactive prompt)").option("--base-url <url>","public base URL (e.g. https://example.com) \u2014 bakes into canonical/og/sitemap").option("-y, --yes","accept defaults for unspecified options (non-interactive)").addOption(new H("--demo","first-party demo build: keep sample content, mark site non-indexable \u2014 requires CI API key").hideHelp()).action(async t=>{await Co(t)})}async function Co(e){let t=performance.now();Ft("1.1.1");let r,i;try{r=cn(e),i=xo(e.templateVersion)}catch(v){E.cancel(T(v)),process.exit(1)}let n=E.spinner(),o;try{o=await ve({apiKey:e.apiKey,prompt:!e.yes})}catch(v){E.cancel(T(v)),process.exit(1)}e.demo&&Rt(o)!==Do&&(E.cancel("--demo is restricted to first-party demo deployments."),process.exit(1));let s=$(o),a=async()=>{let v=await G(s),P=v.latest,Re=i??P;if(i&&!v.versions.some(he=>he.version===Re))throw new Error(`Template version "${i}" is not available.`);return{latestVersion:P,selectedVersion:Re}};n.start("Verifying access...");let d,g;try{({latestVersion:d,selectedVersion:g}=await a()),n.stop("Access verified."),X(o)}catch(v){if(n.stop("Access verification failed."),v instanceof _&&v.status===401){e.yes&&(E.cancel("Invalid API key. Cannot prompt in non-interactive mode."),process.exit(1)),E.log.warning("Invalid API key."),o=await Z(),s=$(o),n.start("Verifying access...");try{({latestVersion:d,selectedVersion:g}=await a()),n.stop("Access verified."),X(o)}catch(P){n.stop("Access verification failed."),E.cancel(P instanceof _&&P.status===401?"Invalid API key.":T(P)),process.exit(1)}}else E.cancel(T(v)),process.exit(1)}E.log.success(`Latest version: ${d}`),g!==d&&E.log.success(`Using template version: ${g}`);let h;e.yes?h=ln(r):h=await Kt(r);let u;n.start("Activating license...");try{let v=crypto.randomUUID();u={token:(await Wt(s,{frontend:h.frontend,version:g,installId:v})).token,keyHash:Rt(o),installId:v},n.stop("License activated.")}catch(v){n.stop("License activation failed."),E.cancel(T(v)),process.exit(1)}let S=Ro(h.projectDir);if(Ao(S)&&ko(S).length>0)if(e.yes)E.log.info(`Directory ${S} is not empty. Merging (keeping existing files, overwriting conflicts).`);else{let P=await E.select({message:`Directory ${S} is not empty.`,options:[{value:"merge",label:"Merge",hint:"keep existing files, overwrite conflicts"},{value:"overwrite",label:"Overwrite",hint:"delete everything and start fresh"},{value:"cancel",label:"Cancel"}]});(E.isCancel(P)||P==="cancel")&&(E.cancel("Setup cancelled."),process.exit(0)),P==="overwrite"&&Po(S,{recursive:!0,force:!0})}let b={...h,projectDir:S,version:g,...e.demo?{docs:!1}:{}};n.start("Downloading template...");try{await ot(s,g,S),n.stop("Template downloaded.")}catch(v){n.stop("Download failed."),E.cancel(T(v)),process.exit(1)}let J;n.start("Generating project files...");try{if({dockerComposeGenerated:J}=await ut(b),!e.demo){let v=await je(S);await l(_o(S,nt),JSON.stringify(v,null," ")+`
|
|
1095
|
+
`),await Xr(S,S)}await en(S,b.aiTools),await qr(b,u),n.stop("Project files generated.")}catch(v){n.stop("Generation failed."),E.cancel(T(v)),process.exit(1)}await rn(S);let D=await nn(S);await on(S),D&&await sn(S);let ne=ke("docker"),I=St(b).map(v=>v.key).filter(v=>!b.credentials?.[v]);an(b,{pnpmInstalled:D,dockerComposeGenerated:J,dockerAvailable:ne,skippedCredentials:I}),Bt(),E.log.info(Oo.dim(`Done in ${((performance.now()-t)/1e3).toFixed(1)}s`))}import{existsSync as dn}from"fs";import{readFile as jo}from"fs/promises";import{join as Ve,resolve as Mo}from"path";import*as A from"@clack/prompts";import _e from"picocolors";import{mkdtemp as No,rm as Lo}from"fs/promises";import{tmpdir as $o}from"os";import{join as Uo}from"path";async function $t(e,t,r,i){let n=await No(Uo($o(),"generatesaas-stage-"));try{await ot(e,t,n),await ut({...r,projectDir:n}),await Ot(n,i)}finally{await Lo(n,{recursive:!0,force:!0})}}function un(e){e.command("update").description("Update AI skill files and stage template updates").option("--cwd <path>","project directory (default: current directory)").action(async t=>{let r=Mo(t.cwd??process.cwd()),i=Ve(r,Q),n;try{n=JSON.parse(await jo(i,"utf-8"))}catch{A.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let o;try{o=await ve()}catch(d){A.cancel(T(d)),process.exit(1)}let s=$(o),a=A.spinner();try{a.start("Verifying access...");let d;try{d=await G(s)}catch(I){if(I instanceof _&&I.status===401)a.stop("Invalid API key."),o=await Z(),s=$(o),a.start("Verifying access..."),d=await G(s);else throw I}a.stop("Access verified."),X(o),a.start("Fetching latest skill files...");let g=await qt(s,d.latest);await Ct(r,g.skillMd,g.scripts,n.aiTools);let h=xt(n.aiTools);if(a.stop("Skills updated."),A.log.success(`Skill files installed to ${_e.cyan(h.length.toString())} locations.`),n.licenseToken)try{let I=await Xt(s,{currentToken:n.licenseToken,newVersion:n.version});n.licenseToken=I.token,await l(i,JSON.stringify(n,null," ")+`
|
|
1096
|
+
`),A.log.success("License refreshed.")}catch{A.log.warn("License refresh skipped.")}if(n.version===d.latest){A.log.info(`Already on the latest version (${n.version}).`);return}let u=Jr(n,r),S=Ve(r,Ht);a.start(`Staging v${d.latest} (shaped for your config)...`),await $t(s,d.latest,u,S),a.stop("Template staged.");let b=await Jt(s,d.latest);b&&A.note(b,`Changelog v${d.latest}`);let J=Ve(r,nt),D=Ve(r,it),ne=!dn(D),ie=!dn(J);if(ne){if(a.start("Building baseline template (one-time migration)..."),await $t(s,n.version,u,D),ie){let I=await je(D);await l(J,JSON.stringify(I,null," ")+`
|
|
1097
|
+
`)}a.stop("Baseline template stored.")}else if(ie){a.start("Computing baseline template hashes...");let I=await je(D);await l(J,JSON.stringify(I,null," ")+`
|
|
1098
|
+
`),a.stop("Baseline hashes computed.")}if(await l(Ve(r,Yt),JSON.stringify({currentVersion:n.version,targetVersion:d.latest,changelog:b,stagedAt:new Date().toISOString()},null," ")+`
|
|
1099
|
+
`),A.log.info(`Update staged: ${_e.cyan(n.version)} \u2192 ${_e.cyan(d.latest)}`),n.aiTools&&n.aiTools.length>0){let I=n.aiTools[0],v=Ce[I].label;A.log.info(`Open your project in ${_e.cyan(v)} and ask: ${_e.cyan("'update my GenerateSaaS project'")}`)}else A.log.info(`Ask your AI coding assistant to ${_e.cyan("'update my GenerateSaaS project'")}.`)}catch(d){a.stop("Failed."),A.cancel(`Update failed: ${T(d)}`),process.exit(1)}})}import*as M from"@clack/prompts";import j from"picocolors";import{readFile as Vo}from"fs/promises";import{join as Fo,resolve as Bo}from"path";function mn(e){e.command("status").description("Show project status and check for updates").option("--cwd <path>","project directory (default: current directory)").action(async t=>{let r=Bo(t.cwd??process.cwd()),i=Fo(r,Q),n;try{n=JSON.parse(await Vo(i,"utf-8"))}catch{M.cancel(".generatesaas/manifest.json not found. Run this from a GenerateSaaS project."),process.exit(1)}let o=[`Version: ${j.cyan(n.version)}`,`Frontend: ${j.cyan(n.frontend)}`,n.deploymentTarget?`Deploy target: ${j.cyan(n.deploymentTarget)}`:null,n.databaseProvider?`Database: ${j.cyan(n.databaseProvider)}`:null,n.cacheProvider?`Cache: ${j.cyan(n.cacheProvider)}`:null,n.aiTools&&n.aiTools.length>0?`AI tools: ${j.cyan(n.aiTools.join(", "))}`:null].filter(Boolean).join(`
|
|
1100
|
+
`);M.note(o,j.bold("Project Status"));let s=M.spinner();s.start("Checking for updates...");try{let a=await ve(),d=$(a),g;try{g=await G(d)}catch(u){if(u instanceof _&&u.status===401)s.stop("Invalid API key."),a=await Z(),d=$(a),s.start("Checking for updates..."),g=await G(d),X(a);else throw u}let h=g.latest;n.version===h?(s.stop("Up to date."),M.log.success(`Already on the latest version (${j.green(h)})`)):(s.stop("Update available."),M.log.warning(`Update available: ${j.yellow(n.version)} \u2192 ${j.green(h)}`),M.log.info(`Run ${j.cyan("generatesaas update")} to update skill files, then ask your AI assistant to apply the update.`))}catch(a){s.stop("Check failed."),M.log.warning(`Could not check for updates: ${T(a)}`)}})}import{readFile as Go}from"fs/promises";import*as C from"@clack/prompts";import Y from"picocolors";function Ko(e){let t=e.split(".");if(t.length!==3||!t[1])throw new Error("Invalid JWT format");let r=Buffer.from(t[1],"base64url").toString("utf-8");return JSON.parse(r)}function Ut(e){return typeof e!="number"?"unknown":new Date(e*1e3).toISOString().split("T")[0]}function fn(e){C.note([`License ID: ${Y.cyan(String(e.lid??"unknown"))}`,`Version: ${Y.cyan(String(e.ver??"unknown"))}`,`Init version: ${String(e.iver??"unknown")}`,`Frontend: ${String(e.fe??"unknown")}`,`Created: ${Ut(e.pat)}`,`Last updated: ${Ut(e.uat)}`,`Expires: ${Ut(e.exp)}`,`Install ID: ${String(e.nid??"unknown")}`].join(`
|
|
1101
|
+
`),Y.yellow("License Details"))}async function gn(e){let t=C.spinner(),r=e.replace(/\/+$/,"");t.start(`Checking ${r}/license...`);let i;try{let o=await fetch(`${r}/license`);if(!o.ok)return t.stop(`${Y.red("Not found")} \u2014 ${r}/license returned ${o.status}`),!1;if(i=await o.text(),!i||i.split(".").length!==3)return t.stop(`${Y.red("Invalid")} \u2014 response is not a JWT`),!1;t.stop(`${Y.green("Found")} \u2014 license endpoint responded`)}catch(o){return t.stop(`${Y.red("Failed")} \u2014 ${T(o)}`),!1}let n;try{n=Ko(i)}catch{return C.log.error("Could not decode JWT payload."),!1}t.start("Verifying signature...");try{let o=process.env.GENERATESAAS_API_URL??rt,s=await Zt(o,i);if(s.valid)t.stop(`${Y.green("Valid")} \u2014 signature verified`);else return t.stop(`${Y.red("Invalid")} \u2014 ${s.reason}`),!1}catch{return t.stop(`${Y.yellow("Skipped")} \u2014 could not reach verification service`),C.log.warn("Signature not verified. Displaying unverified claims:"),fn(n),!1}return fn(n),!0}function hn(e){e.command("verify").description("Verify a GenerateSaaS license on a deployed site").argument("[url]","URL of the site to verify (e.g. https://example.com/api)").option("--file <path>","file with URLs to check, one per line").action(async(t,r)=>{if(!t&&!r.file&&(C.cancel("Provide a URL or --file <path>."),process.exit(1)),r.file){let n=(await Go(r.file,"utf-8")).split(`
|
|
1102
|
+
`).map(s=>s.trim()).filter(s=>s&&!s.startsWith("#"));n.length===0&&(C.cancel("No URLs found in file."),process.exit(1));let o=0;for(let s of n)await gn(s)&&o++,C.log.info("");C.log.success(`${o}/${n.length} sites verified.`)}else await gn(t)||process.exit(1)})}import{existsSync as zo,rmSync as Ho}from"fs";import*as V from"@clack/prompts";function yn(e){e.command("auth").description("Set or update your GenerateSaaS API key").option("--clear","remove saved API key").action(async t=>{if(t.clear){zo(W)?(Ho(W),V.log.success("API key removed.")):V.log.info("No API key configured.");return}let r=Et();r?V.log.info(`Current API key: ****${r.slice(-4)}`):V.log.info("No API key configured.");let i=await Z(),n=$(i),o=V.spinner();o.start("Verifying API key...");try{await G(n),o.stop("API key verified."),X(i),V.log.success("API key saved.")}catch(s){o.stop("Verification failed."),s instanceof _&&s.status===401?V.cancel("Invalid API key."):V.cancel(T(s)),process.exit(1)}})}import{existsSync as ft,rmSync as Yo,readFileSync as Mt,writeFileSync as vn}from"fs";import{join as fe}from"path";import*as N from"@clack/prompts";var Jo=["packages/api/src/functions/maintenance/license-heartbeat.ts","packages/api/src/lib/manifest.ts","packages/api/src/routes/internal/license.ts"],qo=[{file:"packages/api/src/routes/inngest.ts",removals:[`import { licenseHeartbeatFunction } from "../functions/maintenance/license-heartbeat";
|
|
1103
1103
|
`,` licenseHeartbeatFunction,
|
|
1104
1104
|
`]},{file:"packages/api/src/routes/internal/index.ts",removals:[`import licenseRoutes from "./license";
|
|
1105
1105
|
`,` .route("/license", licenseRoutes)
|
|
1106
|
-
`]}];function
|
|
1107
|
-
`).filter(
|
|
1108
|
-
`);return
|
|
1106
|
+
`]}];function Wo(e){return(e&&e.length>0?e.map(r=>Me[r]):Object.values(Me)).map(r=>fe(r,Dt))}function jt(e){return ft(e)?(Yo(e,{recursive:!0}),!0):!1}function Xo(e,t){if(!ft(e))return!1;let r=Mt(e,"utf-8"),i=r;for(let n of t)i=i.replace(n,"");return i===r?!1:(vn(e,i,"utf-8"),!0)}function Zo(e){let t=fe(e,".gitignore");if(!ft(t))return!1;let r=Mt(t,"utf-8"),i=r.split(`
|
|
1107
|
+
`).filter(n=>!n.includes(".generatesaas")).join(`
|
|
1108
|
+
`);return i===r?!1:(vn(t,i,"utf-8"),!0)}function Sn(e){e.command("eject").description("Remove all GenerateSaaS ties \u2014 manifest, license, heartbeat, skills").action(async()=>{let t=process.cwd(),r=fe(t,Q),i;try{i=JSON.parse(Mt(r,"utf-8"))}catch{N.cancel("No GenerateSaaS project found in this directory."),process.exit(1)}let n=await N.text({message:'Type "eject" to confirm (this cannot be undone):',validate:a=>{if(a!=="eject")return'Type "eject" to confirm, or press Ctrl+C to cancel.'}});N.isCancel(n)&&(N.cancel("Eject cancelled."),process.exit(0));let o=[],s=[];for(let a of Wo(i.aiTools))jt(fe(t,a))&&o.push(a);for(let a of Jo)jt(fe(t,a))&&o.push(a);jt(fe(t,L))&&o.push(L+"/");for(let a of qo){let d=fe(t,a.file);Xo(d,a.removals)?s.push(a.file):ft(d)&&N.log.warn(`Could not auto-modify ${a.file} \u2014 manually remove license/heartbeat references.`)}Zo(t)&&s.push(".gitignore");for(let a of o)N.log.info(`Deleted ${a}`);for(let a of s)N.log.info(`Modified ${a}`);N.log.success("Ejected successfully. This project is now fully standalone.")})}var ge=new Qo().name("generatesaas").description("CLI for scaffolding and managing GenerateSaaS projects").version("1.1.1").addHelpText("after",`
|
|
1109
1109
|
Examples:
|
|
1110
1110
|
$ generatesaas init Interactive setup
|
|
1111
1111
|
$ generatesaas init -n my-app -y Quick setup with defaults
|
|
1112
1112
|
$ generatesaas status Check for updates
|
|
1113
1113
|
$ generatesaas auth Set or update API key
|
|
1114
|
-
`);
|
|
1114
|
+
`);pn(ge);un(ge);mn(ge);hn(ge);yn(ge);Sn(ge);ge.parseAsync().catch(e=>{En.cancel("An unexpected error occurred."),console.error(e),process.exit(1)});
|