@metriport/fhir-sdk 1.2.7 → 1.3.0

package/dist/internal/llm-context.d.ts

@@ -0,0 +1,39 @@
+import { Resource } from "@medplum/fhirtypes";
+import { Smart } from "../types/smart-resources";
+import { LLMContextOptions, WalkResult } from "../types/sdk-types";
+/**
+ * Strip non-clinical metadata from a FHIR resource to reduce noise for LLM consumption.
+ * Removes: meta, extension, modifierExtension, text
+ * Returns an immutable copy without mutating the original.
+ */
+export declare function stripNonClinicalData<T extends Resource>(resource: T): T;
+/**
+ * Group resources by their resource type
+ */
+export declare function groupResourcesByType(resources: Resource[]): Record<string, Resource[]>;
+/**
+ * Format a single resource as readable text
+ */
+export declare function formatResourceAsText(resource: Resource): string;
+/**
+ * Format resources as structured text for better LLM readability
+ */
+export declare function formatAsStructuredText(resourcesByDepth: Map<number, Resource[]>): string;
+/**
+ * Format resources as JSON with depth annotations
+ */
+export declare function formatAsJSON(resourcesByDepth: Map<number, Resource[]>): string;
+/**
+ * Generate LLM-friendly context from a starting resource and its related resources.
+ * Uses BFS to discover related resources, strips non-clinical data, and formats output.
+ *
+ * @param startResource - The smart resource to start traversal from
+ * @param options - Options for depth, inclusion, and format
+ * @param walkReferencesFn - Function to walk references (passed in to avoid circular dependency)
+ * @returns Formatted string suitable for LLM context
+ */
+export declare function generateLLMContext<T extends Resource>(startResource: Smart<T>, options: LLMContextOptions | undefined, walkReferencesFn: (startResource: Smart<T>, options: {
+    maxDepth: number;
+    includeStartResource: boolean;
+}) => WalkResult<T>): string;
+//# sourceMappingURL=llm-context.d.ts.map

package/dist/internal/llm-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-context.d.ts","sourceRoot":"","sources":["../../src/internal/llm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA+BvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAetF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA0C/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAqCxF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAc9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EACnD,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,gBAAgB,EAAE,CAChB,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,OAAO,CAAA;CAAE,KACzD,UAAU,CAAC,CAAC,CAAC,GACjB,MAAM,CAoCR"}

