@fieldia/core 0.30.0 → 0.31.0

package/src/lib/record/order.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drawsOrder = void 0;
+exports.seeded = seeded;
+exports.drawOrder = drawOrder;
+exports.askedInOrder = askedInOrder;
+/**
+ * Questions and steps in an order drawn for each respondent (`order: "random"` on a wizard, a step or a group), and N
+ * of a step's or a group's questions drawn of M (`draw`): the survey flow's part's. The draw is seeded, so the same seed draws
+ * the same order in every engine — the form keeps it (`state.order`), in its drafts too, so a person who comes back
+ * finds their questions where they left them.
+ */
+/** Whether a page of responses draws its order, or some of its questions, for each respondent (`order: "random"`, `draw`). */
+const drawsOrder = (page) => page.data.kind === 'responses' && /"(order":"random|draw":)/.test(JSON.stringify(page.layout));
+exports.drawsOrder = drawsOrder;
+/** A string's hash as four 32-bit numbers (cyrb128): a seed's words made into the generator's start. */
+function hashed(seed) {
+    let h1 = 1779033703;
+    let h2 = 3144134277;
+    let h3 = 1013904242;
+    let h4 = 2773480762;
+    for (let i = 0; i < seed.length; i++) {
+        const k = seed.charCodeAt(i);
+        h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+        h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+        h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+        h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+    }
+    h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);
+    h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);
+    h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);
+    h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);
+    return [(h1 ^ h2 ^ h3 ^ h4) >>> 0, (h2 ^ h1) >>> 0, (h3 ^ h1) >>> 0, (h4 ^ h1) >>> 0];
+}
+/** Numbers from 0 to 1 drawn from a seed (sfc32): the same seed, the same numbers, everywhere. */
+function seeded(seed) {
+    let [a, b, c, d] = hashed(seed);
+    return () => {
+        a >>>= 0;
+        b >>>= 0;
+        c >>>= 0;
+        d >>>= 0;
+        let t = (a + b) | 0;
+        a = b ^ (b >>> 9);
+        b = (c + (c << 3)) | 0;
+        c = (c << 21) | (c >>> 11);
+        d = (d + 1) | 0;
+        t = (t + d) | 0;
+        c = (c + t) | 0;
+        return (t >>> 0) / 4294967296;
+    };
+}
+/** A list in an order drawn (Fisher–Yates). */
+function shuffled(items, next) {
+    const out = [...items];
+    for (let i = out.length - 1; i > 0; i--) {
+        const j = Math.floor(next() * (i + 1));
+        [out[i], out[j]] = [out[j], out[i]];
+    }
+    return out;
+}
+/** Whether a part is one a draw moves or leaves out: a question — a field, a saved form, a group of them — not fixed in its place. */
+const drawable = (node) => (node.type === 'field' || node.type === 'form' || node.type === 'section') && node.fixed !== true;
+/**
+ * The parts of one part in their order drawn: those a draw moves change places among themselves — the rest (words,
+ * pictures, a part fixed in its place) keep theirs — and `draw` of them, at most, are kept, the rest left out.
+ */
+function drawnParts(children, movable, random, draw, next) {
+    const moving = children.filter(movable);
+    let kept = moving;
+    if (draw !== undefined && draw < moving.length) {
+        // Which of them are asked, drawn; in their own order unless the order is drawn too.
+        const picked = new Set(shuffled(moving, next).slice(0, draw));
+        kept = moving.filter((child) => picked.has(child));
+    }
+    const placed = random ? shuffled(kept, next) : kept;
+    // The places of those that move, in turn: the first filled with those placed, the rest left out with those not drawn.
+    let at = 0;
+    const out = [];
+    for (const child of children) {
+        if (!movable(child))
+            out.push(child.id);
+        else if (at < placed.length)
+            out.push(placed[at++].id);
+    }
+    return out;
+}
+/**
+ * The order a page's parts are shown in for one seed: each wizard whose steps are in random order, each step and group
+ * whose questions are or which draws some of them — by its id, its parts' ids in the order shown, those not drawn left
+ * out. Empty for a page that draws nothing.
+ */
+function drawOrder(page, seed) {
+    const next = seeded(`${page.id}\u0000${seed}`);
+    const order = {};
+    const visit = (node) => {
+        const own = node;
+        const children = Array.isArray(own.children) ? own.children : [];
+        if ((own.order === 'random' || own.draw !== undefined) && children.length) {
+            const steps = node.type === 'wizard';
+            order[own.id] = drawnParts(children, steps ? (child) => child.fixed !== true : (child) => drawable(child), own.order === 'random', steps ? undefined : own.draw, next);
+        }
+        for (const child of children)
+            visit(child);
+    };
+    const root = page.layout;
+    visit(root);
+    return order;
+}
+/** The fields asked, in the order they were shown: the page's parts walked in their drawn order, those whose answers were sent. */
+function askedInOrder(page, order, values) {
+    const out = [];
+    const visit = (node) => {
+        if (node.type === 'field' && node.field && node.field in values && !out.includes(node.field))
+            out.push(node.field);
+        const children = Array.isArray(node.children) ? node.children : [];
+        const drawn = node.id ? order?.[node.id] : undefined;
+        const shown = drawn ? drawn.map((id) => children.find((child) => child.id === id)).filter((child) => !!child) : children;
+        for (const child of shown)
+            visit(child);
+    };
+    visit(page.layout);
+    // A saved form's answers, and any other sent, after: by name.
+    for (const name of Object.keys(values))
+        if (!out.includes(name))
+            out.push(name);
+    return out;
+}
+//# sourceMappingURL=order.js.map

