@yadsh/dsh-qa-surface 0.17.0 → 0.18.0

package/lib/forms/store.js

@@ -0,0 +1,194 @@
+import { randomUUID } from "node:crypto";
+import { SqliteDatabase } from "@yadsh/dsh-plugin-kit/sqlite";
+import { formAssert, QaFormError } from "./errors.js";
+import { fingerprint } from "./fingerprint.js";
+// Node suites import the fingerprint from the store; keep that path working.
+export { fingerprint } from "./fingerprint.js";
+/** Full synchronous commits: snapshot, revision and mutation receipt share one transaction. */
+export class QaFormStore {
+    storage;
+    constructor(file) {
+        this.storage = new SqliteDatabase(file, [
+            {
+                version: 1,
+                up: `
+      CREATE TABLE forms (id TEXT PRIMARY KEY, session_id TEXT NOT NULL, request_key TEXT NOT NULL, state TEXT NOT NULL, document TEXT NOT NULL, UNIQUE(session_id,request_key));
+      CREATE UNIQUE INDEX one_draft ON forms(session_id) WHERE state='draft';
+      CREATE TABLE mutations (form_id TEXT NOT NULL REFERENCES forms(id), id TEXT NOT NULL, hash TEXT NOT NULL, result TEXT NOT NULL, PRIMARY KEY(form_id,id));
+      CREATE TABLE resources (id TEXT PRIMARY KEY, form_id TEXT NOT NULL REFERENCES forms(id), data BLOB NOT NULL);
+    `,
+            },
+        ]);
+        this.storage.db.exec("PRAGMA synchronous = FULL");
+        // One Host writer owns live uploads. After restart no old stream is alive.
+        this.storage.transaction(() => {
+            for (const row of this.storage.db
+                .prepare("SELECT document FROM forms WHERE state='draft'")
+                .all()) {
+                const r = JSON.parse(String(row.document));
+                let changed = false;
+                for (const u of r.uploads)
+                    if (u.state === "pending" || u.state === "uploading") {
+                        u.state = "failed";
+                        u.error = "UPLOAD_INTERRUPTED";
+                        changed = true;
+                    }
+                if (changed) {
+                    r.revision++;
+                    this.put(r);
+                }
+            }
+        });
+    }
+    list(session) {
+        return this.storage.db
+            .prepare("SELECT document FROM forms WHERE session_id=? ORDER BY rowid DESC")
+            .all(session)
+            .map((row) => JSON.parse(String(row.document)));
+    }
+    get(session, id) {
+        const row = this.storage.db
+            .prepare("SELECT document FROM forms WHERE session_id=? AND id=?")
+            .get(session, id);
+        formAssert(row, "ACCESS_DENIED", "Form access is unavailable.");
+        const record = JSON.parse(String(row.document));
+        formAssert(record.storage_version === 1, "STORAGE_UNAVAILABLE", "Unsupported form storage version.");
+        return record;
+    }
+    put(record) {
+        this.storage.db
+            .prepare("INSERT INTO forms(id,session_id,request_key,state,document) VALUES(?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET state=excluded.state,document=excluded.document")
+            .run(record.id, record.session_id, record.request_key, record.status, JSON.stringify(record));
+    }
+    create(session, key, schema, creator = session) {
+        return this.storage.transaction(() => {
+            const hash = fingerprint(schema), all = this.list(session), prior = all.find((r) => r.request_key === key);
+            if (prior) {
+                formAssert(prior.schema_hash === hash, "SCHEMA_CONFLICT", "This request key already has different requirements.");
+                this.editableOrSubmitted(prior);
+                return prior;
+            }
+            const active = all.find((r) => r.status === "draft");
+            if (active)
+                throw new QaFormError("ACTIVE_FORM_EXISTS", `Resume the existing form ${active.id}.`);
+            const record = {
+                storage_version: 1,
+                id: randomUUID(),
+                session_id: session,
+                creator_id: creator,
+                request_key: key,
+                schema,
+                schema_hash: hash,
+                status: "draft",
+                revision: 0,
+                created_at: new Date().toISOString(),
+                answers: {},
+                attachments: {},
+                uploads: [],
+                step: 0,
+            };
+            this.put(record);
+            return record;
+        });
+    }
+    editableOrSubmitted(record) {
+        formAssert(record.status === "draft" || record.status === "submitted", record.status === "expired" ? "FORM_EXPIRED" : "FORM_NOT_EDITABLE", "This form cannot be edited.");
+    }
+    mutationReceipt(formId, id) {
+        const row = this.storage.db
+            .prepare("SELECT hash,result FROM mutations WHERE form_id=? AND id=?")
+            .get(formId, id);
+        return row ? { hash: String(row.hash), result: String(row.result) } : null;
+    }
+    replayedMutation(formId, mutationId, input) {
+        const prior = this.mutationReceipt(formId, mutationId);
+        if (!prior)
+            return null;
+        formAssert(prior.hash === fingerprint(input), "IDEMPOTENCY_CONFLICT", "The mutation identity was already used for different data.");
+        return JSON.parse(prior.result);
+    }
+    mutate(session, id, revision, mutationId, input, work) {
+        formAssert(typeof mutationId === "string" &&
+            /^[a-zA-Z0-9_-]{1,100}$/u.test(mutationId), "INVALID_REQUEST", "A mutation identity is required.");
+        return this.storage.transaction(() => {
+            const record = this.get(session, id), hash = fingerprint(input);
+            const prior = this.mutationReceipt(id, mutationId);
+            if (prior) {
+                formAssert(prior.hash === hash, "IDEMPOTENCY_CONFLICT", "The mutation identity was already used for different data.");
+                return JSON.parse(prior.result);
+            }
+            if (record.revision !== revision)
+                throw new QaFormError("REVISION_CONFLICT", "The form changed in another window. Reload the saved draft before retrying.", record.revision);
+            formAssert(record.status === "draft", "FORM_NOT_EDITABLE", "This form cannot be edited.");
+            work(record);
+            record.revision++;
+            this.put(record);
+            this.storage.db
+                .prepare("INSERT INTO mutations(form_id,id,hash,result) VALUES(?,?,?,?)")
+                .run(id, mutationId, hash, JSON.stringify(record));
+            return record;
+        });
+    }
+    /** Async work happens before this short final transaction; no revision captured at upload start. */
+    update(session, id, work) {
+        return this.storage.transaction(() => {
+            const r = this.get(session, id);
+            work(r);
+            r.revision++;
+            this.put(r);
+            return r;
+        });
+    }
+    resource(formId, id) {
+        const row = this.storage.db
+            .prepare("SELECT data FROM resources WHERE form_id=? AND id=?")
+            .get(formId, id);
+        formAssert(row?.data instanceof Uint8Array, "FILE_UNAVAILABLE", "The saved file is unavailable.");
+        return row.data;
+    }
+    saveResource(formId, id, data) {
+        this.storage.db
+            .prepare("INSERT INTO resources(id,form_id,data) VALUES(?,?,?)")
+            .run(id, formId, data);
+    }
+    storedBytes(session) {
+        const row = this.storage.db
+            .prepare("SELECT COALESCE(SUM(length(data)),0) AS bytes FROM resources JOIN forms ON forms.id=resources.form_id WHERE forms.session_id=?")
+            .get(session);
+        return Number(row?.bytes ?? 0);
+    }
+    identityReservedBytes(creator) {
+        const rows = this.storage.db
+            .prepare("SELECT document FROM forms WHERE json_extract(document,'$.creator_id')=?")
+            .all(creator);
+        let total = 0;
+        for (const row of rows) {
+            const r = JSON.parse(String(row.document));
+            total += r.uploads
+                .filter((u) => u.state === "pending" || u.state === "uploading")
+                .reduce((n, u) => n + u.size_bytes, 0);
+            const saved = this.storage.db
+                .prepare("SELECT COALESCE(SUM(length(data)),0) AS bytes FROM resources WHERE form_id=?")
+                .get(r.id);
+            total += Number(saved?.bytes ?? 0);
+        }
+        return total;
+    }
+    cancelSession(session) {
+        this.storage.transaction(() => {
+            for (const r of this.list(session))
+                if (r.status === "draft") {
+                    r.status = "cancelled";
+                    r.revision++;
+                    for (const u of r.uploads)
+                        if (u.state !== "ready")
+                            u.state = "cancelled";
+                    this.put(r);
+                }
+        });
+    }
+    close() {
+        this.storage.close();
+    }
+}
+//# sourceMappingURL=store.js.map

