@aglyn/aglyn 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/plugin-manager/repeat-rows.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { RepeatableDataset } from '../app-utils/expand-repeatables';
+/**
+ * WHERE A PUBLISHED PAGE'S REPEATED ROWS COME FROM (AGL-3080).
+ *
+ * Any element can repeat, and the platform decides what a repeat MEANS — the
+ * scope, the copies, the filter, the bound (`expand-repeatables.ts`). What it
+ * does not decide is where the rows live. That is the plugin's that keeps
+ * them, and the composition that renders a published page asks it here, with
+ * the keys the page's tree repeats over, and never reads a collection itself.
+ *
+ * `repeat-sources.ts` is the editor's side of the same line: a hook the
+ * besigner's canvas mounts to preview the rows. This is the server's side,
+ * read once per compose, and it is a different registry because its readers
+ * are different processes with different failure costs.
+ *
+ * ## Declared, then registered — and an absent reader is refused
+ *
+ * The reader is registered from the owning plugin's `serverDeclarations`
+ * entry, which every app runs at boot, so every process that composes a page
+ * has it before the first request. But a registry is only safe where an empty
+ * one cannot be mistaken for an answer, and here it can: a page whose repeat
+ * found no reader would render the template once where the author put a list,
+ * and nothing anywhere would be red. That is the AGL-3025 shape on the most
+ * public surface the product has.
+ *
+ * So the plugin that answers also DECLARES that it does, in
+ * `plugins.config.json` (`repeatSource`), and the generator compiles that into
+ * core. The two together tell the one case that is a real answer from the one
+ * that is a broken boot:
+ *
+ * - nothing declared — this deployment ships no plugin that keeps rows, and a
+ *   repeat renders its element once, as written, exactly as a key naming
+ *   nothing does;
+ * - declared and registered — the reader answers;
+ * - declared and NOT registered — the boot failed. The app's declarations
+ *   step is run again ({@link runPluginDeclarationsRepair}); if the reader is
+ *   still missing, {@link readRepeatRows} THROWS. A render that throws keeps
+ *   the page it last rendered in the cache and is loud in the logs, which is
+ *   the right way round for a page that would otherwise go out wrong.
+ *
+ * Per-key failures are the reader's to absorb, as they always were: a deleted
+ * or unreadable entry leaves its element rendering once and costs the page
+ * nothing else.
+ *
+ * Reached by path, never through a barrel: only the server composition asks.
+ */
+/** One composition's question: the keys a page's tree repeats over. */
+export interface RepeatRowsRequest {
+    /** The site being rendered. A reader answers only what that site may see. */
+    hostId: string;
+    /**
+     * The keys exactly as the nodes store them (`repeatKeys`), trimmed,
+     * sorted and without repeats.
+     */
+    keys: readonly string[];
+}
+/**
+ * The rows for a request, under every key the expansion looks them up by: the
+ * key as the node stores it, the entry's own id, and each entry a one-hop
+ * reference in the rows reads. A key with nothing to render is absent.
+ */
+export type RepeatRowsAnswer = Record<string, RepeatableDataset>;
+/** Answers one composition's request. Never rejects for a single bad key. */
+export type RepeatRowReader = (request: RepeatRowsRequest) => Promise<RepeatRowsAnswer>;
+/** The compiled declaration: which plugin answers, under which source id. */
+export interface RepeatSourceDeclaration {
+    pluginId: string;
+    /** The same id the plugin's editor source (`repeat-sources.ts`) uses. */
+    id: string;
+}
+/** The plugin declared to answer repeats, or `null` when none is. */
+export declare function declaredRepeatSource(): RepeatSourceDeclaration | null;
+interface RegisteredReader {
+    pluginId: string;
+    reader: RepeatRowReader;
+}
+/**
+ * Registers the reader for a source. Returns the unregister, which removes it
+ * only while it is still the one registered.
+ *
+ * The owner is the plugin whose register fn is running, or the `pluginId`
+ * passed for a boot declaration, where the loader's marker is not set. A
+ * registration with neither is refused, and so is one from a plugin other
+ * than the one the declaration names — two readers for one source would each
+ * answer for the other's rows. The same plugin registering again replaces its
+ * reader (a second surface, a repeated boot).
+ */
+export declare function registerRepeatRowReader(sourceId: string, reader: RepeatRowReader, options?: {
+    pluginId?: string;
+}): () => void;
+/** The reader registered for a source, with its owner, or `null`. */
+export declare function repeatRowReader(sourceId: string): RegisteredReader | null;
+/** Only for specs: forgets every registered reader. */
+export declare function resetRepeatRowReadersForTests(): void;
+/**
+ * The declared source's reader was not registered, even after the app's
+ * declarations step ran again. Thrown, never answered: see the module note.
+ */
+export declare class RepeatRowsUnavailableError extends Error {
+    readonly source: RepeatSourceDeclaration;
+    constructor(source: RepeatSourceDeclaration);
+}
+/**
+ * The rows a composition's repeats render. See the module note for what each
+ * of the three cases answers; with no keys it answers `{}` and asks nobody.
+ */
+export declare function readRepeatRows(request: RepeatRowsRequest): Promise<RepeatRowsAnswer>;
+export {};

