@txco/web-abi 0.2.0 → 0.2.1

package/dist/producer.d.ts

@@ -1,8 +1,16 @@
 /** Where the catch-all sits: after the navigation op, since ops in one scope run concurrently. */
 export declare const catchAllScope: (scope: number) => number;
+/** An HTTP GET or HEAD: what a navigation is made of. */
+export declare const METHOD_GUARD = "@src == \"http\" && (@web.req.method == \"GET\" || @web.req.method == \"HEAD\")";
 /**
  * A navigation: an HTTP GET or HEAD of a path whose last segment has no
  * extension. Everything else (an asset miss, a POST) is the catch-all's.
+ *
+ * A producer with a route table ("routes" mode) trusts the table instead for
+ * its 200: a path a page route knows is a page whatever dots it carries (a
+ * param may hold one — /p/mister.parade), so that op opens with METHOD_GUARD
+ * alone; its 404 op and every producer without a table keep this guard, so
+ * an asset miss is still the catch-all's plain 404.
  */
 export declare const NAV_GUARD: string;
 /** The page a 404 op serves when the build has no 404.html. */

package/dist/producer.js

@@ -8,12 +8,19 @@ import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { MANIFEST_NAME, PRODUCER_SCOPE, validateManifest } from "./manifest.js";
 /** Where the catch-all sits: after the navigation op, since ops in one scope run concurrently. */
 export const catchAllScope = (scope) => scope + 900;
+/** An HTTP GET or HEAD: what a navigation is made of. */
+export const METHOD_GUARD = '@src == "http" && (@web.req.method == "GET" || @web.req.method == "HEAD")';
 /**
  * A navigation: an HTTP GET or HEAD of a path whose last segment has no
  * extension. Everything else (an asset miss, a POST) is the catch-all's.
+ *
+ * A producer with a route table ("routes" mode) trusts the table instead for
+ * its 200: a path a page route knows is a page whatever dots it carries (a
+ * param may hold one — /p/mister.parade), so that op opens with METHOD_GUARD
+ * alone; its 404 op and every producer without a table keep this guard, so
+ * an asset miss is still the catch-all's plain 404.
  */
-export const NAV_GUARD = '@src == "http" && (@web.req.method == "GET" || @web.req.method == "HEAD")\n' +
-    "     && @web.req.url.path !~ /(?i)\\.[a-z0-9]+$/";
+export const NAV_GUARD = METHOD_GUARD + "\n" + "     && @web.req.url.path !~ /(?i)\\.[a-z0-9]+$/";
 /** The page a 404 op serves when the build has no 404.html. */
 export const BUILTIN_404 = '<!doctype html>\n<html lang="en"><head><meta charset="utf-8"><title>404 Not Found</title></head>' +
     "<body><h1>404 Not Found</h1></body></html>\n";
@@ -36,8 +43,11 @@ export function renderOps(o) {
 #
 # Serves the app shell (${o.page.name}) with 200 for a navigation to a known
 # page route that no file or earlier op answered. Paired with spa-404.txcl.
+# The route table decides what a page is: a path it knows is one whatever
+# dots it carries (a param may hold one), so this op has no extension guard;
+# spa-404 and the catch-all keep it, and an asset miss is still a plain 404.
 ${extra}# Regenerated on every build — the shell embeds content-hashed asset URLs.
-WHEN ${NAV_GUARD}
+WHEN ${METHOD_GUARD}
      && @web.req.url.path =~ /${o.routes}/
 ${emitPage(200, o.page.html)}`;
         out[`${scope}/spa-404.txcl`] = `# ${o.producer} — SPA 404 (generated; do not edit by hand).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@txco/web-abi",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The TxCo Web ABI kit: the txco-web.json schema and validator, the envelope ↔ Fetch bridge every runner uses, a harness that checks a build's server/ Fetch handler, and the ops and manifest writer producers share.",
   "license": "MIT",
   "type": "module",

package/src/producer.ts

@@ -11,13 +11,20 @@ import { MANIFEST_NAME, PRODUCER_SCOPE, validateManifest } from "./manifest.js";
 /** Where the catch-all sits: after the navigation op, since ops in one scope run concurrently. */
 export const catchAllScope = (scope: number): number => scope + 900;
 
+/** An HTTP GET or HEAD: what a navigation is made of. */
+export const METHOD_GUARD = '@src == "http" && (@web.req.method == "GET" || @web.req.method == "HEAD")';
+
 /**
  * A navigation: an HTTP GET or HEAD of a path whose last segment has no
  * extension. Everything else (an asset miss, a POST) is the catch-all's.
+ *
+ * A producer with a route table ("routes" mode) trusts the table instead for
+ * its 200: a path a page route knows is a page whatever dots it carries (a
+ * param may hold one — /p/mister.parade), so that op opens with METHOD_GUARD
+ * alone; its 404 op and every producer without a table keep this guard, so
+ * an asset miss is still the catch-all's plain 404.
  */
-export const NAV_GUARD =
-  '@src == "http" && (@web.req.method == "GET" || @web.req.method == "HEAD")\n' +
-  "     && @web.req.url.path !~ /(?i)\\.[a-z0-9]+$/";
+export const NAV_GUARD = METHOD_GUARD + "\n" + "     && @web.req.url.path !~ /(?i)\\.[a-z0-9]+$/";
 
 /** The page a 404 op serves when the build has no 404.html. */
 export const BUILTIN_404 =
@@ -80,8 +87,11 @@ export function renderOps(o: RenderOptions): Record<string, string> {
 #
 # Serves the app shell (${o.page.name}) with 200 for a navigation to a known
 # page route that no file or earlier op answered. Paired with spa-404.txcl.
+# The route table decides what a page is: a path it knows is one whatever
+# dots it carries (a param may hold one), so this op has no extension guard;
+# spa-404 and the catch-all keep it, and an asset miss is still a plain 404.
 ${extra}# Regenerated on every build — the shell embeds content-hashed asset URLs.
-WHEN ${NAV_GUARD}
+WHEN ${METHOD_GUARD}
      && @web.req.url.path =~ /${o.routes}/
 ${emitPage(200, o.page.html)}`;
     out[`${scope}/spa-404.txcl`] = `# ${o.producer} — SPA 404 (generated; do not edit by hand).