@pwfabric/cli 0.0.0-stage → 1.0.0-rc.0

package/dist/dev/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/dev/media.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAuD,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACrG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAG1D,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACvC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAChD,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;CACzC;AAuBD,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,GAAG,cAAc,CAwClG;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CA4BxH"}

package/dist/dev/media.js

@@ -0,0 +1,128 @@
+/**
+ * Media: the app's declared images and files, copied into the pwapp.
+ *
+ * pwpack-format §1.3: `app/media/<key>.json` declares one image or file
+ * (`{ purpose, kind, origin, slots, status, url?, decorative?, file? }`) and
+ * carries no bytes; the bytes are `media/<file>`, each recorded in
+ * `media/provenance.json`. The pack library's `mediaDeclarations` reads
+ * that layout (its findings reach the diagnostics through `validatePack`).
+ * pwapp-format §1 puts the bytes the app serves at `pwpack/media/<file>`,
+ * and §4 records each declaration's resolved address in `publish.json`
+ * `media[]`.
+ *
+ * For each declaration the bytes are looked up, in order:
+ *
+ *   1. the declaration's `file` (a pack path, `media/<name>`);
+ *   2. `media/<path>` — a `url` that is itself a `media/…` path;
+ *   3. `media/<key>.<ext>` — the one media file named after the key.
+ *
+ * Found bytes are served at `pwpack/media/…` and the declaration resolves to
+ * that address. A declaration without bytes but with an absolute `url` keeps
+ * the url. Every other one is reported (info) and left alone.
+ *
+ * Slots: a declared slot (`{ surfaceKey, blockId, prop }`) whose prop is
+ * empty in the served receipt gets the resolved address. A value already in
+ * the prop is never replaced (plan.md §2 rule 1). The app's own files are
+ * never rewritten; only the served copy of the receipt is.
+ */
+import { MEDIA_DIR, MEDIA_PROVENANCE_FILE, mediaDeclarations } from '@pwfabric/pack';
+import { isRecord } from './sources.js';
+const ABSOLUTE_URL = /^(?:https?:|data:)/i;
+/** A single path segment that is safe to serve: no separators, no dot names. */
+function isSafeName(name) {
+    return name.length > 0 && !/[\\/\0]/.test(name) && name !== '.' && name !== '..';
+}
+/** A relative `media/…` path with no `.`/`..` segment. */
+function isSafeMediaPath(path) {
+    return path.startsWith(MEDIA_DIR) && path.slice(MEDIA_DIR.length).split('/').every(isSafeName);
+}
+/** The media file named after a key (`media/<key>.<ext>`), when exactly one exists. */
+function byKey(mediaPaths, key) {
+    const hits = mediaPaths.filter((p) => {
+        const name = p.slice(MEDIA_DIR.length);
+        return !name.includes('/') && name.slice(0, name.lastIndexOf('.') > 0 ? name.lastIndexOf('.') : undefined) === key;
+    });
+    return hits.length === 1 ? hits[0] : undefined;
+}
+/** Reads the app's media declarations and bytes. */
+export function collectMedia(folder, diagnostics) {
+    const files = new Map();
+    const records = [];
+    const slots = new Map();
+    const mediaPaths = [...folder.files.keys()].filter((p) => p !== MEDIA_PROVENANCE_FILE && isSafeMediaPath(p)).sort();
+    for (const path of mediaPaths)
+        files.set(path, folder.files.get(path));
+    for (const { key, path, declaration, filePath } of mediaDeclarations(folder).declarations) {
+        const declaredUrl = declaration.url?.trim() ?? '';
+        const urlPath = declaredUrl.replace(/^\.\//, '');
+        let url;
+        const inMedia = (filePath !== undefined && files.has(filePath) ? filePath : undefined) ??
+            (isSafeMediaPath(urlPath) && files.has(urlPath) ? urlPath : undefined) ??
+            byKey(mediaPaths, key);
+        if (inMedia) {
+            url = `pwpack/${inMedia}`;
+        }
+        else if (ABSOLUTE_URL.test(declaredUrl)) {
+            url = declaredUrl;
+        }
+        if (url === undefined) {
+            diagnostics.push({
+                severity: 'info',
+                code: 'MEDIA_UNRESOLVED',
+                message: `media "${key}" has no bytes in media/ and no absolute url; its slots keep what the receipts say`,
+                path,
+            });
+            continue;
+        }
+        records.push({ key, url });
+        const served = ABSOLUTE_URL.test(url) ? url : `./${url}`;
+        for (const { surfaceKey, blockId, prop } of declaration.slots ?? []) {
+            const list = slots.get(surfaceKey) ?? [];
+            list.push({ blockId, prop, url: served });
+            slots.set(surfaceKey, list);
+        }
+    }
+    return { files, records, slots };
+}
+const isEmpty = (v) => v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+/**
+ * The served receipt with its empty media slots filled, or `undefined` when
+ * nothing changed (the bytes are then served exactly as written).
+ */
+export function fillMediaSlots(receiptBytes, slots) {
+    if (!slots || slots.length === 0)
+        return undefined;
+    let receipt;
+    try {
+        receipt = JSON.parse(new TextDecoder().decode(receiptBytes));
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(receipt))
+        return undefined;
+    const copy = structuredClone(receipt);
+    let changed = false;
+    const walk = (node) => {
+        if (Array.isArray(node)) {
+            node.forEach(walk);
+            return;
+        }
+        if (!isRecord(node))
+            return;
+        for (const slot of slots) {
+            if (node['id'] !== slot.blockId)
+                continue;
+            const props = isRecord(node['props']) ? node['props'] : {};
+            if (!isEmpty(props[slot.prop]))
+                continue;
+            node['props'] = { ...props, [slot.prop]: slot.url };
+            changed = true;
+        }
+        if (Array.isArray(node['children']))
+            node['children'].forEach(walk);
+    };
+    walk(copy['blocks']);
+    return changed ? new TextEncoder().encode(JSON.stringify(copy)) : undefined;
+}
+//# sourceMappingURL=media.js.map

package/dist/dev/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/dev/media.ts"],"names":[],"mappings":"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"}

package/dist/dev/needs-host.d.ts

@@ -0,0 +1,3 @@
+/** What the app declares that only a host can serve. Empty when it needs none. */
+export declare function hostNeeds(root: string): Promise<string[]>;
+//# sourceMappingURL=needs-host.d.ts.map

package/dist/dev/needs-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"needs-host.d.ts","sourceRoot":"","sources":["../../src/dev/needs-host.ts"],"names":[],"mappings":"AAgBA,kFAAkF;AAClF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB/D"}