package/src/lib/record/order.js.map

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

package/src/lib/record/order.mjs

@@ -0,0 +1,122 @@
+/**
+ * Questions and steps in an order drawn for each respondent (`order: "random"` on a wizard, a step or a group), and N
+ * of a step's or a group's questions drawn of M (`draw`): the survey flow's part's. The draw is seeded, so the same seed draws
+ * the same order in every engine — the form keeps it (`state.order`), in its drafts too, so a person who comes back
+ * finds their questions where they left them.
+ */
+/** Whether a page of responses draws its order, or some of its questions, for each respondent (`order: "random"`, `draw`). */
+export const drawsOrder = (page) => page.data.kind === 'responses' && /"(order":"random|draw":)/.test(JSON.stringify(page.layout));
+/** A string's hash as four 32-bit numbers (cyrb128): a seed's words made into the generator's start. */
+function hashed(seed) {
+    let h1 = 1779033703;
+    let h2 = 3144134277;
+    let h3 = 1013904242;
+    let h4 = 2773480762;
+    for (let i = 0; i < seed.length; i++) {
+        const k = seed.charCodeAt(i);
+        h1 = h2 ^ Math.imul(h1 ^ k, 597399067);
+        h2 = h3 ^ Math.imul(h2 ^ k, 2869860233);
+        h3 = h4 ^ Math.imul(h3 ^ k, 951274213);
+        h4 = h1 ^ Math.imul(h4 ^ k, 2716044179);
+    }
+    h1 = Math.imul(h3 ^ (h1 >>> 18), 597399067);
+    h2 = Math.imul(h4 ^ (h2 >>> 22), 2869860233);
+    h3 = Math.imul(h1 ^ (h3 >>> 17), 951274213);
+    h4 = Math.imul(h2 ^ (h4 >>> 19), 2716044179);
+    return [(h1 ^ h2 ^ h3 ^ h4) >>> 0, (h2 ^ h1) >>> 0, (h3 ^ h1) >>> 0, (h4 ^ h1) >>> 0];
+}
+/** Numbers from 0 to 1 drawn from a seed (sfc32): the same seed, the same numbers, everywhere. */
+export function seeded(seed) {
+    let [a, b, c, d] = hashed(seed);
+    return () => {
+        a >>>= 0;
+        b >>>= 0;
+        c >>>= 0;
+        d >>>= 0;
+        let t = (a + b) | 0;
+        a = b ^ (b >>> 9);
+        b = (c + (c << 3)) | 0;
+        c = (c << 21) | (c >>> 11);
+        d = (d + 1) | 0;
+        t = (t + d) | 0;
+        c = (c + t) | 0;
+        return (t >>> 0) / 4294967296;
+    };
+}
+/** A list in an order drawn (Fisher–Yates). */
+function shuffled(items, next) {
+    const out = [...items];
+    for (let i = out.length - 1; i > 0; i--) {
+        const j = Math.floor(next() * (i + 1));
+        [out[i], out[j]] = [out[j], out[i]];
+    }
+    return out;
+}
+/** Whether a part is one a draw moves or leaves out: a question — a field, a saved form, a group of them — not fixed in its place. */
+const drawable = (node) => (node.type === 'field' || node.type === 'form' || node.type === 'section') && node.fixed !== true;
+/**
+ * The parts of one part in their order drawn: those a draw moves change places among themselves — the rest (words,
+ * pictures, a part fixed in its place) keep theirs — and `draw` of them, at most, are kept, the rest left out.
+ */
+function drawnParts(children, movable, random, draw, next) {
+    const moving = children.filter(movable);
+    let kept = moving;
+    if (draw !== undefined && draw < moving.length) {
+        // Which of them are asked, drawn; in their own order unless the order is drawn too.
+        const picked = new Set(shuffled(moving, next).slice(0, draw));
+        kept = moving.filter((child) => picked.has(child));
+    }
+    const placed = random ? shuffled(kept, next) : kept;
+    // The places of those that move, in turn: the first filled with those placed, the rest left out with those not drawn.
+    let at = 0;
+    const out = [];
+    for (const child of children) {
+        if (!movable(child))
+            out.push(child.id);
+        else if (at < placed.length)
+            out.push(placed[at++].id);
+    }
+    return out;
+}
+/**
+ * The order a page's parts are shown in for one seed: each wizard whose steps are in random order, each step and group
+ * whose questions are or which draws some of them — by its id, its parts' ids in the order shown, those not drawn left
+ * out. Empty for a page that draws nothing.
+ */
+export function drawOrder(page, seed) {
+    const next = seeded(`${page.id}\u0000${seed}`);
+    const order = {};
+    const visit = (node) => {
+        const own = node;
+        const children = Array.isArray(own.children) ? own.children : [];
+        if ((own.order === 'random' || own.draw !== undefined) && children.length) {
+            const steps = node.type === 'wizard';
+            order[own.id] = drawnParts(children, steps ? (child) => child.fixed !== true : (child) => drawable(child), own.order === 'random', steps ? undefined : own.draw, next);
+        }
+        for (const child of children)
+            visit(child);
+    };
+    const root = page.layout;
+    visit(root);
+    return order;
+}
+/** The fields asked, in the order they were shown: the page's parts walked in their drawn order, those whose answers were sent. */
+export function askedInOrder(page, order, values) {
+    const out = [];
+    const visit = (node) => {
+        if (node.type === 'field' && node.field && node.field in values && !out.includes(node.field))
+            out.push(node.field);
+        const children = Array.isArray(node.children) ? node.children : [];
+        const drawn = node.id ? order?.[node.id] : undefined;
+        const shown = drawn ? drawn.map((id) => children.find((child) => child.id === id)).filter((child) => !!child) : children;
+        for (const child of shown)
+            visit(child);
+    };
+    visit(page.layout);
+    // A saved form's answers, and any other sent, after: by name.
+    for (const name of Object.keys(values))
+        if (!out.includes(name))
+            out.push(name);
+    return out;
+}
+//# sourceMappingURL=order.mjs.map

