fhir-persistence 0.9.0 → 0.10.0

package/dist/index.d.ts

@@ -312,6 +312,20 @@ export declare function buildUpdateMainSQLv2(tableName: string, columns: Record<
     values: unknown[];
 };
 
+/**
+ * Build a mapping from `urn:uuid:` fullUrls to assigned IDs + resourceTypes.
+ *
+ * Only processes POST entries with `urn:uuid:` fullUrl.
+ * Each matching entry gets a newly generated UUID as its assigned ID.
+ *
+ * The returned map has two key formats for each entry:
+ * - `"urn:uuid:<uuid>"` → `UrnTarget` (for fullUrl-based lookup)
+ *
+ * @param entries - Bundle entries to scan.
+ * @returns Map from urn:uuid string to UrnTarget.
+ */
+export declare function buildUrnMap(entries: BundleEntryForUrn[]): Map<string, UrnTarget>;
+
 /**
  * v2: Build a complete WHERE clause from parsed search params using ? placeholders.
  */
@@ -326,11 +340,75 @@ export declare function buildWhereClauseV2(params: ParsedSearchParam[], registry
  */
 export declare function buildWhereFragmentV2(impl: SearchParameterImpl, param: ParsedSearchParam, dialect?: SqlDialect, resourceType?: string): WhereFragment | null;
 
+/**
+ * A FHIR Bundle resource.
+ */
+export declare interface Bundle {
+    resourceType: 'Bundle';
+    type: 'transaction' | 'batch';
+    entry?: BundleEntry[];
+}
+
+/**
+ * A single entry in a FHIR Bundle.
+ */
+export declare interface BundleEntry {
+    fullUrl?: string;
+    resource?: FhirResource;
+    request?: {
+        method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+        url: string;
+        /** If-None-Exist header for conditional create. */
+        ifNoneExist?: string;
+    };
+}
+
+/**
+ * A single entry in a FHIR Bundle (minimal shape for URN resolution).
+ */
+declare interface BundleEntryForUrn {
+    fullUrl?: string;
+    resource?: FhirResource;
+    request?: {
+        method: string;
+        url: string;
+    };
+}
+
 declare interface BundleLink {
     relation: string;
     url: string;
 }
 
+/**
+ * Result of processing a bundle.
+ */
+export declare interface BundleResponse {
+    resourceType: 'Bundle';
+    type: 'transaction-response' | 'batch-response';
+    entry: BundleResponseEntry[];
+}
+
+/**
+ * Result entry for a single bundle operation.
+ */
+export declare interface BundleResponseEntry {
+    resource?: PersistedResource;
+    response: {
+        status: string;
+        location?: string;
+        etag?: string;
+        lastModified?: string;
+        outcome?: {
+            issue: Array<{
+                severity: string;
+                code: string;
+                diagnostics: string;
+            }>;
+        };
+    };
+}
+
 export declare interface CachedExpansion {
     valuesetUrl: string;
     version: string;
@@ -461,6 +539,66 @@ export declare class ConceptHierarchyRepo {
     private mapRow;
 }
 
+export declare interface ConditionalCreateResult<T = PersistedResource> {
+    /** Whether a new resource was created or an existing one was returned. */
+    outcome: 'created' | 'existing';
+    /** The resource (created or existing). */
+    resource: T;
+}
+
+export declare interface ConditionalDeleteResult {
+    /** Number of resources deleted. */
+    count: number;
+}
+
+export declare class ConditionalService {
+    private readonly adapter;
+    private readonly registry;
+    constructor(adapter: StorageAdapter, registry: SearchParameterRegistry);
+    /**
+     * Conditional create: search for existing matches, create only if none found.
+     *
+     * - 0 matches → create new resource
+     * - 1 match → return existing resource (no-op)
+     * - 2+ matches → PreconditionFailedError
+     *
+     * @param resourceType - FHIR resource type
+     * @param resource - The resource to create
+     * @param searchParams - Search criteria (If-None-Exist)
+     */
+    conditionalCreate<T extends FhirResource>(resourceType: string, resource: T, searchParams: ParsedSearchParam[]): Promise<ConditionalCreateResult<T & PersistedResource>>;
+    /**
+     * Conditional update: search for matches, update if exactly one found.
+     *
+     * - 0 matches → create new resource
+     * - 1 match → update existing resource
+     * - 2+ matches → PreconditionFailedError
+     *
+     * @param resourceType - FHIR resource type
+     * @param resource - The resource to create/update
+     * @param searchParams - Search criteria
+     */
+    conditionalUpdate<T extends FhirResource>(resourceType: string, resource: T, searchParams: ParsedSearchParam[]): Promise<ConditionalUpdateResult<T & PersistedResource>>;
+    /**
+     * Conditional delete: delete all resources matching the search criteria.
+     *
+     * @param resourceType - FHIR resource type
+     * @param searchParams - Search criteria
+     * @returns Number of resources deleted
+     */
+    conditionalDelete(resourceType: string, searchParams: ParsedSearchParam[]): Promise<ConditionalDeleteResult>;
+    private searchMatches;
+    private createInTransaction;
+    private updateInTransaction;
+}
+
+export declare interface ConditionalUpdateResult<T = PersistedResource> {
+    /** Whether a new resource was created or an existing one was updated. */
+    outcome: 'created' | 'updated';
+    /** The resource after the operation. */
+    resource: T;
+}
+
 /**
  * Definition of a PostgreSQL table constraint.
  */
@@ -518,13 +656,29 @@ declare interface CreateResourceOptions_2 {
     assignedId?: string;
 }
 
-declare interface CreateResourceOptions_3 {
-    /** Pre-assigned ID (used in batch/transaction). */
-    assignedId?: string;
+export declare interface CreateResourceResult<T = PersistedResource> {
+    /** The persisted resource after the operation. */
+    resource: T;
+    /** True if a new resource was created, false if an existing match was returned. */
+    created: boolean;
 }
 
 declare type DDLDialect = 'sqlite' | 'postgres';
 
+/**
+ * Replace `urn:uuid:` references in a resource with actual `Type/id` references.
+ *
+ * Only replaces values in `.reference` fields (FHIR Reference type)
+ * to avoid accidental replacement in narratives or identifiers.
+ *
+ * Uses structured deep-walk (iterative stack, not recursive).
+ *
+ * @param resource - The FHIR resource to resolve (will be cloned).
+ * @param urnMap - Map from urn:uuid strings to UrnTarget.
+ * @returns A new resource with resolved references.
+ */
+export declare function deepResolveUrns<T extends FhirResource>(resource: T, urnMap: Map<string, UrnTarget>): T;
+
 /**
  * Default page size for search results.
  */
@@ -760,12 +914,13 @@ export declare class FhirPersistence {
     getRegistry(): SearchParameterRegistry;
     /** Get the IndexingPipeline. */
     getPipeline(): IndexingPipeline;
-    createResource<T extends FhirResource>(resourceType: string, resource: T, options?: CreateResourceOptions_3): Promise<T & PersistedResource>;
+    createResource<T extends FhirResource>(resourceType: string, resource: T, options?: PersistenceCreateResourceOptions): Promise<CreateResourceResult<T & PersistedResource>>;
     readResource(resourceType: string, id: string): Promise<PersistedResource>;
-    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: UpdateResourceOptions_3): Promise<T & PersistedResource>;
+    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: PersistenceUpdateResourceOptions): Promise<UpdateResourceResult<T & PersistedResource>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
     readVersion(resourceType: string, id: string, versionId: string): Promise<PersistedResource>;
     readHistory(resourceType: string, id: string, options?: HistoryOptions_3): Promise<HistoryEntry[]>;
+    readTypeHistory(resourceType: string, options?: HistoryOptions_3): Promise<HistoryEntry[]>;
     /**
      * Stream search results row-by-row for large result sets.
      *
@@ -855,10 +1010,11 @@ export declare class FhirStore {
     constructor(adapter: StorageAdapter);
     createResource<T extends FhirResource>(resourceType: string, resource: T, options?: CreateResourceOptions_2): Promise<T & PersistedResource>;
     readResource(resourceType: string, id: string): Promise<PersistedResource>;
-    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: UpdateResourceOptions_2): Promise<T & PersistedResource>;
+    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: StoreUpdateResourceOptions): Promise<StoreUpdateResourceResult<T & PersistedResource>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
     readVersion(resourceType: string, id: string, versionId: string): Promise<PersistedResource>;
     readHistory(resourceType: string, id: string, options?: HistoryOptions_2): Promise<HistoryEntry[]>;
+    readTypeHistory(resourceType: string, options?: HistoryOptions_2): Promise<HistoryEntry[]>;
     writeReferences(resourceType: string, resourceId: string, refs: ReferenceRowV2[]): Promise<void>;
 }
 
@@ -1830,6 +1986,20 @@ export declare interface PersistedResource extends FhirResource {
     };
 }
 
+export declare interface PersistenceCreateResourceOptions {
+    /** Pre-assigned ID (used in batch/transaction). */
+    assignedId?: string;
+    /** Search condition for conditional create (If-None-Exist). */
+    ifNoneExist?: ParsedSearchParam[];
+}
+
+export declare interface PersistenceUpdateResourceOptions {
+    /** Expected versionId for optimistic locking (If-Match header). */
+    ifMatch?: string;
+    /** When true, create the resource if it does not exist (PUT-as-Create / upsert). */
+    upsert?: boolean;
+}
+
 /**
  * Minimal interface that pg.PoolClient satisfies.
  */
@@ -1953,6 +2123,24 @@ declare interface PreparedStatement<T = Record<string, unknown>> {
     finalize(): void;
 }
 
+/**
+ * v2: Process a batch bundle — each entry independently.
+ *
+ * Each entry is processed in its own try/catch.
+ * urn:uuid references are rejected in batch mode (return 400).
+ */
+export declare function processBatchV2(store: FhirStore, bundle: Bundle): Promise<BundleResponse>;
+
+/**
+ * v2: Process a transaction bundle — all-or-nothing.
+ *
+ * All entries are processed within a single StorageAdapter transaction.
+ * If any entry fails, the entire transaction is rolled back.
+ *
+ * Entry processing order: strict sequential (no reorder).
+ */
+export declare function processTransactionV2(store: FhirStore, adapter: StorageAdapter, bundle: Bundle): Promise<BundleResponse>;
+
 /**
  * Resource types that can be managed by project admins (not just super-admins).
  *
@@ -3182,6 +3370,20 @@ declare interface StoredValueSet {
     storedAt: string;
 }
 
+export declare interface StoreUpdateResourceOptions {
+    /** Expected versionId for optimistic locking (If-Match header). */
+    ifMatch?: string;
+    /** When true, create the resource if it does not exist (PUT-as-Create / upsert). */
+    upsert?: boolean;
+}
+
+export declare interface StoreUpdateResourceResult<T = PersistedResource> {
+    /** The persisted resource after the operation. */
+    resource: T;
+    /** True if the resource was newly created (upsert), false if updated. */
+    created: boolean;
+}
+
 /**
  * DefinitionProvider — Bridge Interface for fhir-definition
  *
@@ -3374,14 +3576,21 @@ export declare interface UpdateResourceOptions {
     ifMatch?: string;
 }
 
-declare interface UpdateResourceOptions_2 {
-    /** Expected versionId for optimistic locking (If-Match header). */
-    ifMatch?: string;
+export declare interface UpdateResourceResult<T = PersistedResource> {
+    /** The persisted resource after the operation. */
+    resource: T;
+    /** True if the resource was newly created (upsert), false if updated. */
+    created: boolean;
 }
 