package/dist/internal/llm-context.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateLLMContext = exports.formatAsJSON = exports.formatAsStructuredText = exports.formatResourceAsText = exports.groupResourcesByType = exports.stripNonClinicalData = void 0;
+/**
+ * Strip non-clinical metadata from a FHIR resource to reduce noise for LLM consumption.
+ * Removes: meta, extension, modifierExtension, text
+ * Returns an immutable copy without mutating the original.
+ */
+function stripNonClinicalData(resource) {
+    function deepCloneAndStrip(obj) {
+        if (obj === null || obj === undefined) {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map(item => deepCloneAndStrip(item));
+        }
+        if (typeof obj === "object") {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                // Skip non-clinical fields
+                if (key === "meta" ||
+                    key === "extension" ||
+                    key === "modifierExtension" ||
+                    key === "text") {
+                    continue;
+                }
+                result[key] = deepCloneAndStrip(value);
+            }
+            return result;
+        }
+        return obj;
+    }
+    return deepCloneAndStrip(resource);
+}
+exports.stripNonClinicalData = stripNonClinicalData;
+/**
+ * Group resources by their resource type
+ */
+function groupResourcesByType(resources) {
+    const grouped = {};
+    for (const resource of resources) {
+        const type = resource.resourceType;
+        if (!grouped[type]) {
+            grouped[type] = [];
+        }
+        const resourceArray = grouped[type];
+        if (resourceArray) {
+            resourceArray.push(resource);
+        }
+    }
+    return grouped;
+}
+exports.groupResourcesByType = groupResourcesByType;
+/**
+ * Format a single resource as readable text
+ */
+function formatResourceAsText(resource) {
+    const lines = [];
+    lines.push(`[Type: ${resource.resourceType}, ID: ${resource.id ?? "unknown"}]`);
+    function formatValue(value, indent = 2) {
+        const prefix = " ".repeat(indent);
+        const result = [];
+        if (value === null || value === undefined) {
+            return [`${prefix}(none)`];
+        }
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                return [`${prefix}[]`];
+            }
+            for (const [index, item] of value.entries()) {
+                result.push(`${prefix}[${index}]:`);
+                result.push(...formatValue(item, indent + 2));
+            }
+            return result;
+        }
+        if (typeof value === "object") {
+            for (const [key, val] of Object.entries(value)) {
+                result.push(`${prefix}${key}:`);
+                result.push(...formatValue(val, indent + 2));
+            }
+            return result;
+        }
+        return [`${prefix}${String(value)}`];
+    }
+    // Format key fields
+    for (const [key, value] of Object.entries(resource)) {
+        if (key === "resourceType" || key === "id")
+            continue; // Already shown in header
+        lines.push(`  ${key}:`);
+        lines.push(...formatValue(value, 4));
+    }
+    return lines.join("\n");
+}
+exports.formatResourceAsText = formatResourceAsText;
+/**
+ * Format resources as structured text for better LLM readability
+ */
+function formatAsStructuredText(resourcesByDepth) {
+    const lines = [];
+    // Primary resource section
+    const primaryResources = resourcesByDepth.get(0) ?? [];
+    if (primaryResources.length > 0) {
+        lines.push("PRIMARY RESOURCE:");
+        lines.push("=".repeat(80));
+        for (const resource of primaryResources) {
+            lines.push(formatResourceAsText(resource));
+            lines.push("");
+        }
+    }
+    // Related resources by depth
+    for (const [depth, resources] of resourcesByDepth.entries()) {
+        if (depth === 0)
+            continue; // Already handled above
+        const depthLabel = depth === 1 ? "DIRECTLY REFERENCED" : `INDIRECTLY REFERENCED (Depth ${depth})`;
+        lines.push(`${depthLabel} RESOURCES:`);
+        lines.push("=".repeat(80));
+        // Group by resource type for better organization
+        const groupedByType = groupResourcesByType(resources);
+        for (const [resourceType, typeResources] of Object.entries(groupedByType)) {
+            lines.push(`\n--- ${resourceType} (${typeResources.length}) ---\n`);
+            for (const resource of typeResources) {
+                lines.push(formatResourceAsText(resource));
+                lines.push("");
+            }
+        }
+    }
+    return lines.join("\n");
+}
+exports.formatAsStructuredText = formatAsStructuredText;
+/**
+ * Format resources as JSON with depth annotations
+ */
+function formatAsJSON(resourcesByDepth) {
+    const relatedResourcesByDepth = {};
+    for (const [depth, resources] of resourcesByDepth.entries()) {
+        if (depth === 0)
+            continue; // Skip primary resource (already at top)
+        relatedResourcesByDepth[`depth_${depth}`] = resources;
+    }
+    const output = {
+        primaryResource: resourcesByDepth.get(0)?.[0],
+        relatedResourcesByDepth,
+    };
+    return JSON.stringify(output, null, 2);
+}
+exports.formatAsJSON = formatAsJSON;
+/**
+ * Generate LLM-friendly context from a starting resource and its related resources.
+ * Uses BFS to discover related resources, strips non-clinical data, and formats output.
+ *
+ * @param startResource - The smart resource to start traversal from
+ * @param options - Options for depth, inclusion, and format
+ * @param walkReferencesFn - Function to walk references (passed in to avoid circular dependency)
+ * @returns Formatted string suitable for LLM context
+ */
+function generateLLMContext(startResource, options, walkReferencesFn) {
+    const maxDepth = options?.maxDepth ?? 2;
+    const includeStartResource = options?.includeStartResource ?? true;
+    const format = options?.format ?? "structured-text";
+    // Walk the reference graph
+    const walkResult = walkReferencesFn(startResource, {
+        maxDepth,
+        includeStartResource,
+    });
+    // Log resource counts for debugging
+    console.log(`[LLM Context] Total resources discovered: ${walkResult.allResources.length}`);
+    for (const [depth, resources] of walkResult.resourcesByDepth.entries()) {
+        console.log(`[LLM Context] Depth ${depth}: ${resources.length} resources`);
+    }
+    // Strip non-clinical data from all resources
+    const cleanedResourcesByDepth = new Map();
+    for (const [depth, resources] of walkResult.resourcesByDepth.entries()) {
+        // Skip depth 0 if includeStartResource is false
+        if (depth === 0 && !includeStartResource) {
+            continue;
+        }
+        cleanedResourcesByDepth.set(depth, resources.map(r => stripNonClinicalData(r)));
+    }
+    // Format based on selected format
+    if (format === "json") {
+        return formatAsJSON(cleanedResourcesByDepth);
+    }
+    else {
+        return formatAsStructuredText(cleanedResourcesByDepth);
+    }
+}
+exports.generateLLMContext = generateLLMContext;
+//# sourceMappingURL=llm-context.js.map

