@yadsh/dsh-qa-surface 0.17.0 → 0.19.0

package/lib/forms/schema.js.map

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

package/lib/forms/service.js

@@ -0,0 +1,220 @@
+import { createHash, randomUUID } from "node:crypto";
+import { z } from "zod";
+import { formAssert, QaFormError } from "./errors.js";
+import { parseFormSchema } from "./schema.js";
+import { formAnswerParser, normalizeFormAnswer, validateForm, } from "./validation.js";
+const mutation = {
+    form_id: z.string().min(1),
+    expected_revision: z.number().int().nonnegative(),
+    mutation_id: z.string().min(1).max(100),
+};
+const target = z
+    .object({ attachment_id: z.string(), version: z.number().int().positive() })
+    .strict();
+const commandParser = z.discriminatedUnion("action", [
+    z
+        .object({
+        ...mutation,
+        action: z.literal("save"),
+        answers: z.record(z.string(), z.union([formAnswerParser, z.null()])),
+        step: z.number().int().nonnegative(),
+    })
+        .strict(),
+    ...["submit", "pause"].map((action) => z.object({ ...mutation, action: z.literal(action) }).strict()),
+    z
+        .object({
+        ...mutation,
+        action: z.literal("begin_upload"),
+        item_id: z.string(),
+        name: z.string().min(1).max(240),
+        size_bytes: z.number().int().positive(),
+        target: target.optional(),
+    })
+        .strict(),
+    z
+        .object({
+        ...mutation,
+        action: z.literal("cancel_upload"),
+        upload_id: z.string(),
+    })
+        .strict(),
+    z
+        .object({
+        ...mutation,
+        action: z.literal("remove"),
+        item_id: z.string(),
+        attachment_id: z.string(),
+        version: z.number().int().positive(),
+    })
+        .strict(),
+]);
+export class QaFormService {
+    store;
+    policy;
+    ownerOf;
+    constructor(store, policy, ownerOf = (id) => id) {
+        this.store = store;
+        this.policy = policy;
+        this.ownerOf = ownerOf;
+    }
+    enabled() {
+        formAssert(this.policy().enabled, "INTERACTION_UNAVAILABLE", "Forms are disabled on this deployment.");
+    }
+    create(session, key, input) {
+        this.enabled();
+        formAssert(typeof key === "string" && /^[a-zA-Z0-9_-]{1,100}$/u.test(key), "INVALID_SCHEMA", "Provide a stable request_key.");
+        return this.store.create(session, key, parseFormSchema(input, this.policy()), this.ownerOf(session));
+    }
+    view(record, waiting = false) {
+        return {
+            ...record,
+            waiting,
+            field_errors: validateForm(record, this.policy()),
+        };
+    }
+    get(session, id) {
+        return this.store.get(session, id);
+    }
+    step(session, id, stepId, revision) {
+        const r = this.get(session, id);
+        formAssert(r.revision === revision, "REVISION_CONFLICT", "The form changed. Reload the saved draft.");
+        formAssert(r.schema.steps.some((s) => s.id === stepId), "INVALID_REQUEST", "Unknown form step.");
+        const errors = validateForm(r, this.policy(), stepId);
+        if (errors.length)
+            throw new QaFormError("FORM_INCOMPLETE", "Заполните обязательные пункты шага.", r.revision, errors);
+    }
+    command(session, raw) {
+        this.enabled();
+        const parsed = commandParser.safeParse(raw);
+        formAssert(parsed.success, "INVALID_REQUEST", "Unsupported form mutation.");
+        const c = parsed.data;
+        const existing = this.get(session, c.form_id);
+        // New submit retries may use a fresh key, but cannot create a second snapshot.
+        if (c.action === "submit" && existing.status === "submitted") {
+            return (this.store.replayedMutation(c.form_id, c.mutation_id, c) ?? existing);
+        }
+        return this.store.mutate(session, c.form_id, c.expected_revision, c.mutation_id, c, (r) => {
+            parseFormSchema(r.schema, this.policy());
+            if (c.action === "save") {
+                const items = r.schema.steps.flatMap((s) => s.items);
+                for (const [id, value] of Object.entries(c.answers)) {
+                    const item = items.find((i) => i.id === id);
+                    formAssert(item?.answer !== undefined, "INVALID_ANSWER", "Unknown answer field.");
+                    r.answers[id] = normalizeFormAnswer(item.answer, value, this.policy());
+                }
+                formAssert(Buffer.byteLength(JSON.stringify(r.answers)) <=
+                    this.policy().maxTotalAnswerBytes, "QUOTA_EXCEEDED", "The answers exceed the form limit.");
+                formAssert(c.step <= r.schema.steps.length, "INVALID_REQUEST", "Unknown form step.");
+                if (c.step > r.step) {
+                    const preceding = new Set(r.schema.steps.slice(0, c.step).map((s) => s.id));
+                    const errors = validateForm(r, this.policy()).filter((e) => preceding.has(e.step_id));
+                    if (errors.length)
+                        throw new QaFormError("FORM_INCOMPLETE", "Заполните обязательные пункты шага.", r.revision, errors);
+                }
+                r.step = c.step;
+            }
+            else if (c.action === "begin_upload")
+                this.beginUpload(r, c);
+            else if (c.action === "cancel_upload") {
+                const upload = r.uploads.find((u) => u.id === c.upload_id);
+                formAssert(upload && upload.state !== "ready", "INVALID_REQUEST", "This upload cannot be cancelled.");
+                upload.state = "cancelled";
+            }
+            else if (c.action === "remove") {
+                const active = r.attachments[c.item_id] ?? [];
+                formAssert(active.some((a) => a.attachment_id === c.attachment_id && a.version === c.version), "ATTACHMENT_VERSION_CONFLICT", "The attachment version changed.");
+                r.attachments[c.item_id] = active.filter((a) => a.attachment_id !== c.attachment_id);
+                for (const u of r.uploads)
+                    if (u.target?.attachment_id === c.attachment_id &&
+                        u.state !== "ready")
+                        u.state = "cancelled";
+            }
+            else if (c.action === "submit") {
+                formAssert(Object.values(r.attachments)
+                    .flat()
+                    .reduce((n, a) => n + a.size_bytes, 0) <=
+                    this.policy().maxTotalFileBytesPerForm &&
+                    Buffer.byteLength(JSON.stringify(r.answers)) <=
+                        this.policy().maxTotalAnswerBytes, "QUOTA_EXCEEDED", "The saved form exceeds the current policy. Reduce the draft before submitting.");
+                const errors = validateForm(r, this.policy());
+                if (errors.length)
+                    throw new QaFormError("FORM_INCOMPLETE", "Заполните обязательные пункты формы.", r.revision, errors);
+                const items = r.schema.steps.flatMap((s) => s.items.map((i) => ({
+                    step_id: s.id,
+                    item_id: i.id,
+                    answer: normalizeFormAnswer(i.answer, r.answers[i.id], this.policy(), true),
+                    files: r.attachments[i.id] ?? [],
+                })));
+                // Validate durable ownership/readability from server resources, never client counters.
+                for (const item of items)
+                    for (const file of item.files) {
+                        const data = this.store.resource(r.id, file.resource_id);
+                        formAssert(data.byteLength === file.size_bytes &&
+                            createHash("sha256").update(data).digest("hex") ===
+                                file.sha256, "FILE_UNAVAILABLE", "A saved file failed its integrity check.");
+                    }
+                r.status = "submitted";
+                r.submission = {
+                    status: "submitted",
+                    form_id: r.id,
+                    submission_id: randomUUID(),
+                    schema_version: 1,
+                    schema_hash: r.schema_hash,
+                    form_revision: r.revision + 1,
+                    submitted_at: new Date().toISOString(),
+                    items,
+                    empty_optional_item_ids: items
+                        .filter((i) => i.answer === null && i.files.length === 0)
+                        .map((i) => i.item_id),
+                };
+            }
+        });
+    }
+    beginUpload(r, c) {
+        const item = r.schema.steps
+            .flatMap((s) => s.items)
+            .find((i) => i.id === c.item_id);
+        formAssert(item && item.files.requirement !== "none", "FILE_TYPE_NOT_ALLOWED", "Files are not allowed for this item.");
+        const f = item.files, active = r.attachments[item.id] ?? [];
+        formAssert(!/[\\/]/u.test(c.name) &&
+            Array.from(c.name).every((ch) => (ch.codePointAt(0) ?? 0) > 31 && ch.codePointAt(0) !== 127) &&
+            f.accept.some((ext) => c.name.toLowerCase().endsWith(ext)), "FILE_TYPE_NOT_ALLOWED", "Choose an allowed file format.");
+        formAssert(c.size_bytes <=
+            Math.min(f.max_file_size_bytes, this.policy().maxFileSizeBytes), "FILE_TOO_LARGE", "The file exceeds the size limit.");
+        const pending = r.uploads.filter((u) => ["pending", "uploading"].includes(u.state));
+        formAssert(pending.length < this.policy().maxConcurrentUploadsPerSession, "QUOTA_EXCEEDED", "Wait for another upload to finish.");
+        if (c.target) {
+            formAssert(active.some((a) => a.attachment_id === c.target?.attachment_id &&
+                a.version === c.target.version), "ATTACHMENT_VERSION_CONFLICT", "The attachment version changed.");
+            formAssert(!pending.some((u) => u.target?.attachment_id === c.target?.attachment_id), "UPLOAD_IN_PROGRESS", "This file is already being replaced.");
+        }
+        else
+            formAssert(active.length +
+                pending.filter((u) => u.item_id === item.id && !u.target).length <
+                f.max_count, "QUOTA_EXCEEDED", "The item already has its maximum number of files.");
+        const bytes = Object.values(r.attachments)
+            .flat()
+            .reduce((sum, a) => sum + a.size_bytes, 0);
+        formAssert(bytes +
+            pending.reduce((sum, u) => sum + u.size_bytes, 0) +
+            c.size_bytes <=
+            this.policy().maxTotalFileBytesPerForm, "QUOTA_EXCEEDED", "The form file quota is exhausted.");
+        formAssert(this.store.storedBytes(r.session_id) +
+            pending.reduce((sum, u) => sum + u.size_bytes, 0) +
+            c.size_bytes <=
+            this.policy().maxTotalFileBytesPerForm * 2, "QUOTA_EXCEEDED", "The chat's retained file quota is exhausted.");
+        formAssert(this.store.identityReservedBytes(r.creator_id) + c.size_bytes <=
+            this.policy().maxTotalFileBytesPerForm * 2, "QUOTA_EXCEEDED", "The account's retained file quota is exhausted.");
+        const upload = {
+            id: randomUUID(),
+            item_id: item.id,
+            name: c.name,
+            size_bytes: c.size_bytes,
+            state: "pending",
+            expires_at: Date.now() + this.policy().uploadIntentTtlSeconds * 1000,
+            ...(c.target ? { target: c.target } : {}),
+        };
+        r.uploads.push(upload);
+    }
+}
+//# sourceMappingURL=service.js.map

package/lib/forms/service.js.map

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

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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"}