-declare interface UpdateResourceOptions_3 {
-    /** Expected versionId for optimistic locking (If-Match header). */
-    ifMatch?: string;
+/**
+ * A resolved URN target with explicit resourceType.
+ */
+export declare interface UrnTarget {
+    /** The assigned resource ID. */
+    id: string;
+    /** The FHIR resource type (e.g., "Patient"). */
+    resourceType: string;
 }
 
 /**

package/dist/lib/index.d.ts

@@ -29,8 +29,15 @@ export type { SqlDialect } from './db/dialect.js';
 export { SQLiteDialect } from './db/sqlite-dialect.js';
 export { PostgresDialect } from './db/postgres-dialect.js';
 export { FhirStore } from './store/fhir-store.js';
+export type { UpdateResourceResult as StoreUpdateResourceResult, UpdateResourceOptions as StoreUpdateResourceOptions, } from './store/fhir-store.js';
 export { FhirPersistence } from './store/fhir-persistence.js';
-export type { FhirPersistenceOptions } from './store/fhir-persistence.js';
+export type { FhirPersistenceOptions, CreateResourceOptions as PersistenceCreateResourceOptions, CreateResourceResult, UpdateResourceOptions as PersistenceUpdateResourceOptions, UpdateResourceResult, } from './store/fhir-persistence.js';
+export { ConditionalService } from './store/conditional-service.js';
+export type { ConditionalCreateResult, ConditionalUpdateResult, ConditionalDeleteResult, } from './store/conditional-service.js';
+export { processTransactionV2, processBatchV2 } from './transaction/bundle-processor.js';
+export type { Bundle, BundleEntry, BundleResponse, BundleResponseEntry, } from './transaction/bundle-processor.js';
+export { buildUrnMap, deepResolveUrns } from './transaction/urn-resolver.js';
+export type { UrnTarget } from './transaction/urn-resolver.js';
 export { IndexingPipeline } from './repo/indexing-pipeline.js';
 export type { IndexResult, IndexingPipelineOptions } from './repo/indexing-pipeline.js';
 export { LookupTableWriter } from './repo/lookup-table-writer.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,SAAS,EACT,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,eAAe,IAAI,aAAa,EAChC,oBAAoB,IAAI,kBAAkB,GAC3C,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG9D,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACpI,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAGhG,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC7G,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtG,YAAY,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAGvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EACV,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAC5D,eAAe,EAAE,qBAAqB,EAAE,qBAAqB,EAC7D,eAAe,EAAE,cAAc,GAChC,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/search/where-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"where-builder.d.ts","sourceRoot":"","sources":["../../../src/search/where-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AACtG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAwB9D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,aAAa,GAAG,IAAI,CAkCtB;AA0nBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,MAAM,GACnB,aAAa,GAAG,IAAI,CAmCtB;AAqID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,UAAU,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,aAAa,GAAG,IAAI,CA8BtB;AA8SD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EAAE,EAC3B,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,aAAa,GAAG,IAAI,CA2BtB"}
+{"version":3,"file":"where-builder.d.ts","sourceRoot":"","sources":["../../../src/search/where-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAuB,MAAM,YAAY,CAAC;AACtG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAwB9D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,iBAAiB,EACxB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,aAAa,GAAG,IAAI,CAkCtB;AAuoBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,MAAM,GACnB,aAAa,GAAG,IAAI,CAmCtB;AAqID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,UAAU,EACpB,YAAY,CAAC,EAAE,MAAM,GACpB,aAAa,GAAG,IAAI,CA8BtB;AAwTD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EAAE,EAC3B,QAAQ,EAAE,uBAAuB,EACjC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,aAAa,GAAG,IAAI,CA2BtB"}

package/dist/lib/store/fhir-persistence.d.ts

@@ -24,13 +24,30 @@ import type { SearchParameterRegistry } from '../registry/search-parameter-regis
 import type { FhirResource, PersistedResource, HistoryEntry } from '../repo/types.js';
 import { IndexingPipeline } from '../repo/indexing-pipeline.js';
 import type { IndexingPipelineOptions } from '../repo/indexing-pipeline.js';
+import type { ParsedSearchParam } from '../search/types.js';
 export interface CreateResourceOptions {
     /** Pre-assigned ID (used in batch/transaction). */
     assignedId?: string;
+    /** Search condition for conditional create (If-None-Exist). */
+    ifNoneExist?: ParsedSearchParam[];
+}
+export interface CreateResourceResult<T = PersistedResource> {
+    /** The persisted resource after the operation. */
+    resource: T;
+    /** True if a new resource was created, false if an existing match was returned. */
+    created: boolean;
 }
 export interface UpdateResourceOptions {
     /** Expected versionId for optimistic locking (If-Match header). */
     ifMatch?: string;
+    /** When true, create the resource if it does not exist (PUT-as-Create / upsert). */
+    upsert?: boolean;
+}
+export interface UpdateResourceResult<T = PersistedResource> {
+    /** The persisted resource after the operation. */
+    resource: T;
+    /** True if the resource was newly created (upsert), false if updated. */
+    created: boolean;
 }
 export interface HistoryOptions {
     since?: string;
@@ -52,12 +69,13 @@ export declare class FhirPersistence {
     getRegistry(): SearchParameterRegistry;
     /** Get the IndexingPipeline. */
     getPipeline(): IndexingPipeline;
-    createResource<T extends FhirResource>(resourceType: string, resource: T, options?: CreateResourceOptions): Promise<T & PersistedResource>;
+    createResource<T extends FhirResource>(resourceType: string, resource: T, options?: CreateResourceOptions): Promise<CreateResourceResult<T & PersistedResource>>;
     readResource(resourceType: string, id: string): Promise<PersistedResource>;
-    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: UpdateResourceOptions): Promise<T & PersistedResource>;
+    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: UpdateResourceOptions): Promise<UpdateResourceResult<T & PersistedResource>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
     readVersion(resourceType: string, id: string, versionId: string): Promise<PersistedResource>;
     readHistory(resourceType: string, id: string, options?: HistoryOptions): Promise<HistoryEntry[]>;
