@yadsh/dsh-qa-surface 0.17.0 → 0.18.0

package/lib/forms/errors.js

@@ -0,0 +1,37 @@
+export class QaFormError extends Error {
+    code;
+    revision;
+    fields;
+    constructor(code, message, revision, fields) {
+        super(message);
+        this.code = code;
+        this.revision = revision;
+        this.fields = fields;
+    }
+}
+/** Deliberately redact unexpected storage/Host exceptions at the wire boundary. */
+export function formFailure(error) {
+    return {
+        ok: false,
+        error: error instanceof QaFormError
+            ? {
+                code: error.code,
+                message: error.message,
+                ...(error.revision === undefined
+                    ? {}
+                    : { form_revision: error.revision }),
+                ...(error.fields === undefined
+                    ? {}
+                    : { field_errors: error.fields }),
+            }
+            : {
+                code: "STORAGE_UNAVAILABLE",
+                message: "Form storage is unavailable. Retry without discarding your draft.",
+            },
+    };
+}
+export function formAssert(condition, code, message) {
+    if (!condition)
+        throw new QaFormError(code, message);
+}
+//# sourceMappingURL=errors.js.map

package/lib/forms/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/forms/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAEzB,IAAI;IAEJ,QAAQ;IACR,MAAM;IAJjB,YACW,IAAY,EACrB,OAAe,EACN,QAAiB,EACjB,MAA2B;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;oBALN,IAAI;wBAEJ,QAAQ;sBACR,MAAM;IAGjB,CAAC;CACF;AACD,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EACH,KAAK,YAAY,WAAW;YAC1B,CAAC,CAAC;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS;oBAC9B,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACtC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;oBAC5B,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;aACpC;YACH,CAAC,CAAC;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EACL,mEAAmE;aACtE;KACR,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,UAAU,CACxB,SAAkB,EAClB,IAAY,EACZ,OAAe;IAEf,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/lib/forms/fingerprint.js

@@ -0,0 +1,21 @@
+import { createHash } from "node:crypto";
+/**
+ * Stable object-key ordering for schema and idempotency fingerprints.
+ *
+ * Lives apart from the sqlite store so every store implementation hashes the
+ * same way without importing the sqlite bridge: the client test graph mounts a
+ * store too, and a browser environment must not see `@yadsh/dsh-plugin-kit/sqlite`.
+ */
+export function fingerprint(value) {
+    const canonical = (v) => Array.isArray(v)
+        ? v.map(canonical)
+        : v !== null && typeof v === "object"
+            ? Object.fromEntries(Object.entries(v)
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([k, x]) => [k, canonical(x)]))
+            : v;
+    return `sha256:${createHash("sha256")
+        .update(JSON.stringify(canonical(value)))
+        .digest("hex")}`;
+}
+//# sourceMappingURL=fingerprint.js.map

package/lib/forms/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/forms/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,SAAS,GAAG,CAAC,CAAU,EAAW,EAAE,CACxC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACd,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;QAClB,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;YACnC,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;iBACd,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;iBACtC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CACtC;YACH,CAAC,CAAC,CAAC,CAAC;IACV,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC;SAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;SACxC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACrB,CAAC"}