package/src/lib/plugin-manager/repeat-rows.js

@@ -0,0 +1,108 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ var _globalScope_READERS_KEY;
+import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
+import { PLUGIN_REPEAT_SOURCE_DECLARED } from "./first-party-plugins.generated.js";
+import { runPluginDeclarationsRepair } from "./plugin-declarations-repair.js";
+/** The plugin declared to answer repeats, or `null` when none is. */ export function declaredRepeatSource() {
+    return PLUGIN_REPEAT_SOURCE_DECLARED;
+}
+/**
+ * One table per process, on `globalThis` (AGL-3412): the app registers from
+ * `instrumentation.ts`, which Next compiles apart from the routes that read,
+ * and a module-scoped map would be filled in one copy and read empty in the
+ * other — the exact failure this module exists to refuse.
+ */ const READERS_KEY = Symbol.for('@aglyn/aglyn:repeat-row-readers');
+const globalScope = globalThis;
+const readers = (_globalScope_READERS_KEY = globalScope[READERS_KEY]) != null ? _globalScope_READERS_KEY : globalScope[READERS_KEY] = new Map();
+/**
+ * Registers the reader for a source. Returns the unregister, which removes it
+ * only while it is still the one registered.
+ *
+ * The owner is the plugin whose register fn is running, or the `pluginId`
+ * passed for a boot declaration, where the loader's marker is not set. A
+ * registration with neither is refused, and so is one from a plugin other
+ * than the one the declaration names — two readers for one source would each
+ * answer for the other's rows. The same plugin registering again replaces its
+ * reader (a second surface, a repeated boot).
+ */ export function registerRepeatRowReader(sourceId, reader, options) {
+    var _ref, _getRegisteringPluginId;
+    const id = sourceId.trim();
+    const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId) != null ? _ref : '').trim();
+    if (!id) throw new Error('a repeat row reader needs a source id');
+    if (!pluginId) {
+        throw new Error(`repeat row reader "${id}" registered with no owner: pass { pluginId } ` + 'when registering outside a plugin register fn');
+    }
+    const declared = declaredRepeatSource();
+    if ((declared == null ? void 0 : declared.id) === id && declared.pluginId !== pluginId) {
+        throw new Error(`repeat source "${id}" is declared by "${declared.pluginId}"; ` + `refused a reader from "${pluginId}"`);
+    }
+    const held = readers.get(id);
+    if (held && held.pluginId !== pluginId) {
+        throw new Error(`repeat source "${id}" already has a reader from "${held.pluginId}"; ` + `refused "${pluginId}"`);
+    }
+    const entry = {
+        pluginId,
+        reader
+    };
+    readers.set(id, entry);
+    return ()=>{
+        if (readers.get(id) === entry) readers.delete(id);
+    };
+}
+/** The reader registered for a source, with its owner, or `null`. */ export function repeatRowReader(sourceId) {
+    var _readers_get;
+    return (_readers_get = readers.get(sourceId)) != null ? _readers_get : null;
+}
+/** Only for specs: forgets every registered reader. */ export function resetRepeatRowReadersForTests() {
+    readers.clear();
+}
+/**
+ * The declared source's reader was not registered, even after the app's
+ * declarations step ran again. Thrown, never answered: see the module note.
+ */ export class RepeatRowsUnavailableError extends Error {
+    constructor(source){
+        super(`repeat source "${source.id}" is declared by "${source.pluginId}" but ` + 'no reader is registered in this process — its server declarations ' + 'did not run. Refusing to render repeats as if they had no rows.'), this.source = source;
+        this.name = 'RepeatRowsUnavailableError';
+    }
+}
+/**
+ * The rows a composition's repeats render. See the module note for what each
+ * of the three cases answers; with no keys it answers `{}` and asks nobody.
+ */ export async function readRepeatRows(request) {
+    const keys = [
+        ...new Set(request.keys.map((key)=>key.trim()).filter(Boolean))
+    ].sort();
+    if (!keys.length) return {};
+    const declared = declaredRepeatSource();
+    if (!declared) return {};
+    let registered = readers.get(declared.id);
+    if (!registered) {
+        try {
+            await runPluginDeclarationsRepair();
+        } catch (error) {
+            console.error('[repeat-rows] the declarations repair failed', error);
+        }
+        registered = readers.get(declared.id);
+    }
+    if (!registered) throw new RepeatRowsUnavailableError(declared);
+    return registered.reader({
+        hostId: request.hostId,
+        keys
+    });
+}
+
+//# sourceMappingURL=repeat-rows.js.map

