create-trokky 0.1.1

package/dist/generate.js

@@ -0,0 +1,131 @@
+/**
+ * config → file tree. Pure: nothing here touches the disk, so it is testable, it runs in a
+ * browser as readily as in a terminal, and the same function serves the CLI, a zip download and
+ * an API install.
+ */
+import { hasFrontend, hasStudio } from './config.js';
+import { validate, describe } from './validate.js';
+import * as emit from './emit.js';
+/**
+ * Which copied file sets a composition pulls in, in order.
+ *
+ * A content model owns two sets: `content/<id>` is its schemas, structure and seed, and
+ * `site/<id>` is the pages that render them. They are separate because a headless install wants
+ * the first without the second — and they are named after the model rather than shared, because
+ * pages are written against particular collections. Adding a content model means adding those
+ * directories; nothing here needs to learn its name.
+ *
+ * There is deliberately no `node` set: every file a Node project needs has contents that depend
+ * on the choices, so all of it is emitted. An empty directory would not survive git or npm
+ * anyway — it did not, and the failure was a scandir error on a user's machine.
+ */
+function sources(config) {
+    const sets = ['base'];
+    if (config.target === 'workers')
+        sets.push('workers');
+    if (config.content !== 'blank')
+        sets.push(`content/${config.content}`);
+    if (hasFrontend(config))
+        sets.push(`site/${config.content}`);
+    return sets;
+}
+function copyInto(tree, source, set) {
+    for (const [path, contents] of source.read(set)) {
+        // npm refuses to ship a .gitignore inside a package — it is on its always-ignored list — so
+        // the template keeps it dotless and the name is restored here. Miss this and the set it
+        // lives in arrives empty, which surfaces as an error on a user's machine, not at publish.
+        tree.set(path.replace(/(^|\/)gitignore$/, '$1.gitignore'), contents);
+    }
+}
+export function generate(config, source) {
+    const result = validate(config);
+    if (!result.valid) {
+        throw new Error(`This combination cannot be built:\n${describe(result.problems)}`);
+    }
+    const tree = new Map();
+    for (const set of sources(config))
+        copyInto(tree, source, set);
+    // Files whose contents depend on the choices.
+    tree.set('package.json', emit.packageJson(config));
+    tree.set('tsconfig.json', emit.tsconfig(config));
+    tree.set('README.md', readme(config));
+    if (hasFrontend(config)) {
+        tree.set('astro.config.mjs', emit.astroConfig(config));
+        tree.set('src/trokky/page.ts', emit.pageHelper(config));
+    }
+    if (config.target === 'workers') {
+        tree.set('wrangler.jsonc', emit.wranglerConfig(config));
+        tree.set('src/worker.ts', emit.workersEntry(config));
+        tree.set('src/trokky/core.ts', emit.workersCore(config));
+        tree.set('.dev.vars.example', emit.envExample(config));
+    }
+    else {
+        tree.set('src/server.ts', emit.nodeEntry(config));
+        tree.set('trokky.config.ts', emit.trokkyConfig(config));
+        tree.set('.env.example', emit.envExample(config));
+    }
+    // A Studio-less project has nothing to copy Studio into.
+    if (!hasStudio(config)) {
+        tree.delete('scripts/copy-studio.mjs');
+    }
+    // Seed assets are only reachable when something serves static files.
+    if (config.content === 'blank' || (config.target === 'workers' && !hasStudio(config) && !hasFrontend(config))) {
+        for (const path of [...tree.keys()])
+            if (path.startsWith('public/seed/'))
+                tree.delete(path);
+    }
+    return tree;
+}
+function readme(config) {
+    const edge = config.target === 'workers';
+    const parts = hasFrontend(config) ? 'a site, the Studio and the API' : hasStudio(config) ? 'the Studio and the API' : 'the API';
+    return `# ${config.name}
+
+A [Trokky](https://trokky.dev) project: ${parts}, on ${edge ? 'Cloudflare Workers' : 'Node'}.
+
+Generated with \`npm create trokky@latest\`.
+
+## What is in it
+
+| | |
+|---|---|
+| Content | ${config.data} |
+| Uploads | ${config.media} |
+| Thumbnails | ${config.images === 'none' ? 'not generated — originals only' : config.images} |
+| Parts | ${parts} |
+| Starting content | ${config.content} |
+
+## Run it
+
+\`\`\`
+${edge ? `cp .dev.vars.example .dev.vars   # fill both secrets
+npm install
+npm run build && npm run preview` : `cp .env.example .env             # fill both secrets
+npm install
+npm run dev`}
+\`\`\`
+
+${edge ? `## Deploy
+
+\`\`\`
+npm run build && npm run deploy
+\`\`\`
+
+Wrangler provisions the D1 database and R2 bucket named in \`wrangler.jsonc\` on first deploy.
+\`database_id\` is intentionally empty: it is bound by name.
+
+` : ''}## The first minute
+
+Open ${hasStudio(config) ? '`/studio`' : 'the API'}. Nobody owns this instance yet, so the first
+screen asks you to **claim** it: pick a username and password, and paste \`TROKKY_CLAIM_SECRET\`.
+${config.content === 'blank' ? '' : 'Sample content appears a moment later — edit it or delete it.'}
+
+Without a claim secret the claim is open to whoever reaches the URL first. That is fine for the
+minute between deploying and opening the link; it is not fine for an instance left sitting.
+
+## Make it yours
+
+${config.content === 'blank' ? '- `src/trokky/` — add your schemas; the Studio follows them.' : '- `src/trokky/schemas.ts` — the content model. The Studio follows it.\n- `src/trokky/structure.ts` — the Studio sidebar.'}
+${hasFrontend(config) ? '- `src/pages/` and `src/layouts/` — the site.\n' : ''}${edge ? '- `wrangler.jsonc` — the Worker name and its resources.' : '- `trokky.config.ts` — storage, media and security.'}
+`;
+}

package/dist/generated/files-binary.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GENERATED by scripts/inline-files.mjs — do not edit.
+ *
+ * The magazine's images and PDFs, base64. Imported lazily: only a composition that chooses
+ * that content model needs them, and they are most of the payload.
+ */
+export declare const binary: Record<string, string>;