create-acrylblends 0.2.6 → 0.2.8
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 +78 -6
- package/dist/index.js.map +1 -1
- package/docs/framework/README.md +1 -1
- package/docs/framework/UPSTREAM.md +1 -1
- package/docs/framework/agents/index.md +18 -3
- package/docs/framework/getting-started/desktop.md +2 -2
- package/docs/framework/guides/client-modules.md +4 -3
- package/docs/framework/guides/data.md +72 -8
- package/docs/framework/helpers/streaming.md +12 -27
- package/docs/framework/upstream.json +2 -2
- package/package.json +2 -2
- package/templates/bun/gitignore +1 -0
- package/templates/chat/gitignore +1 -0
- package/templates/nodejs/gitignore +1 -0
- package/templates/notes/gitignore +1 -0
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { createRequire } from "node:module";
|
|
2
2
|
import { spawn, spawnSync } from "node:child_process";
|
|
3
|
-
import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { copyFileSync, cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
|
|
4
4
|
import { tmpdir } from "node:os";
|
|
5
5
|
import { basename, dirname, join, resolve } from "node:path";
|
|
6
6
|
import { createInterface } from "node:readline/promises";
|
|
@@ -18,6 +18,75 @@ const CREATE = "create-acrylblends";
|
|
|
18
18
|
/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */
|
|
19
19
|
const TEMPLATE_MANIFEST = "acryl.template.json";
|
|
20
20
|
//#endregion
|
|
21
|
+
//#region src/self-knowledge.ts
|
|
22
|
+
/** Where an agent looks for a skill: Claude Code reads `.claude/skills`, Codex and others read `.agents/skills`. The text is the same. */
|
|
23
|
+
const SKILL_FOLDERS = [".claude/skills/app-guide", ".agents/skills/app-guide"];
|
|
24
|
+
/** The defaults of an app made from this template, each with the one place that swaps it. */
|
|
25
|
+
function defaultRows(template, pkg) {
|
|
26
|
+
const rows = [];
|
|
27
|
+
if (template === "notes" || template === "chat") rows.push(`| Records | \`db\` port, SQLite (\`${pkg}/db/sqlite\`) | the opener, \`src/db.ts\`: call another provider there; no route, store or test changes |`);
|
|
28
|
+
rows.push(`| Small state | \`kv\` port, one JSON file (\`${pkg}/kv/json\`) | \`${pkg}/kv/db\` keeps it in the \`db\`; or a provider of your own; the opener is the only file that changes |`);
|
|
29
|
+
rows.push(template === "bun" ? `| Server | Bun | \`${pkg}/node-server\` for Node, or the adapter of another runtime; \`src/index.ts\` is the only file that changes |` : `| Server | Node (\`${pkg}/node-server\`) | the adapter of another runtime (\`${pkg}/bun\`, ...); \`src/index.ts\` is the only file that changes |`);
|
|
30
|
+
rows.push(`| Window | the browser | \`npx ${pkg} add desktop\` adds an Electron window on the same server; the app's code never imports Electron |`);
|
|
31
|
+
if (template === "nodejs" || template === "notes" || template === "chat") rows.push(`| Browser code | \`clientModules\`, no bundler | a bundler (Vite, esbuild) in front of \`src/client\`, wrapped in a plugin of its own |`);
|
|
32
|
+
return rows;
|
|
33
|
+
}
|
|
34
|
+
/** The section every app carries: the framework is a set of defaults, never a rule. */
|
|
35
|
+
function defaultsSection(template, pkg) {
|
|
36
|
+
return `## Defaults you can swap
|
|
37
|
+
|
|
38
|
+
The framework is not rigid. Every choice is a plugin behind a port, and what the app starts with is only a fallback. Name the default before you change it,
|
|
39
|
+
and swap it at the one place that opens it.
|
|
40
|
+
|
|
41
|
+
| Choice | Default | To swap it |
|
|
42
|
+
| --- | --- | --- |
|
|
43
|
+
${defaultRows(template, pkg).join("\n")}
|
|
44
|
+
|
|
45
|
+
- **An outside tool** (a database server, a bundler, a router such as Vike) joins the app as a provider: a plugin in \`plugins/<name>/\` that implements a port and
|
|
46
|
+
passes that port's conformance tests, then the opener names it. Postgres is such a provider and is not part of this package; add it when the app needs it.
|
|
47
|
+
- **The dependency rule:** only the opener imports a provider; everything else takes the port as an argument. \`${pkg} check-deps\` enforces it.
|
|
48
|
+
`;
|
|
49
|
+
}
|
|
50
|
+
/** Where the plugins are, said once. */
|
|
51
|
+
function pluginsSection(pkg) {
|
|
52
|
+
return `## Plugins
|
|
53
|
+
|
|
54
|
+
There is one plugin folder: \`plugins/\` at the root of the app. A plugin is a folder \`plugins/<name>/\` with an \`index.ts\`. \`${pkg} add <name>\` copies a library plugin
|
|
55
|
+
there; a plugin you or an agent write goes there too. Do not create \`src/plugins/\` or \`extensions/\`.
|
|
56
|
+
`;
|
|
57
|
+
}
|
|
58
|
+
/** The text of the one skill. It repeats nothing of the docs; it says where to look and how to work. */
|
|
59
|
+
function skillText(name, template, pkg) {
|
|
60
|
+
return `---
|
|
61
|
+
name: app-guide
|
|
62
|
+
description: How to change, run and check the ${name} app. Use it before adding a feature, a page, a route, a plugin or a dependency to this app, and before saying the work is done.
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
# Working in ${name}
|
|
66
|
+
|
|
67
|
+
1. **Read first.** \`AGENTS.md\` in this folder says how the app is laid out. The framework's API is in \`docs/framework/\`: start at \`docs/framework/README.md\`, and
|
|
68
|
+
\`docs/framework/api/summary.md\` is the one-page summary. Parts the docs mark "not yet available" are not in the package.
|
|
69
|
+
2. **Make the change small.** A route is a function from \`Request\` to \`Response\`: test it with \`await app.request('/path')\`. ${template === "notes" || template === "chat" ? "A change to the data is the next numbered file in `migrations/`; never edit one that has run." : "Keep new code in `src/` next to the code it extends."}
|
|
70
|
+
3. **One plugin folder.** A plugin lives in \`plugins/<name>/\` (\`${pkg} add <name>\` copies a library plugin there). There is no \`src/plugins/\` and no \`extensions/\`.
|
|
71
|
+
4. **Defaults are swappable.** The database, the key-value store, the server and the window are plugins behind ports. The table "Defaults you can swap" in \`AGENTS.md\` names each default and the one file that changes it. Never reach around a port to a driver: \`${pkg} check-deps\` fails the check.
|
|
72
|
+
5. **Look at the running app.** Start it with its dev script, open it in a browser, and check the page; the app has no door command yet, so do not look for one.
|
|
73
|
+
6. **Done means checked.** \`npm test\` and \`npm run check\` pass, and the change shows in the running app after a restart. No secret goes in a file or in \`git status\`: keys come from environment variables.
|
|
74
|
+
`;
|
|
75
|
+
}
|
|
76
|
+
/** Write the same text to `AGENTS.md` and `CLAUDE.md`, and the skill to every folder an agent looks in. */
|
|
77
|
+
function writeSelfKnowledge(target, agentsText, skill) {
|
|
78
|
+
const written = ["AGENTS.md", "CLAUDE.md"];
|
|
79
|
+
writeFileSync(join(target, "AGENTS.md"), agentsText);
|
|
80
|
+
writeFileSync(join(target, "CLAUDE.md"), agentsText);
|
|
81
|
+
for (const folder of SKILL_FOLDERS) {
|
|
82
|
+
const file = join(target, folder, "SKILL.md");
|
|
83
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
84
|
+
writeFileSync(file, skill);
|
|
85
|
+
written.push(`${folder}/SKILL.md`);
|
|
86
|
+
}
|
|
87
|
+
return written;
|
|
88
|
+
}
|
|
89
|
+
//#endregion
|
|
21
90
|
//#region src/source.ts
|
|
22
91
|
/**
|
|
23
92
|
* Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.
|
|
@@ -387,6 +456,8 @@ function agentsText(template, name) {
|
|
|
387
456
|
chat: "npm test` and `npm run check",
|
|
388
457
|
bun: "bun test` and `bun run check"
|
|
389
458
|
}[template];
|
|
459
|
+
const jsxNote = template === "nodejs" || template === "notes" || template === "chat" ? "Write pages in `.tsx` (see `src/" + (template === "notes" ? "views.tsx" : "page.tsx") + "`): the scripts in `package.json` run Node.js with `--import acrylblends/node-server/register`, which compiles `.tsx` with this app's own `typescript`, and `tsconfig.json` sets `jsx: react-jsx` with `jsxImportSource: acrylblends/jsx`. Render a component with `.toString()` and return it with `c.html(...)`. A command that starts the app without those scripts (a bare `node src/index.ts`) cannot load a `.tsx` file. Without a build step you can write the call JSX compiles to instead: `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'`, children after the props. See `docs/framework/guides/jsx.md`." : "Bun compiles `.tsx` itself: write pages in `.tsx`, render a component with `.toString()` and return it with `c.html(...)`. `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'` (children after the props) is the same thing without JSX syntax. See `docs/framework/guides/jsx.md`.";
|
|
460
|
+
const clientNote = template === "nodejs" ? `- **Client components** (run in the browser) live in \`src/client/\`, which has its own \`tsconfig.json\` (DOM types, no Node types); \`clientModules\` in \`src/app.ts\` compiles them when the browser asks, and \`npm run build\` compiles them once for production. See \`src/client/counter.tsx\` and \`docs/framework/guides/client-modules.md\`.\n` : "";
|
|
390
461
|
return `# ${name}
|
|
391
462
|
|
|
392
463
|
An ${CLASS} app (${template}${template === "bun" ? ", experimental" : ""}): handlers over the Web Standard \`Request\` and \`Response\`, from the \`${PACKAGE}\` package.
|
|
@@ -440,14 +511,16 @@ Read \`docs/framework/getting-started/deploy.md\`. In short:
|
|
|
440
511
|
|
|
441
512
|
Read \`docs/framework/getting-started/deploy.md\`. In short: \`npm ci --omit=dev\`, \`npm run build\`, \`NODE_ENV=production npm start\`; the app listens on \`127.0.0.1\` (\`HOST=0.0.0.0\` only in a container); the SQLite file goes outside the code folder (\`CHAT_DB=/var/lib/chat/chat.sqlite\`) and is backed up; the model key is an environment variable of the service (a root-only environment file for systemd), never a file in the repository. Anyone who can reach the app can spend your key: put it behind a login or on a private network before it is public.
|
|
442
513
|
` : ""}
|
|
514
|
+
${defaultsSection(template, PACKAGE)}
|
|
515
|
+
${pluginsSection(PACKAGE)}
|
|
443
516
|
## Things that surprise people
|
|
444
517
|
|
|
445
518
|
- A page mounted at \`/x\` answers \`/x\`, not \`/x/\` (trailing slashes are strict); \`trimTrailingSlash()\` redirects.
|
|
446
519
|
- A \`json\` validator target reads the body only with a JSON \`Content-Type\`; a failure answers 400 with \`{ error, issues: [{ message, path }] }\`.
|
|
447
520
|
- \`throw new HTTPException(404, { message })\` answers an error response (plain text).
|
|
448
521
|
- \`testClient(app)\` from \`'${PACKAGE}/testing'\` types only routes chained on the \`new ${CLASS}()\` expression (\`new ${CLASS}().get(...).post(...)\`); headers such as a cookie go in the second argument of each call.
|
|
449
|
-
- **JSX:** ${
|
|
450
|
-
${
|
|
522
|
+
- **JSX:** ${jsxNote}
|
|
523
|
+
${clientNote}
|
|
451
524
|
## Before you say you are done
|
|
452
525
|
|
|
453
526
|
\`${test}\` pass.
|
|
@@ -475,8 +548,7 @@ function copyTemplate(template, target, name) {
|
|
|
475
548
|
}
|
|
476
549
|
};
|
|
477
550
|
walk(join(templatesRoot(), template), target, "");
|
|
478
|
-
|
|
479
|
-
writeFileSync(join(target, "CLAUDE.md"), "@AGENTS.md\n");
|
|
551
|
+
written.push(...writeSelfKnowledge(target, agentsText(template, name), skillText(name, template, PACKAGE)));
|
|
480
552
|
copyDocs(target);
|
|
481
553
|
return written;
|
|
482
554
|
}
|
|
@@ -529,7 +601,7 @@ async function createFromSource(options, target, directory, io) {
|
|
|
529
601
|
const staged = join(scratch, "app");
|
|
530
602
|
const { files, lifecycle } = writeTemplate(join(scratch, "source"), staged, (text) => replacePlaceholders(text, name), frameworkRange(), name);
|
|
531
603
|
if (!existsSync(join(staged, "AGENTS.md"))) writeFileSync(join(staged, "AGENTS.md"), `# ${name}\n\nAn ${CLASS} app made from the template "${manifest.name}": ${manifest.description}\n\nThe framework's API is in \`docs/framework/\` (start at \`docs/framework/README.md\`).\n`);
|
|
532
|
-
if (!existsSync(join(staged, "CLAUDE.md")))
|
|
604
|
+
if (!existsSync(join(staged, "CLAUDE.md"))) copyFileSync(join(staged, "AGENTS.md"), join(staged, "CLAUDE.md"));
|
|
533
605
|
const found = findSecrets(textFiles(staged));
|
|
534
606
|
if (found.length > 0) {
|
|
535
607
|
io.stderr.write(`error: the template holds what looks like a secret, so nothing was created:\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join("\n")}\n`);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/names.ts","../src/source.ts","../src/spawn.ts","../src/index.ts"],"sourcesContent":["/**\n * The one place this package names the framework. The templates are written with `__PACKAGE__` and `__RANGE__` (the range is stamped at create time from the framework version this package carries, see `frameworkRange`), and the text of `AGENTS.md` with\n * `__PACKAGE__`, so a rename (for example to `acryl`) is a change here and in `scripts/lib/names.mjs`, which a test keeps equal.\n */\nexport const PACKAGE = 'acrylblends'\nexport const CLASS = 'Acryl'\nexport const CREATE = 'create-acrylblends'\n\n/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */\nexport const TEMPLATE_MANIFEST = 'acryl.template.json'\n","/**\n * Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.\n * A source is only ever downloaded and unpacked: no git clone (hooks), no lifecycle script (`npm pack --ignore-scripts`), nothing of it is run.\n */\nimport { spawnSync } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n lstatSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmSync,\n writeFileSync,\n} from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { PACKAGE, TEMPLATE_MANIFEST } from './names'\n\nexport type Source =\n | { kind: 'github'; owner: string; repo: string; ref: string | undefined }\n | { kind: 'npm'; spec: string }\n | { kind: 'tarball'; path: string }\n\n/** What a template says about itself in `acryl.template.json`. */\nexport interface Manifest {\n name: string\n description: string\n /** Library plugins the template needs, added with `acrylblends add`. */\n plugins: string[]\n}\n\n/** A source that cannot be used; the message says why and is shown as it is. */\nexport class SourceError extends Error {\n override name = 'SourceError'\n}\n\nexport const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], or a packed .tgz file`\n\nconst LIMITS = { files: 5000, bytes: 50 * 1024 * 1024 }\n\n/** Recognise a source argument, or return `undefined` when it is not one (so the caller can report a usage error). */\nexport function parseSource(text: string, cwd: string): Source | undefined {\n const github = /^github:([A-Za-z0-9_.-]+)\\/([A-Za-z0-9_.-]+)(?:#([A-Za-z0-9_./-]+))?$/.exec(text)\n if (github) return { kind: 'github', owner: github[1]!, repo: github[2]!, ref: github[3] }\n if (text.startsWith('github:')) throw new SourceError(`\"${text}\" is not github:owner/repo[#ref]`)\n if (/^@[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9._-]+)?$/.test(text))\n return { kind: 'npm', spec: text }\n if (text.startsWith('@')) throw new SourceError(`\"${text}\" is not @scope/name[@version]`)\n if (/\\.(tgz|tar\\.gz)$/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path)) throw new SourceError(`${path} does not exist`)\n return { kind: 'tarball', path }\n }\n return undefined\n}\n\n/** How the bytes of a source are obtained; real by default, replaced in tests. */\nexport interface Fetchers {\n /** The body at a URL (a GitHub tarball). */\n download(url: string): Promise<Uint8Array>\n /** `npm pack <spec> --ignore-scripts` into `dest`; the path of the tarball. */\n pack(spec: string, dest: string): string\n}\n\nexport const realFetchers: Fetchers = {\n async download(url) {\n const response = await fetch(url, { redirect: 'follow' })\n if (!response.ok) throw new SourceError(`${url} answered ${response.status}`)\n return new Uint8Array(await response.arrayBuffer())\n },\n pack(spec, dest) {\n const result = spawnSync(\n 'npm',\n ['pack', spec, '--ignore-scripts', '--json', '--pack-destination', dest],\n {\n encoding: 'utf8',\n shell: false,\n env: { ...process.env, npm_config_ignore_scripts: 'true' },\n },\n )\n if (result.status !== 0)\n throw new SourceError(\n `npm could not pack ${spec}: ${(result.stderr || result.stdout).trim().split('\\n').at(-1)}`,\n )\n const file = (JSON.parse(result.stdout) as { filename: string }[])[0]?.filename\n if (!file) throw new SourceError(`npm packed nothing for ${spec}`)\n return join(dest, file)\n },\n}\n\n/** Unpack a tarball into `dir`, dropping its single top folder; refuses links, paths that leave the folder, and archives that are too big. */\nfunction extract(tarball: string, dir: string): void {\n const list = spawnSync('tar', ['-tzf', tarball], {\n encoding: 'utf8',\n maxBuffer: 64 * 1024 * 1024,\n })\n if (list.status !== 0) throw new SourceError(`${tarball} is not a readable tar.gz archive`)\n const entries = list.stdout.split('\\n').filter(Boolean)\n if (entries.length > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n for (const entry of entries)\n if (entry.startsWith('/') || entry.split('/').includes('..'))\n throw new SourceError(`the archive holds a path that leaves its folder: ${entry}`)\n mkdirSync(dir, { recursive: true })\n const run = spawnSync('tar', ['-xzf', tarball, '-C', dir, '--strip-components=1'], {\n encoding: 'utf8',\n })\n if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`)\n let bytes = 0\n const walk = (folder: string) => {\n for (const entry of readdirSync(folder)) {\n const path = join(folder, entry)\n const info = lstatSync(path)\n if (info.isSymbolicLink())\n throw new SourceError(\n `the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`,\n )\n if (info.isDirectory()) walk(path)\n else bytes += info.size\n }\n }\n walk(dir)\n if (bytes > LIMITS.bytes)\n throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`)\n}\n\n/** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */\nexport async function fetchSource(\n source: Source,\n dir: string,\n scratch: string,\n fetchers: Fetchers,\n): Promise<void> {\n mkdirSync(scratch, { recursive: true })\n let tarball: string\n if (source.kind === 'tarball') tarball = source.path\n else if (source.kind === 'npm') tarball = fetchers.pack(source.spec, scratch)\n else {\n tarball = join(scratch, 'source.tar.gz')\n writeFileSync(\n tarball,\n await fetchers.download(\n `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref ?? 'HEAD'}`,\n ),\n )\n }\n extract(tarball, dir)\n}\n\n/** Read and check `acryl.template.json`; a source without it is not a template. */\nexport function readManifest(dir: string): Manifest {\n const file = join(dir, TEMPLATE_MANIFEST)\n if (!existsSync(file))\n throw new SourceError(\n `this source has no ${TEMPLATE_MANIFEST}, so it is not a template: add one with a name and a description (see the create-acrylblends guide)`,\n )\n let data: unknown\n try {\n data = JSON.parse(readFileSync(file, 'utf8'))\n } catch {\n throw new SourceError(`${TEMPLATE_MANIFEST} is not valid JSON`)\n }\n const m = data as Record<string, unknown>\n if (typeof m.name !== 'string' || m.name.trim() === '')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"name\"`)\n if (typeof m.description !== 'string')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"description\"`)\n const plugins = m.plugins ?? []\n if (\n !Array.isArray(plugins) ||\n plugins.some((p) => typeof p !== 'string' || !/^[a-z][a-z0-9-]*$/.test(p))\n )\n throw new SourceError(\n `\"plugins\" in ${TEMPLATE_MANIFEST} is a list of plugin names such as \"desktop\"`,\n )\n return { name: m.name, description: m.description, plugins: plugins as string[] }\n}\n\nconst SKIP = new Set(['.git', 'node_modules', TEMPLATE_MANIFEST])\n/** Lifecycle scripts npm runs on `npm install` in the app's own folder. */\nexport const LIFECYCLE = [\n 'preinstall',\n 'install',\n 'postinstall',\n 'prepublish',\n 'preprepare',\n 'prepare',\n 'postprepare',\n]\n\nconst isText = (buffer: Buffer) => !buffer.subarray(0, 8000).includes(0)\n\n/**\n * Copy the unpacked template into `target`, replacing the placeholders of the built-in templates, naming the app, and pointing a dependency on the framework at\n * the release this package carries. Returns the files written (relative paths) and the lifecycle scripts the app's package.json defines.\n */\nexport function writeTemplate(\n from: string,\n target: string,\n stamp: (text: string) => string,\n range: string,\n name: string,\n): { files: string[]; lifecycle: Record<string, string> } {\n const files: string[] = []\n const walk = (src: string, dst: string, prefix: string) => {\n mkdirSync(dst, { recursive: true })\n for (const entry of readdirSync(src, { withFileTypes: true })) {\n if (SKIP.has(entry.name)) continue\n const outName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(src, entry.name), join(dst, outName), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(src, entry.name))\n writeFileSync(join(dst, outName), isText(buffer) ? stamp(buffer.toString('utf8')) : buffer)\n files.push(`${prefix}${outName}`)\n }\n }\n }\n walk(from, target, '')\n const lifecycle: Record<string, string> = {}\n const pkgFile = join(target, 'package.json')\n if (existsSync(pkgFile)) {\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as {\n name?: string\n scripts?: Record<string, string>\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n pkg.name = name\n for (const group of [pkg.dependencies, pkg.devDependencies])\n if (group?.[PACKAGE] !== undefined) group[PACKAGE] = range\n writeFileSync(pkgFile, `${JSON.stringify(pkg, null, 2)}\\n`)\n for (const script of LIFECYCLE)\n if (typeof pkg.scripts?.[script] === 'string') lifecycle[script] = pkg.scripts[script]\n }\n return { files, lifecycle }\n}\n\n/** Remove a folder tree quietly. */\nexport const removeTree = (path: string) => rmSync(path, { recursive: true, force: true })\nexport { cpSync }\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Invocation {\n file: string\n args: string[]\n}\n\n/**\n * How to start a package manager without the shell option (Node warns about passing args to a shell, DEP0190, and a `.cmd` shim cannot be spawned directly).\n * Off Windows the command runs as it is. On Windows npm runs as `node npm-cli.js` (the one npm is running from, else the one beside `node`); any other\n * manager goes through `cmd.exe /d /s /c <name>.cmd`, whose arguments stay an array.\n */\nexport function packageManagerInvocation(\n command: string,\n args: readonly string[],\n platform: NodeJS.Platform = process.platform,\n env: NodeJS.ProcessEnv = process.env,\n exists: (path: string) => boolean = existsSync,\n execPath: string = process.execPath,\n): Invocation {\n if (platform !== 'win32') return { file: command, args: [...args] }\n if (command === 'npm') {\n const running = env.npm_execpath\n const cli =\n running !== undefined && /npm-cli\\.c?js$/.test(running)\n ? running\n : join(dirname(execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')\n if (exists(cli)) return { file: execPath, args: [cli, ...args] }\n }\n return { file: env.ComSpec ?? 'cmd.exe', args: ['/d', '/s', '/c', `${command}.cmd`, ...args] }\n}\n","import { spawn } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n mkdirSync,\n mkdtempSync,\n readdirSync,\n readFileSync,\n writeFileSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline/promises'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport { findSecrets } from '@webboxes/app-persistence'\nimport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST } from './names'\nimport {\n type Fetchers,\n fetchSource,\n LIFECYCLE,\n parseSource,\n readManifest,\n realFetchers,\n removeTree,\n SOURCE_FORMS,\n SourceError,\n writeTemplate,\n} from './source'\nimport { packageManagerInvocation } from './spawn'\n\nexport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST }\n\nexport const TEMPLATES = ['nodejs', 'notes', 'chat', 'bun', 'acryl-app'] as const\nexport type Template = (typeof TEMPLATES)[number]\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number]\n\n/** The version of this package. */\nexport const VERSION: string = (\n createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `${CREATE} ${VERSION} - create an ${CLASS} app\n\nUsage:\n npm create ${PACKAGE}@latest [directory] [source] [-- options]\n\nA source makes the app from someone else's template (it is downloaded and unpacked, nothing in it runs):\n github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)\n @scope/name[@version] an npm package (npm pack --ignore-scripts)\n ./template.tgz a packed template on disk\nA template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).\n\nOptions:\n --template <name> nodejs, notes, chat, bun (experimental), acryl-app (asked when not given)\n --install install the dependencies after creating the app (the lifecycle scripts it will run are listed first)\n --pm <manager> ${PACKAGE_MANAGERS.join(', ')} (default: the one that ran this command, else npm)\n -y, --yes ask nothing: template nodejs unless --template is given, directory ${PACKAGE}-app\n -h, --help show this help\n -v, --version show the version\n`\n\n/** A command line mistake. The command prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n override name = 'UsageError'\n}\n\nexport interface Io {\n stdout: { write(text: string): unknown }\n stderr: { write(text: string): unknown }\n cwd: string\n env: Record<string, string | undefined>\n /** Ask one question; `undefined` when there is no terminal to ask on. */\n ask: ((question: string) => Promise<string>) | undefined\n /** Run a program, showing its output; resolves to the exit code. */\n run(command: string, args: string[], cwd: string): Promise<number>\n /** How a template source is fetched; the real network and npm by default. */\n fetchers?: Fetchers\n}\n\nexport function processIo(): Io {\n const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n return {\n stdout: process.stdout,\n stderr: process.stderr,\n cwd: process.cwd(),\n env: process.env,\n ask: interactive\n ? async (question) => {\n const rl = createInterface({ input: process.stdin, output: process.stdout })\n try {\n return await rl.question(question)\n } finally {\n rl.close()\n }\n }\n : undefined,\n run: (command, args, cwd) =>\n new Promise((done) => {\n const invocation = packageManagerInvocation(command, args)\n const child = spawn(invocation.file, invocation.args, { cwd, stdio: 'inherit' })\n child.on('error', () => done(1))\n child.on('exit', (code) => done(code ?? 1))\n }),\n }\n}\n\nexport interface CreateOptions {\n directory: string | undefined\n template: Template | undefined\n install: boolean\n pm: PackageManager | undefined\n yes: boolean\n /** `github:owner/repo[#ref]`, `@scope/name` or a packed `.tgz`: a template from outside this package. */\n source: string | undefined\n}\n\nexport function isTemplate(value: string): value is Template {\n return (TEMPLATES as readonly string[]).includes(value)\n}\n\nexport function parseCreateOptions(argv: readonly string[]): CreateOptions {\n let parsed: ReturnType<typeof parse>\n try {\n parsed = parse(argv)\n } catch (error) {\n throw new UsageError((error as Error).message)\n }\n const { values, positionals } = parsed\n if (positionals.length > 2)\n throw new UsageError('takes a directory and at most one template source')\n if (positionals[1] !== undefined && values.template !== undefined)\n throw new UsageError('give a template source or --template, not both')\n if (values.template !== undefined && !isTemplate(values.template))\n throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n if (values.pm !== undefined && !(PACKAGE_MANAGERS as readonly string[]).includes(values.pm))\n throw new UsageError(`unknown package manager \"${values.pm}\" (${PACKAGE_MANAGERS.join(', ')})`)\n return {\n directory: positionals[0],\n template: values.template as Template | undefined,\n install: values.install === true,\n pm: values.pm as PackageManager | undefined,\n yes: values.yes === true,\n source: positionals[1],\n }\n}\n\nconst parse = (argv: readonly string[]) =>\n parseArgs({\n args: [...argv],\n allowPositionals: true,\n strict: true,\n options: {\n template: { type: 'string' },\n install: { type: 'boolean' },\n pm: { type: 'string' },\n yes: { type: 'boolean', short: 'y' },\n },\n })\n\n/** A valid package name from a directory name: lower case letters, digits and dashes. */\nexport function nameFrom(directory: string): string {\n const name = basename(resolve(directory))\n .toLowerCase()\n .replace(/[^a-z0-9-]+/g, '-')\n .replace(/^[^a-z]+/, '')\n .replace(/-+$/g, '')\n return name === '' ? 'acryl-app' : name\n}\n\nfunction walkUp(from: string, test: (dir: string) => string | undefined): string {\n let dir = from\n for (;;) {\n const found = test(dir)\n if (found) return found\n const parent = dirname(dir)\n if (parent === dir) throw new Error(`${CREATE} cannot find its files`)\n dir = parent\n }\n}\nconst here = dirname(fileURLToPath(import.meta.url))\nconst templatesRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'templates', 'nodejs')) ? join(d, 'templates') : undefined,\n )\n/** The framework docs: the copy `prepack` puts in the package, or `docs/framework` of the repository. */\nconst docsRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'docs', 'framework', 'README.md'))\n ? join(d, 'docs', 'framework')\n : undefined,\n )\n\n/**\n * The range a created app asks for: the framework version this package was released with, so a new app depends on the release that made it (and gets what that release's\n * commands can do), never an older one. A caret range, so it also takes the newer patch releases.\n */\nexport function frameworkRange(): string {\n const file = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n return `^${(JSON.parse(readFileSync(file, 'utf8')) as { version: string }).version}`\n}\n\nexport function replacePlaceholders(text: string, name: string): string {\n return text\n .replaceAll('__APP_NAME__', name)\n .replaceAll('__PACKAGE__', PACKAGE)\n .replaceAll('__CLASS__', CLASS)\n .replaceAll('__RANGE__', frameworkRange())\n}\n\n/** The guide for a coding agent in a created app: where the API is, how to run it, what must pass. */\nexport function agentsText(template: Exclude<Template, 'acryl-app'>, name: string): string {\n const run = {\n nodejs: 'npm run dev',\n notes: 'npm run dev',\n chat: 'npm run dev',\n bun: 'bun run dev',\n }[template]\n const desktopNote =\n template === 'nodejs' || template === 'notes' || template === 'chat'\n ? `\\nTo run it as a desktop window: \\`npx ${PACKAGE} add desktop\\`, \\`npm install\\`, then \\`npm run desktop\\` (see \\`docs/framework/getting-started/desktop.md\\`).`\n : ''\n const test = {\n nodejs: 'npm test` and `npm run check',\n notes: 'npm test` and `npm run check',\n chat: 'npm test` and `npm run check',\n bun: 'bun test` and `bun run check',\n }[template]\n const jsxNote =\n template === 'nodejs' || template === 'notes' || template === 'chat'\n ? 'Write pages in `.tsx` (see `src/' +\n (template === 'notes' ? 'views.tsx' : 'page.tsx') +\n \"`): the scripts in `package.json` run Node.js with `--import acrylblends/node-server/register`, which compiles `.tsx` with this app's own `typescript`, and `tsconfig.json` sets `jsx: react-jsx` with `jsxImportSource: acrylblends/jsx`. Render a component with `.toString()` and return it with `c.html(...)`. A command that starts the app without those scripts (a bare `node src/index.ts`) cannot load a `.tsx` file. Without a build step you can write the call JSX compiles to instead: `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'`, children after the props. See `docs/framework/guides/jsx.md`.\"\n : \"Bun compiles `.tsx` itself: write pages in `.tsx`, render a component with `.toString()` and return it with `c.html(...)`. `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'` (children after the props) is the same thing without JSX syntax. See `docs/framework/guides/jsx.md`.\"\n const clientNote =\n template === 'nodejs'\n ? `- **Client components** (run in the browser) live in \\`src/client/\\`, which has its own \\`tsconfig.json\\` (DOM types, no Node types); \\`clientModules\\` in \\`src/app.ts\\` compiles them when the browser asks, and \\`npm run build\\` compiles them once for production. See \\`src/client/counter.tsx\\` and \\`docs/framework/guides/client-modules.md\\`.\\n`\n : ''\n const chatStructure =\n template === 'chat'\n ? `\n## Structure (a chat app: a streamed answer, history in a database)\n\n- **The dependency rule:** only \\`src/db.ts\\` (the \\`opener\\` in \\`package.json\\`) opens the database. Every other file takes a \\`Db\\` (\\`import type { Db } from '${PACKAGE}/db'\\`) as an argument and never imports \\`node:sqlite\\`, \\`pg\\`, another driver or \\`${PACKAGE}/db/sqlite\\`. \\`npm test\\` and \\`npm run check\\` run \\`${PACKAGE} check-deps\\`, which names the file and line of a violation; do not move the \\`opener\\` entry to silence it.\n- \\`src/llm.ts\\`: \\`Llm\\`, what the app needs from a model (messages in, pieces out, an aborted signal stops the work), and \\`openAiCompatible\\`, which calls an OpenAI-compatible chat completions API with \\`stream: true\\`. The base URL is \\`DEEPSEEK_BASE_URL\\` (default \\`https://api.deepseek.com\\`), the model \\`DEEPSEEK_MODEL\\` (default \\`deepseek-chat\\`), the key **only** the environment variable \\`DEEPSEEK_API_KEY\\`, read at the moment of the call: never write it to a file, a response or a log.\n- \\`src/db.ts\\`: \\`openChatDb()\\` (the \\`db\\` port on a SQLite file, \\`data/chat.sqlite\\` or \\`$CHAT_DB\\`, with \\`migrations/\\` applied on start; it returns \\`{ db, close }\\`) and \\`chatStore(db)\\`. The routes only call \\`chatStore\\`; keep SQL out of them. Every \\`db\\` call returns a promise: \\`await\\` it. The shape of the database is \\`migrations/NNN-name.sql\\`: to change it add the next numbered file and never edit one that has run. See \\`docs/framework/guides/data.md\\`.\n- \\`src/app.ts\\` opens the database (top-level \\`await\\`) and exports the app and \\`close\\`; \\`src/index.ts\\` serves it and closes the database on SIGTERM. \\`src/chat-app.ts\\`: \\`createApp(db, llm)\\`. \\`POST /api/chat\\` answers Server-Sent Events: \\`meta\\` (the conversation id), a \\`token\\` per piece, then \\`done\\` or \\`error\\`. The request's signal (\\`c.req.raw.signal\\`) goes to the model call, so a closed tab or the Stop button stops the request to the model; what had arrived is kept.\n- \\`src/client/chat.tsx\\`: the client component (own \\`tsconfig.json\\`, browser types): sends the message with \\`fetch\\`, reads the events as they arrive, shows the answer growing, and aborts on Stop. \\`clientModules\\` compiles it when the browser asks; \\`npm run build\\` compiles it once into \\`dist/client\\`. See \\`docs/framework/guides/client-modules.md\\`.\n- \\`test/chat.test.ts\\` tests every route with a mock \\`Llm\\` (never the network); keep it that way. \\`test/server.test.ts\\` starts the real server and stops it with a signal.\n- To try it with a real model: \\`DEEPSEEK_API_KEY=... npm run dev\\`.\n\n## Before you ship\n\nRead \\`docs/framework/getting-started/deploy.md\\`. In short: \\`npm ci --omit=dev\\`, \\`npm run build\\`, \\`NODE_ENV=production npm start\\`; the app listens on \\`127.0.0.1\\` (\\`HOST=0.0.0.0\\` only in a container); the SQLite file goes outside the code folder (\\`CHAT_DB=/var/lib/chat/chat.sqlite\\`) and is backed up; the model key is an environment variable of the service (a root-only environment file for systemd), never a file in the repository. Anyone who can reach the app can spend your key: put it behind a login or on a private network before it is public.\n`\n : ''\n const notesStructure =\n template === 'notes'\n ? `\n## Structure (a notes app: accounts, sessions, a database)\n\n- \\`src/db.ts\\`: \\`openNotesDb()\\` (the \\`db\\` port on a SQLite file, \\`data/notes.sqlite\\` or \\`$NOTES_DB\\`, with \\`migrations/\\` applied on start; it returns \\`{ db, close }\\`) and \\`notesStore(db)\\`, the queries for notes. Every \\`db\\` call returns a promise: \\`await\\` it. Use \\`?\\` bindings, never string-built SQL. See \\`docs/framework/guides/data.md\\`.\n- \\`migrations/\\`: the shape of the database, one numbered file per change (\\`001-notes.sql\\`). A file that has run is never edited; a change is the next file (\\`002-name.sql\\`).\n- **The dependency rule:** only \\`src/db.ts\\` (the \\`opener\\` in \\`package.json\\`) opens the database. Every other file takes a \\`Db\\` (\\`import type { Db } from '${PACKAGE}/db'\\`) as an argument and never imports \\`node:sqlite\\`, \\`pg\\`, another driver or \\`${PACKAGE}/db/sqlite\\`. \\`npm test\\` and \\`npm run check\\` run \\`${PACKAGE} check-deps\\`, which names the file and line of a violation; do not move the \\`opener\\` entry to silence it.\n- \\`src/auth.ts\\`: scrypt password hashes (\\`node:crypto\\`) and the \\`sessions\\` table; the cookie \\`sid\\` holds a random token.\n- \\`src/schema.ts\\`: the rules for a note and for credentials. The HTML forms and the JSON API both use \\`checkNote\\`.\n- \\`src/views.tsx\\`: the pages, as JSX components rendered to strings, and the small script for the instant filter.\n- \\`src/client/\\`: client components, with their own \\`tsconfig.json\\` (browser types). \\`counter.tsx\\` is the live character counter. \\`clientModules\\` in \\`notes-app.ts\\` compiles them when the browser asks; \\`npm run build\\` compiles them once into \\`dist/client\\` for production. See \\`docs/framework/guides/client-modules.md\\`.\n- \\`src/notes-app.ts\\`: \\`createApp(db)\\` (pages and forms, csrf on) and \\`createApi(db)\\` (the JSON API under \\`/api/notes\\`, chained so \\`testClient\\` is typed). \\`src/app.ts\\` opens the database (top-level \\`await\\`) and exports the app and \\`close\\`; \\`src/index.ts\\` serves it and closes the database on SIGTERM. Tests open \\`openNotesDb(':memory:')\\` and pass its \\`db\\` to \\`createApp\\`.\n- \\`test/notes.test.ts\\`: a test for every route. A form POST in a test needs \\`origin: 'http://localhost'\\` (csrf) and the \\`sid\\` cookie from sign up.\n- Forms answer an invalid input with status 400 and the same page with the messages; a successful POST redirects with 303.\n- To add a column or a table: write the next migration (\\`migrations/002-name.sql\\`), then change \\`notesStore\\`, \\`checkNote\\`, the form and the list in \\`views.tsx\\`, and the tests. Do not edit \\`001-notes.sql\\`.\n\n## Before you ship\n\nRead \\`docs/framework/getting-started/deploy.md\\`. In short:\n\n- Install with \\`npm ci --omit=dev\\`, run \\`npm run build\\` (it compiles \\`src/client\\` once; with \\`NODE_ENV=production\\` only \\`dist/client\\` is served), and start with \\`NODE_ENV=production npm start\\` (\\`typescript\\` stays a runtime dependency: it compiles the \\`.tsx\\` pages at start).\n- The app listens on \\`127.0.0.1\\`; set \\`HOST=0.0.0.0\\` only in a container. \\`PORT\\` chooses the port.\n- Put the SQLite file outside the code folder (\\`NOTES_DB=/var/lib/notes/notes.sqlite\\`) and back it up.\n- Behind an HTTPS reverse proxy set \\`TRUST_PROXY=1\\` and \\`PUBLIC_ORIGIN=https://your.site\\`, or the cookie is not \\`Secure\\` and csrf refuses form posts.\n- \\`npm test\\` includes a test that starts the server and stops it with SIGTERM; keep it passing if you change \\`src/index.ts\\`.\n`\n : ''\n return `# ${name}\n\nAn ${CLASS} app (${template}${template === 'bun' ? ', experimental' : ''}): handlers over the Web Standard \\`Request\\` and \\`Response\\`, from the \\`${PACKAGE}\\` package.\n\n## The framework's API is in \\`docs/framework/\\`\n\nStart at \\`docs/framework/README.md\\`; \\`api/summary.md\\` is the one-page summary. Import the class from \\`'${PACKAGE}'\\` and each middleware or helper from its own\nsubpath (\\`'${PACKAGE}/cors'\\`, \\`'${PACKAGE}/validator'\\`, ...). Parts marked \"not yet available\" in the docs are not in the package yet.\n\n## This app\n\nRun it with \\`${run}\\`. The routes are in \\`${template === 'bun' ? 'src/index.ts' : template === 'notes' ? 'src/notes-app.ts' : template === 'chat' ? 'src/chat-app.ts' : 'src/app.ts'}\\`; an app is a function from \\`Request\\` to \\`Response\\`,\nso test a route with \\`await app.request('/path')\\` and no server.${desktopNote}\n\n${notesStructure}${chatStructure}\n## Things that surprise people\n\n- A page mounted at \\`/x\\` answers \\`/x\\`, not \\`/x/\\` (trailing slashes are strict); \\`trimTrailingSlash()\\` redirects.\n- A \\`json\\` validator target reads the body only with a JSON \\`Content-Type\\`; a failure answers 400 with \\`{ error, issues: [{ message, path }] }\\`.\n- \\`throw new HTTPException(404, { message })\\` answers an error response (plain text).\n- \\`testClient(app)\\` from \\`'${PACKAGE}/testing'\\` types only routes chained on the \\`new ${CLASS}()\\` expression (\\`new ${CLASS}().get(...).post(...)\\`); headers such as a cookie go in the second argument of each call.\n- **JSX:** ${jsxNote}\n${clientNote}\n## Before you say you are done\n\n\\`${test}\\` pass.\n`\n}\n\nfunction copyDocs(target: string): void {\n const filter = (path: string) => !/(upstream\\.json|UPSTREAM\\.md)$/.test(path)\n mkdirSync(join(target, 'docs'), { recursive: true })\n cpSync(docsRoot(), join(target, 'docs', 'framework'), { recursive: true, filter })\n}\n\nfunction copyTemplate(\n template: Exclude<Template, 'acryl-app'>,\n target: string,\n name: string,\n): string[] {\n const written: string[] = []\n const walk = (from: string, to: string, prefix: string) => {\n mkdirSync(to, { recursive: true })\n for (const entry of readdirSync(from, { withFileTypes: true })) {\n const targetName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(from, entry.name), join(to, targetName), `${prefix}${entry.name}/`)\n else {\n writeFileSync(\n join(to, targetName),\n replacePlaceholders(readFileSync(join(from, entry.name), 'utf8'), name),\n )\n written.push(`${prefix}${targetName}`)\n }\n }\n }\n walk(join(templatesRoot(), template), target, '')\n writeFileSync(join(target, 'AGENTS.md'), agentsText(template, name))\n writeFileSync(join(target, 'CLAUDE.md'), '@AGENTS.md\\n')\n copyDocs(target)\n return written\n}\n\nconst isEmpty = (directory: string) => !existsSync(directory) || readdirSync(directory).length === 0\n\n/** The `acrylblends` command of the installed framework package, which creates the `acryl-app` template. */\nfunction acrylblendsBin(): string {\n const pkgFile = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { bin?: string | Record<string, string> }\n const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[PACKAGE]\n if (!bin) throw new Error(`${PACKAGE} has no command to create an app with`)\n return join(dirname(pkgFile), bin)\n}\n\n/** The lifecycle scripts a template defines and the line that says when they run. */\nconst describeScripts = (scripts: Record<string, string>) =>\n Object.entries(scripts)\n .map(([key, value]) => ` ${key}: ${value}`)\n .join('\\n')\n\n/** Files whose text is checked for secrets: the template's own, not the framework docs copied in. */\nfunction textFiles(root: string): { path: string; text: string }[] {\n const found: { path: string; text: string }[] = []\n const walk = (dir: string, prefix: string) => {\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === '.git' ||\n (prefix === '' && entry.name === 'docs')\n )\n continue\n if (entry.isDirectory()) walk(join(dir, entry.name), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(dir, entry.name))\n if (!buffer.subarray(0, 8000).includes(0))\n found.push({ path: `${prefix}${entry.name}`, text: buffer.toString('utf8') })\n }\n }\n }\n walk(root, '')\n return found\n}\n\n/**\n * Create an app from a template source (`github:`, `@scope/name`, a packed tarball). The source is fetched and unpacked into a scratch folder, checked\n * (manifest, secrets), and only then copied to the target; nothing in it is installed or run unless `--install`, which lists the scripts first.\n */\nasync function createFromSource(\n options: CreateOptions,\n target: string,\n directory: string,\n io: Io,\n): Promise<number> {\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const scratch = mkdtempSync(join(tmpdir(), 'create-acrylblends-'))\n try {\n const source = parseSource(options.source!, io.cwd)\n if (!source)\n throw new UsageError(`unknown template source \"${options.source}\" (${SOURCE_FORMS})`)\n const name = nameFrom(target)\n await fetchSource(\n source,\n join(scratch, 'source'),\n join(scratch, 'download'),\n io.fetchers ?? realFetchers,\n )\n const manifest = readManifest(join(scratch, 'source'))\n const staged = join(scratch, 'app')\n const { files, lifecycle } = writeTemplate(\n join(scratch, 'source'),\n staged,\n (text) => replacePlaceholders(text, name),\n frameworkRange(),\n name,\n )\n if (!existsSync(join(staged, 'AGENTS.md')))\n writeFileSync(\n join(staged, 'AGENTS.md'),\n `# ${name}\\n\\nAn ${CLASS} app made from the template \"${manifest.name}\": ${manifest.description}\\n\\nThe framework's API is in \\`docs/framework/\\` (start at \\`docs/framework/README.md\\`).\\n`,\n )\n if (!existsSync(join(staged, 'CLAUDE.md')))\n writeFileSync(join(staged, 'CLAUDE.md'), '@AGENTS.md\\n')\n const found = findSecrets(textFiles(staged))\n if (found.length > 0) {\n io.stderr.write(\n `error: the template holds what looks like a secret, so nothing was created:\\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join('\\n')}\\n`,\n )\n return 1\n }\n copyDocs(staged)\n cpSync(staged, target, { recursive: true })\n io.stdout.write(\n `created ${name} from ${manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n if (manifest.plugins.length > 0)\n io.stdout.write(\n `it needs these plugins: ${manifest.plugins.join(', ')}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(' ')}\\n`,\n )\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n const hasScripts = Object.keys(lifecycle).length > 0\n if (options.install) {\n const pkg = JSON.parse(readFileSync(join(target, 'package.json'), 'utf8')) as {\n dependencies?: object\n devDependencies?: object\n }\n io.stdout.write(\n `running ${pm} install in ${directory}. This installs: ${[...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})].join(', ') || 'nothing'}` +\n `${hasScripts ? `\\nand runs the template's own lifecycle scripts:\\n${describeScripts(lifecycle)}` : ''}\\n` +\n `(the dependencies' install scripts run too unless your ${pm} is set to ignore them)\\n`,\n )\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n } else if (hasScripts) {\n io.stdout.write(\n `nothing was installed or run. The template defines ${LIFECYCLE.filter((k) => lifecycle[k]).join(', ')}, which ${pm} install would run:\\n${describeScripts(lifecycle)}\\nread them first, or pass --install to run them.\\n`,\n )\n }\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} see the template's README or package.json scripts\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof SourceError) {\n io.stderr.write(`error: ${error.message}\\nnothing was changed\\n`)\n return 1\n }\n throw error\n } finally {\n removeTree(scratch)\n }\n}\n\n/** Create the app. Returns the exit code: 0 done, 1 refused or failed, 2 a usage error. Never calls `process.exit`. */\nexport async function runCreate(argv: readonly string[], io: Io = processIo()): Promise<number> {\n try {\n if (argv.includes('-h') || argv.includes('--help')) {\n io.stdout.write(HELP)\n return 0\n }\n if (argv.includes('-v') || argv.includes('--version')) {\n io.stdout.write(`${VERSION}\\n`)\n return 0\n }\n const options = parseCreateOptions(argv)\n const ask = options.yes ? undefined : io.ask\n const directory =\n options.directory ??\n (ask\n ? (await ask(`Project directory (${PACKAGE}-app): `)).trim() || `${PACKAGE}-app`\n : `${PACKAGE}-app`)\n const target = resolve(io.cwd, directory)\n if (options.source !== undefined) return await createFromSource(options, target, directory, io)\n const template: Template =\n options.template ??\n (ask\n ? await (async () => {\n const answer =\n (\n await ask(\n `Which template do you want to use? (nodejs, notes, chat, bun (experimental), acryl-app) [nodejs]: `,\n )\n ).trim() || 'nodejs'\n if (!isTemplate(answer))\n throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n return answer\n })()\n : 'nodejs')\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const name = nameFrom(target)\n if (template === 'acryl-app') {\n const code = await io.run(\n process.execPath,\n [acrylblendsBin(), 'init', target, '--template', 'agent', '--name', name, '--yes'],\n io.cwd,\n )\n if (code !== 0) return 1\n } else {\n const files = copyTemplate(template, target, name)\n io.stdout.write(\n `created ${name} (${template}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n }\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n if (options.install) {\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n }\n const start = {\n nodejs: `${pm} run dev`,\n notes: `${pm} run dev`,\n chat: `${pm} run dev`,\n bun: 'bun run dev',\n 'acryl-app': `${pm} run dev`,\n }[template]\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} ${start}\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof UsageError) {\n io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n return 2\n }\n io.stderr.write(`error: ${(error as Error).message}\\n`)\n return 1\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/names.ts","../src/self-knowledge.ts","../src/source.ts","../src/spawn.ts","../src/index.ts"],"sourcesContent":["/**\n * The one place this package names the framework. The templates are written with `__PACKAGE__` and `__RANGE__` (the range is stamped at create time from the framework version this package carries, see `frameworkRange`), and the text of `AGENTS.md` with\n * `__PACKAGE__`, so a rename (for example to `acryl`) is a change here and in `scripts/lib/names.mjs`, which a test keeps equal.\n */\nexport const PACKAGE = 'acrylblends'\nexport const CLASS = 'Acryl'\nexport const CREATE = 'create-acrylblends'\n\n/** The file that makes a folder a template other people can create apps from (`${CREATE} <name> github:owner/repo`). */\nexport const TEMPLATE_MANIFEST = 'acryl.template.json'\n","import { mkdirSync, writeFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\n/**\n * What an app tells the agent that works in it (spec 049, slice 11): `AGENTS.md` and `CLAUDE.md` (the same text), and one skill that points\n * to `docs/framework/`. The door is Cordis-only for now, so a plain app's text does not mention it. The files are written from this module only, so the three can never disagree.\n */\n\ntype Template = 'nodejs' | 'notes' | 'chat' | 'bun'\n\n/** Where an agent looks for a skill: Claude Code reads `.claude/skills`, Codex and others read `.agents/skills`. The text is the same. */\nexport const SKILL_FOLDERS = ['.claude/skills/app-guide', '.agents/skills/app-guide'] as const\n\n/** The defaults of an app made from this template, each with the one place that swaps it. */\nfunction defaultRows(template: Template, pkg: string): string[] {\n const rows: string[] = []\n if (template === 'notes' || template === 'chat')\n rows.push(\n `| Records | \\`db\\` port, SQLite (\\`${pkg}/db/sqlite\\`) | the opener, \\`src/db.ts\\`: call another provider there; no route, store or test changes |`,\n )\n rows.push(\n `| Small state | \\`kv\\` port, one JSON file (\\`${pkg}/kv/json\\`) | \\`${pkg}/kv/db\\` keeps it in the \\`db\\`; or a provider of your own; the opener is the only file that changes |`,\n )\n rows.push(\n template === 'bun'\n ? `| Server | Bun | \\`${pkg}/node-server\\` for Node, or the adapter of another runtime; \\`src/index.ts\\` is the only file that changes |`\n : `| Server | Node (\\`${pkg}/node-server\\`) | the adapter of another runtime (\\`${pkg}/bun\\`, ...); \\`src/index.ts\\` is the only file that changes |`,\n )\n rows.push(\n `| Window | the browser | \\`npx ${pkg} add desktop\\` adds an Electron window on the same server; the app's code never imports Electron |`,\n )\n if (template === 'nodejs' || template === 'notes' || template === 'chat')\n rows.push(\n `| Browser code | \\`clientModules\\`, no bundler | a bundler (Vite, esbuild) in front of \\`src/client\\`, wrapped in a plugin of its own |`,\n )\n return rows\n}\n\n/** The section every app carries: the framework is a set of defaults, never a rule. */\nexport function defaultsSection(template: Template, pkg: string): string {\n return `## Defaults you can swap\n\nThe framework is not rigid. Every choice is a plugin behind a port, and what the app starts with is only a fallback. Name the default before you change it,\nand swap it at the one place that opens it.\n\n| Choice | Default | To swap it |\n| --- | --- | --- |\n${defaultRows(template, pkg).join('\\n')}\n\n- **An outside tool** (a database server, a bundler, a router such as Vike) joins the app as a provider: a plugin in \\`plugins/<name>/\\` that implements a port and\n passes that port's conformance tests, then the opener names it. Postgres is such a provider and is not part of this package; add it when the app needs it.\n- **The dependency rule:** only the opener imports a provider; everything else takes the port as an argument. \\`${pkg} check-deps\\` enforces it.\n`\n}\n\n/** Where the plugins are, said once. */\nexport function pluginsSection(pkg: string): string {\n return `## Plugins\n\nThere is one plugin folder: \\`plugins/\\` at the root of the app. A plugin is a folder \\`plugins/<name>/\\` with an \\`index.ts\\`. \\`${pkg} add <name>\\` copies a library plugin\nthere; a plugin you or an agent write goes there too. Do not create \\`src/plugins/\\` or \\`extensions/\\`.\n`\n}\n\n/** The text of the one skill. It repeats nothing of the docs; it says where to look and how to work. */\nexport function skillText(name: string, template: Template, pkg: string): string {\n return `---\nname: app-guide\ndescription: How to change, run and check the ${name} app. Use it before adding a feature, a page, a route, a plugin or a dependency to this app, and before saying the work is done.\n---\n\n# Working in ${name}\n\n1. **Read first.** \\`AGENTS.md\\` in this folder says how the app is laid out. The framework's API is in \\`docs/framework/\\`: start at \\`docs/framework/README.md\\`, and\n \\`docs/framework/api/summary.md\\` is the one-page summary. Parts the docs mark \"not yet available\" are not in the package.\n2. **Make the change small.** A route is a function from \\`Request\\` to \\`Response\\`: test it with \\`await app.request('/path')\\`. ${template === 'notes' || template === 'chat' ? 'A change to the data is the next numbered file in `migrations/`; never edit one that has run.' : 'Keep new code in `src/` next to the code it extends.'}\n3. **One plugin folder.** A plugin lives in \\`plugins/<name>/\\` (\\`${pkg} add <name>\\` copies a library plugin there). There is no \\`src/plugins/\\` and no \\`extensions/\\`.\n4. **Defaults are swappable.** The database, the key-value store, the server and the window are plugins behind ports. The table \"Defaults you can swap\" in \\`AGENTS.md\\` names each default and the one file that changes it. Never reach around a port to a driver: \\`${pkg} check-deps\\` fails the check.\n5. **Look at the running app.** Start it with its dev script, open it in a browser, and check the page; the app has no door command yet, so do not look for one.\n6. **Done means checked.** \\`npm test\\` and \\`npm run check\\` pass, and the change shows in the running app after a restart. No secret goes in a file or in \\`git status\\`: keys come from environment variables.\n`\n}\n\n/** Write the same text to `AGENTS.md` and `CLAUDE.md`, and the skill to every folder an agent looks in. */\nexport function writeSelfKnowledge(target: string, agentsText: string, skill: string): string[] {\n const written = ['AGENTS.md', 'CLAUDE.md']\n writeFileSync(join(target, 'AGENTS.md'), agentsText)\n writeFileSync(join(target, 'CLAUDE.md'), agentsText)\n for (const folder of SKILL_FOLDERS) {\n const file = join(target, folder, 'SKILL.md')\n mkdirSync(dirname(file), { recursive: true })\n writeFileSync(file, skill)\n written.push(`${folder}/SKILL.md`)\n }\n return written\n}\n","/**\n * Templates from outside this package: `github:owner/repo[#ref]`, a scoped npm package (`@scope/name[@version]`) or a packed tarball on disk.\n * A source is only ever downloaded and unpacked: no git clone (hooks), no lifecycle script (`npm pack --ignore-scripts`), nothing of it is run.\n */\nimport { spawnSync } from 'node:child_process'\nimport {\n cpSync,\n existsSync,\n lstatSync,\n mkdirSync,\n readdirSync,\n readFileSync,\n rmSync,\n writeFileSync,\n} from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { PACKAGE, TEMPLATE_MANIFEST } from './names'\n\nexport type Source =\n | { kind: 'github'; owner: string; repo: string; ref: string | undefined }\n | { kind: 'npm'; spec: string }\n | { kind: 'tarball'; path: string }\n\n/** What a template says about itself in `acryl.template.json`. */\nexport interface Manifest {\n name: string\n description: string\n /** Library plugins the template needs, added with `acrylblends add`. */\n plugins: string[]\n}\n\n/** A source that cannot be used; the message says why and is shown as it is. */\nexport class SourceError extends Error {\n override name = 'SourceError'\n}\n\nexport const SOURCE_FORMS = `github:owner/repo[#ref], @scope/name[@version], or a packed .tgz file`\n\nconst LIMITS = { files: 5000, bytes: 50 * 1024 * 1024 }\n\n/** Recognise a source argument, or return `undefined` when it is not one (so the caller can report a usage error). */\nexport function parseSource(text: string, cwd: string): Source | undefined {\n const github = /^github:([A-Za-z0-9_.-]+)\\/([A-Za-z0-9_.-]+)(?:#([A-Za-z0-9_./-]+))?$/.exec(text)\n if (github) return { kind: 'github', owner: github[1]!, repo: github[2]!, ref: github[3] }\n if (text.startsWith('github:')) throw new SourceError(`\"${text}\" is not github:owner/repo[#ref]`)\n if (/^@[a-z0-9][a-z0-9._-]*\\/[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9._-]+)?$/.test(text))\n return { kind: 'npm', spec: text }\n if (text.startsWith('@')) throw new SourceError(`\"${text}\" is not @scope/name[@version]`)\n if (/\\.(tgz|tar\\.gz)$/.test(text)) {\n const path = resolve(cwd, text)\n if (!existsSync(path)) throw new SourceError(`${path} does not exist`)\n return { kind: 'tarball', path }\n }\n return undefined\n}\n\n/** How the bytes of a source are obtained; real by default, replaced in tests. */\nexport interface Fetchers {\n /** The body at a URL (a GitHub tarball). */\n download(url: string): Promise<Uint8Array>\n /** `npm pack <spec> --ignore-scripts` into `dest`; the path of the tarball. */\n pack(spec: string, dest: string): string\n}\n\nexport const realFetchers: Fetchers = {\n async download(url) {\n const response = await fetch(url, { redirect: 'follow' })\n if (!response.ok) throw new SourceError(`${url} answered ${response.status}`)\n return new Uint8Array(await response.arrayBuffer())\n },\n pack(spec, dest) {\n const result = spawnSync(\n 'npm',\n ['pack', spec, '--ignore-scripts', '--json', '--pack-destination', dest],\n {\n encoding: 'utf8',\n shell: false,\n env: { ...process.env, npm_config_ignore_scripts: 'true' },\n },\n )\n if (result.status !== 0)\n throw new SourceError(\n `npm could not pack ${spec}: ${(result.stderr || result.stdout).trim().split('\\n').at(-1)}`,\n )\n const file = (JSON.parse(result.stdout) as { filename: string }[])[0]?.filename\n if (!file) throw new SourceError(`npm packed nothing for ${spec}`)\n return join(dest, file)\n },\n}\n\n/** Unpack a tarball into `dir`, dropping its single top folder; refuses links, paths that leave the folder, and archives that are too big. */\nfunction extract(tarball: string, dir: string): void {\n const list = spawnSync('tar', ['-tzf', tarball], {\n encoding: 'utf8',\n maxBuffer: 64 * 1024 * 1024,\n })\n if (list.status !== 0) throw new SourceError(`${tarball} is not a readable tar.gz archive`)\n const entries = list.stdout.split('\\n').filter(Boolean)\n if (entries.length > LIMITS.files)\n throw new SourceError(`the template has more than ${LIMITS.files} files`)\n for (const entry of entries)\n if (entry.startsWith('/') || entry.split('/').includes('..'))\n throw new SourceError(`the archive holds a path that leaves its folder: ${entry}`)\n mkdirSync(dir, { recursive: true })\n const run = spawnSync('tar', ['-xzf', tarball, '-C', dir, '--strip-components=1'], {\n encoding: 'utf8',\n })\n if (run.status !== 0) throw new SourceError(`could not unpack ${tarball}: ${run.stderr.trim()}`)\n let bytes = 0\n const walk = (folder: string) => {\n for (const entry of readdirSync(folder)) {\n const path = join(folder, entry)\n const info = lstatSync(path)\n if (info.isSymbolicLink())\n throw new SourceError(\n `the template holds a symbolic link (${path.slice(dir.length + 1)}); links are not allowed`,\n )\n if (info.isDirectory()) walk(path)\n else bytes += info.size\n }\n }\n walk(dir)\n if (bytes > LIMITS.bytes)\n throw new SourceError(`the template is larger than ${LIMITS.bytes / 1024 / 1024} MB`)\n}\n\n/** Download or pack a source and unpack it into `dir` (which must not exist yet). Nothing in it is run. */\nexport async function fetchSource(\n source: Source,\n dir: string,\n scratch: string,\n fetchers: Fetchers,\n): Promise<void> {\n mkdirSync(scratch, { recursive: true })\n let tarball: string\n if (source.kind === 'tarball') tarball = source.path\n else if (source.kind === 'npm') tarball = fetchers.pack(source.spec, scratch)\n else {\n tarball = join(scratch, 'source.tar.gz')\n writeFileSync(\n tarball,\n await fetchers.download(\n `https://codeload.github.com/${source.owner}/${source.repo}/tar.gz/${source.ref ?? 'HEAD'}`,\n ),\n )\n }\n extract(tarball, dir)\n}\n\n/** Read and check `acryl.template.json`; a source without it is not a template. */\nexport function readManifest(dir: string): Manifest {\n const file = join(dir, TEMPLATE_MANIFEST)\n if (!existsSync(file))\n throw new SourceError(\n `this source has no ${TEMPLATE_MANIFEST}, so it is not a template: add one with a name and a description (see the create-acrylblends guide)`,\n )\n let data: unknown\n try {\n data = JSON.parse(readFileSync(file, 'utf8'))\n } catch {\n throw new SourceError(`${TEMPLATE_MANIFEST} is not valid JSON`)\n }\n const m = data as Record<string, unknown>\n if (typeof m.name !== 'string' || m.name.trim() === '')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"name\"`)\n if (typeof m.description !== 'string')\n throw new SourceError(`${TEMPLATE_MANIFEST} needs a \"description\"`)\n const plugins = m.plugins ?? []\n if (\n !Array.isArray(plugins) ||\n plugins.some((p) => typeof p !== 'string' || !/^[a-z][a-z0-9-]*$/.test(p))\n )\n throw new SourceError(\n `\"plugins\" in ${TEMPLATE_MANIFEST} is a list of plugin names such as \"desktop\"`,\n )\n return { name: m.name, description: m.description, plugins: plugins as string[] }\n}\n\nconst SKIP = new Set(['.git', 'node_modules', TEMPLATE_MANIFEST])\n/** Lifecycle scripts npm runs on `npm install` in the app's own folder. */\nexport const LIFECYCLE = [\n 'preinstall',\n 'install',\n 'postinstall',\n 'prepublish',\n 'preprepare',\n 'prepare',\n 'postprepare',\n]\n\nconst isText = (buffer: Buffer) => !buffer.subarray(0, 8000).includes(0)\n\n/**\n * Copy the unpacked template into `target`, replacing the placeholders of the built-in templates, naming the app, and pointing a dependency on the framework at\n * the release this package carries. Returns the files written (relative paths) and the lifecycle scripts the app's package.json defines.\n */\nexport function writeTemplate(\n from: string,\n target: string,\n stamp: (text: string) => string,\n range: string,\n name: string,\n): { files: string[]; lifecycle: Record<string, string> } {\n const files: string[] = []\n const walk = (src: string, dst: string, prefix: string) => {\n mkdirSync(dst, { recursive: true })\n for (const entry of readdirSync(src, { withFileTypes: true })) {\n if (SKIP.has(entry.name)) continue\n const outName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(src, entry.name), join(dst, outName), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(src, entry.name))\n writeFileSync(join(dst, outName), isText(buffer) ? stamp(buffer.toString('utf8')) : buffer)\n files.push(`${prefix}${outName}`)\n }\n }\n }\n walk(from, target, '')\n const lifecycle: Record<string, string> = {}\n const pkgFile = join(target, 'package.json')\n if (existsSync(pkgFile)) {\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as {\n name?: string\n scripts?: Record<string, string>\n dependencies?: Record<string, string>\n devDependencies?: Record<string, string>\n }\n pkg.name = name\n for (const group of [pkg.dependencies, pkg.devDependencies])\n if (group?.[PACKAGE] !== undefined) group[PACKAGE] = range\n writeFileSync(pkgFile, `${JSON.stringify(pkg, null, 2)}\\n`)\n for (const script of LIFECYCLE)\n if (typeof pkg.scripts?.[script] === 'string') lifecycle[script] = pkg.scripts[script]\n }\n return { files, lifecycle }\n}\n\n/** Remove a folder tree quietly. */\nexport const removeTree = (path: string) => rmSync(path, { recursive: true, force: true })\nexport { cpSync }\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\n\nexport interface Invocation {\n file: string\n args: string[]\n}\n\n/**\n * How to start a package manager without the shell option (Node warns about passing args to a shell, DEP0190, and a `.cmd` shim cannot be spawned directly).\n * Off Windows the command runs as it is. On Windows npm runs as `node npm-cli.js` (the one npm is running from, else the one beside `node`); any other\n * manager goes through `cmd.exe /d /s /c <name>.cmd`, whose arguments stay an array.\n */\nexport function packageManagerInvocation(\n command: string,\n args: readonly string[],\n platform: NodeJS.Platform = process.platform,\n env: NodeJS.ProcessEnv = process.env,\n exists: (path: string) => boolean = existsSync,\n execPath: string = process.execPath,\n): Invocation {\n if (platform !== 'win32') return { file: command, args: [...args] }\n if (command === 'npm') {\n const running = env.npm_execpath\n const cli =\n running !== undefined && /npm-cli\\.c?js$/.test(running)\n ? running\n : join(dirname(execPath), 'node_modules', 'npm', 'bin', 'npm-cli.js')\n if (exists(cli)) return { file: execPath, args: [cli, ...args] }\n }\n return { file: env.ComSpec ?? 'cmd.exe', args: ['/d', '/s', '/c', `${command}.cmd`, ...args] }\n}\n","import { spawn } from 'node:child_process'\nimport {\n copyFileSync,\n cpSync,\n existsSync,\n mkdirSync,\n mkdtempSync,\n readdirSync,\n readFileSync,\n writeFileSync,\n} from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline/promises'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs } from 'node:util'\nimport { findSecrets } from '@webboxes/app-persistence'\nimport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST } from './names'\nimport { defaultsSection, pluginsSection, skillText, writeSelfKnowledge } from './self-knowledge'\nimport {\n type Fetchers,\n fetchSource,\n LIFECYCLE,\n parseSource,\n readManifest,\n realFetchers,\n removeTree,\n SOURCE_FORMS,\n SourceError,\n writeTemplate,\n} from './source'\nimport { packageManagerInvocation } from './spawn'\n\nexport { CLASS, CREATE, PACKAGE, TEMPLATE_MANIFEST }\n\nexport const TEMPLATES = ['nodejs', 'notes', 'chat', 'bun', 'acryl-app'] as const\nexport type Template = (typeof TEMPLATES)[number]\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number]\n\n/** The version of this package. */\nexport const VERSION: string = (\n createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `${CREATE} ${VERSION} - create an ${CLASS} app\n\nUsage:\n npm create ${PACKAGE}@latest [directory] [source] [-- options]\n\nA source makes the app from someone else's template (it is downloaded and unpacked, nothing in it runs):\n github:owner/repo[#ref] a GitHub repository, as a tarball (no clone)\n @scope/name[@version] an npm package (npm pack --ignore-scripts)\n ./template.tgz a packed template on disk\nA template is a folder with an ${TEMPLATE_MANIFEST} (name, description, plugins).\n\nOptions:\n --template <name> nodejs, notes, chat, bun (experimental), acryl-app (asked when not given)\n --install install the dependencies after creating the app (the lifecycle scripts it will run are listed first)\n --pm <manager> ${PACKAGE_MANAGERS.join(', ')} (default: the one that ran this command, else npm)\n -y, --yes ask nothing: template nodejs unless --template is given, directory ${PACKAGE}-app\n -h, --help show this help\n -v, --version show the version\n`\n\n/** A command line mistake. The command prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n override name = 'UsageError'\n}\n\nexport interface Io {\n stdout: { write(text: string): unknown }\n stderr: { write(text: string): unknown }\n cwd: string\n env: Record<string, string | undefined>\n /** Ask one question; `undefined` when there is no terminal to ask on. */\n ask: ((question: string) => Promise<string>) | undefined\n /** Run a program, showing its output; resolves to the exit code. */\n run(command: string, args: string[], cwd: string): Promise<number>\n /** How a template source is fetched; the real network and npm by default. */\n fetchers?: Fetchers\n}\n\nexport function processIo(): Io {\n const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n return {\n stdout: process.stdout,\n stderr: process.stderr,\n cwd: process.cwd(),\n env: process.env,\n ask: interactive\n ? async (question) => {\n const rl = createInterface({ input: process.stdin, output: process.stdout })\n try {\n return await rl.question(question)\n } finally {\n rl.close()\n }\n }\n : undefined,\n run: (command, args, cwd) =>\n new Promise((done) => {\n const invocation = packageManagerInvocation(command, args)\n const child = spawn(invocation.file, invocation.args, { cwd, stdio: 'inherit' })\n child.on('error', () => done(1))\n child.on('exit', (code) => done(code ?? 1))\n }),\n }\n}\n\nexport interface CreateOptions {\n directory: string | undefined\n template: Template | undefined\n install: boolean\n pm: PackageManager | undefined\n yes: boolean\n /** `github:owner/repo[#ref]`, `@scope/name` or a packed `.tgz`: a template from outside this package. */\n source: string | undefined\n}\n\nexport function isTemplate(value: string): value is Template {\n return (TEMPLATES as readonly string[]).includes(value)\n}\n\nexport function parseCreateOptions(argv: readonly string[]): CreateOptions {\n let parsed: ReturnType<typeof parse>\n try {\n parsed = parse(argv)\n } catch (error) {\n throw new UsageError((error as Error).message)\n }\n const { values, positionals } = parsed\n if (positionals.length > 2)\n throw new UsageError('takes a directory and at most one template source')\n if (positionals[1] !== undefined && values.template !== undefined)\n throw new UsageError('give a template source or --template, not both')\n if (values.template !== undefined && !isTemplate(values.template))\n throw new UsageError(`unknown template \"${values.template}\" (${TEMPLATES.join(', ')})`)\n if (values.pm !== undefined && !(PACKAGE_MANAGERS as readonly string[]).includes(values.pm))\n throw new UsageError(`unknown package manager \"${values.pm}\" (${PACKAGE_MANAGERS.join(', ')})`)\n return {\n directory: positionals[0],\n template: values.template as Template | undefined,\n install: values.install === true,\n pm: values.pm as PackageManager | undefined,\n yes: values.yes === true,\n source: positionals[1],\n }\n}\n\nconst parse = (argv: readonly string[]) =>\n parseArgs({\n args: [...argv],\n allowPositionals: true,\n strict: true,\n options: {\n template: { type: 'string' },\n install: { type: 'boolean' },\n pm: { type: 'string' },\n yes: { type: 'boolean', short: 'y' },\n },\n })\n\n/** A valid package name from a directory name: lower case letters, digits and dashes. */\nexport function nameFrom(directory: string): string {\n const name = basename(resolve(directory))\n .toLowerCase()\n .replace(/[^a-z0-9-]+/g, '-')\n .replace(/^[^a-z]+/, '')\n .replace(/-+$/g, '')\n return name === '' ? 'acryl-app' : name\n}\n\nfunction walkUp(from: string, test: (dir: string) => string | undefined): string {\n let dir = from\n for (;;) {\n const found = test(dir)\n if (found) return found\n const parent = dirname(dir)\n if (parent === dir) throw new Error(`${CREATE} cannot find its files`)\n dir = parent\n }\n}\nconst here = dirname(fileURLToPath(import.meta.url))\nconst templatesRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'templates', 'nodejs')) ? join(d, 'templates') : undefined,\n )\n/** The framework docs: the copy `prepack` puts in the package, or `docs/framework` of the repository. */\nconst docsRoot = () =>\n walkUp(here, (d) =>\n existsSync(join(d, 'docs', 'framework', 'README.md'))\n ? join(d, 'docs', 'framework')\n : undefined,\n )\n\n/**\n * The range a created app asks for: the framework version this package was released with, so a new app depends on the release that made it (and gets what that release's\n * commands can do), never an older one. A caret range, so it also takes the newer patch releases.\n */\nexport function frameworkRange(): string {\n const file = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n return `^${(JSON.parse(readFileSync(file, 'utf8')) as { version: string }).version}`\n}\n\nexport function replacePlaceholders(text: string, name: string): string {\n return text\n .replaceAll('__APP_NAME__', name)\n .replaceAll('__PACKAGE__', PACKAGE)\n .replaceAll('__CLASS__', CLASS)\n .replaceAll('__RANGE__', frameworkRange())\n}\n\n/** The guide for a coding agent in a created app: where the API is, how to run it, what must pass. */\nexport function agentsText(template: Exclude<Template, 'acryl-app'>, name: string): string {\n const run = {\n nodejs: 'npm run dev',\n notes: 'npm run dev',\n chat: 'npm run dev',\n bun: 'bun run dev',\n }[template]\n const desktopNote =\n template === 'nodejs' || template === 'notes' || template === 'chat'\n ? `\\nTo run it as a desktop window: \\`npx ${PACKAGE} add desktop\\`, \\`npm install\\`, then \\`npm run desktop\\` (see \\`docs/framework/getting-started/desktop.md\\`).`\n : ''\n const test = {\n nodejs: 'npm test` and `npm run check',\n notes: 'npm test` and `npm run check',\n chat: 'npm test` and `npm run check',\n bun: 'bun test` and `bun run check',\n }[template]\n const jsxNote =\n template === 'nodejs' || template === 'notes' || template === 'chat'\n ? 'Write pages in `.tsx` (see `src/' +\n (template === 'notes' ? 'views.tsx' : 'page.tsx') +\n \"`): the scripts in `package.json` run Node.js with `--import acrylblends/node-server/register`, which compiles `.tsx` with this app's own `typescript`, and `tsconfig.json` sets `jsx: react-jsx` with `jsxImportSource: acrylblends/jsx`. Render a component with `.toString()` and return it with `c.html(...)`. A command that starts the app without those scripts (a bare `node src/index.ts`) cannot load a `.tsx` file. Without a build step you can write the call JSX compiles to instead: `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'`, children after the props. See `docs/framework/guides/jsx.md`.\"\n : \"Bun compiles `.tsx` itself: write pages in `.tsx`, render a component with `.toString()` and return it with `c.html(...)`. `jsx('h1', { class: 'title' }, 'Hello')` from `'acrylblends/jsx'` (children after the props) is the same thing without JSX syntax. See `docs/framework/guides/jsx.md`.\"\n const clientNote =\n template === 'nodejs'\n ? `- **Client components** (run in the browser) live in \\`src/client/\\`, which has its own \\`tsconfig.json\\` (DOM types, no Node types); \\`clientModules\\` in \\`src/app.ts\\` compiles them when the browser asks, and \\`npm run build\\` compiles them once for production. See \\`src/client/counter.tsx\\` and \\`docs/framework/guides/client-modules.md\\`.\\n`\n : ''\n const chatStructure =\n template === 'chat'\n ? `\n## Structure (a chat app: a streamed answer, history in a database)\n\n- **The dependency rule:** only \\`src/db.ts\\` (the \\`opener\\` in \\`package.json\\`) opens the database. Every other file takes a \\`Db\\` (\\`import type { Db } from '${PACKAGE}/db'\\`) as an argument and never imports \\`node:sqlite\\`, \\`pg\\`, another driver or \\`${PACKAGE}/db/sqlite\\`. \\`npm test\\` and \\`npm run check\\` run \\`${PACKAGE} check-deps\\`, which names the file and line of a violation; do not move the \\`opener\\` entry to silence it.\n- \\`src/llm.ts\\`: \\`Llm\\`, what the app needs from a model (messages in, pieces out, an aborted signal stops the work), and \\`openAiCompatible\\`, which calls an OpenAI-compatible chat completions API with \\`stream: true\\`. The base URL is \\`DEEPSEEK_BASE_URL\\` (default \\`https://api.deepseek.com\\`), the model \\`DEEPSEEK_MODEL\\` (default \\`deepseek-chat\\`), the key **only** the environment variable \\`DEEPSEEK_API_KEY\\`, read at the moment of the call: never write it to a file, a response or a log.\n- \\`src/db.ts\\`: \\`openChatDb()\\` (the \\`db\\` port on a SQLite file, \\`data/chat.sqlite\\` or \\`$CHAT_DB\\`, with \\`migrations/\\` applied on start; it returns \\`{ db, close }\\`) and \\`chatStore(db)\\`. The routes only call \\`chatStore\\`; keep SQL out of them. Every \\`db\\` call returns a promise: \\`await\\` it. The shape of the database is \\`migrations/NNN-name.sql\\`: to change it add the next numbered file and never edit one that has run. See \\`docs/framework/guides/data.md\\`.\n- \\`src/app.ts\\` opens the database (top-level \\`await\\`) and exports the app and \\`close\\`; \\`src/index.ts\\` serves it and closes the database on SIGTERM. \\`src/chat-app.ts\\`: \\`createApp(db, llm)\\`. \\`POST /api/chat\\` answers Server-Sent Events: \\`meta\\` (the conversation id), a \\`token\\` per piece, then \\`done\\` or \\`error\\`. The request's signal (\\`c.req.raw.signal\\`) goes to the model call, so a closed tab or the Stop button stops the request to the model; what had arrived is kept.\n- \\`src/client/chat.tsx\\`: the client component (own \\`tsconfig.json\\`, browser types): sends the message with \\`fetch\\`, reads the events as they arrive, shows the answer growing, and aborts on Stop. \\`clientModules\\` compiles it when the browser asks; \\`npm run build\\` compiles it once into \\`dist/client\\`. See \\`docs/framework/guides/client-modules.md\\`.\n- \\`test/chat.test.ts\\` tests every route with a mock \\`Llm\\` (never the network); keep it that way. \\`test/server.test.ts\\` starts the real server and stops it with a signal.\n- To try it with a real model: \\`DEEPSEEK_API_KEY=... npm run dev\\`.\n\n## Before you ship\n\nRead \\`docs/framework/getting-started/deploy.md\\`. In short: \\`npm ci --omit=dev\\`, \\`npm run build\\`, \\`NODE_ENV=production npm start\\`; the app listens on \\`127.0.0.1\\` (\\`HOST=0.0.0.0\\` only in a container); the SQLite file goes outside the code folder (\\`CHAT_DB=/var/lib/chat/chat.sqlite\\`) and is backed up; the model key is an environment variable of the service (a root-only environment file for systemd), never a file in the repository. Anyone who can reach the app can spend your key: put it behind a login or on a private network before it is public.\n`\n : ''\n const notesStructure =\n template === 'notes'\n ? `\n## Structure (a notes app: accounts, sessions, a database)\n\n- \\`src/db.ts\\`: \\`openNotesDb()\\` (the \\`db\\` port on a SQLite file, \\`data/notes.sqlite\\` or \\`$NOTES_DB\\`, with \\`migrations/\\` applied on start; it returns \\`{ db, close }\\`) and \\`notesStore(db)\\`, the queries for notes. Every \\`db\\` call returns a promise: \\`await\\` it. Use \\`?\\` bindings, never string-built SQL. See \\`docs/framework/guides/data.md\\`.\n- \\`migrations/\\`: the shape of the database, one numbered file per change (\\`001-notes.sql\\`). A file that has run is never edited; a change is the next file (\\`002-name.sql\\`).\n- **The dependency rule:** only \\`src/db.ts\\` (the \\`opener\\` in \\`package.json\\`) opens the database. Every other file takes a \\`Db\\` (\\`import type { Db } from '${PACKAGE}/db'\\`) as an argument and never imports \\`node:sqlite\\`, \\`pg\\`, another driver or \\`${PACKAGE}/db/sqlite\\`. \\`npm test\\` and \\`npm run check\\` run \\`${PACKAGE} check-deps\\`, which names the file and line of a violation; do not move the \\`opener\\` entry to silence it.\n- \\`src/auth.ts\\`: scrypt password hashes (\\`node:crypto\\`) and the \\`sessions\\` table; the cookie \\`sid\\` holds a random token.\n- \\`src/schema.ts\\`: the rules for a note and for credentials. The HTML forms and the JSON API both use \\`checkNote\\`.\n- \\`src/views.tsx\\`: the pages, as JSX components rendered to strings, and the small script for the instant filter.\n- \\`src/client/\\`: client components, with their own \\`tsconfig.json\\` (browser types). \\`counter.tsx\\` is the live character counter. \\`clientModules\\` in \\`notes-app.ts\\` compiles them when the browser asks; \\`npm run build\\` compiles them once into \\`dist/client\\` for production. See \\`docs/framework/guides/client-modules.md\\`.\n- \\`src/notes-app.ts\\`: \\`createApp(db)\\` (pages and forms, csrf on) and \\`createApi(db)\\` (the JSON API under \\`/api/notes\\`, chained so \\`testClient\\` is typed). \\`src/app.ts\\` opens the database (top-level \\`await\\`) and exports the app and \\`close\\`; \\`src/index.ts\\` serves it and closes the database on SIGTERM. Tests open \\`openNotesDb(':memory:')\\` and pass its \\`db\\` to \\`createApp\\`.\n- \\`test/notes.test.ts\\`: a test for every route. A form POST in a test needs \\`origin: 'http://localhost'\\` (csrf) and the \\`sid\\` cookie from sign up.\n- Forms answer an invalid input with status 400 and the same page with the messages; a successful POST redirects with 303.\n- To add a column or a table: write the next migration (\\`migrations/002-name.sql\\`), then change \\`notesStore\\`, \\`checkNote\\`, the form and the list in \\`views.tsx\\`, and the tests. Do not edit \\`001-notes.sql\\`.\n\n## Before you ship\n\nRead \\`docs/framework/getting-started/deploy.md\\`. In short:\n\n- Install with \\`npm ci --omit=dev\\`, run \\`npm run build\\` (it compiles \\`src/client\\` once; with \\`NODE_ENV=production\\` only \\`dist/client\\` is served), and start with \\`NODE_ENV=production npm start\\` (\\`typescript\\` stays a runtime dependency: it compiles the \\`.tsx\\` pages at start).\n- The app listens on \\`127.0.0.1\\`; set \\`HOST=0.0.0.0\\` only in a container. \\`PORT\\` chooses the port.\n- Put the SQLite file outside the code folder (\\`NOTES_DB=/var/lib/notes/notes.sqlite\\`) and back it up.\n- Behind an HTTPS reverse proxy set \\`TRUST_PROXY=1\\` and \\`PUBLIC_ORIGIN=https://your.site\\`, or the cookie is not \\`Secure\\` and csrf refuses form posts.\n- \\`npm test\\` includes a test that starts the server and stops it with SIGTERM; keep it passing if you change \\`src/index.ts\\`.\n`\n : ''\n return `# ${name}\n\nAn ${CLASS} app (${template}${template === 'bun' ? ', experimental' : ''}): handlers over the Web Standard \\`Request\\` and \\`Response\\`, from the \\`${PACKAGE}\\` package.\n\n## The framework's API is in \\`docs/framework/\\`\n\nStart at \\`docs/framework/README.md\\`; \\`api/summary.md\\` is the one-page summary. Import the class from \\`'${PACKAGE}'\\` and each middleware or helper from its own\nsubpath (\\`'${PACKAGE}/cors'\\`, \\`'${PACKAGE}/validator'\\`, ...). Parts marked \"not yet available\" in the docs are not in the package yet.\n\n## This app\n\nRun it with \\`${run}\\`. The routes are in \\`${template === 'bun' ? 'src/index.ts' : template === 'notes' ? 'src/notes-app.ts' : template === 'chat' ? 'src/chat-app.ts' : 'src/app.ts'}\\`; an app is a function from \\`Request\\` to \\`Response\\`,\nso test a route with \\`await app.request('/path')\\` and no server.${desktopNote}\n\n${notesStructure}${chatStructure}\n${defaultsSection(template, PACKAGE)}\n${pluginsSection(PACKAGE)}\n## Things that surprise people\n\n- A page mounted at \\`/x\\` answers \\`/x\\`, not \\`/x/\\` (trailing slashes are strict); \\`trimTrailingSlash()\\` redirects.\n- A \\`json\\` validator target reads the body only with a JSON \\`Content-Type\\`; a failure answers 400 with \\`{ error, issues: [{ message, path }] }\\`.\n- \\`throw new HTTPException(404, { message })\\` answers an error response (plain text).\n- \\`testClient(app)\\` from \\`'${PACKAGE}/testing'\\` types only routes chained on the \\`new ${CLASS}()\\` expression (\\`new ${CLASS}().get(...).post(...)\\`); headers such as a cookie go in the second argument of each call.\n- **JSX:** ${jsxNote}\n${clientNote}\n## Before you say you are done\n\n\\`${test}\\` pass.\n`\n}\n\nfunction copyDocs(target: string): void {\n const filter = (path: string) => !/(upstream\\.json|UPSTREAM\\.md)$/.test(path)\n mkdirSync(join(target, 'docs'), { recursive: true })\n cpSync(docsRoot(), join(target, 'docs', 'framework'), { recursive: true, filter })\n}\n\nfunction copyTemplate(\n template: Exclude<Template, 'acryl-app'>,\n target: string,\n name: string,\n): string[] {\n const written: string[] = []\n const walk = (from: string, to: string, prefix: string) => {\n mkdirSync(to, { recursive: true })\n for (const entry of readdirSync(from, { withFileTypes: true })) {\n const targetName = prefix === '' && entry.name === 'gitignore' ? '.gitignore' : entry.name\n if (entry.isDirectory())\n walk(join(from, entry.name), join(to, targetName), `${prefix}${entry.name}/`)\n else {\n writeFileSync(\n join(to, targetName),\n replacePlaceholders(readFileSync(join(from, entry.name), 'utf8'), name),\n )\n written.push(`${prefix}${targetName}`)\n }\n }\n }\n walk(join(templatesRoot(), template), target, '')\n written.push(\n ...writeSelfKnowledge(target, agentsText(template, name), skillText(name, template, PACKAGE)),\n )\n copyDocs(target)\n return written\n}\n\nconst isEmpty = (directory: string) => !existsSync(directory) || readdirSync(directory).length === 0\n\n/** The `acrylblends` command of the installed framework package, which creates the `acryl-app` template. */\nfunction acrylblendsBin(): string {\n const pkgFile = createRequire(import.meta.url).resolve(`${PACKAGE}/package.json`)\n const pkg = JSON.parse(readFileSync(pkgFile, 'utf8')) as { bin?: string | Record<string, string> }\n const bin = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[PACKAGE]\n if (!bin) throw new Error(`${PACKAGE} has no command to create an app with`)\n return join(dirname(pkgFile), bin)\n}\n\n/** The lifecycle scripts a template defines and the line that says when they run. */\nconst describeScripts = (scripts: Record<string, string>) =>\n Object.entries(scripts)\n .map(([key, value]) => ` ${key}: ${value}`)\n .join('\\n')\n\n/** Files whose text is checked for secrets: the template's own, not the framework docs copied in. */\nfunction textFiles(root: string): { path: string; text: string }[] {\n const found: { path: string; text: string }[] = []\n const walk = (dir: string, prefix: string) => {\n for (const entry of readdirSync(dir, { withFileTypes: true })) {\n if (\n entry.name === 'node_modules' ||\n entry.name === '.git' ||\n (prefix === '' && entry.name === 'docs')\n )\n continue\n if (entry.isDirectory()) walk(join(dir, entry.name), `${prefix}${entry.name}/`)\n else {\n const buffer = readFileSync(join(dir, entry.name))\n if (!buffer.subarray(0, 8000).includes(0))\n found.push({ path: `${prefix}${entry.name}`, text: buffer.toString('utf8') })\n }\n }\n }\n walk(root, '')\n return found\n}\n\n/**\n * Create an app from a template source (`github:`, `@scope/name`, a packed tarball). The source is fetched and unpacked into a scratch folder, checked\n * (manifest, secrets), and only then copied to the target; nothing in it is installed or run unless `--install`, which lists the scripts first.\n */\nasync function createFromSource(\n options: CreateOptions,\n target: string,\n directory: string,\n io: Io,\n): Promise<number> {\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const scratch = mkdtempSync(join(tmpdir(), 'create-acrylblends-'))\n try {\n const source = parseSource(options.source!, io.cwd)\n if (!source)\n throw new UsageError(`unknown template source \"${options.source}\" (${SOURCE_FORMS})`)\n const name = nameFrom(target)\n await fetchSource(\n source,\n join(scratch, 'source'),\n join(scratch, 'download'),\n io.fetchers ?? realFetchers,\n )\n const manifest = readManifest(join(scratch, 'source'))\n const staged = join(scratch, 'app')\n const { files, lifecycle } = writeTemplate(\n join(scratch, 'source'),\n staged,\n (text) => replacePlaceholders(text, name),\n frameworkRange(),\n name,\n )\n if (!existsSync(join(staged, 'AGENTS.md')))\n writeFileSync(\n join(staged, 'AGENTS.md'),\n `# ${name}\\n\\nAn ${CLASS} app made from the template \"${manifest.name}\": ${manifest.description}\\n\\nThe framework's API is in \\`docs/framework/\\` (start at \\`docs/framework/README.md\\`).\\n`,\n )\n if (!existsSync(join(staged, 'CLAUDE.md')))\n copyFileSync(join(staged, 'AGENTS.md'), join(staged, 'CLAUDE.md'))\n const found = findSecrets(textFiles(staged))\n if (found.length > 0) {\n io.stderr.write(\n `error: the template holds what looks like a secret, so nothing was created:\\n${found.map((f) => ` ${f.path}:${f.line} (${f.kind})`).join('\\n')}\\n`,\n )\n return 1\n }\n copyDocs(staged)\n cpSync(staged, target, { recursive: true })\n io.stdout.write(\n `created ${name} from ${manifest.name} (${manifest.description}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n if (manifest.plugins.length > 0)\n io.stdout.write(\n `it needs these plugins: ${manifest.plugins.join(', ')}; add them with: npx ${PACKAGE} add ${manifest.plugins.join(' ')}\\n`,\n )\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n const hasScripts = Object.keys(lifecycle).length > 0\n if (options.install) {\n const pkg = JSON.parse(readFileSync(join(target, 'package.json'), 'utf8')) as {\n dependencies?: object\n devDependencies?: object\n }\n io.stdout.write(\n `running ${pm} install in ${directory}. This installs: ${[...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})].join(', ') || 'nothing'}` +\n `${hasScripts ? `\\nand runs the template's own lifecycle scripts:\\n${describeScripts(lifecycle)}` : ''}\\n` +\n `(the dependencies' install scripts run too unless your ${pm} is set to ignore them)\\n`,\n )\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n } else if (hasScripts) {\n io.stdout.write(\n `nothing was installed or run. The template defines ${LIFECYCLE.filter((k) => lifecycle[k]).join(', ')}, which ${pm} install would run:\\n${describeScripts(lifecycle)}\\nread them first, or pass --install to run them.\\n`,\n )\n }\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} see the template's README or package.json scripts\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof SourceError) {\n io.stderr.write(`error: ${error.message}\\nnothing was changed\\n`)\n return 1\n }\n throw error\n } finally {\n removeTree(scratch)\n }\n}\n\n/** Create the app. Returns the exit code: 0 done, 1 refused or failed, 2 a usage error. Never calls `process.exit`. */\nexport async function runCreate(argv: readonly string[], io: Io = processIo()): Promise<number> {\n try {\n if (argv.includes('-h') || argv.includes('--help')) {\n io.stdout.write(HELP)\n return 0\n }\n if (argv.includes('-v') || argv.includes('--version')) {\n io.stdout.write(`${VERSION}\\n`)\n return 0\n }\n const options = parseCreateOptions(argv)\n const ask = options.yes ? undefined : io.ask\n const directory =\n options.directory ??\n (ask\n ? (await ask(`Project directory (${PACKAGE}-app): `)).trim() || `${PACKAGE}-app`\n : `${PACKAGE}-app`)\n const target = resolve(io.cwd, directory)\n if (options.source !== undefined) return await createFromSource(options, target, directory, io)\n const template: Template =\n options.template ??\n (ask\n ? await (async () => {\n const answer =\n (\n await ask(\n `Which template do you want to use? (nodejs, notes, chat, bun (experimental), acryl-app) [nodejs]: `,\n )\n ).trim() || 'nodejs'\n if (!isTemplate(answer))\n throw new UsageError(`unknown template \"${answer}\" (${TEMPLATES.join(', ')})`)\n return answer\n })()\n : 'nodejs')\n if (!isEmpty(target)) {\n io.stderr.write(`error: ${target} is not empty; nothing was changed\\n`)\n return 1\n }\n const name = nameFrom(target)\n if (template === 'acryl-app') {\n const code = await io.run(\n process.execPath,\n [acrylblendsBin(), 'init', target, '--template', 'agent', '--name', name, '--yes'],\n io.cwd,\n )\n if (code !== 0) return 1\n } else {\n const files = copyTemplate(template, target, name)\n io.stdout.write(\n `created ${name} (${template}) in ${target}: ${files.length} files, ${CLASS} docs in docs/framework\\n`,\n )\n }\n const pm: PackageManager =\n options.pm ??\n ((PACKAGE_MANAGERS as readonly string[]).find((m) =>\n (io.env.npm_config_user_agent ?? '').startsWith(`${m}/`),\n ) as PackageManager | undefined) ??\n 'npm'\n if (options.install) {\n if ((await io.run(pm, ['install'], target)) !== 0) {\n io.stderr.write(`error: ${pm} install failed; run it yourself in ${directory}\\n`)\n return 1\n }\n }\n const start = {\n nodejs: `${pm} run dev`,\n notes: `${pm} run dev`,\n chat: `${pm} run dev`,\n bun: 'bun run dev',\n 'acryl-app': `${pm} run dev`,\n }[template]\n io.stdout.write(\n `\\nNext:\\n cd ${directory}\\n${options.install ? '' : ` ${pm} install\\n`} ${start}\\n`,\n )\n return 0\n } catch (error) {\n if (error instanceof UsageError) {\n io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n return 2\n }\n io.stderr.write(`error: ${(error as Error).message}\\n`)\n return 1\n }\n}\n"],"mappings":"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"}
|
package/docs/framework/README.md
CHANGED
|
@@ -29,7 +29,7 @@ The starter asks which template you want (`nodejs`, `bun` (experimental), or `ac
|
|
|
29
29
|
See [Built-in middleware](middleware/builtin/basic-auth.md) and [Middleware](concepts/middleware.md).
|
|
30
30
|
- **Helpers** for cookies, streaming and server-sent events, content negotiation, HTML templates, WebSockets and testing. See [Helpers](guides/helpers.md).
|
|
31
31
|
- **Typed routes and a typed client.** Route types flow from the server to `acrylblends/client`. See [RPC](guides/rpc.md).
|
|
32
|
-
- **Data** through one small `db` interface: SQL with numbered migrations on SQLite
|
|
32
|
+
- **Data** through one small `db` interface: SQL with numbered migrations on SQLite; the same code runs on Postgres through an optional plugin. See [Data](guides/data.md).
|
|
33
33
|
- **Validation** with a validator function or any Standard Schema library. See [Validation](guides/validation.md).
|
|
34
34
|
- **A Cordis plugin around it.** A plugin mounts an app with `ctx.router.route`, the mount goes away when the plugin unloads, and a coding agent can write such plugins
|
|
35
35
|
into a running app. See [Acryl in a Cordis app](cordis/acryl-in-a-cordis-app.md) and [Agents](agents/index.md).
|
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
# Generated copy
|
|
2
2
|
|
|
3
|
-
This folder is a copy of `docs/framework` of acryldev/acryl at commit `
|
|
3
|
+
This folder is a copy of `docs/framework` of acryldev/acryl at commit `f132283c43337f5e1d58dfbbbc15786efb5e756c`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.
|
|
@@ -5,14 +5,29 @@ A coding agent (Claude Code, Codex, OpenCode, Copilot and others) builds on Acry
|
|
|
5
5
|
|
|
6
6
|
- `docs/framework/`: these pages. Start at `README.md`; `api/summary.md` is the one-page summary of the API.
|
|
7
7
|
- `AGENTS.md`: where the API is, how a feature is built (an `Acryl` app mounted with `ctx.router.route`, a plugin registered in `src/app.ts` and `blend.yaml`, a state cell),
|
|
8
|
-
the things that surprise people, and what must pass before a task is done (`npm test` and `npm run check`).
|
|
9
|
-
- `CLAUDE.md`:
|
|
8
|
+
the defaults and how each is swapped, the things that surprise people, and what must pass before a task is done (`npm test` and `npm run check`).
|
|
9
|
+
- `CLAUDE.md`: the same text as `AGENTS.md`, so tools that read either file read the same guide.
|
|
10
|
+
- One skill, `app-guide`, in `.claude/skills/app-guide/SKILL.md` and `.agents/skills/app-guide/SKILL.md` (the same text): where to read first, the one plugin folder, the defaults, the door, and what "done" means.
|
|
11
|
+
- `.gitignore` lists `.acryl/`, the folder the door keeps its secret and state in, so `git add -A` stages none of it.
|
|
12
|
+
|
|
13
|
+
## One plugin folder
|
|
14
|
+
|
|
15
|
+
Every plugin of an app is a folder in `plugins/<name>/`, at the root of the app: the library plugins `acrylblends add <name>` copies (listed in `plugins/library.json`), and the
|
|
16
|
+
plugins you or an agent write. There is no `src/plugins/` and no `extensions/`. An app made before this layout keeps working for one release: the CLI reads its `src/plugins/` and
|
|
17
|
+
`extensions/` and warns; move them with `git mv src/plugins plugins`, fix the paths in `tsconfig.json`, `package.json` and `src/`, and `git mv extensions/<name> plugins/<name>`.
|
|
18
|
+
|
|
19
|
+
## Defaults, and how to swap each
|
|
20
|
+
|
|
21
|
+
The framework is not rigid: every choice is a plugin behind a port, and the default is only a fallback. A new app names each default in `AGENTS.md`: records on the `db` port
|
|
22
|
+
with SQLite, small state on the `kv` port with one JSON file, the Node server, the browser as the window (`acrylblends add desktop` adds Electron), browser code through
|
|
23
|
+
`clientModules`. A swap changes the one file that opens or mounts the choice (the opener, `src/db.ts`; or `src/app.ts` in a Blend app), because nothing else imports a provider
|
|
24
|
+
(`acrylblends check-deps` checks it). An outside tool, such as a database server or a bundler, joins the app as a provider in `plugins/<name>/` that implements the port.
|
|
10
25
|
|
|
11
26
|
## What an agent can do inside a running app
|
|
12
27
|
|
|
13
28
|
The `acryl-app` template (a Cordis app) also lets an agent change the app while it runs:
|
|
14
29
|
|
|
15
|
-
1. The agent writes a plugin into `
|
|
30
|
+
1. The agent writes a plugin into `plugins/<name>/index.ts`. The plugin may import `acrylblends` and the other subpaths by name.
|
|
16
31
|
2. The app installs it as a child plugin, runs its `check(ctx)` with the plugin's own context, and keeps the previous version if the new one fails to start or to pass its check.
|
|
17
32
|
3. A plugin's routes are an `Acryl` app mounted with `ctx.router.route`, so removing the plugin removes its routes.
|
|
18
33
|
|
|
@@ -16,11 +16,11 @@ npm run desktop
|
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
In a Blend app, the same two commands (`npx acrylblends add desktop`, `npm install`) add the Blend form of the shell, and `npx acrylblends init my-app --template todo --desktop` creates a Blend app with it already in.
|
|
19
|
-
`acrylblends add desktop` chooses the right form: a Blend app (it has `
|
|
19
|
+
`acrylblends add desktop` chooses the right form: a Blend app (it has `plugins/instance`) or a plain Acryl app.
|
|
20
20
|
|
|
21
21
|
## What it adds
|
|
22
22
|
|
|
23
|
-
- `
|
|
23
|
+
- `plugins/desktop-web/` (a plain app) or `plugins/desktop/` (a Blend app): the window code. Only this folder imports `electron`; the app's own code never does.
|
|
24
24
|
- `electron` as a development dependency (pinned to 44.9.3) and the script `npm run desktop`.
|
|
25
25
|
- `.acrylblends/` in `.gitignore`: Electron's user data (window state, cache, logs) lives in `.acrylblends/electron` inside the app's own folder, never in the user's application-data folder.
|
|
26
26
|
|
|
@@ -149,8 +149,9 @@ For a request that streams its answer and a Stop button (an `AbortController` ke
|
|
|
149
149
|
- JSX in a client module always compiles for the DOM renderer (`acrylblends/jsx/dom`), whatever the server's `tsconfig.json` says. A file's
|
|
150
150
|
own `/** @jsxImportSource ... */` comment still wins.
|
|
151
151
|
- `acrylblends/jsx/dom`, its `jsx-runtime`, `jsx-dev-runtime` and `client` are one browser module (`@acrylblends/jsx-dom.js`), and
|
|
152
|
-
`acrylblends/client` is another (`@acrylblends/client.js`)
|
|
153
|
-
|
|
152
|
+
`acrylblends/client` is another (`@acrylblends/client.js`), and `acrylblends/read-sse` (the reader of a POST event stream, see
|
|
153
|
+
[Streaming](../helpers/streaming.md#reading-a-post-event-stream-in-the-browser)) a third (`@acrylblends/read-sse.js`). None imports anything. The same app
|
|
154
|
+
serves them, and each import is rewritten to a URL relative to the module, so the setup works under whatever path you route `clientModules` at.
|
|
154
155
|
- Import your own modules with their file names, as the browser fetches them: `import { label } from './parts/label.ts'`.
|
|
155
156
|
- Another package (`import confetti from 'canvas-confetti'`) is left as it is: add an
|
|
156
157
|
[import map](https://developer.mozilla.org/docs/Web/HTML/Element/script/type/importmap) to the page for it, or use a bundler.
|
|
@@ -185,7 +186,7 @@ Compile the client folder once when you build, as the `build` script of your `pa
|
|
|
185
186
|
}
|
|
186
187
|
```
|
|
187
188
|
|
|
188
|
-
It writes each module compiled to `dist/client` at the same path and file name, so the page's URLs stay the same, and copies the
|
|
189
|
+
It writes each module compiled to `dist/client` at the same path and file name, so the page's URLs stay the same, and copies the three
|
|
189
190
|
browser modules to `dist/client/@acrylblends/`. Run it where `typescript` is installed, before the development dependencies are removed.
|
|
190
191
|
|
|
191
192
|
With `NODE_ENV=production` and the `compiled` option set, `clientModules` serves only that folder and compiles nothing. A module that is in
|
|
@@ -2,18 +2,82 @@
|
|
|
2
2
|
|
|
3
3
|
An app that keeps records (users, notes, orders) keeps them in a SQL database, and reaches it through one small interface, `db`. Handlers and
|
|
4
4
|
stores take a `Db` as an argument and never import a driver, so the file or server behind it can change without touching them. SQLite is the
|
|
5
|
-
provider
|
|
5
|
+
provider in `acrylblends`. Postgres (or Supabase, through `DATABASE_URL`) is an optional plugin, `acryl-db-postgres`, that serves the same
|
|
6
|
+
interface; it is not part of `acrylblends` or the templates, and an app adds it only when it must use Postgres.
|
|
6
7
|
|
|
7
8
|
## Choosing
|
|
8
9
|
|
|
9
10
|
| The app | Use | State |
|
|
10
11
|
| --- | --- | --- |
|
|
11
12
|
| Normal web or desktop app, users, lists, orders | `db` with SQLite (the `notes` and `chat` templates) | available |
|
|
12
|
-
|
|
|
13
|
-
| Tiny, one person, a few screens | `kv
|
|
14
|
-
| Agents or long tasks that must survive a restart | `durable`, in the same database as `db` | planned |
|
|
13
|
+
| Must use Postgres or Supabase | `db` with the optional `acryl-db-postgres` plugin | optional, not in `acrylblends` |
|
|
14
|
+
| Tiny, one person, a few screens | [`kv`](#a-tiny-app-kv), named JSON documents with no SQL | available |
|
|
15
15
|
|
|
16
|
-
Start with `db
|
|
16
|
+
Start with `db` when the data has users, lists or relations: SQL is what people and coding agents already know. Start with `kv` when the whole
|
|
17
|
+
data is a handful of settings or a small list that one process reads and writes.
|
|
18
|
+
|
|
19
|
+
## A tiny app: `kv`
|
|
20
|
+
|
|
21
|
+
`kv` keeps named JSON documents in one file, with no SQL and no migrations. It suits a settings page, a demo, a one-person tool.
|
|
22
|
+
|
|
23
|
+
```ts
|
|
24
|
+
import { openKv } from 'acrylblends/kv/json'
|
|
25
|
+
|
|
26
|
+
const { kv, close } = await openKv({ path: 'data/kv.json' })
|
|
27
|
+
|
|
28
|
+
await kv.set('theme', 'dark')
|
|
29
|
+
const theme = await kv.get<string>('theme') // 'dark'; undefined for a key that was never set
|
|
30
|
+
|
|
31
|
+
// Change a value from the value it has now, without losing a concurrent change.
|
|
32
|
+
const visits = await kv.update<number>('visits', (current) => (current ?? 0) + 1)
|
|
33
|
+
|
|
34
|
+
await kv.set('todos/1', { title: 'Buy milk', done: false })
|
|
35
|
+
await kv.set('todos/2', { title: 'Write docs', done: true })
|
|
36
|
+
const keys = await kv.list('todos/') // ['todos/1', 'todos/2'], sorted by code point
|
|
37
|
+
|
|
38
|
+
await kv.delete('todos/1') // a key that is not there is not an error
|
|
39
|
+
await close()
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
- A key is a non-empty string; a prefix such as `todos/` groups related documents. A value is JSON (`null`, booleans, numbers, strings, arrays,
|
|
43
|
+
objects). `undefined`, functions, bigints and `NaN` are refused with a `TypeError` before anything is written, and a value read back is a copy.
|
|
44
|
+
- `update` runs your function with the current value (`undefined` when the key is missing) and stores what it returns. The function is
|
|
45
|
+
**synchronous**: an `async` function is a type error. Read what you need first with `await kv.get(...)`, then update with a plain function.
|
|
46
|
+
If it throws, the value stays as it was.
|
|
47
|
+
- Every write reaches the disk before its promise resolves, and the file is replaced as a whole (a temporary file, then a rename), so a crash
|
|
48
|
+
or a power cut leaves the old file or the new one, never half of one. A file that exists but does not parse stops the app with a message that
|
|
49
|
+
names it; it is never started over.
|
|
50
|
+
- Like `db`, the store is passed to the code that needs it (`createApp(kv)`), opened in one place, and closed when the process stops.
|
|
51
|
+
A test opens a file in a temporary folder.
|
|
52
|
+
|
|
53
|
+
### When to move to SQL
|
|
54
|
+
|
|
55
|
+
The whole file is kept in memory and rewritten on every write, and one process owns it. Move to `db` when:
|
|
56
|
+
|
|
57
|
+
- more than one process must write (two writers would overwrite each other);
|
|
58
|
+
- the file grows past a few megabytes, or you need to search, sort or join the data;
|
|
59
|
+
- the data gets relations (users who own notes).
|
|
60
|
+
|
|
61
|
+
The same `kv` interface runs on SQL, so the code does not change, only the line that opens it. `kvOnDb` keeps the documents in a `kv` table of the
|
|
62
|
+
database from `openDb`, and `copyKv` moves what the file holds:
|
|
63
|
+
|
|
64
|
+
```ts
|
|
65
|
+
import { copyKv } from 'acrylblends/kv'
|
|
66
|
+
import { openKv } from 'acrylblends/kv/json'
|
|
67
|
+
import { kvOnDb } from 'acrylblends/kv/db'
|
|
68
|
+
import { openDb } from 'acrylblends/db/sqlite'
|
|
69
|
+
|
|
70
|
+
const file = await openKv({ path: 'data/kv.json' })
|
|
71
|
+
const sql = await openDb({ path: 'data/app.sqlite', migrations: 'migrations' })
|
|
72
|
+
|
|
73
|
+
const { copied } = await copyKv(file.kv, kvOnDb(sql.db)) // refuses to overwrite a key the table already has, unless you pass { overwrite: true }
|
|
74
|
+
|
|
75
|
+
await file.close()
|
|
76
|
+
await sql.close()
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
On the command line, `npx acrylblends kv import data/kv.json data/app.sqlite` does the same (add `--overwrite` to replace keys the table has).
|
|
80
|
+
The table is created on first use, beside the app's own tables; nothing else changes.
|
|
17
81
|
|
|
18
82
|
## Open the database
|
|
19
83
|
|
|
@@ -126,7 +190,7 @@ await db.transaction(async (tx) => {
|
|
|
126
190
|
|
|
127
191
|
## Writing SQL that moves to Postgres
|
|
128
192
|
|
|
129
|
-
The Postgres
|
|
193
|
+
The optional Postgres plugin serves the same interface. SQL that stays inside this list runs on both:
|
|
130
194
|
|
|
131
195
|
- Placeholders are `?` on every provider.
|
|
132
196
|
- Use `RETURNING` to get a new row, not a driver-specific "last id".
|
|
@@ -205,8 +269,8 @@ The rule is checked, not hoped for. The app names its opener once, in `package.j
|
|
|
205
269
|
}
|
|
206
270
|
```
|
|
207
271
|
|
|
208
|
-
`acrylblends check-deps` reads every `.ts`, `.tsx` and `.js` file in `src/`, `test/`, `tests/` and `
|
|
209
|
-
the opener imports a database driver, an opener such as `acrylblends/db/sqlite` or `acryl-db-sqlite`, or (outside `
|
|
272
|
+
`acrylblends check-deps` reads every `.ts`, `.tsx` and `.js` file in `src/`, `test/`, `tests/` and `plugins/`, and fails when a file other than
|
|
273
|
+
the opener imports a database driver, an opener such as `acrylblends/db/sqlite` or `acryl-db-sqlite`, or (outside `plugins/desktop`) `electron`.
|
|
210
274
|
It names the file and the line:
|
|
211
275
|
|
|
212
276
|
```
|
|
@@ -86,7 +86,7 @@ app.get('/sse', async (c) => {
|
|
|
86
86
|
A reader that closes the tab, loses the network or presses a Stop button should not leave your server working for nobody (a request to a paid model, a database scan). There are two signals, and they are not the same:
|
|
87
87
|
|
|
88
88
|
- **`c.req.raw.signal`** is the request's `AbortSignal`. It aborts when the client goes away. Pass it to anything that takes a `signal`, such as `fetch`, and the work stops with the client. This is the one to use for cancelling work.
|
|
89
|
-
- **`stream.onAbort(callback)`** and **`stream.aborted`** belong to the response stream. They report that the *reader of the response* was cancelled.
|
|
89
|
+
- **`stream.onAbort(callback)`** and **`stream.aborted`** belong to the response stream. They report that the *reader of the response* was cancelled, and they are set when the response body is cancelled, which is what the Node adapter does when the connection closes. Over a real connection, a browser that aborts its `fetch` (or closes the tab) fires both: the request signal and `stream.onAbort`. Under `app.request()` (in-process, no socket) they come apart, and this is how the upstream behaves too: aborting the `signal` you passed to `app.request()` fires `c.req.raw.signal` while `stream.aborted` stays `false`, and cancelling the reader of the response body fires `stream.onAbort` while `c.req.raw.signal` does not. A test that simulates the client leaving therefore aborts the request signal (for work cancelled through the signal) or cancels the body reader (for `stream.onAbort`), whichever the handler listens to. Use `c.req.raw.signal` for the work, and `stream.onAbort` for cleanup of the stream itself.
|
|
90
90
|
|
|
91
91
|
An abort event that has already fired does not fire again, so check `signal.aborted` before you wait for it:
|
|
92
92
|
|
|
@@ -160,31 +160,10 @@ app.post('/api/chat', async (c) => {
|
|
|
160
160
|
|
|
161
161
|
## Reading a POST event stream in the browser
|
|
162
162
|
|
|
163
|
-
`EventSource` can only send a GET request. For a POST (a chat message), read the response
|
|
163
|
+
`EventSource` can only send a GET request. For a POST (a chat message), call `fetch` and read the events with `readSSE` from `acrylblends/read-sse`. It is an async iterator over the events of a `text/event-stream` response, parsed by the rules of the SSE standard (LF, CRLF and CR line ends, several `data` lines joined with a line feed, comments, UTF-8 split across chunks):
|
|
164
164
|
|
|
165
165
|
```ts
|
|
166
|
-
|
|
167
|
-
const reader = body.getReader()
|
|
168
|
-
const decoder = new TextDecoder()
|
|
169
|
-
let buffer = ''
|
|
170
|
-
for (;;) {
|
|
171
|
-
const { done, value } = await reader.read()
|
|
172
|
-
if (done) return
|
|
173
|
-
// Line endings may be CRLF; a \r at the end of a chunk is completed by the next chunk, so normalise the whole buffer.
|
|
174
|
-
buffer = (buffer + decoder.decode(value, { stream: true })).replaceAll('\r\n', '\n')
|
|
175
|
-
const blocks = buffer.split('\n\n')
|
|
176
|
-
buffer = blocks.pop() ?? ''
|
|
177
|
-
for (const block of blocks) {
|
|
178
|
-
let event = 'message'
|
|
179
|
-
const data: string[] = []
|
|
180
|
-
for (const line of block.split('\n')) {
|
|
181
|
-
if (line.startsWith('event:')) event = line.slice(6).trim()
|
|
182
|
-
else if (line.startsWith('data:')) data.push(line.slice(5).replace(/^ /, '')) // the SSE spec strips one leading space only
|
|
183
|
-
}
|
|
184
|
-
on(event, data.join('\n'))
|
|
185
|
-
}
|
|
186
|
-
}
|
|
187
|
-
}
|
|
166
|
+
import { readSSE } from 'acrylblends/read-sse'
|
|
188
167
|
|
|
189
168
|
const controller = new AbortController() // controller.abort() is the Stop button
|
|
190
169
|
const response = await fetch('/api/chat', {
|
|
@@ -193,13 +172,19 @@ const response = await fetch('/api/chat', {
|
|
|
193
172
|
body: JSON.stringify({ message: 'Hello' }),
|
|
194
173
|
signal: controller.signal,
|
|
195
174
|
})
|
|
175
|
+
|
|
196
176
|
let answer = ''
|
|
197
|
-
await
|
|
177
|
+
for await (const { event, data } of readSSE(response)) {
|
|
198
178
|
if (event === 'token') answer += JSON.parse(data) as string
|
|
199
|
-
}
|
|
179
|
+
}
|
|
200
180
|
```
|
|
201
181
|
|
|
202
|
-
|
|
182
|
+
- Each event is `{ event, data, id?, retry? }`; `event` is `message` when the server named none, and `data` is a string (parse it yourself when the server sends JSON).
|
|
183
|
+
- Leaving the loop early (a `break`, a thrown error) cancels the response body, so the request to the server ends. Abort the `fetch` with its own `signal` for a Stop button; `readSSE(response, { signal })` also stops reading when a signal aborts.
|
|
184
|
+
- A response that is not `ok` throws with its status (the body is not parsed as events), and a response without a body throws.
|
|
185
|
+
- A client module served by `clientModules` can import it as it is (`import { readSSE } from 'acrylblends/read-sse'`): the import is pointed at a browser file the same app serves, like `acrylblends/client`. With a bundler it is an ordinary import.
|
|
186
|
+
|
|
187
|
+
A complete chat component is in the `chat` template of `create-acrylblends` (`npm create acrylblends@latest my-chat -- --template chat`).
|
|
203
188
|
|
|
204
189
|
## Error Handling
|
|
205
190
|
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"source": {
|
|
3
3
|
"repo": "acryldev/acryl",
|
|
4
4
|
"path": "docs/framework",
|
|
5
|
-
"commit": "
|
|
5
|
+
"commit": "f132283c43337f5e1d58dfbbbc15786efb5e756c"
|
|
6
6
|
},
|
|
7
7
|
"files": 99,
|
|
8
|
-
"digest": "sha256:
|
|
8
|
+
"digest": "sha256:9b0fe3329319398ce1108a015a99247c001b02cfb30a953b4b180a73674e2aec"
|
|
9
9
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-acrylblends",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.8",
|
|
4
4
|
"description": "Create an Acryl app: npm create acrylblends@latest",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
"scaffold"
|
|
38
38
|
],
|
|
39
39
|
"dependencies": {
|
|
40
|
-
"acrylblends": "^0.7.
|
|
40
|
+
"acrylblends": "^0.7.8",
|
|
41
41
|
"@webboxes/app-persistence": "0.1.1"
|
|
42
42
|
},
|
|
43
43
|
"publishConfig": {
|
package/templates/bun/gitignore
CHANGED
package/templates/chat/gitignore
CHANGED