package/src/lib/plugin-manager/repeat-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/repeat-rows.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { RepeatableDataset } from '../app-utils/expand-repeatables'\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport { PLUGIN_REPEAT_SOURCE_DECLARED } from './first-party-plugins.generated'\nimport { runPluginDeclarationsRepair } from './plugin-declarations-repair'\n\n/**\n * WHERE A PUBLISHED PAGE'S REPEATED ROWS COME FROM (AGL-3080).\n *\n * Any element can repeat, and the platform decides what a repeat MEANS — the\n * scope, the copies, the filter, the bound (`expand-repeatables.ts`). What it\n * does not decide is where the rows live. That is the plugin's that keeps\n * them, and the composition that renders a published page asks it here, with\n * the keys the page's tree repeats over, and never reads a collection itself.\n *\n * `repeat-sources.ts` is the editor's side of the same line: a hook the\n * besigner's canvas mounts to preview the rows. This is the server's side,\n * read once per compose, and it is a different registry because its readers\n * are different processes with different failure costs.\n *\n * ## Declared, then registered — and an absent reader is refused\n *\n * The reader is registered from the owning plugin's `serverDeclarations`\n * entry, which every app runs at boot, so every process that composes a page\n * has it before the first request. But a registry is only safe where an empty\n * one cannot be mistaken for an answer, and here it can: a page whose repeat\n * found no reader would render the template once where the author put a list,\n * and nothing anywhere would be red. That is the AGL-3025 shape on the most\n * public surface the product has.\n *\n * So the plugin that answers also DECLARES that it does, in\n * `plugins.config.json` (`repeatSource`), and the generator compiles that into\n * core. The two together tell the one case that is a real answer from the one\n * that is a broken boot:\n *\n * - nothing declared — this deployment ships no plugin that keeps rows, and a\n *   repeat renders its element once, as written, exactly as a key naming\n *   nothing does;\n * - declared and registered — the reader answers;\n * - declared and NOT registered — the boot failed. The app's declarations\n *   step is run again ({@link runPluginDeclarationsRepair}); if the reader is\n *   still missing, {@link readRepeatRows} THROWS. A render that throws keeps\n *   the page it last rendered in the cache and is loud in the logs, which is\n *   the right way round for a page that would otherwise go out wrong.\n *\n * Per-key failures are the reader's to absorb, as they always were: a deleted\n * or unreadable entry leaves its element rendering once and costs the page\n * nothing else.\n *\n * Reached by path, never through a barrel: only the server composition asks.\n */\n\n/** One composition's question: the keys a page's tree repeats over. */\nexport interface RepeatRowsRequest {\n  /** The site being rendered. A reader answers only what that site may see. */\n  hostId: string\n  /**\n   * The keys exactly as the nodes store them (`repeatKeys`), trimmed,\n   * sorted and without repeats.\n   */\n  keys: readonly string[]\n}\n\n/**\n * The rows for a request, under every key the expansion looks them up by: the\n * key as the node stores it, the entry's own id, and each entry a one-hop\n * reference in the rows reads. A key with nothing to render is absent.\n */\nexport type RepeatRowsAnswer = Record<string, RepeatableDataset>\n\n/** Answers one composition's request. Never rejects for a single bad key. */\nexport type RepeatRowReader = (\n  request: RepeatRowsRequest,\n) => Promise<RepeatRowsAnswer>\n\n/** The compiled declaration: which plugin answers, under which source id. */\nexport interface RepeatSourceDeclaration {\n  pluginId: string\n  /** The same id the plugin's editor source (`repeat-sources.ts`) uses. */\n  id: string\n}\n\n/** The plugin declared to answer repeats, or `null` when none is. */\nexport function declaredRepeatSource(): RepeatSourceDeclaration | null {\n  return PLUGIN_REPEAT_SOURCE_DECLARED\n}\n\ninterface RegisteredReader {\n  pluginId: string\n  reader: RepeatRowReader\n}\n\n/**\n * One table per process, on `globalThis` (AGL-3412): the app registers from\n * `instrumentation.ts`, which Next compiles apart from the routes that read,\n * and a module-scoped map would be filled in one copy and read empty in the\n * other — the exact failure this module exists to refuse.\n */\nconst READERS_KEY = Symbol.for('@aglyn/aglyn:repeat-row-readers')\n\nconst globalScope = globalThis as typeof globalThis & {\n  [READERS_KEY]?: Map<string, RegisteredReader>\n}\n\nconst readers: Map<string, RegisteredReader> =\n  globalScope[READERS_KEY] ?? (globalScope[READERS_KEY] = new Map())\n\n/**\n * Registers the reader for a source. Returns the unregister, which removes it\n * only while it is still the one registered.\n *\n * The owner is the plugin whose register fn is running, or the `pluginId`\n * passed for a boot declaration, where the loader's marker is not set. A\n * registration with neither is refused, and so is one from a plugin other\n * than the one the declaration names — two readers for one source would each\n * answer for the other's rows. The same plugin registering again replaces its\n * reader (a second surface, a repeated boot).\n */\nexport function registerRepeatRowReader(\n  sourceId: string,\n  reader: RepeatRowReader,\n  options?: { pluginId?: string },\n): () => void {\n  const id = sourceId.trim()\n  const pluginId = (getRegisteringPluginId() ?? options?.pluginId ?? '').trim()\n  if (!id) throw new Error('a repeat row reader needs a source id')\n  if (!pluginId) {\n    throw new Error(\n      `repeat row reader \"${id}\" registered with no owner: pass { pluginId } ` +\n        'when registering outside a plugin register fn',\n    )\n  }\n  const declared = declaredRepeatSource()\n  if (declared?.id === id && declared.pluginId !== pluginId) {\n    throw new Error(\n      `repeat source \"${id}\" is declared by \"${declared.pluginId}\"; ` +\n        `refused a reader from \"${pluginId}\"`,\n    )\n  }\n  const held = readers.get(id)\n  if (held && held.pluginId !== pluginId) {\n    throw new Error(\n      `repeat source \"${id}\" already has a reader from \"${held.pluginId}\"; ` +\n        `refused \"${pluginId}\"`,\n    )\n  }\n  const entry: RegisteredReader = { pluginId, reader }\n  readers.set(id, entry)\n  return () => {\n    if (readers.get(id) === entry) readers.delete(id)\n  }\n}\n\n/** The reader registered for a source, with its owner, or `null`. */\nexport function repeatRowReader(sourceId: string): RegisteredReader | null {\n  return readers.get(sourceId) ?? null\n}\n\n/** Only for specs: forgets every registered reader. */\nexport function resetRepeatRowReadersForTests(): void {\n  readers.clear()\n}\n\n/**\n * The declared source's reader was not registered, even after the app's\n * declarations step ran again. Thrown, never answered: see the module note.\n */\nexport class RepeatRowsUnavailableError extends Error {\n  constructor(readonly source: RepeatSourceDeclaration) {\n    super(\n      `repeat source \"${source.id}\" is declared by \"${source.pluginId}\" but ` +\n        'no reader is registered in this process — its server declarations ' +\n        'did not run. Refusing to render repeats as if they had no rows.',\n    )\n    this.name = 'RepeatRowsUnavailableError'\n  }\n}\n\n/**\n * The rows a composition's repeats render. See the module note for what each\n * of the three cases answers; with no keys it answers `{}` and asks nobody.\n */\nexport async function readRepeatRows(\n  request: RepeatRowsRequest,\n): Promise<RepeatRowsAnswer> {\n  const keys = [\n    ...new Set(request.keys.map((key) => key.trim()).filter(Boolean)),\n  ].sort()\n  if (!keys.length) return {}\n  const declared = declaredRepeatSource()\n  if (!declared) return {}\n  let registered = readers.get(declared.id)\n  if (!registered) {\n    try {\n      await runPluginDeclarationsRepair()\n    } catch (error) {\n      console.error('[repeat-rows] the declarations repair failed', error)\n    }\n    registered = readers.get(declared.id)\n  }\n  if (!registered) throw new RepeatRowsUnavailableError(declared)\n  return registered.reader({ hostId: request.hostId, keys })\n}\n"],"names":["globalScope","getRegisteringPluginId","PLUGIN_REPEAT_SOURCE_DECLARED","runPluginDeclarationsRepair","declaredRepeatSource","READERS_KEY","Symbol","for","globalThis","readers","Map","registerRepeatRowReader","sourceId","reader","options","id","trim","pluginId","Error","declared","held","get","entry","set","delete","repeatRowReader","resetRepeatRowReadersForTests","clear","RepeatRowsUnavailableError","source","name","readRepeatRows","request","keys","Set","map","key","filter","Boolean","sort","length","registered","error","console","hostId"],"mappings":"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"}

