@mosetta/cli 0.0.12 → 0.0.14

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @mosetta/cli
 
+## 0.0.14
+
+### Patch Changes
+
+- Drafts and looks with draft blocks. A tile palette's build can be a DRAFT — `mosetta push --draft`:
+  no version spent, the site unchanged, the palette keeps its last ten. Any page of the site opened
+  with `?previewOverride=<brand>.<block>:<draft>` shows that block from the draft, whatever version
+  the page names, its server side included — for the site's editors, or anybody with a shared link;
+  `<brand>:<draft>` overrides every block of it. The runner lays the blocks asked for over the
+  palette for that request only (a tile host may now be merged with an OVERLAY over another), and the
+  site leads them to their draft where it aligns every page.
+- Updated dependencies
+  - @mosetta/server@0.0.14
+  - @mosetta/runtime@0.0.14
+  - @mosetta/build@0.0.14
+  - @mosetta/stores@0.0.14
+
+## 0.0.13
+
+### Patch Changes
+
+- Updated dependencies
+  - @mosetta/server@0.0.13
+  - @mosetta/build@0.0.13
+  - @mosetta/stores@0.0.13
+  - @mosetta/runtime@0.0.13
+
 ## 0.0.12
 
 ### Patch Changes

package/README.md

@@ -5,7 +5,7 @@ The `mosetta` command: a development server and the build of a deployable tile p
 ```
 mosetta dev   [--root <dir>] [--port <n>] [--write] [--no-typecheck]
 mosetta build [--root <dir>] [--out <dir>] [--no-typecheck] [--released <descriptor url|file>]
-mosetta push  [--root <dir>] [--target <name>] [--dry-run]
+mosetta push  [--root <dir>] [--target <name>] [--dry-run] [--draft]
 mosetta login [--target <name>]
 mosetta version <patch|minor|major> [--package <brand|name>]
 ```
@@ -16,7 +16,10 @@ mosetta version <patch|minor|major> [--package <brand|name>]
   stylesheets, the tile host descriptor) and `dist/private/` (server sides, root renderers), gated
   on a clean type check. `--released` leaves out what a platform already holds.
 - `push` releases the build through a platform's API: no store key on the machine, the platform
-  checks every byte against the build's manifest.
+  checks every byte against the build's manifest. `--draft` sends a tile palette's build as a draft
+  instead: no version is spent and the site does not change; any page of the site opened with
+  `?previewOverride=<brand>:<draft>` (or `<brand>.<block>:<draft>` for one block) shows the draft's
+  blocks to the site's editors. The palette keeps its last 10 drafts.
 
 A site is a folder with `mosetta.json` (its brand and the tile palettes it uses), `tiles/` and
 `pages/`.

package/bin/mosetta.mjs

