@luca-financial/luca-schema 3.0.0 → 3.0.2

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.2] - 2026-02-14
+
+### Changed
+
+- Export `SCHEMA_VERSION` for consumers to read the contract version without schema-shape coupling.
+- Add tests to verify `SCHEMA_VERSION` matches `lucaSchema.properties.schemaVersion.const` and example schemaVersion values.
+- Update README validator utilities docs to include `SCHEMA_VERSION`.
+
+## [3.0.1] - 2026-02-14
+
+### Changed
+
+- Pin `lucaSchema.properties.schemaVersion` to contract version `3.0.0`.
+- Remove schema-side date repair helpers and date-fix metadata from validator APIs.
+- Keep schema package focused on contract validation and migration utilities.
+- Refresh dependency/tooling versions after `pnpm upgrade` (including `ajv`, `@babel/core`, `@babel/preset-env`, `prettier`, and `typescript-eslint`).
+- Regenerate `pnpm-lock.yaml` to capture updated transitive dependency resolutions.
+
 ## [3.0.0] - 2026-02-13
 
 ### Changed

package/README.md

@@ -214,7 +214,7 @@ Validates the full ledger export.
 
 ```typescript
 const lucaSchema = {
-  schemaVersion: string;
+  schemaVersion: '3.0.0';
   categories: Category[];
   accounts: Account[];
   statements: Statement[];
@@ -231,10 +231,9 @@ This module exports helper utilities to inspect schemas and validate data:
 
 ```typescript
 import {
+  SCHEMA_VERSION,
   validate,
   validateCollection,
-  normalizeDateString,
-  isDateStringFixable,
   getDateFieldPaths,
   getDateFieldPathsByCollection,
   getValidFields,
@@ -246,10 +245,9 @@ import {
 } from '@luca-financial/luca-schema';
 ```
 
-- `validate(schemaKey, data)` → `{ valid: boolean, errors: AjvError[], metadata: { dateFormatIssues, hasFixableDateFormatIssues } }`
-- `validateCollection(schemaKey, array)` → `{ valid: boolean, errors: [{ index, entity, errors, metadata }], metadata: { hasFixableDateFormatIssues } }`
-- `normalizeDateString(value)` → normalized `YYYY-MM-DD` for unambiguous date strings (`YYYY-MM-DD` or `YYYY/MM/DD`), else `null`
-- `isDateStringFixable(value)` → `true` only for unambiguous slash date strings that can be safely normalized
+- `SCHEMA_VERSION` → schema contract version from `lucaSchema.properties.schemaVersion.const`
+- `validate(schemaKey, data)` → `{ valid: boolean, errors: AjvError[] }`
+- `validateCollection(schemaKey, array)` → `{ valid: boolean, errors: [{ index, entity, errors }] }`
 - `getDateFieldPaths(schemaKey)` → `string[]` of `format: date` fields for a schema key
 - `getDateFieldPathsByCollection()` → `{ accounts, categories, statements, recurringTransactions, recurringTransactionEvents, transactions, transactionSplits }`
 - `getValidFields(schemaKey)` → `Set<string>` of all fields (includes common fields when applicable)

package/dist/esm/index.d.ts

@@ -673,9 +673,9 @@ export type Memo1 = string | null;
  */
 export interface LucaSchema {
   /**
-   * Schema version of the luca ledger
+   * Schema contract version of the luca ledger
    */
-  schemaVersion: string;
+  schemaVersion: '3.0.0';
   /**
    * List of categories
    */

package/dist/esm/index.js

@@ -20,7 +20,6 @@ import {
   validate,
   validateCollection
 } from './lucaValidator.js';
-import { isDateStringFixable, normalizeDateString } from './dateUtils.js';
 
 const schemas = {
   account,
@@ -38,6 +37,7 @@ const schemas = {
 export const accountSchema = schemas.account;
 export const categorySchema = schemas.category;
 export const lucaSchema = schemas.lucaSchema;
+export const SCHEMA_VERSION = lucaSchemaJson.properties.schemaVersion.const;
 export const statementSchema = schemas.statement;
 export const recurringTransactionSchema = schemas.recurringTransaction;
 export const recurringTransactionEventSchema =
@@ -51,8 +51,6 @@ export {
   schemas,
   validate,
   validateCollection,
-  normalizeDateString,
-  isDateStringFixable,
   getDateFieldPaths,
   getDateFieldPathsByCollection,
   getValidFields,

package/dist/esm/lucaValidator.js

@@ -1,6 +1,5 @@
 import Ajv2020 from 'ajv/dist/2020.js';
 import addFormats from 'ajv-formats';
-import { isDateStringFixable, normalizeDateString } from './dateUtils.js';
 import accountSchemaJson from './schemas/account.json' with { type: 'json' };
 import categorySchemaJson from './schemas/category.json' with { type: 'json' };
 import commonSchemaJson from './schemas/common.json' with { type: 'json' };
@@ -91,72 +90,6 @@ function isPlainObject(value) {
   return proto === Object.prototype || proto === null;
 }
 
-function decodePointerToken(token) {
-  return token.replace(/~1/g, '/').replace(/~0/g, '~');
-}
-
-function getValueAtInstancePath(data, instancePath) {
-  if (!instancePath) return data;
-  if (typeof instancePath !== 'string' || !instancePath.startsWith('/')) {
-    return undefined;
-  }
-
-  const tokens = instancePath
-    .slice(1)
-    .split('/')
-    .filter(token => token.length > 0)
-    .map(decodePointerToken);
-
-  let current = data;
-  for (const token of tokens) {
-    if (current === null || current === undefined) return undefined;
-    if (Array.isArray(current)) {
-      const index = Number.parseInt(token, 10);
-      if (!Number.isInteger(index) || index < 0 || index >= current.length) {
-        return undefined;
-      }
-      current = current[index];
-      continue;
-    }
-    if (typeof current !== 'object') return undefined;
-    current = current[token];
-  }
-
-  return current;
-}
-
-function createDateFormatIssue(error, data) {
-  const instancePath =
-    typeof error?.instancePath === 'string' ? error.instancePath : '';
-  const value = getValueAtInstancePath(data, instancePath);
-  const normalizedValue = normalizeDateString(value);
-  const fixable = isDateStringFixable(value);
-
-  return {
-    instancePath,
-    schemaPath: typeof error?.schemaPath === 'string' ? error.schemaPath : '',
-    keyword: 'format',
-    format: 'date',
-    value,
-    fixable,
-    normalizedValue: fixable ? normalizedValue : null
-  };
-}
-
-function buildValidationMetadata(errors, data) {
-  const dateFormatIssues = [];
-  for (const error of errors) {
-    if (error?.keyword !== 'format') continue;
-    if (error?.params?.format !== 'date') continue;
-    dateFormatIssues.push(createDateFormatIssue(error, data));
-  }
-
-  return {
-    dateFormatIssues,
-    hasFixableDateFormatIssues: dateFormatIssues.some(issue => issue.fixable)
-  };
-}
-
 function collectDatePathsFromSchemaFragment(schemaFragment, prefix = '') {
   if (!schemaFragment || typeof schemaFragment !== 'object') return [];
 
@@ -193,8 +126,7 @@ export function validate(schemaKey, data) {
   const errors = ajv.errors ?? [];
   return {
     valid: isValid,
-    errors,
-    metadata: buildValidationMetadata(errors, data)
+    errors
   };
 }
 
@@ -317,20 +249,14 @@ export function validateCollection(schemaKey, arrayOfEntities) {
       errors.push({
         index,
         entity,
-        errors: entityErrors,
-        metadata: buildValidationMetadata(entityErrors, entity)
+        errors: entityErrors
       });
     }
   });
 
   return {
     valid: errors.length === 0,
-    errors,
-    metadata: {
-      hasFixableDateFormatIssues: errors.some(
-        entityError => entityError.metadata.hasFixableDateFormatIssues
-      )
-    }
+    errors
   };
 }
 

package/dist/esm/schemas/lucaSchema.json

@@ -17,7 +17,8 @@
   "properties": {
     "schemaVersion": {
       "type": "string",
-      "description": "Schema version of the luca ledger"
+      "const": "3.0.0",
+      "description": "Schema contract version of the luca ledger"
     },
     "categories": {
       "type": "array",

package/dist/index.d.ts

@@ -673,9 +673,9 @@ export type Memo1 = string | null;
  */
 export interface LucaSchema {
   /**
-   * Schema version of the luca ledger
+   * Schema contract version of the luca ledger
    */
-  schemaVersion: string;
+  schemaVersion: '3.0.0';
   /**
    * List of categories
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luca-financial/luca-schema",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Schemas for the Luca Ledger application",
   "author": "Johnathan Aspinwall",
   "main": "dist/esm/index.js",
@@ -71,14 +71,14 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "ajv": "^8.17.1",
+    "ajv": "^8.18.0",
     "ajv-formats": "^2.1.1"
   },
   "devDependencies": {
     "@babel/cli": "^7.28.6",
-    "@babel/core": "^7.28.6",
+    "@babel/core": "^7.29.0",
     "@babel/plugin-syntax-import-attributes": "^7.28.6",
-    "@babel/preset-env": "^7.28.6",
+    "@babel/preset-env": "^7.29.0",
     "@babel/preset-typescript": "^7.28.5",
     "@eslint/js": "^9.39.2",
     "@types/jest": "^29.5.14",
@@ -93,12 +93,12 @@
     "jest": "^29.7.0",
     "json-schema-to-typescript": "^15.0.4",
     "lint-staged": "^15.5.2",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "rimraf": "^5.0.10",
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.53.0"
+    "typescript-eslint": "^8.55.0"
   },
   "scripts": {
     "build": "pnpm clean && pnpm generate:types && node scripts/build.js",