package/dist/internal/llm-context.js.map

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

package/dist/internal/reference-resolution.d.ts

@@ -0,0 +1,25 @@
+import { Resource } from "@medplum/fhirtypes";
+import { Smart } from "../types/smart-resources";
+import { ReverseReferenceOptions } from "../types/sdk-types";
+/**
+ * Check if a reference field expects an array of references
+ */
+export declare function isArrayReferenceField(fieldName: string): boolean;
+/**
+ * Resolve a single reference object to a resource
+ * FR-5.5: Reference resolution methods handle both resource.id and fullUrl matching
+ */
+export declare function resolveReferenceObject(referenceObj: unknown, resourcesById: Map<string, Resource>, resourcesByFullUrl: Map<string, Resource>, resolutionStack: Set<string>): Resource | undefined;
+/**
+ * Resolve a reference method call to actual resources
+ * FR-5.2-5.6: Handle different reference types and patterns
+ */
+export declare function resolveReference(methodName: string, resource: Resource, resourcesById: Map<string, Resource>, resourcesByFullUrl: Map<string, Resource>, resolutionStack: Set<string>, createSmartResourceFn: <T extends Resource>(resource: T) => Smart<T>): Smart<Resource> | Smart<Resource>[] | undefined;
+/**
+ * Create a smart resource with reference resolution methods
+ * FR-5.1: Resources returned by SDK have additional getter methods for each Reference field
+ * FR-5.7: Reference resolution operates in O(1) time complexity per reference
+ * FR-5.8: Original reference fields remain unchanged
+ */
+export declare function createSmartResource<T extends Resource>(resource: T, smartResourceCache: WeakMap<Resource, Smart<Resource>>, resourcesById: Map<string, Resource>, resourcesByFullUrl: Map<string, Resource>, resolutionStack: Set<string>, getResourcesReferencingIdFn: (targetId: string, options?: ReverseReferenceOptions) => Smart<Resource>[]): Smart<T>;
+//# sourceMappingURL=reference-resolution.d.ts.map

package/dist/internal/reference-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-resolution.d.ts","sourceRoot":"","sources":["../../src/internal/reference-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAwC,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACzC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,QAAQ,GAAG,SAAS,CAgCtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACzC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,qBAAqB,EAAE,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GACnE,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,SAAS,CA0CjD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,EACpD,QAAQ,EAAE,CAAC,EACX,kBAAkB,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACzC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,2BAA2B,EAAE,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,uBAAuB,KAC9B,KAAK,CAAC,QAAQ,CAAC,EAAE,GACrB,KAAK,CAAC,CAAC,CAAC,CA+DV"}