package/dist/dev/needs-host.js

@@ -0,0 +1,32 @@
+/**
+ * Whether an app needs a local host: it declares sign-in
+ * (`app/definitions/auth.json`) or records (`app/definitions/entities.json`).
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isRecord } from './sources.js';
+async function readJson(path) {
+    try {
+        return JSON.parse((await readFile(path, 'utf8')).replace(/^\uFEFF/, ''));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** What the app declares that only a host can serve. Empty when it needs none. */
+export async function hostNeeds(root) {
+    const needs = [];
+    const auth = await readJson(join(root, 'app', 'definitions', 'auth.json'));
+    if (isRecord(auth) &&
+        (auth['required'] === true ||
+            auth['topology'] === 'external' ||
+            (Array.isArray(auth['methods']) && auth['methods'].length > 0))) {
+        needs.push('sign-in');
+    }
+    const entities = await readJson(join(root, 'app', 'definitions', 'entities.json'));
+    if (isRecord(entities) && Array.isArray(entities['entities']) && entities['entities'].length > 0) {
+        needs.push('records');
+    }
+    return needs;
+}
+//# sourceMappingURL=needs-host.js.map

package/dist/dev/needs-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"needs-host.js","sourceRoot":"","sources":["../../src/dev/needs-host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAY,CAAA;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAA;IAC1E,IACE,QAAQ,CAAC,IAAI,CAAC;QACd,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI;YACxB,IAAI,CAAC,UAAU,CAAC,KAAK,UAAU;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EACjE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACvB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAA;IAClF,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACvB,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/dev/output.d.ts

@@ -0,0 +1,10 @@
+/** Thrown when the output folder holds something that is not a previous build. */
+export declare class OutputFolderError extends Error {
+}
+/**
+ * Writes `files` into `outDir`, replacing a previous build there. A folder
+ * that exists, is not empty and holds no `publish.json` is not a build this
+ * command wrote, and is left alone.
+ */
+export declare function writePwapp(files: ReadonlyMap<string, Uint8Array>, outDir: string): Promise<void>;
+//# sourceMappingURL=output.d.ts.map

package/dist/dev/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/dev/output.ts"],"names":[],"mappings":"AAMA,kFAAkF;AAClF,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBtG"}

package/dist/dev/output.js

@@ -0,0 +1,32 @@
+/**
+ * Writing an assembled pwapp to disk.
+ */
+import { mkdir, readdir, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+/** Thrown when the output folder holds something that is not a previous build. */
+export class OutputFolderError extends Error {
+}
+/**
+ * Writes `files` into `outDir`, replacing a previous build there. A folder
+ * that exists, is not empty and holds no `publish.json` is not a build this
+ * command wrote, and is left alone.
+ */
+export async function writePwapp(files, outDir) {
+    const st = await stat(outDir).catch(() => null);
+    if (st) {
+        if (!st.isDirectory())
+            throw new OutputFolderError(`${outDir} exists and is not a folder`);
+        const entries = await readdir(outDir);
+        if (entries.length > 0 && !entries.includes('publish.json')) {
+            throw new OutputFolderError(`${outDir} is not empty and holds no previous build (no publish.json); choose another --out`);
+        }
+        await rm(outDir, { recursive: true, force: true });
+    }
+    await mkdir(outDir, { recursive: true });
+    for (const [path, bytes] of files) {
+        const target = join(outDir, ...path.split('/'));
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, bytes);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/dev/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/dev/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,kFAAkF;AAClF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAE/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsC,EAAE,MAAc;IACrF,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,EAAE,EAAE,CAAC;QACP,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE;YAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,MAAM,6BAA6B,CAAC,CAAA;QAC1F,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;QACrC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,iBAAiB,CAAC,GAAG,MAAM,mFAAmF,CAAC,CAAA;QAC3H,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACpD,CAAC;IACD,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/C,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAChC,CAAC;AACH,CAAC"}

package/dist/dev/overlay.d.ts

@@ -0,0 +1,22 @@
+/**
+ * What `pwf dev` adds to a page: the reload client, and the overlay shown
+ * instead of the app when the last build failed.
+ */
+import type { AssembleDiagnostic } from './diagnostics.js';
+/** Server-Sent Events endpoint the page listens on. */
+export declare const EVENTS_PATH = "/_pwf/events";
+/** The current build's status as JSON. */
+export declare const STATUS_PATH = "/_pwf/status";
+/** Where the dev server serves the reload client's script. */
+export declare const RELOAD_PATH = "/_pwf/reload.js";
+/** The reload client's script: reloads the page when the server announces a new build. */
+export declare const RELOAD_JS = "(function () {\n  if (typeof EventSource === 'undefined') return\n  var es = new EventSource('/_pwf/events')\n  es.addEventListener('reload', function () { location.reload() })\n})()\n";
+/**
+ * The reload client, as markup for a page. A script file on the dev server's
+ * own origin, not an inline script, so the app's Content Security Policy
+ * covers it with 'self' (and its event stream with connect-src 'self').
+ */
+export declare const RELOAD_CLIENT = "\n    <script src=\"/_pwf/reload.js\"></script>";
+/** The page shown while the last build has errors. */
+export declare function overlayHtml(diagnostics: readonly AssembleDiagnostic[], title?: string): string;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/dev/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/dev/overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAG1D,uDAAuD;AACvD,eAAO,MAAM,WAAW,iBAAiB,CAAA;AACzC,0CAA0C;AAC1C,eAAO,MAAM,WAAW,iBAAiB,CAAA;AAEzC,8DAA8D;AAC9D,eAAO,MAAM,WAAW,oBAAoB,CAAA;AAE5C,0FAA0F;AAC1F,eAAO,MAAM,SAAS,6LAKrB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,oDACiB,CAAA;AAE3C,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAAE,KAAK,SAAiB,GAAG,MAAM,CAqCtG"}

package/dist/dev/overlay.js

@@ -0,0 +1,59 @@
+import { escapeHtml } from './shell.js';
+/** Server-Sent Events endpoint the page listens on. */
+export const EVENTS_PATH = '/_pwf/events';
+/** The current build's status as JSON. */
+export const STATUS_PATH = '/_pwf/status';
+/** Where the dev server serves the reload client's script. */
+export const RELOAD_PATH = '/_pwf/reload.js';
+/** The reload client's script: reloads the page when the server announces a new build. */
+export const RELOAD_JS = `(function () {
+  if (typeof EventSource === 'undefined') return
+  var es = new EventSource('${EVENTS_PATH}')
+  es.addEventListener('reload', function () { location.reload() })
+})()
+`;
+/**
+ * The reload client, as markup for a page. A script file on the dev server's
+ * own origin, not an inline script, so the app's Content Security Policy
+ * covers it with 'self' (and its event stream with connect-src 'self').
+ */
+export const RELOAD_CLIENT = `
+    <script src="${RELOAD_PATH}"></script>`;
+/** The page shown while the last build has errors. */
+export function overlayHtml(diagnostics, title = 'Build failed') {
+    const errors = diagnostics.filter((d) => d.severity === 'error');
+    const rest = diagnostics.length - errors.length;
+    const items = errors
+        .map((d) => `<li><code>${escapeHtml(d.code)}</code>${d.path ? ` <span class="path">${escapeHtml(d.path)}${d.line !== undefined ? `:${d.line}` : ''}</span>` : ''}<pre>${escapeHtml(d.message)}</pre></li>`)
+        .join('\n');
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(title)} — pwf dev</title>
+    <style>
+      body { margin: 0; font: 14px/1.5 ui-sans-serif, system-ui, sans-serif; background: #1c1917; color: #fafaf9; }
+      main { max-width: 960px; margin: 0 auto; padding: 32px 16px; }
+      h1 { font-size: 20px; color: #fca5a5; margin: 0 0 4px; }
+      p { color: #d6d3d1; margin: 0 0 24px; }
+      ul { list-style: none; padding: 0; margin: 0; }
+      li { border-left: 3px solid #f87171; background: #292524; padding: 12px 16px; margin: 0 0 12px; border-radius: 4px; }
+      code { color: #fca5a5; font-weight: 600; }
+      .path { color: #a8a29e; margin-left: 8px; }
+      pre { white-space: pre-wrap; word-break: break-word; margin: 8px 0 0; font: 13px/1.5 ui-monospace, Menlo, Consolas, monospace; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>${escapeHtml(title)}</h1>
+      <p>${errors.length} error${errors.length === 1 ? '' : 's'}${rest > 0 ? `, ${rest} other finding${rest === 1 ? '' : 's'} in the terminal` : ''}. Fix the files and the page reloads.</p>
+      <ul>
+${items}
+      </ul>
+    </main>${RELOAD_CLIENT}
+  </body>
+</html>
+`;
+}
+//# sourceMappingURL=overlay.js.map

package/dist/dev/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../src/dev/overlay.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAA;AACzC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAA;AAEzC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE5C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,SAAS,GAAG;;8BAEK,WAAW;;;CAGxC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;mBACV,WAAW,aAAa,CAAA;AAE3C,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,WAA0C,EAAE,KAAK,GAAG,cAAc;IAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;IAChE,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC/C,MAAM,KAAK,GAAG,MAAM;SACjB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CACtM;SACA,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO;;;;;aAKI,UAAU,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;YAelB,UAAU,CAAC,KAAK,CAAC;WAClB,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE;;EAEjJ,KAAK;;aAEM,aAAa;;;CAGzB,CAAA;AACD,CAAC"}

package/dist/dev/server.d.ts

@@ -0,0 +1,28 @@
+import type { CreateLocalHost } from '../host/types.js';
+import { type AssembleOptions } from './assemble.js';
+import { type AssembleDiagnostic } from './diagnostics.js';
+import type { DevServer, DevServerOptions, StartDevServer } from './types.js';
+import { type WatchOptions } from './watcher.js';
+export declare const DEFAULT_PORT = 4600;
+export declare const DEFAULT_HOSTNAME = "127.0.0.1";
+/** Where a host this server creates is mounted. */
+export declare const HOST_PREFIX = "/_host";
+/** Seams for the `dev` command and for tests; not part of the public contract. */
+export interface DevServerInternals {
+    /** Watching; `false` turns it off. */
+    readonly watch?: WatchOptions | false;
+    /** Makes a host when the app needs one and none was passed. */
+    readonly createHost?: CreateLocalHost;
+    /** Assembly options (runtime bundles, cache folder). */
+    readonly assemble?: Pick<AssembleOptions, 'runtime' | 'cacheDir' | 'publishedAt'>;
+}
+export declare function contentTypeOf(path: string): string;
+/** The address a browser should open for a bound interface. */
+export declare function urlFor(hostname: string, port: number): string;
+/** Lines for the terminal: everything that is the app's own, and a count of what pinned packs say. */
+export declare function logLines(diagnostics: readonly AssembleDiagnostic[]): string[];
+/** Starts the dev server with the internal seams. {@link startDevServer} is the public entry. */
+export declare function createDevServer(options: DevServerOptions, internals?: DevServerInternals): Promise<DevServer>;
+/** Implements the `pwf dev` contract (see ./types.ts). */
+export declare const startDevServer: StartDevServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/dev/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dev/server.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAiB,KAAK,eAAe,EAAuB,MAAM,eAAe,CAAA;AAExF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAI5E,OAAO,KAAK,EAAkB,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC7F,OAAO,EAAe,KAAK,YAAY,EAAgB,MAAM,cAAc,CAAA;AAE3E,eAAO,MAAM,YAAY,OAAO,CAAA;AAChC,eAAO,MAAM,gBAAgB,cAAc,CAAA;AAC3C,mDAAmD;AACnD,eAAO,MAAM,WAAW,WAAW,CAAA;AAEnC,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,KAAK,CAAA;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;IACrC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC,CAAA;CAClF;AAqBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAWD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7D;AAWD,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,EAAE,CAa7E;AAED,iGAAiG;AACjG,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CA6LvH;AAED,0DAA0D;AAC1D,eAAO,MAAM,cAAc,EAAE,cAAsD,CAAA"}

package/dist/dev/server.js

@@ -0,0 +1,264 @@
+/**
+ * `pwf dev`: serves an app folder as a pwapp and keeps it current.
+ *
+ * One `node:http` server on 127.0.0.1 (port 4600 by default). It assembles
+ * the app into memory (see ./assemble.ts), serves the files from there,
+ * watches the folder, reassembles on change and tells the open page to reload
+ * through Server-Sent Events. While the last build has errors the page is an
+ * overlay listing them; the terminal gets the same list.
+ *
+ * When the app declares sign-in or records it needs a local host. A host
+ * passed in `localHost` is mounted on the same server: requests it claims go
+ * to `host.handle()`, and the envelope carries `host.envelopeEntries()`.
+ * This module never constructs a host itself (it depends on the host's
+ * interface only); a caller that can make one passes `createHost`.
+ */
+import { createServer } from 'node:http';
+import { extname, join, resolve } from 'node:path';
+import { assemblePwapp } from './assemble.js';
+import { createCompileCache } from './compile.js';
+import { formatDiagnostic } from './diagnostics.js';
+import { hostNeeds } from './needs-host.js';
+import { EVENTS_PATH, overlayHtml, RELOAD_CLIENT, RELOAD_JS, RELOAD_PATH, STATUS_PATH } from './overlay.js';
+import { PWF_DIR } from './sources.js';
+import { watchFolder } from './watcher.js';
+export const DEFAULT_PORT = 4600;
+export const DEFAULT_HOSTNAME = '127.0.0.1';
+/** Where a host this server creates is mounted. */
+export const HOST_PREFIX = '/_host';
+const CONTENT_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.ico': 'image/x-icon',
+    '.woff2': 'font/woff2',
+    '.txt': 'text/plain; charset=utf-8',
+};
+export function contentTypeOf(path) {
+    return CONTENT_TYPES[extname(path).toLowerCase()] ?? 'application/octet-stream';
+}
+function isLocalHost(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        typeof value.handle === 'function' &&
+        typeof value.envelopeEntries === 'function');
+}
+/** The address a browser should open for a bound interface. */
+export function urlFor(hostname, port) {
+    const h = hostname === '0.0.0.0' || hostname === '::' || hostname === '' ? 'localhost' : hostname;
+    return `http://${h.includes(':') ? `[${h}]` : h}:${port}/`;
+}
+function send(res, status, type, body, head = false) {
+    res.writeHead(status, {
+        'content-type': type,
+        'cache-control': 'no-store',
+        'content-length': typeof body === 'string' ? Buffer.byteLength(body) : body.byteLength,
+    });
+    res.end(head ? undefined : body);
+}
+/** Lines for the terminal: everything that is the app's own, and a count of what pinned packs say. */
+export function logLines(diagnostics) {
+    const own = [];
+    let packWarnings = 0;
+    for (const d of diagnostics) {
+        if (d.severity !== 'error' && d.path?.startsWith(`${PWF_DIR}/`)) {
+            packWarnings++;
+            continue;
+        }
+        if (d.severity === 'info')
+            continue;
+        own.push(formatDiagnostic(d));
+    }
+    if (packWarnings > 0)
+        own.push(`${packWarnings} finding${packWarnings === 1 ? '' : 's'} in pinned packs (\`pwf build\` lists them)`);
+    return own;
+}
+/** Starts the dev server with the internal seams. {@link startDevServer} is the public entry. */
+export async function createDevServer(options, internals = {}) {
+    const root = resolve(options.root);
+    const log = options.log ?? (() => undefined);
+    const hostname = options.hostname ?? DEFAULT_HOSTNAME;
+    const cache = createCompileCache(internals.assemble?.cacheDir === undefined ? join(root, PWF_DIR, 'build-cache') : internals.assemble.cacheDir);
+    // ── the local host ───────────────────────────────────────────────
+    let host = null;
+    if (isLocalHost(options.localHost)) {
+        host = options.localHost;
+    }
+    else if (options.localHost !== false) {
+        const needs = await hostNeeds(root);
+        const wanted = options.localHost === true || needs.length > 0;
+        if (wanted && internals.createHost) {
+            host = internals.createHost({ root, prefix: HOST_PREFIX });
+        }
+        else if (wanted) {
+            log(`note: this app declares ${needs.join(' and ') || 'a host'}, but no local host is mounted — pages render, ${needs.includes('sign-in') ? 'sign-in cannot complete and ' : ''}data stays empty`);
+        }
+    }
+    // ── state ────────────────────────────────────────────────────────
+    let state = null;
+    const packMemo = new Map();
+    const clients = new Set();
+    let origin = '';
+    const broadcast = (event, data) => {
+        const frame = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+        for (const c of clients)
+            c.write(frame);
+    };
+    const build = async () => {
+        let result;
+        try {
+            result = await assemblePwapp(root, {
+                ...internals.assemble,
+                cache,
+                packMemo,
+                shellExtra: RELOAD_CLIENT,
+                ...(host ? { envelopeEntries: host.envelopeEntries(origin) } : {}),
+            });
+        }
+        catch (e) {
+            const diagnostics = [
+                { severity: 'error', code: 'INTERNAL', message: e instanceof Error ? (e.stack ?? e.message) : String(e) },
+            ];
+            result = {
+                ok: false,
+                files: state?.files ?? new Map(),
+                diagnostics,
+                stats: { pages: 0, blocks: 0, engines: 0, atoms: 0, compiled: 0, fromCache: 0, failed: 0 },
+                ms: 0,
+            };
+        }
+        state = result;
+        const { stats } = result;
+        log(`${result.ok ? 'built' : 'build failed'} in ${result.ms} ms — ${stats.pages} page${stats.pages === 1 ? '' : 's'}, ${stats.blocks} block type${stats.blocks === 1 ? '' : 's'}, ${stats.compiled}/${stats.atoms} atoms compiled (${stats.fromCache} from cache${stats.failed ? `, ${stats.failed} failed` : ''})`);
+        for (const line of logLines(result.diagnostics))
+            log(`  ${line}`);
+        broadcast('reload', { ok: result.ok });
+        return { ok: result.ok, compiled: stats.compiled, diagnostics: result.diagnostics.map(formatDiagnostic), ms: result.ms };
+    };
+    let chain = Promise.resolve();
+    const rebuild = () => {
+        const next = chain.then(build, build);
+        chain = next.catch(() => undefined);
+        return next;
+    };
+    // ── HTTP ─────────────────────────────────────────────────────────
+    const handle = async (req, res) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        if (url.pathname === EVENTS_PATH) {
+            res.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-store', connection: 'keep-alive' });
+            res.write(': connected\n\n');
+            clients.add(res);
+            req.on('close', () => clients.delete(res));
+            return;
+        }
+        if (url.pathname === RELOAD_PATH) {
+            send(res, 200, CONTENT_TYPES['.js'], RELOAD_JS, req.method === 'HEAD');
+            return;
+        }
+        if (url.pathname === STATUS_PATH) {
+            send(res, 200, CONTENT_TYPES['.json'], JSON.stringify({ ok: state?.ok ?? false, diagnostics: state?.diagnostics ?? [] }));
+            return;
+        }
+        if (host && (await host.handle(req, res)))
+            return;
+        if (req.method !== 'GET' && req.method !== 'HEAD') {
+            send(res, 405, CONTENT_TYPES['.txt'], 'method not allowed');
+            return;
+        }
+        const head = req.method === 'HEAD';
+        let path;
+        try {
+            path = decodeURIComponent(url.pathname);
+        }
+        catch {
+            send(res, 400, CONTENT_TYPES['.txt'], 'bad path', head);
+            return;
+        }
+        let rel = path.replace(/^\/+/, '');
+        if (rel === '' || rel.endsWith('/'))
+            rel += 'index.html';
+        if (rel.split('/').some((s) => s === '..' || s === '.') || rel.includes('\\') || rel.includes('\0')) {
+            send(res, 400, CONTENT_TYPES['.txt'], 'bad path', head);
+            return;
+        }
+        const current = state;
+        const isPage = rel === 'index.html' || extname(rel) === '';
+        if (isPage && current && !current.ok) {
+            send(res, 200, CONTENT_TYPES['.html'], overlayHtml(current.diagnostics), head);
+            return;
+        }
+        // `_headers` configures a static host; it is not part of the site.
+        const file = rel === '_headers'
+            ? undefined
+            : (current?.files.get(rel) ?? (extname(rel) === '' ? current?.files.get('index.html') : undefined));
+        if (!file) {
+            send(res, 404, CONTENT_TYPES['.txt'], `not found: /${rel}`, head);
+            return;
+        }
+        send(res, 200, contentTypeOf(isPage ? 'index.html' : rel), file, head);
+    };
+    const server = createServer((req, res) => {
+        handle(req, res).catch((e) => {
+            if (!res.headersSent)
+                send(res, 500, CONTENT_TYPES['.txt'], e instanceof Error ? e.message : String(e));
+            else
+                res.end();
+        });
+    });
+    await new Promise((ok, fail) => {
+        server.once('error', fail);
+        server.listen(options.port ?? DEFAULT_PORT, hostname, () => {
+            server.off('error', fail);
+            ok();
+        });
+    });
+    const port = server.address().port;
+    const url = urlFor(hostname, port);
+    origin = url.replace(/\/$/, '');
+    if (host) {
+        log(`local host mounted at ${origin}${HOST_PREFIX} — development only: records in memory, one user, any password`);
+    }
+    await rebuild();
+    let watcher = null;
+    if (internals.watch !== false) {
+        watcher = watchFolder(root, (paths) => {
+            // A pack build changed (or the platform could not say what did): read it again.
+            if (paths === null || paths.some((p) => p.startsWith(`${PWF_DIR}/packs`)))
+                packMemo.clear();
+            void rebuild();
+        }, internals.watch ?? {});
+        log(`watching ${root} (${watcher.mode === 'native' ? 'file events' : 'polling'})`);
+    }
+    let closed = null;
+    return {
+        url,
+        rebuild,
+        close() {
+            closed ??= (async () => {
+                watcher?.close();
+                for (const c of clients)
+                    c.end();
+                clients.clear();
+                await new Promise((ok) => {
+                    server.close(() => ok());
+                    server.closeAllConnections();
+                });
+                await chain;
+            })();
+            return closed;
+        },
+    };
+}
+/** Implements the `pwf dev` contract (see ./types.ts). */
+export const startDevServer = (options) => createDevServer(options);
+//# sourceMappingURL=server.js.map