payload-dynamic-forms 0.0.0-stage → 0.2.0

package/dist/shared/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/tokens.ts"],"sourcesContent":["import type { Answers, FieldTypeChecks, FormLike, InputBlock } from './types.js'\n\nimport { answerToText } from './answers.js'\nimport { getInputFields, getOptions, getRowLabel, hasAnswer, isChoiceBlock, toStringList } from './rules.js'\nimport { getVisibility } from './steps.js'\nimport { fillWords } from './words.js'\n\nexport type TokenValue = boolean | null | number | string | undefined\n\nexport type MessageRow = { key: string; label: string; value: string }\n\nexport type InterpolateOptions = {\n  /** Escape values for HTML and turn `{{*}}` lines into `<br>`. */\n  html?: boolean\n  /** Rows for `{{*}}` and `{{*:table}}`. */\n  rows?: MessageRow[]\n  /** Remove line breaks (for subjects and headers). */\n  singleLine?: boolean\n}\n\nconst TOKEN = /\\{\\{\\s*(\\*(?::table)?|\\w[\\w-]*(?:\\.[\\w-]+)?)\\s*\\}\\}/g\n\nexport function escapeHtml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;')\n}\n\nfunction rowsAsLines(rows: MessageRow[], html: boolean): string {\n  const lines = rows.map((row) => `${row.label}: ${row.value}`)\n  return html ? lines.map(escapeHtml).join('<br>\\n') : lines.join('\\n')\n}\n\nfunction rowsAsTable(rows: MessageRow[], html: boolean): string {\n  if (!html) {\n    return rowsAsLines(rows, false)\n  }\n  const body = rows\n    .map((row) => `<tr><th align=\"left\">${escapeHtml(row.label)}</th><td>${escapeHtml(row.value)}</td></tr>`)\n    .join('')\n  return `<table><tbody>${body}</tbody></table>`\n}\n\n/**\n * Fills `{{key}}` (dashes and underscores allowed), `{{key.attribute}}`, `{{*}}` and\n * `{{*:table}}`. Unknown tokens become empty.\n */\nexport function interpolate(\n  template: null | string | undefined,\n  values: Record<string, TokenValue>,\n  options: InterpolateOptions = {},\n): string {\n  if (!template) {\n    return ''\n  }\n  const html = Boolean(options.html)\n  const out = template.replace(TOKEN, (_match, name: string) => {\n    if (name === '*') {\n      return rowsAsLines(options.rows || [], html)\n    }\n    if (name === '*:table') {\n      return rowsAsTable(options.rows || [], html)\n    }\n    const value = values[name]\n    const text = value === undefined || value === null ? '' : String(value)\n    return html ? escapeHtml(text) : text\n  })\n  return options.singleLine ? out.replace(/[\\r\\n]+/g, ' ').trim() : out\n}\n\n/** One row per answered, shown field, in form order, using each field's row label. */\nexport function buildMessageRows(\n  form: FormLike,\n  answers: Answers,\n  fieldTypes?: Record<string, FieldTypeChecks>,\n): MessageRow[] {\n  const { answers: shown } = getVisibility(form, answers)\n  const words = fillWords(form.wording)\n  const rows: MessageRow[] = []\n  for (const { field, key } of getInputFields(form)) {\n    if (!(key in shown) || !hasAnswer(shown[key])) {\n      continue\n    }\n    const value = answerToText(field, shown[key], words, fieldTypes)\n    if (!value.trim()) {\n      continue\n    }\n    rows.push({ key, label: getRowLabel(field, key), value })\n  }\n  return rows\n}\n\nfunction chosenAttributes(field: InputBlock, value: unknown): Record<string, string> {\n  const options = getOptions(field)\n  const chosen = toStringList(value)\n    .map((v) => options.find((o) => String(o.value) === v))\n    .filter(Boolean)\n  const out: Record<string, string> = {}\n  for (const option of chosen) {\n    for (const [name, attr] of Object.entries(option!.attributes || {})) {\n      if (attr === null || attr === undefined) {\n        continue\n      }\n      out[name] = out[name] ? `${out[name]}, ${String(attr)}` : String(attr)\n    }\n  }\n  return out\n}\n\n/** Token values for a form's shown answers: `{{key}}`, `{{key.attribute}}` plus `extra`. */\nexport function buildTemplateValues(\n  form: FormLike,\n  answers: Answers,\n  extra: Record<string, TokenValue> = {},\n  fieldTypes?: Record<string, FieldTypeChecks>,\n): Record<string, TokenValue> {\n  const { answers: shown } = getVisibility(form, answers)\n  const words = fillWords(form.wording)\n  const values: Record<string, TokenValue> = { formTitle: form.title || '', ...extra }\n  for (const { field, key } of getInputFields(form)) {\n    if (!(key in shown)) {\n      continue\n    }\n    values[key] = answerToText(field, shown[key], words, fieldTypes)\n    if (isChoiceBlock(field)) {\n      for (const [name, attr] of Object.entries(chosenAttributes(field, shown[key]))) {\n        values[`${key}.${name}`] = attr\n      }\n    }\n  }\n  return values\n}\n"],"names":["answerToText","getInputFields","getOptions","getRowLabel","hasAnswer","isChoiceBlock","toStringList","getVisibility","fillWords","TOKEN","escapeHtml","value","replace","rowsAsLines","rows","html","lines","map","row","label","join","rowsAsTable","body","interpolate","template","values","options","Boolean","out","_match","name","text","undefined","String","singleLine","trim","buildMessageRows","form","answers","fieldTypes","shown","words","wording","field","key","push","chosenAttributes","chosen","v","find","o","filter","option","attr","Object","entries","attributes","buildTemplateValues","extra","formTitle","title"],"mappings":"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"}

