@reso-standards/reso-validation 0.1.0

package/LICENSE

@@ -0,0 +1,11 @@
+REAL ESTATE STANDARDS ORGANIZATION
+End-user License Agreement (EULA)
+
+By downloading these resources, you confirm that you agree to the RESO EULA: https://www.reso.org/eula/
+
+Contact Information:
+Attn:     Sam DeBord, Chief Executive Officer
+Address:  P.O. Box 10824
+          Raleigh, NC 27605
+Phone:    206.658.3225
+Email:    sam@reso.org

package/README.md

@@ -0,0 +1,109 @@
+# @reso-standards/validation
+
+Isomorphic TypeScript validation library for RESO Data Dictionary records. Validates field types, lengths, and ranges against metadata, plus resource-specific business rules with cross-field constraints. Zero external dependencies.
+
+> **[User Guide](doc/GUIDE.md)** – a task-oriented walkthrough with realistic examples.
+
+## Install
+
+This package isn't on npm yet. Install from the [`reso-tools`](https://github.com/RESOStandards/reso-tools) monorepo on GitHub:
+
+```bash
+git clone https://github.com/RESOStandards/reso-tools.git
+cd reso-tools/reso-validation
+npm install
+```
+
+This package has no sibling dependencies — `npm install` just runs. To bootstrap every package at once, run `npm run bootstrap` from the repo root instead.
+
+To consume the SDK from another project, link it locally with `npm link` or use a `file:` dependency.
+
+## Usage
+
+```typescript
+import { validateRecord, validateBusinessRules, getBusinessRules } from '@reso-standards/validation';
+import type { ResoField, ValidationFailure } from '@reso-standards/validation';
+
+// Validate a record against field metadata
+const failures = validateRecord(record, fields);
+
+// Validate resource-specific business rules
+const ruleFailures = validateBusinessRules('Property', record);
+
+// Get the rule definitions for a resource
+const rules = getBusinessRules('Property');
+```
+
+## API
+
+### `validateRecord(body, fields): ValidationFailure[]`
+
+Validates a record payload against RESO field metadata. Checks:
+
+- **Unknown fields** – fields not in metadata
+- **Type mismatches** – Edm.String, Edm.Boolean, Edm.Int32, Edm.Decimal, Edm.Date, Edm.DateTimeOffset, etc.
+- **Negative numerics** – rejects negative values for numeric types
+- **MaxLength** – strings exceeding `field.maxLength`
+- **Integer enforcement** – Int types must be whole numbers
+- **Collection fields** – must be arrays
+- **Enum fields** – must be string or number
+- **Business rules** – delegates to `validateBusinessRules()` for range/relationship checks
+
+Null, undefined, and empty string values are silently skipped unless the field is required. Fields starting with `@` (OData annotations) are ignored.
+
+### `validateBusinessRules(resourceName, body): ValidationFailure[]`
+
+Validates resource-specific constraints:
+
+**Property:**
+- Required: City, StateOrProvince, PostalCode, Country
+- Price fields (> 0 to $1B): ListPrice, OriginalListPrice, PreviousListPrice, ClosePrice, ListPriceLow
+- Room counts (0 to 100): BedroomsTotal, BathroomsFull, BathroomsHalf, etc.
+- Expense/fee/amount fields ($0 to $10K): matched via `fieldPattern` regex `/(?:Expense|Amount|Fee\d?)$/`
+- Latitude and Longitude are exempt from the non-negative rule (negative coordinates are valid)
+- Cross-field: `BathroomsTotalInteger = sum(BathroomsFull + BathroomsHalf + ...)`
+
+**Member:** Required MemberCity, MemberStateOrProvince, MemberPostalCode, MemberCountry
+
+**Office:** Required OfficeCity, OfficeStateOrProvince, OfficePostalCode, OfficeCountry
+
+### `getBusinessRules(resourceName): FieldRule[]`
+
+Returns the per-field constraint definitions for a resource.
+
+### Type Helpers
+
+- `isEnumType(type)` – true if type is an enum reference (not a primitive Edm type)
+- `isNumericEdmType(type)` – true for Edm.Decimal, Edm.Int32, Edm.Double, etc.
+- `isIntegerEdmType(type)` – true for Edm.Int16, Edm.Int32, Edm.Int64, Edm.Byte
+
+## Types
+
+```typescript
+interface ValidationFailure {
+  readonly field: string;
+  readonly reason: string;
+}
+
+interface FieldRule {
+  readonly fieldName: string;
+  readonly fieldPattern?: RegExp;  // regex alternative to fieldName for matching multiple fields
+  readonly required?: boolean;
+  readonly min?: number;
+  readonly max?: number;
+  readonly message?: string;
+}
+
+interface CrossFieldRule {
+  readonly name: string;
+  readonly validate: (body: Record<string, unknown>) => ValidationFailure | null;
+}
+```
+
+## Integration
+
+Used by both the reference server (request body validation on POST/PATCH) and the React UI (client-side form validation). Also used by `@reso-standards/certification` for payload validation in compliance testing.
+
+## License
+
+See [LICENSE](https://github.com/RESOStandards/reso-tools/blob/main/LICENSE) in the repository root.

package/dist/business-rules/index.d.ts

@@ -0,0 +1,15 @@
+import type { ValidationFailure } from '../metadata/types.js';
+import type { CrossFieldRule, FieldRule } from './types.js';
+export type { CrossFieldRule, FieldRule } from './types.js';
+/** Returns the per-field business rules for a given resource (empty array if none). */
+export declare const getBusinessRules: (resourceName: string) => ReadonlyArray<FieldRule>;
+/** Returns the cross-field business rules for a given resource (empty array if none). */
+export declare const getCrossFieldRules: (resourceName: string) => ReadonlyArray<CrossFieldRule>;
+/**
+ * Validates a record against business rules for the given resource.
+ * Checks per-field range rules first, then cross-field relationship rules.
+ * When `skipRequired` is true (e.g., for PATCH partial updates), required-field checks are skipped.
+ * Returns an array of failures (empty if valid).
+ */
+export declare const validateBusinessRules: (resourceName: string, body: Readonly<Record<string, unknown>>, skipRequired?: boolean) => ReadonlyArray<ValidationFailure>;
+//# sourceMappingURL=index.d.ts.map

package/dist/business-rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/business-rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAc5D,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,GAAI,cAAc,MAAM,KAAG,aAAa,CAAC,SAAS,CAA0C,CAAC;AAE1H,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,GAAI,cAAc,MAAM,KAAG,aAAa,CAAC,cAAc,CAAgD,CAAC;AAevI;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,MAAM,EACpB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,sBAAoB,KACnB,aAAa,CAAC,iBAAiB,CA+CjC,CAAC"}

package/dist/business-rules/index.js

@@ -0,0 +1,87 @@
+import { MEMBER_RULES } from './member-rules.js';
+import { OFFICE_RULES } from './office-rules.js';
+import { PROPERTY_CROSS_RULES, PROPERTY_RULES } from './property-rules.js';
+/** Per-field rule registry keyed by resource name. */
+const RULES_BY_RESOURCE = {
+    Property: PROPERTY_RULES,
+    Member: MEMBER_RULES,
+    Office: OFFICE_RULES
+};
+/** Cross-field rule registry keyed by resource name. */
+const CROSS_RULES_BY_RESOURCE = {
+    Property: PROPERTY_CROSS_RULES
+};
+/** Returns the per-field business rules for a given resource (empty array if none). */
+export const getBusinessRules = (resourceName) => RULES_BY_RESOURCE[resourceName] ?? [];
+/** Returns the cross-field business rules for a given resource (empty array if none). */
+export const getCrossFieldRules = (resourceName) => CROSS_RULES_BY_RESOURCE[resourceName] ?? [];
+/** Formats a default error message for a range violation. */
+const formatRangeMessage = (rule, value) => {
+    if (rule.message)
+        return rule.message;
+    if (rule.min !== undefined && value < rule.min) {
+        return `Must be at least ${rule.min.toLocaleString('en-US')}.`;
+    }
+    if (rule.max !== undefined && value > rule.max) {
+        return `Must be at most ${rule.max.toLocaleString('en-US')}.`;
+    }
+    /* v8 ignore next 2 */
+    return 'Value is out of range.';
+};
+/**
+ * Validates a record against business rules for the given resource.
+ * Checks per-field range rules first, then cross-field relationship rules.
+ * When `skipRequired` is true (e.g., for PATCH partial updates), required-field checks are skipped.
+ * Returns an array of failures (empty if valid).
+ */
+export const validateBusinessRules = (resourceName, body, skipRequired = false) => {
+    const failures = [];
+    // Per-field rules
+    const rules = getBusinessRules(resourceName);
+    if (rules.length > 0) {
+        const exactRules = new Map();
+        const patternRules = [];
+        for (const r of rules) {
+            if (r.fieldPattern)
+                patternRules.push(r);
+            else
+                exactRules.set(r.fieldName, r);
+        }
+        // Required field checks — iterate rules looking for missing fields
+        // Skipped for partial updates (PATCH) where only supplied fields are validated
+        if (!skipRequired) {
+            for (const rule of rules) {
+                if (!rule.required)
+                    continue;
+                const value = body[rule.fieldName];
+                if (value === undefined || value === null || value === '') {
+                    failures.push({ field: rule.fieldName, reason: rule.message ?? `${rule.fieldName} is required.` });
+                }
+            }
+        }
+        // Range checks — iterate body fields looking for out-of-range values
+        for (const [key, value] of Object.entries(body)) {
+            if (typeof value !== 'number')
+                continue;
+            // Check exact match first, then pattern rules
+            const rule = exactRules.get(key) ?? patternRules.find(r => r.fieldPattern.test(key));
+            if (!rule)
+                continue;
+            if (rule.min !== undefined && value < rule.min) {
+                failures.push({ field: key, reason: formatRangeMessage(rule, value) });
+            }
+            else if (rule.max !== undefined && value > rule.max) {
+                failures.push({ field: key, reason: formatRangeMessage(rule, value) });
+            }
+        }
+    }
+    // Cross-field relationship rules
+    const crossRules = getCrossFieldRules(resourceName);
+    for (const crossRule of crossRules) {
+        const failure = crossRule.validate(body);
+        if (failure)
+            failures.push(failure);
+    }
+    return failures;
+};
+//# sourceMappingURL=index.js.map

package/dist/business-rules/index.js.map

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

package/dist/business-rules/member-rules.d.ts

@@ -0,0 +1,4 @@
+import type { FieldRule } from './types.js';
+/** Per-field rules for the Member resource. */
+export declare const MEMBER_RULES: ReadonlyArray<FieldRule>;
+//# sourceMappingURL=member-rules.d.ts.map

package/dist/business-rules/member-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-rules.d.ts","sourceRoot":"","sources":["../../src/business-rules/member-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,+CAA+C;AAC/C,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,SAAS,CAMjD,CAAC"}

package/dist/business-rules/member-rules.js

@@ -0,0 +1,9 @@
+/** Per-field rules for the Member resource. */
+export const MEMBER_RULES = [
+    // Required address fields
+    { fieldName: 'MemberCity', required: true },
+    { fieldName: 'MemberStateOrProvince', required: true },
+    { fieldName: 'MemberPostalCode', required: true },
+    { fieldName: 'MemberCountry', required: true }
+];
+//# sourceMappingURL=member-rules.js.map

package/dist/business-rules/member-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-rules.js","sourceRoot":"","sources":["../../src/business-rules/member-rules.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAA6B;IACpD,0BAA0B;IAC1B,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,EAAE,SAAS,EAAE,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE;IACtD,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjD,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;CAC/C,CAAC"}

package/dist/business-rules/office-rules.d.ts

@@ -0,0 +1,4 @@
+import type { FieldRule } from './types.js';
+/** Per-field rules for the Office resource. */
+export declare const OFFICE_RULES: ReadonlyArray<FieldRule>;
+//# sourceMappingURL=office-rules.d.ts.map

package/dist/business-rules/office-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"office-rules.d.ts","sourceRoot":"","sources":["../../src/business-rules/office-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,+CAA+C;AAC/C,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,SAAS,CAMjD,CAAC"}

package/dist/business-rules/office-rules.js

@@ -0,0 +1,9 @@
+/** Per-field rules for the Office resource. */
+export const OFFICE_RULES = [
+    // Required address fields
+    { fieldName: 'OfficeCity', required: true },
+    { fieldName: 'OfficeStateOrProvince', required: true },
+    { fieldName: 'OfficePostalCode', required: true },
+    { fieldName: 'OfficeCountry', required: true }
+];
+//# sourceMappingURL=office-rules.js.map

package/dist/business-rules/office-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"office-rules.js","sourceRoot":"","sources":["../../src/business-rules/office-rules.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAA6B;IACpD,0BAA0B;IAC1B,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,EAAE,SAAS,EAAE,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE;IACtD,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjD,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;CAC/C,CAAC"}

package/dist/business-rules/property-rules.d.ts

@@ -0,0 +1,6 @@
+import type { CrossFieldRule, FieldRule } from './types.js';
+/** Per-field rules for the Property resource. */
+export declare const PROPERTY_RULES: ReadonlyArray<FieldRule>;
+/** Cross-field rules for the Property resource. */
+export declare const PROPERTY_CROSS_RULES: ReadonlyArray<CrossFieldRule>;
+//# sourceMappingURL=property-rules.d.ts.map

package/dist/business-rules/property-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-rules.d.ts","sourceRoot":"","sources":["../../src/business-rules/property-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmC5D,iDAAiD;AACjD,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,SAAS,CAmCnD,CAAC;AAaF,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,cAAc,CA2B9D,CAAC"}

package/dist/business-rules/property-rules.js

@@ -0,0 +1,97 @@
+/** Maximum allowed value for price fields. */
+const MAX_PRICE = 1_000_000_000;
+/** Maximum allowed value for bedroom/bathroom count fields. */
+const MAX_ROOM_COUNT = 100;
+/** Maximum allowed value for expense, fee, and amount fields. */
+const MAX_EXPENSE = 10_000;
+const priceRule = (fieldName) => ({
+    fieldName,
+    min: 0.01,
+    max: MAX_PRICE
+});
+const roomCountRule = (fieldName) => ({
+    fieldName,
+    min: 0,
+    max: MAX_ROOM_COUNT
+});
+const requiredRule = (fieldName) => ({
+    fieldName,
+    required: true
+});
+/**
+ * Pattern matching expense, fee, and amount fields by name suffix.
+ * Matches: CableTvExpense, AssociationFee, AssociationFee2, TaxAnnualAmount, etc.
+ * Does NOT match: LotSizeSquareFeet (ends with "Feet", not "Fee").
+ */
+const EXPENSE_FEE_AMOUNT_PATTERN = /(?:Expense|Amount|Fee\d?)$/;
+/** Per-field rules for the Property resource. */
+export const PROPERTY_RULES = [
+    // Required address fields
+    requiredRule('City'),
+    requiredRule('StateOrProvince'),
+    requiredRule('PostalCode'),
+    requiredRule('Country'),
+    // Price fields (must be > $0)
+    priceRule('ListPrice'),
+    priceRule('OriginalListPrice'),
+    priceRule('PreviousListPrice'),
+    priceRule('ClosePrice'),
+    priceRule('ListPriceLow'),
+    // Expense, fee, and amount fields (pattern-matched)
+    {
+        fieldName: 'expenses/fees/amounts',
+        fieldPattern: EXPENSE_FEE_AMOUNT_PATTERN,
+        min: 0,
+        max: MAX_EXPENSE
+    },
+    // Bedroom fields
+    roomCountRule('BedroomsTotal'),
+    roomCountRule('BedroomsPossible'),
+    roomCountRule('MainLevelBedrooms'),
+    // Bathroom fields
+    roomCountRule('BathroomsTotalInteger'),
+    roomCountRule('BathroomsFull'),
+    roomCountRule('BathroomsHalf'),
+    roomCountRule('BathroomsOneQuarter'),
+    roomCountRule('BathroomsPartial'),
+    roomCountRule('BathroomsThreeQuarter'),
+    roomCountRule('MainLevelBathrooms')
+];
+// --- Cross-field helpers ---
+/** Extracts a numeric value from a record field, or returns null if absent/non-numeric. */
+const numericField = (body, field) => {
+    const v = body[field];
+    return typeof v === 'number' ? v : null;
+};
+/** Bathroom part fields that should sum to BathroomsTotalInteger. */
+const BATHROOM_PARTS = ['BathroomsFull', 'BathroomsHalf', 'BathroomsPartial', 'BathroomsOneQuarter', 'BathroomsThreeQuarter'];
+/** Cross-field rules for the Property resource. */
+export const PROPERTY_CROSS_RULES = [
+    {
+        name: 'BathroomsTotalInteger = sum of parts',
+        validate: body => {
+            const total = numericField(body, 'BathroomsTotalInteger');
+            if (total === null)
+                return null;
+            let sum = 0;
+            let hasParts = false;
+            for (const part of BATHROOM_PARTS) {
+                const v = numericField(body, part);
+                if (v !== null) {
+                    sum += v;
+                    hasParts = true;
+                }
+            }
+            if (!hasParts)
+                return null;
+            if (total !== sum) {
+                return {
+                    field: 'BathroomsTotalInteger',
+                    reason: `BathroomsTotalInteger (${total}) must equal the sum of bathroom parts (${sum}).`
+                };
+            }
+            return null;
+        }
+    }
+];
+//# sourceMappingURL=property-rules.js.map

package/dist/business-rules/property-rules.js.map

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

package/dist/business-rules/types.d.ts

@@ -0,0 +1,18 @@
+import type { ValidationFailure } from '../metadata/types.js';
+/** A per-field constraint for a specific field within a resource. */
+export interface FieldRule {
+    readonly fieldName: string;
+    /** Pattern to match multiple field names. When set, fieldName is a descriptive label. */
+    readonly fieldPattern?: RegExp;
+    readonly required?: boolean;
+    readonly min?: number;
+    readonly max?: number;
+    /** Custom error message. If omitted, a default is generated from min/max or required. */
+    readonly message?: string;
+}
+/** A cross-field constraint that validates relationships between multiple fields. */
+export interface CrossFieldRule {
+    readonly name: string;
+    readonly validate: (body: Readonly<Record<string, unknown>>) => ValidationFailure | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/business-rules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/business-rules/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,iBAAiB,GAAG,IAAI,CAAC;CAC1F"}

package/dist/business-rules/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/business-rules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/business-rules/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { CrossFieldRule, FieldRule, ResoAnnotation, ResoField, ValidationFailure } from './metadata/index.js';
+export { getBusinessRules, isEnumType, isIntegerEdmType, isNumericEdmType, validateBusinessRules, validateRecord } from './metadata/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnH,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACf,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { getBusinessRules, isEnumType, isIntegerEdmType, isNumericEdmType, validateBusinessRules, validateRecord } from './metadata/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACf,MAAM,qBAAqB,CAAC"}

package/dist/metadata/helpers.d.ts

@@ -0,0 +1,7 @@
+/** Checks whether a field type is an enum reference (not a primitive Edm type). */
+export declare const isEnumType: (type: string) => boolean;
+/** Checks if an Edm type is numeric. */
+export declare const isNumericEdmType: (type: string) => boolean;
+/** Checks if an Edm type is an integer (no decimals allowed). */
+export declare const isIntegerEdmType: (type: string) => boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/metadata/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/metadata/helpers.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAGnF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OAAmC,CAAC;AAE9E,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAC+D,CAAC;AAEhH,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAA6E,CAAC"}

package/dist/metadata/helpers.js

@@ -0,0 +1,9 @@
+/** Checks whether a field type is an enum reference (not a primitive Edm type). */
+// TODO(#222): duplicate of reso-common's isEnumType — consolidate to one shared helper and
+// prefer the precomputed isEnumeration flag where a field is in hand. See reso-tools #222.
+export const isEnumType = (type) => !type.startsWith('Edm.');
+/** Checks if an Edm type is numeric. */
+export const isNumericEdmType = (type) => ['Edm.Decimal', 'Edm.Int64', 'Edm.Int32', 'Edm.Int16', 'Edm.Double', 'Edm.Single', 'Edm.Byte'].includes(type);
+/** Checks if an Edm type is an integer (no decimals allowed). */
+export const isIntegerEdmType = (type) => ['Edm.Int64', 'Edm.Int32', 'Edm.Int16', 'Edm.Byte'].includes(type);
+//# sourceMappingURL=helpers.js.map

package/dist/metadata/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/metadata/helpers.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,2FAA2F;AAC3F,2FAA2F;AAC3F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAE9E,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE,CACxD,CAAC,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAEhH,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC"}

package/dist/metadata/index.d.ts

@@ -0,0 +1,6 @@
+export type { ResoAnnotation, ResoField, ValidationFailure } from './types.js';
+export type { CrossFieldRule, FieldRule } from '../business-rules/index.js';
+export { getBusinessRules, validateBusinessRules } from '../business-rules/index.js';
+export { isEnumType, isIntegerEdmType, isNumericEdmType } from './helpers.js';
+export { validateRecord } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/metadata/index.js

@@ -0,0 +1,4 @@
+export { getBusinessRules, validateBusinessRules } from '../business-rules/index.js';
+export { isEnumType, isIntegerEdmType, isNumericEdmType } from './helpers.js';
+export { validateRecord } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/metadata/types.d.ts

@@ -0,0 +1,24 @@
+/** Annotation entry from RESO metadata (e.g., StandardName, Description, DDWikiUrl). */
+export interface ResoAnnotation {
+    readonly term: string;
+    readonly value: string;
+}
+/** A field definition from the RESO Data Dictionary metadata. */
+export interface ResoField {
+    readonly resourceName: string;
+    readonly fieldName: string;
+    readonly type: string;
+    readonly typeName?: string;
+    readonly nullable?: boolean;
+    readonly isCollection?: boolean;
+    readonly maxLength?: number;
+    readonly scale?: number;
+    readonly precision?: number;
+    readonly annotations: ReadonlyArray<ResoAnnotation>;
+}
+/** A validation failure for a single field. */
+export interface ValidationFailure {
+    readonly field: string;
+    readonly reason: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/metadata/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metadata/types.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACrD;AAED,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/metadata/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/metadata/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metadata/types.ts"],"names":[],"mappings":""}

package/dist/metadata/validate.d.ts

@@ -0,0 +1,16 @@
+import type { ResoField, ValidationFailure } from './types.js';
+/**
+ * Validates a record against the resource's field definitions.
+ *
+ * Checks for:
+ * - Unknown fields (not in metadata)
+ * - Null/undefined/empty-string passthrough (no error)
+ * - Negative numeric values
+ * - MaxLength enforcement for strings
+ * - Integer-only enforcement for Int types
+ * - Basic type mismatches (string, number, boolean, date, enum, collection)
+ *
+ * Returns an array of failures (empty if valid).
+ */
+export declare const validateRecord: (body: Readonly<Record<string, unknown>>, fields: ReadonlyArray<ResoField>, skipRequired?: boolean) => ReadonlyArray<ValidationFailure>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/metadata/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/metadata/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK/D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,QAAQ,aAAa,CAAC,SAAS,CAAC,EAChC,sBAAoB,KACnB,aAAa,CAAC,iBAAiB,CAmDjC,CAAC"}

package/dist/metadata/validate.js

@@ -0,0 +1,121 @@
+import { validateBusinessRules } from '../business-rules/index.js';
+import { isEnumType, isNumericEdmType } from './helpers.js';
+/** Fields that legitimately hold negative numeric values (e.g., coordinates). */
+const ALLOW_NEGATIVE_FIELDS = new Set(['Latitude', 'Longitude']);
+/**
+ * Validates a record against the resource's field definitions.
+ *
+ * Checks for:
+ * - Unknown fields (not in metadata)
+ * - Null/undefined/empty-string passthrough (no error)
+ * - Negative numeric values
+ * - MaxLength enforcement for strings
+ * - Integer-only enforcement for Int types
+ * - Basic type mismatches (string, number, boolean, date, enum, collection)
+ *
+ * Returns an array of failures (empty if valid).
+ */
+export const validateRecord = (body, fields, skipRequired = false) => {
+    const fieldMap = new Map(fields.map(f => [f.fieldName, f]));
+    const failures = [];
+    for (const [key, value] of Object.entries(body)) {
+        // Skip OData annotations
+        if (key.startsWith('@'))
+            continue;
+        const field = fieldMap.get(key);
+        if (!field) {
+            failures.push({
+                field: key,
+                reason: `'${key}' is not a recognized field. Check field name spelling or consult the metadata.`
+            });
+            continue;
+        }
+        // Skip null, undefined, and empty string values
+        if (value === null || value === undefined || value === '')
+            continue;
+        // Check negative numerics (Latitude/Longitude are allowed to be negative)
+        if (typeof value === 'number' && value < 0 && isNumericEdmType(field.type) && !ALLOW_NEGATIVE_FIELDS.has(key)) {
+            failures.push({ field: key, reason: 'Value must be greater than or equal to 0.' });
+            continue;
+        }
+        // MaxLength for strings
+        if (typeof value === 'string' && field.maxLength && value.length > field.maxLength) {
+            failures.push({ field: key, reason: `Exceeds maximum length of ${field.maxLength} characters (currently ${value.length}).` });
+            continue;
+        }
+        // Basic type validation
+        const typeError = validateFieldType(key, value, field);
+        if (typeError) {
+            failures.push(typeError);
+        }
+    }
+    // Field-specific business rules (range constraints, etc.)
+    // Skip fields that already have type-level failures to avoid duplicate errors.
+    const resourceName = fields[0]?.resourceName;
+    if (resourceName) {
+        const failedFields = new Set(failures.map(f => f.field));
+        const ruleFailures = validateBusinessRules(resourceName, body, skipRequired);
+        for (const rf of ruleFailures) {
+            if (!failedFields.has(rf.field))
+                failures.push(rf);
+        }
+    }
+    return failures;
+};
+/** Validates a single field value against its expected Edm type. */
+const validateFieldType = (fieldName, value, field) => {
+    if (field.isCollection) {
+        if (!Array.isArray(value)) {
+            return { field: fieldName, reason: 'Must be a list of values.' };
+        }
+        return undefined;
+    }
+    if (isEnumType(field.type)) {
+        if (typeof value !== 'string' && typeof value !== 'number') {
+            return { field: fieldName, reason: 'Please select a valid option from the list.' };
+        }
+        return undefined;
+    }
+    switch (field.type) {
+        case 'Edm.String':
+            if (typeof value !== 'string') {
+                return { field: fieldName, reason: 'Must be text.' };
+            }
+            break;
+        case 'Edm.Boolean':
+            if (typeof value !== 'boolean') {
+                return { field: fieldName, reason: 'Must be true or false.' };
+            }
+            break;
+        case 'Edm.Int64':
+        case 'Edm.Int32':
+        case 'Edm.Int16':
+        case 'Edm.Byte':
+            if (typeof value !== 'number') {
+                return { field: fieldName, reason: 'Must be a whole number.' };
+            }
+            if (!Number.isInteger(value)) {
+                return { field: fieldName, reason: 'Must be a whole number (no decimals).' };
+            }
+            break;
+        case 'Edm.Decimal':
+        case 'Edm.Double':
+        case 'Edm.Single':
+            if (typeof value !== 'number') {
+                return { field: fieldName, reason: 'Must be a number.' };
+            }
+            break;
+        case 'Edm.Date':
+            if (typeof value !== 'string') {
+                return { field: fieldName, reason: 'Must be a date (YYYY-MM-DD).' };
+            }
+            break;
+        case 'Edm.DateTimeOffset':
+            if (typeof value !== 'string') {
+                return { field: fieldName, reason: 'Must be a date and time.' };
+            }
+            break;
+    }
+    return undefined;
+};
+//# sourceMappingURL=validate.js.map

package/dist/metadata/validate.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@reso-standards/reso-validation",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RESOStandards/reso-tools.git",
+    "directory": "reso-validation"
+  },
+  "description": "RESO validation library — isomorphic, no Node/browser APIs.",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./metadata": {
+      "types": "./dist/metadata/index.d.ts",
+      "import": "./dist/metadata/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.9",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.9"
+  }
+}