package/lib/forms/store.js.map

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

package/lib/forms/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/forms/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":""}

package/lib/forms/validation.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { QaFormError } from "./errors.js";
+export const formAnswerParser = z.union([
+    z.object({ type: z.enum(["text", "textarea"]), text: z.string() }).strict(),
+    z
+        .object({
+        type: z.enum(["single_select", "multi_select"]),
+        selected: z.array(z.string()),
+        other_text: z.string().optional(),
+    })
+        .strict(),
+]);
+/** Requiredness is checked at navigation/submit; invalid supplied values fail even if optional. */
+export function normalizeFormAnswer(spec, raw, policy, requireComplete = false) {
+    const invalid = () => {
+        throw new QaFormError("INVALID_ANSWER", "Check the answer and its limits.");
+    };
+    if (raw === undefined || raw === null) {
+        if (requireComplete && spec?.required)
+            invalid();
+        return null;
+    }
+    if (spec === undefined)
+        return invalid();
+    const parsed = formAnswerParser.safeParse(raw);
+    if (!parsed.success || parsed.data.type !== spec.type)
+        return invalid();
+    const a = parsed.data;
+    if ("text" in a && (spec.type === "text" || spec.type === "textarea")) {
+        const text = a.text.trim(), length = Array.from(text).length;
+        if (length === 0) {
+            if (requireComplete && spec.required)
+                invalid();
+            return null;
+        }
+        if (length < (spec.min_length ?? 0) ||
+            length >
+                Math.min(spec.max_length ?? policy.maxTextLength, policy.maxTextLength))
+            return invalid();
+        return { type: a.type, text };
+    }
+    if (!("selected" in a) || !("options" in spec))
+        return invalid();
+    const other = a.other_text?.trim() ?? "";
+    if (other &&
+        (!spec.allow_other || Array.from(other).length > policy.maxTextLength))
+        return invalid();
+    if (new Set(a.selected).size !== a.selected.length ||
+        a.selected.some((v) => !spec.options.some((o) => o.value === v)))
+        return invalid();
+    const count = a.selected.length + (other ? 1 : 0);
+    if (count === 0) {
+        if (requireComplete && spec.required)
+            return invalid();
+        return null;
+    }
+    if (spec.type === "single_select"
+        ? count !== 1
+        : count < (spec.min_selected ?? 1) ||
+            count >
+                (spec.max_selected ??
+                    spec.options.length + (spec.allow_other ? 1 : 0)))
+        return invalid();
+    return {
+        type: a.type,
+        selected: a.selected,
+        ...(other ? { other_text: other } : {}),
+    };
+}
+export function validateForm(record, policy, stepId) {
+    const errors = [];
+    for (const step of record.schema.steps) {
+        if (stepId !== undefined && step.id !== stepId)
+            continue;
+        for (const item of step.items) {
+            const error = (component, code, message) => errors.push({
+                step_id: step.id,
+                item_id: item.id,
+                component,
+                code,
+                message,
+            });
+            try {
+                normalizeFormAnswer(item.answer, record.answers[item.id], policy, true);
+            }
+            catch {
+                error("answer", "ANSWER_INVALID", `Ответьте на вопрос «${item.title}» и проверьте ограничения.`);
+            }
+            const f = item.files, active = record.attachments[item.id] ?? [];
+            if (record.uploads.some((u) => u.item_id === item.id &&
+                ["pending", "uploading", "failed"].includes(u.state)))
+                error("files", "UPLOAD_UNRESOLVED", "Дождитесь загрузки, повторите её или уберите файл.");
+            if (f.requirement === "none") {
+                if (active.length)
+                    error("files", "FILES_NOT_ALLOWED", "Файлы для этого пункта запрещены.");
+            }
+            else {
+                if (active.length < (f.requirement === "required" ? f.min_count : 0))
+                    error("files", "REQUIRED_FILES_MISSING", `Приложите файлы к пункту «${item.title}».`);
+                if (active.length > f.max_count ||
+                    new Set(active.map((a) => a.sha256)).size !== active.length ||
+                    active.some((a) => a.size_bytes <= 0 ||
+                        a.size_bytes >
+                            Math.min(f.max_file_size_bytes, policy.maxFileSizeBytes) ||
+                        !f.accept.some((ext) => a.name.toLowerCase().endsWith(ext)) ||
+                        !policy.allowedExtensions.some((ext) => a.name.toLowerCase().endsWith(ext))))
+                    error("files", "FILES_INVALID", "Проверьте форматы, размеры и количество файлов.");
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validation.js.map

package/lib/forms/validation.js.map

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