+    readTypeHistory(resourceType: string, options?: HistoryOptions): Promise<HistoryEntry[]>;
     /**
      * Stream search results row-by-row for large result sets.
      *

package/dist/lib/store/fhir-persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fhir-persistence.d.ts","sourceRoot":"","sources":["../../../src/store/fhir-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAuB,MAAM,0CAA0C,CAAC;AAC7G,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAGb,MAAM,kBAAkB,CAAC;AAc1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAM5E,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;CACpC;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAG1C,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,sBAAsB;IAWlC,yCAAyC;IACzC,UAAU,IAAI,cAAc;IAE5B,uCAAuC;IACvC,WAAW,IAAI,uBAAuB;IAEtC,gCAAgC;IAChC,WAAW,IAAI,gBAAgB;IAMzB,cAAc,CAAC,CAAC,SAAS,YAAY,EACzC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IA2D3B,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB1E,cAAc,CAAC,CAAC,SAAS,YAAY,EACzC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IAyF3B,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD/D,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAkBvB,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IA6B1B;;;;;;;;;;;OAWG;IACI,YAAY,CACjB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,cAAc,CAAC,iBAAiB,CAAC;IAmBpC;;;OAGG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtE,OAAO,CAAC,QAAQ;CAGjB"}
+{"version":3,"file":"fhir-persistence.d.ts","sourceRoot":"","sources":["../../../src/store/fhir-persistence.ts"],"names":[],"mappings":"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"}

package/dist/lib/store/fhir-store.d.ts

@@ -24,6 +24,14 @@ export interface CreateResourceOptions {
 export interface UpdateResourceOptions {
     /** Expected versionId for optimistic locking (If-Match header). */
     ifMatch?: string;
