@metriport/fhir-sdk 0.30.0-alpha.1

package/dist/internal/reference-resolution.js

@@ -0,0 +1,338 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSmartResource = exports.resolveReference = exports.resolveReferenceObject = exports.isArrayReferenceField = void 0;
+const util_1 = require("util");
+const smart_resources_1 = require("../types/smart-resources");
+const coding_utilities_1 = require("./coding-utilities");
+const transparent_proxy_1 = require("./transparent-proxy");
+/**
+ * Navigate through a nested path in a resource to get the value at that path.
+ * Handles both simple paths ("subject") and nested paths ("diagnosis.condition").
+ *
+ * For nested paths where the intermediate level is an array:
+ * - "diagnosis.condition" navigates to resource.diagnosis[], extracts .condition from each element
+ * - Returns an array of all reference values found
+ *
+ * For nested paths where the intermediate level is an object:
+ * - "hospitalization.origin" navigates to resource.hospitalization.origin
+ * - Returns the single reference value
+ *
+ * For deeply nested paths like "activity.detail.goal":
+ * - Flattens nested arrays that may result from navigating through multiple array levels
+ * - Returns a flat array of all references found
+ *
+ * @param resource - The FHIR resource to navigate
+ * @param path - Dot-separated path to the reference field
+ * @returns The value at the path, which could be a reference, array of references, or undefined
+ */
+function getNestedValue(resource, path) {
+    const parts = path.split(".");
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = resource;
+    for (const part of parts) {
+        if (!current) {
+            return undefined;
+        }
+        // If current is an array, map over it and collect values
+        if (Array.isArray(current)) {
+            const values = current.map(item => item?.[part]).filter(v => v !== undefined);
+            current = values.length > 0 ? values : undefined;
+        }
+        else {
+            current = current[part];
+        }
+    }
+    // Flatten nested arrays that may result from navigating through multiple array levels
+    // For example, activity.detail.goal where activity is an array and goal is also an array
+    // This prevents [[reference]] and instead returns [reference]
+    if (Array.isArray(current) && current.some(item => Array.isArray(item))) {
+        current = current.flat();
+    }
+    return current;
+}
+/**
+ * Check if a reference field expects an array of references.
+ * Handles both simple paths ("performer") and nested paths ("diagnosis.condition").
+ *
+ * For nested paths, if the intermediate level is an array, the method returns an array.
+ * For example, "diagnosis.condition" returns an array because diagnosis is an array field.
+ */
+function isArrayReferenceField(fieldName) {
+    // Known simple array reference fields
+    const arrayFields = new Set(["performer", "participant", "result", "generalPractitioner"]);
+    // Check if this is a simple array field
+    if (arrayFields.has(fieldName)) {
+        return true;
+    }
+    // For nested paths, check if the base field (first part) is an array
+    // Examples: "diagnosis.condition", "participant.individual", "media.link"
+    if (fieldName.includes(".")) {
+        const parts = fieldName.split(".");
+        const baseField = parts[0];
+        // Known base fields that are arrays (and thus make their nested references arrays)
+        const arrayBaseFields = new Set([
+            "diagnosis",
+            "participant",
+            "location",
+            "contact",
+            "qualification",
+            "link",
+            "media",
+            "performer",
+            "attester",
+            "relatesTo",
+            "event",
+            "section",
+            "stage",
+            "evidence",
+            "protocolApplied",
+            "reaction",
+            "ingredient",
+            "activity",
+        ]);
+        return arrayBaseFields.has(baseField ?? "");
+    }
+    return false;
+}
+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;
+    }
+    // Use getNestedValue to handle both simple and nested paths
+    const referenceValue = getNestedValue(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);
+                };
+            }
+            // Handle forward reference method
+            if (prop === "getReferencedResources") {
+                return () => {
+                    const referencedResources = [];
+                    const referenceMethods = smart_resources_1.REFERENCE_METHOD_MAPPING[target.resourceType];
+                    if (!referenceMethods) {
+                        return referencedResources;
+                    }
+                    // Iterate through all reference methods for this resource type
+                    for (const methodName of Object.keys(referenceMethods)) {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const result = smartResource[methodName]();
+                        if (!result) {
+                            continue;
+                        }
+                        // Handle both single and array references
+                        if (Array.isArray(result)) {
+                            referencedResources.push(...result.filter((r) => r !== undefined));
+                        }
+                        else {
+                            referencedResources.push(result);
+                        }
+                    }
+                    return referencedResources;
+                };
+            }
+            // Handle toString method
+            if (prop === "toString") {
+                return (space) => {
+                    return JSON.stringify(target, null, space ?? 2);
+                };
+            }
+            // Handle Node.js util.inspect.custom for console.log and REPL
+            if (prop === util_1.inspect.custom) {
+                return () => {
+                    return JSON.stringify(target, null, 2);
+                };
+            }
+            // Handle Symbol.toStringTag for better console display
+            if (prop === Symbol.toStringTag) {
+                return `Smart<${target.resourceType}>`;
+            }
+            // Handle toJSON for serialization
+            if (prop === "toJSON") {
+                return () => target;
+            }
+            // 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));
+            }
+            // Get the property value
+            const value = Reflect.get(target, prop, receiver);
+            // Don't wrap null or undefined
+            if (value === null || value === undefined) {
+                return value;
+            }
+            // Wrap CodeableConcept objects (check before Coding to avoid misidentification)
+            if ((0, coding_utilities_1.isCodeableConcept)(value)) {
+                return (0, coding_utilities_1.createSmartCodeableConcept)(value);
+            }
+            // Wrap Coding objects
+            if ((0, coding_utilities_1.isCoding)(value)) {
+                return (0, coding_utilities_1.createSmartCoding)(value);
+            }
+            // Handle arrays - wrap each element if needed
+            if (Array.isArray(value)) {
+                return value.map(item => {
+                    if (item === null || item === undefined) {
+                        return item;
+                    }
+                    // Check CodeableConcept before Coding
+                    if ((0, coding_utilities_1.isCodeableConcept)(item)) {
+                        return (0, coding_utilities_1.createSmartCodeableConcept)(item);
+                    }
+                    if ((0, coding_utilities_1.isCoding)(item)) {
+                        return (0, coding_utilities_1.createSmartCoding)(item);
+                    }
+                    // Recursively wrap plain objects with transparent proxy
+                    // Only wrap plain objects, not built-in types
+                    if (typeof item === "object" && !Array.isArray(item) && item.constructor === Object) {
+                        return (0, transparent_proxy_1.createTransparentProxy)(item);
+                    }
+                    return item;
+                });
+            }
+            // Recursively wrap plain objects with transparent proxy (but not primitives, dates, etc.)
+            // Only wrap plain objects, not built-in types like Date, RegExp, etc.
+            if (typeof value === "object" && !Array.isArray(value) && value.constructor === Object) {
+                return (0, transparent_proxy_1.createTransparentProxy)(value);
+            }
+            // Return original property for primitives and other types
+            return value;
+        },
+        // Ensure JSON serialization works correctly (FR-5.8)
+        ownKeys: target => {
+            const keys = Reflect.ownKeys(target);
+            const virtualMethods = [
+                "getReferencingResources",
+                "getReferencedResources",
+                "toString",
+            ];
+            // Add reference methods for this resource type
+            const referenceMethods = smart_resources_1.REFERENCE_METHOD_MAPPING[target.resourceType];
+            if (referenceMethods) {
+                virtualMethods.push(...Object.keys(referenceMethods));
+            }
+            // Filter out internal markers and add virtual methods for DevTools
+            return [...keys.filter(key => key !== "__isSmartResource"), ...virtualMethods];
+        },
+        getOwnPropertyDescriptor: (target, prop) => {
+            // Hide internal markers from enumeration
+            if (prop === "__isSmartResource" ||
+                prop === Symbol.toStringTag ||
+                prop === "toJSON" ||
+                prop === util_1.inspect.custom) {
+                return undefined;
+            }
+            // Make virtual methods enumerable for DevTools
+            if (prop === "getReferencingResources" ||
+                prop === "getReferencedResources" ||
+                prop === "toString") {
+                return {
+                    enumerable: true,
+                    configurable: true,
+                    writable: false,
+                };
+            }
+            // Make reference methods enumerable for DevTools
+            const referenceMethods = smart_resources_1.REFERENCE_METHOD_MAPPING[target.resourceType];
+            if (referenceMethods && typeof prop === "string" && prop in referenceMethods) {
+                return {
+                    enumerable: true,
+                    configurable: true,
+                    writable: false,
+                };
+            }
+            return Reflect.getOwnPropertyDescriptor(target, prop);
+        },
+    });
+    // Cache the smart resource - cast to avoid type complexity issues
+    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/transparent-proxy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Create a transparent proxy that wraps plain objects to intercept property access.
+ * This enables deep access to Coding and CodeableConcept objects at any nesting level.
+ *
+ * Unlike SmartResource proxies, transparent proxies don't add methods - they just
+ * intercept property access to wrap Coding/CodeableConcept objects when accessed.
+ *
+ * @param obj - The plain object to wrap
+ * @returns A proxied object that wraps Coding/CodeableConcept on access
+ */
+export declare function createTransparentProxy<T extends object>(obj: T): T;
+//# sourceMappingURL=transparent-proxy.d.ts.map

