@adminiumjs/add-on-contracts 0.3.39 → 0.3.40

package/dist/forms/definition.d.ts.map

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

package/dist/forms/definition.js

@@ -0,0 +1,451 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * A FORM'S DEFINITION: what the forms add-on's builder writes and the engine
+ * draws, checks and stores answers against.
+ *
+ * The engine reads every form for a stranger (no add-on code runs for one),
+ * so this one schema is the whole of what a form may say: the eleven question
+ * kinds and their own checks, "show if" on an earlier answer, sections, a
+ * version of every text per language, the agreement tick with its wording's
+ * version, the hidden source field, and the ending. The builder previews with
+ * it and the engine parses with it at publish and at every draw, so the two
+ * can never disagree.
+ *
+ * A refusal is a CODE at a path, never a sentence: the dashboard and the
+ * stranger's page word it in the reader's language. The codes this file adds
+ * are in {@link FORM_DEFINITION_CODES}; the rest are Zod's own
+ * (`invalid_type`, `too_big`, …).
+ *
+ * Pure: no I/O.
+ */
+import { z } from 'zod';
+import { FORM_FILES_MAX, SCALE_OF } from './scales.js';
+import { FORM_LANGUAGES, FORM_WORDS_MAX, formLanguageSchema, wordsSchema } from './words.js';
+export { FORM_FILES_MAX, SCALE_OF };
+/** The version of this vocabulary. A form says which one it was written in (`v`). */
+export const FORMS_VOCABULARY_VERSION = 1;
+/** The most questions, sections and choices a form holds. */
+export const FORM_QUESTIONS_MAX = 60;
+export const FORM_SECTIONS_MAX = 12;
+export const FORM_CHOICES_MIN = 2;
+export const FORM_CHOICES_MAX = 30;
+/** The eleven kinds of question (comp E4.3). */
+export const FORM_QUESTION_KINDS = ['short', 'long', 'one', 'several', 'date', 'number', 'score', 'stars', 'file', 'tick', 'hidden'];
+/** The kinds a "show if" may name: the ones whose answer is a pick or a number. */
+export const SHOW_IF_KINDS = ['one', 'several', 'score', 'stars', 'number'];
+/**
+ * The two purposes a tick may give consent for. A closed list on purpose: the
+ * unsubscribe page, the audience and the stop list know these two and no
+ * others (the manifest's `CONSENT_PURPOSES` is the same list).
+ */
+export const FORM_TICK_PURPOSES = ['newsletter', 'surveys'];
+/** The kinds of file a file question may take: pictures, PDF and plain text only. */
+export const FORM_FILE_KINDS = ['pdf', 'jpg', 'png', 'text'];
+/** Codes this file refuses a definition with, beside Zod's own. */
+export const FORM_DEFINITION_CODES = [
+    /** Two questions, sections, choices of one question or hidden fields share an id (or a parameter). */
+    'id-duplicate',
+    'languages-duplicate',
+    /** The default language is not one the form lists. */
+    'default-language',
+    /** A listed language has no version of this text (the path ends in the language). */
+    'words-missing',
+    /** A text has a version in a language the form does not list. */
+    'words-unlisted',
+    'section-unknown',
+    /** Questions without a section come first, then each section's in the sections' order. */
+    'section-order',
+    /** A "show if" names no question of the form. */
+    'show-if-unknown',
+    /** A "show if" names its own question or a later one. */
+    'show-if-forward',
+    /** A "show if" names a question whose kind it cannot test. */
+    'show-if-kind',
+    /** A "show if" gives no test, more than one, or one its question's kind does not take. */
+    'show-if-test',
+    /** A "show if" names a choice its question does not have. */
+    'show-if-choice',
+    /** A "show if" names a number its question can never hold. */
+    'show-if-range',
+    /** A hidden field is never shown, so it has no "show if". */
+    'hidden-show-if',
+    /** A hidden field is filled from the page's address, so nobody can be asked for it. */
+    'hidden-required',
+    /** An agreement is given freely: a tick is never required. */
+    'tick-required',
+    /** Two ticks give consent for one purpose. */
+    'tick-purpose-twice',
+    /**
+     * A tick that waits for the click in a confirmation mail, on a form that
+     * asks for no e-mail address (a short answer that checks for one): the
+     * mail has nowhere to go, so the yes could never be proved.
+     */
+    'tick-confirm-email',
+    /** `recommend` marks a survey's score; a form has none. */
+    'recommend-on-form',
+    'recommend-twice',
+    /** Surveys take no files. */
+    'survey-file',
+    /** Surveys sign nobody up. */
+    'survey-tick',
+    /** A several-choice question's least and most picks do not fit its choices. */
+    'several-picks',
+    /** A number question's least is above its most. */
+    'number-bounds',
+    'file-kinds-duplicate',
+    /** A question marked as the e-mail address checks for one. */
+    'role-email-check',
+    /** The page an ending sends to is not an https address. */
+    'ending-https',
+];
+export const questionIdSchema = z.string().regex(/^q[a-z0-9]{1,15}$/, 'a question id is q and 1 to 15 lower-case letters or digits');
+export const sectionIdSchema = z.string().regex(/^s[a-z0-9]{1,15}$/, 'a section id is s and 1 to 15 lower-case letters or digits');
+/** A choice's id: what an answer stores, so a column a form fills may take it as it is. */
+export const choiceIdSchema = z.string().regex(/^[a-z0-9][a-z0-9_-]{0,39}$/, 'a choice id is 1 to 40 lower-case letters, digits, _ or -');
+/** The one test a "show if" makes of an earlier answer. */
+export const showIfSchema = z
+    .object({
+    question: questionIdSchema,
+    /** A pick of a one-choice question, or a score, a star count or a number. */
+    is: z.union([choiceIdSchema, z.number()]).optional(),
+    /** A several-choice question's picks include this choice. */
+    includes: choiceIdSchema.optional(),
+    atLeast: z.number().optional(),
+    atMost: z.number().optional(),
+})
+    .strict();
+export const choiceSchema = z.object({ id: choiceIdSchema, label: wordsSchema(FORM_WORDS_MAX.choice) }).strict();
+/** What every question has. */
+const base = {
+    id: questionIdSchema,
+    label: wordsSchema(FORM_WORDS_MAX.label),
+    help: wordsSchema(FORM_WORDS_MAX.help).optional(),
+    required: z.boolean().default(false),
+    /** The section it sits in; absent, it sits before the first. */
+    section: sectionIdSchema.optional(),
+    showIf: showIfSchema.optional(),
+};
+/** A bound a number question may say: a sensible magnitude, so a stored answer fits any number column. */
+const NUMBER_MAGNITUDE = 1e12;
+const bound = z.number().min(-NUMBER_MAGNITUDE).max(NUMBER_MAGNITUDE);
+export const shortQuestionSchema = z
+    .object({
+    ...base,
+    kind: z.literal('short'),
+    /** The answer must be an e-mail address, or a phone number. */
+    check: z.enum(['email', 'phone']).optional(),
+    maxLength: z.number().int().min(1).max(500).default(200),
+    /** What the answer is of the person: the engine keeps the name and the e-mail address on the answer itself. */
+    role: z.enum(['name', 'email', 'company']).optional(),
+})
+    .strict();
+export const longQuestionSchema = z.object({ ...base, kind: z.literal('long'), maxLength: z.number().int().min(1).max(5000).default(2000) }).strict();
+const choices = z.array(choiceSchema).min(FORM_CHOICES_MIN).max(FORM_CHOICES_MAX);
+export const oneQuestionSchema = z.object({ ...base, kind: z.literal('one'), choices }).strict();
+export const severalQuestionSchema = z
+    .object({
+    ...base,
+    kind: z.literal('several'),
+    choices,
+    /** The fewest and the most picks an answer may make. */
+    min: z.number().int().min(1).max(FORM_CHOICES_MAX).optional(),
+    max: z.number().int().min(1).max(FORM_CHOICES_MAX).optional(),
+})
+    .strict();
+export const dateQuestionSchema = z
+    .object({
+    ...base,
+    kind: z.literal('date'),
+    /** The earliest day an answer may name, counted in the business's time zone. */
+    from: z.enum(['any', 'today', 'tomorrow']).default('any'),
+})
+    .strict();
+export const numberQuestionSchema = z.object({ ...base, kind: z.literal('number'), min: bound.optional(), max: bound.optional(), whole: z.boolean().optional() }).strict();
+export const scoreQuestionSchema = z
+    .object({
+    ...base,
+    kind: z.literal('score'),
+    /** "How likely are you to recommend us?": the survey's one score its results call the recommend score. */
+    recommend: z.boolean().optional(),
+})
+    .strict();
+export const starsQuestionSchema = z.object({ ...base, kind: z.literal('stars') }).strict();
+export const fileQuestionSchema = z
+    .object({
+    ...base,
+    kind: z.literal('file'),
+    /** The largest file taken, in megabytes, per file. */
+    maxMb: z.number().int().min(1).max(10),
+    kinds: z.array(z.enum(FORM_FILE_KINDS)).min(1).max(FORM_FILE_KINDS.length),
+    /** Up to {@link FORM_FILES_MAX} files; absent, one. */
+    many: z.boolean().optional(),
+})
+    .strict();
+/**
+ * The agreement tick. Its `label` IS the wording the visitor agrees to, and
+ * its version is what the consent log keeps with the yes. It is never ticked
+ * before the visitor ticks it, so the vocabulary has no default value for it.
+ */
+export const tickQuestionSchema = z
+    .object({
+    ...base,
+    label: wordsSchema(FORM_WORDS_MAX.wording),
+    kind: z.literal('tick'),
+    purpose: z.enum(FORM_TICK_PURPOSES),
+    wordingVersion: z.number().int().min(1),
+    wordingChangedAt: z.iso.date(),
+    /** A yes waits for the click in a confirmation mail (on by default). */
+    confirm: z.boolean().default(true),
+})
+    .strict();
+/** The hidden source field: filled from the page address's query (`?from=flyer`), never shown. */
+export const hiddenQuestionSchema = z
+    .object({
+    ...base,
+    kind: z.literal('hidden'),
+    param: z.string().regex(/^[a-z][a-z0-9_]{0,31}$/, 'a parameter is 1 to 32 lower-case letters, digits or _'),
+})
+    .strict();
+export const formQuestionSchema = z.discriminatedUnion('kind', [
+    shortQuestionSchema,
+    longQuestionSchema,
+    oneQuestionSchema,
+    severalQuestionSchema,
+    dateQuestionSchema,
+    numberQuestionSchema,
+    scoreQuestionSchema,
+    starsQuestionSchema,
+    fileQuestionSchema,
+    tickQuestionSchema,
+    hiddenQuestionSchema,
+]);
+export const formSectionSchema = z.object({ id: sectionIdSchema, title: wordsSchema(FORM_WORDS_MAX.section) }).strict();
+/** Whether a text is an https address with a host and no user name or password in it. */
+export function isHttpsAddress(text) {
+    if (!URL.canParse(text))
+        return false;
+    const url = new URL(text);
+    return url.protocol === 'https:' && url.hostname !== '' && url.username === '' && url.password === '';
+}
+/** What a visitor sees after sending: the owner's words, or another page. */
+export const formEndingSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('words'), words: wordsSchema(FORM_WORDS_MAX.ending) }).strict(),
+    z.object({ kind: z.literal('page'), url: z.string().min(1).max(2048) }).strict(),
+]);
+const definitionShape = z
+    .object({
+    v: z.literal(FORMS_VOCABULARY_VERSION),
+    kind: z.enum(['form', 'survey']),
+    languages: z.array(formLanguageSchema).min(1).max(FORM_LANGUAGES.length),
+    defaultLanguage: formLanguageSchema,
+    title: wordsSchema(FORM_WORDS_MAX.title),
+    intro: wordsSchema(FORM_WORDS_MAX.intro).optional(),
+    sections: z.array(formSectionSchema).max(FORM_SECTIONS_MAX).optional(),
+    questions: z.array(formQuestionSchema).min(1).max(FORM_QUESTIONS_MAX),
+    ending: formEndingSchema,
+})
+    .strict();
+/** The kinds of test each kind of question takes in a "show if". */
+const TESTS_OF = {
+    one: ['is'],
+    several: ['includes'],
+    score: ['is', 'atLeast', 'atMost'],
+    stars: ['is', 'atLeast', 'atMost'],
+    number: ['is', 'atLeast', 'atMost'],
+};
+/** Every text of the definition, with its path, to hold against the form's languages. */
+function textsOf(d) {
+    const out = [{ words: d.title, path: ['title'] }];
+    if (d.intro !== undefined)
+        out.push({ words: d.intro, path: ['intro'] });
+    (d.sections ?? []).forEach((section, s) => out.push({ words: section.title, path: ['sections', s, 'title'] }));
+    d.questions.forEach((question, q) => {
+        out.push({ words: question.label, path: ['questions', q, 'label'] });
+        if (question.help !== undefined)
+            out.push({ words: question.help, path: ['questions', q, 'help'] });
+        if (question.kind === 'one' || question.kind === 'several') {
+            question.choices.forEach((choice, c) => out.push({ words: choice.label, path: ['questions', q, 'choices', c, 'label'] }));
+        }
+    });
+    if (d.ending.kind === 'words')
+        out.push({ words: d.ending.words, path: ['ending', 'words'] });
+    return out;
+}
+/** The rules across a definition's parts, each a code at a path. */
+function definitionIssues(d, report) {
+    // Languages: listed once, the default among them, and every text in exactly those.
+    const listed = new Set(d.languages);
+    if (listed.size !== d.languages.length)
+        report('languages-duplicate', ['languages']);
+    if (!listed.has(d.defaultLanguage))
+        report('default-language', ['defaultLanguage']);
+    for (const { words, path } of textsOf(d)) {
+        for (const language of listed)
+            if (words[language] === undefined)
+                report('words-missing', [...path, language]);
+        for (const language of Object.keys(words))
+            if (!listed.has(language))
+                report('words-unlisted', [...path, language]);
+    }
+    // Sections: unique, named by their questions, and drawn in order.
+    const sections = d.sections ?? [];
+    const sectionAt = new Map();
+    sections.forEach((section, s) => {
+        if (sectionAt.has(section.id))
+            report('id-duplicate', ['sections', s, 'id']);
+        else
+            sectionAt.set(section.id, s);
+    });
+    let lastSection = -1;
+    d.questions.forEach((question, q) => {
+        if (question.section === undefined) {
+            if (lastSection !== -1)
+                report('section-order', ['questions', q, 'section']);
+            return;
+        }
+        const at = sectionAt.get(question.section);
+        if (at === undefined) {
+            report('section-unknown', ['questions', q, 'section']);
+            return;
+        }
+        if (at < lastSection)
+            report('section-order', ['questions', q, 'section']);
+        lastSection = Math.max(lastSection, at);
+    });
+    // Questions: ids, choices and hidden parameters unique.
+    const questionAt = new Map();
+    const params = new Set();
+    d.questions.forEach((question, q) => {
+        if (questionAt.has(question.id))
+            report('id-duplicate', ['questions', q, 'id']);
+        else
+            questionAt.set(question.id, q);
+        if (question.kind === 'one' || question.kind === 'several') {
+            const seen = new Set();
+            question.choices.forEach((choice, c) => {
+                if (seen.has(choice.id))
+                    report('id-duplicate', ['questions', q, 'choices', c, 'id']);
+                seen.add(choice.id);
+            });
+        }
+        if (question.kind === 'hidden') {
+            if (params.has(question.param))
+                report('id-duplicate', ['questions', q, 'param']);
+            params.add(question.param);
+        }
+    });
+    // Each kind's own rules.
+    const asksEmail = d.questions.some((question) => question.kind === 'short' && question.check === 'email');
+    const purposes = new Set();
+    let recommends = 0;
+    d.questions.forEach((question, q) => {
+        const at = (...rest) => ['questions', q, ...rest];
+        switch (question.kind) {
+            case 'short':
+                if (question.role === 'email' && question.check !== 'email')
+                    report('role-email-check', at('role'));
+                break;
+            case 'several': {
+                const most = question.max ?? question.choices.length;
+                if (most > question.choices.length || (question.min ?? 1) > most)
+                    report('several-picks', at(question.max === undefined ? 'min' : 'max'));
+                break;
+            }
+            case 'number':
+                if (question.min !== undefined && question.max !== undefined && question.min > question.max)
+                    report('number-bounds', at('min'));
+                break;
+            case 'score':
+                if (question.recommend === true) {
+                    if (d.kind === 'form')
+                        report('recommend-on-form', at('recommend'));
+                    else if (++recommends > 1)
+                        report('recommend-twice', at('recommend'));
+                }
+                break;
+            case 'file':
+                if (new Set(question.kinds).size !== question.kinds.length)
+                    report('file-kinds-duplicate', at('kinds'));
+                if (d.kind === 'survey')
+                    report('survey-file', at('kind'));
+                break;
+            case 'tick':
+                if (question.required)
+                    report('tick-required', at('required'));
+                if (purposes.has(question.purpose))
+                    report('tick-purpose-twice', at('purpose'));
+                purposes.add(question.purpose);
+                if (d.kind === 'survey')
+                    report('survey-tick', at('kind'));
+                else if (question.confirm && !asksEmail)
+                    report('tick-confirm-email', at('confirm'));
+                break;
+            case 'hidden':
+                if (question.required)
+                    report('hidden-required', at('required'));
+                if (question.showIf !== undefined)
+                    report('hidden-show-if', at('showIf'));
+                break;
+            default:
+                break;
+        }
+    });
+    // "Show if": one test, of an earlier question it can test, naming what that question can hold.
+    d.questions.forEach((question, q) => {
+        const showIf = question.showIf;
+        if (showIf === undefined || question.kind === 'hidden')
+            return;
+        const at = (...rest) => ['questions', q, 'showIf', ...rest];
+        const target = questionAt.get(showIf.question);
+        if (target === undefined) {
+            report('show-if-unknown', at('question'));
+            return;
+        }
+        if (target >= q) {
+            report('show-if-forward', at('question'));
+            return;
+        }
+        const named = d.questions[target];
+        if (!SHOW_IF_KINDS.includes(named.kind)) {
+            report('show-if-kind', at('question'));
+            return;
+        }
+        const given = ['is', 'includes', 'atLeast', 'atMost'].filter((test) => showIf[test] !== undefined);
+        const takes = TESTS_OF[named.kind];
+        if (given.length !== 1 || !takes.includes(given[0])) {
+            report('show-if-test', at());
+            return;
+        }
+        const test = given[0];
+        const value = showIf[test];
+        if (named.kind === 'one' || named.kind === 'several') {
+            if (typeof value !== 'string' || !named.choices.some((choice) => choice.id === value))
+                report('show-if-choice', at(test));
+            return;
+        }
+        if (typeof value !== 'number') {
+            report('show-if-test', at(test));
+            return;
+        }
+        if (named.kind === 'score' || named.kind === 'stars') {
+            const scale = SCALE_OF[named.kind];
+            if (!Number.isInteger(value) || value < scale.min || value > scale.max)
+                report('show-if-range', at(test));
+        }
+        else if (named.kind === 'number' && ((named.min !== undefined && value < named.min) || (named.max !== undefined && value > named.max))) {
+            report('show-if-range', at(test));
+        }
+    });
+    if (d.ending.kind === 'page' && !isHttpsAddress(d.ending.url))
+        report('ending-https', ['ending', 'url']);
+}
+/**
+ * A form's definition. Its defaults filled in (`required: false`, a short
+ * answer's 200 characters, a tick's confirmation on), and every rule across
+ * its parts held: a value that parses here is one the engine can draw in each
+ * of its languages and check an answer against.
+ */
+export const formDefinitionSchema = definitionShape.superRefine((d, ctx) => {
+    definitionIssues(d, (code, path) => ctx.addIssue({ code: 'custom', message: code, path, params: { code } }));
+});
+//# sourceMappingURL=definition.js.map

