fhir-persistence 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,36 @@ 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2025-03-17
+
+### Added
+
+#### Full-Text Search (SQLite FTS5 + PostgreSQL tsvector/GIN)
+
+- **`table-schema-builder.ts`** — HumanName and Address lookup tables now include tsvector GIN expression indexes (`to_tsvector('simple'::regconfig, column)`) for PostgreSQL full-text search
+- **`where-builder.ts`** — Lookup table string search supports FTS query paths: SQLite FTS5 MATCH and PostgreSQL `to_tsvector @@ plainto_tsquery` with automatic fallback to LIKE
+- **`fhir-system.ts`** — `FhirSystemConfig.features.fullTextSearch` option to enable FTS query paths (default: `false` for backward compatibility)
+- SQLite FTS5 virtual tables generated via `MigrationGenerator` for HumanName/Address lookup columns
+
+#### Reindex Progress Callbacks
+
+- **`cli/reindex.ts`** — `ReindexProgressCallbackV2` type with `onProgress` callback reporting `{ resourceType, processed, total }` per batch
+- **`reindexResourceTypeV2`** and **`reindexAllV2`** accept optional `onProgress` parameter for CLI and UI progress display
+
+#### Conditional Operations API
+
+- **`store/conditional-service.ts`** — `ConditionalService` class with full FHIR R4 conditional semantics:
+  - `conditionalCreate`: 0 match → create, 1 match → return existing, 2+ → `PreconditionFailedError`
+  - `conditionalUpdate`: 0 match → create, 1 match → update, 2+ → `PreconditionFailedError`
+  - `conditionalDelete`: delete all matching resources, return count
+- **`repo/errors.ts`** — `PreconditionFailedError` (HTTP 412) for multiple-match conditional operations
+- All conditional operations execute within transactions (TOCTOU protection)
+
+### Changed
+
+- **`table-schema-builder.ts`** — HumanName lookup table adds `pg_trgm` GIN indexes (`gin_trgm_ops`) alongside tsvector indexes for trigram fuzzy matching
+- **`migration-generator.ts`** — Automatically creates `pg_trgm` and `btree_gin` extensions on PostgreSQL before GIN index generation
+
 ## [0.5.0] - 2025-03-16
 
 ### Fixed

package/README.md

@@ -5,7 +5,7 @@ Embedded FHIR R4 persistence layer — CRUD, search, indexing, and schema migrat
 [![npm version](https://img.shields.io/npm/v/fhir-persistence)](https://www.npmjs.com/package/fhir-persistence)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 
-> **v0.5.0** — PostgreSQL migration path complete: GIN extensions + lookup table fixes
+> **v0.6.0** — Full-text search (SQLite FTS5 + PostgreSQL tsvector/GIN), reindex progress callbacks, conditional operations API
 
 ## Features
 
@@ -21,7 +21,9 @@ Embedded FHIR R4 persistence layer — CRUD, search, indexing, and schema migrat
 - **Two-phase SQL** — id-first query for large table performance
 - **IG-driven schema** — StructureDefinition + SearchParameter → DDL (SQLite + PostgreSQL dialects)
 - **Migration engine** — SchemaDiff → MigrationGenerator → MigrationRunnerV2
-- **Conditional operations** — conditionalCreate / conditionalUpdate / conditionalDelete
+- **Full-text search** — SQLite FTS5 + PostgreSQL tsvector/GIN for string search parameters
+- **Conditional operations** — conditionalCreate / conditionalUpdate / conditionalDelete via `ConditionalService`
+- **Reindex progress** — `onProgress` callback for CLI and UI progress reporting
 - **Bundle processing** — transaction and batch bundle support
 - **Terminology** — TerminologyCodeRepo + ValueSetRepo
 - **FhirSystem orchestrator** — end-to-end startup flow for `fhir-engine` integration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhir-persistence",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Embedded FHIR R4 persistence layer — CRUD, search, indexing, schema migration over SQLite and PostgreSQL",
   "homepage": "https://github.com/medxaidev/fhir-persistence#readme",
   "license": "MIT",