package/dist/shared/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Types shared by the browser and the server. Type-only: nothing here runs.
+ */
+import type { OperatorValue } from './operators.js';
+export type MatchMode = 'all' | 'any';
+export type PresentationMode = 'singlePage' | 'steps';
+export type IntakeState = 'closed' | 'open';
+export type SubmissionStatus = 'failed' | 'partlyFailed' | 'processed' | 'received';
+export type RuleRow = {
+    /** A field key, or `<field key>.<attribute>` for an attribute of the chosen option. */
+    fieldKey?: null | string;
+    id?: null | string;
+    operator?: null | OperatorValue;
+    value?: null | string;
+};
+export type RuleGroup = {
+    match?: MatchMode | null;
+    rows?: null | RuleRow[];
+};
+export type NextStepRule = {
+    targetSectionKey?: null | string;
+} & RuleGroup;
+/** A choice as the renderer and the checks see it (typed or resolved from a source). */
+export type ChoiceOption = {
+    attributes?: Record<string, unknown>;
+    label?: null | string;
+    value?: null | string;
+};
+/** The words one question shows. */
+export type FieldWords = {
+    errorEmpty?: null | string;
+    errorInvalid?: null | string;
+    hint?: null | string;
+    label?: null | string;
+    placeholder?: null | string;
+    /** Label of this answer's row in messages; falls back to `label`. */
+    rowLabel?: null | string;
+};
+export type BuiltInFieldType = 'checkbox' | 'checkboxGroup' | 'date' | 'email' | 'fileUpload' | 'heading' | 'helpText' | 'number' | 'radio' | 'select' | 'text' | 'textarea';
+export type DisplayBlock = {
+    blockName?: null | string;
+    blockType: 'heading' | 'helpText';
+    body?: null | string;
+    heading?: null | string;
+    id?: null | string;
+    level?: 'h2' | 'h3' | 'h4' | null;
+};
+export type InputBlock = {
+    [extra: string]: unknown;
+    blockName?: null | string;
+    /** Any input type: a built-in one or one an app registered. */
+    blockType: string;
+    defaultValue?: unknown;
+    fieldKey?: null | string;
+    id?: null | string;
+    max?: null | number;
+    maxDate?: null | string;
+    /** Files per field (file upload). */
+    maxFiles?: null | number;
+    /** Largest file in MB (file upload). */
+    maxFileSizeMB?: null | number;
+    maxLength?: null | number;
+    /** Allowed MIME types (file upload); empty = the plugin's list. */
+    mimeTypes?: null | string[];
+    min?: null | number;
+    minDate?: null | string;
+    minLength?: null | number;
+    options?: ChoiceOption[] | null;
+    optionsFrom?: null | string;
+    /** Name of a link (search) parameter that prefills this input. */
+    prefillParam?: null | string;
+    required?: boolean | null;
+    visibilityRules?: null | RuleGroup;
+    width?: 'full' | 'half' | null;
+    words?: FieldWords | null;
+};
+export type FieldBlock = DisplayBlock | InputBlock;
+export type FormSection = {
+    description?: null | string;
+    fields?: FieldBlock[] | null;
+    id?: null | string;
+    key?: null | string;
+    nextStepRules?: NextStepRule[] | null;
+    title?: null | string;
+    visibilityRules?: null | RuleGroup;
+};
+export type FormWords = {
+    back: string;
+    chooseOne: string;
+    closed: string;
+    continue: string;
+    errorPrefix: string;
+    fileRejected: string;
+    genericError: string;
+    invalid: string;
+    /** An unticked checkbox in messages, tokens and the snapshot. */
+    no: string;
+    notFound: string;
+    optionalHint: string;
+    required: string;
+    securityCheckFailed: string;
+    send: string;
+    sending: string;
+    sent: string;
+    stepProgress: string;
+    success: string;
+    tooManyTries: string;
+    /** A ticked checkbox in messages, tokens and the snapshot. */
+    yes: string;
+};
+/** The words `answerToText` needs: the form's `yes` and `no`. */
+export type YesNoWords = Pick<FormWords, 'no' | 'yes'>;
+/** The shape the rule engine needs: sections (with resolved choices) and optionally the words. */
+export type FormLike = {
+    presentationMode?: null | PresentationMode;
+    sections?: FormSection[] | null;
+    title?: null | string;
+    wording?: null | Partial<FormWords>;
+};
+/** A form as `getPublicForm` and `GET /api/<forms>/public/:slug` return it. */
+export type PublicForm = {
+    honeypotField: string;
+    id: number | string;
+    intakeState: IntakeState;
+    presentationMode: PresentationMode;
+    sections: FormSection[];
+    slug: string;
+    /** True when the server runs the honeypot, Turnstile and rate limit for this form. */
+    spamChecks: boolean;
+    successRedirectURL?: null | string;
+    successType: 'message' | 'redirect';
+    title: string;
+    turnstile: {
+        enabled: boolean;
+        fieldName: string;
+    };
+    whatsapp?: {
+        number: string;
+    };
+    wording: FormWords;
+};
+export type FileAnswer = {
+    attachmentIds: Array<number | string>;
+    filenames: string[];
+};
+export type AnswerValue = boolean | FileAnswer | null | number | string | string[];
+export type Answers = Record<string, AnswerValue>;
+/** A file as the checks see it: a browser `File` or anything with name, type and size. */
+export type FileLike = {
+    name?: string;
+    size: number;
+    type?: string;
+};
+export type SnapshotRow = {
+    fieldKey: string;
+    label: string;
+    sectionKey: string;
+    sectionTitle: string;
+    value: string;
+};
+/** Checks an app adds for its own field type (the plugin's `fields` registry). */
+export type FieldTypeChecks = {
+    normalize?: (raw: unknown, field: InputBlock) => AnswerValue;
+    toText?: (value: AnswerValue, field: InputBlock, words: YesNoWords) => string;
+    /** Return `true` when the value is fine, or the error words to show. */
+    validate?: (value: AnswerValue, ctx: {
+        answers: Answers;
+        field: InputBlock;
+    }) => string | true;
+};
+export type SubmitResult = {
+    fieldErrors?: Record<string, string>;
+    message: string;
+    ok: false;
+} | {
+    message: string;
+    ok: true;
+    redirectURL?: string;
+    submissionId?: number | string;
+    whatsappUrl?: string;
+};