package/dist/forms/definition.js.map

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

package/dist/forms/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@adminium/add-on-contracts/forms` — the forms vocabulary: a form's
+ * definition and settings, the check an answer is held to, which questions
+ * are shown, and the results counted.
+ *
+ * Both the engine and the forms add-on import it, so the builder's preview,
+ * the page a stranger fills and the server's check can never disagree. Pure:
+ * no I/O, no `node:` import.
+ */
+export { FORM_LANGUAGES, FORM_WORDS_MAX, formLanguageSchema, wordsSchema, type FormLanguage, type Words } from './words.js';
+export { FORMS_VOCABULARY_VERSION, FORM_CHOICES_MAX, FORM_CHOICES_MIN, FORM_DEFINITION_CODES, FORM_FILES_MAX, FORM_FILE_KINDS, FORM_QUESTIONS_MAX, FORM_QUESTION_KINDS, FORM_SECTIONS_MAX, FORM_TICK_PURPOSES, SCALE_OF, SHOW_IF_KINDS, choiceIdSchema, choiceSchema, dateQuestionSchema, fileQuestionSchema, formDefinitionSchema, formEndingSchema, formQuestionSchema, formSectionSchema, hiddenQuestionSchema, isHttpsAddress, longQuestionSchema, numberQuestionSchema, oneQuestionSchema, questionIdSchema, scoreQuestionSchema, sectionIdSchema, severalQuestionSchema, shortQuestionSchema, showIfSchema, starsQuestionSchema, tickQuestionSchema, type FormChoice, type FormDefinition, type FormDefinitionCode, type FormDefinitionInput, type FormFileKind, type FormQuestion, type FormQuestionKind, type FormQuestionOf, type FormTickPurpose, type ShowIf, } from './definition.js';
+export { FORM_PER_HOUR_DEFAULT, FORM_PER_HOUR_MAX, FORM_TELL_MAX, SURVEY_STOP_AFTER_DAYS_DEFAULT, formBecomesSchema, formColumnRefSchema, formSettingsSchema, formTellSchema, keepsNames, type FormBecomes, type FormSettings, type FormSettingsInput, } from './settings.js';
+export { FORM_SETTINGS_CODES, parseForm, type Form, type FormIssue, type FormSettingsCode, type ParsedForm } from './parse.js';
+export { ANSWER_NAME_MAX, EMAIL_MAX, FORM_ANSWER_CODES, HIDDEN_VALUE_MAX, UPLOAD_ID, WHOLE_ANSWER, checkAnswer, cleanText, isEmailAddress, isPhoneNumber, visibleQuestions, type CheckedAnswer, type FormAnswerCode, type FormAnswerValue, type FormAnswerValues, } from './check.js';
+export { recommendScoreOf, summarise, type FormSummary, type QuestionSummary } from './summary.js';
+export { WEBSITES_MAX, WEBSITE_LINE_CODES, WEBSITE_LINE_MAX, WEBSITE_ORIGIN_MAX, checkWebsiteLine, checkWebsiteLines, isWebsiteOrigin, type WebsiteCheckContext, type WebsiteLine, type WebsiteLineCode, } from './websites.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5H,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,MAAM,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/H,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEnG,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC"}

package/dist/forms/index.js

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * `@adminium/add-on-contracts/forms` — the forms vocabulary: a form's
+ * definition and settings, the check an answer is held to, which questions
+ * are shown, and the results counted.
+ *
+ * Both the engine and the forms add-on import it, so the builder's preview,
+ * the page a stranger fills and the server's check can never disagree. Pure:
+ * no I/O, no `node:` import.
+ */
+export { FORM_LANGUAGES, FORM_WORDS_MAX, formLanguageSchema, wordsSchema } from './words.js';
+export { FORMS_VOCABULARY_VERSION, FORM_CHOICES_MAX, FORM_CHOICES_MIN, FORM_DEFINITION_CODES, FORM_FILES_MAX, FORM_FILE_KINDS, FORM_QUESTIONS_MAX, FORM_QUESTION_KINDS, FORM_SECTIONS_MAX, FORM_TICK_PURPOSES, SCALE_OF, SHOW_IF_KINDS, choiceIdSchema, choiceSchema, dateQuestionSchema, fileQuestionSchema, formDefinitionSchema, formEndingSchema, formQuestionSchema, formSectionSchema, hiddenQuestionSchema, isHttpsAddress, longQuestionSchema, numberQuestionSchema, oneQuestionSchema, questionIdSchema, scoreQuestionSchema, sectionIdSchema, severalQuestionSchema, shortQuestionSchema, showIfSchema, starsQuestionSchema, tickQuestionSchema, } from './definition.js';
+export { FORM_PER_HOUR_DEFAULT, FORM_PER_HOUR_MAX, FORM_TELL_MAX, SURVEY_STOP_AFTER_DAYS_DEFAULT, formBecomesSchema, formColumnRefSchema, formSettingsSchema, formTellSchema, keepsNames, } from './settings.js';
+export { FORM_SETTINGS_CODES, parseForm } from './parse.js';
+export { ANSWER_NAME_MAX, EMAIL_MAX, FORM_ANSWER_CODES, HIDDEN_VALUE_MAX, UPLOAD_ID, WHOLE_ANSWER, checkAnswer, cleanText, isEmailAddress, isPhoneNumber, visibleQuestions, } from './check.js';
+export { recommendScoreOf, summarise } from './summary.js';
+export { WEBSITES_MAX, WEBSITE_LINE_CODES, WEBSITE_LINE_MAX, WEBSITE_ORIGIN_MAX, checkWebsiteLine, checkWebsiteLines, isWebsiteOrigin, } from './websites.js';
+//# sourceMappingURL=index.js.map

package/dist/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AAE5H,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,GAWnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,8BAA8B,EAC9B,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,GAIX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAqE,MAAM,YAAY,CAAC;AAE/H,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,SAAS,EACT,cAAc,EACd,aAAa,EACb,gBAAgB,GAKjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAA0C,MAAM,cAAc,CAAC;AAEnG,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAIhB,MAAM,eAAe,CAAC"}

package/dist/forms/parse.d.ts

@@ -0,0 +1,30 @@
+import { type FormDefinition } from './definition.js';
+import { type FormSettings } from './settings.js';
+/** A form as the engine holds it. */
+export interface Form {
+    definition: FormDefinition;
+    settings: FormSettings;
+}
+/** Codes the settings are refused with, beside the definition's and Zod's own. */
+export declare const FORM_SETTINGS_CODES: readonly ["survey-settings-missing", "survey-settings-on-form", "survey-anonymous-names", "becomes-question-unknown", "becomes-question-kind", "becomes-column-twice", "becomes-anonymous", "tell-duplicate", "tell-when-question", "tell-when-range"];
+export type FormSettingsCode = (typeof FORM_SETTINGS_CODES)[number];
+export interface FormIssue {
+    /** Where: under `definition` or `settings`. */
+    path: (string | number)[];
+    /** What: one of this vocabulary's codes, or Zod's own. */
+    code: string;
+}
+export type ParsedForm = {
+    ok: true;
+    form: Form;
+} | {
+    ok: false;
+    issues: FormIssue[];
+};
+/**
+ * A form from its stored definition and settings, or every reason it is not
+ * one. The definition's issues come first; the rules across the two are
+ * checked only when both parse.
+ */
+export declare function parseForm(definition: unknown, settings: unknown): ParsedForm;
+//# sourceMappingURL=parse.d.ts.map

package/dist/forms/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/forms/parse.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAElF,qCAAqC;AACrC,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,wPAoBtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAkDvF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,CAO5E"}