gdc-common-utils-ts 2.0.11 → 2.0.13

package/dist/utils/appointment-claim-helpers.d.ts

@@ -1,10 +0,0 @@
-import { type GenericInteroperableClaims } from './claim-list-helpers.js';
-export type AppointmentInteroperableClaims = GenericInteroperableClaims;
-export declare function getAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string): string[];
-export declare function setAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentInteroperableClaims;
-export declare function addAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentInteroperableClaims;
-export declare function removeAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentInteroperableClaims;
-export declare function getAppointmentIdentifier(claims: AppointmentInteroperableClaims): string;
-export declare function setAppointmentIdentifier(claims: AppointmentInteroperableClaims, value: string): AppointmentInteroperableClaims;
-export declare function getAppointmentParticipantActorList(claims: AppointmentInteroperableClaims): string[];
-export declare function setAppointmentParticipantActorList(claims: AppointmentInteroperableClaims, values: string | readonly string[]): AppointmentInteroperableClaims;

package/dist/utils/appointment-claim-helpers.js

@@ -1,26 +0,0 @@
-import { AppointmentClaim } from '../models/interoperable-claims/appointment-claims.js';
-import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
-export function getAppointmentClaimList(claims, claimKey) {
-    return getClaimValues(claims, claimKey);
-}
-export function setAppointmentClaimList(claims, claimKey, values) {
-    return setClaimValues(claims, claimKey, values);
-}
-export function addAppointmentClaimList(claims, claimKey, values) {
-    return addClaimValues(claims, claimKey, values);
-}
-export function removeAppointmentClaimList(claims, claimKey, values) {
-    return removeClaimValues(claims, claimKey, values);
-}
-export function getAppointmentIdentifier(claims) {
-    return normalizeClaimScalar(claims[AppointmentClaim.Identifier]);
-}
-export function setAppointmentIdentifier(claims, value) {
-    return { ...claims, [AppointmentClaim.Identifier]: normalizeClaimScalar(value) };
-}
-export function getAppointmentParticipantActorList(claims) {
-    return getAppointmentClaimList(claims, AppointmentClaim.ParticipantActor);
-}
-export function setAppointmentParticipantActorList(claims, values) {
-    return setAppointmentClaimList(claims, AppointmentClaim.ParticipantActor, values);
-}

package/dist/utils/appointment-response-claim-helpers.d.ts

@@ -1,8 +0,0 @@
-import { type GenericInteroperableClaims } from './claim-list-helpers.js';
-export type AppointmentResponseInteroperableClaims = GenericInteroperableClaims;
-export declare function getAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string): string[];
-export declare function setAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentResponseInteroperableClaims;
-export declare function addAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentResponseInteroperableClaims;
-export declare function removeAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentResponseInteroperableClaims;
-export declare function getAppointmentResponseIdentifier(claims: AppointmentResponseInteroperableClaims): string;
-export declare function setAppointmentResponseIdentifier(claims: AppointmentResponseInteroperableClaims, value: string): AppointmentResponseInteroperableClaims;

package/dist/utils/appointment-response-claim-helpers.js

@@ -1,20 +0,0 @@
-import { AppointmentResponseClaim } from '../models/interoperable-claims/appointment-response-claims.js';
-import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
-export function getAppointmentResponseClaimList(claims, claimKey) {
-    return getClaimValues(claims, claimKey);
-}
-export function setAppointmentResponseClaimList(claims, claimKey, values) {
-    return setClaimValues(claims, claimKey, values);
-}
-export function addAppointmentResponseClaimList(claims, claimKey, values) {
-    return addClaimValues(claims, claimKey, values);
-}
-export function removeAppointmentResponseClaimList(claims, claimKey, values) {
-    return removeClaimValues(claims, claimKey, values);
-}
-export function getAppointmentResponseIdentifier(claims) {
-    return normalizeClaimScalar(claims[AppointmentResponseClaim.Identifier]);
-}
-export function setAppointmentResponseIdentifier(claims, value) {
-    return { ...claims, [AppointmentResponseClaim.Identifier]: normalizeClaimScalar(value) };
-}

package/dist/utils/claim-list-helpers.d.ts