package/dist/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types shared by the browser and the server. Type-only: nothing here runs.
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/types.ts"],"sourcesContent":["/**\n * Types shared by the browser and the server. Type-only: nothing here runs.\n */\n\nimport type { OperatorValue } from './operators.js'\n\nexport type MatchMode = 'all' | 'any'\nexport type PresentationMode = 'singlePage' | 'steps'\nexport type IntakeState = 'closed' | 'open'\nexport type SubmissionStatus = 'failed' | 'partlyFailed' | 'processed' | 'received'\n\nexport type RuleRow = {\n  /** A field key, or `<field key>.<attribute>` for an attribute of the chosen option. */\n  fieldKey?: null | string\n  id?: null | string\n  operator?: null | OperatorValue\n  value?: null | string\n}\n\nexport type RuleGroup = {\n  match?: MatchMode | null\n  rows?: null | RuleRow[]\n}\n\nexport type NextStepRule = {\n  targetSectionKey?: null | string\n} & RuleGroup\n\n/** A choice as the renderer and the checks see it (typed or resolved from a source). */\nexport type ChoiceOption = {\n  attributes?: Record<string, unknown>\n  label?: null | string\n  value?: null | string\n}\n\n/** The words one question shows. */\nexport type FieldWords = {\n  errorEmpty?: null | string\n  errorInvalid?: null | string\n  hint?: null | string\n  label?: null | string\n  placeholder?: null | string\n  /** Label of this answer's row in messages; falls back to `label`. */\n  rowLabel?: null | string\n}\n\nexport type BuiltInFieldType =\n  | 'checkbox'\n  | 'checkboxGroup'\n  | 'date'\n  | 'email'\n  | 'fileUpload'\n  | 'heading'\n  | 'helpText'\n  | 'number'\n  | 'radio'\n  | 'select'\n  | 'text'\n  | 'textarea'\n\nexport type DisplayBlock = {\n  blockName?: null | string\n  blockType: 'heading' | 'helpText'\n  body?: null | string\n  heading?: null | string\n  id?: null | string\n  level?: 'h2' | 'h3' | 'h4' | null\n}\n\nexport type InputBlock = {\n  [extra: string]: unknown\n  blockName?: null | string\n  /** Any input type: a built-in one or one an app registered. */\n  blockType: string\n  defaultValue?: unknown\n  fieldKey?: null | string\n  id?: null | string\n  max?: null | number\n  maxDate?: null | string\n  /** Files per field (file upload). */\n  maxFiles?: null | number\n  /** Largest file in MB (file upload). */\n  maxFileSizeMB?: null | number\n  maxLength?: null | number\n  /** Allowed MIME types (file upload); empty = the plugin's list. */\n  mimeTypes?: null | string[]\n  min?: null | number\n  minDate?: null | string\n  minLength?: null | number\n  options?: ChoiceOption[] | null\n  optionsFrom?: null | string\n  /** Name of a link (search) parameter that prefills this input. */\n  prefillParam?: null | string\n  required?: boolean | null\n  visibilityRules?: null | RuleGroup\n  width?: 'full' | 'half' | null\n  words?: FieldWords | null\n}\n\nexport type FieldBlock = DisplayBlock | InputBlock\n\nexport type FormSection = {\n  description?: null | string\n  fields?: FieldBlock[] | null\n  id?: null | string\n  key?: null | string\n  nextStepRules?: NextStepRule[] | null\n  title?: null | string\n  visibilityRules?: null | RuleGroup\n}\n\nexport type FormWords = {\n  back: string\n  chooseOne: string\n  closed: string\n  continue: string\n  errorPrefix: string\n  fileRejected: string\n  genericError: string\n  invalid: string\n  /** An unticked checkbox in messages, tokens and the snapshot. */\n  no: string\n  notFound: string\n  optionalHint: string\n  required: string\n  securityCheckFailed: string\n  send: string\n  sending: string\n  sent: string\n  stepProgress: string\n  success: string\n  tooManyTries: string\n  /** A ticked checkbox in messages, tokens and the snapshot. */\n  yes: string\n}\n\n/** The words `answerToText` needs: the form's `yes` and `no`. */\nexport type YesNoWords = Pick<FormWords, 'no' | 'yes'>\n\n/** The shape the rule engine needs: sections (with resolved choices) and optionally the words. */\nexport type FormLike = {\n  presentationMode?: null | PresentationMode\n  sections?: FormSection[] | null\n  title?: null | string\n  wording?: null | Partial<FormWords>\n}\n\n/** A form as `getPublicForm` and `GET /api/<forms>/public/:slug` return it. */\nexport type PublicForm = {\n  honeypotField: string\n  id: number | string\n  intakeState: IntakeState\n  presentationMode: PresentationMode\n  sections: FormSection[]\n  slug: string\n  /** True when the server runs the honeypot, Turnstile and rate limit for this form. */\n  spamChecks: boolean\n  successRedirectURL?: null | string\n  successType: 'message' | 'redirect'\n  title: string\n  turnstile: { enabled: boolean; fieldName: string }\n  whatsapp?: { number: string }\n  wording: FormWords\n}\n\nexport type FileAnswer = {\n  attachmentIds: Array<number | string>\n  filenames: string[]\n}\n\nexport type AnswerValue = boolean | FileAnswer | null | number | string | string[]\n\nexport type Answers = Record<string, AnswerValue>\n\n/** A file as the checks see it: a browser `File` or anything with name, type and size. */\nexport type FileLike = { name?: string; size: number; type?: string }\n\nexport type SnapshotRow = {\n  fieldKey: string\n  label: string\n  sectionKey: string\n  sectionTitle: string\n  value: string\n}\n\n/** Checks an app adds for its own field type (the plugin's `fields` registry). */\nexport type FieldTypeChecks = {\n  normalize?: (raw: unknown, field: InputBlock) => AnswerValue\n  toText?: (value: AnswerValue, field: InputBlock, words: YesNoWords) => string\n  /** Return `true` when the value is fine, or the error words to show. */\n  validate?: (value: AnswerValue, ctx: { answers: Answers; field: InputBlock }) => string | true\n}\n\nexport type SubmitResult =\n  | {\n      fieldErrors?: Record<string, string>\n      message: string\n      ok: false\n    }\n  | {\n      message: string\n      ok: true\n      redirectURL?: string\n      submissionId?: number | string\n      whatsappUrl?: string\n    }\n"],"names":[],"mappings":"AAAA;;CAEC,GA+LD,WAYK"}