package/src/lib/plugin-manager/submission-record-target.d.ts

@@ -0,0 +1,144 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * WHERE A FORM'S SUBMISSION IS ALSO SAVED AS A RECORD (AGL-3080).
+ *
+ * A form on a published page can file every submission as a record another
+ * plugin keeps — a row in a dataset, today. The form is one plugin's element
+ * and the record is another plugin's storage, so neither may know the other:
+ * this is the contract between them, and core names neither the target nor
+ * where it keeps anything.
+ *
+ * It has two halves, because the decision of where a record lands must be
+ * made where the visitor cannot reach it:
+ *
+ * 1. {@link stampFormRecordTargets} — the page's composition hands the target
+ *    the tree it is about to ship, and the target stamps each form it will
+ *    write for with whatever it needs to trust at submit time (a signed
+ *    binding). The submit route is public and unauthenticated, so nothing
+ *    the body says on its own may choose a destination.
+ * 2. {@link writeFormRecordTarget} — the submit route hands the target the
+ *    submission as posted, after the submission itself is stored. The target
+ *    reads back what it stamped, writes the record or refuses it, and answers
+ *    what to note on the submission (`routing`) so the Inbox can say where it
+ *    went or why it did not.
+ *
+ * ## Declared, then registered — and an absent target is loud
+ *
+ * The target registers from its plugin's `serverDeclarations` entry, which
+ * every app runs at boot, and also DECLARES itself in `plugins.config.json`
+ * (`formRecordTarget`), compiled into core. A registry alone would read a
+ * failed boot as "no form writes anywhere", and every bound form would keep
+ * accepting submissions while its records quietly stopped — the AGL-3025
+ * shape. With the declaration the three cases are distinct:
+ *
+ * - nothing declared — this deployment ships no plugin that keeps records; no
+ *   form is stamped and no submission writes one, which is a real answer;
+ * - declared and registered — the target answers;
+ * - declared and NOT registered — the app's declarations step runs again. If
+ *   the target is still missing, a page carrying a form THROWS at render (the
+ *   cache keeps the last good page, and the logs are red), and a submission
+ *   is kept — the Inbox copy is written before this is asked — with the
+ *   failure logged and noted on it under `routing.recordTargetUnavailable`.
+ *
+ * Server-only, and reached by path, never through a barrel.
+ */
+/** One submission, as the route stored it. */
+export interface FormRecordWriteRequest {
+    /** The site the form was submitted on. */
+    hostId: string;
+    /** The organization that owns the site, when it has one. */
+    orgId: string | null;
+    /** The organization's billing document — the entitlements a write is held to. */
+    orgBilling: unknown;
+    /**
+     * The request body as posted. The target reads back only what it stamped
+     * onto the form, and must trust nothing else in it.
+     */
+    body: Readonly<Record<string, unknown>>;
+    /** The submitted values, sanitized, keyed by the name each field submits under. */
+    fields: Readonly<Record<string, string>>;
+}
+/** What a target answers for one submission. */
+export interface FormRecordWriteOutcome {
+    /**
+     * Written as the stored submission's `routing` when present: where the
+     * record went, or why it was refused. Absent when the form writes nowhere.
+     */
+    routing?: Record<string, unknown>;
+}
+/** A plugin that keeps the records forms may file into. */
+export interface FormRecordTarget {
+    /**
+     * Stamps each form in a composed tree this target will write for. Never
+     * mutates `nodes`, and answers the same object when it stamps nothing.
+     */
+    stamp<N extends Record<string, unknown>>(nodes: N, hostId: string): Promise<N>;
+    /**
+     * Writes one submission's record, or refuses it. Never rejects: a record
+     * that cannot be written is no reason to fail a submission already stored.
+     */
+    write(request: FormRecordWriteRequest): Promise<FormRecordWriteOutcome>;
+}
+/** The compiled declaration: which plugin keeps the records forms file into. */
+export interface FormRecordTargetDeclaration {
+    pluginId: string;
+    id: string;
+}
+/** The plugin declared as the forms' record target, or `null` when none is. */
+export declare function declaredFormRecordTarget(): FormRecordTargetDeclaration | null;
+interface RegisteredTarget {
+    pluginId: string;
+    target: FormRecordTarget;
+}
+/**
+ * Registers the target. The owner is the plugin whose register fn is running,
+ * or the `pluginId` passed for a boot declaration; with neither, or from a
+ * plugin other than the one declared, it throws. The same plugin registering
+ * again replaces its target. Returns the unregister.
+ */
+export declare function registerFormRecordTarget(target: FormRecordTarget, options?: {
+    pluginId?: string;
+}): () => void;
+/** The registered target with its owner, or `null`. */
+export declare function formRecordTarget(): RegisteredTarget | null;
+/** Only for specs: forgets the registered target. */
+export declare function resetFormRecordTargetForTests(): void;
+/**
+ * The declared target's registration was not found, even after the app's
+ * declarations step ran again.
+ */
+export declare class FormRecordTargetUnavailableError extends Error {
+    readonly declared: FormRecordTargetDeclaration;
+    constructor(declared: FormRecordTargetDeclaration);
+}
+/**
+ * The tree a page ships, with each form the target writes for stamped.
+ *
+ * A tree with no form asks nobody and comes back as the same object. A tree
+ * with one THROWS when the declared target is missing — see the module note.
+ */
+export declare function stampFormRecordTargets<N extends Record<string, unknown>>(nodes: N, hostId: string): Promise<N>;
+/**
+ * Files one stored submission as a record where the page's form said to.
+ *
+ * Never rejects. With no target declared it answers nothing; with the declared
+ * target missing it logs the failure and answers a `routing` note saying so,
+ * because the submission is already kept and losing it now would be worse.
+ */
+export declare function writeFormRecordTarget(request: FormRecordWriteRequest): Promise<FormRecordWriteOutcome>;
+export {};