@@ -1,21 +0,0 @@
-export type GenericInteroperableClaims = Record<string, unknown>;
-export declare function splitClaimCsv(value: unknown): string[];
-export declare function normalizeClaimTokens(values: readonly string[]): string[];
-export declare function normalizeClaimInput(values: string | readonly string[]): string[];
-export declare function normalizeClaimScalar(value: unknown): string;
-/**
- * Returns the tokenized values for a claims field stored as CSV.
- */
-export declare function getClaimValues(claims: GenericInteroperableClaims, claimKey: string): string[];
-/**
- * Replaces a claims CSV field with the provided values.
- */
-export declare function setClaimValues(claims: GenericInteroperableClaims, claimKey: string, values: string | readonly string[]): GenericInteroperableClaims;
-/**
- * Adds one or many values into a claims CSV field while preserving uniqueness.
- */
-export declare function addClaimValues(claims: GenericInteroperableClaims, claimKey: string, values: string | readonly string[]): GenericInteroperableClaims;
-/**
- * Removes one or many values from a claims CSV field while preserving uniqueness.
- */
-export declare function removeClaimValues(claims: GenericInteroperableClaims, claimKey: string, values: string | readonly string[]): GenericInteroperableClaims;

package/dist/utils/claim-list-helpers.js

@@ -1,50 +0,0 @@
-// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
-export function splitClaimCsv(value) {
-    return String(value || '')
-        .split(',')
-        .map((item) => item.trim())
-        .filter(Boolean);
-}
-export function normalizeClaimTokens(values) {
-    return [...new Set(values.map((value) => String(value || '').trim()).filter(Boolean))];
-}
-export function normalizeClaimInput(values) {
-    return Array.isArray(values)
-        ? normalizeClaimTokens(values)
-        : normalizeClaimTokens(splitClaimCsv(values));
-}
-export function normalizeClaimScalar(value) {
-    return String(value || '').trim();
-}
-/**
- * Returns the tokenized values for a claims field stored as CSV.
- */
-export function getClaimValues(claims, claimKey) {
-    return normalizeClaimTokens(splitClaimCsv(claims[claimKey]));
-}
-/**
- * Replaces a claims CSV field with the provided values.
- */
-export function setClaimValues(claims, claimKey, values) {
-    const nextValues = normalizeClaimInput(values);
-    return {
-        ...claims,
-        [claimKey]: nextValues.join(','),
-    };
-}
-/**
- * Adds one or many values into a claims CSV field while preserving uniqueness.
- */
-export function addClaimValues(claims, claimKey, values) {
-    const current = getClaimValues(claims, claimKey);
-    const additions = normalizeClaimInput(values);
-    return setClaimValues(claims, claimKey, [...current, ...additions]);
-}
-/**
- * Removes one or many values from a claims CSV field while preserving uniqueness.
- */
-export function removeClaimValues(claims, claimKey, values) {
-    const removals = new Set(normalizeClaimInput(values));
-    const nextValues = getClaimValues(claims, claimKey).filter((value) => !removals.has(value));
-    return setClaimValues(claims, claimKey, nextValues);
-}

package/dist/utils/clinical-impression-claim-helpers.d.ts