package/src/lib/record/order.mjs.map

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

package/src/lib/record/outbox-form.d.mts

@@ -0,0 +1,79 @@
+import { type SaveProblem, type SaveRequest, type SubmitRequest, type UploadFile } from './data-source.mjs';
+import type { FormInner, FormJoin } from './joins.mjs';
+import { type FileValue } from './values.mjs';
+/**
+ * An offline outbox (`outbox` on a page), the form's side — the outbox part's, which joins a form whose page has one
+ * (joins.ts): a send that finds no network is kept on the device — its answers and its photos' bytes — and sent in order
+ * when the signal comes back. In the one-tag script, one script with the viewer's outbox part (fieldia.outbox.js).
+ */
+/** A send kept on the device until it can go: what it was, its answers, how far it got. */
+export interface OutboxItem {
+    /** Its own key, the same for every try: sent with it (`queued.key`), so a server can tell a second try from a new send. */
+    key: string;
+    pageId: string;
+    /** A response's `submit`, or a record's `save`. */
+    kind: 'submit' | 'save';
+    /** The send as it would have gone, its files' bytes in its values where they were not stored yet. */
+    request: SubmitRequest | SaveRequest;
+    /** When it was kept, as ISO: its place in the order they go. */
+    at: string;
+    /** A new record's own key on the form that kept it: a later save of the same record while this waits takes its place. */
+    record?: string;
+    /** How many times it was tried. */
+    tries: number;
+    /** Refused when it was sent (not the network's doing): why, kept for the person to see, and nothing sent after it waits on it. */
+    refused?: {
+        message: string;
+        problem?: SaveProblem;
+    };
+    /** Who is sending it now, and until when: no other tab or page sends it meanwhile. */
+    claim?: {
+        by: string;
+        until: number;
+    };
+}
+/**
+ * Where an outbox keeps its items: the browser's IndexedDB in the viewer (the outbox part's), a memory store in tests
+ * (`memoryOutbox`), or the app's own. Every call is the store's to make atomic: `claim` takes an item for one sender only.
+ */
+export interface OutboxStore {
+    /** The items of a page, in the order they were kept. */
+    list(pageId: string): Promise<OutboxItem[]>;
+    put(item: OutboxItem): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** Take an item to send it, unless another sender holds it still: whether it was taken. */
+    claim(key: string, by: string, until: number): Promise<boolean>;
+}
+/** A form's outbox, made for it (`join`; `form.joined('outbox')`). */
+export interface FormOutbox extends FormJoin {
+    /** Keep a send that found no network, in order — a new record's later save in place of its earlier one still waiting. */
+    keep(kind: OutboxItem['kind'], request: SubmitRequest | SaveRequest, record?: string): Promise<OutboxItem>;
+    /** Send what waits, in order: a network's failure stops it there (tried again later), a refusal is kept and said. */
+    send(): Promise<void>;
+    /** What waits now, told in the form's state (`outbox`). */
+    refresh(): Promise<void>;
+    /** Let a refused send go: the person's Discard. */
+    discard(key: string): Promise<void>;
+    /** Try again a refused send, as it is. */
+    retry(key: string): Promise<void>;
+    /** A file the network could not take, as its field keeps it until the send goes: its bytes, in base64. */
+    bytes(file: UploadFile): Promise<FileValue>;
+}
+/** An outbox kept in memory: for tests, and where a browser keeps nothing (no IndexedDB). Lost with the page. */
+export declare function memoryOutbox(): OutboxStore & {
+    readonly items: OutboxItem[];
+};
+/**
+ * An outbox kept in the browser's IndexedDB (database `fieldia-outbox`, store `items`): never lost on a reload, shared by
+ * the tabs of one site, an item taken by one sender at a time in a transaction of its own. Null where the browser has no
+ * IndexedDB.
+ */
+export declare function indexedOutbox(name?: string): OutboxStore | null;
+/**
+ * The outbox part's side of a form (`outbox` on its page): around each send, one that finds no network kept on the
+ * device in order — the form going on as though it went, its ending saying so (`state.outbox.kept`) — and a file the
+ * network could not take kept as its bytes; what waits sent — each taken by one sender only, its photos stored first —
+ * when the signal comes back, and right after a send of this form went through; a refusal kept and said; what waits
+ * told in the form's state (`outbox`).
+ */
+export declare function join(joined: FormInner): FormOutbox;

