@webstir-io/module-contract 0.9.0 → 0.9.1

package/dist/client-nav.d.ts

@@ -20,3 +20,14 @@ export declare const CLIENT_NAV_HEADERS: {
  * client-nav when it falls back to a normal post.
  */
 export declare const CLIENT_NAV_SUBMISSION_FIELD = "_webstir_submission";
+/**
+ * The form field carrying the address of the page a form was rendered on, so a failed submission
+ * goes back to that page even when the browser sends no Referer, or one that names the address of
+ * an earlier failed post.
+ */
+export declare const FORM_PAGE_FIELD = "_webstir_page";
+/**
+ * The form field an app writes into a form that is one of many on a page (one per item), naming
+ * the state its failures go to: `<input type="hidden" name="_webstir_form" value="reply:42">`.
+ */
+export declare const FORM_ID_FIELD = "_webstir_form";

package/dist/client-nav.js

@@ -20,3 +20,14 @@ export const CLIENT_NAV_HEADERS = {
  * client-nav when it falls back to a normal post.
  */
 export const CLIENT_NAV_SUBMISSION_FIELD = '_webstir_submission';
+/**
+ * The form field carrying the address of the page a form was rendered on, so a failed submission
+ * goes back to that page even when the browser sends no Referer, or one that names the address of
+ * an earlier failed post.
+ */
+export const FORM_PAGE_FIELD = '_webstir_page';
+/**
+ * The form field an app writes into a form that is one of many on a page (one per item), naming
+ * the state its failures go to: `<input type="hidden" name="_webstir_form" value="reply:42">`.
+ */
+export const FORM_ID_FIELD = '_webstir_form';

package/dist/index.d.ts

@@ -4683,4 +4683,4 @@ export { RENDER_PROGRAM_FILE, RENDER_PROGRAM_VERSION, renderFlashMessageSchema,
 export type { RenderFlashMessage, RenderNode, RenderPath, RenderProgram, RenderSourceLocation, } from './render-program.js';
 export { executeRenderProgram, programUsesCsrf, readRenderProgram, RENDER_CSRF_FIELD, RenderProgramError, prepareViewData, schemaDeclaresField, withShellData, } from './render-execute.js';
 export type { ExecuteRenderProgramOptions, PreparedViewData } from './render-execute.js';
-export { CLIENT_NAV_HEADERS, CLIENT_NAV_SUBMISSION_FIELD } from './client-nav.js';
+export { CLIENT_NAV_HEADERS, CLIENT_NAV_SUBMISSION_FIELD, FORM_ID_FIELD, FORM_PAGE_FIELD, } from './client-nav.js';

package/dist/index.js

@@ -279,4 +279,4 @@ export function createModule(definition) {
 export { fromTsRestRoute, fromTsRestRouter } from './adapters/ts-rest.js';
 export { RENDER_PROGRAM_FILE, RENDER_PROGRAM_VERSION, renderFlashMessageSchema, renderFlashSchema, renderNodeSchema, renderPathSchema, renderProgramSchema, renderSourceLocationSchema, } from './render-program.js';
 export { executeRenderProgram, programUsesCsrf, readRenderProgram, RENDER_CSRF_FIELD, RenderProgramError, prepareViewData, schemaDeclaresField, withShellData, } from './render-execute.js';
-export { CLIENT_NAV_HEADERS, CLIENT_NAV_SUBMISSION_FIELD } from './client-nav.js';
+export { CLIENT_NAV_HEADERS, CLIENT_NAV_SUBMISSION_FIELD, FORM_ID_FIELD, FORM_PAGE_FIELD, } from './client-nav.js';

package/dist/render-execute.d.ts

@@ -15,6 +15,8 @@ export interface ExecuteRenderProgramOptions {
      * double click) is answered once. Left out, forms render without one.
      */
     readonly submissionId?: () => string;
+    /** The page's own address, rendered into each POST form so a failure returns to it. */
+    readonly pagePath?: string;
 }
 export declare function readRenderProgram(value: unknown, source: string): RenderProgram;
 export declare function programUsesCsrf(program: RenderProgram): boolean;

package/dist/render-execute.js

@@ -1,4 +1,4 @@
-import { CLIENT_NAV_SUBMISSION_FIELD } from './client-nav.js';
+import { CLIENT_NAV_SUBMISSION_FIELD, FORM_PAGE_FIELD } from './client-nav.js';
 import { RENDER_PROGRAM_VERSION } from './render-version.js';
 export const RENDER_CSRF_FIELD = '_csrf';
 const SAFE_URL_SCHEMES = new Set(['http', 'https', 'mailto', 'tel']);
@@ -67,6 +67,9 @@ function run(nodes, data, scopes, options, out) {
                 if (options.submissionId) {
                     out.push(`<input type="hidden" name="${CLIENT_NAV_SUBMISSION_FIELD}" value="${escapeAttribute(options.submissionId())}">`);
                 }
+                if (options.pagePath) {
+                    out.push(`<input type="hidden" name="${FORM_PAGE_FIELD}" value="${escapeAttribute(options.pagePath)}">`);
+                }
                 break;
             case 'text': {
                 const value = read(node.path, data, scopes);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webstir-io/module-contract",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Public contract definitions for Webstir frontend and backend module providers.",
   "type": "module",
   "main": "dist/index.js",