package/dist/internal/reference-resolution.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSmartResource = exports.resolveReference = exports.resolveReferenceObject = exports.isArrayReferenceField = void 0;
+const smart_resources_1 = require("../types/smart-resources");
+/**
+ * Check if a reference field expects an array of references
+ */
+function isArrayReferenceField(fieldName) {
+    // Known array reference fields
+    const arrayFields = new Set(["performer", "participant", "result", "generalPractitioner"]);
+    return arrayFields.has(fieldName);
+}
+exports.isArrayReferenceField = isArrayReferenceField;
+/**
+ * Resolve a single reference object to a resource
+ * FR-5.5: Reference resolution methods handle both resource.id and fullUrl matching
+ */
+function resolveReferenceObject(referenceObj, resourcesById, resourcesByFullUrl, resolutionStack) {
+    if (!referenceObj || typeof referenceObj !== "object" || !("reference" in referenceObj)) {
+        return undefined;
+    }
+    const reference = referenceObj.reference;
+    // Circular reference protection
+    if (resolutionStack.has(reference)) {
+        return undefined;
+    }
+    resolutionStack.add(reference);
+    try {
+        // Try to resolve by resource ID (e.g., "Patient/123")
+        if (reference.includes("/")) {
+            const [, resourceId] = reference.split("/");
+            if (resourceId && resourcesById.has(resourceId)) {
+                return resourcesById.get(resourceId);
+            }
+        }
+        // Try to resolve by fullUrl (e.g., "urn:uuid:123")
+        if (resourcesByFullUrl.has(reference)) {
+            return resourcesByFullUrl.get(reference);
+        }
+        return undefined;
+    }
+    finally {
+        resolutionStack.delete(reference);
+    }
+}
+exports.resolveReferenceObject = resolveReferenceObject;
+/**
+ * Resolve a reference method call to actual resources
+ * FR-5.2-5.6: Handle different reference types and patterns
+ */
+function resolveReference(methodName, resource, resourcesById, resourcesByFullUrl, resolutionStack, createSmartResourceFn) {
+    const referenceField = (0, smart_resources_1.getReferenceField)(methodName, resource.resourceType);
+    if (!referenceField) {
+        return undefined;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const referenceValue = resource[referenceField];
+    if (!referenceValue) {
+        // FR-5.6: Return appropriate empty value for missing references
+        return isArrayReferenceField(referenceField) ? [] : undefined;
+    }
+    // Handle array references
+    if (Array.isArray(referenceValue)) {
+        const resolvedResources = [];
+        for (const ref of referenceValue) {
+            const resolved = resolveReferenceObject(ref, resourcesById, resourcesByFullUrl, resolutionStack);
+            if (resolved) {
+                resolvedResources.push(createSmartResourceFn(resolved));
+            }
+        }
+        return resolvedResources;
+    }
+    // Handle single reference - we know it's not an array at this point
+    const resolved = resolveReferenceObject(referenceValue, resourcesById, resourcesByFullUrl, resolutionStack);
+    if (resolved) {
+        // Type assertion is safe here because we've established this is the single reference path
+        return createSmartResourceFn(resolved);
+    }
+    return undefined;
+}
+exports.resolveReference = resolveReference;
+/**
+ * Create a smart resource with reference resolution methods
+ * FR-5.1: Resources returned by SDK have additional getter methods for each Reference field
+ * FR-5.7: Reference resolution operates in O(1) time complexity per reference
+ * FR-5.8: Original reference fields remain unchanged
+ */
+function createSmartResource(resource, smartResourceCache, resourcesById, resourcesByFullUrl, resolutionStack, getResourcesReferencingIdFn) {
+    // Check cache first to maintain object identity
+    const cached = smartResourceCache.get(resource);
+    if (cached) {
+        return cached;
+    }
+    const smartResource = new Proxy(resource, {
+        get: (target, prop, receiver) => {
+            // Handle the smart resource marker
+            if (prop === "__isSmartResource") {
+                return true;
+            }
+            // Handle reverse reference method
+            if (prop === "getReferencingResources") {
+                return (options) => {
+                    const resourceId = target.id;
+                    if (!resourceId) {
+                        return [];
+                    }
+                    return getResourcesReferencingIdFn(resourceId, options);
+                };
+            }
+            // Check if this is a reference method call
+            if (typeof prop === "string" && (0, smart_resources_1.isReferenceMethod)(prop, target.resourceType)) {
+                return () => resolveReference(prop, target, resourcesById, resourcesByFullUrl, resolutionStack, res => createSmartResource(res, smartResourceCache, resourcesById, resourcesByFullUrl, resolutionStack, getResourcesReferencingIdFn));
+            }
+            // Return original property
+            return Reflect.get(target, prop, receiver);
+        },
+        // Ensure JSON serialization works correctly (FR-5.8)
+        ownKeys: target => {
+            return Reflect.ownKeys(target).filter(key => key !== "__isSmartResource" && key !== "getReferencingResources");
+        },
+        getOwnPropertyDescriptor: (target, prop) => {
+            if (prop === "__isSmartResource" || prop === "getReferencingResources") {
+                return undefined;
+            }
+            return Reflect.getOwnPropertyDescriptor(target, prop);
+        },
+    });
+    // Cache the smart resource
+    smartResourceCache.set(resource, smartResource);
+    return smartResource;
+}
+exports.createSmartResource = createSmartResource;
+//# sourceMappingURL=reference-resolution.js.map

package/dist/internal/reference-resolution.js.map

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

package/dist/internal/reference-utils.d.ts

@@ -0,0 +1,26 @@
+import { Resource } from "@medplum/fhirtypes";
+/**
+ * Find all Reference fields in a resource recursively
+ */
+export declare function findAllReferences(resource: Resource): Array<{
+    field: string;
+    reference: string;
+}>;
+/**
+ * Extract target resource ID from a reference string
+ */
+export declare function extractTargetIdFromReference(reference: string): string | undefined;
+/**
+ * Normalize reference field path to base field name
+ * e.g., "participant.individual" -> "participant"
+ *       "performer[0]" -> "performer"
+ */
+export declare function normalizeReferenceField(field: string): string;
+/**
+ * Check if a reference can be resolved within the bundle
+ * @param reference - The reference string to check
+ * @param resourcesById - Map of resources indexed by resource.id
+ * @param resourcesByFullUrl - Map of resources indexed by entry.fullUrl
+ */
+export declare function canResolveReference(reference: string, resourcesById: Map<string, Resource>, resourcesByFullUrl: Map<string, Resource>): boolean;
+//# sourceMappingURL=reference-utils.d.ts.map

package/dist/internal/reference-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-utils.d.ts","sourceRoot":"","sources":["../../src/internal/reference-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAkCjG;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAalF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GACxC,OAAO,CAeT"}

package/dist/internal/reference-utils.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canResolveReference = exports.normalizeReferenceField = exports.extractTargetIdFromReference = exports.findAllReferences = void 0;
+/**
+ * Find all Reference fields in a resource recursively
+ */
+function findAllReferences(resource) {
+    const references = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function searchObject(obj, path = "") {
+        if (!obj || typeof obj !== "object") {
+            return;
+        }
+        // Check if this object is a Reference
+        if (obj.reference && typeof obj.reference === "string") {
+            references.push({
+                field: path || "reference",
+                reference: obj.reference,
+            });
+            return;
+        }
+        // Recursively search object properties
+        for (const [key, value] of Object.entries(obj)) {
+            const currentPath = path ? `${path}.${key}` : key;
+            if (Array.isArray(value)) {
+                value.forEach((item, index) => {
+                    searchObject(item, `${currentPath}[${index}]`);
+                });
+            }
+            else if (value && typeof value === "object") {
+                searchObject(value, currentPath);
+            }
+        }
+    }
+    searchObject(resource);
+    return references;
+}
+exports.findAllReferences = findAllReferences;
+/**
+ * Extract target resource ID from a reference string
+ */
+function extractTargetIdFromReference(reference) {
+    if (!reference) {
+        return undefined;
+    }
+    // Handle "ResourceType/id" pattern
+    if (reference.includes("/")) {
+        const parts = reference.split("/");
+        return parts[parts.length - 1];
+    }
+    // Handle other reference patterns (e.g., "urn:uuid:xxx")
+    return reference;
+}
+exports.extractTargetIdFromReference = extractTargetIdFromReference;
+/**
+ * Normalize reference field path to base field name
+ * e.g., "participant.individual" -> "participant"
+ *       "performer[0]" -> "performer"
+ */
+function normalizeReferenceField(field) {
+    // Remove array indices
+    const withoutIndices = field.replace(/\[\d+\]/g, "");
+    // Take first part of dotted path
+    const parts = withoutIndices.split(".");
+    return parts[0] ?? field;
+}
+exports.normalizeReferenceField = normalizeReferenceField;
+/**
+ * Check if a reference can be resolved within the bundle
+ * @param reference - The reference string to check
+ * @param resourcesById - Map of resources indexed by resource.id
+ * @param resourcesByFullUrl - Map of resources indexed by entry.fullUrl
+ */
+function canResolveReference(reference, resourcesById, resourcesByFullUrl) {
+    // Try to resolve by resource ID (e.g., "Patient/123")
+    if (reference.includes("/")) {
+        const [, resourceId] = reference.split("/");
+        if (resourceId && resourcesById.has(resourceId)) {
+            return true;
+        }
+    }
+    // Try to resolve by fullUrl (e.g., "urn:uuid:123")
+    if (resourcesByFullUrl.has(reference)) {
+        return true;
+    }
+    return false;
+}
+exports.canResolveReference = canResolveReference;
+//# sourceMappingURL=reference-utils.js.map

package/dist/internal/reference-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-utils.js","sourceRoot":"","sources":["../../src/internal/reference-utils.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,SAAgB,iBAAiB,CAAC,QAAkB;IAClD,MAAM,UAAU,GAAgD,EAAE,CAAC;IAEnE,8DAA8D;IAC9D,SAAS,YAAY,CAAC,GAAQ,EAAE,IAAI,GAAG,EAAE;QACvC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YACnC,OAAO;SACR;QAED,sCAAsC;QACtC,IAAI,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,EAAE;YACtD,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,IAAI,IAAI,WAAW;gBAC1B,SAAS,EAAE,GAAG,CAAC,SAAS;aACzB,CAAC,CAAC;YACH,OAAO;SACR;QAED,uCAAuC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAElD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBACxB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;oBAC5B,YAAY,CAAC,IAAI,EAAE,GAAG,WAAW,IAAI,KAAK,GAAG,CAAC,CAAC;gBACjD,CAAC,CAAC,CAAC;aACJ;iBAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;gBAC7C,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;aAClC;SACF;IACH,CAAC;IAED,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvB,OAAO,UAAU,CAAC;AACpB,CAAC;AAlCD,8CAkCC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAAC,SAAiB;IAC5D,IAAI,CAAC,SAAS,EAAE;QACd,OAAO,SAAS,CAAC;KAClB;IAED,mCAAmC;IACnC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;KAChC;IAED,yDAAyD;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAbD,oEAaC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,KAAa;IACnD,uBAAuB;IACvB,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrD,iCAAiC;IACjC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;AAC3B,CAAC;AAND,0DAMC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,SAAiB,EACjB,aAAoC,EACpC,kBAAyC;IAEzC,sDAAsD;IACtD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;QAC3B,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,UAAU,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE;YAC/C,OAAO,IAAI,CAAC;SACb;KACF;IAED,mDAAmD;IACnD,IAAI,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;QACrC,OAAO,IAAI,CAAC;KACb;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAnBD,kDAmBC"}

package/dist/internal/validation.d.ts

@@ -0,0 +1,16 @@
+import { Bundle, Resource } from "@medplum/fhirtypes";
+import { ValidationResult } from "../types/sdk-types";
+/**
+ * Validate all references in the bundle
+ * FR-2.1: Validate all references in the bundle
+ * FR-2.2: Identifies references by Resource/id pattern and fullUrl references
+ * FR-2.3: Handles both relative and absolute references
+ * FR-2.4: Returns validation result with broken reference details
+ *
+ * @param bundle - The FHIR bundle to validate
+ * @param resourcesById - Map of resources indexed by resource.id
+ * @param resourcesByFullUrl - Map of resources indexed by entry.fullUrl
+ * @returns ValidationResult with broken reference details
+ */
+export declare function lookForBrokenReferences(bundle: Bundle, resourcesById: Map<string, Resource>, resourcesByFullUrl: Map<string, Resource>): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/internal/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/internal/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,oBAAoB,CAAC;AAGvE;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACpC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GACxC,gBAAgB,CA+BlB"}

package/dist/internal/validation.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookForBrokenReferences = void 0;
+const reference_utils_1 = require("./reference-utils");
+/**
+ * Validate all references in the bundle
+ * FR-2.1: Validate all references in the bundle
+ * FR-2.2: Identifies references by Resource/id pattern and fullUrl references
+ * FR-2.3: Handles both relative and absolute references
+ * FR-2.4: Returns validation result with broken reference details
+ *
+ * @param bundle - The FHIR bundle to validate
+ * @param resourcesById - Map of resources indexed by resource.id
+ * @param resourcesByFullUrl - Map of resources indexed by entry.fullUrl
+ * @returns ValidationResult with broken reference details
+ */
+function lookForBrokenReferences(bundle, resourcesById, resourcesByFullUrl) {
+    const brokenReferences = [];
+    if (!bundle.entry) {
+        return { hasBrokenReferences: false, brokenReferences: [] };
+    }
+    for (const entry of bundle.entry) {
+        if (!entry.resource) {
+            continue;
+        }
+        const resource = entry.resource;
+        const resourceReferences = (0, reference_utils_1.findAllReferences)(resource);
+        for (const { field, reference } of resourceReferences) {
+            if (!(0, reference_utils_1.canResolveReference)(reference, resourcesById, resourcesByFullUrl)) {
+                brokenReferences.push({
+                    sourceResourceId: resource.id || entry.fullUrl || "unknown",
+                    sourceResourceType: resource.resourceType,
+                    referenceField: field,
+                    reference: reference,
+                });
+            }
+        }
+    }
+    return {
+        hasBrokenReferences: brokenReferences.length > 0,
+        brokenReferences: brokenReferences,
+    };
+}
+exports.lookForBrokenReferences = lookForBrokenReferences;
+//# sourceMappingURL=validation.js.map

package/dist/internal/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/internal/validation.ts"],"names":[],"mappings":";;;AAEA,uDAA2E;AAE3E;;;;;;;;;;;GAWG;AACH,SAAgB,uBAAuB,CACrC,MAAc,EACd,aAAoC,EACpC,kBAAyC;IAEzC,MAAM,gBAAgB,GAAsB,EAAE,CAAC;IAE/C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;QACjB,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;KAC7D;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YACnB,SAAS;SACV;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,kBAAkB,GAAG,IAAA,mCAAiB,EAAC,QAAQ,CAAC,CAAC;QAEvD,KAAK,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,kBAAkB,EAAE;YACrD,IAAI,CAAC,IAAA,qCAAmB,EAAC,SAAS,EAAE,aAAa,EAAE,kBAAkB,CAAC,EAAE;gBACtE,gBAAgB,CAAC,IAAI,CAAC;oBACpB,gBAAgB,EAAE,QAAQ,CAAC,EAAE,IAAI,KAAK,CAAC,OAAO,IAAI,SAAS;oBAC3D,kBAAkB,EAAE,QAAQ,CAAC,YAAY;oBACzC,cAAc,EAAE,KAAK;oBACrB,SAAS,EAAE,SAAS;iBACrB,CAAC,CAAC;aACJ;SACF;KACF;IAED,OAAO;QACL,mBAAmB,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAChD,gBAAgB,EAAE,gBAAgB;KACnC,CAAC;AACJ,CAAC;AAnCD,0DAmCC"}