create-nymbal-app 0.6.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +9 -0
- package/dist/index.d.ts +13 -2
- package/dist/index.js +45 -12
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/scaffold/templates/astro/README.md +49 -15
- package/scaffold/templates/astro/_dot.env.example +3 -1
- package/scaffold/templates/astro/astro.config.mjs +3 -0
- package/scaffold/templates/astro/package.json +25 -25
- package/scaffold/templates/astro/src/layouts/AccountLayout.astro +3 -6
- package/scaffold/templates/astro/src/layouts/BaseLayout.astro +5 -2
- package/scaffold/templates/astro/src/lib/api.ts +119 -13
- package/scaffold/templates/astro/src/lib/client.ts +9 -3
- package/scaffold/templates/astro/src/lib/page-policy.ts +24 -0
- package/scaffold/templates/astro/src/lib/reviews.ts +6 -0
- package/scaffold/templates/astro/src/lib/seo.ts +14 -1
- package/scaffold/templates/astro/src/lib/submit-once.ts +15 -2
- package/scaffold/templates/astro/src/middleware.ts +19 -10
- package/scaffold/templates/astro/src/pages/account/index.astro +1 -0
- package/scaffold/templates/astro/src/pages/account/orders/[orderNumber].astro +1 -1
- package/scaffold/templates/astro/src/pages/alerts/confirm.astro +3 -2
- package/scaffold/templates/astro/src/pages/alerts/unsubscribe.astro +3 -2
- package/scaffold/templates/astro/src/pages/cart.astro +18 -4
- package/scaffold/templates/astro/src/pages/checkout.astro +9 -2
- package/scaffold/templates/astro/src/pages/order/[orderNumber].astro +186 -60
- package/scaffold/templates/astro/src/pages/product/[slug].astro +10 -4
- package/scaffold/templates/astro/src/pages/products/index.astro +2 -1
- package/scaffold/templates/astro/src/scripts/order-access.ts +181 -0
- package/scaffold/templates/astro/src/scripts/pdp.ts +1 -0
- package/scaffold/templates/astro/src/scripts/plp.ts +1 -0
- package/scaffold/templates/astro/src/scripts/search.ts +1 -0
- package/scaffold/templates/astro/src/scripts/signed-in-redirect.ts +14 -1
- package/scaffold/templates/astro/src/styles/global.css +3 -0
- package/scaffold/templates/astro/src/styles/pages/pdp.css +7 -4
- package/scaffold/templates/nextjs/README.md +49 -15
- package/scaffold/templates/nextjs/_dot.env.example +3 -1
- package/scaffold/templates/nextjs/app/(catalog)/home/[key]/page.tsx +2 -2
- package/scaffold/templates/nextjs/app/(catalog)/product/[slug]/page.tsx +24 -20
- package/scaffold/templates/nextjs/app/(catalog)/products/page.tsx +8 -5
- package/scaffold/templates/nextjs/app/(catalog)/search/SearchView.tsx +1 -1
- package/scaffold/templates/nextjs/app/(shopper)/account/login/LoginView.tsx +4 -4
- package/scaffold/templates/nextjs/app/(shopper)/account/login/page.tsx +3 -1
- package/scaffold/templates/nextjs/app/(shopper)/alerts/actions.ts +6 -3
- package/scaffold/templates/nextjs/app/(shopper)/cart/page.tsx +21 -5
- package/scaffold/templates/nextjs/app/(shopper)/checkout/CheckoutView.tsx +6 -2
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/OrderDetails.tsx +23 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/OrderEmailPrompt.tsx +112 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/OrderLinkForm.tsx +89 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/OrderNotFound.tsx +30 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/OrderView.tsx +140 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/OwnerRedirect.tsx +48 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/actions.ts +56 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/not-found.tsx +6 -0
- package/scaffold/templates/nextjs/app/(shopper)/order/[orderNumber]/page.tsx +9 -137
- package/scaffold/templates/nextjs/app/error.tsx +9 -3
- package/scaffold/templates/nextjs/app/globals.css +3 -0
- package/scaffold/templates/nextjs/components/client/AuthGuard.tsx +2 -2
- package/scaffold/templates/nextjs/components/client/NymbalSetup.tsx +1 -2
- package/scaffold/templates/nextjs/components/server/Header.tsx +5 -2
- package/scaffold/templates/nextjs/lib/api.ts +118 -12
- package/scaffold/templates/nextjs/lib/chrome.ts +9 -5
- package/scaffold/templates/nextjs/lib/client.ts +5 -7
- package/scaffold/templates/nextjs/lib/header.ts +15 -0
- package/scaffold/templates/nextjs/lib/page-policy.mjs +24 -0
- package/scaffold/templates/nextjs/lib/reviews.ts +6 -0
- package/scaffold/templates/nextjs/lib/seo.ts +19 -15
- package/scaffold/templates/nextjs/lib/signed-in-target.ts +11 -0
- package/scaffold/templates/nextjs/next.config.mjs +10 -1
- package/scaffold/templates/nextjs/package.json +26 -26
- package/scaffold/templates/astro/src/scripts/account-guard.ts +0 -22
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 nymbal contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# create-nymbal-app
|
|
2
|
+
|
|
3
|
+
Creates a Nymbal store: an Astro or Next.js storefront, its config, demo products and an admin account.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npx create-nymbal-app my-store
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
Then follow the [quickstart](https://github.com/nymbalhq/nymbal/blob/main/apps/docs/src/content/docs/quickstart.md).
|
package/dist/index.d.ts
CHANGED
|
@@ -11,6 +11,13 @@ interface Answers {
|
|
|
11
11
|
* Injected into `main` so tests do not shell out.
|
|
12
12
|
*/
|
|
13
13
|
type Runner = (cmd: string, args: string[], cwd: string, env?: NodeJS.ProcessEnv) => Promise<void>;
|
|
14
|
+
/**
|
|
15
|
+
* An admin address no other store shares, so an attacker does not start from a known login: eight base32 characters
|
|
16
|
+
* (40 bits). It receives no mail; the merchant reads it from `.env` and the outro.
|
|
17
|
+
*/
|
|
18
|
+
declare function randomAdminEmail(): string;
|
|
19
|
+
/** Why `value` is not an admin email (one `@` with text either side, no whitespace), or undefined when it is one. */
|
|
20
|
+
declare function adminEmailProblem(value: string | undefined): string | undefined;
|
|
14
21
|
interface MainDeps {
|
|
15
22
|
run?: Runner;
|
|
16
23
|
}
|
|
@@ -24,15 +31,19 @@ interface CliFlags {
|
|
|
24
31
|
yes: boolean;
|
|
25
32
|
/** Present (false) only with `--no-install`. */
|
|
26
33
|
install?: boolean;
|
|
34
|
+
adminEmail?: string;
|
|
27
35
|
}
|
|
28
36
|
/** A command-line flag that is missing its value or names a value outside the allowed set. */
|
|
29
37
|
declare class CliFlagError extends Error {
|
|
30
38
|
constructor(message: string);
|
|
31
39
|
}
|
|
32
|
-
/**
|
|
40
|
+
/**
|
|
41
|
+
* Parses process.argv (node and script first): --name, --template, --currency and --admin-email take `--flag v` or
|
|
42
|
+
* `--flag=v`.
|
|
43
|
+
*/
|
|
33
44
|
declare function parseCliFlags(argv: string[]): CliFlags;
|
|
34
45
|
declare function main(argv?: string[], deps?: MainDeps): Promise<void>;
|
|
35
46
|
declare function scaffold(dir: string, answers: Answers): Promise<void>;
|
|
36
47
|
|
|
37
|
-
export { CliFlagError, detectPackageManager, main, parseCliFlags, scaffold };
|
|
48
|
+
export { CliFlagError, adminEmailProblem, detectPackageManager, main, parseCliFlags, randomAdminEmail, scaffold };
|
|
38
49
|
export type { CliFlags, MainDeps, PackageManager, Runner };
|
package/dist/index.js
CHANGED
|
@@ -10,12 +10,23 @@ import pc from "picocolors";
|
|
|
10
10
|
var HERE = dirname(fileURLToPath(import.meta.url));
|
|
11
11
|
var SCAFFOLD_ROOT = resolve(HERE, "..", "scaffold");
|
|
12
12
|
var API_PORT = 3001;
|
|
13
|
+
var HELP_LINE = "Problems or questions: https://github.com/nymbalhq/nymbal/issues";
|
|
13
14
|
var STOREFRONT_ORIGIN = {
|
|
14
15
|
astro: "http://localhost:4321",
|
|
15
16
|
nextjs: "http://localhost:3000"
|
|
16
17
|
};
|
|
17
|
-
|
|
18
|
-
|
|
18
|
+
var BASE32 = "abcdefghijklmnopqrstuvwxyz234567";
|
|
19
|
+
function randomAdminEmail() {
|
|
20
|
+
const bits = randomBytes(5).readUIntBE(0, 5);
|
|
21
|
+
let local = "";
|
|
22
|
+
for (let i = 7; i >= 0; i--) local += BASE32[Math.floor(bits / 32 ** i) % 32];
|
|
23
|
+
return `admin-${local}@nymbal.local`;
|
|
24
|
+
}
|
|
25
|
+
function adminEmailProblem(value) {
|
|
26
|
+
return /^[^\s@]+@[^\s@]+$/.test(value ?? "") ? void 0 : "Enter an email address, such as you@shop.com";
|
|
27
|
+
}
|
|
28
|
+
function newAdminCredentials(email = randomAdminEmail()) {
|
|
29
|
+
return { email, password: randomBytes(16).toString("base64url") };
|
|
19
30
|
}
|
|
20
31
|
async function writeAdminEnv(dir, admin) {
|
|
21
32
|
const lines = [
|
|
@@ -25,6 +36,9 @@ async function writeAdminEnv(dir, admin) {
|
|
|
25
36
|
"",
|
|
26
37
|
"# Encrypts the keys saved in the admin's Settings. Losing it loses them: back it up with your deploy's secrets.",
|
|
27
38
|
`NYMBAL_SECRETS_KEY=${randomBytes(32).toString("base64")}`,
|
|
39
|
+
"",
|
|
40
|
+
"# Signs sign-in tokens. Changing it signs everyone out: deploy it with your secrets, as the key above.",
|
|
41
|
+
`NYMBAL_JWT_SECRET=${randomBytes(32).toString("base64url")}`,
|
|
28
42
|
""
|
|
29
43
|
];
|
|
30
44
|
await writeFile(resolve(dir, ".env"), lines.join("\n"), { encoding: "utf8", mode: 384 });
|
|
@@ -125,7 +139,7 @@ function parseCliFlags(argv) {
|
|
|
125
139
|
flags.install = false;
|
|
126
140
|
continue;
|
|
127
141
|
}
|
|
128
|
-
const match = /^--(name|template|currency)(?:=(.*))?$/s.exec(arg);
|
|
142
|
+
const match = /^--(name|template|currency|admin-email)(?:=(.*))?$/s.exec(arg);
|
|
129
143
|
if (match) {
|
|
130
144
|
const flag = match[1];
|
|
131
145
|
let value = match[2];
|
|
@@ -138,7 +152,12 @@ function parseCliFlags(argv) {
|
|
|
138
152
|
}
|
|
139
153
|
if (flag === "name") flags.name = value;
|
|
140
154
|
else if (flag === "template") flags.template = oneOf("--template", value, TEMPLATES);
|
|
141
|
-
else flags.currency = oneOf("--currency", value, CURRENCIES);
|
|
155
|
+
else if (flag === "currency") flags.currency = oneOf("--currency", value, CURRENCIES);
|
|
156
|
+
else {
|
|
157
|
+
const problem = adminEmailProblem(value);
|
|
158
|
+
if (problem) throw new CliFlagError(`Invalid --admin-email "${value}". ${problem}`);
|
|
159
|
+
flags.adminEmail = value;
|
|
160
|
+
}
|
|
142
161
|
} else if (!arg.startsWith("-") && positional === void 0) {
|
|
143
162
|
positional = arg;
|
|
144
163
|
}
|
|
@@ -185,7 +204,7 @@ async function main(argv = process.argv, deps = {}) {
|
|
|
185
204
|
await mkdir(targetDir2, { recursive: true });
|
|
186
205
|
}
|
|
187
206
|
await scaffold(targetDir2, answers2);
|
|
188
|
-
const admin2 = newAdminCredentials();
|
|
207
|
+
const admin2 = newAdminCredentials(flags.adminEmail);
|
|
189
208
|
await writeAdminEnv(targetDir2, admin2);
|
|
190
209
|
process.stdout.write(`Created ${answers2.directory}
|
|
191
210
|
`);
|
|
@@ -195,7 +214,7 @@ async function main(argv = process.argv, deps = {}) {
|
|
|
195
214
|
process.stdout.write(`Next: cd ${answers2.directory} && ${installCmd(pm)[0]} install
|
|
196
215
|
`);
|
|
197
216
|
}
|
|
198
|
-
process.stdout.write(`${adminSignIn(admin2).join("\n")}
|
|
217
|
+
process.stdout.write(`${[...adminSignIn(admin2), "", HELP_LINE].join("\n")}
|
|
199
218
|
`);
|
|
200
219
|
return;
|
|
201
220
|
}
|
|
@@ -206,6 +225,12 @@ async function main(argv = process.argv, deps = {}) {
|
|
|
206
225
|
validate: (v) => !v || v.trim().length === 0 ? "Required" : void 0
|
|
207
226
|
});
|
|
208
227
|
if (isCancel(name)) return cancel("Cancelled");
|
|
228
|
+
const adminEmail = flags.adminEmail ? flags.adminEmail : await text({
|
|
229
|
+
message: "Admin email",
|
|
230
|
+
initialValue: randomAdminEmail(),
|
|
231
|
+
validate: adminEmailProblem
|
|
232
|
+
});
|
|
233
|
+
if (isCancel(adminEmail)) return cancel("Cancelled");
|
|
209
234
|
const currencyOptions = [
|
|
210
235
|
{ value: "GBP", label: "GBP \u2014 British Pound" },
|
|
211
236
|
{ value: "USD", label: "USD \u2014 US Dollar" },
|
|
@@ -256,7 +281,7 @@ async function main(argv = process.argv, deps = {}) {
|
|
|
256
281
|
}
|
|
257
282
|
note(pc.dim(`Scaffolding into ${targetDir}`), "Creating project");
|
|
258
283
|
await scaffold(targetDir, answers);
|
|
259
|
-
const admin = newAdminCredentials();
|
|
284
|
+
const admin = newAdminCredentials(String(adminEmail).trim());
|
|
260
285
|
await writeAdminEnv(targetDir, admin);
|
|
261
286
|
if (shouldInstall) {
|
|
262
287
|
await installAndSeed(targetDir, pm, answers.seedDemo, run, admin);
|
|
@@ -269,9 +294,15 @@ async function main(argv = process.argv, deps = {}) {
|
|
|
269
294
|
}
|
|
270
295
|
nextSteps.push(` ${pc.cyan(cmd)}`);
|
|
271
296
|
outro(
|
|
272
|
-
[
|
|
273
|
-
|
|
274
|
-
|
|
297
|
+
[
|
|
298
|
+
pc.green(`\u2713 Created ${answers.directory}`),
|
|
299
|
+
"",
|
|
300
|
+
...nextSteps,
|
|
301
|
+
"",
|
|
302
|
+
...adminSignIn(admin),
|
|
303
|
+
"",
|
|
304
|
+
HELP_LINE
|
|
305
|
+
].join("\n")
|
|
275
306
|
);
|
|
276
307
|
}
|
|
277
308
|
async function installAndSeed(dir, pm, seedDemo, run, admin) {
|
|
@@ -345,8 +376,8 @@ export default defineConfig({
|
|
|
345
376
|
|
|
346
377
|
infrastructure: {
|
|
347
378
|
commandStore: 'sqlite',
|
|
348
|
-
documentStore: 'in-memory',
|
|
349
|
-
eventBus: 'in-process',
|
|
379
|
+
documentStore: { provider: 'in-memory' },
|
|
380
|
+
eventBus: { provider: 'in-process' },
|
|
350
381
|
},
|
|
351
382
|
|
|
352
383
|
security: {
|
|
@@ -419,9 +450,11 @@ var runCmd = (cmd, args, cwd, env = process.env) => {
|
|
|
419
450
|
};
|
|
420
451
|
export {
|
|
421
452
|
CliFlagError,
|
|
453
|
+
adminEmailProblem,
|
|
422
454
|
detectPackageManager,
|
|
423
455
|
main,
|
|
424
456
|
parseCliFlags,
|
|
457
|
+
randomAdminEmail,
|
|
425
458
|
scaffold
|
|
426
459
|
};
|
|
427
460
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { cp, readFile, mkdir, readdir, rm, writeFile } from 'node:fs/promises'\nimport { existsSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { spawn, spawnSync } from 'node:child_process'\nimport { randomBytes } from 'node:crypto'\nimport { cancel, confirm, intro, isCancel, note, outro, select, text } from '@clack/prompts'\nimport pc from 'picocolors'\n\nconst HERE = dirname(fileURLToPath(import.meta.url))\nconst SCAFFOLD_ROOT = resolve(HERE, '..', 'scaffold')\n\nexport type PackageManager = 'npm' | 'pnpm' | 'yarn-classic' | 'yarn-berry' | 'bun'\n\ninterface Answers {\n name: string\n directory: string\n currency: 'GBP' | 'USD' | 'EUR'\n template: 'astro' | 'nextjs'\n seedDemo: boolean\n}\n\n/**\n * Runs a command in `cwd` (with `env` when given, else the process environment) and rejects on a non-zero exit.\n * Injected into `main` so tests do not shell out.\n */\nexport type Runner = (\n cmd: string,\n args: string[],\n cwd: string,\n env?: NodeJS.ProcessEnv,\n) => Promise<void>\n\n/** The port `renderConfig` gives the API, which serves the admin at /admin/. */\nconst API_PORT = 3001\n\n/** Each template's dev server origin, the storefront URL a new store starts with. */\nconst STOREFRONT_ORIGIN: Record<Answers['template'], string> = {\n astro: 'http://localhost:4321',\n nextjs: 'http://localhost:3000',\n}\n\ninterface AdminCredentials {\n email: string\n password: string\n}\n\n/** A fresh admin password per project (128 bits, base64url), so no two stores share the seed's default. */\nfunction newAdminCredentials(): AdminCredentials {\n return { email: 'admin@nymbal.local', password: randomBytes(16).toString('base64url') }\n}\n\n/**\n * `.env` holds the admin credentials the seed (and a first `nymbal dev`) creates the admin from, and the project's own\n * key for the values the admin's Settings encrypt (32 random bytes, base64).\n */\nasync function writeAdminEnv(dir: string, admin: AdminCredentials): Promise<void> {\n const lines = [\n '# The admin account the seed creates. Keep this file out of version control (.gitignore lists it).',\n `NYMBAL_ADMIN_EMAIL=${admin.email}`,\n `NYMBAL_ADMIN_PASSWORD=${admin.password}`,\n '',\n \"# Encrypts the keys saved in the admin's Settings. Losing it loses them: back it up with your deploy's secrets.\",\n `NYMBAL_SECRETS_KEY=${randomBytes(32).toString('base64')}`,\n '',\n ]\n await writeFile(resolve(dir, '.env'), lines.join('\\n'), { encoding: 'utf8', mode: 0o600 })\n}\n\nfunction adminSignIn(admin: AdminCredentials): string[] {\n return [\n `Admin: http://localhost:${API_PORT}/admin/`,\n ` email ${admin.email}`,\n ` password ${admin.password} (saved in .env)`,\n ]\n}\n\nexport interface MainDeps {\n run?: Runner\n}\n\n/**\n * The `packageManager` field for the package manager that launched us (`npm_config_user_agent`), read when called.\n * Without a usable user agent it is the installed npm; undefined when npm cannot be run either.\n */\nfunction packageManagerField(): string | undefined {\n const token = (process.env['npm_config_user_agent'] ?? '').split(' ')[0] ?? ''\n const match = /^(npm|pnpm|yarn|bun)\\/(\\d+\\.\\d+\\.\\d+\\S*)$/.exec(token)\n if (match) return `${match[1]}@${match[2]}`\n const npm = spawnSync('npm', ['-v'], { encoding: 'utf8', shell: process.platform === 'win32' })\n const version = npm.status === 0 ? npm.stdout.trim() : ''\n return version ? `npm@${version}` : undefined\n}\n\nexport function detectPackageManager(): PackageManager {\n const ua = process.env['npm_config_user_agent']\n if (!ua) return 'npm'\n const token = ua.split(' ')[0] ?? ''\n const slash = token.indexOf('/')\n const pm = slash >= 0 ? token.slice(0, slash) : token\n const version = slash >= 0 ? token.slice(slash + 1) : ''\n if (pm === 'pnpm') return 'pnpm'\n if (pm === 'bun') return 'bun'\n if (pm === 'yarn') {\n const major = parseInt(version.split('.')[0] ?? '1', 10)\n return major < 2 ? 'yarn-classic' : 'yarn-berry'\n }\n return 'npm'\n}\n\nfunction installCmd(pm: PackageManager): [string, string[]] {\n switch (pm) {\n case 'pnpm':\n return ['pnpm', ['install']]\n case 'bun':\n return ['bun', ['install']]\n case 'yarn-classic':\n case 'yarn-berry':\n return ['yarn', ['install']]\n default:\n return ['npm', ['install']]\n }\n}\n\nfunction seedCmd(pm: PackageManager): [string, string[]] {\n switch (pm) {\n case 'pnpm':\n return ['pnpm', ['exec', 'nymbal', 'seed']]\n case 'bun':\n return ['bunx', ['nymbal', 'seed']]\n case 'yarn-classic':\n return ['yarn', ['run', 'nymbal', 'seed']]\n case 'yarn-berry':\n return ['yarn', ['exec', 'nymbal', 'seed']]\n default:\n return ['npx', ['nymbal', 'seed']]\n }\n}\n\nfunction devCmd(pm: PackageManager): string {\n switch (pm) {\n case 'pnpm':\n return 'pnpm dev'\n case 'bun':\n return 'bun dev'\n case 'yarn-classic':\n case 'yarn-berry':\n return 'yarn dev'\n default:\n return 'npm run dev'\n }\n}\n\nconst TEMPLATES = ['astro', 'nextjs'] as const\nconst CURRENCIES = ['GBP', 'USD', 'EUR'] as const\n\nexport interface CliFlags {\n name?: string\n template?: (typeof TEMPLATES)[number]\n currency?: (typeof CURRENCIES)[number]\n yes: boolean\n /** Present (false) only with `--no-install`. */\n install?: boolean\n}\n\n/** A command-line flag that is missing its value or names a value outside the allowed set. */\nexport class CliFlagError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'CliFlagError'\n }\n}\n\nfunction oneOf<T extends string>(flag: string, value: string, allowed: readonly T[]): T {\n if ((allowed as readonly string[]).includes(value)) return value as T\n throw new CliFlagError(`Unknown ${flag} \"${value}\". Allowed: ${allowed.join(', ')}`)\n}\n\n/** Parses process.argv (node and script first): --name, --template and --currency take `--flag v` or `--flag=v`. */\nexport function parseCliFlags(argv: string[]): CliFlags {\n const flags: CliFlags = { yes: false }\n const args = argv.slice(2)\n let positional: string | undefined\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!\n if (arg === '--yes' || arg === '-y') {\n flags.yes = true\n continue\n }\n if (arg === '--no-install') {\n flags.install = false\n continue\n }\n const match = /^--(name|template|currency)(?:=(.*))?$/s.exec(arg)\n if (match) {\n const flag = match[1]!\n let value = match[2]\n if (value === undefined) {\n const next = args[i + 1]\n if (next === undefined || next.startsWith('-'))\n throw new CliFlagError(`--${flag} needs a value`)\n value = next\n i++\n }\n if (flag === 'name') flags.name = value\n else if (flag === 'template') flags.template = oneOf('--template', value, TEMPLATES)\n else flags.currency = oneOf('--currency', value, CURRENCIES)\n } else if (!arg.startsWith('-') && positional === undefined) {\n positional = arg\n }\n }\n if (flags.name === undefined && positional !== undefined) flags.name = positional\n return flags\n}\n\nexport async function main(argv: string[] = process.argv, deps: MainDeps = {}): Promise<void> {\n const run = deps.run ?? runCmd\n let flags: CliFlags\n try {\n flags = parseCliFlags(argv)\n } catch (err) {\n if (!(err instanceof CliFlagError)) throw err\n process.stderr.write(`Error: ${err.message}\\n`)\n process.exit(1)\n }\n\n const pm = detectPackageManager()\n\n if (flags.yes) {\n if (!flags.name) {\n process.stderr.write('Error: --yes requires --name or a positional name argument\\n')\n process.exit(1)\n }\n const name = flags.name.trim()\n const answers: Answers = {\n name,\n directory: toDirectoryName(name),\n currency: flags.currency ?? 'GBP',\n template: flags.template ?? 'astro',\n seedDemo: true,\n }\n const targetDir = resolve(process.cwd(), answers.directory)\n if (existsSync(targetDir)) {\n const entries = await readdir(targetDir)\n if (entries.length > 0) {\n process.stderr.write(\n `Error: Directory ${answers.directory} already exists and is not empty.\\n`,\n )\n process.exit(1)\n }\n } else {\n await mkdir(targetDir, { recursive: true })\n }\n await scaffold(targetDir, answers)\n const admin = newAdminCredentials()\n await writeAdminEnv(targetDir, admin)\n process.stdout.write(`Created ${answers.directory}\\n`)\n if (flags.install !== false) {\n await installAndSeed(targetDir, pm, answers.seedDemo, run, admin)\n } else {\n process.stdout.write(`Next: cd ${answers.directory} && ${installCmd(pm)[0]} install\\n`)\n }\n process.stdout.write(`${adminSignIn(admin).join('\\n')}\\n`)\n return\n }\n\n intro(pc.cyan(pc.bold('◆ create-nymbal-app')))\n\n const name = flags.name\n ? flags.name\n : ((await text({\n message: 'Store name',\n placeholder: 'My Store',\n validate: (v) => (!v || v.trim().length === 0 ? 'Required' : undefined),\n })) as string | symbol)\n\n if (isCancel(name)) return cancel('Cancelled')\n\n type Currency = 'GBP' | 'USD' | 'EUR'\n const currencyOptions: { value: Currency; label: string }[] = [\n { value: 'GBP', label: 'GBP — British Pound' },\n { value: 'USD', label: 'USD — US Dollar' },\n { value: 'EUR', label: 'EUR — Euro' },\n ]\n const currency = await select({\n message: 'Store currency',\n options: currencyOptions,\n initialValue: 'GBP' as Currency,\n })\n\n if (isCancel(currency)) return cancel('Cancelled')\n\n type Template = 'astro' | 'nextjs'\n const templateOptions: { value: Template; label: string }[] = [\n { value: 'astro', label: 'Astro (recommended — performance-first)' },\n { value: 'nextjs', label: 'Next.js (migration-friendly)' },\n ]\n const template = await select({\n message: 'Storefront template',\n options: templateOptions,\n initialValue: 'astro' as Template,\n })\n\n if (isCancel(template)) return cancel('Cancelled')\n\n const seedDemo = (await confirm({\n message: 'Generate demo content?',\n initialValue: true,\n })) as boolean | symbol\n\n if (isCancel(seedDemo)) return cancel('Cancelled')\n\n const shouldInstall =\n flags.install === false\n ? false\n : ((await confirm({\n message: 'Install dependencies now?',\n initialValue: true,\n })) as boolean | symbol)\n\n if (isCancel(shouldInstall)) return cancel('Cancelled')\n\n const answers: Answers = {\n name: String(name).trim(),\n directory: toDirectoryName(String(name).trim()),\n currency: currency as 'GBP' | 'USD' | 'EUR',\n template: template as 'astro' | 'nextjs',\n seedDemo: seedDemo as boolean,\n }\n\n const targetDir = resolve(process.cwd(), answers.directory)\n if (existsSync(targetDir)) {\n const entries = await readdir(targetDir)\n if (entries.length > 0) {\n cancel(`Directory ${answers.directory} already exists and is not empty.`)\n process.exit(1)\n }\n } else {\n await mkdir(targetDir, { recursive: true })\n }\n\n note(pc.dim(`Scaffolding into ${targetDir}`), 'Creating project')\n\n await scaffold(targetDir, answers)\n const admin = newAdminCredentials()\n await writeAdminEnv(targetDir, admin)\n\n if (shouldInstall) {\n await installAndSeed(targetDir, pm, answers.seedDemo, run, admin)\n }\n\n const cmd = devCmd(pm)\n const nextSteps = [` ${pc.cyan('cd')} ${answers.directory}`]\n if (!shouldInstall) {\n const [ic] = installCmd(pm)\n nextSteps.push(` ${pc.cyan(ic + ' install')}`)\n }\n nextSteps.push(` ${pc.cyan(cmd)}`)\n\n outro(\n [pc.green(`✓ Created ${answers.directory}`), '', ...nextSteps, '', ...adminSignIn(admin)].join(\n '\\n',\n ),\n )\n}\n\n/** Install with the detected package manager, then seed through the project's own `nymbal` bin. */\nasync function installAndSeed(\n dir: string,\n pm: PackageManager,\n seedDemo: boolean,\n run: Runner,\n admin: AdminCredentials,\n): Promise<void> {\n const [installBin, installArgs] = installCmd(pm)\n process.stdout.write(`Running ${installBin} install (this may take a moment)...\\n`)\n await run(installBin, installArgs, dir)\n if (seedDemo) {\n process.stdout.write('Seeding demo content...\\n')\n const [seedBin, seedArgs] = seedCmd(pm)\n // Explicit, so a value exported in the shell cannot replace the one in .env and the outro.\n await run(seedBin, seedArgs, dir, {\n ...process.env,\n NYMBAL_ADMIN_EMAIL: admin.email,\n NYMBAL_ADMIN_PASSWORD: admin.password,\n })\n }\n}\n\nexport async function scaffold(dir: string, answers: Answers): Promise<void> {\n // Copy the chosen template directly into dir (flat — no storefront/ subdirectory)\n await copyScaffoldDir(resolve(SCAFFOLD_ROOT, 'templates', answers.template), dir)\n\n // Overlay the project layer (scaffold/project/<template>) on top of the template\n // defaults. Project files WIN on path collision — this is the override model:\n // anything in the project layer shadows the template default at the same path.\n // scaffold/project/ lives outside scaffold/templates/, so sync-scaffold's\n // rm -rf of scaffold/templates/* never deletes it.\n const projectLayer = resolve(SCAFFOLD_ROOT, 'project', answers.template)\n if (existsSync(projectLayer)) {\n await copyScaffoldDir(projectLayer, dir)\n }\n\n // Write nymbal.config.ts (answers-dependent, so generated at runtime)\n await writeFile(resolve(dir, 'nymbal.config.ts'), renderConfig(answers), 'utf8')\n\n // Patch the copied package.json: set name to the project directory name\n await patchPackageJson(dir, answers.directory)\n}\n\nasync function patchPackageJson(dir: string, name: string): Promise<void> {\n const pkgPath = resolve(dir, 'package.json')\n const pkg = JSON.parse(await readFile(pkgPath, 'utf8')) as Record<string, unknown>\n pkg['name'] = name\n pkg['private'] = true\n const packageManager = packageManagerField()\n if (packageManager) pkg['packageManager'] = packageManager\n await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\\n', 'utf8')\n}\n\nasync function copyScaffoldDir(src: string, dest: string): Promise<void> {\n if (!existsSync(src)) {\n throw new Error(`Scaffold directory not found: ${src}`)\n }\n await cp(src, dest, {\n recursive: true,\n filter: (source) => !source.endsWith('node_modules'),\n })\n await renameDotFiles(dest)\n}\n\nasync function renameDotFiles(dir: string): Promise<void> {\n // Non-recursive: only rename _dot.* files at the project root.\n // All shared dotfiles (_dot.gitignore, _dot.env.example) live at template root.\n const entries = await readdir(dir, { withFileTypes: true })\n for (const entry of entries) {\n if (!entry.isDirectory() && entry.name.startsWith('_dot.')) {\n const full = resolve(dir, entry.name)\n const renamed = resolve(dir, '.' + entry.name.slice(5))\n await writeFile(renamed, await readFile(full))\n await rm(full)\n }\n }\n}\n\nfunction renderConfig(answers: Answers): string {\n return `import { defineConfig, env } from '@nymbalhq/config'\n\nexport default defineConfig({\n store: {\n name: '${escape(answers.name)}',\n currency: '${answers.currency}',\n locale: '${defaultLocale(answers.currency)}',\n timezone: '${defaultTimezone(answers.currency)}',\n // The storefront's public origin: the order email links to its order page. Set it for production.\n url: env('NYMBAL_STOREFRONT_URL', '${STOREFRONT_ORIGIN[answers.template]}'),\n },\n\n template: '${answers.template}',\n\n infrastructure: {\n commandStore: 'sqlite',\n documentStore: 'in-memory',\n eventBus: 'in-process',\n },\n\n security: {\n adapter: 'middleware',\n rateLimit: {\n '/checkout': { requests: 10, window: '1m', action: 'block' },\n '/auth/*': { requests: 5, window: '1m', action: 'challenge' },\n '/api/*': { requests: 100, window: '1m', action: 'throttle' },\n '/webhooks/*': { requests: 200, window: '1m', action: 'throttle' },\n },\n botProtection: { mode: 'managed', allowList: ['googlebot', 'bingbot', 'stripe-webhooks'] },\n headers: {\n hsts: true,\n contentSecurityPolicy: 'strict',\n referrerPolicy: 'strict-origin-when-cross-origin',\n xFrameOptions: 'deny',\n },\n csrf: true,\n },\n\n commerce: {\n payments: { provider: 'native' },\n email: { provider: 'native' },\n reviews: { provider: 'native' },\n search: { provider: 'native' },\n analytics: { provider: 'native' },\n shipping: { provider: 'native' },\n tax: { provider: 'native' },\n ai: { provider: 'none' },\n },\n\n http: {\n adapter: 'fastify',\n port: ${API_PORT},\n },\n\n deployment: {\n strategy: 'standard',\n },\n\n features: {\n staging: false,\n heartbeat: false,\n autoUpdates: false,\n },\n})\n`\n}\n\nfunction defaultLocale(currency: Answers['currency']): string {\n return currency === 'USD' ? 'en-US' : 'en-GB'\n}\n\nfunction defaultTimezone(currency: Answers['currency']): string {\n return currency === 'USD' ? 'America/New_York' : 'Europe/London'\n}\n\nfunction escape(v: string): string {\n return v.replace(/'/g, \"\\\\'\")\n}\n\nfunction toDirectoryName(name: string): string {\n return name\n .toLowerCase()\n .replace(/[^a-z0-9-_ ]/g, '')\n .trim()\n .replace(/\\s+/g, '-')\n}\n\nconst runCmd: Runner = (cmd, args, cwd, env = process.env) => {\n return new Promise((resolve, reject) => {\n const child = spawn(cmd, args, { cwd, env, stdio: 'inherit', shell: false })\n child.on('error', reject)\n child.on('exit', (code) => {\n if (code === 0) return resolve()\n reject(new Error(`${cmd} ${args.join(' ')} exited with ${code}`))\n })\n })\n}\n"],"mappings":"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","names":["name","answers","targetDir","admin","resolve"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { cp, readFile, mkdir, readdir, rm, writeFile } from 'node:fs/promises'\nimport { existsSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { spawn, spawnSync } from 'node:child_process'\nimport { randomBytes } from 'node:crypto'\nimport { cancel, confirm, intro, isCancel, note, outro, select, text } from '@clack/prompts'\nimport pc from 'picocolors'\n\nconst HERE = dirname(fileURLToPath(import.meta.url))\nconst SCAFFOLD_ROOT = resolve(HERE, '..', 'scaffold')\n\nexport type PackageManager = 'npm' | 'pnpm' | 'yarn-classic' | 'yarn-berry' | 'bun'\n\ninterface Answers {\n name: string\n directory: string\n currency: 'GBP' | 'USD' | 'EUR'\n template: 'astro' | 'nextjs'\n seedDemo: boolean\n}\n\n/**\n * Runs a command in `cwd` (with `env` when given, else the process environment) and rejects on a non-zero exit.\n * Injected into `main` so tests do not shell out.\n */\nexport type Runner = (\n cmd: string,\n args: string[],\n cwd: string,\n env?: NodeJS.ProcessEnv,\n) => Promise<void>\n\n/** The port `renderConfig` gives the API, which serves the admin at /admin/. */\nconst API_PORT = 3001\n/** The last line create-nymbal-app prints: where a new store's developer reports a problem. */\nconst HELP_LINE = 'Problems or questions: https://github.com/nymbalhq/nymbal/issues'\n\n/** Each template's dev server origin, the storefront URL a new store starts with. */\nconst STOREFRONT_ORIGIN: Record<Answers['template'], string> = {\n astro: 'http://localhost:4321',\n nextjs: 'http://localhost:3000',\n}\n\ninterface AdminCredentials {\n email: string\n password: string\n}\n\nconst BASE32 = 'abcdefghijklmnopqrstuvwxyz234567'\n\n/**\n * An admin address no other store shares, so an attacker does not start from a known login: eight base32 characters\n * (40 bits). It receives no mail; the merchant reads it from `.env` and the outro.\n */\nexport function randomAdminEmail(): string {\n const bits = randomBytes(5).readUIntBE(0, 5)\n let local = ''\n for (let i = 7; i >= 0; i--) local += BASE32[Math.floor(bits / 32 ** i) % 32]\n return `admin-${local}@nymbal.local`\n}\n\n/** Why `value` is not an admin email (one `@` with text either side, no whitespace), or undefined when it is one. */\nexport function adminEmailProblem(value: string | undefined): string | undefined {\n return /^[^\\s@]+@[^\\s@]+$/.test(value ?? '')\n ? undefined\n : 'Enter an email address, such as you@shop.com'\n}\n\n/** The admin account the seed creates: the given address or a random one, and a fresh password (128 bits). */\nfunction newAdminCredentials(email: string = randomAdminEmail()): AdminCredentials {\n return { email, password: randomBytes(16).toString('base64url') }\n}\n\n/**\n * `.env` holds the admin credentials the seed (and a first `nymbal dev`) creates the admin from, and the project's own\n * key for the values the admin's Settings encrypt (32 random bytes, base64) and its own JWT secret (32 random bytes,\n * base64url), which the platform reads at run time so the config never holds it.\n */\nasync function writeAdminEnv(dir: string, admin: AdminCredentials): Promise<void> {\n const lines = [\n '# The admin account the seed creates. Keep this file out of version control (.gitignore lists it).',\n `NYMBAL_ADMIN_EMAIL=${admin.email}`,\n `NYMBAL_ADMIN_PASSWORD=${admin.password}`,\n '',\n \"# Encrypts the keys saved in the admin's Settings. Losing it loses them: back it up with your deploy's secrets.\",\n `NYMBAL_SECRETS_KEY=${randomBytes(32).toString('base64')}`,\n '',\n '# Signs sign-in tokens. Changing it signs everyone out: deploy it with your secrets, as the key above.',\n `NYMBAL_JWT_SECRET=${randomBytes(32).toString('base64url')}`,\n '',\n ]\n await writeFile(resolve(dir, '.env'), lines.join('\\n'), { encoding: 'utf8', mode: 0o600 })\n}\n\nfunction adminSignIn(admin: AdminCredentials): string[] {\n return [\n `Admin: http://localhost:${API_PORT}/admin/`,\n ` email ${admin.email}`,\n ` password ${admin.password} (saved in .env)`,\n ]\n}\n\nexport interface MainDeps {\n run?: Runner\n}\n\n/**\n * The `packageManager` field for the package manager that launched us (`npm_config_user_agent`), read when called.\n * Without a usable user agent it is the installed npm; undefined when npm cannot be run either.\n */\nfunction packageManagerField(): string | undefined {\n const token = (process.env['npm_config_user_agent'] ?? '').split(' ')[0] ?? ''\n const match = /^(npm|pnpm|yarn|bun)\\/(\\d+\\.\\d+\\.\\d+\\S*)$/.exec(token)\n if (match) return `${match[1]}@${match[2]}`\n const npm = spawnSync('npm', ['-v'], { encoding: 'utf8', shell: process.platform === 'win32' })\n const version = npm.status === 0 ? npm.stdout.trim() : ''\n return version ? `npm@${version}` : undefined\n}\n\nexport function detectPackageManager(): PackageManager {\n const ua = process.env['npm_config_user_agent']\n if (!ua) return 'npm'\n const token = ua.split(' ')[0] ?? ''\n const slash = token.indexOf('/')\n const pm = slash >= 0 ? token.slice(0, slash) : token\n const version = slash >= 0 ? token.slice(slash + 1) : ''\n if (pm === 'pnpm') return 'pnpm'\n if (pm === 'bun') return 'bun'\n if (pm === 'yarn') {\n const major = parseInt(version.split('.')[0] ?? '1', 10)\n return major < 2 ? 'yarn-classic' : 'yarn-berry'\n }\n return 'npm'\n}\n\nfunction installCmd(pm: PackageManager): [string, string[]] {\n switch (pm) {\n case 'pnpm':\n return ['pnpm', ['install']]\n case 'bun':\n return ['bun', ['install']]\n case 'yarn-classic':\n case 'yarn-berry':\n return ['yarn', ['install']]\n default:\n return ['npm', ['install']]\n }\n}\n\nfunction seedCmd(pm: PackageManager): [string, string[]] {\n switch (pm) {\n case 'pnpm':\n return ['pnpm', ['exec', 'nymbal', 'seed']]\n case 'bun':\n return ['bunx', ['nymbal', 'seed']]\n case 'yarn-classic':\n return ['yarn', ['run', 'nymbal', 'seed']]\n case 'yarn-berry':\n return ['yarn', ['exec', 'nymbal', 'seed']]\n default:\n return ['npx', ['nymbal', 'seed']]\n }\n}\n\nfunction devCmd(pm: PackageManager): string {\n switch (pm) {\n case 'pnpm':\n return 'pnpm dev'\n case 'bun':\n return 'bun dev'\n case 'yarn-classic':\n case 'yarn-berry':\n return 'yarn dev'\n default:\n return 'npm run dev'\n }\n}\n\nconst TEMPLATES = ['astro', 'nextjs'] as const\nconst CURRENCIES = ['GBP', 'USD', 'EUR'] as const\n\nexport interface CliFlags {\n name?: string\n template?: (typeof TEMPLATES)[number]\n currency?: (typeof CURRENCIES)[number]\n yes: boolean\n /** Present (false) only with `--no-install`. */\n install?: boolean\n adminEmail?: string\n}\n\n/** A command-line flag that is missing its value or names a value outside the allowed set. */\nexport class CliFlagError extends Error {\n constructor(message: string) {\n super(message)\n this.name = 'CliFlagError'\n }\n}\n\nfunction oneOf<T extends string>(flag: string, value: string, allowed: readonly T[]): T {\n if ((allowed as readonly string[]).includes(value)) return value as T\n throw new CliFlagError(`Unknown ${flag} \"${value}\". Allowed: ${allowed.join(', ')}`)\n}\n\n/**\n * Parses process.argv (node and script first): --name, --template, --currency and --admin-email take `--flag v` or\n * `--flag=v`.\n */\nexport function parseCliFlags(argv: string[]): CliFlags {\n const flags: CliFlags = { yes: false }\n const args = argv.slice(2)\n let positional: string | undefined\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!\n if (arg === '--yes' || arg === '-y') {\n flags.yes = true\n continue\n }\n if (arg === '--no-install') {\n flags.install = false\n continue\n }\n const match = /^--(name|template|currency|admin-email)(?:=(.*))?$/s.exec(arg)\n if (match) {\n const flag = match[1]!\n let value = match[2]\n if (value === undefined) {\n const next = args[i + 1]\n if (next === undefined || next.startsWith('-'))\n throw new CliFlagError(`--${flag} needs a value`)\n value = next\n i++\n }\n if (flag === 'name') flags.name = value\n else if (flag === 'template') flags.template = oneOf('--template', value, TEMPLATES)\n else if (flag === 'currency') flags.currency = oneOf('--currency', value, CURRENCIES)\n else {\n const problem = adminEmailProblem(value)\n if (problem) throw new CliFlagError(`Invalid --admin-email \"${value}\". ${problem}`)\n flags.adminEmail = value\n }\n } else if (!arg.startsWith('-') && positional === undefined) {\n positional = arg\n }\n }\n if (flags.name === undefined && positional !== undefined) flags.name = positional\n return flags\n}\n\nexport async function main(argv: string[] = process.argv, deps: MainDeps = {}): Promise<void> {\n const run = deps.run ?? runCmd\n let flags: CliFlags\n try {\n flags = parseCliFlags(argv)\n } catch (err) {\n if (!(err instanceof CliFlagError)) throw err\n process.stderr.write(`Error: ${err.message}\\n`)\n process.exit(1)\n }\n\n const pm = detectPackageManager()\n\n if (flags.yes) {\n if (!flags.name) {\n process.stderr.write('Error: --yes requires --name or a positional name argument\\n')\n process.exit(1)\n }\n const name = flags.name.trim()\n const answers: Answers = {\n name,\n directory: toDirectoryName(name),\n currency: flags.currency ?? 'GBP',\n template: flags.template ?? 'astro',\n seedDemo: true,\n }\n const targetDir = resolve(process.cwd(), answers.directory)\n if (existsSync(targetDir)) {\n const entries = await readdir(targetDir)\n if (entries.length > 0) {\n process.stderr.write(\n `Error: Directory ${answers.directory} already exists and is not empty.\\n`,\n )\n process.exit(1)\n }\n } else {\n await mkdir(targetDir, { recursive: true })\n }\n await scaffold(targetDir, answers)\n const admin = newAdminCredentials(flags.adminEmail)\n await writeAdminEnv(targetDir, admin)\n process.stdout.write(`Created ${answers.directory}\\n`)\n if (flags.install !== false) {\n await installAndSeed(targetDir, pm, answers.seedDemo, run, admin)\n } else {\n process.stdout.write(`Next: cd ${answers.directory} && ${installCmd(pm)[0]} install\\n`)\n }\n process.stdout.write(`${[...adminSignIn(admin), '', HELP_LINE].join('\\n')}\\n`)\n return\n }\n\n intro(pc.cyan(pc.bold('◆ create-nymbal-app')))\n\n const name = flags.name\n ? flags.name\n : ((await text({\n message: 'Store name',\n placeholder: 'My Store',\n validate: (v) => (!v || v.trim().length === 0 ? 'Required' : undefined),\n })) as string | symbol)\n\n if (isCancel(name)) return cancel('Cancelled')\n\n const adminEmail = flags.adminEmail\n ? flags.adminEmail\n : ((await text({\n message: 'Admin email',\n initialValue: randomAdminEmail(),\n validate: adminEmailProblem,\n })) as string | symbol)\n\n if (isCancel(adminEmail)) return cancel('Cancelled')\n\n type Currency = 'GBP' | 'USD' | 'EUR'\n const currencyOptions: { value: Currency; label: string }[] = [\n { value: 'GBP', label: 'GBP — British Pound' },\n { value: 'USD', label: 'USD — US Dollar' },\n { value: 'EUR', label: 'EUR — Euro' },\n ]\n const currency = await select({\n message: 'Store currency',\n options: currencyOptions,\n initialValue: 'GBP' as Currency,\n })\n\n if (isCancel(currency)) return cancel('Cancelled')\n\n type Template = 'astro' | 'nextjs'\n const templateOptions: { value: Template; label: string }[] = [\n { value: 'astro', label: 'Astro (recommended — performance-first)' },\n { value: 'nextjs', label: 'Next.js (migration-friendly)' },\n ]\n const template = await select({\n message: 'Storefront template',\n options: templateOptions,\n initialValue: 'astro' as Template,\n })\n\n if (isCancel(template)) return cancel('Cancelled')\n\n const seedDemo = (await confirm({\n message: 'Generate demo content?',\n initialValue: true,\n })) as boolean | symbol\n\n if (isCancel(seedDemo)) return cancel('Cancelled')\n\n const shouldInstall =\n flags.install === false\n ? false\n : ((await confirm({\n message: 'Install dependencies now?',\n initialValue: true,\n })) as boolean | symbol)\n\n if (isCancel(shouldInstall)) return cancel('Cancelled')\n\n const answers: Answers = {\n name: String(name).trim(),\n directory: toDirectoryName(String(name).trim()),\n currency: currency as 'GBP' | 'USD' | 'EUR',\n template: template as 'astro' | 'nextjs',\n seedDemo: seedDemo as boolean,\n }\n\n const targetDir = resolve(process.cwd(), answers.directory)\n if (existsSync(targetDir)) {\n const entries = await readdir(targetDir)\n if (entries.length > 0) {\n cancel(`Directory ${answers.directory} already exists and is not empty.`)\n process.exit(1)\n }\n } else {\n await mkdir(targetDir, { recursive: true })\n }\n\n note(pc.dim(`Scaffolding into ${targetDir}`), 'Creating project')\n\n await scaffold(targetDir, answers)\n const admin = newAdminCredentials(String(adminEmail).trim())\n await writeAdminEnv(targetDir, admin)\n\n if (shouldInstall) {\n await installAndSeed(targetDir, pm, answers.seedDemo, run, admin)\n }\n\n const cmd = devCmd(pm)\n const nextSteps = [` ${pc.cyan('cd')} ${answers.directory}`]\n if (!shouldInstall) {\n const [ic] = installCmd(pm)\n nextSteps.push(` ${pc.cyan(ic + ' install')}`)\n }\n nextSteps.push(` ${pc.cyan(cmd)}`)\n\n outro(\n [\n pc.green(`✓ Created ${answers.directory}`),\n '',\n ...nextSteps,\n '',\n ...adminSignIn(admin),\n '',\n HELP_LINE,\n ].join('\\n'),\n )\n}\n\n/** Install with the detected package manager, then seed through the project's own `nymbal` bin. */\nasync function installAndSeed(\n dir: string,\n pm: PackageManager,\n seedDemo: boolean,\n run: Runner,\n admin: AdminCredentials,\n): Promise<void> {\n const [installBin, installArgs] = installCmd(pm)\n process.stdout.write(`Running ${installBin} install (this may take a moment)...\\n`)\n await run(installBin, installArgs, dir)\n if (seedDemo) {\n process.stdout.write('Seeding demo content...\\n')\n const [seedBin, seedArgs] = seedCmd(pm)\n // Explicit, so a value exported in the shell cannot replace the one in .env and the outro.\n await run(seedBin, seedArgs, dir, {\n ...process.env,\n NYMBAL_ADMIN_EMAIL: admin.email,\n NYMBAL_ADMIN_PASSWORD: admin.password,\n })\n }\n}\n\nexport async function scaffold(dir: string, answers: Answers): Promise<void> {\n // Copy the chosen template directly into dir (flat — no storefront/ subdirectory)\n await copyScaffoldDir(resolve(SCAFFOLD_ROOT, 'templates', answers.template), dir)\n\n // Overlay the project layer (scaffold/project/<template>) on top of the template\n // defaults. Project files WIN on path collision — this is the override model:\n // anything in the project layer shadows the template default at the same path.\n // scaffold/project/ lives outside scaffold/templates/, so sync-scaffold's\n // rm -rf of scaffold/templates/* never deletes it.\n const projectLayer = resolve(SCAFFOLD_ROOT, 'project', answers.template)\n if (existsSync(projectLayer)) {\n await copyScaffoldDir(projectLayer, dir)\n }\n\n // Write nymbal.config.ts (answers-dependent, so generated at runtime)\n await writeFile(resolve(dir, 'nymbal.config.ts'), renderConfig(answers), 'utf8')\n\n // Patch the copied package.json: set name to the project directory name\n await patchPackageJson(dir, answers.directory)\n}\n\nasync function patchPackageJson(dir: string, name: string): Promise<void> {\n const pkgPath = resolve(dir, 'package.json')\n const pkg = JSON.parse(await readFile(pkgPath, 'utf8')) as Record<string, unknown>\n pkg['name'] = name\n pkg['private'] = true\n const packageManager = packageManagerField()\n if (packageManager) pkg['packageManager'] = packageManager\n await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\\n', 'utf8')\n}\n\nasync function copyScaffoldDir(src: string, dest: string): Promise<void> {\n if (!existsSync(src)) {\n throw new Error(`Scaffold directory not found: ${src}`)\n }\n await cp(src, dest, {\n recursive: true,\n filter: (source) => !source.endsWith('node_modules'),\n })\n await renameDotFiles(dest)\n}\n\nasync function renameDotFiles(dir: string): Promise<void> {\n // Non-recursive: only rename _dot.* files at the project root.\n // All shared dotfiles (_dot.gitignore, _dot.env.example) live at template root.\n const entries = await readdir(dir, { withFileTypes: true })\n for (const entry of entries) {\n if (!entry.isDirectory() && entry.name.startsWith('_dot.')) {\n const full = resolve(dir, entry.name)\n const renamed = resolve(dir, '.' + entry.name.slice(5))\n await writeFile(renamed, await readFile(full))\n await rm(full)\n }\n }\n}\n\nfunction renderConfig(answers: Answers): string {\n return `import { defineConfig, env } from '@nymbalhq/config'\n\nexport default defineConfig({\n store: {\n name: '${escape(answers.name)}',\n currency: '${answers.currency}',\n locale: '${defaultLocale(answers.currency)}',\n timezone: '${defaultTimezone(answers.currency)}',\n // The storefront's public origin: the order email links to its order page. Set it for production.\n url: env('NYMBAL_STOREFRONT_URL', '${STOREFRONT_ORIGIN[answers.template]}'),\n },\n\n template: '${answers.template}',\n\n infrastructure: {\n commandStore: 'sqlite',\n documentStore: { provider: 'in-memory' },\n eventBus: { provider: 'in-process' },\n },\n\n security: {\n adapter: 'middleware',\n rateLimit: {\n '/checkout': { requests: 10, window: '1m', action: 'block' },\n '/auth/*': { requests: 5, window: '1m', action: 'challenge' },\n '/api/*': { requests: 100, window: '1m', action: 'throttle' },\n '/webhooks/*': { requests: 200, window: '1m', action: 'throttle' },\n },\n botProtection: { mode: 'managed', allowList: ['googlebot', 'bingbot', 'stripe-webhooks'] },\n headers: {\n hsts: true,\n contentSecurityPolicy: 'strict',\n referrerPolicy: 'strict-origin-when-cross-origin',\n xFrameOptions: 'deny',\n },\n csrf: true,\n },\n\n commerce: {\n payments: { provider: 'native' },\n email: { provider: 'native' },\n reviews: { provider: 'native' },\n search: { provider: 'native' },\n analytics: { provider: 'native' },\n shipping: { provider: 'native' },\n tax: { provider: 'native' },\n ai: { provider: 'none' },\n },\n\n http: {\n adapter: 'fastify',\n port: ${API_PORT},\n },\n\n deployment: {\n strategy: 'standard',\n },\n\n features: {\n staging: false,\n heartbeat: false,\n autoUpdates: false,\n },\n})\n`\n}\n\nfunction defaultLocale(currency: Answers['currency']): string {\n return currency === 'USD' ? 'en-US' : 'en-GB'\n}\n\nfunction defaultTimezone(currency: Answers['currency']): string {\n return currency === 'USD' ? 'America/New_York' : 'Europe/London'\n}\n\nfunction escape(v: string): string {\n return v.replace(/'/g, \"\\\\'\")\n}\n\nfunction toDirectoryName(name: string): string {\n return name\n .toLowerCase()\n .replace(/[^a-z0-9-_ ]/g, '')\n .trim()\n .replace(/\\s+/g, '-')\n}\n\nconst runCmd: Runner = (cmd, args, cwd, env = process.env) => {\n return new Promise((resolve, reject) => {\n const child = spawn(cmd, args, { cwd, env, stdio: 'inherit', shell: false })\n child.on('error', reject)\n child.on('exit', (code) => {\n if (code === 0) return resolve()\n reject(new Error(`${cmd} ${args.join(' ')} exited with ${code}`))\n })\n })\n}\n"],"mappings":"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","names":["name","answers","targetDir","admin","resolve"]}
|
package/package.json
CHANGED
|
@@ -1,26 +1,60 @@
|
|
|
1
|
-
# Your Nymbal
|
|
1
|
+
# Your Nymbal store
|
|
2
2
|
|
|
3
|
-
A commerce
|
|
3
|
+
A commerce store made with [create-nymbal-app](https://github.com/nymbalhq/nymbal). Everything in this project is
|
|
4
|
+
yours to edit: `nymbal.config.ts`, and the pages, layouts and components under `src/`.
|
|
4
5
|
|
|
5
|
-
##
|
|
6
|
+
## Develop
|
|
6
7
|
|
|
8
|
+
```sh
|
|
9
|
+
npx nymbal dev
|
|
7
10
|
```
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
11
|
+
|
|
12
|
+
This serves the storefront at `http://localhost:4321`, the API on port 3001 and the admin at
|
|
13
|
+
`http://localhost:3001/admin/` (its email and password are in `.env`). It runs on SQLite with stub payments, and seeds
|
|
14
|
+
demo products on the first run.
|
|
15
|
+
|
|
16
|
+
## Production
|
|
17
|
+
|
|
18
|
+
Production runs on Postgres and takes payments through Stripe. Add both, then build the store's image:
|
|
19
|
+
|
|
20
|
+
```sh
|
|
21
|
+
npx nymbal add postgres
|
|
22
|
+
npx nymbal add stripe
|
|
23
|
+
npx nymbal build --image
|
|
13
24
|
```
|
|
14
25
|
|
|
26
|
+
The image runs `nymbal start`: the API, the admin and the storefront on one port. `npx nymbal deploy fly` and
|
|
27
|
+
`npx nymbal deploy railway` deploy it (`--dry-run` shows the steps first). The
|
|
28
|
+
[quickstart](https://github.com/nymbalhq/nymbal/blob/main/apps/docs/src/content/docs/quickstart.md) runs it locally with
|
|
29
|
+
an AI agent connected, and [Deploying](https://github.com/nymbalhq/nymbal/blob/main/apps/docs/src/content/docs/deploying.md)
|
|
30
|
+
covers the environment it needs.
|
|
31
|
+
|
|
32
|
+
## Scripts
|
|
33
|
+
|
|
34
|
+
| Script | Runs |
|
|
35
|
+
| ----------- | ------------------------------------------------------------------------- |
|
|
36
|
+
| `dev` | `astro dev`: the storefront alone, without the API (use `npx nymbal dev`) |
|
|
37
|
+
| `build` | `astro build`: the storefront's production build |
|
|
38
|
+
| `preview` | `astro preview`: the built storefront |
|
|
39
|
+
| `typecheck` | `astro check` |
|
|
40
|
+
| `migrate` | `nymbal migrate`: apply database migrations |
|
|
41
|
+
| `seed` | `nymbal seed`: seed the demo content again |
|
|
42
|
+
|
|
43
|
+
Run them with your package manager (`npm run dev`, `pnpm dev`, …). `npx nymbal --help` lists every CLI command.
|
|
44
|
+
|
|
15
45
|
## Configuration
|
|
16
46
|
|
|
17
|
-
All configuration lives in `nymbal.config.ts
|
|
18
|
-
|
|
47
|
+
All configuration lives in `nymbal.config.ts`: the CLI, the API and the storefront read it. `npx nymbal doctor`
|
|
48
|
+
checks the project without changing anything, and `npx nymbal add` lists the providers and services you can add.
|
|
49
|
+
|
|
50
|
+
## Running behind a proxy
|
|
19
51
|
|
|
20
|
-
|
|
52
|
+
The API believes a forwarded client address (`X-Forwarded-For`) only from the proxies listed in
|
|
53
|
+
`NYMBAL_TRUSTED_PROXIES`: `loopback` by default, for a web server on the same machine. On your own server,
|
|
54
|
+
`npx nymbal deploy nginx` (or `apache`, `caddy`) writes a web server config with TLS that sets the header itself.
|
|
55
|
+
Behind a platform proxy, list its range (`NYMBAL_TRUSTED_PROXIES=uniquelocal` on Fly and Railway); otherwise every shopper
|
|
56
|
+
shares one rate-limit bucket, and `nymbal doctor` warns when the list is the default and `NYMBAL_PUBLIC_URL` is public.
|
|
21
57
|
|
|
22
|
-
|
|
58
|
+
## Help
|
|
23
59
|
|
|
24
|
-
|
|
25
|
-
2. Change `infrastructure.commandStore` to `'postgres'` in `nymbal.config.ts`.
|
|
26
|
-
3. Run `pnpm migrate`.
|
|
60
|
+
Report a problem or ask a question at [github.com/nymbalhq/nymbal/issues](https://github.com/nymbalhq/nymbal/issues).
|
|
@@ -3,4 +3,6 @@ NYMBAL_API_URL=http://localhost:3001
|
|
|
3
3
|
# DATABASE_URL=postgres://user:pass@localhost:5432/nymbal
|
|
4
4
|
# STRIPE_SECRET_KEY=
|
|
5
5
|
# STRIPE_WEBHOOK_SECRET=
|
|
6
|
-
#
|
|
6
|
+
# The proxies whose X-Forwarded-For the API believes: loopback for a web server on this machine,
|
|
7
|
+
# uniquelocal behind Fly's or Railway's proxy.
|
|
8
|
+
# NYMBAL_TRUSTED_PROXIES=loopback
|
|
@@ -31,6 +31,9 @@ export default defineConfig({
|
|
|
31
31
|
output: 'server',
|
|
32
32
|
adapter: node({ mode: 'standalone' }),
|
|
33
33
|
server: { port },
|
|
34
|
+
// `nymbal start` forwards pages with the store's public origin in Host and X-Forwarded-*, so Astro.url is that
|
|
35
|
+
// origin. Only the forward reaches the server it starts, on 127.0.0.1.
|
|
36
|
+
security: { allowedDomains: [{}] },
|
|
34
37
|
// The page's CSS travels in its HTML, so the first paint waits on no stylesheet request (perf-budgets.json: LCP).
|
|
35
38
|
build: { inlineStylesheets: 'always' },
|
|
36
39
|
vite: { plugins: elementsEntryPath ? [elementsEntry(elementsEntryPath)] : [] },
|
|
@@ -17,14 +17,14 @@
|
|
|
17
17
|
"seed": "nymbal seed"
|
|
18
18
|
},
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"nymbal": "1.
|
|
21
|
-
"@nymbalhq/config": "1.
|
|
22
|
-
"@nymbalhq/platform": "1.
|
|
23
|
-
"@nymbalhq/stack": "1.
|
|
20
|
+
"nymbal": "1.6.0",
|
|
21
|
+
"@nymbalhq/config": "1.6.0",
|
|
22
|
+
"@nymbalhq/platform": "1.6.0",
|
|
23
|
+
"@nymbalhq/stack": "1.6.0",
|
|
24
24
|
"@astrojs/node": "^11.1.8",
|
|
25
|
-
"@nymbalhq/sdk": "1.
|
|
26
|
-
"@nymbalhq/types": "1.
|
|
27
|
-
"@nymbalhq/web-components": "1.
|
|
25
|
+
"@nymbalhq/sdk": "1.6.0",
|
|
26
|
+
"@nymbalhq/types": "1.6.0",
|
|
27
|
+
"@nymbalhq/web-components": "1.6.0",
|
|
28
28
|
"astro": "^7.4.0"
|
|
29
29
|
},
|
|
30
30
|
"devDependencies": {
|
|
@@ -33,26 +33,26 @@
|
|
|
33
33
|
},
|
|
34
34
|
"pnpm": {
|
|
35
35
|
"overrides": {
|
|
36
|
-
"nymbal": "1.
|
|
37
|
-
"@nymbalhq/config": "1.
|
|
38
|
-
"@nymbalhq/http": "1.
|
|
39
|
-
"@nymbalhq/platform": "1.
|
|
40
|
-
"@nymbalhq/react": "1.
|
|
41
|
-
"@nymbalhq/sdk": "1.
|
|
42
|
-
"@nymbalhq/stack": "1.
|
|
43
|
-
"@nymbalhq/types": "1.
|
|
44
|
-
"@nymbalhq/web-components": "1.
|
|
36
|
+
"nymbal": "1.6.0",
|
|
37
|
+
"@nymbalhq/config": "1.6.0",
|
|
38
|
+
"@nymbalhq/http": "1.6.0",
|
|
39
|
+
"@nymbalhq/platform": "1.6.0",
|
|
40
|
+
"@nymbalhq/react": "1.6.0",
|
|
41
|
+
"@nymbalhq/sdk": "1.6.0",
|
|
42
|
+
"@nymbalhq/stack": "1.6.0",
|
|
43
|
+
"@nymbalhq/types": "1.6.0",
|
|
44
|
+
"@nymbalhq/web-components": "1.6.0"
|
|
45
45
|
}
|
|
46
46
|
},
|
|
47
47
|
"overrides": {
|
|
48
|
-
"nymbal": "1.
|
|
49
|
-
"@nymbalhq/config": "1.
|
|
50
|
-
"@nymbalhq/http": "1.
|
|
51
|
-
"@nymbalhq/platform": "1.
|
|
52
|
-
"@nymbalhq/react": "1.
|
|
53
|
-
"@nymbalhq/sdk": "1.
|
|
54
|
-
"@nymbalhq/stack": "1.
|
|
55
|
-
"@nymbalhq/types": "1.
|
|
56
|
-
"@nymbalhq/web-components": "1.
|
|
48
|
+
"nymbal": "1.6.0",
|
|
49
|
+
"@nymbalhq/config": "1.6.0",
|
|
50
|
+
"@nymbalhq/http": "1.6.0",
|
|
51
|
+
"@nymbalhq/platform": "1.6.0",
|
|
52
|
+
"@nymbalhq/react": "1.6.0",
|
|
53
|
+
"@nymbalhq/sdk": "1.6.0",
|
|
54
|
+
"@nymbalhq/stack": "1.6.0",
|
|
55
|
+
"@nymbalhq/types": "1.6.0",
|
|
56
|
+
"@nymbalhq/web-components": "1.6.0"
|
|
57
57
|
}
|
|
58
58
|
}
|
|
@@ -36,6 +36,7 @@ const { title } = Astro.props
|
|
|
36
36
|
</BaseLayout>
|
|
37
37
|
|
|
38
38
|
<script>
|
|
39
|
+
import '@nymbalhq/sdk/ns/auth'
|
|
39
40
|
import { client } from '../lib/client.js'
|
|
40
41
|
|
|
41
42
|
async function guardAuth() {
|
|
@@ -45,12 +46,8 @@ const { title } = Astro.props
|
|
|
45
46
|
let state = client.auth.getState()
|
|
46
47
|
|
|
47
48
|
if (!state.isAuthenticated) {
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
state = client.auth.getState()
|
|
51
|
-
} catch {
|
|
52
|
-
// ignore — will redirect below
|
|
53
|
-
}
|
|
49
|
+
await client.auth.restore()
|
|
50
|
+
state = client.auth.getState()
|
|
54
51
|
}
|
|
55
52
|
|
|
56
53
|
if (!state.isAuthenticated) {
|
|
@@ -4,6 +4,7 @@ import NymbalElement from '@nymbalhq/web-components/astro'
|
|
|
4
4
|
import SkipNav from '../components/SkipNav.astro'
|
|
5
5
|
import { FOOTER, HEADER, headerSlots } from '../lib/chrome'
|
|
6
6
|
import { fetchCapabilities, fetchCart, type CartProjection } from '../lib/api'
|
|
7
|
+
import { serializeJsonLd } from '../lib/seo'
|
|
7
8
|
|
|
8
9
|
interface Props {
|
|
9
10
|
title: string
|
|
@@ -12,6 +13,8 @@ interface Props {
|
|
|
12
13
|
jsonLd?: Record<string, unknown>
|
|
13
14
|
/** The shopper's cart, when the page has read it already (fetchCart); the layout reads it otherwise. */
|
|
14
15
|
cart?: CartProjection | null
|
|
16
|
+
/** The page's canonical URL and og:url, when its own URL carries what must not travel (an order's key). */
|
|
17
|
+
canonical?: string
|
|
15
18
|
}
|
|
16
19
|
|
|
17
20
|
const { title, description = 'Shop the Nymbal store', ogImage, jsonLd } = Astro.props
|
|
@@ -19,7 +22,7 @@ const cart =
|
|
|
19
22
|
Astro.props.cart !== undefined ? Astro.props.cart : await fetchCart(Astro.request.headers.get('cookie'))
|
|
20
23
|
const capabilities = await fetchCapabilities()
|
|
21
24
|
const canSearch = capabilities?.search.capabilities.includes('search') ?? false
|
|
22
|
-
const canonicalUrl = Astro.url.href
|
|
25
|
+
const canonicalUrl = Astro.props.canonical ?? Astro.url.href
|
|
23
26
|
---
|
|
24
27
|
<!doctype html>
|
|
25
28
|
<html lang="en">
|
|
@@ -41,7 +44,7 @@ const canonicalUrl = Astro.url.href
|
|
|
41
44
|
|
|
42
45
|
<!-- JSON-LD structured data -->
|
|
43
46
|
{jsonLd && (
|
|
44
|
-
<script type="application/ld+json" set:html={
|
|
47
|
+
<script type="application/ld+json" set:html={serializeJsonLd(jsonLd)} />
|
|
45
48
|
)}
|
|
46
49
|
</head>
|
|
47
50
|
<body>
|