+    /** When true, create the resource if it does not exist (PUT-as-Create / upsert). */
+    upsert?: boolean;
+}
+export interface UpdateResourceResult<T = PersistedResource> {
+    /** The persisted resource after the operation. */
+    resource: T;
+    /** True if the resource was newly created (upsert), false if updated. */
+    created: boolean;
 }
 export interface HistoryOptions {
     since?: string;
@@ -35,10 +43,11 @@ export declare class FhirStore {
     constructor(adapter: StorageAdapter);
     createResource<T extends FhirResource>(resourceType: string, resource: T, options?: CreateResourceOptions): Promise<T & PersistedResource>;
     readResource(resourceType: string, id: string): Promise<PersistedResource>;
-    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: UpdateResourceOptions): Promise<T & PersistedResource>;
+    updateResource<T extends FhirResource>(resourceType: string, resource: T, options?: UpdateResourceOptions): Promise<UpdateResourceResult<T & PersistedResource>>;
     deleteResource(resourceType: string, id: string): Promise<void>;
     readVersion(resourceType: string, id: string, versionId: string): Promise<PersistedResource>;
     readHistory(resourceType: string, id: string, options?: HistoryOptions): Promise<HistoryEntry[]>;
+    readTypeHistory(resourceType: string, options?: HistoryOptions): Promise<HistoryEntry[]>;
     writeReferences(resourceType: string, resourceId: string, refs: ReferenceRowV2[]): Promise<void>;
 }
 //# sourceMappingURL=fhir-store.d.ts.map

package/dist/lib/store/fhir-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fhir-store.d.ts","sourceRoot":"","sources":["../../../src/store/fhir-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAGb,MAAM,kBAAkB,CAAC;AAgB1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAM9C,cAAc,CAAC,CAAC,SAAS,YAAY,EACzC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IAmD3B,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB1E,cAAc,CAAC,CAAC,SAAS,YAAY,EACzC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IAwF3B,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqD/D,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAkBvB,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IA6BpB,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC;CAYjB"}
+{"version":3,"file":"fhir-store.d.ts","sourceRoot":"","sources":["../../../src/store/fhir-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAGb,MAAM,kBAAkB,CAAC;AAiB1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,iBAAiB;IACzD,kDAAkD;IAClD,QAAQ,EAAE,CAAC,CAAC;IACZ,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAM9C,cAAc,CAAC,CAAC,SAAS,YAAY,EACzC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IAmD3B,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB1E,cAAc,CAAC,CAAC,SAAS,YAAY,EACzC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAqHjD,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqD/D,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC;IAkBvB,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IA6BpB,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IA4BpB,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC;CAYjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhir-persistence",
-  "version": "0.9.0",
+  "version": "0.10.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",