package/dist/internal/transparent-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transparent-proxy.d.ts","sourceRoot":"","sources":["../../src/internal/transparent-proxy.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAuElE"}

package/dist/internal/transparent-proxy.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransparentProxy = void 0;
+const coding_utilities_1 = require("./coding-utilities");
+/**
+ * Cache for transparent proxy objects to maintain object identity
+ */
+const transparentProxyCache = new WeakMap();
+/**
+ * Create a transparent proxy that wraps plain objects to intercept property access.
+ * This enables deep access to Coding and CodeableConcept objects at any nesting level.
+ *
+ * Unlike SmartResource proxies, transparent proxies don't add methods - they just
+ * intercept property access to wrap Coding/CodeableConcept objects when accessed.
+ *
+ * @param obj - The plain object to wrap
+ * @returns A proxied object that wraps Coding/CodeableConcept on access
+ */
+function createTransparentProxy(obj) {
+    // Check cache first to maintain object identity
+    const cached = transparentProxyCache.get(obj);
+    if (cached) {
+        return cached;
+    }
+    const proxy = new Proxy(obj, {
+        get: (target, prop, receiver) => {
+            const value = Reflect.get(target, prop, receiver);
+            // Don't wrap null or undefined
+            if (value === null || value === undefined) {
+                return value;
+            }
+            // Wrap CodeableConcept objects (check before Coding to avoid misidentification)
+            if ((0, coding_utilities_1.isCodeableConcept)(value)) {
+                return (0, coding_utilities_1.createSmartCodeableConcept)(value);
+            }
+            // Wrap Coding objects
+            if ((0, coding_utilities_1.isCoding)(value)) {
+                return (0, coding_utilities_1.createSmartCoding)(value);
+            }
+            // Handle arrays - wrap each element if needed
+            if (Array.isArray(value)) {
+                return value.map(item => {
+                    if (item === null || item === undefined) {
+                        return item;
+                    }
+                    // Check CodeableConcept before Coding
+                    if ((0, coding_utilities_1.isCodeableConcept)(item)) {
+                        return (0, coding_utilities_1.createSmartCodeableConcept)(item);
+                    }
+                    if ((0, coding_utilities_1.isCoding)(item)) {
+                        return (0, coding_utilities_1.createSmartCoding)(item);
+                    }
+                    // Recursively wrap plain objects, not built-in types
+                    if (typeof item === "object" && !Array.isArray(item) && item.constructor === Object) {
+                        return createTransparentProxy(item);
+                    }
+                    return item;
+                });
+            }
+            // Recursively wrap plain objects (but not primitives, dates, etc.)
+            // Only wrap plain objects, not built-in types like Date, RegExp, etc.
+            if (typeof value === "object" && !Array.isArray(value) && value.constructor === Object) {
+                return createTransparentProxy(value);
+            }
+            // Return primitives, dates, and other built-in types as-is
+            return value;
+        },
+        // Handle Symbol.toStringTag for better console display
+        ownKeys: target => {
+            return Reflect.ownKeys(target);
+        },
+        getOwnPropertyDescriptor: (target, prop) => {
+            return Reflect.getOwnPropertyDescriptor(target, prop);
+        },
+    });
+    // Cache the proxy
+    transparentProxyCache.set(obj, proxy);
+    return proxy;
+}
+exports.createTransparentProxy = createTransparentProxy;
+//# sourceMappingURL=transparent-proxy.js.map

