form0-core 0.1.16 → 0.1.17

package/README.md

@@ -57,6 +57,9 @@ Record-side utilities follow this contract:
 - `normalizeStructuredRecord()` consumes and returns canonical stored records
 - `buildFormRecordSnapshot()` consumes canonical stored records and returns renderer snapshot values
 - `projectDatasetRowValues()` consumes canonical stored rows
+- Choice `FIELD_SPECS` keep separate validators by context:
+  - `valueValidator` validates live engine / renderer values
+  - `recordValueValidator` validates canonical stored record values
 
 Record status remains top-level as `@status`; it is not stored inside `form_values`.
 

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "form0-core",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
-  "description": "Schema-driven engine that powers form0 ecosystem.",
+  "description": "Schema-driven engine that powers form0 ecosystem. Looking for the full form0 ecosystem? Install the CLI: `npm install -g form0-cli`",
   "main": "src/index.js",
   "type": "module",
   "scripts": {
     "test": "node tests/form0-core.test.js && node tests/dataset-descriptors.test.js && node tests/structured-record.test.js && node tests/builtin-metadata.test.js && node tests/calculation-editor.test.js && node tests/form-event-editor.test.js && node tests/security-test.js",
-    "postinstall": "node scripts/postinstall.cjs",
     "format": "prettier --write \"**/*.{js,jsx,json,ts,tsx,md}\"",
     "format:check": "prettier --check \"**/*.{js,jsx,json,ts,tsx,md}\""
   },

package/scripts/{postinstall.cjs → legacy-postinstall-message.cjs}

@@ -1,3 +1,7 @@
+// Legacy reference only.
+// This script is intentionally not wired into package.json lifecycle hooks.
+// It is retained as a reference for the previous install-time guidance message.
+
 const PACKAGE_NAME = 'form0-core';
 
 const npmUserAgent = process.env.npm_config_user_agent || '';

package/src/index.js

@@ -6,6 +6,12 @@ export {
   buildFormRecordSnapshot,
 } from './utilities/structured-record.js';
 export { validateSchema } from './schema/schema-validator.js';
+export {
+  validateFieldValue,
+  validateRecordFieldValue,
+  getFieldValueValidator,
+  getRecordFieldValueValidator,
+} from './schema/field-value-registry.js';
 //export { validateSchema, resolveSupportingImagePath } from './schema/schema-validator.js';
 export { generateKey } from './utilities/hash.js';
 export {

package/src/schema/field-specs.js

@@ -1,4 +1,5 @@
 import { validateChoiceFieldChoices } from '../utilities/field-helpers.js';
+import { validateStoredChoiceValue } from '../utilities/choice-value-shapes.js';
 import {
   isNonEmptyString,
   validateFormLinkRecordDefaults,
@@ -316,6 +317,10 @@ export const FIELD_SPECS = {
       }
       return null;
     },
+    recordValueValidator: (field, value) =>
+      validateStoredChoiceValue(field, value, {
+        context: 'FIELD_SPECS.recordValueValidator',
+      }),
     defaultProducer: (field) => {
       if (field.default_value) {
         const choice = field.choices.find((c) => c.value === field.default_value);
@@ -466,6 +471,10 @@ export const FIELD_SPECS = {
       }
       return null;
     },
+    recordValueValidator: (field, value) =>
+      validateStoredChoiceValue(field, value, {
+        context: 'FIELD_SPECS.recordValueValidator',
+      }),
     defaultProducer: (field) => {
       if (field.default_value) {
         const selectedChoices = field.choices
@@ -596,6 +605,10 @@ export const FIELD_SPECS = {
       }
       return null;
     },
+    recordValueValidator: (field, value) =>
+      validateStoredChoiceValue(field, value, {
+        context: 'FIELD_SPECS.recordValueValidator',
+      }),
     defaultProducer: (field) => {
       if (field.default_value) {
         const choice = field.choices.find((c) => c.value === field.default_value);

package/src/schema/field-value-registry.js

@@ -19,6 +19,29 @@ export function validateFieldValue(field, value) {
   return null;
 }
 
+/**
+ * Validates a structured-record field value against its specification
+ * @param {object} field - The field definition
+ * @param {any} value - The stored record value to validate
+ * @returns {string|null} - Error message if validation fails, or null if valid
+ */
+export function validateRecordFieldValue(field, value) {
+  const spec = FIELD_SPECS[field.type];
+  if (!spec) {
+    return `Unsupported field type: ${field.type}`;
+  }
+
+  if (typeof spec.recordValueValidator === 'function') {
+    return spec.recordValueValidator(field, value);
+  }
+
+  if (typeof spec.valueValidator === 'function') {
+    return spec.valueValidator(field, value);
+  }
+
+  return null;
+}
+
 /**
  * Returns the value validator function for a field type
  * @param {string} fieldType - The field type
@@ -29,6 +52,25 @@ export function getFieldValueValidator(fieldType) {
   return spec ? spec.valueValidator : null;
 }
 
+/**
+ * Returns the structured-record value validator function for a field type
+ * Falls back to the live value validator when no record-specific validator exists.
+ * @param {string} fieldType - The field type
+ * @returns {function|null} - The record value validator function or null if not found
+ */
+export function getRecordFieldValueValidator(fieldType) {
+  const spec = FIELD_SPECS[fieldType];
+  if (!spec) {
+    return null;
+  }
+
+  if (typeof spec.recordValueValidator === 'function') {
+    return spec.recordValueValidator;
+  }
+
+  return typeof spec.valueValidator === 'function' ? spec.valueValidator : null;
+}
+
 /**
  * Validates TextField value
  * @param {object} field - The field definition

package/src/utilities/choice-value-shapes.js

@@ -213,6 +213,34 @@ export function normalizeStoredChoiceValue(field, rawValue, options = {}) {
   return normalized;
 }
 
+export function validateStoredChoiceValue(field, rawValue, options = {}) {
+  try {
+    const normalized = normalizeStoredChoiceValue(field, rawValue, options);
+    const kind = getChoiceKind(field);
+    const fieldIdentifier = toFieldIdentifier(field);
+
+    if (normalized && kind === 'single' && toFieldType(field) === 'BooleanField') {
+      if (normalized.other_value.length > 0) {
+        return `${fieldIdentifier} does not support 'other_value' values`;
+      }
+    }
+
+    if (normalized && kind !== null && toFieldType(field) !== 'BooleanField') {
+      if (field.allow_other !== true && normalized.other_value.length > 0) {
+        return `${fieldIdentifier} does not allow 'other_value' values`;
+      }
+    }
+
+    return null;
+  } catch (error) {
+    if (error instanceof Error) {
+      return error.message.replace(/^\[form0\] [^:]+: /, '');
+    }
+
+    return 'stored choice value is invalid';
+  }
+}
+
 export function toRendererChoiceValue(field, rawValue, options = {}) {
   const kind = getChoiceKind(field);
   if (!kind || rawValue === null || typeof rawValue === 'undefined') {