@@ -103,7 +103,7 @@ switch (cmd) {
     // the built distribution released THROUGH the platform's API: no store key here — the token
     // `mosetta login` kept, the target from mosetta.json's publish.<--target|default>
     try {
-      const release = await push(root, { target: opt('--target', 'default'), dryRun: flag('--dry-run') });
+      const release = await push(root, { target: opt('--target', 'default'), dryRun: flag('--dry-run'), draft: flag('--draft') });
       sectionLog('cli')(`push: ${JSON.stringify(release)}`);
     } catch (e) {
       sectionLog('cli')(e.message);
@@ -137,5 +137,5 @@ switch (cmd) {
     }
     break;
   default:
-    sectionLog('cli')('usage: mosetta <dev|build|deploy|push|login|logout|version> [--root <dir>] [--port <n>] [--write] [--out <dir>] [--no-typecheck] [--released <descriptor url|file>] [--registry <file> | --target <name>] [--content|--force-content|--content-only] [--dry-run]; mosetta version <patch|minor|major> [--package <brand|name>]');
+    sectionLog('cli')('usage: mosetta <dev|build|deploy|push|login|logout|version> [--root <dir>] [--port <n>] [--write] [--out <dir>] [--no-typecheck] [--released <descriptor url|file>] [--registry <file> | --target <name>] [--content|--force-content|--content-only] [--dry-run] [--draft]; mosetta version <patch|minor|major> [--package <brand|name>]');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mosetta/cli",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "license": "MIT",
   "description": "mosetta CLI: development server (single port, live reload, type-check companion), building a deployable tile palette and publishing it.",
   "type": "module",
@@ -13,10 +13,10 @@
     "esbuild-wasm": "0.24.2",
     "systemjs": "^6.15.1",
     "workerd": "^1.20260630.1",
-    "@mosetta/build": "0.0.12",
-    "@mosetta/runtime": "0.0.12",
-    "@mosetta/server": "0.0.12",
-    "@mosetta/stores": "0.0.12"
+    "@mosetta/build": "0.0.14",
+    "@mosetta/stores": "0.0.14",
+    "@mosetta/runtime": "0.0.14",
+    "@mosetta/server": "0.0.14"
   },
   "publishConfig": {
     "access": "public"

package/src/push.mjs

@@ -12,6 +12,10 @@ import { sectionLog } from './log.mjs';
 // checks every byte and runs the release rules on its side, writing with keys only it holds. Where
 // to push is the app's `publish` target in mosetta.json; who pushes is the token `mosetta login`
 // kept (or MOSETTA_TOKEN).
+//
+// `--draft` sends a tile palette's build as a DRAFT instead: the whole build, into the palette's
+// pool of drafts — no version spent, the site unchanged; any page of the site opened with
+// `?previewOverride=<brand>:<draft>` shows its blocks.
 
 /** where the build comes from, as git says — the platform keeps it with the release */
 export function provenanceOf(root) {
@@ -48,6 +52,7 @@ function failureOf(res, body, doing) {
 export async function push(root, {
   target = 'default',
   dryRun = false,
+  draft = false,
   fetchImpl = fetch,
   env = process.env,
   dir,
@@ -63,6 +68,7 @@ export async function push(root, {
   // a palette's target has a slash of its own (`palettes/<brand>`): each part encoded, the slash kept
   const base = `${new URL(where.api).origin}/v1/code/${where.target.split('/').map(encodeURIComponent).join('/')}`;
   const authorization = `Bearer ${held.token}`;
+  if (draft) return pushDraft(build, manifest, { base, authorization, where, dryRun, fetchImpl, log });
 
   const planned = await fetchImpl(`${base}/plan`, {
     method: 'POST',
@@ -97,3 +103,30 @@ export async function push(root, {
   log(`released ${release.fresh.join(', ') || 'nothing new'} into "${where.target}" (${release.uploaded.public} public, ${release.uploaded.private} private file(s)); trace ${release.id}`);
   return release;
 }
+
+/** the whole build into the palette's pool of drafts */
+async function pushDraft(build, manifest, { base, authorization, where, dryRun, fetchImpl, log }) {
+  const brand = /^palettes\/([a-z0-9][a-z0-9-]*)$/.exec(where.target)?.[1];
+  if (!brand) throw new Error(`push: a draft goes into a tile palette — "${where.target}" is none (its target is palettes/<brand>)`);
+  const files = [...manifest.files.public.map((f) => ['public', f.key]), ...manifest.files.private.map((f) => ['private', f.key])];
+  log(`draft of ${brand} at ${where.api}: ${files.length} file(s) to send`);
+  if (dryRun) return { dryRun: true, draft: true, files: files.length };
+  const entries = [{ name: 'release.json', data: new TextEncoder().encode(JSON.stringify(manifest)) }];
+  for (const [side, key] of files) {
+    const data = await build.read(side, key);
+    if (data === null) throw new Error(`push: ${side} ${key} is in the manifest but not in the build`);
+    entries.push({ name: `${side}/${key}`, data });
+  }
+  const pushed = await fetchImpl(`${base}/draft`, {
+    method: 'POST',
+    headers: { authorization, 'content-type': 'application/x-tar' },
+    body: writeTar(entries),
+  });
+  const answer = await answerOf(pushed);
+  if (!pushed.ok || !answer.ok) throw failureOf(pushed, answer, 'pushing the draft');
+  const { draft } = answer;
+  log(`draft #${draft.n} of ${brand} at ${draft.version}: ${draft.blocks.join(', ') || 'no blocks'}`
+    + `${answer.evicted?.length ? ` (draft${answer.evicted.length > 1 ? 's' : ''} #${answer.evicted.join(', #')} gone from the pool)` : ''}`);
+  log(`look at any page of the site with ?previewOverride=${brand}:${draft.n} — or one block: ?previewOverride=${brand}.<block>:${draft.n}`);
+  return { draft: draft.n, version: draft.version, blocks: draft.blocks, override: `${brand}:${draft.n}` };
+}