package/lib/forms/gate.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { formAssert, QaFormError } from "./errors.js";
+import { parseFormSchema } from "./schema.js";
+const argsParser = z.discriminatedUnion("action", [
+    z
+        .object({
+        action: z.literal("create"),
+        request_key: z.string(),
+        form: z.unknown(),
+    })
+        .strict(),
+    z.object({ action: z.literal("resume"), form_id: z.string() }).strict(),
+]);
+/** A parked tool call is transient. Never reconstruct one from a saved draft. */
+export class QaFormGate {
+    service;
+    rootOf;
+    busy;
+    allowed;
+    filesAvailable;
+    waiters = new Map();
+    disposers = [];
+    closed = false;
+    clients = new Map();
+    constructor(service, rootOf, busy, allowed, filesAvailable = () => false) {
+        this.service = service;
+        this.rootOf = rootOf;
+        this.busy = busy;
+        this.allowed = allowed;
+        this.filesAvailable = filesAvailable;
+    }
+    install(ctx) {
+        this.disposers.push(ctx.on("agent/disposed", ({ agent }) => this.cancel(String(agent.session.id))), ctx.on("agent/status", ({ agent, status }) => {
+            if (status === "idle")
+                this.cancel(String(agent.session.id));
+        }));
+    }
+    waiting(id) {
+        return this.waiters.has(id);
+    }
+    touch(session) {
+        this.clients.set(session, Date.now());
+    }
+    hasSession(session) {
+        return [...this.waiters.values()].some((w) => w.session === session);
+    }
+    async request(raw, exec) {
+        const parsed = argsParser.safeParse(raw);
+        formAssert(parsed.success, "INVALID_SCHEMA", "Provide create with a schema, or resume with a form_id.");
+        exec.signal.throwIfAborted();
+        formAssert(!this.closed && this.allowed(exec), "INTERACTION_UNAVAILABLE", "An interactive QA form is unavailable for this request.");
+        const agentId = exec.agent === undefined ? "" : String(exec.agent.session.id), session = this.rootOf(agentId);
+        formAssert(session &&
+            session === agentId &&
+            exec.agent?.session.header.origin !== "subagent", "ACCESS_DENIED", "Only the main agent of an admitted QA chat can request a form. Ask the main agent to collect the input.");
+        const service = this.service();
+        service.enabled();
+        formAssert(Date.now() - (this.clients.get(session) ?? 0) < 30000, "INTERACTION_UNAVAILABLE", "Open this chat in the QA interface before requesting a form.");
+        const args = parsed.data;
+        formAssert(!this.hasSession(session) && !this.busy(session), "INTERACTION_BUSY", "Finish the current interactive request before opening this form.");
+        if (args.action === "create" && !this.filesAvailable()) {
+            const schema = parseFormSchema(args.form, service.policy());
+            formAssert(schema.steps.every((s) => s.items.every((i) => i.files.requirement === "none")), "INTERACTION_UNAVAILABLE", "This deployment has no authenticated form-file upload and reader pipeline.");
+        }
+        const r = args.action === "create"
+            ? service.create(session, args.request_key, args.form)
+            : service.get(session, args.form_id);
+        formAssert(this.filesAvailable() ||
+            r.schema.steps.every((s) => s.items.every((i) => i.files.requirement === "none")), "INTERACTION_UNAVAILABLE", "This deployment has no authenticated form-file upload and reader pipeline.");
+        service.store.editableOrSubmitted(r);
+        if (r.submission)
+            return r.submission;
+        formAssert(!this.waiters.has(r.id) &&
+            !this.hasSession(session) &&
+            !this.busy(session), "INTERACTION_BUSY", "Finish the current interactive request before opening this form.");
+        return new Promise((resolve, reject) => {
+            const abort = () => finish();
+            const finish = (outcome) => {
+                if (!this.waiters.delete(r.id))
+                    return;
+                exec.signal.removeEventListener("abort", abort);
+                if (outcome === undefined)
+                    reject(exec.signal.aborted
+                        ? exec.signal.reason
+                        : new QaFormError("INTERACTION_CANCELLED", "Form collection stopped. The draft remains available for resume."));
+                else if (!this.allowed(exec))
+                    reject(new QaFormError("ACCESS_DENIED", "Form access is no longer available."));
+                else
+                    resolve(outcome);
+            };
+            this.waiters.set(r.id, { session, call: String(exec.callId), finish });
+            exec.signal.addEventListener("abort", abort, { once: true });
+            if (exec.signal.aborted)
+                abort();
+        });
+    }
+    notify(record, pause = false) {
+        const waiter = this.waiters.get(record.id);
+        if (record.submission)
+            waiter?.finish(record.submission);
+        else if (pause)
+            waiter?.finish({
+                status: "paused",
+                form_id: record.id,
+                reason: "Draft saved. Resume this form; collection is not complete.",
+            });
+    }
+    cancel(session) {
+        for (const w of [...this.waiters.values()])
+            if (w.session === session)
+                w.finish();
+    }
+    cancelAll() {
+        for (const w of [...this.waiters.values()])
+            w.finish();
+    }
+    dispose() {
+        this.closed = true;
+        for (const w of [...this.waiters.values()])
+            w.finish();
+        for (const d of this.disposers.splice(0))
+            d();
+    }
+}
+//# sourceMappingURL=gate.js.map

package/lib/forms/gate.js.map

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

package/lib/forms/schema.js