package/src/lib/record/outbox-form.d.ts

@@ -0,0 +1,79 @@
+import { type SaveProblem, type SaveRequest, type SubmitRequest, type UploadFile } from './data-source';
+import type { FormInner, FormJoin } from './joins';
+import { type FileValue } from './values';
+/**
+ * An offline outbox (`outbox` on a page), the form's side — the outbox part's, which joins a form whose page has one
+ * (joins.ts): a send that finds no network is kept on the device — its answers and its photos' bytes — and sent in order
+ * when the signal comes back. In the one-tag script, one script with the viewer's outbox part (fieldia.outbox.js).
+ */
+/** A send kept on the device until it can go: what it was, its answers, how far it got. */
+export interface OutboxItem {
+    /** Its own key, the same for every try: sent with it (`queued.key`), so a server can tell a second try from a new send. */
+    key: string;
+    pageId: string;
+    /** A response's `submit`, or a record's `save`. */
+    kind: 'submit' | 'save';
+    /** The send as it would have gone, its files' bytes in its values where they were not stored yet. */
+    request: SubmitRequest | SaveRequest;
+    /** When it was kept, as ISO: its place in the order they go. */
+    at: string;
+    /** A new record's own key on the form that kept it: a later save of the same record while this waits takes its place. */
+    record?: string;
+    /** How many times it was tried. */
+    tries: number;
+    /** Refused when it was sent (not the network's doing): why, kept for the person to see, and nothing sent after it waits on it. */
+    refused?: {
+        message: string;
+        problem?: SaveProblem;
+    };
+    /** Who is sending it now, and until when: no other tab or page sends it meanwhile. */
+    claim?: {
+        by: string;
+        until: number;
+    };
+}
+/**
+ * Where an outbox keeps its items: the browser's IndexedDB in the viewer (the outbox part's), a memory store in tests
+ * (`memoryOutbox`), or the app's own. Every call is the store's to make atomic: `claim` takes an item for one sender only.
+ */
+export interface OutboxStore {
+    /** The items of a page, in the order they were kept. */
+    list(pageId: string): Promise<OutboxItem[]>;
+    put(item: OutboxItem): Promise<void>;
+    delete(key: string): Promise<void>;
+    /** Take an item to send it, unless another sender holds it still: whether it was taken. */
+    claim(key: string, by: string, until: number): Promise<boolean>;
+}
+/** A form's outbox, made for it (`join`; `form.joined('outbox')`). */
+export interface FormOutbox extends FormJoin {
+    /** Keep a send that found no network, in order — a new record's later save in place of its earlier one still waiting. */
+    keep(kind: OutboxItem['kind'], request: SubmitRequest | SaveRequest, record?: string): Promise<OutboxItem>;
+    /** Send what waits, in order: a network's failure stops it there (tried again later), a refusal is kept and said. */
+    send(): Promise<void>;
+    /** What waits now, told in the form's state (`outbox`). */
+    refresh(): Promise<void>;
+    /** Let a refused send go: the person's Discard. */
+    discard(key: string): Promise<void>;
+    /** Try again a refused send, as it is. */
+    retry(key: string): Promise<void>;
+    /** A file the network could not take, as its field keeps it until the send goes: its bytes, in base64. */
+    bytes(file: UploadFile): Promise<FileValue>;
+}
+/** An outbox kept in memory: for tests, and where a browser keeps nothing (no IndexedDB). Lost with the page. */
+export declare function memoryOutbox(): OutboxStore & {
+    readonly items: OutboxItem[];
+};
+/**
+ * An outbox kept in the browser's IndexedDB (database `fieldia-outbox`, store `items`): never lost on a reload, shared by
+ * the tabs of one site, an item taken by one sender at a time in a transaction of its own. Null where the browser has no
+ * IndexedDB.
+ */
+export declare function indexedOutbox(name?: string): OutboxStore | null;
+/**
+ * The outbox part's side of a form (`outbox` on its page): around each send, one that finds no network kept on the
+ * device in order — the form going on as though it went, its ending saying so (`state.outbox.kept`) — and a file the
+ * network could not take kept as its bytes; what waits sent — each taken by one sender only, its photos stored first —
+ * when the signal comes back, and right after a send of this form went through; a refusal kept and said; what waits
+ * told in the form's state (`outbox`).
+ */
+export declare function join(joined: FormInner): FormOutbox;