@standards/schema 0.0.0-stage → 1.0.0-alpha.382

package/dist/index-DLO8JpnY.d.ts

@@ -0,0 +1,53 @@
+
+import { n as Attribute } from "./attributes-kAhQzg8-.js";
+import { z as z$1 } from "zod";
+//#region src/validation/core/types.d.ts
+/**
+ * Validation messages for Zod validators.
+ * All functions receive the full Attribute to access label, type, etc.
+ * Can be customized for i18n support.
+ */
+interface ValidationMessages {
+  required: (attr: Attribute) => string;
+  invalidType: (attr: Attribute, expected: string) => string;
+  minLength: (attr: Attribute, min: number) => string;
+  maxLength: (attr: Attribute, max: number) => string;
+  invalidPattern: (attr: Attribute) => string;
+  minValue: (attr: Attribute, min: number) => string;
+  maxValue: (attr: Attribute, max: number) => string;
+  mustBeInteger: (attr: Attribute) => string;
+  invalidDate: (attr: Attribute) => string;
+  invalidOption: (attr: Attribute, options: string[]) => string;
+  invalidId: (attr: Attribute) => string;
+  maxItems: (attr: Attribute, max: number) => string;
+  invalidRichtext: (attr: Attribute) => string;
+  invalidPhone: (attr: Attribute) => string;
+  invalidCurrency: (attr: Attribute) => string;
+  invalidLocation: (attr: Attribute) => string;
+}
+/**
+ * Validation result
+ */
+interface ValidationResult {
+  success: boolean;
+  data?: Record<string, unknown>;
+  errors?: Array<{
+    path: string[];
+    message: string;
+  }>;
+}
+//#endregion
+//#region src/validation/core/messages.d.ts
+declare const DEFAULT_VALIDATION_MESSAGES: ValidationMessages;
+//#endregion
+//#region src/validation/core/errors.d.ts
+/**
+ * Format Zod validation errors into a consistent structure.
+ * This eliminates code duplication across multiple validation functions.
+ */
+declare function formatZodErrors(error: z$1.ZodError): Array<{
+  path: string[];
+  message: string;
+}>;
+//#endregion
+export { ValidationResult as i, DEFAULT_VALIDATION_MESSAGES as n, ValidationMessages as r, formatZodErrors as t };

package/dist/index-DPO5w-fC.d.mts

@@ -0,0 +1,101 @@
+
+import { i as ObjectDefinition } from "./objects-C9f6hFW_.mjs";
+import { n as Attribute } from "./attributes-aTeqx6cK.mjs";
+import { i as ValidationResult, r as ValidationMessages } from "./index-3HZjBOpj.mjs";
+import { z as z$1 } from "zod";
+//#region src/validation/object/attribute-factory.d.ts
+/**
+ * Create a Zod schema for any attribute type.
+ * Returns a strict validator that does NOT handle optional fields.
+ * Use createFormAttributeValidator for form validation with optional support.
+ *
+ * @param attr - The attribute to create a validator for
+ * @param messages - Custom validation messages for i18n support
+ */
+declare function createAttributeValidator(attr: Attribute, messages?: ValidationMessages): z$1.ZodTypeAny;
+/**
+ * Create a Zod schema for form validation.
+ * - Normalizes empty values (empty strings, empty objects) to null for optional fields
+ * - Accepts custom messages for i18n support
+ *
+ * Use this in UI forms where optional fields may have null/undefined values.
+ *
+ * @param attr - The attribute to create a validator for
+ * @param messages - Custom validation messages for i18n support
+ */
+declare function createFormAttributeValidator(attr: Attribute, messages?: ValidationMessages): z$1.ZodTypeAny;
+//#endregion
+//#region src/validation/object/object-validator.d.ts
+/**
+ * Create a Zod schema for an entire object
+ *
+ * Uses passthrough mode to allow computed fields (formula, rollup) that may be
+ * present in record data but are not part of the mutable schema.
+ *
+ * Result is cached per ObjectDefinition instance — safe because ObjectDefinitions
+ * are stable after module load and never mutated at runtime.
+ */
+declare function createObjectValidator(objectDef: ObjectDefinition): z$1.ZodType<Record<string, unknown>>;
+/**
+ * Create a Zod schema for draft validation.
+ * All attributes become optional, but provided values are still validated.
+ *
+ * Uses passthrough mode to allow computed fields (formula, rollup) that may be
+ * present in record data but are not part of the mutable schema.
+ *
+ * Result is cached per ObjectDefinition instance — safe because ObjectDefinitions
+ * are stable after module load and never mutated at runtime.
+ */
+declare function createDraftValidator(objectDef: ObjectDefinition): z$1.ZodType<Record<string, unknown>>;
+//#endregion
+//#region src/validation/object/helpers.d.ts
+/**
+ * Validate data against an attribute schema
+ */
+declare function validateAttribute(attr: Attribute, value: unknown): ValidationResult;
+/**
+ * Validate data against an object schema
+ */
+declare function validateObject(objectDef: ObjectDefinition, data: Record<string, unknown>): ValidationResult;
+/**
+ * Validate and throw if invalid.
+ *
+ * Throws `ValidationError` (code `SCHEMA_VALIDATION_FAILED`) on failure so HTTP
+ * adapters can map it to 400. Generic `Error` would bubble up to a 500.
+ */
+declare function validateObjectOrThrow(objectDef: ObjectDefinition, data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Validate data in draft mode.
+ * - All attributes are treated as optional (no required validation)
+ * - Provided values are still validated for format/type correctness
+ */
+declare function validateDraft(objectDef: ObjectDefinition, data: Record<string, unknown>): ValidationResult;
+/**
+ * Validate draft data and throw if format validation fails.
+ *
+ * Same contract as `validateObjectOrThrow` but skips `required()` checks.
+ * Throws `ValidationError` so HTTP adapters map it to 400.
+ */
+declare function validateDraftOrThrow(objectDef: ObjectDefinition, data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Throw a `ValidationError` when `data` contains keys that do not correspond
+ * to any attribute declared on `objectDef`.
+ *
+ * Call this on **client-supplied input** before Zod validation so the error
+ * message clearly names every offending key.  Do NOT call on merged data that
+ * includes existing record values — older records may legitimately carry stale
+ * keys that predate this guard (see issue #658).
+ *
+ * Maps to HTTP 400 via `SchemaExceptionFilter` (code SCHEMA_VALIDATION_FAILED).
+ */
+declare function rejectUnknownAttributesOrThrow(objectDef: ObjectDefinition, data: Record<string, unknown>): void;
+/**
+ * Get the list of required attributes that are missing values.
+ */
+declare function getMissingRequiredAttributes(objectDef: ObjectDefinition, data: Record<string, unknown>): Attribute[];
+/**
+ * Check if a record is complete (all required attributes have valid values).
+ */
+declare function isRecordComplete(objectDef: ObjectDefinition, data: Record<string, unknown>): boolean;
+//#endregion
+export { validateDraft as a, validateObjectOrThrow as c, createAttributeValidator as d, createFormAttributeValidator as f, validateAttribute as i, createDraftValidator as l, isRecordComplete as n, validateDraftOrThrow as o, rejectUnknownAttributesOrThrow as r, validateObject as s, getMissingRequiredAttributes as t, createObjectValidator as u };