@oystehr/sdk 4.3.10 → 4.3.11

package/src/resources/classes/fhir-ext.ts

@@ -267,6 +267,43 @@ export interface OystehrFHIRUpdateClientRequest extends OystehrClientRequest {
   optimisticLockingVersionId?: string;
 }
 
+/**
+ * Optional parameter that can be passed to the FHIR create method. In addition
+ * to the standard request options, it supports FHIR conditional create via the
+ * 'If-None-Exist' header.
+ */
+export interface OystehrFHIRCreateClientRequest extends OystehrClientRequest {
+  /**
+   * Perform a FHIR conditional create using the 'If-None-Exist' header. The value is a
+   * FHIR search query that identifies whether a matching resource already exists:
+   *   - if no resource matches, the resource is created as normal;
+   *   - if exactly one resource matches, no resource is created and the existing one is returned;
+   *   - if more than one resource matches, the request fails with a 412 Precondition Failed error.
+   *
+   * Accepts either a raw search query string (e.g. `'identifier=http://acme.org|1234'`) or an
+   * array of SearchParam objects (e.g. `[{ name: 'identifier', value: 'http://acme.org|1234' }]`).
+   *
+   * @see https://www.hl7.org/fhir/http.html#cond-update for the conditional create specification.
+   */
+  ifNoneExist?: string | SearchParam[];
+}
+
+/**
+ * Serializes an If-None-Exist value into a FHIR search query string. A raw string is
+ * returned unchanged; an array of SearchParam objects is encoded as a query string
+ * (e.g. "identifier=sys|123&active=true").
+ */
+function ifNoneExistToString(value: string | SearchParam[]): string {
+  if (typeof value === 'string') {
+    return value;
+  }
+  const search = new URLSearchParams();
+  for (const param of value) {
+    search.append(param.name, String(param.value));
+  }
+  return search.toString();
+}
+
 function isAsyncRequestMode(mode: FhirResponseMode | undefined): mode is Exclude<FhirResponseMode, 'sync'> {
   return mode === 'async-bundle' || mode === 'async-bulk';
 }
@@ -385,34 +422,38 @@ export async function searchAndGetAllPages<T extends FhirResource>(
 export async function create<T extends FhirResource>(
   this: SDKResource,
   params: FhirCreateParams<T>,
-  request: OystehrClientRequest & { mode: Exclude<FhirResponseMode, 'sync'> }
+  request: OystehrFHIRCreateClientRequest & { mode: Exclude<FhirResponseMode, 'sync'> }
 ): Promise<FhirAsyncJobHandle>;
 export async function create<T extends FhirResource>(
   this: SDKResource,
   params: FhirCreateParams<T>,
-  request?: OystehrClientRequest & { mode?: 'sync' | undefined }
+  request?: OystehrFHIRCreateClientRequest & { mode?: 'sync' | undefined }
 ): Promise<FhirFetcherResponse<FhirResourceReturnValue<T>>>;
 export async function create<T extends FhirResource>(
   this: SDKResource,
   params: FhirCreateParams<T>,
-  request?: OystehrClientRequest
+  request?: OystehrFHIRCreateClientRequest
 ): Promise<FhirFetcherResponse<FhirResourceReturnValue<T>> | FhirAsyncJobHandle> {
   const tagged = applyTagToResource(this.config, params);
   const { resourceType } = tagged;
   const requestMode = request?.mode;
+  const ifNoneExistRequest = {
+    ...request,
+    ifNoneExist: request?.ifNoneExist !== undefined ? ifNoneExistToString(request.ifNoneExist) : undefined,
+  };
   if (isAsyncRequestMode(requestMode)) {
     return await this.startAsyncJob(
       `/${resourceType}`,
       'POST',
       tagged as unknown as Record<string, unknown>,
       requestMode,
-      request
+      ifNoneExistRequest
     );
   }
 
   return await this.fhirRequest<FhirResourceReturnValue<T>>(`/${resourceType}`, 'POST')(
     tagged as unknown as Record<string, unknown>,
-    request
+    ifNoneExistRequest
   );
 }
 
@@ -946,9 +987,13 @@ function batchInputRequestToBundleEntryItem<T extends FhirResource>(
   // POST creates require a full resource
   if (method === 'POST' && 'resource' in request) {
     const resource = applyTagToResource(config, request.resource);
-    const { fullUrl } = request;
+    const { fullUrl, ifNoneExist } = request;
     return {
-      ...baseRequest,
+      request: {
+        ...baseRequest.request,
+        // Conditional create: only create the resource if no existing resource matches the query.
+        ifNoneExist: ifNoneExist !== undefined ? ifNoneExistToString(ifNoneExist) : undefined,
+      },
       resource: resource as T,
       fullUrl,
     } as BundleEntry<T>;

package/src/resources/types/fhir.ts

@@ -127,6 +127,19 @@ export interface BatchInputPostRequest<F extends FhirResource> extends BatchInpu
   method: 'POST';
   resource: F;
   fullUrl?: string;
+  /**
+   * Perform a FHIR conditional create for this entry using the bundle entry's `ifNoneExist`
+   * field. The value is a FHIR search query that identifies whether a matching resource already
+   * exists: if no resource matches, the resource is created; if exactly one matches, no resource
+   * is created and the existing one is returned; if more than one matches, the entry fails with a
+   * 412 Precondition Failed error.
+   *
+   * Accepts either a raw search query string (e.g. `'identifier=http://acme.org|1234'`) or an
+   * array of SearchParam objects (e.g. `[{ name: 'identifier', value: 'http://acme.org|1234' }]`).
+   *
+   * @see https://www.hl7.org/fhir/http.html#cond-update
+   */
+  ifNoneExist?: string | SearchParam[];
 }
 
 /**