@fieldia/core 0.30.1 → 0.31.0

package/src/lib/record/memory-codes.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryCodes = memoryCodes;
+const data_source_1 = require("./data-source");
+/** A memory source's `sendCode` and `checkCode`, over the codes it keeps. */
+function memoryCodes(options = {}, codes) {
+    const now = options.now ?? (() => Date.now());
+    const length = options.length ?? 6;
+    const retryAfter = options.retryAfter ?? 30;
+    const sameValue = (request) => (code) => code.pageId === request.pageId && code.field === request.field && code.value === request.value;
+    return {
+        sendCode(request) {
+            const refused = options.refuse?.(request);
+            if (refused)
+                throw (0, data_source_1.saveRefused)({ kind: 'rule', message: refused });
+            const last = codes.filter(sameValue(request)).pop();
+            const wait = last ? Math.ceil(retryAfter - (now() - last.sentAt) / 1000) : 0;
+            if (wait > 0)
+                throw (0, data_source_1.saveRefused)({ kind: 'rule', message: `Wait ${wait} seconds before asking for another code` });
+            const code = options.code?.(request, codes.length + 1) ?? String(Math.floor(Math.random() * 10 ** length)).padStart(length, '0');
+            const sent = {
+                id: `code-${codes.length + 1}`,
+                pageId: request.pageId,
+                field: request.field,
+                value: request.value,
+                ...(request.by ? { by: request.by } : {}),
+                code,
+                sentAt: now(),
+                expiresAt: now() + (options.expiresIn ?? 600) * 1000,
+                triesLeft: options.tries ?? 3,
+            };
+            codes.push(sent);
+            return { id: sent.id, expiresAt: new Date(sent.expiresAt).toISOString(), retryAfter, length: code.length };
+        },
+        checkCode(request) {
+            const sent = (request.id ? codes.find((code) => code.id === request.id) : undefined) ?? codes.filter(sameValue(request)).pop();
+            if (!sent || sent.used || sent.value !== request.value || now() > sent.expiresAt)
+                return { ok: false, expired: true };
+            if (sent.triesLeft <= 0)
+                return { ok: false, triesLeft: 0 };
+            if (request.code !== sent.code) {
+                sent.triesLeft -= 1;
+                return { ok: false, triesLeft: sent.triesLeft };
+            }
+            sent.used = true;
+            return { ok: true, proof: `proved:${sent.id}` };
+        },
+    };
+}
+//# sourceMappingURL=memory-codes.js.map

package/src/lib/record/memory-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-codes.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/memory-codes.ts"],"names":[],"mappings":"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"}

package/src/lib/record/memory-codes.mjs

@@ -0,0 +1,47 @@
+import { saveRefused } from './data-source.mjs';
+/** A memory source's `sendCode` and `checkCode`, over the codes it keeps. */
+export function memoryCodes(options = {}, codes) {
+    const now = options.now ?? (() => Date.now());
+    const length = options.length ?? 6;
+    const retryAfter = options.retryAfter ?? 30;
+    const sameValue = (request) => (code) => code.pageId === request.pageId && code.field === request.field && code.value === request.value;
+    return {
+        sendCode(request) {
+            const refused = options.refuse?.(request);
+            if (refused)
+                throw saveRefused({ kind: 'rule', message: refused });
+            const last = codes.filter(sameValue(request)).pop();
+            const wait = last ? Math.ceil(retryAfter - (now() - last.sentAt) / 1000) : 0;
+            if (wait > 0)
+                throw saveRefused({ kind: 'rule', message: `Wait ${wait} seconds before asking for another code` });
+            const code = options.code?.(request, codes.length + 1) ?? String(Math.floor(Math.random() * 10 ** length)).padStart(length, '0');
+            const sent = {
+                id: `code-${codes.length + 1}`,
+                pageId: request.pageId,
+                field: request.field,
+                value: request.value,
+                ...(request.by ? { by: request.by } : {}),
+                code,
+                sentAt: now(),
+                expiresAt: now() + (options.expiresIn ?? 600) * 1000,
+                triesLeft: options.tries ?? 3,
+            };
+            codes.push(sent);
+            return { id: sent.id, expiresAt: new Date(sent.expiresAt).toISOString(), retryAfter, length: code.length };
+        },
+        checkCode(request) {
+            const sent = (request.id ? codes.find((code) => code.id === request.id) : undefined) ?? codes.filter(sameValue(request)).pop();
+            if (!sent || sent.used || sent.value !== request.value || now() > sent.expiresAt)
+                return { ok: false, expired: true };
+            if (sent.triesLeft <= 0)
+                return { ok: false, triesLeft: 0 };
+            if (request.code !== sent.code) {
+                sent.triesLeft -= 1;
+                return { ok: false, triesLeft: sent.triesLeft };
+            }
+            sent.used = true;
+            return { ok: true, proof: `proved:${sent.id}` };
+        },
+    };
+}
+//# sourceMappingURL=memory-codes.mjs.map