package/dist/shared/whatsapp.d.ts

@@ -0,0 +1,20 @@
+import type { Answers, FieldTypeChecks, FormLike } from './types.js';
+import { type TokenValue } from './tokens.js';
+export declare const DEFAULT_WHATSAPP_TEMPLATE = "{{*}}";
+export declare const DEFAULT_WHATSAPP_ROW_TEMPLATE = "*{{label}}:* {{value}}";
+export type WhatsAppMessageOptions = {
+    extra?: Record<string, TokenValue>;
+    fieldTypes?: Record<string, FieldTypeChecks>;
+    /** Row format for `{{*}}`; tokens `{{label}}` and `{{value}}`. Default `*{{label}}:* {{value}}`. */
+    rowTemplate?: null | string;
+    /** Message template. Default `{{*}}`. */
+    template?: null | string;
+};
+/**
+ * The WhatsApp message for these answers: the template with `{{*}}` as one row per answered,
+ * shown field (row labels), `{{key}}` and `{{key.attribute}}` tokens. Empty lines left by empty
+ * tokens are collapsed.
+ */
+export declare function buildWhatsAppMessage(form: FormLike, answers: Answers, options?: WhatsAppMessageOptions): string;
+/** `https://wa.me/<digits>?text=<message encoded with encodeURIComponent>`. */
+export declare function whatsappUrl(number: null | string | undefined, message: string): string;

package/dist/shared/whatsapp.js

@@ -0,0 +1,26 @@
+import { buildMessageRows, buildTemplateValues, interpolate } from './tokens.js';
+export const DEFAULT_WHATSAPP_TEMPLATE = '{{*}}';
+export const DEFAULT_WHATSAPP_ROW_TEMPLATE = '*{{label}}:* {{value}}';
+/**
+ * The WhatsApp message for these answers: the template with `{{*}}` as one row per answered,
+ * shown field (row labels), `{{key}}` and `{{key.attribute}}` tokens. Empty lines left by empty
+ * tokens are collapsed.
+ */ export function buildWhatsAppMessage(form, answers, options = {}) {
+    const rowTemplate = options.rowTemplate?.trim() ? options.rowTemplate : DEFAULT_WHATSAPP_ROW_TEMPLATE;
+    const template = options.template?.trim() ? options.template : DEFAULT_WHATSAPP_TEMPLATE;
+    const rows = buildMessageRows(form, answers, options.fieldTypes);
+    const star = rows.map((row)=>interpolate(rowTemplate, {
+            label: row.label,
+            value: row.value
+        })).join('\n');
+    const values = buildTemplateValues(form, answers, options.extra, options.fieldTypes);
+    const withRows = template.replace(/\{\{\s*\*(?::table)?\s*\}\}/g, ()=>'\u0000ROWS\u0000');
+    const filled = interpolate(withRows, values).split('\u0000ROWS\u0000').join(star);
+    return filled.replace(/\r\n/g, '\n').split('\n').map((line)=>line.replace(/[ \t]+$/g, '')).join('\n').replace(/\n{3,}/g, '\n\n').trim();
+}
+/** `https://wa.me/<digits>?text=<message encoded with encodeURIComponent>`. */ export function whatsappUrl(number, message) {
+    const digits = String(number ?? '').replace(/\D+/g, '');
+    return `https://wa.me/${digits}?text=${encodeURIComponent(message)}`;
+}
+
+//# sourceMappingURL=whatsapp.js.map

