@cogenta/forms 0.2.4

package/dist/validate.js

@@ -0,0 +1,353 @@
+import { CogentaError } from '@cogenta/core';
+import { isFieldVisible } from './conditions.js';
+import { FORM_CONDITION_OPERATORS, FORM_FILE_CATEGORIES, isFormFileValue, } from './types.js';
+/**
+ * Full server-side validation, independent of whatever the client did or
+ * did not check (fiche 16 task 3's own requirement, and the same standard
+ * `@cogenta/commerce`'s stores hold their own writes to). Never trusts a
+ * shape the browser sent: a `choiceMulti` answer for a field it does not
+ * know, a `consent` box the definition never declared, or a value that
+ * arrived as an object are all rejected here, the same way whether the
+ * caller was a browser form post or a JSON API client.
+ */
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/u;
+// Loose on purpose: a phone number is free text almost everywhere in the
+// world (extensions, country codes, spaces) — this rejects control
+// characters and enforces a sane length, not a dial plan.
+const PHONE_RE = /^[+()0-9 .-]{3,32}$/u;
+const MAX_TEXT_LENGTH = 2_000;
+const MAX_LONG_TEXT_LENGTH = 20_000;
+function invalid(field, reason) {
+    return new CogentaError({
+        code: 'FORM_SUBMISSION_INVALID',
+        message: `"${field}" ${reason}.`,
+        hint: 'Check the value sent for this field and try again.',
+        details: { field },
+    });
+}
+function readRawString(raw, field) {
+    if (typeof raw === 'string')
+        return raw.trim();
+    if (Array.isArray(raw) && raw.length === 1 && typeof raw[0] === 'string')
+        return raw[0].trim();
+    throw invalid(field.name, 'must be a single text value');
+}
+function readRawList(raw, field) {
+    if (typeof raw === 'string')
+        return raw.trim() === '' ? [] : [raw.trim()];
+    if (Array.isArray(raw)) {
+        return raw.map((entry) => {
+            if (typeof entry !== 'string')
+                throw invalid(field.name, 'must be a list of text values');
+            return entry.trim();
+        });
+    }
+    throw invalid(field.name, 'must be a list of text values');
+}
+function validateField(field, raw, now) {
+    const present = raw !== undefined &&
+        raw !== null &&
+        !(typeof raw === 'string' && raw.trim() === '') &&
+        !(Array.isArray(raw) && raw.length === 0);
+    if (!present) {
+        if (field.required)
+            throw invalid(field.name, 'is required');
+        return { value: undefined };
+    }
+    switch (field.kind) {
+        case 'text': {
+            const value = readRawString(raw, field);
+            if (value.length > MAX_TEXT_LENGTH)
+                throw invalid(field.name, `must be at most ${MAX_TEXT_LENGTH} characters`);
+            return { value };
+        }
+        case 'longText': {
+            const value = readRawString(raw, field);
+            if (value.length > MAX_LONG_TEXT_LENGTH) {
+                throw invalid(field.name, `must be at most ${MAX_LONG_TEXT_LENGTH} characters`);
+            }
+            return { value };
+        }
+        case 'email': {
+            const value = readRawString(raw, field).toLowerCase();
+            if (!EMAIL_RE.test(value))
+                throw invalid(field.name, 'must be a valid e-mail address');
+            return { value };
+        }
+        case 'phone': {
+            const value = readRawString(raw, field);
+            if (!PHONE_RE.test(value))
+                throw invalid(field.name, 'must be a valid phone number');
+            return { value };
+        }
+        case 'number': {
+            const text = readRawString(raw, field);
+            const value = Number(text);
+            if (!Number.isFinite(value))
+                throw invalid(field.name, 'must be a number');
+            return { value: String(value) };
+        }
+        case 'date': {
+            const value = readRawString(raw, field);
+            if (Number.isNaN(new Date(value).getTime()))
+                throw invalid(field.name, 'must be a valid date');
+            return { value };
+        }
+        case 'choiceSingle': {
+            const value = readRawString(raw, field);
+            const choices = field.choices ?? [];
+            if (!choices.includes(value))
+                throw invalid(field.name, 'must be one of the offered choices');
+            return { value };
+        }
+        case 'choiceMulti': {
+            const values = readRawList(raw, field);
+            const choices = field.choices ?? [];
+            for (const value of values) {
+                if (!choices.includes(value))
+                    throw invalid(field.name, 'must only contain offered choices');
+            }
+            return { value: values };
+        }
+        case 'file': {
+            // The router (`@cogenta/api`'s `forms-router.ts`) is the only layer
+            // that ever sees raw bytes — it resolves an uploaded multipart file
+            // (or a JSON-carried value from an earlier multi-step page) into a
+            // `FormFileValue` *before* calling this function. This package never
+            // touches a `StorageDriver`, so all it can check here is the shape.
+            if (!isFormFileValue(raw)) {
+                throw invalid(field.name, 'must be a file already uploaded to this field');
+            }
+            return { value: raw };
+        }
+        case 'consent': {
+            const value = readRawString(raw, field);
+            const agreed = value === 'true' || value === 'on' || value === '1' || value === 'yes';
+            if (!agreed) {
+                throw new CogentaError({
+                    code: 'FORM_CONSENT_REQUIRED',
+                    message: `Consent for "${field.name}" is required to submit this form.`,
+                    hint: 'Tick the consent checkbox before submitting.',
+                    details: { field: field.name },
+                });
+            }
+            return {
+                value: 'true',
+                consent: {
+                    fieldName: field.name,
+                    // The wording as it stands *right now*, recorded verbatim onto the
+                    // submission — this is what has probative value, per ADR-0026 and
+                    // the fiche's own reminder: "le texte au moment du recueil compte,
+                    // pas celui d'aujourd'hui".
+                    text: field.consentText ?? field.label,
+                    agreedAt: new Date(now()).toISOString(),
+                },
+            };
+        }
+        default: {
+            const exhaustive = field.kind;
+            throw invalid(field.name, `has an unknown field kind ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Validates a raw submission body against a form's own definition. Rejects
+ * any key the definition does not declare — a client cannot smuggle an
+ * extra column into what gets stored.
+ */
+export function validateSubmission(definition, rawValues, now = Date.now) {
+    if (!definition.active) {
+        throw new CogentaError({
+            code: 'FORM_DISABLED',
+            message: `The form "${definition.name}" is not accepting submissions.`,
+            hint: 'This form has been switched off by its owner.',
+        });
+    }
+    const known = new Set(definition.fields.map((field) => field.name));
+    for (const key of Object.keys(rawValues)) {
+        if (key.startsWith('_'))
+            continue; // anti-abuse fields (honeypot, timestamp) — never stored as an answer.
+        if (!known.has(key))
+            throw invalid(key, 'is not a field on this form');
+    }
+    const values = {};
+    const consents = [];
+    for (const field of definition.fields) {
+        // Fiche 47 task 1: a field masked by an unmet `showIf` is neither
+        // required nor validated — whatever was submitted under its name (if
+        // anything) is silently discarded, never stored. Evaluated against the
+        // *raw* submission, so it works identically with or without JavaScript
+        // having toggled anything on screen.
+        if (!isFieldVisible(field, rawValues))
+            continue;
+        const outcome = validateField(field, rawValues[field.name], now);
+        if (outcome.value !== undefined)
+            values[field.name] = outcome.value;
+        if (outcome.consent !== undefined)
+            consents.push(outcome.consent);
+    }
+    return { values, consents };
+}
+/** A definition's own fields must be internally consistent — checked once, at create/update time. */
+export function validateDefinitionFields(fields) {
+    if (fields.length === 0) {
+        throw new CogentaError({
+            code: 'FORM_DEFINITION_INVALID',
+            message: 'A form needs at least one field.',
+            hint: 'Add at least one field before saving.',
+        });
+    }
+    const seen = new Set();
+    for (const field of fields) {
+        if (field.name.trim() === '' || !/^[a-zA-Z][a-zA-Z0-9_]*$/u.test(field.name)) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.name}" is not a valid field name.`,
+                hint: 'Field names start with a letter and contain only letters, digits and underscores.',
+            });
+        }
+        if (seen.has(field.name)) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `Field name "${field.name}" is used more than once.`,
+                hint: 'Every field needs a unique name.',
+            });
+        }
+        seen.add(field.name);
+        if ((field.kind === 'choiceSingle' || field.kind === 'choiceMulti') &&
+            (field.choices ?? []).length === 0) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.name}" needs at least one choice.`,
+                hint: 'Add at least one choice for this field.',
+            });
+        }
+        if (field.kind === 'consent' && (field.consentText ?? '').trim() === '') {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.name}" needs its consent wording.`,
+                hint: 'A consent field must carry the exact text shown to whoever ticks it — this is what has probative value later.',
+            });
+        }
+        if (field.kind === 'file' && field.acceptCategories !== undefined) {
+            for (const category of field.acceptCategories) {
+                if (!FORM_FILE_CATEGORIES.includes(category)) {
+                    throw new CogentaError({
+                        code: 'FORM_DEFINITION_INVALID',
+                        message: `"${category}" is not a file category.`,
+                        hint: `Use one of: ${FORM_FILE_CATEGORIES.join(', ')}.`,
+                    });
+                }
+            }
+        }
+        if (field.kind === 'file' && field.maxSizeBytes !== undefined && field.maxSizeBytes <= 0) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.name}" needs a positive maximum file size.`,
+                hint: 'Set maxSizeBytes to a positive number of bytes, or omit it to use the default.',
+            });
+        }
+    }
+    // A second pass for `showIf`: every field name has to be known before a
+    // condition can be checked against one, which is why this is not folded
+    // into the loop above.
+    for (const field of fields) {
+        if (field.showIf === undefined)
+            continue;
+        if (!FORM_CONDITION_OPERATORS.includes(field.showIf.operator)) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.showIf.operator}" is not a condition operator.`,
+                hint: `Use one of: ${FORM_CONDITION_OPERATORS.join(', ')}.`,
+            });
+        }
+        if (field.showIf.field === field.name) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.name}" cannot depend on its own value.`,
+                hint: 'A showIf condition must name a different field.',
+            });
+        }
+        if (!seen.has(field.showIf.field)) {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: `"${field.name}"'s condition names an unknown field "${field.showIf.field}".`,
+                hint: 'showIf.field must be the name of another field on this form.',
+            });
+        }
+    }
+}
+/** Task 2 — every field must belong to exactly one step when a form declares any. Absent/empty `steps` means single-page, unchecked here. */
+export function validateFormSteps(fields, steps) {
+    if (steps.length === 0)
+        return;
+    const fieldNames = new Set(fields.map((field) => field.name));
+    const assigned = new Set();
+    for (const step of steps) {
+        if (step.name.trim() === '') {
+            throw new CogentaError({
+                code: 'FORM_STEP_INVALID',
+                message: 'Every step needs a name.',
+                hint: 'Give each step a short, stable identifier.',
+            });
+        }
+        if (step.fieldNames.length === 0) {
+            throw new CogentaError({
+                code: 'FORM_STEP_INVALID',
+                message: `Step "${step.name}" has no fields.`,
+                hint: 'Every step must show at least one field.',
+            });
+        }
+        for (const name of step.fieldNames) {
+            if (!fieldNames.has(name)) {
+                throw new CogentaError({
+                    code: 'FORM_STEP_INVALID',
+                    message: `Step "${step.name}" names an unknown field "${name}".`,
+                    hint: 'Every step field must be a real field on this form.',
+                });
+            }
+            if (assigned.has(name)) {
+                throw new CogentaError({
+                    code: 'FORM_STEP_INVALID',
+                    message: `"${name}" is assigned to more than one step.`,
+                    hint: 'Every field belongs to exactly one step.',
+                });
+            }
+            assigned.add(name);
+        }
+    }
+    for (const name of fieldNames) {
+        if (!assigned.has(name)) {
+            throw new CogentaError({
+                code: 'FORM_STEP_INVALID',
+                message: `"${name}" is not assigned to any step.`,
+                hint: 'Every field must belong to exactly one step once a form declares steps.',
+            });
+        }
+    }
+}
+/** Task 4 — a channel/target pair must at least be non-empty text; `@cogenta/api`'s router is what actually knows whether `channel` names a configured adapter. */
+export function validateNotifyChannels(channels) {
+    for (const entry of channels) {
+        if (entry.channel.trim() === '' || entry.target.trim() === '') {
+            throw new CogentaError({
+                code: 'FORM_DEFINITION_INVALID',
+                message: 'Every notification channel needs both a channel name and a target.',
+                hint: 'Set both "channel" (e.g. "slack") and "target" (that channel’s own destination id).',
+            });
+        }
+    }
+}
+/** Task 10 — enabling the CAPTCHA without both keys is a misconfiguration caught at save time, not at the first anonymous submission. */
+export function validateCaptchaConfig(captcha) {
+    if (!captcha.enabled)
+        return;
+    if ((captcha.siteKey ?? '').trim() === '' || (captcha.secretKey ?? '').trim() === '') {
+        throw new CogentaError({
+            code: 'FORM_DEFINITION_INVALID',
+            message: 'Enabling the CAPTCHA requires both a site key and a secret key.',
+            hint: 'Get a Turnstile site key and secret key, or leave the CAPTCHA disabled.',
+        });
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EAOpB,eAAe,GAEhB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;GAQG;AAEH,MAAM,QAAQ,GAAG,6BAA6B,CAAA;AAC9C,yEAAyE;AACzE,mEAAmE;AACnE,0DAA0D;AAC1D,MAAM,QAAQ,GAAG,sBAAsB,CAAA;AACvC,MAAM,eAAe,GAAG,KAAK,CAAA;AAC7B,MAAM,oBAAoB,GAAG,MAAM,CAAA;AAOnC,SAAS,OAAO,CAAC,KAAa,EAAE,MAAc;IAC5C,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,IAAI,KAAK,KAAK,MAAM,GAAG;QAChC,IAAI,EAAE,oDAAoD;QAC1D,OAAO,EAAE,EAAE,KAAK,EAAE;KACnB,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAY,EAAE,KAA0B;IAC7D,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAA;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9F,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,KAA0B;IAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IACzE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAA;YACzF,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,aAAa,CACpB,KAA0B,EAC1B,GAAY,EACZ,GAAiB;IAKjB,MAAM,OAAO,GACX,GAAG,KAAK,SAAS;QACjB,GAAG,KAAK,IAAI;QACZ,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAA;IAE3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,KAAK,CAAC,QAAQ;YAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC5D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;IAC7B,CAAC;IAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvC,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe;gBAChC,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,eAAe,aAAa,CAAC,CAAA;YAC5E,OAAO,EAAE,KAAK,EAAE,CAAA;QAClB,CAAC;QACD,KAAK,UAAU,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvC,IAAI,KAAK,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;gBACxC,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,oBAAoB,aAAa,CAAC,CAAA;YACjF,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,CAAA;QAClB,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;YACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAA;YACtF,OAAO,EAAE,KAAK,EAAE,CAAA;QAClB,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAA;YACpF,OAAO,EAAE,KAAK,EAAE,CAAA;QAClB,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACtC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;YAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;QACjC,CAAC;QACD,KAAK,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAA;YAC9F,OAAO,EAAE,KAAK,EAAE,CAAA;QAClB,CAAC;QACD,KAAK,cAAc,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAA;YACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAAA;YAC7F,OAAO,EAAE,KAAK,EAAE,CAAA;QAClB,CAAC;QACD,KAAK,aAAa,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAA;YACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAAA;YAC9F,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;QAC1B,CAAC;QACD,KAAK,MAAM,EAAE,CAAC;YACZ,oEAAoE;YACpE,oEAAoE;YACpE,mEAAmE;YACnE,qEAAqE;YACrE,oEAAoE;YACpE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAA;YAC5E,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;QACvB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACvC,MAAM,MAAM,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,KAAK,CAAA;YACrF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,gBAAgB,KAAK,CAAC,IAAI,oCAAoC;oBACvE,IAAI,EAAE,8CAA8C;oBACpD,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;iBAC/B,CAAC,CAAA;YACJ,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE;oBACP,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,mEAAmE;oBACnE,kEAAkE;oBAClE,mEAAmE;oBACnE,4BAA4B;oBAC5B,IAAI,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK;oBACtC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;iBACxC;aACF,CAAA;QACH,CAAC;QACD,SAAS,CAAC;YACR,MAAM,UAAU,GAAU,KAAK,CAAC,IAAI,CAAA;YACpC,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,6BAA6B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA0B,EAC1B,SAA4C,EAC5C,GAAG,GAAiB,IAAI,CAAC,GAAG;IAE5B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,aAAa,UAAU,CAAC,IAAI,iCAAiC;YACtE,IAAI,EAAE,+CAA+C;SACtD,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACnE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ,CAAC,uEAAuE;QACzG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,OAAO,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,MAAM,GAA+D,EAAE,CAAA;IAC7E,MAAM,QAAQ,GAAsB,EAAE,CAAA;IAEtC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtC,kEAAkE;QAClE,qEAAqE;QACrE,uEAAuE;QACvE,uEAAuE;QACvE,qCAAqC;QACrC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,SAAQ;QAE/C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;QAChE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAA;QACnE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACnE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,wBAAwB,CAAC,MAAsC;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,kCAAkC;YAC3C,IAAI,EAAE,uCAAuC;SAC9C,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,8BAA8B;gBACrD,IAAI,EAAE,mFAAmF;aAC1F,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,eAAe,KAAK,CAAC,IAAI,2BAA2B;gBAC7D,IAAI,EAAE,kCAAkC;aACzC,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACpB,IACE,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;YAC/D,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAClC,CAAC;YACD,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,8BAA8B;gBACrD,IAAI,EAAE,yCAAyC;aAChD,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxE,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,8BAA8B;gBACrD,IAAI,EAAE,+GAA+G;aACtH,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAClE,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBAC9C,IAAI,CAAE,oBAA0C,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACpE,MAAM,IAAI,YAAY,CAAC;wBACrB,IAAI,EAAE,yBAAyB;wBAC/B,OAAO,EAAE,IAAI,QAAQ,2BAA2B;wBAChD,IAAI,EAAE,eAAe,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;qBACxD,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;YACzF,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,uCAAuC;gBAC9D,IAAI,EAAE,gFAAgF;aACvF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,uBAAuB;IACvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,SAAQ;QACxC,IAAI,CAAE,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,gCAAgC;gBAClE,IAAI,EAAE,eAAe,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aAC5D,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,mCAAmC;gBAC1D,IAAI,EAAE,iDAAiD;aACxD,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,yCAAyC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI;gBACtF,IAAI,EAAE,8DAA8D;aACrE,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,6IAA6I;AAC7I,MAAM,UAAU,iBAAiB,CAC/B,MAAsC,EACtC,KAAoC;IAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAE9B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,0BAA0B;gBACnC,IAAI,EAAE,4CAA4C;aACnD,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,kBAAkB;gBAC7C,IAAI,EAAE,0CAA0C;aACjD,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,6BAA6B,IAAI,IAAI;oBAChE,IAAI,EAAE,qDAAqD;iBAC5D,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,IAAI,IAAI,sCAAsC;oBACvD,IAAI,EAAE,0CAA0C;iBACjD,CAAC,CAAA;YACJ,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,IAAI,IAAI,gCAAgC;gBACjD,IAAI,EAAE,yEAAyE;aAChF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,mKAAmK;AACnK,MAAM,UAAU,sBAAsB,CAAC,QAAsC;IAC3E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC9D,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,oEAAoE;gBAC7E,IAAI,EAAE,qFAAqF;aAC5F,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,yIAAyI;AACzI,MAAM,UAAU,qBAAqB,CAAC,OAA0B;IAC9D,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAM;IAC5B,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrF,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,iEAAiE;YAC1E,IAAI,EAAE,yEAAyE;SAChF,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@cogenta/forms",
+  "version": "0.2.4",
+  "description": "Contract G: form definitions and submissions (ADR-0026).",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogenta-cms/cogenta.git",
+    "directory": "packages/forms"
+  },
+  "dependencies": {
+    "@cogenta/channels": "0.3.4",
+    "@cogenta/core": "0.8.0"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --passWithNoTests",
+    "test:integration": "vitest run --config vitest.integration.config.ts --passWithNoTests"
+  }
+}