package/src/lib/plugin-manager/submission-record-target.js

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
+import { FORM_COMPONENT_ID } from "../app-utils/forms.js";
+import { PLUGIN_FORM_RECORD_TARGET_DECLARED } from "./first-party-plugins.generated.js";
+import { runPluginDeclarationsRepair } from "./plugin-declarations-repair.js";
+/** The plugin declared as the forms' record target, or `null` when none is. */ export function declaredFormRecordTarget() {
+    return PLUGIN_FORM_RECORD_TARGET_DECLARED;
+}
+/**
+ * One slot per process, on `globalThis` (AGL-3412): the app registers from
+ * `instrumentation.ts`, which Next compiles apart from the routes that read.
+ */ const TARGET_KEY = Symbol.for('@aglyn/aglyn:submission-record-target');
+const globalScope = globalThis;
+/**
+ * Registers the target. The owner is the plugin whose register fn is running,
+ * or the `pluginId` passed for a boot declaration; with neither, or from a
+ * plugin other than the one declared, it throws. The same plugin registering
+ * again replaces its target. Returns the unregister.
+ */ export function registerFormRecordTarget(target, options) {
+    var _ref, _getRegisteringPluginId;
+    const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId) != null ? _ref : '').trim();
+    if (!pluginId) {
+        throw new Error('the form record target was registered with no owner: pass ' + '{ pluginId } when registering outside a plugin register fn');
+    }
+    const declared = declaredFormRecordTarget();
+    if (declared && declared.pluginId !== pluginId) {
+        throw new Error(`the form record target is declared by "${declared.pluginId}"; ` + `refused "${pluginId}"`);
+    }
+    const held = globalScope[TARGET_KEY];
+    if (held && held.pluginId !== pluginId) {
+        throw new Error(`the form record target is already registered by "${held.pluginId}"; ` + `refused "${pluginId}"`);
+    }
+    const entry = {
+        pluginId,
+        target
+    };
+    globalScope[TARGET_KEY] = entry;
+    return ()=>{
+        if (globalScope[TARGET_KEY] === entry) globalScope[TARGET_KEY] = null;
+    };
+}
+/** The registered target with its owner, or `null`. */ export function formRecordTarget() {
+    var _globalScope_TARGET_KEY;
+    return (_globalScope_TARGET_KEY = globalScope[TARGET_KEY]) != null ? _globalScope_TARGET_KEY : null;
+}
+/** Only for specs: forgets the registered target. */ export function resetFormRecordTargetForTests() {
+    globalScope[TARGET_KEY] = null;
+}
+/**
+ * The declared target's registration was not found, even after the app's
+ * declarations step ran again.
+ */ export class FormRecordTargetUnavailableError extends Error {
+    constructor(declared){
+        super(`the form record target is declared by "${declared.pluginId}" but none ` + 'is registered in this process — its server declarations did not run. ' + 'Refusing to treat bound forms as writing nowhere.'), this.declared = declared;
+        this.name = 'FormRecordTargetUnavailableError';
+    }
+}
+/** The declared target, repaired once if missing; `null` when none is declared. */ async function requireDeclaredTarget() {
+    const declared = declaredFormRecordTarget();
+    if (!declared) return null;
+    let registered = formRecordTarget();
+    if (!registered) {
+        try {
+            await runPluginDeclarationsRepair();
+        } catch (error) {
+            console.error('[submission-record-target] the declarations repair failed', error);
+        }
+        registered = formRecordTarget();
+    }
+    if (!registered) throw new FormRecordTargetUnavailableError(declared);
+    return registered.target;
+}
+const placesAForm = (nodes)=>Object.values(nodes).some((node)=>(node == null ? void 0 : node.componentId) === FORM_COMPONENT_ID);
+/**
+ * The tree a page ships, with each form the target writes for stamped.
+ *
+ * A tree with no form asks nobody and comes back as the same object. A tree
+ * with one THROWS when the declared target is missing — see the module note.
+ */ export async function stampFormRecordTargets(nodes, hostId) {
+    if (!placesAForm(nodes)) return nodes;
+    const target = await requireDeclaredTarget();
+    return target ? target.stamp(nodes, hostId) : nodes;
+}
+/**
+ * Files one stored submission as a record where the page's form said to.
+ *
+ * Never rejects. With no target declared it answers nothing; with the declared
+ * target missing it logs the failure and answers a `routing` note saying so,
+ * because the submission is already kept and losing it now would be worse.
+ */ export async function writeFormRecordTarget(request) {
+    let target;
+    try {
+        target = await requireDeclaredTarget();
+    } catch (error) {
+        console.error('[submission-record-target] a submission could not be filed', error);
+        return {
+            routing: {
+                recordTargetUnavailable: true
+            }
+        };
+    }
+    if (!target) return {};
+    try {
+        return await target.write(request);
+    } catch (error) {
+        console.error('[submission-record-target] the target failed a write', error);
+        return {};
+    }
+}
+
+//# sourceMappingURL=submission-record-target.js.map