package/dist/shared/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/whatsapp.ts"],"sourcesContent":["import type { Answers, FieldTypeChecks, FormLike } from './types.js'\n\nimport { buildMessageRows, buildTemplateValues, interpolate, type TokenValue } from './tokens.js'\n\nexport const DEFAULT_WHATSAPP_TEMPLATE = '{{*}}'\nexport const DEFAULT_WHATSAPP_ROW_TEMPLATE = '*{{label}}:* {{value}}'\n\nexport type WhatsAppMessageOptions = {\n  extra?: Record<string, TokenValue>\n  fieldTypes?: Record<string, FieldTypeChecks>\n  /** Row format for `{{*}}`; tokens `{{label}}` and `{{value}}`. Default `*{{label}}:* {{value}}`. */\n  rowTemplate?: null | string\n  /** Message template. Default `{{*}}`. */\n  template?: null | string\n}\n\n/**\n * The WhatsApp message for these answers: the template with `{{*}}` as one row per answered,\n * shown field (row labels), `{{key}}` and `{{key.attribute}}` tokens. Empty lines left by empty\n * tokens are collapsed.\n */\nexport function buildWhatsAppMessage(\n  form: FormLike,\n  answers: Answers,\n  options: WhatsAppMessageOptions = {},\n): string {\n  const rowTemplate = options.rowTemplate?.trim() ? options.rowTemplate : DEFAULT_WHATSAPP_ROW_TEMPLATE\n  const template = options.template?.trim() ? options.template : DEFAULT_WHATSAPP_TEMPLATE\n  const rows = buildMessageRows(form, answers, options.fieldTypes)\n  const star = rows.map((row) => interpolate(rowTemplate, { label: row.label, value: row.value })).join('\\n')\n  const values = buildTemplateValues(form, answers, options.extra, options.fieldTypes)\n  const withRows = template.replace(/\\{\\{\\s*\\*(?::table)?\\s*\\}\\}/g, () => '\\u0000ROWS\\u0000')\n  const filled = interpolate(withRows, values).split('\\u0000ROWS\\u0000').join(star)\n  return filled\n    .replace(/\\r\\n/g, '\\n')\n    .split('\\n')\n    .map((line) => line.replace(/[ \\t]+$/g, ''))\n    .join('\\n')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim()\n}\n\n/** `https://wa.me/<digits>?text=<message encoded with encodeURIComponent>`. */\nexport function whatsappUrl(number: null | string | undefined, message: string): string {\n  const digits = String(number ?? '').replace(/\\D+/g, '')\n  return `https://wa.me/${digits}?text=${encodeURIComponent(message)}`\n}\n"],"names":["buildMessageRows","buildTemplateValues","interpolate","DEFAULT_WHATSAPP_TEMPLATE","DEFAULT_WHATSAPP_ROW_TEMPLATE","buildWhatsAppMessage","form","answers","options","rowTemplate","trim","template","rows","fieldTypes","star","map","row","label","value","join","values","extra","withRows","replace","filled","split","line","whatsappUrl","number","message","digits","String","encodeURIComponent"],"mappings":"AAEA,SAASA,gBAAgB,EAAEC,mBAAmB,EAAEC,WAAW,QAAyB,cAAa;AAEjG,OAAO,MAAMC,4BAA4B,QAAO;AAChD,OAAO,MAAMC,gCAAgC,yBAAwB;AAWrE;;;;CAIC,GACD,OAAO,SAASC,qBACdC,IAAc,EACdC,OAAgB,EAChBC,UAAkC,CAAC,CAAC;IAEpC,MAAMC,cAAcD,QAAQC,WAAW,EAAEC,SAASF,QAAQC,WAAW,GAAGL;IACxE,MAAMO,WAAWH,QAAQG,QAAQ,EAAED,SAASF,QAAQG,QAAQ,GAAGR;IAC/D,MAAMS,OAAOZ,iBAAiBM,MAAMC,SAASC,QAAQK,UAAU;IAC/D,MAAMC,OAAOF,KAAKG,GAAG,CAAC,CAACC,MAAQd,YAAYO,aAAa;YAAEQ,OAAOD,IAAIC,KAAK;YAAEC,OAAOF,IAAIE,KAAK;QAAC,IAAIC,IAAI,CAAC;IACtG,MAAMC,SAASnB,oBAAoBK,MAAMC,SAASC,QAAQa,KAAK,EAAEb,QAAQK,UAAU;IACnF,MAAMS,WAAWX,SAASY,OAAO,CAAC,gCAAgC,IAAM;IACxE,MAAMC,SAAStB,YAAYoB,UAAUF,QAAQK,KAAK,CAAC,oBAAoBN,IAAI,CAACL;IAC5E,OAAOU,OACJD,OAAO,CAAC,SAAS,MACjBE,KAAK,CAAC,MACNV,GAAG,CAAC,CAACW,OAASA,KAAKH,OAAO,CAAC,YAAY,KACvCJ,IAAI,CAAC,MACLI,OAAO,CAAC,WAAW,QACnBb,IAAI;AACT;AAEA,6EAA6E,GAC7E,OAAO,SAASiB,YAAYC,MAAiC,EAAEC,OAAe;IAC5E,MAAMC,SAASC,OAAOH,UAAU,IAAIL,OAAO,CAAC,QAAQ;IACpD,OAAO,CAAC,cAAc,EAAEO,OAAO,MAAM,EAAEE,mBAAmBH,UAAU;AACtE"}

package/dist/shared/words.d.ts

@@ -0,0 +1,9 @@
+import type { FormWords } from './types.js';
+/**
+ * Starting values of every "Form wording" field. Apps change them per form in Payload, or for
+ * new forms with the plugin's `words` option. `getPublicForm` uses them only for empty fields.
+ */
+export declare const DEFAULT_WORDS: Readonly<FormWords>;
+export declare const WORD_KEYS: Array<keyof FormWords>;
+/** Fills every empty word from `defaults` (default: `DEFAULT_WORDS`). */
+export declare function fillWords(words: null | Partial<Record<keyof FormWords, null | string>> | undefined, defaults?: Partial<FormWords>): FormWords;

package/dist/shared/words.js