@@ -1,10 +0,0 @@
-import { type GenericInteroperableClaims } from './claim-list-helpers.js';
-export type ClinicalImpressionInteroperableClaims = GenericInteroperableClaims;
-export declare function getClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string): string[];
-export declare function setClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;
-export declare function addClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;
-export declare function removeClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;
-export declare function getClinicalImpressionIdentifier(claims: ClinicalImpressionInteroperableClaims): string;
-export declare function setClinicalImpressionIdentifier(claims: ClinicalImpressionInteroperableClaims, value: string): ClinicalImpressionInteroperableClaims;
-export declare function getClinicalImpressionProblemList(claims: ClinicalImpressionInteroperableClaims): string[];
-export declare function setClinicalImpressionProblemList(claims: ClinicalImpressionInteroperableClaims, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;

package/dist/utils/clinical-impression-claim-helpers.js

@@ -1,26 +0,0 @@
-import { ClinicalImpressionClaim } from '../models/interoperable-claims/clinical-impression-claims.js';
-import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
-export function getClinicalImpressionClaimList(claims, claimKey) {
-    return getClaimValues(claims, claimKey);
-}
-export function setClinicalImpressionClaimList(claims, claimKey, values) {
-    return setClaimValues(claims, claimKey, values);
-}
-export function addClinicalImpressionClaimList(claims, claimKey, values) {
-    return addClaimValues(claims, claimKey, values);
-}
-export function removeClinicalImpressionClaimList(claims, claimKey, values) {
-    return removeClaimValues(claims, claimKey, values);
-}
-export function getClinicalImpressionIdentifier(claims) {
-    return normalizeClaimScalar(claims[ClinicalImpressionClaim.Identifier]);
-}
-export function setClinicalImpressionIdentifier(claims, value) {
-    return { ...claims, [ClinicalImpressionClaim.Identifier]: normalizeClaimScalar(value) };
-}
-export function getClinicalImpressionProblemList(claims) {
-    return getClinicalImpressionClaimList(claims, ClinicalImpressionClaim.Problem);
-}
-export function setClinicalImpressionProblemList(claims, values) {
-    return setClinicalImpressionClaimList(claims, ClinicalImpressionClaim.Problem, values);
-}

package/dist/utils/communication-bundle-session.d.ts

@@ -1,175 +0,0 @@
-import { BundleEntry, BundleJsonApi, BundleRequest } from '../models/bundle';
-import { type BundleResourceIdFilters } from './bundle-query';
-import { type MedicationStatementClaimsFlat } from '../models/interoperable-claims/medication-statement-claims';
-export type CommunicationBundleSessionMode = 'strict' | 'normalize';
-export type CommunicationBundleSessionOptions = Readonly<{
-    communicationClaims?: Record<string, unknown>;
-    initialBundle?: BundleJsonApi<BundleEntry>;
-    mode?: CommunicationBundleSessionMode;
-}>;
-export type ActiveEntrySelection = Readonly<{
-    index?: number;
-    fullUrl?: string;
-}>;
-export type UpsertEntryInput = Readonly<{
-    resourceType: string;
-    claims: Record<string, unknown>;
-    type?: string;
-    fullUrl?: string;
-    request?: BundleRequest;
-}>;
-export type AddContainedDocumentToActiveEntryInput = Readonly<{
-    identifier?: string;
-    fullUrl?: string;
-    claims?: Record<string, unknown>;
-    attachmentContentType?: string;
-    attachmentDataBase64?: string;
-    attachmentUrl?: string;
-    description?: string;
-    date?: string;
-    language?: string;
-}>;
-/**
- * Communication editing session with bundle-in-memory as source of truth.
- *
- * Design contract:
- * - `activeEntry` is the real editing unit (not only `activeResource`), because
- *   it can include `fullUrl`, `request`, and entry-level context.
- * - `Communication.content-attachment-data` is always derived from the
- *   in-memory bundle after each committed update.
- * - saving can release active entry memory via `saveAndReleaseActiveEntry()`.
- */
-export declare class CommunicationBundleSession {
-    private communicationClaims;
-    private bundleInMemory;
-    private activeEntryIndex;
-    private mode;
-    constructor(options?: CommunicationBundleSessionOptions);
-    /** Returns a deep copy of communication claims. */
-    getCommunicationClaims(): Record<string, unknown>;
-    /** Returns a deep copy of the current in-memory bundle. */
-    getBundleInMemory(): BundleJsonApi<BundleEntry>;
-    /** Returns the active entry index, or null when no entry is selected. */
-    getActiveEntryIndex(): number | null;
-    /** Returns a deep copy of the active entry when selected. */
-    getActiveEntry(): BundleEntry | null;
-    /** Selects an active entry by index or fullUrl. */
-    selectActiveEntry(selection: ActiveEntrySelection): this;
-    /** Clears active entry selection from memory. */
-    clearActiveEntry(): this;
-    /**
-     * Upserts an entry in bundle memory and marks it as active.
-     * Matching priority: `fullUrl` if present, then resource claim identifier.
-     */
-    upsertActiveEntry(input: UpsertEntryInput): this;
-    /**
-     * Consent-first helper for developer onboarding.
-     *
-     * Expected keys should come from `ClaimConsent` in caller code.
-     */
-    upsertActiveConsentEntry(input: Readonly<{
-        claims: Record<string, unknown>;
-        fullUrl?: string;
-        type?: string;
-        request?: BundleRequest;
-    }>): this;
-    /**
-     * MedicationStatement helper for IPS-in-Communication use cases.
-     *
-     * Expected keys should come from MedicationStatement claims constants.
-     */
-    upsertActiveMedicationStatementEntry(input: Readonly<{
-        claims: MedicationStatementClaimsFlat | Record<string, unknown>;
-        fullUrl?: string;
-        type?: string;
-        request?: BundleRequest;
-    }>): this;
-    /**
-     * DocumentReference helper for bundle-contained attachments linked from
-     * other clinical resources through `*.contained-documents`.
-     */
-    upsertActiveDocumentReferenceEntry(input: Readonly<{
-        claims: Record<string, unknown>;
-        fullUrl?: string;
-        type?: string;
-        request?: BundleRequest;
-    }>): this;
-    /**
-     * Condition helper for IPS-in-Communication use cases.
-     *
-     * Expected keys should come from Condition claims constants.
-     */
-    upsertActiveConditionEntry(input: Readonly<{
-        claims: Record<string, unknown>;
-        fullUrl?: string;
-        type?: string;
-        request?: BundleRequest;
-    }>): this;
-    /**
-     * AllergyIntolerance helper for IPS-in-Communication use cases.
-     *
-     * Expected keys should come from AllergyIntolerance claims constants.
-     */
-    upsertActiveAllergyIntoleranceEntry(input: Readonly<{
-        claims: Record<string, unknown>;
-        fullUrl?: string;
-        type?: string;
-        request?: BundleRequest;
-    }>): this;
-    /**
-     * TODO(ips-next):
-     * Add `upsertActiveDiagnosticReportEntry(...)` once the shared claim helpers
-     * for `DiagnosticReport` are in place.
-     *
-     * Expected shape should mirror the existing resource helpers:
-     * - `claims` authored with `@context = org.hl7.fhir.api`
-     * - matching priority by `DiagnosticReport.identifier`
-     * - support for linked `DocumentReference` ids through
-     *   `DiagnosticReport.contained-documents`
-     *
-     * Intentionally not implemented in this pass:
-     * - IPS authoring already works for the currently documented resources
-     * - GW Core can already consume bundle-contained `DocumentReference` rows
-     * - adding the DiagnosticReport editing surface now would expand the IPS
-     *   contract further than intended for this release slice
-     */
-    /**
-     * Creates or updates a linked `DocumentReference` entry and stores its
-     * identifier under the active resource `*.contained-documents` claim.
-     */
-    addContainedDocumentToActiveEntry(input: AddContainedDocumentToActiveEntryInput): this;
-    /**
-     * Patches active entry `resource.meta.claims` and synchronizes attachment data.
-     */
-    patchActiveEntryClaims(claimPatch: Record<string, unknown>): this;
-    /**
-     * Persists current memory state into communication claims attachment.
-     * No-op for active entry pointer.
-     */
-    saveActiveEntry(): this;
-    /**
-     * Persists and releases active entry memory pointer.
-     * This is the recommended step after a successful save operation.
-     */
-    saveAndReleaseActiveEntry(): this;
-    /**
-     * Returns stable resource IDs from bundle entries with optional filters.
-     */
-    getResourceIds(filters?: BundleResourceIdFilters): string[];
-    /**
-     * Returns bundle entries matching resource IDs produced by `getResourceIds`.
-     */
-    getResourceEntriesByIds(resourceIds: readonly string[]): BundleEntry[];
-    /**
-     * Resolves the entry URL (`fullUrl`) for a given entry/resource identifier.
-     */
-    getEntryUrl(entryId: string): string | undefined;
-    private decodeBundleFromClaims;
-    private syncAttachmentFromBundle;
-    private resolveCurrentSubject;
-    private findUpsertIndex;
-    private resolveEntryIdentifier;
-    private createBundleEntry;
-    private resolveEntryCanonicalIdValue;
-    private assertEntryIndex;
-}