package/src/lib/plugin-manager/submission-record-target.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/submission-record-target.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport { FORM_COMPONENT_ID } from '../app-utils/forms'\nimport { PLUGIN_FORM_RECORD_TARGET_DECLARED } from './first-party-plugins.generated'\nimport { runPluginDeclarationsRepair } from './plugin-declarations-repair'\n\n/**\n * WHERE A FORM'S SUBMISSION IS ALSO SAVED AS A RECORD (AGL-3080).\n *\n * A form on a published page can file every submission as a record another\n * plugin keeps — a row in a dataset, today. The form is one plugin's element\n * and the record is another plugin's storage, so neither may know the other:\n * this is the contract between them, and core names neither the target nor\n * where it keeps anything.\n *\n * It has two halves, because the decision of where a record lands must be\n * made where the visitor cannot reach it:\n *\n * 1. {@link stampFormRecordTargets} — the page's composition hands the target\n *    the tree it is about to ship, and the target stamps each form it will\n *    write for with whatever it needs to trust at submit time (a signed\n *    binding). The submit route is public and unauthenticated, so nothing\n *    the body says on its own may choose a destination.\n * 2. {@link writeFormRecordTarget} — the submit route hands the target the\n *    submission as posted, after the submission itself is stored. The target\n *    reads back what it stamped, writes the record or refuses it, and answers\n *    what to note on the submission (`routing`) so the Inbox can say where it\n *    went or why it did not.\n *\n * ## Declared, then registered — and an absent target is loud\n *\n * The target registers from its plugin's `serverDeclarations` entry, which\n * every app runs at boot, and also DECLARES itself in `plugins.config.json`\n * (`formRecordTarget`), compiled into core. A registry alone would read a\n * failed boot as \"no form writes anywhere\", and every bound form would keep\n * accepting submissions while its records quietly stopped — the AGL-3025\n * shape. With the declaration the three cases are distinct:\n *\n * - nothing declared — this deployment ships no plugin that keeps records; no\n *   form is stamped and no submission writes one, which is a real answer;\n * - declared and registered — the target answers;\n * - declared and NOT registered — the app's declarations step runs again. If\n *   the target is still missing, a page carrying a form THROWS at render (the\n *   cache keeps the last good page, and the logs are red), and a submission\n *   is kept — the Inbox copy is written before this is asked — with the\n *   failure logged and noted on it under `routing.recordTargetUnavailable`.\n *\n * Server-only, and reached by path, never through a barrel.\n */\n\n/** One submission, as the route stored it. */\nexport interface FormRecordWriteRequest {\n  /** The site the form was submitted on. */\n  hostId: string\n  /** The organization that owns the site, when it has one. */\n  orgId: string | null\n  /** The organization's billing document — the entitlements a write is held to. */\n  orgBilling: unknown\n  /**\n   * The request body as posted. The target reads back only what it stamped\n   * onto the form, and must trust nothing else in it.\n   */\n  body: Readonly<Record<string, unknown>>\n  /** The submitted values, sanitized, keyed by the name each field submits under. */\n  fields: Readonly<Record<string, string>>\n}\n\n/** What a target answers for one submission. */\nexport interface FormRecordWriteOutcome {\n  /**\n   * Written as the stored submission's `routing` when present: where the\n   * record went, or why it was refused. Absent when the form writes nowhere.\n   */\n  routing?: Record<string, unknown>\n}\n\n/** A plugin that keeps the records forms may file into. */\nexport interface FormRecordTarget {\n  /**\n   * Stamps each form in a composed tree this target will write for. Never\n   * mutates `nodes`, and answers the same object when it stamps nothing.\n   */\n  stamp<N extends Record<string, unknown>>(nodes: N, hostId: string): Promise<N>\n  /**\n   * Writes one submission's record, or refuses it. Never rejects: a record\n   * that cannot be written is no reason to fail a submission already stored.\n   */\n  write(request: FormRecordWriteRequest): Promise<FormRecordWriteOutcome>\n}\n\n/** The compiled declaration: which plugin keeps the records forms file into. */\nexport interface FormRecordTargetDeclaration {\n  pluginId: string\n  id: string\n}\n\n/** The plugin declared as the forms' record target, or `null` when none is. */\nexport function declaredFormRecordTarget(): FormRecordTargetDeclaration | null {\n  return PLUGIN_FORM_RECORD_TARGET_DECLARED\n}\n\ninterface RegisteredTarget {\n  pluginId: string\n  target: FormRecordTarget\n}\n\n/**\n * One slot per process, on `globalThis` (AGL-3412): the app registers from\n * `instrumentation.ts`, which Next compiles apart from the routes that read.\n */\nconst TARGET_KEY = Symbol.for('@aglyn/aglyn:submission-record-target')\n\nconst globalScope = globalThis as typeof globalThis & {\n  [TARGET_KEY]?: RegisteredTarget | null\n}\n\n/**\n * Registers the target. The owner is the plugin whose register fn is running,\n * or the `pluginId` passed for a boot declaration; with neither, or from a\n * plugin other than the one declared, it throws. The same plugin registering\n * again replaces its target. Returns the unregister.\n */\nexport function registerFormRecordTarget(\n  target: FormRecordTarget,\n  options?: { pluginId?: string },\n): () => void {\n  const pluginId = (getRegisteringPluginId() ?? options?.pluginId ?? '').trim()\n  if (!pluginId) {\n    throw new Error(\n      'the form record target was registered with no owner: pass ' +\n        '{ pluginId } when registering outside a plugin register fn',\n    )\n  }\n  const declared = declaredFormRecordTarget()\n  if (declared && declared.pluginId !== pluginId) {\n    throw new Error(\n      `the form record target is declared by \"${declared.pluginId}\"; ` +\n        `refused \"${pluginId}\"`,\n    )\n  }\n  const held = globalScope[TARGET_KEY]\n  if (held && held.pluginId !== pluginId) {\n    throw new Error(\n      `the form record target is already registered by \"${held.pluginId}\"; ` +\n        `refused \"${pluginId}\"`,\n    )\n  }\n  const entry: RegisteredTarget = { pluginId, target }\n  globalScope[TARGET_KEY] = entry\n  return () => {\n    if (globalScope[TARGET_KEY] === entry) globalScope[TARGET_KEY] = null\n  }\n}\n\n/** The registered target with its owner, or `null`. */\nexport function formRecordTarget(): RegisteredTarget | null {\n  return globalScope[TARGET_KEY] ?? null\n}\n\n/** Only for specs: forgets the registered target. */\nexport function resetFormRecordTargetForTests(): void {\n  globalScope[TARGET_KEY] = null\n}\n\n/**\n * The declared target's registration was not found, even after the app's\n * declarations step ran again.\n */\nexport class FormRecordTargetUnavailableError extends Error {\n  constructor(readonly declared: FormRecordTargetDeclaration) {\n    super(\n      `the form record target is declared by \"${declared.pluginId}\" but none ` +\n        'is registered in this process — its server declarations did not run. ' +\n        'Refusing to treat bound forms as writing nowhere.',\n    )\n    this.name = 'FormRecordTargetUnavailableError'\n  }\n}\n\n/** The declared target, repaired once if missing; `null` when none is declared. */\nasync function requireDeclaredTarget(): Promise<FormRecordTarget | null> {\n  const declared = declaredFormRecordTarget()\n  if (!declared) return null\n  let registered = formRecordTarget()\n  if (!registered) {\n    try {\n      await runPluginDeclarationsRepair()\n    } catch (error) {\n      console.error('[submission-record-target] the declarations repair failed', error)\n    }\n    registered = formRecordTarget()\n  }\n  if (!registered) throw new FormRecordTargetUnavailableError(declared)\n  return registered.target\n}\n\nconst placesAForm = (nodes: Record<string, unknown>): boolean =>\n  Object.values(nodes).some(\n    (node) =>\n      (node as { componentId?: unknown } | null)?.componentId === FORM_COMPONENT_ID,\n  )\n\n/**\n * The tree a page ships, with each form the target writes for stamped.\n *\n * A tree with no form asks nobody and comes back as the same object. A tree\n * with one THROWS when the declared target is missing — see the module note.\n */\nexport async function stampFormRecordTargets<N extends Record<string, unknown>>(\n  nodes: N,\n  hostId: string,\n): Promise<N> {\n  if (!placesAForm(nodes)) return nodes\n  const target = await requireDeclaredTarget()\n  return target ? target.stamp(nodes, hostId) : nodes\n}\n\n/**\n * Files one stored submission as a record where the page's form said to.\n *\n * Never rejects. With no target declared it answers nothing; with the declared\n * target missing it logs the failure and answers a `routing` note saying so,\n * because the submission is already kept and losing it now would be worse.\n */\nexport async function writeFormRecordTarget(\n  request: FormRecordWriteRequest,\n): Promise<FormRecordWriteOutcome> {\n  let target: FormRecordTarget | null\n  try {\n    target = await requireDeclaredTarget()\n  } catch (error) {\n    console.error('[submission-record-target] a submission could not be filed', error)\n    return { routing: { recordTargetUnavailable: true } }\n  }\n  if (!target) return {}\n  try {\n    return await target.write(request)\n  } catch (error) {\n    console.error('[submission-record-target] the target failed a write', error)\n    return {}\n  }\n}\n"],"names":["getRegisteringPluginId","FORM_COMPONENT_ID","PLUGIN_FORM_RECORD_TARGET_DECLARED","runPluginDeclarationsRepair","declaredFormRecordTarget","TARGET_KEY","Symbol","for","globalScope","globalThis","registerFormRecordTarget","target","options","pluginId","trim","Error","declared","held","entry","formRecordTarget","resetFormRecordTargetForTests","FormRecordTargetUnavailableError","name","requireDeclaredTarget","registered","error","console","placesAForm","nodes","Object","values","some","node","componentId","stampFormRecordTargets","hostId","stamp","writeFormRecordTarget","request","routing","recordTargetUnavailable","write"],"mappings":"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"}