package/src/lib/record/memory-codes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-codes.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/memory-codes.ts"],"names":[],"mappings":"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"}

package/src/lib/record/memory-data-source.d.mts

@@ -1,5 +1,6 @@
 import type { Option, PropertyDefinition } from '../format/field.mjs';
-import type { DataSource, OptionsRequest, SubmitRequest, SubmitResult, ListedRecord, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest, ApprovalEntry, SuggestRequest, SuggestResult, RewriteRequest, RewriteResult, SearchToFilterRequest, SearchToFilterResult, ClustersRequest, ClustersResult } from './data-source.mjs';
+import { type MemoryCodes, type SentCodeKept } from './memory-codes.mjs';
+import type { PayRequest, PayResult, DataSource, OptionsRequest, SubmitRequest, SubmitResult, ListedRecord, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest, ApprovalEntry, SuggestRequest, SuggestResult, RewriteRequest, RewriteResult, SearchToFilterRequest, SearchToFilterResult, ClustersRequest, ClustersResult, SavedView, PresentPerson, RecordTemplate } from './data-source.mjs';
 import { type Scheduler } from './scheduler.mjs';
 import { type MemoryKept } from './memory-kept.mjs';
 import { type MemoryApprovalRoute } from './memory-approvals.mjs';
@@ -58,6 +59,19 @@ export interface MemoryDataSourceOptions {
     versions?: boolean | {
         by?: string;
     };
+    /**
+     * Live, as a server with a socket: a record's changes made with `changeElsewhere` are pushed to each page that has it
+     * open (`subscribe`), and who has a record open is told (`presence`): each page that opens it, and anyone `arrive`
+     * brings (`leave` takes them away). Without it the source has none of `subscribe`, `presence`, `arrive` and `leave`, as
+     * a source without a socket: a change elsewhere is found as a save meets it.
+     */
+    live?: boolean;
+    /**
+     * Record templates saved before, by page id: what `templates` answers first ("Botox package"), as an app's server
+     * keeps them — `{}` for none yet. Given, the source has `templates`, `saveTemplate` and `deleteTemplate`; else none,
+     * and a page keeps its templates in the viewer's `preferences`.
+     */
+    templates?: Record<string, RecordTemplate[]>;
     /**
      * What the person may do with each record, by model: given with its load
      * and its row in a list, and kept to as a backend would — a save, a
@@ -146,6 +160,29 @@ export interface MemoryDataSourceOptions {
      * them. Without it, the source has no `clusters`, and every map gathers its records in the browser.
      */
     clusters?: (request: ClustersRequest, records: Readonly<Record<string, Record<string, Values>>>, row: (id: RecordId, values: Values) => ListedRecord) => ClustersResult | false | Promise<ClustersResult | false>;
+    /**
+     * Keep lists' saved views, as an app's server does (`views`, `saveView`, `deleteView`): those it starts with, by page
+     * id — the team's shared ones, each with who made it (`by`), and this person's own (`mine`) — `{}` for none yet.
+     * Without it, the source has none of the three, and a list keeps its favourites in the browser, as before.
+     */
+    views?: Record<string, SavedView[]>;
+    /**
+     * How the codes that prove an email or a phone are made and checked (`sendCode`, `checkCode`), as an app's own
+     * service would: their digits, how long each works, how soon another may be asked for, the wrong ones taken. Each
+     * code sent is kept in `codes`, where a demo shows it as the message would. See `MemoryCodes`.
+     */
+    codes?: MemoryCodes;
+    /**
+     * How a payment the answers wait for ends (`pay`), as an app's provider would answer: paid, with a reference of its
+     * own, unless this says otherwise — a demo's stand-in checkout drawn in the request's `slot`, a test's decline. Each
+     * payment asked for is kept in `payments`.
+     */
+    pay?: (request: PayRequest, count: number) => PayResult | Promise<PayResult>;
+    /**
+     * Whether there is no signal now: while it says so, a save, a send and a file's upload fail as a network does
+     * (`TypeError: Failed to fetch`) — a demo's "Work offline", a test's outbox. Signal always, unless said.
+     */
+    offline?: () => boolean;
 }
 /** What a memory source's AI help answers with (`MemoryDataSourceOptions.assist`): each given, from its records. */
 export interface MemoryAssist {
@@ -155,14 +192,21 @@ export interface MemoryAssist {
 }
 /** The members of AI help a memory source has only where its `assist` answers them. */
 type AssistMembers = 'suggest' | 'rewrite' | 'searchToFilter';
+/**
+ * The members a memory source has only where an option says how it answers: AI help's (`assist`), a list's map's
+ * `clusters`, lists' saved views (`views`), record templates (`templates`) and live updates (`live`).
+ */
+type OptionalMembers = AssistMembers | 'clusters' | 'views' | 'saveView' | 'deleteView' | 'templates' | 'saveTemplate' | 'deleteTemplate' | 'subscribe' | 'presence';
 /**
  * Every member of a data source but `exportRecords` and `importRecords`: a
  * memory source leaves an export and an import to the browser, as a source
  * without a server of its own does. A test or a demo gives it one by setting
  * it. AI help's (`suggest`, `rewrite`, `searchToFilter`) where its `assist`
  * option answers them. `clusters` is there where its option says how it answers.
+ * Saved views (`views`, `saveView`, `deleteView`) where it is given `views`; record templates (`templates`,
+ * `saveTemplate`, `deleteTemplate`) where it is given `templates`; `subscribe` and `presence` with `live`.
  */
-export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'>>, Pick<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'> {
+export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords' | OptionalMembers>>, Pick<DataSource, 'exportRecords' | 'importRecords' | OptionalMembers> {
     readonly records: Record<string, Record<string, Values>>;
     /**
      * The records said to be someone else for one another, by model: each pair of ids, in the order kept, through
@@ -183,6 +227,10 @@ export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecor
         by: string;
         at?: string;
     }): RecordVersion;
+    /** Someone else opens a record, or changes whether they are editing it: told to each page that has it open. With `live`. */
+    arrive?(model: string, id: RecordId, person: PresentPerson): void;
+    /** Someone else closes it. With `live`. */
+    leave?(model: string, id: RecordId, person: RecordId): void;
     /** Drafts kept by `saveDraft`, by key, each with its page's id and the request's `later`: the partial answers an app sees. */
     readonly drafts: Record<string, StoredDraft & {
         pageId: string;
@@ -190,6 +238,12 @@ export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecor
     }>;
     /** Take a response to a page as someone else would, on another screen: counted by `limits`, never as this person's. */
     answeredElsewhere(pageId: string, values: Values): void;
+    /** The codes `sendCode` sent, in order: each with the value it proves and the code itself, as its message would say it. */
+    readonly codes: SentCodeKept[];
+    /** The payments `pay` was asked for, in order (without their slot and signal), and how each ended. */
+    readonly payments: (Omit<PayRequest, 'slot' | 'signal'> & {
+        result: PayResult;
+    })[];
 }
 /**
  * A data source that keeps everything in memory. It implements the whole

package/src/lib/record/memory-data-source.d.ts

@@ -1,5 +1,6 @@
 import type { Option, PropertyDefinition } from '../format/field';
-import type { DataSource, OptionsRequest, SubmitRequest, SubmitResult, ListedRecord, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest, ApprovalEntry, SuggestRequest, SuggestResult, RewriteRequest, RewriteResult, SearchToFilterRequest, SearchToFilterResult, ClustersRequest, ClustersResult } from './data-source';
+import { type MemoryCodes, type SentCodeKept } from './memory-codes';
+import type { PayRequest, PayResult, DataSource, OptionsRequest, SubmitRequest, SubmitResult, ListedRecord, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest, ApprovalEntry, SuggestRequest, SuggestResult, RewriteRequest, RewriteResult, SearchToFilterRequest, SearchToFilterResult, ClustersRequest, ClustersResult, SavedView, PresentPerson, RecordTemplate } from './data-source';
 import { type Scheduler } from './scheduler';
 import { type MemoryKept } from './memory-kept';
 import { type MemoryApprovalRoute } from './memory-approvals';
@@ -58,6 +59,19 @@ export interface MemoryDataSourceOptions {
     versions?: boolean | {
         by?: string;
     };
+    /**
+     * Live, as a server with a socket: a record's changes made with `changeElsewhere` are pushed to each page that has it
+     * open (`subscribe`), and who has a record open is told (`presence`): each page that opens it, and anyone `arrive`
+     * brings (`leave` takes them away). Without it the source has none of `subscribe`, `presence`, `arrive` and `leave`, as
+     * a source without a socket: a change elsewhere is found as a save meets it.
+     */
+    live?: boolean;
+    /**
+     * Record templates saved before, by page id: what `templates` answers first ("Botox package"), as an app's server
+     * keeps them — `{}` for none yet. Given, the source has `templates`, `saveTemplate` and `deleteTemplate`; else none,
+     * and a page keeps its templates in the viewer's `preferences`.
+     */
+    templates?: Record<string, RecordTemplate[]>;
     /**
      * What the person may do with each record, by model: given with its load
      * and its row in a list, and kept to as a backend would — a save, a
@@ -146,6 +160,29 @@ export interface MemoryDataSourceOptions {
      * them. Without it, the source has no `clusters`, and every map gathers its records in the browser.
      */
     clusters?: (request: ClustersRequest, records: Readonly<Record<string, Record<string, Values>>>, row: (id: RecordId, values: Values) => ListedRecord) => ClustersResult | false | Promise<ClustersResult | false>;
+    /**
+     * Keep lists' saved views, as an app's server does (`views`, `saveView`, `deleteView`): those it starts with, by page
+     * id — the team's shared ones, each with who made it (`by`), and this person's own (`mine`) — `{}` for none yet.
+     * Without it, the source has none of the three, and a list keeps its favourites in the browser, as before.
+     */
+    views?: Record<string, SavedView[]>;
+    /**
+     * How the codes that prove an email or a phone are made and checked (`sendCode`, `checkCode`), as an app's own
+     * service would: their digits, how long each works, how soon another may be asked for, the wrong ones taken. Each
+     * code sent is kept in `codes`, where a demo shows it as the message would. See `MemoryCodes`.
+     */
+    codes?: MemoryCodes;
+    /**
+     * How a payment the answers wait for ends (`pay`), as an app's provider would answer: paid, with a reference of its
+     * own, unless this says otherwise — a demo's stand-in checkout drawn in the request's `slot`, a test's decline. Each
+     * payment asked for is kept in `payments`.
+     */
+    pay?: (request: PayRequest, count: number) => PayResult | Promise<PayResult>;
+    /**
+     * Whether there is no signal now: while it says so, a save, a send and a file's upload fail as a network does
+     * (`TypeError: Failed to fetch`) — a demo's "Work offline", a test's outbox. Signal always, unless said.
+     */
+    offline?: () => boolean;
 }
 /** What a memory source's AI help answers with (`MemoryDataSourceOptions.assist`): each given, from its records. */
 export interface MemoryAssist {
@@ -155,14 +192,21 @@ export interface MemoryAssist {
 }
 /** The members of AI help a memory source has only where its `assist` answers them. */
 type AssistMembers = 'suggest' | 'rewrite' | 'searchToFilter';
+/**
+ * The members a memory source has only where an option says how it answers: AI help's (`assist`), a list's map's
+ * `clusters`, lists' saved views (`views`), record templates (`templates`) and live updates (`live`).
+ */
+type OptionalMembers = AssistMembers | 'clusters' | 'views' | 'saveView' | 'deleteView' | 'templates' | 'saveTemplate' | 'deleteTemplate' | 'subscribe' | 'presence';
 /**
  * Every member of a data source but `exportRecords` and `importRecords`: a
  * memory source leaves an export and an import to the browser, as a source
  * without a server of its own does. A test or a demo gives it one by setting
  * it. AI help's (`suggest`, `rewrite`, `searchToFilter`) where its `assist`
  * option answers them. `clusters` is there where its option says how it answers.
+ * Saved views (`views`, `saveView`, `deleteView`) where it is given `views`; record templates (`templates`,
+ * `saveTemplate`, `deleteTemplate`) where it is given `templates`; `subscribe` and `presence` with `live`.
  */
-export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'>>, Pick<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'> {
+export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords' | OptionalMembers>>, Pick<DataSource, 'exportRecords' | 'importRecords' | OptionalMembers> {
     readonly records: Record<string, Record<string, Values>>;
     /**
      * The records said to be someone else for one another, by model: each pair of ids, in the order kept, through
@@ -183,6 +227,10 @@ export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecor
         by: string;
         at?: string;
     }): RecordVersion;
+    /** Someone else opens a record, or changes whether they are editing it: told to each page that has it open. With `live`. */
+    arrive?(model: string, id: RecordId, person: PresentPerson): void;
+    /** Someone else closes it. With `live`. */
+    leave?(model: string, id: RecordId, person: RecordId): void;
     /** Drafts kept by `saveDraft`, by key, each with its page's id and the request's `later`: the partial answers an app sees. */
     readonly drafts: Record<string, StoredDraft & {
         pageId: string;
@@ -190,6 +238,12 @@ export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecor
     }>;
     /** Take a response to a page as someone else would, on another screen: counted by `limits`, never as this person's. */
     answeredElsewhere(pageId: string, values: Values): void;
+    /** The codes `sendCode` sent, in order: each with the value it proves and the code itself, as its message would say it. */
+    readonly codes: SentCodeKept[];
+    /** The payments `pay` was asked for, in order (without their slot and signal), and how each ended. */
+    readonly payments: (Omit<PayRequest, 'slot' | 'signal'> & {
+        result: PayResult;
+    })[];
 }
 /**
  * A data source that keeps everything in memory. It implements the whole

package/src/lib/record/memory-data-source.js

@@ -3,12 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMemoryDataSource = createMemoryDataSource;
 exports.memorySource = memorySource;
 const input_rules_1 = require("./input-rules");
+const memory_codes_1 = require("./memory-codes");
 const data_source_1 = require("./data-source");
+const memory_live_1 = require("./memory-live");
 const filter_1 = require("./filter");
 const periods_1 = require("./periods");
 const scheduler_1 = require("./scheduler");
 const memory_kept_1 = require("./memory-kept");
 const memory_approvals_1 = require("./memory-approvals");
+const memory_views_1 = require("./memory-views");
 const values_1 = require("./values");
 /**
  * A data source that keeps everything in memory. It implements the whole
@@ -20,7 +23,8 @@ function createMemoryDataSource(options = {}) {
 }
 /** A memory source's members, working on what it keeps (`memoryKept`): the one-tag script's memory part. */
 function memorySource(options, kept) {
-    const { records, notDuplicatePairs, responses, calls, elsewhere, drafts, table, versionOf, moveOn } = kept;
+    const { records, notDuplicatePairs, responses, calls, elsewhere, drafts, codes, payments, table, versionOf, moveOn } = kept;
+    const proving = (0, memory_codes_1.memoryCodes)(options.codes, codes);
     let draftIds = 0;
     /** A record's approvals, as an approval engine keeps them (memory-approvals.ts). */
     const approving = (0, memory_approvals_1.memoryApprovals)({
@@ -63,6 +67,40 @@ function memorySource(options, kept) {
     const pause = () => (options.delayMs ? (0, scheduler_1.wait)(options.delayMs, options.scheduler) : Promise.resolve());
     /** A record's name, or its names in each language it is kept in (`{ ar, en }`). */
     const nameOf = (model, id) => table(model)[String(id)]?.[options.labelField?.[model] ?? 'name'];
+    /** No signal now (`offline`): fail as a network does. */
+    const noSignal = () => {
+        if (options.offline?.())
+            throw new TypeError('Failed to fetch');
+    };
+    /** Each page's record templates, as saved: those given first, then each kept, numbered on. */
+    const savedTemplates = (0, values_1.structuredCopy)(options.templates ?? {});
+    const templatesOf = (pageId) => (savedTemplates[pageId] ??= []);
+    let templateIds = 0;
+    async function templates(request) {
+        calls.push({ method: 'templates', request });
+        await pause();
+        return (0, values_1.structuredCopy)(templatesOf(request.pageId));
+    }
+    async function saveTemplate(request) {
+        calls.push({ method: 'saveTemplate', request });
+        await pause();
+        const list = templatesOf(request.pageId);
+        const kept = { id: request.template.id ?? `template-${++templateIds}`, name: request.template.name, values: (0, values_1.structuredCopy)(request.template.values) };
+        const at = list.findIndex((one) => String(one.id) === String(kept.id));
+        if (at >= 0)
+            list[at] = kept;
+        else
+            list.push(kept);
+        return (0, values_1.structuredCopy)(kept);
+    }
+    async function deleteTemplate(request) {
+        calls.push({ method: 'deleteTemplate', request });
+        await pause();
+        const list = templatesOf(request.pageId);
+        const at = list.findIndex((one) => String(one.id) === String(request.id));
+        if (at >= 0)
+            list.splice(at, 1);
+    }
     const labelOf = (model, id) => {
         const value = nameOf(model, id);
         const name = oneText(value, options.language);
@@ -188,8 +226,31 @@ function memorySource(options, kept) {
         responses,
         calls,
         drafts,
+        codes,
+        payments,
         answeredElsewhere: kept.answeredElsewhere,
+        async pay(request) {
+            const { slot: _slot, signal: _signal, ...asked } = request;
+            calls.push({ method: 'pay', request: asked });
+            await pause();
+            const result = options.pay ? await options.pay(request, payments.length + 1) : { status: 'paid', reference: `PAY-${payments.length + 1}` };
+            payments.push({ ...(0, values_1.structuredCopy)(asked), result: (0, values_1.structuredCopy)(result) });
+            return result;
+        },
         changeElsewhere: kept.changeElsewhere,
+        ...(0, memory_live_1.memoryLive)(options, kept),
+        // Record templates, as an app's server keeps them: where it was given some (`templates`, `{}` for none yet).
+        ...(options.templates ? { templates, saveTemplate, deleteTemplate } : {}),
+        async sendCode(request) {
+            calls.push({ method: 'sendCode', request });
+            await pause();
+            return proving.sendCode(request);
+        },
+        async checkCode(request) {
+            calls.push({ method: 'checkCode', request });
+            await pause();
+            return proving.checkCode(request);
+        },
         async limits(request) {
             calls.push({ method: 'limits', request });
             await pause();
@@ -264,6 +325,7 @@ function memorySource(options, kept) {
         async save(request) {
             calls.push({ method: 'save', request });
             await pause();
+            noSignal();
             const saved = write(request);
             // Saved: the draft its changes were kept in is let go, as a server does.
             if (request.draft)
@@ -441,6 +503,7 @@ function memorySource(options, kept) {
         },
         async upload(file, request) {
             calls.push({ method: 'upload', request: { ...request, file } });
+            noSignal();
             const stopped = () => Object.assign(new Error('The upload was stopped'), { name: 'AbortError' });
             // A store slow or failing as `storage` says: a refusal at once, a failure partway, the bytes paced as they go.
             const tried = `${file.name}:${file.size}`;
@@ -487,6 +550,7 @@ function memorySource(options, kept) {
         async submit(request) {
             calls.push({ method: 'submit', request });
             await pause();
+            noSignal();
             responses.push((0, values_1.structuredCopy)(request));
             // Sent: the draft it was kept in is let go, as a server does.
             if (request.draft)
@@ -562,6 +626,8 @@ function memorySource(options, kept) {
             const own = options.definitions?.[request.list]?.(request.values) ?? [];
             addedDefinitions.set(`${request.list}:${JSON.stringify(own)}`, (0, values_1.structuredCopy)(request.definitions.filter((d) => !own.some((o) => o.name === d.name))));
         },
+        // Lists' saved views, where it was given some (memory-views.ts).
+        ...(options.views ? (0, memory_views_1.memoryViews)(options.views, calls, pause) : {}),
     };
     // AI help's members, where the app gave what answers them (`assist`): each called as a server would be, after the
     // source's pause, from the records it keeps.