@@ -0,0 +1,182 @@
+import { z } from "zod";
+import { formAssert, QaFormError } from "./errors.js";
+export const DEFAULT_FORM_POLICY = Object.freeze({
+    enabled: false,
+    maxSteps: 20,
+    maxItemsPerForm: 100,
+    maxOptionsPerItem: 50,
+    maxSchemaBytes: 131072,
+    maxTextLength: 10000,
+    maxTotalAnswerBytes: 32768,
+    maxFilesPerItem: 10,
+    maxFileSizeBytes: 52428800,
+    maxTotalFileBytesPerForm: 262144000,
+    maxConcurrentUploadsPerSession: 2,
+    uploadIntentTtlSeconds: 900,
+    allowedExtensions: Object.freeze([
+        ".pdf",
+        ".docx",
+        ".xlsx",
+        ".csv",
+        ".txt",
+        ".png",
+        ".jpg",
+        ".jpeg",
+    ]),
+});
+const id = z
+    .string()
+    .regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,79}$/u)
+    .refine((v) => !["constructor", "prototype", "__proto__"].includes(v));
+const label = z.string().trim().min(1).max(2000);
+const integer = z.number().int().nonnegative();
+const option = z
+    .object({
+    value: id,
+    label,
+    description: label.optional(),
+    recommended: z.boolean().optional(),
+})
+    .strict();
+const answer = z.discriminatedUnion("type", [
+    z
+        .object({
+        type: z.literal("text"),
+        required: z.boolean(),
+        placeholder: label.optional(),
+        min_length: integer.optional(),
+        max_length: integer.positive().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("textarea"),
+        required: z.boolean(),
+        placeholder: label.optional(),
+        min_length: integer.optional(),
+        max_length: integer.positive().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("single_select"),
+        required: z.boolean(),
+        options: z.array(option).min(1),
+        allow_other: z.boolean().optional(),
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("multi_select"),
+        required: z.boolean(),
+        options: z.array(option).min(1),
+        allow_other: z.boolean().optional(),
+        min_selected: integer.optional(),
+        max_selected: integer.positive().optional(),
+    })
+        .strict(),
+]);
+const fileFields = {
+    max_count: integer.positive(),
+    accept: z.array(z.string().regex(/^\.[a-z0-9]+$/u)).min(1),
+    max_file_size_bytes: integer.positive(),
+};
+const files = z.discriminatedUnion("requirement", [
+    z.object({ requirement: z.literal("none") }).strict(),
+    z
+        .object({
+        requirement: z.literal("required"),
+        min_count: integer.positive(),
+        ...fileFields,
+    })
+        .strict(),
+    z.object({ requirement: z.literal("optional"), ...fileFields }).strict(),
+]);
+export const formSchemaParser = z
+    .object({
+    schema_version: z.literal(1),
+    title: label,
+    description: label.optional(),
+    submit_label: label.optional(),
+    steps: z
+        .array(z
+        .object({
+        id,
+        title: label,
+        description: label.optional(),
+        items: z
+            .array(z
+            .object({
+            id,
+            title: label,
+            description: label.optional(),
+            answer: answer.optional(),
+            files,
+        })
+            .strict())
+            .min(1),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+/** Shared by server and browser. No Node APIs or browser-supplied readiness. */
+export function parseFormSchema(input, policy) {
+    const parsed = formSchemaParser.safeParse(input);
+    if (!parsed.success)
+        throw new QaFormError("INVALID_SCHEMA", "The form schema is invalid; provide explicit requirements and supported fields.");
+    const schema = parsed.data;
+    const check = (ok) => formAssert(ok, "INVALID_SCHEMA", "The form schema exceeds policy or contains conflicting requirements.");
+    check(new TextEncoder().encode(JSON.stringify(schema)).length <=
+        policy.maxSchemaBytes);
+    check(schema.steps.length <= policy.maxSteps);
+    const stepIds = new Set(), itemIds = new Set();
+    for (const step of schema.steps) {
+        check(!stepIds.has(step.id));
+        stepIds.add(step.id);
+        for (const item of step.items) {
+            check(!itemIds.has(item.id));
+            itemIds.add(item.id);
+            check(item.answer !== undefined || item.files.requirement !== "none");
+            const a = item.answer;
+            if (a?.type === "text" || a?.type === "textarea") {
+                check((a.max_length ?? policy.maxTextLength) <= policy.maxTextLength);
+                check((a.min_length ?? 0) <= (a.max_length ?? policy.maxTextLength));
+            }
+            else if (a !== undefined) {
+                check(a.options.length <= policy.maxOptionsPerItem);
+                check(new Set(a.options.map((o) => o.value)).size === a.options.length);
+                if (a.type === "multi_select") {
+                    const maximum = a.max_selected ?? a.options.length + (a.allow_other ? 1 : 0);
+                    check((a.min_selected ?? 0) <= maximum &&
+                        maximum <= a.options.length + (a.allow_other ? 1 : 0));
+                }
+            }
+            const f = item.files;
+            if (f.requirement !== "none") {
+                check(f.max_count <= policy.maxFilesPerItem &&
+                    f.max_file_size_bytes <= policy.maxFileSizeBytes);
+                check(f.accept.every((ext) => policy.allowedExtensions.includes(ext)) &&
+                    new Set(f.accept).size === f.accept.length);
+                if (f.requirement === "required")
+                    check(f.min_count <= f.max_count);
+            }
+        }
+    }
+    check(itemIds.size <= policy.maxItemsPerForm);
+    return schema;
+}
+export function resolveFormPolicy(input = {}) {
+    const policy = { ...DEFAULT_FORM_POLICY, ...input };
+    for (const [key, value] of Object.entries(policy)) {
+        if (key === "enabled" || key === "allowedExtensions")
+            continue;
+        formAssert(typeof value === "number" && Number.isSafeInteger(value) && value > 0, "INVALID_SCHEMA", `forms.${key} must be a positive integer.`);
+    }
+    formAssert(typeof policy.enabled === "boolean" &&
+        Array.isArray(policy.allowedExtensions) &&
+        policy.allowedExtensions.length > 0 &&
+        policy.allowedExtensions.every((ext) => DEFAULT_FORM_POLICY.allowedExtensions.includes(ext)), "INVALID_SCHEMA", "Unsupported form file policy.");
+    return policy;
+}
+//# sourceMappingURL=schema.js.map

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