@@ -0,0 +1,41 @@
+/**
+ * Starting values of every "Form wording" field. Apps change them per form in Payload, or for
+ * new forms with the plugin's `words` option. `getPublicForm` uses them only for empty fields.
+ */ export const DEFAULT_WORDS = Object.freeze({
+    back: 'Back',
+    chooseOne: 'Choose one',
+    closed: 'This form is closed.',
+    continue: 'Continue',
+    errorPrefix: 'Please check the fields marked below.',
+    fileRejected: '{{label}}: this file cannot be accepted.',
+    genericError: 'Something went wrong. Please try again.',
+    invalid: '{{label}} is not valid.',
+    no: 'No',
+    notFound: 'This form could not be found.',
+    optionalHint: '(optional)',
+    required: '{{label}} is required.',
+    securityCheckFailed: 'The security check failed. Please try again.',
+    send: 'Send',
+    sending: 'Sending…',
+    sent: 'Sent',
+    stepProgress: 'Step {{current}} of {{total}}',
+    success: 'Thanks. Your submission has been received.',
+    tooManyTries: 'Too many tries. Please wait a few minutes and try again.',
+    yes: 'Yes'
+});
+export const WORD_KEYS = Object.keys(DEFAULT_WORDS);
+/** Fills every empty word from `defaults` (default: `DEFAULT_WORDS`). */ export function fillWords(words, defaults = DEFAULT_WORDS) {
+    const out = {
+        ...DEFAULT_WORDS,
+        ...defaults
+    };
+    for (const key of WORD_KEYS){
+        const value = words?.[key];
+        if (typeof value === 'string' && value.trim()) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+
+//# sourceMappingURL=words.js.map

package/dist/shared/words.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/words.ts"],"sourcesContent":["import type { FormWords } from './types.js'\n\n/**\n * Starting values of every \"Form wording\" field. Apps change them per form in Payload, or for\n * new forms with the plugin's `words` option. `getPublicForm` uses them only for empty fields.\n */\nexport const DEFAULT_WORDS: Readonly<FormWords> = Object.freeze({\n  back: 'Back',\n  chooseOne: 'Choose one',\n  closed: 'This form is closed.',\n  continue: 'Continue',\n  errorPrefix: 'Please check the fields marked below.',\n  fileRejected: '{{label}}: this file cannot be accepted.',\n  genericError: 'Something went wrong. Please try again.',\n  invalid: '{{label}} is not valid.',\n  no: 'No',\n  notFound: 'This form could not be found.',\n  optionalHint: '(optional)',\n  required: '{{label}} is required.',\n  securityCheckFailed: 'The security check failed. Please try again.',\n  send: 'Send',\n  sending: 'Sending…',\n  sent: 'Sent',\n  stepProgress: 'Step {{current}} of {{total}}',\n  success: 'Thanks. Your submission has been received.',\n  tooManyTries: 'Too many tries. Please wait a few minutes and try again.',\n  yes: 'Yes',\n})\n\nexport const WORD_KEYS = Object.keys(DEFAULT_WORDS) as Array<keyof FormWords>\n\n/** Fills every empty word from `defaults` (default: `DEFAULT_WORDS`). */\nexport function fillWords(\n  words: null | Partial<Record<keyof FormWords, null | string>> | undefined,\n  defaults: Partial<FormWords> = DEFAULT_WORDS,\n): FormWords {\n  const out = { ...DEFAULT_WORDS, ...defaults } as FormWords\n  for (const key of WORD_KEYS) {\n    const value = words?.[key]\n    if (typeof value === 'string' && value.trim()) {\n      out[key] = value\n    }\n  }\n  return out\n}\n"],"names":["DEFAULT_WORDS","Object","freeze","back","chooseOne","closed","continue","errorPrefix","fileRejected","genericError","invalid","no","notFound","optionalHint","required","securityCheckFailed","send","sending","sent","stepProgress","success","tooManyTries","yes","WORD_KEYS","keys","fillWords","words","defaults","out","key","value","trim"],"mappings":"AAEA;;;CAGC,GACD,OAAO,MAAMA,gBAAqCC,OAAOC,MAAM,CAAC;IAC9DC,MAAM;IACNC,WAAW;IACXC,QAAQ;IACRC,UAAU;IACVC,aAAa;IACbC,cAAc;IACdC,cAAc;IACdC,SAAS;IACTC,IAAI;IACJC,UAAU;IACVC,cAAc;IACdC,UAAU;IACVC,qBAAqB;IACrBC,MAAM;IACNC,SAAS;IACTC,MAAM;IACNC,cAAc;IACdC,SAAS;IACTC,cAAc;IACdC,KAAK;AACP,GAAE;AAEF,OAAO,MAAMC,YAAYtB,OAAOuB,IAAI,CAACxB,eAAwC;AAE7E,uEAAuE,GACvE,OAAO,SAASyB,UACdC,KAAyE,EACzEC,WAA+B3B,aAAa;IAE5C,MAAM4B,MAAM;QAAE,GAAG5B,aAAa;QAAE,GAAG2B,QAAQ;IAAC;IAC5C,KAAK,MAAME,OAAON,UAAW;QAC3B,MAAMO,QAAQJ,OAAO,CAACG,IAAI;QAC1B,IAAI,OAAOC,UAAU,YAAYA,MAAMC,IAAI,IAAI;YAC7CH,GAAG,CAACC,IAAI,GAAGC;QACb;IACF;IACA,OAAOF;AACT"}

package/dist/types.d.ts

@@ -0,0 +1,182 @@
+import type { Block, CollectionConfig, CollectionSlug, Field, PayloadRequest, SendEmailOptions } from 'payload';
+import type { Answers, FieldTypeChecks, FormWords, PublicForm } from './shared/types.js';
+/** A new field type: its block plus the checks the server runs for it. */
+export type FieldTypeDefinition = {
+    /** The admin block. The plugin adds the common input fields (key, required, words, rules…). */
+    block: Block;
+} & FieldTypeChecks;
+export type CollectionOverride = {
+    /** Receives the plugin's fields and returns the field list to use. */
+    fields?: (args: {
+        defaultFields: Field[];
+    }) => Field[];
+} & Partial<Omit<CollectionConfig, 'fields'>>;
+export type OptionSource = {
+    /** Extra fields of each item carried as option attributes (rules and tokens read them). */
+    attributes?: string[];
+    collection: CollectionSlug;
+    /** Field shown to the visitor. */
+    labelField: string;
+    /** Field stored as the answer. */
+    valueField: string;
+};
+/** What a `webhooks.signingSecret` or `webhooks.headers` function receives for each webhook it is asked about. */
+export type WebhookConfigArgs = {
+    form: PublicForm;
+    req: PayloadRequest;
+    webhook: {
+        id: null | string;
+        label: null | string;
+        url: string;
+    };
+};
+/** A value, or a (possibly async) function of the form, request and webhook returning one. */
+export type WebhookConfigValue<T> = ((args: WebhookConfigArgs) => Promise<T | undefined> | T | undefined) | T;
+export type WebhookOptions = {
+    /**
+     * Request headers for every webhook, e.g. an API key from an env var. The webhook's own admin
+     * secret headers replace a config header of the same name (any case); neither can replace
+     * `Content-Type`'s place first or the signature headers.
+     */
+    headers?: WebhookConfigValue<Record<string, string>>;
+    /**
+     * `true` refuses to send a webhook that has no signing secret from either source: no request is
+     * made and its delivery is logged as failed. Default `false`: it is sent unsigned, with one
+     * warning per webhook per server process.
+     */
+    requireSignature?: boolean;
+    /**
+     * Default `true`: each webhook row has the admin-only `signingSecret` and secret `headers`
+     * fields, as in 0.1.0. `false` leaves both fields out of the forms collection, so secrets come
+     * only from this config and none is stored in the database. Turning it off drops the column
+     * and the headers table at the app's next migration; stored values are lost.
+     */
+    secretsInAdmin?: boolean;
+    /**
+     * Signs any webhook whose admin signing secret is empty (the admin secret wins). A string, or a
+     * function returning one, e.g. per webhook label. A `whsec_…` secret also keys the Standard
+     * Webhooks signature with its decoded bytes.
+     */
+    signingSecret?: WebhookConfigValue<string>;
+};
+export type FormsPluginOptions = {
+    /**
+     * Who may read and write webhook secrets in the admin, update or delete submissions and resend.
+     * Default: any logged-in user. Prefer `webhooks.signingSecret` / `webhooks.headers` from env
+     * vars (with `webhooks.secretsInAdmin: false`) over secrets stored in forms.
+     */
+    access?: {
+        isAdmin?: (req: PayloadRequest) => boolean;
+    };
+    /** Overrides for the attachments collection (when the plugin creates it). */
+    attachmentOverrides?: CollectionOverride;
+    /** Private uploads for file fields. `false`: no attachments collection (file uploads can't be turned on). */
+    attachments?: {
+        /** Use the app's own upload collection instead of creating one; the plugin adds its link fields. */
+        collection?: CollectionSlug;
+        /** Largest file in bytes. Default 10 MB. */
+        maxFileSize?: number;
+        /** Largest total per submission in bytes. Default 25 MB. */
+        maxTotalSize?: number;
+        /** Allowed MIME types. Default: PDF, JPEG, PNG, WebP, text, CSV, Word. */
+        mimeTypes?: string[];
+    } | false;
+    /** Gets each email before it is sent (wrap it in a layout, add headers…) and returns the one to send. */
+    beforeEmail?: (message: SendEmailOptions, ctx: {
+        answers: Answers;
+        form: PublicForm;
+        req: PayloadRequest;
+    }) => Promise<SendEmailOptions> | SendEmailOptions;
+    delivery?: {
+        /**
+         * Runs email and webhook delivery after the reply, e.g. `(task) => after(task)` (Next.js) or
+         * `(task) => ctx.waitUntil(task())` (Workers). Default: delivery runs before the reply.
+         */
+        schedule?: (task: () => Promise<void>) => void;
+    };
+    /** Default `true`. `false` returns the config untouched. */
+    enabled?: boolean;
+    /**
+     * Field-type registry keyed by type: `true`/`false` turns a built-in type on or off, a partial
+     * block is merged into the built-in one, a full definition adds a new type. `fileUpload` is off
+     * unless turned on.
+     */
+    fields?: Record<string, boolean | FieldTypeDefinition | Partial<Block>>;
+    /** Overrides for the forms collection. */
+    formOverrides?: CollectionOverride;
+    /** Name of the honeypot field in a submission. Default `_hp`. */
+    honeypotField?: string;
+    /** What a submission keeps about the request. Default: IP off, user agent on. */
+    metadata?: {
+        ip?: boolean;
+        userAgent?: boolean;
+    };
+    /** Collections whose items can be the choices of select, radio and checkbox-group fields. */
+    optionSources?: Record<string, OptionSource>;
+    /** Per form and visitor. Default 5 per 600 s. `false` turns it off. */
+    rateLimit?: {
+        max?: number;
+        windowSeconds?: number;
+    } | false;
+    /** Collection slugs. Default `custom-forms`, `custom-form-submissions`, `custom-form-attachments`. */
+    slugs?: {
+        attachments?: string;
+        forms?: string;
+        submissions?: string;
+    };
+    /** Overrides for the submissions collection. */
+    submissionOverrides?: CollectionOverride;
+    /** Cloudflare Turnstile checked on the server. On with no secret refuses every submission. */
+    turnstile?: {
+        enabled?: boolean;
+        fieldName?: string;
+        secretKey?: string;
+    };
+    /** Webhook secrets and headers from the config, and whether signing is required. */
+    webhooks?: WebhookOptions;
+    whatsapp?: {
+        /** Number for forms that have none. */
+        number?: (args: {
+            form: PublicForm;
+            req: PayloadRequest;
+        }) => Promise<string | undefined> | string | undefined;
+    };
+    /** Default words for new forms, merged over `DEFAULT_WORDS`. */
+    words?: Partial<FormWords>;
+};
+/** The options with every default applied. */
+export type ResolvedOptions = {
+    attachments: {
+        collection: string;
+        createCollection: boolean;
+        maxFileSize: number;
+        maxTotalSize: number;
+        mimeTypes: string[];
+    } | null;
+    fieldTypes: Record<string, FieldTypeChecks>;
+    honeypotField: string;
+    isAdmin: (req: PayloadRequest) => boolean;
+    metadata: {
+        ip: boolean;
+        userAgent: boolean;
+    };
+    rateLimit: {
+        max: number;
+        windowSeconds: number;
+    } | null;
+    slugs: {
+        attachments: string;
+        forms: string;
+        submissions: string;
+    };
+    turnstile: {
+        enabled: boolean;
+        fieldName: string;
+        secretKey: string;
+    };
+    webhooks: {
+        requireSignature: boolean;
+        secretsInAdmin: boolean;
+    } & Pick<WebhookOptions, 'headers' | 'signingSecret'>;
+    words: FormWords;
+} & Pick<FormsPluginOptions, 'beforeEmail' | 'delivery' | 'optionSources' | 'whatsapp'>;

package/dist/types.js

@@ -0,0 +1,3 @@
+/** The options with every default applied. */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n  Block,\n  CollectionConfig,\n  CollectionSlug,\n  Field,\n  PayloadRequest,\n  SendEmailOptions,\n} from 'payload'\n\nimport type { Answers, FieldTypeChecks, FormWords, PublicForm } from './shared/types.js'\n\n/** A new field type: its block plus the checks the server runs for it. */\nexport type FieldTypeDefinition = {\n  /** The admin block. The plugin adds the common input fields (key, required, words, rules…). */\n  block: Block\n} & FieldTypeChecks\n\nexport type CollectionOverride = {\n  /** Receives the plugin's fields and returns the field list to use. */\n  fields?: (args: { defaultFields: Field[] }) => Field[]\n} & Partial<Omit<CollectionConfig, 'fields'>>\n\nexport type OptionSource = {\n  /** Extra fields of each item carried as option attributes (rules and tokens read them). */\n  attributes?: string[]\n  collection: CollectionSlug\n  /** Field shown to the visitor. */\n  labelField: string\n  /** Field stored as the answer. */\n  valueField: string\n}\n\n/** What a `webhooks.signingSecret` or `webhooks.headers` function receives for each webhook it is asked about. */\nexport type WebhookConfigArgs = {\n  form: PublicForm\n  req: PayloadRequest\n  webhook: { id: null | string; label: null | string; url: string }\n}\n\n/** A value, or a (possibly async) function of the form, request and webhook returning one. */\nexport type WebhookConfigValue<T> =\n  | ((args: WebhookConfigArgs) => Promise<T | undefined> | T | undefined)\n  | T\n\nexport type WebhookOptions = {\n  /**\n   * Request headers for every webhook, e.g. an API key from an env var. The webhook's own admin\n   * secret headers replace a config header of the same name (any case); neither can replace\n   * `Content-Type`'s place first or the signature headers.\n   */\n  headers?: WebhookConfigValue<Record<string, string>>\n  /**\n   * `true` refuses to send a webhook that has no signing secret from either source: no request is\n   * made and its delivery is logged as failed. Default `false`: it is sent unsigned, with one\n   * warning per webhook per server process.\n   */\n  requireSignature?: boolean\n  /**\n   * Default `true`: each webhook row has the admin-only `signingSecret` and secret `headers`\n   * fields, as in 0.1.0. `false` leaves both fields out of the forms collection, so secrets come\n   * only from this config and none is stored in the database. Turning it off drops the column\n   * and the headers table at the app's next migration; stored values are lost.\n   */\n  secretsInAdmin?: boolean\n  /**\n   * Signs any webhook whose admin signing secret is empty (the admin secret wins). A string, or a\n   * function returning one, e.g. per webhook label. A `whsec_…` secret also keys the Standard\n   * Webhooks signature with its decoded bytes.\n   */\n  signingSecret?: WebhookConfigValue<string>\n}\n\nexport type FormsPluginOptions = {\n  /**\n   * Who may read and write webhook secrets in the admin, update or delete submissions and resend.\n   * Default: any logged-in user. Prefer `webhooks.signingSecret` / `webhooks.headers` from env\n   * vars (with `webhooks.secretsInAdmin: false`) over secrets stored in forms.\n   */\n  access?: { isAdmin?: (req: PayloadRequest) => boolean }\n  /** Overrides for the attachments collection (when the plugin creates it). */\n  attachmentOverrides?: CollectionOverride\n  /** Private uploads for file fields. `false`: no attachments collection (file uploads can't be turned on). */\n  attachments?:\n    | {\n        /** Use the app's own upload collection instead of creating one; the plugin adds its link fields. */\n        collection?: CollectionSlug\n        /** Largest file in bytes. Default 10 MB. */\n        maxFileSize?: number\n        /** Largest total per submission in bytes. Default 25 MB. */\n        maxTotalSize?: number\n        /** Allowed MIME types. Default: PDF, JPEG, PNG, WebP, text, CSV, Word. */\n        mimeTypes?: string[]\n      }\n    | false\n  /** Gets each email before it is sent (wrap it in a layout, add headers…) and returns the one to send. */\n  beforeEmail?: (\n    message: SendEmailOptions,\n    ctx: { answers: Answers; form: PublicForm; req: PayloadRequest },\n  ) => Promise<SendEmailOptions> | SendEmailOptions\n  delivery?: {\n    /**\n     * Runs email and webhook delivery after the reply, e.g. `(task) => after(task)` (Next.js) or\n     * `(task) => ctx.waitUntil(task())` (Workers). Default: delivery runs before the reply.\n     */\n    schedule?: (task: () => Promise<void>) => void\n  }\n  /** Default `true`. `false` returns the config untouched. */\n  enabled?: boolean\n  /**\n   * Field-type registry keyed by type: `true`/`false` turns a built-in type on or off, a partial\n   * block is merged into the built-in one, a full definition adds a new type. `fileUpload` is off\n   * unless turned on.\n   */\n  fields?: Record<string, boolean | FieldTypeDefinition | Partial<Block>>\n  /** Overrides for the forms collection. */\n  formOverrides?: CollectionOverride\n  /** Name of the honeypot field in a submission. Default `_hp`. */\n  honeypotField?: string\n  /** What a submission keeps about the request. Default: IP off, user agent on. */\n  metadata?: { ip?: boolean; userAgent?: boolean }\n  /** Collections whose items can be the choices of select, radio and checkbox-group fields. */\n  optionSources?: Record<string, OptionSource>\n  /** Per form and visitor. Default 5 per 600 s. `false` turns it off. */\n  rateLimit?: { max?: number; windowSeconds?: number } | false\n  /** Collection slugs. Default `custom-forms`, `custom-form-submissions`, `custom-form-attachments`. */\n  slugs?: { attachments?: string; forms?: string; submissions?: string }\n  /** Overrides for the submissions collection. */\n  submissionOverrides?: CollectionOverride\n  /** Cloudflare Turnstile checked on the server. On with no secret refuses every submission. */\n  turnstile?: { enabled?: boolean; fieldName?: string; secretKey?: string }\n  /** Webhook secrets and headers from the config, and whether signing is required. */\n  webhooks?: WebhookOptions\n  whatsapp?: {\n    /** Number for forms that have none. */\n    number?: (args: {\n      form: PublicForm\n      req: PayloadRequest\n    }) => Promise<string | undefined> | string | undefined\n  }\n  /** Default words for new forms, merged over `DEFAULT_WORDS`. */\n  words?: Partial<FormWords>\n}\n\n/** The options with every default applied. */\nexport type ResolvedOptions = {\n  attachments: {\n    collection: string\n    createCollection: boolean\n    maxFileSize: number\n    maxTotalSize: number\n    mimeTypes: string[]\n  } | null\n  fieldTypes: Record<string, FieldTypeChecks>\n  honeypotField: string\n  isAdmin: (req: PayloadRequest) => boolean\n  metadata: { ip: boolean; userAgent: boolean }\n  rateLimit: { max: number; windowSeconds: number } | null\n  slugs: { attachments: string; forms: string; submissions: string }\n  turnstile: { enabled: boolean; fieldName: string; secretKey: string }\n  webhooks: {\n    requireSignature: boolean\n    secretsInAdmin: boolean\n  } & Pick<WebhookOptions, 'headers' | 'signingSecret'>\n  words: FormWords\n} & Pick<FormsPluginOptions, 'beforeEmail' | 'delivery' | 'optionSources' | 'whatsapp'>\n"],"names":[],"mappings":"AA+IA,4CAA4C,GAC5C,WAoBuF"}