package/dist/internal/transparent-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transparent-proxy.js","sourceRoot":"","sources":["../../src/internal/transparent-proxy.ts"],"names":[],"mappings":";;;AAAA,yDAK4B;AAE5B;;GAEG;AACH,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAAkB,CAAC;AAE5D;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAAmB,GAAM;IAC7D,gDAAgD;IAChD,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,MAAM,EAAE;QACV,OAAO,MAAW,CAAC;KACpB;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE;QAC3B,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAElD,+BAA+B;YAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE;gBACzC,OAAO,KAAK,CAAC;aACd;YAED,gFAAgF;YAChF,IAAI,IAAA,oCAAiB,EAAC,KAAK,CAAC,EAAE;gBAC5B,OAAO,IAAA,6CAA0B,EAAC,KAAK,CAAC,CAAC;aAC1C;YAED,sBAAsB;YACtB,IAAI,IAAA,2BAAQ,EAAC,KAAK,CAAC,EAAE;gBACnB,OAAO,IAAA,oCAAiB,EAAC,KAAK,CAAC,CAAC;aACjC;YAED,8CAA8C;YAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBACxB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;oBACtB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE;wBACvC,OAAO,IAAI,CAAC;qBACb;oBACD,sCAAsC;oBACtC,IAAI,IAAA,oCAAiB,EAAC,IAAI,CAAC,EAAE;wBAC3B,OAAO,IAAA,6CAA0B,EAAC,IAAI,CAAC,CAAC;qBACzC;oBACD,IAAI,IAAA,2BAAQ,EAAC,IAAI,CAAC,EAAE;wBAClB,OAAO,IAAA,oCAAiB,EAAC,IAAI,CAAC,CAAC;qBAChC;oBACD,qDAAqD;oBACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,EAAE;wBACnF,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;qBACrC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC,CAAC;aACJ;YAED,mEAAmE;YACnE,sEAAsE;YACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,EAAE;gBACtF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;aACtC;YAED,2DAA2D;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uDAAuD;QACvD,OAAO,EAAE,MAAM,CAAC,EAAE;YAChB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,wBAAwB,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YACzC,OAAO,OAAO,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;KACF,CAAM,CAAC;IAER,kBAAkB;IAClB,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEtC,OAAO,KAAK,CAAC;AACf,CAAC;AAvED,wDAuEC"}

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"}