@beechcms/core 0.4.3 → 0.5.0

package/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EAKN,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAgFnB;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsBtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAuB5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAkBpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAgCxD;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,aAAkB,GAAG,kBAAkB,CAqE5F;AA+GD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,CAc7D;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAmCrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BzE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EAKN,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAgFnB;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAsBtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAuB5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAkBpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAgCxD;AAID;;;;GAIG;AAGH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,aAAkB,GAAG,kBAAkB,CAqE5F;AAgHD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,CAc7D;AAID;;;GAGG;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAmCrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BzE"}

package/dist/engine.js

@@ -212,6 +212,7 @@ export function generateFtsTriggers(seed) {
  * Never uses json_extract — every column is a real column.
  * Unknown columns in filters/orderBy are ignored (fail-closed).
  */
+//TODO: buildSelectQuery ha troppe responsabilità, va suddiviso in più funzioni
 export function buildSelectQuery(seed, options = {}) {
     const table = tableName(seed);
     const { filters = [], orderBy, pagination, status, search, fields } = options;
@@ -278,6 +279,7 @@ export function buildSelectQuery(seed, options = {}) {
     }
     return { sql, bindings };
 }
+//TODO: normalizeFilterValue ha troppe responsabilità, va suddiviso in più funzioni
 function normalizeFilterValue(type, value) {
     if (value === null || value === undefined)
         return null;
@@ -286,7 +288,7 @@ function normalizeFilterValue(type, value) {
             return value;
         if (typeof value === 'string' && value.trim() !== '') {
             const d = new Date(value);
-            return isNaN(d.getTime()) ? null : Math.floor(d.getTime() / 1000);
+            return Number.isNaN(d.getTime()) ? null : Math.floor(d.getTime() / 1000);
         }
         return null;
     }
@@ -298,12 +300,13 @@ function normalizeFilterValue(type, value) {
             return value;
         if (typeof value === 'string' && value.trim() !== '') {
             const n = Number(value);
-            return isNaN(n) ? null : n;
+            return Number.isNaN(n) ? null : n;
         }
         return null;
     }
     return value;
 }
+//TODO: buildFilterCondition ha troppe responsabilità, va suddiviso in più funzioni
 function buildFilterCondition(col, type, cond, bindings) {
     const { op, value } = cond;
     if (op === 'is_empty') {
@@ -392,6 +395,7 @@ export function getExpectedColumns(seed) {
  * Serializes a value for writing to the DB.
  * boolean → 0/1 | date → Unix timestamp | json/asset-list → JSON string
  */
+//TODO: serializeForDb ha troppe responsabilità, va suddiviso in più funzioni
 export function serializeForDb(branch, value) {
     if (value === null || value === undefined)
         return null;
@@ -407,7 +411,7 @@ export function serializeForDb(branch, value) {
                 return value;
             if (typeof value === 'string') {
                 const d = new Date(value);
-                if (isNaN(d.getTime()))
+                if (Number.isNaN(d.getTime()))
                     return null;
                 if (branch.format === 'date') {
                     const midnight = Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());

package/dist/types.d.ts

@@ -1,4 +1,27 @@
 export type BranchType = 'text' | 'number' | 'boolean' | 'json' | 'date' | 'richtext' | 'file' | 'tags';
+/** Configurazioni specializzate per il tipo di branch 'number' */
+export interface NumberFieldOptions {
+    /** Stile di presentazione visiva. Default: 'decimal' */
+    format?: 'decimal' | 'currency' | 'percentage' | 'compact';
+    /** Codice valuta ISO 4217 (obbligatorio se format === 'currency'). Es. 'EUR', 'USD' */
+    currency?: string;
+    /** Testo personalizzato da anteporre al valore formattato */
+    prefix?: string;
+    /** Unità di misura personalizzata da appendere al valore formattato (es. 'kg', 'm²') */
+    suffix?: string;
+    /** Numero esplicito di cifre decimali da visualizzare e imporre */
+    decimals?: number;
+    /** Abilita/disabilita il separatore delle migliaia. Default: true */
+    grouping?: boolean;
+    /** Meccanismo di input alternativo per l'editor delle entità. Default: 'input' */
+    control?: 'input' | 'slider' | 'rating' | 'stepper';
+    /** Valore minimo consentito */
+    min?: number;
+    /** Valore massimo consentito */
+    max?: number;
+    /** Incremento del valore (es. 1 per interi stretti, 0.5 per mezzi passi) */
+    step?: number;
+}
 /** Branch: definizione di una proprietà. alias = nome colonna SQL. */
 export interface Branch {
     /** Alias human-readable, usato nel payload API e come nome colonna SQL nella tabella dedicata */
@@ -45,6 +68,8 @@ export interface Branch {
         /** Il campo è incluso nelle risposte della Public API. Default: true */
         public?: boolean;
     };
+    /** Opzioni avanzate per i campi numerici. Ignorato se type !== 'number' */
+    numberOptions?: NumberFieldOptions;
 }
 /** Dashboard-specific config embedded in a Seed. All fields optional — defaults applied by the dashboard. */
 export interface DashboardSeedConfig {

package/dist/types.d.ts.map

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

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC/B,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAqaD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAmH3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,GAAG,QAAQ,GAAG,WAAW,CAE9F;AAED;;;;;GAKG"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC/B,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAgkBD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAyC3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,GAAG,QAAQ,GAAG,WAAW,CAE9F;AAED;;;;;GAKG"}

package/dist/validation.js

@@ -225,91 +225,130 @@ function requiredAliases(seed, operation) {
         .filter((branch) => (operation === 'create' ? branch.requiredOnCreate : branch.requiredOnUpdate))
         .map((branch) => branch.alias);
 }
-function buildBranchSchema(branch, options) {
-    const nullable = options.allowNull ? z.null() : null;
-    const preprocessEmpty = (schema) => z.preprocess((val) => (val === '' || val === null ? (options.allowNull ? null : undefined) : val), schema.optional());
-    switch (branch.type) {
-        case 'text': {
-            const schema = stringSchema
-                .transform((value) => sanitizePlainString(value))
-                .refine((value) => value.length <= options.maxTextLength, {
-                message: `Expected string(max:${options.maxTextLength})`,
+function getPreprocessEmpty(allowNull) {
+    return (schema) => z.preprocess((val) => (val === '' || val === null ? (allowNull ? null : undefined) : val), schema.optional());
+}
+function buildTextSchema(options, nullable) {
+    const schema = stringSchema
+        .transform((value) => sanitizePlainString(value))
+        .refine((value) => value.length <= options.maxTextLength, {
+        message: `Expected string(max:${options.maxTextLength})`,
+    });
+    return nullable ? z.union([schema, nullable]) : schema;
+}
+function buildRichtextSchema(options, nullable) {
+    const schema = z.any().transform((value, ctx) => {
+        const sanitized = sanitizeRichtext(value);
+        if (!sanitized.valid) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'Expected richtext-json|string',
+                params: { expected: 'richtext-json|string' },
             });
-            return nullable ? z.union([schema, nullable]) : schema;
         }
-        case 'richtext': {
-            const schema = z.any().transform((value, ctx) => {
-                const sanitized = sanitizeRichtext(value);
-                if (!sanitized.valid) {
-                    ctx.addIssue({
-                        code: 'custom',
-                        message: 'Expected richtext-json|string',
-                        params: { expected: 'richtext-json|string' },
-                    });
-                }
-                if (sanitized.size > options.maxTextLength) {
-                    ctx.addIssue({
-                        code: 'custom',
-                        message: `Expected richtext(max:${options.maxTextLength})`,
-                        params: { expected: `richtext(max:${options.maxTextLength})` },
-                    });
-                }
-                if (sanitized.dangerous) {
-                    ctx.addIssue({
-                        code: 'custom',
-                        message: 'Dangerous richtext content',
-                        params: { dangerous: true },
-                    });
-                }
-                return sanitized.value;
+        if (sanitized.size > options.maxTextLength) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `Expected richtext(max:${options.maxTextLength})`,
+                params: { expected: `richtext(max:${options.maxTextLength})` },
             });
-            return nullable ? z.union([schema, nullable]) : schema;
         }
-        case 'number': {
-            const schema = preprocessEmpty(finiteNumberSchema);
-            return nullable ? z.union([schema, nullable]) : schema;
+        if (sanitized.dangerous) {
+            ctx.addIssue({
+                code: 'custom',
+                message: 'Dangerous richtext content',
+                params: { dangerous: true },
+            });
         }
-        case 'boolean': {
-            const schema = preprocessEmpty(booleanSchema);
-            return nullable ? z.union([schema, nullable]) : schema;
+        return sanitized.value;
+    });
+    return nullable ? z.union([schema, nullable]) : schema;
+}
+function buildNumberSchema(branch, allowNull, nullable) {
+    const opts = branch.numberOptions;
+    const numSchema = z.number();
+    const refinedSchema = numSchema.superRefine((val, ctx) => {
+        if (!Number.isFinite(val)) {
+            ctx.addIssue({ code: 'custom', message: 'Expected finite number' });
+            return z.NEVER;
         }
-        case 'date': {
-            const schema = preprocessEmpty(stringSchema
-                .transform((value) => sanitizePlainString(value))
-                .refine((value) => isIsoDateString(value), { message: 'Expected date(ISO)' }));
+        if (opts?.min !== undefined && val < opts.min) {
+            ctx.addIssue({ code: 'custom', message: `Expected number(min:${opts.min})` });
+            return z.NEVER;
+        }
+        if (opts?.max !== undefined && val > opts.max) {
+            ctx.addIssue({ code: 'custom', message: `Expected number(max:${opts.max})` });
+            return z.NEVER;
+        }
+        if (opts?.step !== undefined) {
+            const step = opts.step;
+            const min = opts.min ?? 0;
+            const valDecimals = (val.toString().split('.')[1] || '').length;
+            const stepDecimals = (step.toString().split('.')[1] || '').length;
+            const decimals = Math.max(valDecimals, stepDecimals);
+            const multiplier = Math.pow(10, decimals);
+            if ((Math.round((val - min) * multiplier) % Math.round(step * multiplier)) !== 0) {
+                ctx.addIssue({ code: 'custom', message: `Expected number(step:${step})` });
+            }
+        }
+    });
+    const schema = getPreprocessEmpty(allowNull)(refinedSchema);
+    return nullable ? z.union([schema, nullable]) : schema;
+}
+function buildDateSchema(allowNull, nullable) {
+    const schema = getPreprocessEmpty(allowNull)(stringSchema
+        .transform((value) => sanitizePlainString(value))
+        .refine((value) => isIsoDateString(value), { message: 'Expected date(ISO)' }));
+    return nullable ? z.union([schema, nullable]) : schema;
+}
+function buildFileSchema(branch, allowNull, nullable) {
+    if (isAssetListBranch(branch)) {
+        const schema = getPreprocessEmpty(allowNull)(z.any()
+            .transform((rawValue, ctx) => {
+            const normalized = normalizeAssetListValue(rawValue);
+            if (!normalized) {
+                ctx.addIssue({ code: 'custom', message: 'Expected url-string[]' });
+                return z.NEVER;
+            }
+            return normalized;
+        })
+            .pipe(z.array(z.string().url())));
+        return nullable ? z.union([schema, nullable]) : schema;
+    }
+    const schema = getPreprocessEmpty(allowNull)(z.any()
+        .transform((rawValue, ctx) => {
+        const normalized = normalizeHttpUrl(rawValue);
+        if (!normalized) {
+            ctx.addIssue({ code: 'custom', message: 'Expected url-string' });
+            return z.NEVER;
+        }
+        return normalized;
+    })
+        .pipe(z.string().url()));
+    return nullable ? z.union([schema, nullable]) : schema;
+}
+function buildBranchSchema(branch, options) {
+    const nullable = options.allowNull ? z.null() : null;
+    switch (branch.type) {
+        case 'text':
+            return buildTextSchema(options, nullable);
+        case 'richtext':
+            return buildRichtextSchema(options, nullable);
+        case 'number':
+            return buildNumberSchema(branch, options.allowNull, nullable);
+        case 'boolean': {
+            const schema = getPreprocessEmpty(options.allowNull)(booleanSchema);
             return nullable ? z.union([schema, nullable]) : schema;
         }
+        case 'date':
+            return buildDateSchema(options.allowNull, nullable);
         case 'json':
         case 'tags': {
-            const schema = preprocessEmpty(jsonObjectOrArraySchema);
-            return nullable ? z.union([schema, nullable]) : schema;
-        }
-        case 'file': {
-            if (isAssetListBranch(branch)) {
-                const schema = preprocessEmpty(z.any()
-                    .transform((rawValue, ctx) => {
-                    const normalized = normalizeAssetListValue(rawValue);
-                    if (!normalized) {
-                        ctx.addIssue({ code: 'custom', message: 'Expected url-string[]' });
-                        return z.NEVER;
-                    }
-                    return normalized;
-                })
-                    .pipe(z.array(z.string().url())));
-                return nullable ? z.union([schema, nullable]) : schema;
-            }
-            const schema = preprocessEmpty(z.any()
-                .transform((rawValue, ctx) => {
-                const normalized = normalizeHttpUrl(rawValue);
-                if (!normalized) {
-                    ctx.addIssue({ code: 'custom', message: 'Expected url-string' });
-                    return z.NEVER;
-                }
-                return normalized;
-            })
-                .pipe(z.string().url()));
+            const schema = getPreprocessEmpty(options.allowNull)(jsonObjectOrArraySchema);
             return nullable ? z.union([schema, nullable]) : schema;
         }
+        case 'file':
+            return buildFileSchema(branch, options.allowNull, nullable);
         default:
             throw new Error(`Unhandled branch type: ${branch.type}`);
     }
@@ -325,6 +364,7 @@ function seedFingerprint(seed) {
             multiple: branch.multiple ?? false,
             requiredOnCreate: branch.requiredOnCreate ?? false,
             requiredOnUpdate: branch.requiredOnUpdate ?? false,
+            numberOptions: branch.numberOptions ?? null,
         })),
     });
 }
@@ -370,29 +410,9 @@ function isIsoDateString(value) {
     const d = new Date(parsed);
     return d.toISOString().startsWith(value.substring(0, 10));
 }
-/**
- * Common foundation for schema-driven validation and sanitization of payloads.
- * Used by the Public API and reusable in the Botanical Engine.
- *
- * Mandatory execution order at the time of writing:
- *   validate raw → hash (privacy policy) → store
- * Hashing occurs AFTER validation, not before.
- * This ensures that the validated value is the original raw value,
- * not the digest — avoiding false failures on fields with formats (e.g., email).
- */
-export function validateAndSanitizeSeedPayload(seed, payload, options = {}) {
-    const normalizedOptions = {
-        allowNull: options.allowNull ?? false,
-        operation: options.operation ?? 'create',
-        requireAtLeastOneValidField: options.requireAtLeastOneValidField ?? true,
-        enforceRequiredFields: options.enforceRequiredFields ?? true,
-        maxTextLength: options.maxTextLength ?? DEFAULT_MAX_TEXT_LENGTH,
-    };
-    const details = [];
-    const data = {};
+function filterPayloadAliases(seed, payload) {
     const unknownAliases = [];
-    const dangerousFields = [];
-    const requiredFieldsMissing = [];
+    const details = [];
     const allowedAliases = new Set(seed.branches.map((branch) => branch.alias));
     const filteredPayload = {};
     for (const [alias, rawValue] of Object.entries(payload)) {
@@ -408,67 +428,100 @@ export function validateAndSanitizeSeedPayload(seed, payload, options = {}) {
         }
         filteredPayload[alias] = rawValue;
     }
-    const schema = compileSeedSchema(seed, normalizedOptions);
-    const parsed = schema.safeParse(filteredPayload);
-    if (parsed.success) {
-        Object.assign(data, parsed.data);
-    }
-    else {
-        for (const issue of parsed.error.issues) {
-            if (issue.code === 'unrecognized_keys') {
-                for (const alias of issue.keys) {
-                    unknownAliases.push(alias);
-                    details.push({
-                        field: alias,
-                        expected: 'known-seed-alias',
-                        received: 'unknown-alias',
-                        message: `Field '${alias}' is not defined in seed '${seed.slug}'`,
-                    });
-                }
-                continue;
-            }
-            if (issue.message === 'Required' && normalizedOptions.enforceRequiredFields) {
-                continue; // Let enforceRequiredFields logic below handle it properly with detailed messages
-            }
-            const field = String(issue.path[0] ?? 'payload');
-            const receivedValue = filteredPayload[field];
-            const expected = typeof issue.message === 'string' && issue.message.startsWith('Expected ')
-                ? issue.message.replace('Expected ', '')
-                : 'valid-field-value';
-            if (issue.params?.dangerous === true) {
-                dangerousFields.push(field);
-            }
-            details.push(makeDetail(field, expected, receivedValue));
-        }
-    }
-    if (normalizedOptions.enforceRequiredFields) {
-        for (const branch of seed.branches) {
-            const isRequired = normalizedOptions.operation === 'create' ? branch.requiredOnCreate : branch.requiredOnUpdate;
-            if (!isRequired)
-                continue;
-            const hasProvidedAlias = Object.hasOwn(payload, branch.alias);
-            if (!hasProvidedAlias) {
-                requiredFieldsMissing.push(branch.alias);
-                details.push({
-                    field: branch.alias,
-                    expected: 'required-field',
-                    received: 'missing',
-                    message: `Field '${branch.alias}' is required for ${normalizedOptions.operation}`,
-                });
-                continue;
-            }
-            const valueToCheck = parsed.success ? data[branch.alias] : filteredPayload[branch.alias];
-            if (isMissingRequiredValue(valueToCheck)) {
-                requiredFieldsMissing.push(branch.alias);
+    return { filteredPayload, unknownAliases, unknownDetails: details };
+}
+function collectZodIssueDetails(seed, issues, filteredPayload, normalizedOptions) {
+    const unknownAliases = [];
+    const details = [];
+    const dangerousFields = [];
+    for (const issue of issues) {
+        if (issue.code === 'unrecognized_keys') {
+            for (const alias of issue.keys) {
+                unknownAliases.push(alias);
                 details.push({
-                    field: branch.alias,
-                    expected: 'required-field',
-                    received: 'empty',
-                    message: `Field '${branch.alias}' cannot be empty for ${normalizedOptions.operation}`,
+                    field: alias,
+                    expected: 'known-seed-alias',
+                    received: 'unknown-alias',
+                    message: `Field '${alias}' is not defined in seed '${seed.slug}'`,
                 });
             }
+            continue;
+        }
+        if (issue.message === 'Required' && normalizedOptions.enforceRequiredFields) {
+            continue; // Let enforceRequiredFields logic handle it properly
+        }
+        const field = String(issue.path[0] ?? 'payload');
+        const receivedValue = filteredPayload[field];
+        const expected = typeof issue.message === 'string' && issue.message.startsWith('Expected ')
+            ? issue.message.replace('Expected ', '')
+            : 'valid-field-value';
+        if (issue.params?.dangerous === true) {
+            dangerousFields.push(field);
+        }
+        details.push(makeDetail(field, expected, receivedValue));
+    }
+    return { unknownAliases, zodDetails: details, dangerousFields };
+}
+function enforceRequiredFields(seed, payload, filteredPayload, data, isSuccess, normalizedOptions) {
+    const requiredFieldsMissing = [];
+    const details = [];
+    for (const branch of seed.branches) {
+        const isRequired = normalizedOptions.operation === 'create' ? branch.requiredOnCreate : branch.requiredOnUpdate;
+        if (!isRequired)
+            continue;
+        const hasProvidedAlias = Object.hasOwn(payload, branch.alias);
+        if (!hasProvidedAlias) {
+            requiredFieldsMissing.push(branch.alias);
+            details.push({
+                field: branch.alias,
+                expected: 'required-field',
+                received: 'missing',
+                message: `Field '${branch.alias}' is required for ${normalizedOptions.operation}`,
+            });
+            continue;
+        }
+        const valueToCheck = isSuccess ? data[branch.alias] : filteredPayload[branch.alias];
+        if (isMissingRequiredValue(valueToCheck)) {
+            requiredFieldsMissing.push(branch.alias);
+            details.push({
+                field: branch.alias,
+                expected: 'required-field',
+                received: 'empty',
+                message: `Field '${branch.alias}' cannot be empty for ${normalizedOptions.operation}`,
+            });
         }
     }
+    return { requiredFieldsMissing, requiredDetails: details };
+}
+/**
+ * Common foundation for schema-driven validation and sanitization of payloads.
+ * Used by the Public API and reusable in the Botanical Engine.
+ *
+ * Mandatory execution order at the time of writing:
+ *   validate raw → hash (privacy policy) → store
+ * Hashing occurs AFTER validation, not before.
+ * This ensures that the validated value is the original raw value,
+ * not the digest — avoiding false failures on fields with formats (e.g., email).
+ */
+export function validateAndSanitizeSeedPayload(seed, payload, options = {}) {
+    const normalizedOptions = {
+        allowNull: options.allowNull ?? false,
+        operation: options.operation ?? 'create',
+        requireAtLeastOneValidField: options.requireAtLeastOneValidField ?? true,
+        enforceRequiredFields: options.enforceRequiredFields ?? true,
+        maxTextLength: options.maxTextLength ?? DEFAULT_MAX_TEXT_LENGTH,
+    };
+    const { filteredPayload, unknownAliases: initialUnknown, unknownDetails } = filterPayloadAliases(seed, payload);
+    const schema = compileSeedSchema(seed, normalizedOptions);
+    const parsed = schema.safeParse(filteredPayload);
+    const data = parsed.success ? { ...parsed.data } : {};
+    const { unknownAliases: zodUnknown, zodDetails, dangerousFields } = parsed.success
+        ? { unknownAliases: [], zodDetails: [], dangerousFields: [] }
+        : collectZodIssueDetails(seed, parsed.error.issues, filteredPayload, normalizedOptions);
+    const { requiredFieldsMissing, requiredDetails } = normalizedOptions.enforceRequiredFields
+        ? enforceRequiredFields(seed, payload, filteredPayload, data, parsed.success, normalizedOptions)
+        : { requiredFieldsMissing: [], requiredDetails: [] };
+    const details = [...unknownDetails, ...zodDetails, ...requiredDetails];
     if (normalizedOptions.requireAtLeastOneValidField && Object.keys(data).length === 0) {
         details.push({
             field: 'data',
@@ -480,7 +533,7 @@ export function validateAndSanitizeSeedPayload(seed, payload, options = {}) {
     return {
         data,
         details,
-        unknownAliases: [...new Set(unknownAliases)],
+        unknownAliases: [...new Set([...initialUnknown, ...zodUnknown])],
         dangerousFields: [...new Set(dangerousFields)],
         requiredFieldsMissing,
         hasAnyValidField: Object.keys(data).length > 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beechcms/core",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",